Debian Codegraph @

docs/dyn/compute_v1.urlMaps.html

raw
1 <html><body>
2 <style>
3
4 body, h1, h2, h3, div, span, p, pre, a {
5 margin: 0;
6 padding: 0;
7 border: 0;
8 font-weight: inherit;
9 font-style: inherit;
10 font-size: 100%;
11 font-family: inherit;
12 vertical-align: baseline;
13 }
14
15 body {
16 font-size: 13px;
17 padding: 1em;
18 }
19
20 h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23 }
24
25 h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28 }
29
30 h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34 }
35
36 pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39 }
40
41 pre {
42 margin-top: 0.5em;
43 }
44
45 h1, h2, h3, p {
46 font-family: Arial, sans serif;
47 }
48
49 h1, h2, h3 {
50 border-bottom: solid #CCC 1px;
51 }
52
53 .toc_element {
54 margin-top: 0.5em;
55 }
56
57 .firstline {
58 margin-left: 2 em;
59 }
60
61 .method {
62 margin-top: 1em;
63 border: solid 1px #CCC;
64 padding: 1em;
65 background: #EEE;
66 }
67
68 .details {
69 font-weight: bold;
70 font-size: 14px;
71 }
72
73 </style>
74
75 <h1><a href="compute_v1.html">Compute Engine API</a> . <a href="compute_v1.urlMaps.html">urlMaps</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 UrlMap 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, urlMap, requestId=None, x__xgafv=None)</a></code></p>
88 <p class="firstline">Deletes the specified UrlMap resource.</p>
89 <p class="toc_element">
90 <code><a href="#get">get(project, urlMap, x__xgafv=None)</a></code></p>
91 <p class="firstline">Returns the specified UrlMap resource.</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">Creates a UrlMap resource in the specified project using</p>
95 <p class="toc_element">
96 <code><a href="#invalidateCache">invalidateCache(project, urlMap, body=None, requestId=None, x__xgafv=None)</a></code></p>
97 <p class="firstline">Initiates a cache invalidation operation, invalidating the specified path,</p>
98 <p class="toc_element">
99 <code><a href="#list">list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</a></code></p>
100 <p class="firstline">Retrieves the list of UrlMap resources available to the specified</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, urlMap, body=None, requestId=None, x__xgafv=None)</a></code></p>
106 <p class="firstline">Patches the specified UrlMap resource with the data included in the</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 <p class="toc_element">
111 <code><a href="#update">update(project, urlMap, body=None, requestId=None, x__xgafv=None)</a></code></p>
112 <p class="firstline">Updates the specified UrlMap resource with the data included in the</p>
113 <p class="toc_element">
114 <code><a href="#validate">validate(project, urlMap, body=None, x__xgafv=None)</a></code></p>
115 <p class="firstline">Runs static validation for the UrlMap. In particular, the tests of the</p>
116 <h3>Method Details</h3>
117 <div class="method">
118 <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>
119 <pre>Retrieves the list of all UrlMap resources, regional and global,
120 available to the specified project.
121
122 To prevent failure, Google recommends that you set the
123 `returnPartialSuccess` parameter to `true`.
124
125 Args:
126 project: string, Name of the project scoping this request. (required)
127 filter: string, A filter expression that filters resources listed in the response. Most
128 Compute resources support two types of filter expressions:
129 expressions that support regular expressions and expressions that follow
130 API improvement proposal AIP-160.
131 These two types of filter expressions cannot be mixed in one request.
132
133 If you want to use AIP-160, your expression must specify the field name, an
134 operator, and the value that you want to use for filtering. The value
135 must be a string, a number, or a boolean. The operator
136 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
137
138 For example, if you are filtering Compute Engine instances, you can
139 exclude instances named `example-instance` by specifying
140 `name != example-instance`.
141
142 The `:*` comparison can be used to test whether a key has been defined.
143 For example, to find all objects with `owner` label use:
144 ```
145 labels.owner:*
146 ```
147
148 You can also filter nested fields. For example, you could specify
149 `scheduling.automaticRestart = false` to include instances only
150 if they are not scheduled for automatic restarts. You can use filtering
151 on nested fields to filter based onresource labels.
152
153 To filter on multiple expressions, provide each separate expression within
154 parentheses. For example:
155 ```
156 (scheduling.automaticRestart = true)
157 (cpuPlatform = &quot;Intel Skylake&quot;)
158 ```
159 By default, each expression is an `AND` expression. However, you
160 can include `AND` and `OR` expressions explicitly.
161 For example:
162 ```
163 (cpuPlatform = &quot;Intel Skylake&quot;) OR
164 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
165 (scheduling.automaticRestart = true)
166 ```
167
168 If you want to use a regular expression, use the `eq` (equal) or `ne`
169 (not equal) operator against a single un-parenthesized expression with or
170 without quotes or against multiple parenthesized expressions. Examples:
171
172 `fieldname eq unquoted literal`
173 `fieldname eq &#x27;single quoted literal&#x27;`
174 `fieldname eq &quot;double quoted literal&quot;`
175 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
176
177 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
178 The literal value must match the entire field.
179
180 For example, to filter for instances that do not end with name &quot;instance&quot;,
181 you would use `name ne .*instance`.
182
183 You cannot combine constraints on multiple fields using regular
184 expressions.
185 includeAllScopes: boolean, Indicates whether every visible scope for each scope type (zone, region,
186 global) should be included in the response. For new resource types added
187 after this field, the flag has no effect as new resource types will always
188 include every visible scope for each scope type in response. For resource
189 types which predate this field, if this flag is omitted or false, only
190 scopes of the scope types where the resource type is expected to be found
191 will be included.
192 maxResults: integer, The maximum number of results per page that should be returned.
193 If the number of available results is larger than `maxResults`,
194 Compute Engine returns a `nextPageToken` that can be used to get
195 the next page of results in subsequent list requests. Acceptable values are
196 `0` to `500`, inclusive. (Default: `500`)
197 orderBy: string, Sorts list results by a certain order. By default, results
198 are returned in alphanumerical order based on the resource name.
199
200 You can also sort results in descending order based on the creation
201 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
202 results based on the `creationTimestamp` field in
203 reverse chronological order (newest result first). Use this to sort
204 resources like operations so that the newest operation is returned first.
205
206 Currently, only sorting by `name` or
207 `creationTimestamp desc` is supported.
208 pageToken: string, Specifies a page token to use. Set `pageToken` to the
209 `nextPageToken` returned by a previous list request to get
210 the next page of results.
211 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
212 of failure. The default value is false.
213
214 For example, when partial success behavior is enabled, aggregatedList for a
215 single zone scope either returns all resources in the zone or no resources,
216 with an error code.
217 serviceProjectNumber: string, The Shared VPC service project id or service project number for which
218 aggregated list request is invoked for subnetworks list-usable api.
219 x__xgafv: string, V1 error format.
220 Allowed values
221 1 - v1 error format
222 2 - v2 error format
223
224 Returns:
225 An object of the form:
226
227 {
228 &quot;id&quot;: &quot;A String&quot;, # [Output Only] Unique identifier for the resource; defined by the server.
229 &quot;items&quot;: { # A list of UrlMapsScopedList resources.
230 &quot;a_key&quot;: { # Name of the scope containing this set of UrlMaps.
231 &quot;urlMaps&quot;: [ # A list of UrlMaps contained in this scope.
232 { # Represents a URL Map resource.
233 #
234 # Compute Engine has two URL Map resources:
235 #
236 # * [Global](/compute/docs/reference/rest/v1/urlMaps)
237 # * [Regional](/compute/docs/reference/rest/v1/regionUrlMaps)
238 #
239 # A URL map resource is a component of certain types of cloud load balancers
240 # and Traffic Director:
241 #
242 # * urlMaps are used by global external Application Load
243 # Balancers, classic Application Load Balancers, and cross-region internal
244 # Application Load Balancers.
245 # * regionUrlMaps are used by internal Application Load Balancers,
246 # regional external Application Load Balancers and regional internal
247 # Application Load Balancers.
248 #
249 # For a list of supported URL map features by the load balancer type, see the
250 # Load balancing features: Routing and traffic management table.
251 #
252 # For a list of supported URL map features for Traffic Director, see the
253 # Traffic Director features: Routing and traffic management table.
254 #
255 # This resource defines mappings from hostnames and URL paths to either a
256 # backend service or a backend bucket.
257 #
258 # To use the global urlMaps resource, the backend service must
259 # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
260 # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
261 # information, read URL
262 # Map Concepts.
263 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
264 # text format.
265 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
266 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
267 #
268 # This policy takes
269 # effect at the load balancer level and applies only when no policy has been
270 # defined for the error code at lower levels like PathMatcher, RouteRule and
271 # PathRule within this UrlMap.
272 #
273 # For example, consider a UrlMap with the
274 # following configuration:
275 #
276 #
277 # - defaultCustomErrorResponsePolicy containing policies for
278 # responding to 5xx and 4xx errors
279 # - A PathMatcher configured for *.example.com has
280 # defaultCustomErrorResponsePolicy for 4xx.
281 #
282 # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
283 # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
284 # a request that does not match any host in *.example.com such
285 # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
286 # takes effect.
287 #
288 # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
289 # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
290 # a retry, if load balancer is successful in reaching the
291 # service, the defaultCustomErrorResponsePolicy is ignored and
292 # the response from the service is returned to the client.
293 #
294 # defaultCustomErrorResponsePolicy is supported only for
295 # global external Application Load Balancers.
296 # backend service or backend bucket responds with an error.
297 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
298 #
299 # In a given policy, if you specify rules for both a range of error codes
300 # as well as rules for specific error codes then rules with specific error
301 # codes have a higher priority. For example, assume that you configure a rule
302 # for 401 (Un-authorized) code, and another for all 4 series
303 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
304 # However if the backend service returns a 403, the rule for4xx takes effect.
305 { # Specifies the mapping between the response code that will be returned along
306 # with the custom error content and the response code returned by the backend
307 # service.
308 &quot;matchResponseCodes&quot;: [ # Valid values include:
309 #
310 #
311 # - A number between 400 and 599: For example
312 # 401 or 503, in which case the load balancer
313 # applies the policy if the error code exactly matches this value.
314 # - 5xx: Load Balancer will apply the policy if the
315 # backend service responds with any response code in the range of
316 # 500 to 599.
317 # - 4xx: Load
318 # Balancer will apply the policy if the backend service responds with any
319 # response code in the range of 400 to
320 # 499.
321 #
322 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
323 &quot;A String&quot;,
324 ],
325 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
326 # error content. If overrideResponseCode is not supplied, the
327 # same response code returned by the original backend bucket or backend
328 # service is returned to the client.
329 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
330 #
331 # path must start
332 # with a leading slash. path cannot have trailing slashes.
333 #
334 # If the file is not available in backendBucket or the
335 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
336 #
337 # The value must
338 # be from 1 to 1024 characters
339 },
340 ],
341 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
342 # contains the custom error content. Examples are:
343 #
344 #
345 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
346 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
347 # - global/backendBuckets/myBackendBucket
348 #
349 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
350 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
351 #
352 # If load balancer cannot reach
353 # the backendBucket, a simple Not Found Error will
354 # be returned, with the original response code (oroverrideResponseCode if configured).
355 #
356 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
357 },
358 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
359 # hostRules match. The load balancer performs advanced routing
360 # actions, such as URL rewrites and header transformations, before forwarding
361 # the request to the selected backend.
362 #
363 #
364 # Only one of defaultUrlRedirect, defaultService
365 # or defaultRouteAction.weightedBackendService can be set.
366 #
367 #
368 # URL maps for classic Application Load Balancers only support
369 # the urlRewrite action within defaultRouteAction.
370 #
371 #
372 # defaultRouteAction has no effect when the URL map is bound
373 # to a target gRPC proxy that has the validateForProxyless field
374 # set to true.
375 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
376 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
377 # property must be specified. This policy cannot be specified if any target
378 # backend has Identity-Aware Proxy enabled.
379 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
380 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
381 # header names can be specified. The cache is bypassed for all `cacheMode`
382 # values.
383 &quot;A String&quot;,
384 ],
385 &quot;cacheKeyPolicy&quot;: { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
386 # on the backend type: for Backend Services, the complete request URI is
387 # used; for Backend Buckets, the request URI is used without the protocol or
388 # host, and only query parameters known to Cloud Storage are included.
389 # Policy defined on Route Action.
390 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
391 # parameters will be included. Either specify `excludedQueryParameters`
392 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
393 # encoded and not treated as delimiters.
394 #
395 # Note: This field applies to routes that use backend services. Attempting
396 # to set it on a route that points exclusively to Backend Buckets will
397 # result in a configuration error. For routes that point to a Backend
398 # Bucket, use `includedQueryParameters` to define which parameters should
399 # be part of the cache key.
400 &quot;A String&quot;,
401 ],
402 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
403 #
404 # Note: This setting is only applicable to routes that use a Backend
405 # Service. It does not affect requests served by a Backend Bucket, as the
406 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
407 # it on a route that points exclusively to Backend Buckets will result in a
408 # configuration error.
409 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
410 #
411 # Note: This setting is only applicable to routes that use a Backend
412 # Service. It does not affect requests served by a Backend Bucket, as the
413 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
414 # set on a route that points exclusively to Backend Buckets will result in
415 # a configuration error.
416 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
417 # `includedQueryParameters` and `excludedQueryParameters`. If neither
418 # is set, the entire query string will be included. If false, the query
419 # string will be excluded from the cache key entirely.
420 #
421 # Note: This field applies to routes that use backend services. Attempting
422 # to set it on a route that points exclusively to Backend Buckets will
423 # result in a configuration error. For routes that point to a Backend
424 # Bucket, use `includedQueryParameters` to define which parameters should
425 # be part of the cache key.
426 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
427 # The name=value pair will be used in the cache key Cloud CDN generates.
428 #
429 # Note: This setting is only applicable to routes that use a Backend
430 # Service. It does not affect requests served by a Backend Bucket.
431 # Attempting to set it on a route that points exclusively to Backend
432 # Buckets will result in a configuration error. Up to 5 cookie names can be
433 # specified.
434 &quot;A String&quot;,
435 ],
436 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
437 &quot;A String&quot;,
438 ],
439 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
440 # parameters will be excluded. Either specify `includedQueryParameters`
441 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
442 # encoded and not treated as delimiters.
443 &quot;A String&quot;,
444 ],
445 },
446 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
447 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
448 &quot;clientTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
449 # content. This is used to clamp the max-age (or Expires) value sent to the
450 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
451 # is used for the response max-age directive, along with a &quot;public&quot;
452 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
453 # clamps the max-age from the origin (if specified), or else sets the
454 # response max-age directive to the lesser of the `clientTtl` and
455 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
456 # present. The maximum allowed value is 31,622,400s (1 year). If not
457 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
458 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
459 # `USE_ORIGIN_HEADERS`.
460 # as a count of seconds and fractions of seconds at nanosecond
461 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
462 # or &quot;month&quot;. Range is approximately 10,000 years.
463 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
464 # Durations less than one second are represented with a 0
465 # `seconds` field and a positive `nanos` field. Must be from 0
466 # to 999,999,999 inclusive.
467 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
468 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
469 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
470 },
471 &quot;defaultTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
472 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
473 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
474 # greater than that of `maxTtl`. When the `cacheMode` is set to
475 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
476 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
477 # accessed objects may be evicted from the cache before the defined TTL. If
478 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
479 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
480 # `USE_ORIGIN_HEADERS`.
481 # as a count of seconds and fractions of seconds at nanosecond
482 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
483 # or &quot;month&quot;. Range is approximately 10,000 years.
484 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
485 # Durations less than one second are represented with a 0
486 # `seconds` field and a positive `nanos` field. Must be from 0
487 # to 999,999,999 inclusive.
488 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
489 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
490 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
491 },
492 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
493 # attempt to set a max-age or s-maxage higher than this, or an Expires header
494 # more than `maxTtl` seconds in the future will be capped at the value of
495 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
496 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
497 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
498 # Infrequently accessed objects may be evicted from the cache before the
499 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
500 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
501 # mode.
502 # as a count of seconds and fractions of seconds at nanosecond
503 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
504 # or &quot;month&quot;. Range is approximately 10,000 years.
505 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
506 # Durations less than one second are represented with a 0
507 # `seconds` field and a positive `nanos` field. Must be from 0
508 # to 999,999,999 inclusive.
509 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
510 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
511 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
512 },
513 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
514 # to apply fine-grained caching for common errors or redirects.
515 # This can reduce the load on your origin and improve end-user
516 # experience by reducing response latency.
517 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
518 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
519 # the specified response code that lack any Cache-Control, Expires, or
520 # Pragma: no-cache directives. When the `cacheMode` is set to
521 # `FORCE_CACHE_ALL`, negative caching applies to all responses
522 # with the specified response code, and overrides any caching headers. By
523 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
524 #
525 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
526 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
527 # * 405 (Method Not Found), 501 (Not Implemented): 60s
528 #
529 # These defaults can be overridden in `negativeCachingPolicy`.
530 # If not specified, Cloud CDN applies negative caching by default.
531 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
532 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
533 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
534 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
535 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
536 # all response codes that you wish to cache. Cloud CDN will not apply any
537 # default negative caching when a policy exists.
538 { # Specify CDN TTLs for response error codes.
539 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
540 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
541 # specified as values, and you cannot specify a status code more than
542 # once.
543 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
544 # corresponding status code.
545 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
546 # objects may be evicted from the cache before the defined TTL.
547 # as a count of seconds and fractions of seconds at nanosecond
548 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
549 # or &quot;month&quot;. Range is approximately 10,000 years.
550 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
551 # Durations less than one second are represented with a 0
552 # `seconds` field and a positive `nanos` field. Must be from 0
553 # to 999,999,999 inclusive.
554 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
555 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
556 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
557 },
558 },
559 ],
560 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
561 # requests into a small number of requests to the origin. If not specified,
562 # Cloud CDN applies request coalescing by default.
563 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
564 # content with the origin, or when an error is encountered when refreshing
565 # the cache.
566 # This setting defines the default &quot;max-stale&quot; duration for any cached
567 # responses that do not specify a max-stale directive. Stale responses that
568 # exceed the TTL configured here will not be served. The default limit
569 # (max-stale) is 86400s (1 day), which will allow stale content to be
570 # served up to this limit beyond the max-age (or s-maxage) of a cached
571 # response.
572 # The maximum allowed value is 604800 (1 week).
573 # Set this to zero (0) to disable serve-while-stale.
574 # as a count of seconds and fractions of seconds at nanosecond
575 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
576 # or &quot;month&quot;. Range is approximately 10,000 years.
577 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
578 # Durations less than one second are represented with a 0
579 # `seconds` field and a positive `nanos` field. Must be from 0
580 # to 999,999,999 inclusive.
581 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
582 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
583 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
584 },
585 },
586 &quot;corsPolicy&quot;: { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
587 # information about the W3C recommendation for cross-origin resource sharing
588 # (CORS), see Fetch API Living
589 # Standard.
590 #
591 # Not supported when the URL map is bound to a target gRPC proxy.
592 # information about the W3C recommendation for cross-origin resource sharing
593 # (CORS), see Fetch API Living
594 # Standard.
595 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
596 # indicates that
597 # the actual request can include user credentials. This field translates to
598 # the Access-Control-Allow-Credentials header.
599 #
600 # Default is false.
601 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
602 # header.
603 &quot;A String&quot;,
604 ],
605 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
606 # header.
607 &quot;A String&quot;,
608 ],
609 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
610 # more information, see regular expression syntax.
611 #
612 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
613 #
614 # Regular expressions can only be used when the loadBalancingScheme is
615 # set to INTERNAL_SELF_MANAGED.
616 &quot;A String&quot;,
617 ],
618 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
619 #
620 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
621 &quot;A String&quot;,
622 ],
623 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
624 # The default value is false, which indicates that the CORS
625 # policy is in effect.
626 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
627 # header.
628 &quot;A String&quot;,
629 ],
630 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
631 # seconds. This field translates to the Access-Control-Max-Age
632 # header.
633 },
634 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
635 # the resiliency of clients to backend service failure. As part of fault
636 # injection, when clients send requests to a backend service, delays can be
637 # introduced by a load balancer on a percentage of requests before sending
638 # those requests to the backend service. Similarly requests from clients can
639 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
640 # that are configured with a fault_injection_policy if:
641 # 1. The traffic is generated by fault injection AND
642 # 2. The fault injection is not a delay fault injection.
643 # Fault injection is not supported with the classic Application Load Balancer
644 # . To see which load balancers support fault injection,
645 # see Load
646 # balancing: Routing and traffic management features.
647 # the resiliency of clients to backend service failure. As part of fault
648 # injection, when clients send requests to a backend service, delays can be
649 # introduced by the load balancer on a percentage of requests before sending
650 # those request to the backend service. Similarly requests from clients can be
651 # aborted by the load balancer for a percentage of requests.
652 &quot;abort&quot;: { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
653 # injection.
654 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
655 #
656 # The value must be from 200 to 599 inclusive.
657 #
658 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
659 # according to this
660 # mapping table. HTTP status 200 is mapped to gRPC status
661 # UNKNOWN. Injecting an OK status is currently not supported by
662 # Traffic Director.
663 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
664 # that is aborted as part of fault injection.
665 #
666 # The value must be from 0.0 to 100.0 inclusive.
667 },
668 &quot;delay&quot;: { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
669 # injection, before being sent to a backend service.
670 # request to the backend service as part of fault injection.
671 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
672 # as a count of seconds and fractions of seconds at nanosecond
673 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
674 # or &quot;month&quot;. Range is approximately 10,000 years.
675 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
676 # Durations less than one second are represented with a 0
677 # `seconds` field and a positive `nanos` field. Must be from 0
678 # to 999,999,999 inclusive.
679 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
680 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
681 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
682 },
683 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
684 # which a delay is introduced as part of fault injection.
685 #
686 # The value must be from 0.0 to 100.0 inclusive.
687 },
688 },
689 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
690 # Unlike the timeout field where the timeout duration starts
691 # from the time the request has been fully processed (known as*end-of-stream*),
692 # the duration in this field is computed from the beginning of the stream
693 # until the response has been processed, including all retries. A
694 # stream that does not complete in this duration is closed.
695 #
696 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
697 # with the route.
698 #
699 # This field is only allowed if the Url map is used with backend services
700 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
701 # as a count of seconds and fractions of seconds at nanosecond
702 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
703 # or &quot;month&quot;. Range is approximately 10,000 years.
704 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
705 # Durations less than one second are represented with a 0
706 # `seconds` field and a positive `nanos` field. Must be from 0
707 # to 999,999,999 inclusive.
708 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
709 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
710 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
711 },
712 &quot;requestMirrorPolicy&quot;: { # A policy that specifies how requests intended for the route&#x27;s backends # Specifies the policy on how requests intended for the route&#x27;s backends
713 # are shadowed to a separate mirrored backend service. The load balancer does
714 # not wait for responses from the shadow service. Before sending traffic
715 # to the shadow service, the host / authority header is suffixed with-shadow.
716 #
717 # Not supported when the URL map is bound to a target gRPC proxy that
718 # has the validateForProxyless field set to true.
719 # are shadowed to a separate mirrored backend service. The load balancer
720 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
721 # to the shadow service, the host or authority header is suffixed with-shadow.
722 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
723 # mirrored to.
724 #
725 # The backend service configured for a mirroring
726 # policy must reference backends that are of the same type as the original
727 # backend service matched in the URL map.
728 #
729 # Serverless NEG backends are not currently supported as a mirrored
730 # backend service.
731 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
732 },
733 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
734 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
735 # If not specified, defaults to 1.
736 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
737 #
738 # If not specified, will use the timeout set in theHttpRouteAction field.
739 # If timeout in the HttpRouteAction field is not set, this field
740 # uses the largest timeout
741 # among all backend services associated with the route.
742 #
743 # Not supported when the URL map is bound to a target gRPC proxy that
744 # has the validateForProxyless field set to true.
745 # as a count of seconds and fractions of seconds at nanosecond
746 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
747 # or &quot;month&quot;. Range is approximately 10,000 years.
748 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
749 # Durations less than one second are represented with a 0
750 # `seconds` field and a positive `nanos` field. Must be from 0
751 # to 999,999,999 inclusive.
752 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
753 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
754 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
755 },
756 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
757 # values are:
758 #
759 # - 5xx: retry is attempted if the instance or endpoint
760 # responds with any 5xx response code, or if the instance or
761 # endpoint does not respond at all. For example, disconnects, reset, read
762 # timeout, connection failure, and refused streams.
763 # - gateway-error: Similar to 5xx, but only
764 # applies to response codes 502, 503 or504.
765 # - connect-failure: a retry is attempted on failures
766 # connecting to the instance or endpoint. For example, connection
767 # timeouts.
768 # - retriable-4xx: a retry is attempted if the instance
769 # or endpoint responds with a 4xx response code.
770 # The only error that you can retry is error code 409.
771 # - refused-stream: a retry is attempted if the instance
772 # or endpoint resets the stream with a REFUSED_STREAM error
773 # code. This reset type indicates that it is safe to retry.
774 # - cancelled: a retry is attempted if the gRPC status
775 # code in the response header is set to cancelled.
776 # - deadline-exceeded: a retry is attempted if the gRPC
777 # status code in the response header is set todeadline-exceeded.
778 # - internal: a retry is attempted if the gRPC
779 # status code in the response header is set tointernal.
780 # - resource-exhausted: a retry is attempted if the gRPC
781 # status code in the response header is set toresource-exhausted.
782 # - unavailable: a retry is attempted if the gRPC
783 # status code in the response header is set tounavailable.
784 #
785 # Only the following codes are supported when the URL map is bound to
786 # target gRPC proxy that has validateForProxyless field set to true.
787 #
788 # - cancelled
789 # - deadline-exceeded
790 # - internal
791 # - resource-exhausted
792 # - unavailable
793 &quot;A String&quot;,
794 ],
795 },
796 &quot;timeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
797 # time the request has been fully processed (known as *end-of-stream*)
798 # up until the response has been processed. Timeout includes
799 # all retries.
800 #
801 # If not specified, this field uses the largest timeout among all backend
802 # services associated with the route.
803 #
804 # Not supported when the URL map is bound to a target gRPC proxy that
805 # has validateForProxyless field set to true.
806 # as a count of seconds and fractions of seconds at nanosecond
807 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
808 # or &quot;month&quot;. Range is approximately 10,000 years.
809 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
810 # Durations less than one second are represented with a 0
811 # `seconds` field and a positive `nanos` field. Must be from 0
812 # to 999,999,999 inclusive.
813 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
814 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
815 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
816 },
817 &quot;urlRewrite&quot;: { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
818 # to the matched service.
819 #
820 # urlRewrite is the only action supported in UrlMaps
821 # for classic Application Load Balancers.
822 #
823 # Not supported when the URL map is bound to a target gRPC proxy that
824 # has the validateForProxyless field set to true.
825 # backend service.
826 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
827 # host header is replaced with contents of hostRewrite.
828 #
829 # The value must be from 1 to 255 characters.
830 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
831 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
832 #
833 # The value must be from 1 to 1024 characters.
834 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
835 # header) using the HTTP template syntax.
836 #
837 # A corresponding
838 # path_template_match must be specified. Any template variables must exist in
839 # the path_template_match field.
840 #
841 #
842 # - -At least one variable must be specified in the path_template_match
843 # field
844 # - You can omit variables from the rewritten URL
845 # - The * and ** operators cannot be matched
846 # unless they have a corresponding variable name - e.g.
847 # {format=*} or {var=**}.
848 #
849 # For example, a path_template_match of /static/{format=**}
850 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
851 # rewrite, so that /{country}/{format}/{suffix=**} can be
852 # rewritten as /content/{format}/{country}/{suffix}.
853 #
854 # At least
855 # one non-empty routeRules[].matchRules[].path_template_match is
856 # required.
857 #
858 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
859 },
860 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
861 # occurs. The weights determine the fraction of traffic that flows to
862 # their corresponding backend service. If all traffic needs to
863 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
864 #
865 # After a backend service is identified and before forwarding
866 # the request to
867 # the backend service, advanced routing actions such as URL rewrites and
868 # header transformations are applied depending on additional settings
869 # specified in this HttpRouteAction.
870 { # In contrast to a single BackendService in
871 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
872 # multiple backend services. The volume of traffic for each
873 # backend service is proportional to the weight specified
874 # in each WeightedBackendService
875 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
876 # resource. Before
877 # forwarding the request to backendService, the load balancer
878 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
879 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
880 # effect for the selected backendService.
881 #
882 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
883 #
884 # headerAction is not supported for load balancers that have
885 # their loadBalancingScheme set to EXTERNAL.
886 #
887 # Not supported when the URL map is bound to a target gRPC proxy that
888 # has validateForProxyless field set to true.
889 # the request is passed along to the selected backendService.
890 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
891 { # Specification determining how headers are added to requests or responses.
892 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
893 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
894 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
895 # that already
896 # exist for the header. If true, headerValue is set for the
897 # header, discarding any values that were set for that header.
898 #
899 # The default value is true,
900 # unless a variable is present in headerValue,
901 # in which case the default value is false.
902 # .
903 },
904 ],
905 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
906 # request before forwarding the request to the backendService.
907 &quot;A String&quot;,
908 ],
909 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
910 # client.
911 { # Specification determining how headers are added to requests or responses.
912 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
913 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
914 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
915 # that already
916 # exist for the header. If true, headerValue is set for the
917 # header, discarding any values that were set for that header.
918 #
919 # The default value is true,
920 # unless a variable is present in headerValue,
921 # in which case the default value is false.
922 # .
923 },
924 ],
925 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
926 # response before sending the response back to the client.
927 &quot;A String&quot;,
928 ],
929 },
930 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
931 # computed asweight / (sum of all weightedBackendService weights in routeAction).
932 #
933 # The selection of a backend service is determined only for new traffic.
934 # Once a user&#x27;s request has been directed to a backend service,
935 # subsequent requests are sent to the same backend service as
936 # determined by the backend service&#x27;s session affinity policy.
937 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
938 # splitting. If you do, the weighted traffic splitting configuration takes
939 # precedence.
940 #
941 # The value must be from 0 to 1000.
942 },
943 ],
944 },
945 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL of the defaultService resource to
946 # which traffic is directed if none of the hostRules match.
947 # If defaultRouteAction is also specified, advanced
948 # routing actions, such as URL rewrites, take effect before sending the
949 # request to the backend.
950 #
951 #
952 # Only one of defaultUrlRedirect, defaultService
953 # or defaultRouteAction.weightedBackendService can be set.
954 #
955 #
956 # defaultService has no effect when the URL map is bound
957 # to a target gRPC proxy that has the validateForProxyless field
958 # set to true.
959 &quot;defaultUrlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
960 # is redirected to a URL specified by defaultUrlRedirect.
961 #
962 #
963 # Only one of defaultUrlRedirect, defaultService
964 # or defaultRouteAction.weightedBackendService can be set.
965 #
966 #
967 # Not supported when the URL map is bound to a target gRPC proxy.
968 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
969 # was supplied in the request.
970 #
971 # The value must be from 1 to 255
972 # characters.
973 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
974 # set to HTTPS.
975 # If set to false, the URL scheme of the redirected request
976 # remains the same as that of the request.
977 #
978 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
979 #
980 # The default is set to false.
981 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
982 # that was supplied in the request.
983 #
984 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
985 # supplied, the path of the original request is used for the redirect.
986 #
987 # The value must be from 1 to 1024 characters.
988 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
989 # the HttpRouteRuleMatch, retaining the remaining portion
990 # of the URL before redirecting the request.
991 #
992 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
993 # supplied, the path of the original request is used for the redirect.
994 #
995 # The value must be from 1 to 1024 characters.
996 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
997 #
998 # Supported values are:
999 #
1000 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
1001 # to 301.
1002 # - FOUND, which corresponds to 302.
1003 # - SEE_OTHER which corresponds to 303.
1004 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
1005 # method is retained.
1006 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
1007 # method is retained.
1008 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
1009 # URL is
1010 # removed before redirecting the request. If set to false, the
1011 # query portion of the original URL is retained.
1012 #
1013 # The default is set to false.
1014 },
1015 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
1016 # create the resource.
1017 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. A hash of the contents stored in this object.
1018 # This field is used in optimistic locking. This field is ignored when
1019 # inserting a UrlMap. An up-to-date fingerprint must be provided
1020 # in order to update the UrlMap, otherwise the request will
1021 # fail with error 412 conditionNotMet.
1022 #
1023 # To see the latest fingerprint, make a get() request to
1024 # retrieve a UrlMap.
1025 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
1026 # for the selected backendService.
1027 #
1028 # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
1029 #
1030 # headerAction is not supported for load balancers
1031 # that have
1032 # their loadBalancingScheme set to EXTERNAL.
1033 #
1034 # Not supported when the URL map is bound to a target gRPC proxy that
1035 # has validateForProxyless field set to true.
1036 # the request is passed along to the selected backendService.
1037 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
1038 { # Specification determining how headers are added to requests or responses.
1039 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
1040 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
1041 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
1042 # that already
1043 # exist for the header. If true, headerValue is set for the
1044 # header, discarding any values that were set for that header.
1045 #
1046 # The default value is true,
1047 # unless a variable is present in headerValue,
1048 # in which case the default value is false.
1049 # .
1050 },
1051 ],
1052 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
1053 # request before forwarding the request to the backendService.
1054 &quot;A String&quot;,
1055 ],
1056 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
1057 # client.
1058 { # Specification determining how headers are added to requests or responses.
1059 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
1060 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
1061 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
1062 # that already
1063 # exist for the header. If true, headerValue is set for the
1064 # header, discarding any values that were set for that header.
1065 #
1066 # The default value is true,
1067 # unless a variable is present in headerValue,
1068 # in which case the default value is false.
1069 # .
1070 },
1071 ],
1072 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
1073 # response before sending the response back to the client.
1074 &quot;A String&quot;,
1075 ],
1076 },
1077 &quot;hostRules&quot;: [ # The list of host rules to use against the URL.
1078 { # UrlMaps
1079 # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
1080 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
1081 # create the resource.
1082 &quot;hosts&quot;: [ # The list of host patterns to match. They must be valid hostnames with
1083 # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
1084 # that case, * must be the first character, and if followed by
1085 # anything, the immediate following character must be either -
1086 # or ..
1087 #
1088 # * based matching is not supported when the URL map is bound
1089 # to a target gRPC proxy that has the validateForProxyless field
1090 # set to true.
1091 &quot;A String&quot;,
1092 ],
1093 &quot;pathMatcher&quot;: &quot;A String&quot;, # The name of the PathMatcher to use to match the path portion
1094 # of the URL if the hostRule matches the URL&#x27;s host portion.
1095 },
1096 ],
1097 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the resource. This identifier is
1098 # defined by the server.
1099 &quot;kind&quot;: &quot;compute#urlMap&quot;, # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
1100 # url maps.
1101 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
1102 # The name must be 1-63 characters long, and comply withRFC1035.
1103 # Specifically, the name must be 1-63 characters long and match the regular
1104 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
1105 # character must be a lowercase letter, and all following characters must
1106 # be a dash, lowercase letter, or digit, except the last character, which
1107 # cannot be a dash.
1108 &quot;pathMatchers&quot;: [ # The list of named PathMatchers to use against the URL.
1109 { # A matcher for the path portion of the URL. The BackendService
1110 # from the longest-matched rule will serve the URL. If no rule was matched, the
1111 # default service is used.
1112 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
1113 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
1114 #
1115 # This policy takes
1116 # effect at the PathMatcher level and applies only when no
1117 # policy has been defined for the error code at lower levels likeRouteRule and PathRule within thisPathMatcher. If an error code does not have a policy defined
1118 # in defaultCustomErrorResponsePolicy, then a policy defined for
1119 # the error code in UrlMap.defaultCustomErrorResponsePolicy
1120 # takes effect.
1121 #
1122 # For example, consider a UrlMap with the following
1123 # configuration:
1124 #
1125 #
1126 # - UrlMap.defaultCustomErrorResponsePolicy is configured
1127 # with policies for 5xx and 4xx errors
1128 # - A RouteRule for /coming_soon/ is configured for the
1129 # error code 404.
1130 #
1131 # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher&#x27;s policy
1132 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
1133 # the policy in RouteRule.customErrorResponsePolicy takes
1134 # effect. If any of the requests in this example encounter a 500
1135 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
1136 #
1137 # When
1138 # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
1139 # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
1140 # a retry, if load balancer is successful in reaching the
1141 # service, the defaultCustomErrorResponsePolicy is ignored and
1142 # the response from the service is returned to the client.
1143 #
1144 # defaultCustomErrorResponsePolicy is supported only for
1145 # global external Application Load Balancers.
1146 # backend service or backend bucket responds with an error.
1147 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
1148 #
1149 # In a given policy, if you specify rules for both a range of error codes
1150 # as well as rules for specific error codes then rules with specific error
1151 # codes have a higher priority. For example, assume that you configure a rule
1152 # for 401 (Un-authorized) code, and another for all 4 series
1153 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
1154 # However if the backend service returns a 403, the rule for4xx takes effect.
1155 { # Specifies the mapping between the response code that will be returned along
1156 # with the custom error content and the response code returned by the backend
1157 # service.
1158 &quot;matchResponseCodes&quot;: [ # Valid values include:
1159 #
1160 #
1161 # - A number between 400 and 599: For example
1162 # 401 or 503, in which case the load balancer
1163 # applies the policy if the error code exactly matches this value.
1164 # - 5xx: Load Balancer will apply the policy if the
1165 # backend service responds with any response code in the range of
1166 # 500 to 599.
1167 # - 4xx: Load
1168 # Balancer will apply the policy if the backend service responds with any
1169 # response code in the range of 400 to
1170 # 499.
1171 #
1172 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
1173 &quot;A String&quot;,
1174 ],
1175 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
1176 # error content. If overrideResponseCode is not supplied, the
1177 # same response code returned by the original backend bucket or backend
1178 # service is returned to the client.
1179 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
1180 #
1181 # path must start
1182 # with a leading slash. path cannot have trailing slashes.
1183 #
1184 # If the file is not available in backendBucket or the
1185 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
1186 #
1187 # The value must
1188 # be from 1 to 1024 characters
1189 },
1190 ],
1191 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
1192 # contains the custom error content. Examples are:
1193 #
1194 #
1195 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
1196 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
1197 # - global/backendBuckets/myBackendBucket
1198 #
1199 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
1200 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
1201 #
1202 # If load balancer cannot reach
1203 # the backendBucket, a simple Not Found Error will
1204 # be returned, with the original response code (oroverrideResponseCode if configured).
1205 #
1206 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
1207 },
1208 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
1209 # pathRules or routeRules match. The load balancer
1210 # performs advanced routing actions, such as URL rewrites and
1211 # header transformations, before forwarding the request to the
1212 # selected backend.
1213 #
1214 #
1215 # Only one of defaultUrlRedirect, defaultService
1216 # or defaultRouteAction.weightedBackendService can be set.
1217 #
1218 #
1219 # URL maps for classic Application Load Balancers only support
1220 # the urlRewrite action within a path matcher&#x27;sdefaultRouteAction.
1221 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
1222 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
1223 # property must be specified. This policy cannot be specified if any target
1224 # backend has Identity-Aware Proxy enabled.
1225 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
1226 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
1227 # header names can be specified. The cache is bypassed for all `cacheMode`
1228 # values.
1229 &quot;A String&quot;,
1230 ],
1231 &quot;cacheKeyPolicy&quot;: { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
1232 # on the backend type: for Backend Services, the complete request URI is
1233 # used; for Backend Buckets, the request URI is used without the protocol or
1234 # host, and only query parameters known to Cloud Storage are included.
1235 # Policy defined on Route Action.
1236 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
1237 # parameters will be included. Either specify `excludedQueryParameters`
1238 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
1239 # encoded and not treated as delimiters.
1240 #
1241 # Note: This field applies to routes that use backend services. Attempting
1242 # to set it on a route that points exclusively to Backend Buckets will
1243 # result in a configuration error. For routes that point to a Backend
1244 # Bucket, use `includedQueryParameters` to define which parameters should
1245 # be part of the cache key.
1246 &quot;A String&quot;,
1247 ],
1248 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
1249 #
1250 # Note: This setting is only applicable to routes that use a Backend
1251 # Service. It does not affect requests served by a Backend Bucket, as the
1252 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
1253 # it on a route that points exclusively to Backend Buckets will result in a
1254 # configuration error.
1255 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
1256 #
1257 # Note: This setting is only applicable to routes that use a Backend
1258 # Service. It does not affect requests served by a Backend Bucket, as the
1259 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
1260 # set on a route that points exclusively to Backend Buckets will result in
1261 # a configuration error.
1262 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
1263 # `includedQueryParameters` and `excludedQueryParameters`. If neither
1264 # is set, the entire query string will be included. If false, the query
1265 # string will be excluded from the cache key entirely.
1266 #
1267 # Note: This field applies to routes that use backend services. Attempting
1268 # to set it on a route that points exclusively to Backend Buckets will
1269 # result in a configuration error. For routes that point to a Backend
1270 # Bucket, use `includedQueryParameters` to define which parameters should
1271 # be part of the cache key.
1272 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
1273 # The name=value pair will be used in the cache key Cloud CDN generates.
1274 #
1275 # Note: This setting is only applicable to routes that use a Backend
1276 # Service. It does not affect requests served by a Backend Bucket.
1277 # Attempting to set it on a route that points exclusively to Backend
1278 # Buckets will result in a configuration error. Up to 5 cookie names can be
1279 # specified.
1280 &quot;A String&quot;,
1281 ],
1282 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
1283 &quot;A String&quot;,
1284 ],
1285 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
1286 # parameters will be excluded. Either specify `includedQueryParameters`
1287 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
1288 # encoded and not treated as delimiters.
1289 &quot;A String&quot;,
1290 ],
1291 },
1292 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
1293 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
1294 &quot;clientTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
1295 # content. This is used to clamp the max-age (or Expires) value sent to the
1296 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
1297 # is used for the response max-age directive, along with a &quot;public&quot;
1298 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
1299 # clamps the max-age from the origin (if specified), or else sets the
1300 # response max-age directive to the lesser of the `clientTtl` and
1301 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
1302 # present. The maximum allowed value is 31,622,400s (1 year). If not
1303 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
1304 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
1305 # `USE_ORIGIN_HEADERS`.
1306 # as a count of seconds and fractions of seconds at nanosecond
1307 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1308 # or &quot;month&quot;. Range is approximately 10,000 years.
1309 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1310 # Durations less than one second are represented with a 0
1311 # `seconds` field and a positive `nanos` field. Must be from 0
1312 # to 999,999,999 inclusive.
1313 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1314 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1315 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1316 },
1317 &quot;defaultTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
1318 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
1319 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
1320 # greater than that of `maxTtl`. When the `cacheMode` is set to
1321 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
1322 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
1323 # accessed objects may be evicted from the cache before the defined TTL. If
1324 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
1325 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
1326 # `USE_ORIGIN_HEADERS`.
1327 # as a count of seconds and fractions of seconds at nanosecond
1328 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1329 # or &quot;month&quot;. Range is approximately 10,000 years.
1330 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1331 # Durations less than one second are represented with a 0
1332 # `seconds` field and a positive `nanos` field. Must be from 0
1333 # to 999,999,999 inclusive.
1334 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1335 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1336 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1337 },
1338 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
1339 # attempt to set a max-age or s-maxage higher than this, or an Expires header
1340 # more than `maxTtl` seconds in the future will be capped at the value of
1341 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
1342 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
1343 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
1344 # Infrequently accessed objects may be evicted from the cache before the
1345 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
1346 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
1347 # mode.
1348 # as a count of seconds and fractions of seconds at nanosecond
1349 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1350 # or &quot;month&quot;. Range is approximately 10,000 years.
1351 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1352 # Durations less than one second are represented with a 0
1353 # `seconds` field and a positive `nanos` field. Must be from 0
1354 # to 999,999,999 inclusive.
1355 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1356 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1357 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1358 },
1359 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
1360 # to apply fine-grained caching for common errors or redirects.
1361 # This can reduce the load on your origin and improve end-user
1362 # experience by reducing response latency.
1363 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
1364 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
1365 # the specified response code that lack any Cache-Control, Expires, or
1366 # Pragma: no-cache directives. When the `cacheMode` is set to
1367 # `FORCE_CACHE_ALL`, negative caching applies to all responses
1368 # with the specified response code, and overrides any caching headers. By
1369 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
1370 #
1371 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
1372 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
1373 # * 405 (Method Not Found), 501 (Not Implemented): 60s
1374 #
1375 # These defaults can be overridden in `negativeCachingPolicy`.
1376 # If not specified, Cloud CDN applies negative caching by default.
1377 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
1378 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
1379 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
1380 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
1381 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
1382 # all response codes that you wish to cache. Cloud CDN will not apply any
1383 # default negative caching when a policy exists.
1384 { # Specify CDN TTLs for response error codes.
1385 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
1386 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
1387 # specified as values, and you cannot specify a status code more than
1388 # once.
1389 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
1390 # corresponding status code.
1391 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
1392 # objects may be evicted from the cache before the defined TTL.
1393 # as a count of seconds and fractions of seconds at nanosecond
1394 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1395 # or &quot;month&quot;. Range is approximately 10,000 years.
1396 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1397 # Durations less than one second are represented with a 0
1398 # `seconds` field and a positive `nanos` field. Must be from 0
1399 # to 999,999,999 inclusive.
1400 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1401 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1402 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1403 },
1404 },
1405 ],
1406 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
1407 # requests into a small number of requests to the origin. If not specified,
1408 # Cloud CDN applies request coalescing by default.
1409 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
1410 # content with the origin, or when an error is encountered when refreshing
1411 # the cache.
1412 # This setting defines the default &quot;max-stale&quot; duration for any cached
1413 # responses that do not specify a max-stale directive. Stale responses that
1414 # exceed the TTL configured here will not be served. The default limit
1415 # (max-stale) is 86400s (1 day), which will allow stale content to be
1416 # served up to this limit beyond the max-age (or s-maxage) of a cached
1417 # response.
1418 # The maximum allowed value is 604800 (1 week).
1419 # Set this to zero (0) to disable serve-while-stale.
1420 # as a count of seconds and fractions of seconds at nanosecond
1421 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1422 # or &quot;month&quot;. Range is approximately 10,000 years.
1423 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1424 # Durations less than one second are represented with a 0
1425 # `seconds` field and a positive `nanos` field. Must be from 0
1426 # to 999,999,999 inclusive.
1427 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1428 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1429 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1430 },
1431 },
1432 &quot;corsPolicy&quot;: { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
1433 # information about the W3C recommendation for cross-origin resource sharing
1434 # (CORS), see Fetch API Living
1435 # Standard.
1436 #
1437 # Not supported when the URL map is bound to a target gRPC proxy.
1438 # information about the W3C recommendation for cross-origin resource sharing
1439 # (CORS), see Fetch API Living
1440 # Standard.
1441 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
1442 # indicates that
1443 # the actual request can include user credentials. This field translates to
1444 # the Access-Control-Allow-Credentials header.
1445 #
1446 # Default is false.
1447 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
1448 # header.
1449 &quot;A String&quot;,
1450 ],
1451 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
1452 # header.
1453 &quot;A String&quot;,
1454 ],
1455 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
1456 # more information, see regular expression syntax.
1457 #
1458 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
1459 #
1460 # Regular expressions can only be used when the loadBalancingScheme is
1461 # set to INTERNAL_SELF_MANAGED.
1462 &quot;A String&quot;,
1463 ],
1464 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
1465 #
1466 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
1467 &quot;A String&quot;,
1468 ],
1469 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
1470 # The default value is false, which indicates that the CORS
1471 # policy is in effect.
1472 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
1473 # header.
1474 &quot;A String&quot;,
1475 ],
1476 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
1477 # seconds. This field translates to the Access-Control-Max-Age
1478 # header.
1479 },
1480 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
1481 # the resiliency of clients to backend service failure. As part of fault
1482 # injection, when clients send requests to a backend service, delays can be
1483 # introduced by a load balancer on a percentage of requests before sending
1484 # those requests to the backend service. Similarly requests from clients can
1485 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
1486 # that are configured with a fault_injection_policy if:
1487 # 1. The traffic is generated by fault injection AND
1488 # 2. The fault injection is not a delay fault injection.
1489 # Fault injection is not supported with the classic Application Load Balancer
1490 # . To see which load balancers support fault injection,
1491 # see Load
1492 # balancing: Routing and traffic management features.
1493 # the resiliency of clients to backend service failure. As part of fault
1494 # injection, when clients send requests to a backend service, delays can be
1495 # introduced by the load balancer on a percentage of requests before sending
1496 # those request to the backend service. Similarly requests from clients can be
1497 # aborted by the load balancer for a percentage of requests.
1498 &quot;abort&quot;: { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
1499 # injection.
1500 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
1501 #
1502 # The value must be from 200 to 599 inclusive.
1503 #
1504 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
1505 # according to this
1506 # mapping table. HTTP status 200 is mapped to gRPC status
1507 # UNKNOWN. Injecting an OK status is currently not supported by
1508 # Traffic Director.
1509 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
1510 # that is aborted as part of fault injection.
1511 #
1512 # The value must be from 0.0 to 100.0 inclusive.
1513 },
1514 &quot;delay&quot;: { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
1515 # injection, before being sent to a backend service.
1516 # request to the backend service as part of fault injection.
1517 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
1518 # as a count of seconds and fractions of seconds at nanosecond
1519 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1520 # or &quot;month&quot;. Range is approximately 10,000 years.
1521 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1522 # Durations less than one second are represented with a 0
1523 # `seconds` field and a positive `nanos` field. Must be from 0
1524 # to 999,999,999 inclusive.
1525 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1526 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1527 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1528 },
1529 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
1530 # which a delay is introduced as part of fault injection.
1531 #
1532 # The value must be from 0.0 to 100.0 inclusive.
1533 },
1534 },
1535 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
1536 # Unlike the timeout field where the timeout duration starts
1537 # from the time the request has been fully processed (known as*end-of-stream*),
1538 # the duration in this field is computed from the beginning of the stream
1539 # until the response has been processed, including all retries. A
1540 # stream that does not complete in this duration is closed.
1541 #
1542 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
1543 # with the route.
1544 #
1545 # This field is only allowed if the Url map is used with backend services
1546 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
1547 # as a count of seconds and fractions of seconds at nanosecond
1548 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1549 # or &quot;month&quot;. Range is approximately 10,000 years.
1550 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1551 # Durations less than one second are represented with a 0
1552 # `seconds` field and a positive `nanos` field. Must be from 0
1553 # to 999,999,999 inclusive.
1554 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1555 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1556 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1557 },
1558 &quot;requestMirrorPolicy&quot;: { # A policy that specifies how requests intended for the route&#x27;s backends # Specifies the policy on how requests intended for the route&#x27;s backends
1559 # are shadowed to a separate mirrored backend service. The load balancer does
1560 # not wait for responses from the shadow service. Before sending traffic
1561 # to the shadow service, the host / authority header is suffixed with-shadow.
1562 #
1563 # Not supported when the URL map is bound to a target gRPC proxy that
1564 # has the validateForProxyless field set to true.
1565 # are shadowed to a separate mirrored backend service. The load balancer
1566 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
1567 # to the shadow service, the host or authority header is suffixed with-shadow.
1568 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
1569 # mirrored to.
1570 #
1571 # The backend service configured for a mirroring
1572 # policy must reference backends that are of the same type as the original
1573 # backend service matched in the URL map.
1574 #
1575 # Serverless NEG backends are not currently supported as a mirrored
1576 # backend service.
1577 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
1578 },
1579 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
1580 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
1581 # If not specified, defaults to 1.
1582 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
1583 #
1584 # If not specified, will use the timeout set in theHttpRouteAction field.
1585 # If timeout in the HttpRouteAction field is not set, this field
1586 # uses the largest timeout
1587 # among all backend services associated with the route.
1588 #
1589 # Not supported when the URL map is bound to a target gRPC proxy that
1590 # has the validateForProxyless field set to true.
1591 # as a count of seconds and fractions of seconds at nanosecond
1592 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1593 # or &quot;month&quot;. Range is approximately 10,000 years.
1594 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1595 # Durations less than one second are represented with a 0
1596 # `seconds` field and a positive `nanos` field. Must be from 0
1597 # to 999,999,999 inclusive.
1598 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1599 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1600 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1601 },
1602 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
1603 # values are:
1604 #
1605 # - 5xx: retry is attempted if the instance or endpoint
1606 # responds with any 5xx response code, or if the instance or
1607 # endpoint does not respond at all. For example, disconnects, reset, read
1608 # timeout, connection failure, and refused streams.
1609 # - gateway-error: Similar to 5xx, but only
1610 # applies to response codes 502, 503 or504.
1611 # - connect-failure: a retry is attempted on failures
1612 # connecting to the instance or endpoint. For example, connection
1613 # timeouts.
1614 # - retriable-4xx: a retry is attempted if the instance
1615 # or endpoint responds with a 4xx response code.
1616 # The only error that you can retry is error code 409.
1617 # - refused-stream: a retry is attempted if the instance
1618 # or endpoint resets the stream with a REFUSED_STREAM error
1619 # code. This reset type indicates that it is safe to retry.
1620 # - cancelled: a retry is attempted if the gRPC status
1621 # code in the response header is set to cancelled.
1622 # - deadline-exceeded: a retry is attempted if the gRPC
1623 # status code in the response header is set todeadline-exceeded.
1624 # - internal: a retry is attempted if the gRPC
1625 # status code in the response header is set tointernal.
1626 # - resource-exhausted: a retry is attempted if the gRPC
1627 # status code in the response header is set toresource-exhausted.
1628 # - unavailable: a retry is attempted if the gRPC
1629 # status code in the response header is set tounavailable.
1630 #
1631 # Only the following codes are supported when the URL map is bound to
1632 # target gRPC proxy that has validateForProxyless field set to true.
1633 #
1634 # - cancelled
1635 # - deadline-exceeded
1636 # - internal
1637 # - resource-exhausted
1638 # - unavailable
1639 &quot;A String&quot;,
1640 ],
1641 },
1642 &quot;timeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
1643 # time the request has been fully processed (known as *end-of-stream*)
1644 # up until the response has been processed. Timeout includes
1645 # all retries.
1646 #
1647 # If not specified, this field uses the largest timeout among all backend
1648 # services associated with the route.
1649 #
1650 # Not supported when the URL map is bound to a target gRPC proxy that
1651 # has validateForProxyless field set to true.
1652 # as a count of seconds and fractions of seconds at nanosecond
1653 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1654 # or &quot;month&quot;. Range is approximately 10,000 years.
1655 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1656 # Durations less than one second are represented with a 0
1657 # `seconds` field and a positive `nanos` field. Must be from 0
1658 # to 999,999,999 inclusive.
1659 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1660 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1661 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1662 },
1663 &quot;urlRewrite&quot;: { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
1664 # to the matched service.
1665 #
1666 # urlRewrite is the only action supported in UrlMaps
1667 # for classic Application Load Balancers.
1668 #
1669 # Not supported when the URL map is bound to a target gRPC proxy that
1670 # has the validateForProxyless field set to true.
1671 # backend service.
1672 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
1673 # host header is replaced with contents of hostRewrite.
1674 #
1675 # The value must be from 1 to 255 characters.
1676 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
1677 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
1678 #
1679 # The value must be from 1 to 1024 characters.
1680 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
1681 # header) using the HTTP template syntax.
1682 #
1683 # A corresponding
1684 # path_template_match must be specified. Any template variables must exist in
1685 # the path_template_match field.
1686 #
1687 #
1688 # - -At least one variable must be specified in the path_template_match
1689 # field
1690 # - You can omit variables from the rewritten URL
1691 # - The * and ** operators cannot be matched
1692 # unless they have a corresponding variable name - e.g.
1693 # {format=*} or {var=**}.
1694 #
1695 # For example, a path_template_match of /static/{format=**}
1696 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
1697 # rewrite, so that /{country}/{format}/{suffix=**} can be
1698 # rewritten as /content/{format}/{country}/{suffix}.
1699 #
1700 # At least
1701 # one non-empty routeRules[].matchRules[].path_template_match is
1702 # required.
1703 #
1704 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
1705 },
1706 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
1707 # occurs. The weights determine the fraction of traffic that flows to
1708 # their corresponding backend service. If all traffic needs to
1709 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
1710 #
1711 # After a backend service is identified and before forwarding
1712 # the request to
1713 # the backend service, advanced routing actions such as URL rewrites and
1714 # header transformations are applied depending on additional settings
1715 # specified in this HttpRouteAction.
1716 { # In contrast to a single BackendService in
1717 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
1718 # multiple backend services. The volume of traffic for each
1719 # backend service is proportional to the weight specified
1720 # in each WeightedBackendService
1721 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
1722 # resource. Before
1723 # forwarding the request to backendService, the load balancer
1724 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
1725 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
1726 # effect for the selected backendService.
1727 #
1728 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
1729 #
1730 # headerAction is not supported for load balancers that have
1731 # their loadBalancingScheme set to EXTERNAL.
1732 #
1733 # Not supported when the URL map is bound to a target gRPC proxy that
1734 # has validateForProxyless field set to true.
1735 # the request is passed along to the selected backendService.
1736 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
1737 { # Specification determining how headers are added to requests or responses.
1738 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
1739 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
1740 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
1741 # that already
1742 # exist for the header. If true, headerValue is set for the
1743 # header, discarding any values that were set for that header.
1744 #
1745 # The default value is true,
1746 # unless a variable is present in headerValue,
1747 # in which case the default value is false.
1748 # .
1749 },
1750 ],
1751 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
1752 # request before forwarding the request to the backendService.
1753 &quot;A String&quot;,
1754 ],
1755 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
1756 # client.
1757 { # Specification determining how headers are added to requests or responses.
1758 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
1759 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
1760 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
1761 # that already
1762 # exist for the header. If true, headerValue is set for the
1763 # header, discarding any values that were set for that header.
1764 #
1765 # The default value is true,
1766 # unless a variable is present in headerValue,
1767 # in which case the default value is false.
1768 # .
1769 },
1770 ],
1771 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
1772 # response before sending the response back to the client.
1773 &quot;A String&quot;,
1774 ],
1775 },
1776 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
1777 # computed asweight / (sum of all weightedBackendService weights in routeAction).
1778 #
1779 # The selection of a backend service is determined only for new traffic.
1780 # Once a user&#x27;s request has been directed to a backend service,
1781 # subsequent requests are sent to the same backend service as
1782 # determined by the backend service&#x27;s session affinity policy.
1783 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
1784 # splitting. If you do, the weighted traffic splitting configuration takes
1785 # precedence.
1786 #
1787 # The value must be from 0 to 1000.
1788 },
1789 ],
1790 },
1791 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource. This
1792 # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
1793 # matched. For example, the
1794 # following are all valid URLs to a BackendService resource:
1795 #
1796 #
1797 # - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
1798 # - compute/v1/projects/project/global/backendServices/backendService
1799 # - global/backendServices/backendService
1800 #
1801 #
1802 # If defaultRouteAction is also specified, advanced
1803 # routing actions, such as URL rewrites, take effect before sending the
1804 # request to the backend.
1805 #
1806 #
1807 # Only one of defaultUrlRedirect, defaultService
1808 # or defaultRouteAction.weightedBackendService can be set.
1809 #
1810 #
1811 # Authorization requires one or more of the following Google IAM permissions on the
1812 # specified resource default_service:
1813 #
1814 #
1815 # - compute.backendBuckets.use
1816 # - compute.backendServices.use
1817 &quot;defaultUrlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When none of the specified pathRules orrouteRules match, the request is redirected to a URL specified
1818 # by defaultUrlRedirect.
1819 #
1820 #
1821 # Only one of defaultUrlRedirect, defaultService
1822 # or defaultRouteAction.weightedBackendService can be set.
1823 #
1824 #
1825 # Not supported when the URL map is bound to a target gRPC proxy.
1826 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
1827 # was supplied in the request.
1828 #
1829 # The value must be from 1 to 255
1830 # characters.
1831 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
1832 # set to HTTPS.
1833 # If set to false, the URL scheme of the redirected request
1834 # remains the same as that of the request.
1835 #
1836 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
1837 #
1838 # The default is set to false.
1839 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
1840 # that was supplied in the request.
1841 #
1842 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
1843 # supplied, the path of the original request is used for the redirect.
1844 #
1845 # The value must be from 1 to 1024 characters.
1846 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
1847 # the HttpRouteRuleMatch, retaining the remaining portion
1848 # of the URL before redirecting the request.
1849 #
1850 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
1851 # supplied, the path of the original request is used for the redirect.
1852 #
1853 # The value must be from 1 to 1024 characters.
1854 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
1855 #
1856 # Supported values are:
1857 #
1858 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
1859 # to 301.
1860 # - FOUND, which corresponds to 302.
1861 # - SEE_OTHER which corresponds to 303.
1862 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
1863 # method is retained.
1864 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
1865 # method is retained.
1866 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
1867 # URL is
1868 # removed before redirecting the request. If set to false, the
1869 # query portion of the original URL is retained.
1870 #
1871 # The default is set to false.
1872 },
1873 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
1874 # create the resource.
1875 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
1876 # for the selected backend service.
1877 #
1878 # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
1879 #
1880 # HeaderAction is not supported for load balancers
1881 # that have
1882 # their loadBalancingScheme set to EXTERNAL.
1883 #
1884 # Not supported when the URL map is bound to a target gRPC proxy that
1885 # has validateForProxyless field set to true.
1886 # the request is passed along to the selected backendService.
1887 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
1888 { # Specification determining how headers are added to requests or responses.
1889 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
1890 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
1891 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
1892 # that already
1893 # exist for the header. If true, headerValue is set for the
1894 # header, discarding any values that were set for that header.
1895 #
1896 # The default value is true,
1897 # unless a variable is present in headerValue,
1898 # in which case the default value is false.
1899 # .
1900 },
1901 ],
1902 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
1903 # request before forwarding the request to the backendService.
1904 &quot;A String&quot;,
1905 ],
1906 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
1907 # client.
1908 { # Specification determining how headers are added to requests or responses.
1909 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
1910 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
1911 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
1912 # that already
1913 # exist for the header. If true, headerValue is set for the
1914 # header, discarding any values that were set for that header.
1915 #
1916 # The default value is true,
1917 # unless a variable is present in headerValue,
1918 # in which case the default value is false.
1919 # .
1920 },
1921 ],
1922 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
1923 # response before sending the response back to the client.
1924 &quot;A String&quot;,
1925 ],
1926 },
1927 &quot;name&quot;: &quot;A String&quot;, # The name to which this PathMatcher is referred by theHostRule.
1928 &quot;pathRules&quot;: [ # The list of path rules. Use this list instead of routeRules
1929 # when routing based on simple path matching is all that&#x27;s required. A path
1930 # rule can only include a wildcard character (*) after a
1931 # forward slash character (&quot;/&quot;).
1932 #
1933 # The order by which path rules are specified does not matter.
1934 # Matches are always done on the longest-path-first basis.
1935 #
1936 # For example: a pathRule with a path /a/b/c/* will match
1937 # before /a/b/* irrespective of the order in which those paths appear in this
1938 # list.
1939 #
1940 # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
1941 { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
1942 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
1943 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
1944 #
1945 # If a policy for an
1946 # error code is not configured for the PathRule, a policy for
1947 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
1948 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
1949 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
1950 # effect.
1951 #
1952 # For example, consider a UrlMap with the following configuration:
1953 #
1954 #
1955 # - UrlMap.defaultCustomErrorResponsePolicy are configured
1956 # with policies for 5xx and 4xx errors
1957 # - A PathRule for /coming_soon/ is configured for the error
1958 # code 404.
1959 #
1960 # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher&#x27;s policy
1961 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
1962 # the policy in PathRule.customErrorResponsePolicy takes
1963 # effect. If any of the requests in this example encounter a 500
1964 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
1965 #
1966 # customErrorResponsePolicy is supported only for
1967 # global external Application Load Balancers.
1968 # backend service or backend bucket responds with an error.
1969 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
1970 #
1971 # In a given policy, if you specify rules for both a range of error codes
1972 # as well as rules for specific error codes then rules with specific error
1973 # codes have a higher priority. For example, assume that you configure a rule
1974 # for 401 (Un-authorized) code, and another for all 4 series
1975 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
1976 # However if the backend service returns a 403, the rule for4xx takes effect.
1977 { # Specifies the mapping between the response code that will be returned along
1978 # with the custom error content and the response code returned by the backend
1979 # service.
1980 &quot;matchResponseCodes&quot;: [ # Valid values include:
1981 #
1982 #
1983 # - A number between 400 and 599: For example
1984 # 401 or 503, in which case the load balancer
1985 # applies the policy if the error code exactly matches this value.
1986 # - 5xx: Load Balancer will apply the policy if the
1987 # backend service responds with any response code in the range of
1988 # 500 to 599.
1989 # - 4xx: Load
1990 # Balancer will apply the policy if the backend service responds with any
1991 # response code in the range of 400 to
1992 # 499.
1993 #
1994 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
1995 &quot;A String&quot;,
1996 ],
1997 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
1998 # error content. If overrideResponseCode is not supplied, the
1999 # same response code returned by the original backend bucket or backend
2000 # service is returned to the client.
2001 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
2002 #
2003 # path must start
2004 # with a leading slash. path cannot have trailing slashes.
2005 #
2006 # If the file is not available in backendBucket or the
2007 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
2008 #
2009 # The value must
2010 # be from 1 to 1024 characters
2011 },
2012 ],
2013 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
2014 # contains the custom error content. Examples are:
2015 #
2016 #
2017 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
2018 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
2019 # - global/backendBuckets/myBackendBucket
2020 #
2021 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
2022 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
2023 #
2024 # If load balancer cannot reach
2025 # the backendBucket, a simple Not Found Error will
2026 # be returned, with the original response code (oroverrideResponseCode if configured).
2027 #
2028 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
2029 },
2030 &quot;paths&quot;: [ # The list of path patterns to match. Each must start with /
2031 # and the only place a * is allowed is at the end following
2032 # a /. The string fed to the path matcher does not include
2033 # any text after the first ? or #, and
2034 # those chars are not allowed here.
2035 &quot;A String&quot;,
2036 ],
2037 &quot;routeAction&quot;: { # In response to a matching path, the load balancer
2038 # performs advanced routing actions, such as URL rewrites and header
2039 # transformations, before forwarding the request to the selected
2040 # backend.
2041 #
2042 #
2043 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
2044 #
2045 #
2046 # URL maps for classic Application Load Balancers only support
2047 # the urlRewrite action within a path rule&#x27;srouteAction.
2048 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
2049 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
2050 # property must be specified. This policy cannot be specified if any target
2051 # backend has Identity-Aware Proxy enabled.
2052 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
2053 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
2054 # header names can be specified. The cache is bypassed for all `cacheMode`
2055 # values.
2056 &quot;A String&quot;,
2057 ],
2058 &quot;cacheKeyPolicy&quot;: { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
2059 # on the backend type: for Backend Services, the complete request URI is
2060 # used; for Backend Buckets, the request URI is used without the protocol or
2061 # host, and only query parameters known to Cloud Storage are included.
2062 # Policy defined on Route Action.
2063 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
2064 # parameters will be included. Either specify `excludedQueryParameters`
2065 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
2066 # encoded and not treated as delimiters.
2067 #
2068 # Note: This field applies to routes that use backend services. Attempting
2069 # to set it on a route that points exclusively to Backend Buckets will
2070 # result in a configuration error. For routes that point to a Backend
2071 # Bucket, use `includedQueryParameters` to define which parameters should
2072 # be part of the cache key.
2073 &quot;A String&quot;,
2074 ],
2075 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
2076 #
2077 # Note: This setting is only applicable to routes that use a Backend
2078 # Service. It does not affect requests served by a Backend Bucket, as the
2079 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
2080 # it on a route that points exclusively to Backend Buckets will result in a
2081 # configuration error.
2082 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
2083 #
2084 # Note: This setting is only applicable to routes that use a Backend
2085 # Service. It does not affect requests served by a Backend Bucket, as the
2086 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
2087 # set on a route that points exclusively to Backend Buckets will result in
2088 # a configuration error.
2089 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
2090 # `includedQueryParameters` and `excludedQueryParameters`. If neither
2091 # is set, the entire query string will be included. If false, the query
2092 # string will be excluded from the cache key entirely.
2093 #
2094 # Note: This field applies to routes that use backend services. Attempting
2095 # to set it on a route that points exclusively to Backend Buckets will
2096 # result in a configuration error. For routes that point to a Backend
2097 # Bucket, use `includedQueryParameters` to define which parameters should
2098 # be part of the cache key.
2099 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
2100 # The name=value pair will be used in the cache key Cloud CDN generates.
2101 #
2102 # Note: This setting is only applicable to routes that use a Backend
2103 # Service. It does not affect requests served by a Backend Bucket.
2104 # Attempting to set it on a route that points exclusively to Backend
2105 # Buckets will result in a configuration error. Up to 5 cookie names can be
2106 # specified.
2107 &quot;A String&quot;,
2108 ],
2109 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
2110 &quot;A String&quot;,
2111 ],
2112 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
2113 # parameters will be excluded. Either specify `includedQueryParameters`
2114 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
2115 # encoded and not treated as delimiters.
2116 &quot;A String&quot;,
2117 ],
2118 },
2119 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
2120 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
2121 &quot;clientTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
2122 # content. This is used to clamp the max-age (or Expires) value sent to the
2123 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
2124 # is used for the response max-age directive, along with a &quot;public&quot;
2125 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
2126 # clamps the max-age from the origin (if specified), or else sets the
2127 # response max-age directive to the lesser of the `clientTtl` and
2128 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
2129 # present. The maximum allowed value is 31,622,400s (1 year). If not
2130 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
2131 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
2132 # `USE_ORIGIN_HEADERS`.
2133 # as a count of seconds and fractions of seconds at nanosecond
2134 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2135 # or &quot;month&quot;. Range is approximately 10,000 years.
2136 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2137 # Durations less than one second are represented with a 0
2138 # `seconds` field and a positive `nanos` field. Must be from 0
2139 # to 999,999,999 inclusive.
2140 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2141 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2142 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2143 },
2144 &quot;defaultTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
2145 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
2146 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
2147 # greater than that of `maxTtl`. When the `cacheMode` is set to
2148 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
2149 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
2150 # accessed objects may be evicted from the cache before the defined TTL. If
2151 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
2152 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
2153 # `USE_ORIGIN_HEADERS`.
2154 # as a count of seconds and fractions of seconds at nanosecond
2155 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2156 # or &quot;month&quot;. Range is approximately 10,000 years.
2157 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2158 # Durations less than one second are represented with a 0
2159 # `seconds` field and a positive `nanos` field. Must be from 0
2160 # to 999,999,999 inclusive.
2161 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2162 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2163 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2164 },
2165 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
2166 # attempt to set a max-age or s-maxage higher than this, or an Expires header
2167 # more than `maxTtl` seconds in the future will be capped at the value of
2168 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
2169 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
2170 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
2171 # Infrequently accessed objects may be evicted from the cache before the
2172 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
2173 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
2174 # mode.
2175 # as a count of seconds and fractions of seconds at nanosecond
2176 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2177 # or &quot;month&quot;. Range is approximately 10,000 years.
2178 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2179 # Durations less than one second are represented with a 0
2180 # `seconds` field and a positive `nanos` field. Must be from 0
2181 # to 999,999,999 inclusive.
2182 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2183 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2184 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2185 },
2186 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
2187 # to apply fine-grained caching for common errors or redirects.
2188 # This can reduce the load on your origin and improve end-user
2189 # experience by reducing response latency.
2190 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
2191 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
2192 # the specified response code that lack any Cache-Control, Expires, or
2193 # Pragma: no-cache directives. When the `cacheMode` is set to
2194 # `FORCE_CACHE_ALL`, negative caching applies to all responses
2195 # with the specified response code, and overrides any caching headers. By
2196 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
2197 #
2198 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
2199 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
2200 # * 405 (Method Not Found), 501 (Not Implemented): 60s
2201 #
2202 # These defaults can be overridden in `negativeCachingPolicy`.
2203 # If not specified, Cloud CDN applies negative caching by default.
2204 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
2205 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
2206 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
2207 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
2208 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
2209 # all response codes that you wish to cache. Cloud CDN will not apply any
2210 # default negative caching when a policy exists.
2211 { # Specify CDN TTLs for response error codes.
2212 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
2213 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
2214 # specified as values, and you cannot specify a status code more than
2215 # once.
2216 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
2217 # corresponding status code.
2218 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
2219 # objects may be evicted from the cache before the defined TTL.
2220 # as a count of seconds and fractions of seconds at nanosecond
2221 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2222 # or &quot;month&quot;. Range is approximately 10,000 years.
2223 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2224 # Durations less than one second are represented with a 0
2225 # `seconds` field and a positive `nanos` field. Must be from 0
2226 # to 999,999,999 inclusive.
2227 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2228 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2229 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2230 },
2231 },
2232 ],
2233 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
2234 # requests into a small number of requests to the origin. If not specified,
2235 # Cloud CDN applies request coalescing by default.
2236 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
2237 # content with the origin, or when an error is encountered when refreshing
2238 # the cache.
2239 # This setting defines the default &quot;max-stale&quot; duration for any cached
2240 # responses that do not specify a max-stale directive. Stale responses that
2241 # exceed the TTL configured here will not be served. The default limit
2242 # (max-stale) is 86400s (1 day), which will allow stale content to be
2243 # served up to this limit beyond the max-age (or s-maxage) of a cached
2244 # response.
2245 # The maximum allowed value is 604800 (1 week).
2246 # Set this to zero (0) to disable serve-while-stale.
2247 # as a count of seconds and fractions of seconds at nanosecond
2248 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2249 # or &quot;month&quot;. Range is approximately 10,000 years.
2250 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2251 # Durations less than one second are represented with a 0
2252 # `seconds` field and a positive `nanos` field. Must be from 0
2253 # to 999,999,999 inclusive.
2254 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2255 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2256 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2257 },
2258 },
2259 &quot;corsPolicy&quot;: { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
2260 # information about the W3C recommendation for cross-origin resource sharing
2261 # (CORS), see Fetch API Living
2262 # Standard.
2263 #
2264 # Not supported when the URL map is bound to a target gRPC proxy.
2265 # information about the W3C recommendation for cross-origin resource sharing
2266 # (CORS), see Fetch API Living
2267 # Standard.
2268 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
2269 # indicates that
2270 # the actual request can include user credentials. This field translates to
2271 # the Access-Control-Allow-Credentials header.
2272 #
2273 # Default is false.
2274 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
2275 # header.
2276 &quot;A String&quot;,
2277 ],
2278 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
2279 # header.
2280 &quot;A String&quot;,
2281 ],
2282 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
2283 # more information, see regular expression syntax.
2284 #
2285 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
2286 #
2287 # Regular expressions can only be used when the loadBalancingScheme is
2288 # set to INTERNAL_SELF_MANAGED.
2289 &quot;A String&quot;,
2290 ],
2291 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
2292 #
2293 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
2294 &quot;A String&quot;,
2295 ],
2296 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
2297 # The default value is false, which indicates that the CORS
2298 # policy is in effect.
2299 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
2300 # header.
2301 &quot;A String&quot;,
2302 ],
2303 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
2304 # seconds. This field translates to the Access-Control-Max-Age
2305 # header.
2306 },
2307 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
2308 # the resiliency of clients to backend service failure. As part of fault
2309 # injection, when clients send requests to a backend service, delays can be
2310 # introduced by a load balancer on a percentage of requests before sending
2311 # those requests to the backend service. Similarly requests from clients can
2312 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
2313 # that are configured with a fault_injection_policy if:
2314 # 1. The traffic is generated by fault injection AND
2315 # 2. The fault injection is not a delay fault injection.
2316 # Fault injection is not supported with the classic Application Load Balancer
2317 # . To see which load balancers support fault injection,
2318 # see Load
2319 # balancing: Routing and traffic management features.
2320 # the resiliency of clients to backend service failure. As part of fault
2321 # injection, when clients send requests to a backend service, delays can be
2322 # introduced by the load balancer on a percentage of requests before sending
2323 # those request to the backend service. Similarly requests from clients can be
2324 # aborted by the load balancer for a percentage of requests.
2325 &quot;abort&quot;: { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
2326 # injection.
2327 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
2328 #
2329 # The value must be from 200 to 599 inclusive.
2330 #
2331 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
2332 # according to this
2333 # mapping table. HTTP status 200 is mapped to gRPC status
2334 # UNKNOWN. Injecting an OK status is currently not supported by
2335 # Traffic Director.
2336 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
2337 # that is aborted as part of fault injection.
2338 #
2339 # The value must be from 0.0 to 100.0 inclusive.
2340 },
2341 &quot;delay&quot;: { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
2342 # injection, before being sent to a backend service.
2343 # request to the backend service as part of fault injection.
2344 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
2345 # as a count of seconds and fractions of seconds at nanosecond
2346 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2347 # or &quot;month&quot;. Range is approximately 10,000 years.
2348 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2349 # Durations less than one second are represented with a 0
2350 # `seconds` field and a positive `nanos` field. Must be from 0
2351 # to 999,999,999 inclusive.
2352 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2353 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2354 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2355 },
2356 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
2357 # which a delay is introduced as part of fault injection.
2358 #
2359 # The value must be from 0.0 to 100.0 inclusive.
2360 },
2361 },
2362 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
2363 # Unlike the timeout field where the timeout duration starts
2364 # from the time the request has been fully processed (known as*end-of-stream*),
2365 # the duration in this field is computed from the beginning of the stream
2366 # until the response has been processed, including all retries. A
2367 # stream that does not complete in this duration is closed.
2368 #
2369 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
2370 # with the route.
2371 #
2372 # This field is only allowed if the Url map is used with backend services
2373 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
2374 # as a count of seconds and fractions of seconds at nanosecond
2375 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2376 # or &quot;month&quot;. Range is approximately 10,000 years.
2377 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2378 # Durations less than one second are represented with a 0
2379 # `seconds` field and a positive `nanos` field. Must be from 0
2380 # to 999,999,999 inclusive.
2381 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2382 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2383 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2384 },
2385 &quot;requestMirrorPolicy&quot;: { # A policy that specifies how requests intended for the route&#x27;s backends # Specifies the policy on how requests intended for the route&#x27;s backends
2386 # are shadowed to a separate mirrored backend service. The load balancer does
2387 # not wait for responses from the shadow service. Before sending traffic
2388 # to the shadow service, the host / authority header is suffixed with-shadow.
2389 #
2390 # Not supported when the URL map is bound to a target gRPC proxy that
2391 # has the validateForProxyless field set to true.
2392 # are shadowed to a separate mirrored backend service. The load balancer
2393 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
2394 # to the shadow service, the host or authority header is suffixed with-shadow.
2395 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
2396 # mirrored to.
2397 #
2398 # The backend service configured for a mirroring
2399 # policy must reference backends that are of the same type as the original
2400 # backend service matched in the URL map.
2401 #
2402 # Serverless NEG backends are not currently supported as a mirrored
2403 # backend service.
2404 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
2405 },
2406 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
2407 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
2408 # If not specified, defaults to 1.
2409 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
2410 #
2411 # If not specified, will use the timeout set in theHttpRouteAction field.
2412 # If timeout in the HttpRouteAction field is not set, this field
2413 # uses the largest timeout
2414 # among all backend services associated with the route.
2415 #
2416 # Not supported when the URL map is bound to a target gRPC proxy that
2417 # has the validateForProxyless field set to true.
2418 # as a count of seconds and fractions of seconds at nanosecond
2419 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2420 # or &quot;month&quot;. Range is approximately 10,000 years.
2421 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2422 # Durations less than one second are represented with a 0
2423 # `seconds` field and a positive `nanos` field. Must be from 0
2424 # to 999,999,999 inclusive.
2425 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2426 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2427 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2428 },
2429 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
2430 # values are:
2431 #
2432 # - 5xx: retry is attempted if the instance or endpoint
2433 # responds with any 5xx response code, or if the instance or
2434 # endpoint does not respond at all. For example, disconnects, reset, read
2435 # timeout, connection failure, and refused streams.
2436 # - gateway-error: Similar to 5xx, but only
2437 # applies to response codes 502, 503 or504.
2438 # - connect-failure: a retry is attempted on failures
2439 # connecting to the instance or endpoint. For example, connection
2440 # timeouts.
2441 # - retriable-4xx: a retry is attempted if the instance
2442 # or endpoint responds with a 4xx response code.
2443 # The only error that you can retry is error code 409.
2444 # - refused-stream: a retry is attempted if the instance
2445 # or endpoint resets the stream with a REFUSED_STREAM error
2446 # code. This reset type indicates that it is safe to retry.
2447 # - cancelled: a retry is attempted if the gRPC status
2448 # code in the response header is set to cancelled.
2449 # - deadline-exceeded: a retry is attempted if the gRPC
2450 # status code in the response header is set todeadline-exceeded.
2451 # - internal: a retry is attempted if the gRPC
2452 # status code in the response header is set tointernal.
2453 # - resource-exhausted: a retry is attempted if the gRPC
2454 # status code in the response header is set toresource-exhausted.
2455 # - unavailable: a retry is attempted if the gRPC
2456 # status code in the response header is set tounavailable.
2457 #
2458 # Only the following codes are supported when the URL map is bound to
2459 # target gRPC proxy that has validateForProxyless field set to true.
2460 #
2461 # - cancelled
2462 # - deadline-exceeded
2463 # - internal
2464 # - resource-exhausted
2465 # - unavailable
2466 &quot;A String&quot;,
2467 ],
2468 },
2469 &quot;timeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
2470 # time the request has been fully processed (known as *end-of-stream*)
2471 # up until the response has been processed. Timeout includes
2472 # all retries.
2473 #
2474 # If not specified, this field uses the largest timeout among all backend
2475 # services associated with the route.
2476 #
2477 # Not supported when the URL map is bound to a target gRPC proxy that
2478 # has validateForProxyless field set to true.
2479 # as a count of seconds and fractions of seconds at nanosecond
2480 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2481 # or &quot;month&quot;. Range is approximately 10,000 years.
2482 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2483 # Durations less than one second are represented with a 0
2484 # `seconds` field and a positive `nanos` field. Must be from 0
2485 # to 999,999,999 inclusive.
2486 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2487 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2488 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2489 },
2490 &quot;urlRewrite&quot;: { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
2491 # to the matched service.
2492 #
2493 # urlRewrite is the only action supported in UrlMaps
2494 # for classic Application Load Balancers.
2495 #
2496 # Not supported when the URL map is bound to a target gRPC proxy that
2497 # has the validateForProxyless field set to true.
2498 # backend service.
2499 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
2500 # host header is replaced with contents of hostRewrite.
2501 #
2502 # The value must be from 1 to 255 characters.
2503 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
2504 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
2505 #
2506 # The value must be from 1 to 1024 characters.
2507 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
2508 # header) using the HTTP template syntax.
2509 #
2510 # A corresponding
2511 # path_template_match must be specified. Any template variables must exist in
2512 # the path_template_match field.
2513 #
2514 #
2515 # - -At least one variable must be specified in the path_template_match
2516 # field
2517 # - You can omit variables from the rewritten URL
2518 # - The * and ** operators cannot be matched
2519 # unless they have a corresponding variable name - e.g.
2520 # {format=*} or {var=**}.
2521 #
2522 # For example, a path_template_match of /static/{format=**}
2523 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
2524 # rewrite, so that /{country}/{format}/{suffix=**} can be
2525 # rewritten as /content/{format}/{country}/{suffix}.
2526 #
2527 # At least
2528 # one non-empty routeRules[].matchRules[].path_template_match is
2529 # required.
2530 #
2531 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
2532 },
2533 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
2534 # occurs. The weights determine the fraction of traffic that flows to
2535 # their corresponding backend service. If all traffic needs to
2536 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
2537 #
2538 # After a backend service is identified and before forwarding
2539 # the request to
2540 # the backend service, advanced routing actions such as URL rewrites and
2541 # header transformations are applied depending on additional settings
2542 # specified in this HttpRouteAction.
2543 { # In contrast to a single BackendService in
2544 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
2545 # multiple backend services. The volume of traffic for each
2546 # backend service is proportional to the weight specified
2547 # in each WeightedBackendService
2548 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
2549 # resource. Before
2550 # forwarding the request to backendService, the load balancer
2551 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
2552 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
2553 # effect for the selected backendService.
2554 #
2555 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
2556 #
2557 # headerAction is not supported for load balancers that have
2558 # their loadBalancingScheme set to EXTERNAL.
2559 #
2560 # Not supported when the URL map is bound to a target gRPC proxy that
2561 # has validateForProxyless field set to true.
2562 # the request is passed along to the selected backendService.
2563 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
2564 { # Specification determining how headers are added to requests or responses.
2565 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
2566 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
2567 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
2568 # that already
2569 # exist for the header. If true, headerValue is set for the
2570 # header, discarding any values that were set for that header.
2571 #
2572 # The default value is true,
2573 # unless a variable is present in headerValue,
2574 # in which case the default value is false.
2575 # .
2576 },
2577 ],
2578 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
2579 # request before forwarding the request to the backendService.
2580 &quot;A String&quot;,
2581 ],
2582 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
2583 # client.
2584 { # Specification determining how headers are added to requests or responses.
2585 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
2586 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
2587 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
2588 # that already
2589 # exist for the header. If true, headerValue is set for the
2590 # header, discarding any values that were set for that header.
2591 #
2592 # The default value is true,
2593 # unless a variable is present in headerValue,
2594 # in which case the default value is false.
2595 # .
2596 },
2597 ],
2598 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
2599 # response before sending the response back to the client.
2600 &quot;A String&quot;,
2601 ],
2602 },
2603 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
2604 # computed asweight / (sum of all weightedBackendService weights in routeAction).
2605 #
2606 # The selection of a backend service is determined only for new traffic.
2607 # Once a user&#x27;s request has been directed to a backend service,
2608 # subsequent requests are sent to the same backend service as
2609 # determined by the backend service&#x27;s session affinity policy.
2610 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
2611 # splitting. If you do, the weighted traffic splitting configuration takes
2612 # precedence.
2613 #
2614 # The value must be from 0 to 1000.
2615 },
2616 ],
2617 },
2618 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
2619 # is directed if this rule is matched. If routeAction is
2620 # also specified, advanced routing actions, such as URL rewrites,
2621 # take effect before sending the request to the backend.
2622 #
2623 #
2624 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
2625 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
2626 # specified by urlRedirect.
2627 #
2628 #
2629 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
2630 #
2631 #
2632 # Not supported when the URL map is bound to a target gRPC proxy.
2633 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
2634 # was supplied in the request.
2635 #
2636 # The value must be from 1 to 255
2637 # characters.
2638 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
2639 # set to HTTPS.
2640 # If set to false, the URL scheme of the redirected request
2641 # remains the same as that of the request.
2642 #
2643 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
2644 #
2645 # The default is set to false.
2646 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
2647 # that was supplied in the request.
2648 #
2649 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
2650 # supplied, the path of the original request is used for the redirect.
2651 #
2652 # The value must be from 1 to 1024 characters.
2653 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
2654 # the HttpRouteRuleMatch, retaining the remaining portion
2655 # of the URL before redirecting the request.
2656 #
2657 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
2658 # supplied, the path of the original request is used for the redirect.
2659 #
2660 # The value must be from 1 to 1024 characters.
2661 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
2662 #
2663 # Supported values are:
2664 #
2665 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
2666 # to 301.
2667 # - FOUND, which corresponds to 302.
2668 # - SEE_OTHER which corresponds to 303.
2669 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
2670 # method is retained.
2671 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
2672 # method is retained.
2673 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
2674 # URL is
2675 # removed before redirecting the request. If set to false, the
2676 # query portion of the original URL is retained.
2677 #
2678 # The default is set to false.
2679 },
2680 },
2681 ],
2682 &quot;routeRules&quot;: [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
2683 # desired. routeRules are evaluated in order of priority, from
2684 # the lowest to highest number.
2685 #
2686 # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
2687 { # The HttpRouteRule setting specifies how to match an HTTP request
2688 # and the corresponding routing action that load balancing proxies perform.
2689 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
2690 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
2691 #
2692 # If a policy for an
2693 # error code is not configured for the RouteRule, a policy for
2694 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
2695 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
2696 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
2697 # effect.
2698 #
2699 # For example, consider a UrlMap with the following configuration:
2700 #
2701 #
2702 # - UrlMap.defaultCustomErrorResponsePolicy are configured
2703 # with policies for 5xx and 4xx errors
2704 # - A RouteRule for /coming_soon/ is configured for the
2705 # error code 404.
2706 #
2707 # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher&#x27;s policy
2708 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
2709 # the policy in RouteRule.customErrorResponsePolicy takes
2710 # effect. If any of the requests in this example encounter a 500
2711 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
2712 #
2713 # When
2714 # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
2715 # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
2716 # a retry, if load balancer is successful in reaching the
2717 # service, the customErrorResponsePolicy is ignored and
2718 # the response from the service is returned to the client.
2719 #
2720 # customErrorResponsePolicy is supported only for
2721 # global external Application Load Balancers.
2722 # backend service or backend bucket responds with an error.
2723 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
2724 #
2725 # In a given policy, if you specify rules for both a range of error codes
2726 # as well as rules for specific error codes then rules with specific error
2727 # codes have a higher priority. For example, assume that you configure a rule
2728 # for 401 (Un-authorized) code, and another for all 4 series
2729 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
2730 # However if the backend service returns a 403, the rule for4xx takes effect.
2731 { # Specifies the mapping between the response code that will be returned along
2732 # with the custom error content and the response code returned by the backend
2733 # service.
2734 &quot;matchResponseCodes&quot;: [ # Valid values include:
2735 #
2736 #
2737 # - A number between 400 and 599: For example
2738 # 401 or 503, in which case the load balancer
2739 # applies the policy if the error code exactly matches this value.
2740 # - 5xx: Load Balancer will apply the policy if the
2741 # backend service responds with any response code in the range of
2742 # 500 to 599.
2743 # - 4xx: Load
2744 # Balancer will apply the policy if the backend service responds with any
2745 # response code in the range of 400 to
2746 # 499.
2747 #
2748 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
2749 &quot;A String&quot;,
2750 ],
2751 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
2752 # error content. If overrideResponseCode is not supplied, the
2753 # same response code returned by the original backend bucket or backend
2754 # service is returned to the client.
2755 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
2756 #
2757 # path must start
2758 # with a leading slash. path cannot have trailing slashes.
2759 #
2760 # If the file is not available in backendBucket or the
2761 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
2762 #
2763 # The value must
2764 # be from 1 to 1024 characters
2765 },
2766 ],
2767 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
2768 # contains the custom error content. Examples are:
2769 #
2770 #
2771 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
2772 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
2773 # - global/backendBuckets/myBackendBucket
2774 #
2775 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
2776 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
2777 #
2778 # If load balancer cannot reach
2779 # the backendBucket, a simple Not Found Error will
2780 # be returned, with the original response code (oroverrideResponseCode if configured).
2781 #
2782 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
2783 },
2784 &quot;description&quot;: &quot;A String&quot;, # The short description conveying the intent of this routeRule.
2785 #
2786 #
2787 # The description can have a maximum length of 1024 characters.
2788 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
2789 # for the selected backendService.
2790 #
2791 # The headerAction value specified here is applied before the
2792 # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
2793 #
2794 # HeaderAction is not supported for load balancers
2795 # that have
2796 # their loadBalancingScheme set to EXTERNAL.
2797 #
2798 # Not supported when the URL map is bound to a target gRPC proxy that
2799 # has validateForProxyless field set to true.
2800 # the request is passed along to the selected backendService.
2801 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
2802 { # Specification determining how headers are added to requests or responses.
2803 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
2804 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
2805 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
2806 # that already
2807 # exist for the header. If true, headerValue is set for the
2808 # header, discarding any values that were set for that header.
2809 #
2810 # The default value is true,
2811 # unless a variable is present in headerValue,
2812 # in which case the default value is false.
2813 # .
2814 },
2815 ],
2816 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
2817 # request before forwarding the request to the backendService.
2818 &quot;A String&quot;,
2819 ],
2820 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
2821 # client.
2822 { # Specification determining how headers are added to requests or responses.
2823 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
2824 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
2825 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
2826 # that already
2827 # exist for the header. If true, headerValue is set for the
2828 # header, discarding any values that were set for that header.
2829 #
2830 # The default value is true,
2831 # unless a variable is present in headerValue,
2832 # in which case the default value is false.
2833 # .
2834 },
2835 ],
2836 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
2837 # response before sending the response back to the client.
2838 &quot;A String&quot;,
2839 ],
2840 },
2841 &quot;matchRules&quot;: [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
2842 # this routeRule when any of thematchRules are satisfied. However predicates within
2843 # a given matchRule have AND semantics. All predicates
2844 # within a matchRule must match for the request to
2845 # match the rule.
2846 { # HttpRouteRuleMatch specifies a set of criteria for matching
2847 # requests to an HttpRouteRule. All specified criteria must
2848 # be satisfied for a match to occur.
2849 &quot;fullPathMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
2850 # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
2851 # that may be part of the original URL.
2852 #
2853 # fullPathMatch must be from 1 to 1024 characters.
2854 #
2855 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
2856 # specified.
2857 &quot;headerMatches&quot;: [ # Specifies a list of header match criteria, all of which must match
2858 # corresponding headers in the request.
2859 { # matchRule criteria for request header matches.
2860 &quot;exactMatch&quot;: &quot;A String&quot;, # The value should exactly match contents of exactMatch.
2861 #
2862 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
2863 &quot;headerName&quot;: &quot;A String&quot;, # The name of the HTTP header to match.
2864 #
2865 # For matching against the HTTP request&#x27;s authority, use a headerMatch
2866 # with the header name &quot;:authority&quot;.
2867 #
2868 # For matching a request&#x27;s method, use the headerName &quot;:method&quot;.
2869 #
2870 # When the URL map is bound to a target gRPC proxy that has
2871 # the validateForProxyless field set to true, only
2872 # non-binary
2873 # user-specified custom metadata and the `content-type` header are supported.
2874 # The following transport-level headers cannot be used in header matching
2875 # rules:
2876 # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
2877 # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
2878 # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
2879 # `grpc-timeout` and `grpc-trace-bin`.
2880 &quot;invertMatch&quot;: True or False, # If set to false, the headerMatch is considered a
2881 # match if the preceding match criteria are met. If set to true,
2882 # the headerMatch is considered a match if the preceding
2883 # match criteria are NOT met.
2884 #
2885 # The default setting is false.
2886 &quot;prefixMatch&quot;: &quot;A String&quot;, # The value of the header must start with the contents ofprefixMatch.
2887 #
2888 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
2889 &quot;presentMatch&quot;: True or False, # A header with the contents of headerName must exist. The
2890 # match takes place whether or not the request&#x27;s header has a value.
2891 #
2892 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
2893 &quot;rangeMatch&quot;: { # HttpRouteRuleMatch criteria for field values that must stay # The header value must be an integer and its value must be in the range
2894 # specified in rangeMatch. If the header does not contain an
2895 # integer, number or is empty, the match fails.
2896 #
2897 # For example for a range [-5, 0]
2898 #
2899 #
2900 # - -3 will match.
2901 # - 0 will not match.
2902 # - 0.25 will not match.
2903 # - -3someString will not match.
2904 #
2905 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
2906 #
2907 # rangeMatch is not supported for load balancers
2908 # that have loadBalancingScheme set to EXTERNAL.
2909 # within the specified integer range.
2910 &quot;rangeEnd&quot;: &quot;A String&quot;, # The end of the range (exclusive) in signed long integer format.
2911 &quot;rangeStart&quot;: &quot;A String&quot;, # The start of the range (inclusive) in signed long integer format.
2912 },
2913 &quot;regexMatch&quot;: &quot;A String&quot;, # The value of the header must match the regular expression specified inregexMatch.
2914 # For more information about regular expression syntax, see Syntax.
2915 #
2916 # For matching against a port specified in the HTTP request, use a
2917 # headerMatch with headerName set to PORT and a regular expression that
2918 # satisfies the RFC2616 Host header&#x27;s port specifier.
2919 #
2920 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
2921 #
2922 # Regular expressions can only be used when the loadBalancingScheme is
2923 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
2924 # (regional scope) or INTERNAL_MANAGED.
2925 &quot;suffixMatch&quot;: &quot;A String&quot;, # The value of the header must end with the contents ofsuffixMatch.
2926 #
2927 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
2928 },
2929 ],
2930 &quot;ignoreCase&quot;: True or False, # Specifies that prefixMatch and fullPathMatch
2931 # matches are case sensitive.
2932 #
2933 # The default value is false.
2934 #
2935 # ignoreCase must not be used with regexMatch.
2936 #
2937 # Not supported when the URL map is bound to a target gRPC proxy.
2938 &quot;metadataFilters&quot;: [ # Opaque filter criteria used by the load balancer to restrict routing
2939 # configuration to a limited set of xDS
2940 # compliant clients. In their xDS requests to the load balancer, xDS clients
2941 # present node
2942 # metadata. When there is a match, the relevant routing configuration
2943 # is made available to those proxies.
2944 #
2945 # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least one of thefilterLabels must match the corresponding label provided in
2946 # the metadata. If its filterMatchCriteria is set to
2947 # MATCH_ALL, then all of its filterLabels must match with
2948 # corresponding labels provided in the metadata. If multiple
2949 # metadata filters are specified, all of them need to be
2950 # satisfied in order to be considered a match.
2951 #
2952 # metadataFilters specified here is applied after those
2953 # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
2954 #
2955 # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
2956 #
2957 # Not supported when the URL map is bound to a target gRPC proxy that
2958 # has validateForProxyless field set to true.
2959 { # Opaque filter criteria used by load balancers to restrict routing
2960 # configuration to a limited set of load balancing proxies. Proxies and
2961 # sidecars involved in load balancing would typically present metadata to the
2962 # load balancers that need to match criteria specified here. If a match takes
2963 # place, the relevant configuration is made available to those
2964 # proxies.
2965 #
2966 # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
2967 # one of thefilterLabels must match the corresponding label provided in
2968 # the metadata. If its filterMatchCriteria is set to
2969 # MATCH_ALL, then all of its filterLabels must match with
2970 # corresponding labels provided in the metadata.
2971 #
2972 # An example for using metadataFilters would be: if
2973 # load balancing involves
2974 # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in of their XDS requests to loadbalancers.
2975 &quot;filterLabels&quot;: [ # The list of label value pairs that must match labels in the provided
2976 # metadata based on filterMatchCriteria
2977 #
2978 # This list must not be empty and can have at the most 64 entries.
2979 { # MetadataFilter label name value pairs that are expected
2980 # to match corresponding labels presented as metadata to the load balancer.
2981 &quot;name&quot;: &quot;A String&quot;, # Name of metadata label.
2982 #
2983 # The name can have a maximum length of 1024 characters and must be at
2984 # least 1 character long.
2985 &quot;value&quot;: &quot;A String&quot;, # The value of the label must match the specified value.
2986 #
2987 # value can have a maximum length of 1024 characters.
2988 },
2989 ],
2990 &quot;filterMatchCriteria&quot;: &quot;A String&quot;, # Specifies how individual filter label matches
2991 # within the list of filterLabels and contributes toward the
2992 # overall metadataFilter match.
2993 #
2994 # Supported values are:
2995 #
2996 # - MATCH_ANY: at least one of the filterLabels
2997 # must have a matching label in the provided metadata.
2998 # - MATCH_ALL: all filterLabels must have
2999 # matching labels in the provided metadata.
3000 },
3001 ],
3002 &quot;pathTemplateMatch&quot;: &quot;A String&quot;, # If specified, this field defines a path template pattern that must match
3003 # the :path header after the query string is removed.
3004 #
3005 # A path template pattern can include variables and wildcards.
3006 # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
3007 # matches a single path segment, and ** that matches zero or
3008 # more path segments. The pattern must follow these rules:
3009 #
3010 #
3011 # - The value must be between 1 and 1024 characters.
3012 # - The pattern must start with a leading slash (&quot;/&quot;).
3013 # - No more than 5 operators (variables or wildcards) may appear in
3014 # the pattern.
3015 #
3016 # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
3017 # set.
3018 &quot;prefixMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the request&#x27;s
3019 # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
3020 #
3021 # The value must be from 1 to 1024 characters.
3022 #
3023 # The * character inside a prefix match is
3024 # treated as a literal character, not as a wildcard.
3025 #
3026 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
3027 # used within a matchRule.
3028 &quot;queryParameterMatches&quot;: [ # Specifies a list of query parameter match criteria, all of which must
3029 # match corresponding query parameters in the request.
3030 #
3031 # Not supported when the URL map is bound to a target gRPC proxy.
3032 { # HttpRouteRuleMatch criteria for a request&#x27;s query parameter.
3033 &quot;exactMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
3034 # parameter exactly matches the contents of exactMatch.
3035 #
3036 # Only one of presentMatch, exactMatch, orregexMatch must be set.
3037 &quot;name&quot;: &quot;A String&quot;, # The name of the query parameter to match. The query parameter must exist in
3038 # the request, in the absence of which the request match fails.
3039 &quot;presentMatch&quot;: True or False, # Specifies that the queryParameterMatch matches if the
3040 # request contains the query parameter, irrespective of whether the
3041 # parameter has a value or not.
3042 #
3043 # Only one of presentMatch, exactMatch, orregexMatch must be set.
3044 &quot;regexMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
3045 # parameter matches the regular expression specified byregexMatch. For
3046 # more information about regular expression syntax, see Syntax.
3047 #
3048 # Only one of presentMatch, exactMatch, orregexMatch must be set.
3049 #
3050 # Regular expressions can only be used when the loadBalancingScheme is
3051 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
3052 # (regional scope) or INTERNAL_MANAGED.
3053 },
3054 ],
3055 &quot;regexMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
3056 # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
3057 # supplied with the original URL. For
3058 # more information about regular expression syntax, see Syntax.
3059 #
3060 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
3061 # specified.
3062 #
3063 # Regular expressions can only be used when the loadBalancingScheme is
3064 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
3065 # (regional scope) or INTERNAL_MANAGED.
3066 },
3067 ],
3068 &quot;priority&quot;: 42, # For routeRules within a given pathMatcher,
3069 # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
3070 # of priority, from the lowest to highest number. The priority of a
3071 # rule decreases as its number increases (1, 2, 3, N+1). The first rule
3072 # that matches the request is applied.
3073 #
3074 #
3075 # You cannot configure two or more routeRules with the same priority.
3076 # Priority for each rule must be set to a number from 0 to 2147483647
3077 # inclusive.
3078 #
3079 #
3080 # Priority numbers can have gaps, which enable you to add or remove rules
3081 # in the future without affecting the rest of the rules. For example, 1, 2,
3082 # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
3083 # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
3084 # without any impact on existing rules.
3085 &quot;routeAction&quot;: { # In response to a matching matchRule, the load balancer
3086 # performs advanced routing actions, such as URL rewrites and header
3087 # transformations, before forwarding the request to the selected backend.
3088 #
3089 #
3090 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
3091 #
3092 #
3093 # URL maps for classic Application Load Balancers only support
3094 # the urlRewrite action within a route rule&#x27;srouteAction.
3095 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
3096 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
3097 # property must be specified. This policy cannot be specified if any target
3098 # backend has Identity-Aware Proxy enabled.
3099 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
3100 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
3101 # header names can be specified. The cache is bypassed for all `cacheMode`
3102 # values.
3103 &quot;A String&quot;,
3104 ],
3105 &quot;cacheKeyPolicy&quot;: { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
3106 # on the backend type: for Backend Services, the complete request URI is
3107 # used; for Backend Buckets, the request URI is used without the protocol or
3108 # host, and only query parameters known to Cloud Storage are included.
3109 # Policy defined on Route Action.
3110 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
3111 # parameters will be included. Either specify `excludedQueryParameters`
3112 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
3113 # encoded and not treated as delimiters.
3114 #
3115 # Note: This field applies to routes that use backend services. Attempting
3116 # to set it on a route that points exclusively to Backend Buckets will
3117 # result in a configuration error. For routes that point to a Backend
3118 # Bucket, use `includedQueryParameters` to define which parameters should
3119 # be part of the cache key.
3120 &quot;A String&quot;,
3121 ],
3122 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
3123 #
3124 # Note: This setting is only applicable to routes that use a Backend
3125 # Service. It does not affect requests served by a Backend Bucket, as the
3126 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
3127 # it on a route that points exclusively to Backend Buckets will result in a
3128 # configuration error.
3129 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
3130 #
3131 # Note: This setting is only applicable to routes that use a Backend
3132 # Service. It does not affect requests served by a Backend Bucket, as the
3133 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
3134 # set on a route that points exclusively to Backend Buckets will result in
3135 # a configuration error.
3136 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
3137 # `includedQueryParameters` and `excludedQueryParameters`. If neither
3138 # is set, the entire query string will be included. If false, the query
3139 # string will be excluded from the cache key entirely.
3140 #
3141 # Note: This field applies to routes that use backend services. Attempting
3142 # to set it on a route that points exclusively to Backend Buckets will
3143 # result in a configuration error. For routes that point to a Backend
3144 # Bucket, use `includedQueryParameters` to define which parameters should
3145 # be part of the cache key.
3146 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
3147 # The name=value pair will be used in the cache key Cloud CDN generates.
3148 #
3149 # Note: This setting is only applicable to routes that use a Backend
3150 # Service. It does not affect requests served by a Backend Bucket.
3151 # Attempting to set it on a route that points exclusively to Backend
3152 # Buckets will result in a configuration error. Up to 5 cookie names can be
3153 # specified.
3154 &quot;A String&quot;,
3155 ],
3156 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
3157 &quot;A String&quot;,
3158 ],
3159 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
3160 # parameters will be excluded. Either specify `includedQueryParameters`
3161 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
3162 # encoded and not treated as delimiters.
3163 &quot;A String&quot;,
3164 ],
3165 },
3166 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
3167 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
3168 &quot;clientTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
3169 # content. This is used to clamp the max-age (or Expires) value sent to the
3170 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
3171 # is used for the response max-age directive, along with a &quot;public&quot;
3172 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
3173 # clamps the max-age from the origin (if specified), or else sets the
3174 # response max-age directive to the lesser of the `clientTtl` and
3175 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
3176 # present. The maximum allowed value is 31,622,400s (1 year). If not
3177 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
3178 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
3179 # `USE_ORIGIN_HEADERS`.
3180 # as a count of seconds and fractions of seconds at nanosecond
3181 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3182 # or &quot;month&quot;. Range is approximately 10,000 years.
3183 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3184 # Durations less than one second are represented with a 0
3185 # `seconds` field and a positive `nanos` field. Must be from 0
3186 # to 999,999,999 inclusive.
3187 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3188 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3189 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3190 },
3191 &quot;defaultTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
3192 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
3193 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
3194 # greater than that of `maxTtl`. When the `cacheMode` is set to
3195 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
3196 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
3197 # accessed objects may be evicted from the cache before the defined TTL. If
3198 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
3199 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
3200 # `USE_ORIGIN_HEADERS`.
3201 # as a count of seconds and fractions of seconds at nanosecond
3202 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3203 # or &quot;month&quot;. Range is approximately 10,000 years.
3204 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3205 # Durations less than one second are represented with a 0
3206 # `seconds` field and a positive `nanos` field. Must be from 0
3207 # to 999,999,999 inclusive.
3208 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3209 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3210 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3211 },
3212 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
3213 # attempt to set a max-age or s-maxage higher than this, or an Expires header
3214 # more than `maxTtl` seconds in the future will be capped at the value of
3215 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
3216 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
3217 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
3218 # Infrequently accessed objects may be evicted from the cache before the
3219 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
3220 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
3221 # mode.
3222 # as a count of seconds and fractions of seconds at nanosecond
3223 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3224 # or &quot;month&quot;. Range is approximately 10,000 years.
3225 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3226 # Durations less than one second are represented with a 0
3227 # `seconds` field and a positive `nanos` field. Must be from 0
3228 # to 999,999,999 inclusive.
3229 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3230 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3231 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3232 },
3233 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
3234 # to apply fine-grained caching for common errors or redirects.
3235 # This can reduce the load on your origin and improve end-user
3236 # experience by reducing response latency.
3237 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
3238 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
3239 # the specified response code that lack any Cache-Control, Expires, or
3240 # Pragma: no-cache directives. When the `cacheMode` is set to
3241 # `FORCE_CACHE_ALL`, negative caching applies to all responses
3242 # with the specified response code, and overrides any caching headers. By
3243 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
3244 #
3245 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
3246 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
3247 # * 405 (Method Not Found), 501 (Not Implemented): 60s
3248 #
3249 # These defaults can be overridden in `negativeCachingPolicy`.
3250 # If not specified, Cloud CDN applies negative caching by default.
3251 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
3252 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
3253 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
3254 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
3255 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
3256 # all response codes that you wish to cache. Cloud CDN will not apply any
3257 # default negative caching when a policy exists.
3258 { # Specify CDN TTLs for response error codes.
3259 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
3260 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
3261 # specified as values, and you cannot specify a status code more than
3262 # once.
3263 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
3264 # corresponding status code.
3265 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
3266 # objects may be evicted from the cache before the defined TTL.
3267 # as a count of seconds and fractions of seconds at nanosecond
3268 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3269 # or &quot;month&quot;. Range is approximately 10,000 years.
3270 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3271 # Durations less than one second are represented with a 0
3272 # `seconds` field and a positive `nanos` field. Must be from 0
3273 # to 999,999,999 inclusive.
3274 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3275 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3276 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3277 },
3278 },
3279 ],
3280 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
3281 # requests into a small number of requests to the origin. If not specified,
3282 # Cloud CDN applies request coalescing by default.
3283 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
3284 # content with the origin, or when an error is encountered when refreshing
3285 # the cache.
3286 # This setting defines the default &quot;max-stale&quot; duration for any cached
3287 # responses that do not specify a max-stale directive. Stale responses that
3288 # exceed the TTL configured here will not be served. The default limit
3289 # (max-stale) is 86400s (1 day), which will allow stale content to be
3290 # served up to this limit beyond the max-age (or s-maxage) of a cached
3291 # response.
3292 # The maximum allowed value is 604800 (1 week).
3293 # Set this to zero (0) to disable serve-while-stale.
3294 # as a count of seconds and fractions of seconds at nanosecond
3295 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3296 # or &quot;month&quot;. Range is approximately 10,000 years.
3297 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3298 # Durations less than one second are represented with a 0
3299 # `seconds` field and a positive `nanos` field. Must be from 0
3300 # to 999,999,999 inclusive.
3301 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3302 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3303 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3304 },
3305 },
3306 &quot;corsPolicy&quot;: { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
3307 # information about the W3C recommendation for cross-origin resource sharing
3308 # (CORS), see Fetch API Living
3309 # Standard.
3310 #
3311 # Not supported when the URL map is bound to a target gRPC proxy.
3312 # information about the W3C recommendation for cross-origin resource sharing
3313 # (CORS), see Fetch API Living
3314 # Standard.
3315 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
3316 # indicates that
3317 # the actual request can include user credentials. This field translates to
3318 # the Access-Control-Allow-Credentials header.
3319 #
3320 # Default is false.
3321 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
3322 # header.
3323 &quot;A String&quot;,
3324 ],
3325 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
3326 # header.
3327 &quot;A String&quot;,
3328 ],
3329 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
3330 # more information, see regular expression syntax.
3331 #
3332 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
3333 #
3334 # Regular expressions can only be used when the loadBalancingScheme is
3335 # set to INTERNAL_SELF_MANAGED.
3336 &quot;A String&quot;,
3337 ],
3338 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
3339 #
3340 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
3341 &quot;A String&quot;,
3342 ],
3343 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
3344 # The default value is false, which indicates that the CORS
3345 # policy is in effect.
3346 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
3347 # header.
3348 &quot;A String&quot;,
3349 ],
3350 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
3351 # seconds. This field translates to the Access-Control-Max-Age
3352 # header.
3353 },
3354 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
3355 # the resiliency of clients to backend service failure. As part of fault
3356 # injection, when clients send requests to a backend service, delays can be
3357 # introduced by a load balancer on a percentage of requests before sending
3358 # those requests to the backend service. Similarly requests from clients can
3359 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
3360 # that are configured with a fault_injection_policy if:
3361 # 1. The traffic is generated by fault injection AND
3362 # 2. The fault injection is not a delay fault injection.
3363 # Fault injection is not supported with the classic Application Load Balancer
3364 # . To see which load balancers support fault injection,
3365 # see Load
3366 # balancing: Routing and traffic management features.
3367 # the resiliency of clients to backend service failure. As part of fault
3368 # injection, when clients send requests to a backend service, delays can be
3369 # introduced by the load balancer on a percentage of requests before sending
3370 # those request to the backend service. Similarly requests from clients can be
3371 # aborted by the load balancer for a percentage of requests.
3372 &quot;abort&quot;: { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
3373 # injection.
3374 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
3375 #
3376 # The value must be from 200 to 599 inclusive.
3377 #
3378 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
3379 # according to this
3380 # mapping table. HTTP status 200 is mapped to gRPC status
3381 # UNKNOWN. Injecting an OK status is currently not supported by
3382 # Traffic Director.
3383 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
3384 # that is aborted as part of fault injection.
3385 #
3386 # The value must be from 0.0 to 100.0 inclusive.
3387 },
3388 &quot;delay&quot;: { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
3389 # injection, before being sent to a backend service.
3390 # request to the backend service as part of fault injection.
3391 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
3392 # as a count of seconds and fractions of seconds at nanosecond
3393 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3394 # or &quot;month&quot;. Range is approximately 10,000 years.
3395 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3396 # Durations less than one second are represented with a 0
3397 # `seconds` field and a positive `nanos` field. Must be from 0
3398 # to 999,999,999 inclusive.
3399 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3400 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3401 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3402 },
3403 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
3404 # which a delay is introduced as part of fault injection.
3405 #
3406 # The value must be from 0.0 to 100.0 inclusive.
3407 },
3408 },
3409 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
3410 # Unlike the timeout field where the timeout duration starts
3411 # from the time the request has been fully processed (known as*end-of-stream*),
3412 # the duration in this field is computed from the beginning of the stream
3413 # until the response has been processed, including all retries. A
3414 # stream that does not complete in this duration is closed.
3415 #
3416 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
3417 # with the route.
3418 #
3419 # This field is only allowed if the Url map is used with backend services
3420 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
3421 # as a count of seconds and fractions of seconds at nanosecond
3422 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3423 # or &quot;month&quot;. Range is approximately 10,000 years.
3424 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3425 # Durations less than one second are represented with a 0
3426 # `seconds` field and a positive `nanos` field. Must be from 0
3427 # to 999,999,999 inclusive.
3428 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3429 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3430 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3431 },
3432 &quot;requestMirrorPolicy&quot;: { # A policy that specifies how requests intended for the route&#x27;s backends # Specifies the policy on how requests intended for the route&#x27;s backends
3433 # are shadowed to a separate mirrored backend service. The load balancer does
3434 # not wait for responses from the shadow service. Before sending traffic
3435 # to the shadow service, the host / authority header is suffixed with-shadow.
3436 #
3437 # Not supported when the URL map is bound to a target gRPC proxy that
3438 # has the validateForProxyless field set to true.
3439 # are shadowed to a separate mirrored backend service. The load balancer
3440 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
3441 # to the shadow service, the host or authority header is suffixed with-shadow.
3442 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
3443 # mirrored to.
3444 #
3445 # The backend service configured for a mirroring
3446 # policy must reference backends that are of the same type as the original
3447 # backend service matched in the URL map.
3448 #
3449 # Serverless NEG backends are not currently supported as a mirrored
3450 # backend service.
3451 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
3452 },
3453 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
3454 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
3455 # If not specified, defaults to 1.
3456 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
3457 #
3458 # If not specified, will use the timeout set in theHttpRouteAction field.
3459 # If timeout in the HttpRouteAction field is not set, this field
3460 # uses the largest timeout
3461 # among all backend services associated with the route.
3462 #
3463 # Not supported when the URL map is bound to a target gRPC proxy that
3464 # has the validateForProxyless field set to true.
3465 # as a count of seconds and fractions of seconds at nanosecond
3466 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3467 # or &quot;month&quot;. Range is approximately 10,000 years.
3468 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3469 # Durations less than one second are represented with a 0
3470 # `seconds` field and a positive `nanos` field. Must be from 0
3471 # to 999,999,999 inclusive.
3472 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3473 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3474 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3475 },
3476 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
3477 # values are:
3478 #
3479 # - 5xx: retry is attempted if the instance or endpoint
3480 # responds with any 5xx response code, or if the instance or
3481 # endpoint does not respond at all. For example, disconnects, reset, read
3482 # timeout, connection failure, and refused streams.
3483 # - gateway-error: Similar to 5xx, but only
3484 # applies to response codes 502, 503 or504.
3485 # - connect-failure: a retry is attempted on failures
3486 # connecting to the instance or endpoint. For example, connection
3487 # timeouts.
3488 # - retriable-4xx: a retry is attempted if the instance
3489 # or endpoint responds with a 4xx response code.
3490 # The only error that you can retry is error code 409.
3491 # - refused-stream: a retry is attempted if the instance
3492 # or endpoint resets the stream with a REFUSED_STREAM error
3493 # code. This reset type indicates that it is safe to retry.
3494 # - cancelled: a retry is attempted if the gRPC status
3495 # code in the response header is set to cancelled.
3496 # - deadline-exceeded: a retry is attempted if the gRPC
3497 # status code in the response header is set todeadline-exceeded.
3498 # - internal: a retry is attempted if the gRPC
3499 # status code in the response header is set tointernal.
3500 # - resource-exhausted: a retry is attempted if the gRPC
3501 # status code in the response header is set toresource-exhausted.
3502 # - unavailable: a retry is attempted if the gRPC
3503 # status code in the response header is set tounavailable.
3504 #
3505 # Only the following codes are supported when the URL map is bound to
3506 # target gRPC proxy that has validateForProxyless field set to true.
3507 #
3508 # - cancelled
3509 # - deadline-exceeded
3510 # - internal
3511 # - resource-exhausted
3512 # - unavailable
3513 &quot;A String&quot;,
3514 ],
3515 },
3516 &quot;timeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
3517 # time the request has been fully processed (known as *end-of-stream*)
3518 # up until the response has been processed. Timeout includes
3519 # all retries.
3520 #
3521 # If not specified, this field uses the largest timeout among all backend
3522 # services associated with the route.
3523 #
3524 # Not supported when the URL map is bound to a target gRPC proxy that
3525 # has validateForProxyless field set to true.
3526 # as a count of seconds and fractions of seconds at nanosecond
3527 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3528 # or &quot;month&quot;. Range is approximately 10,000 years.
3529 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3530 # Durations less than one second are represented with a 0
3531 # `seconds` field and a positive `nanos` field. Must be from 0
3532 # to 999,999,999 inclusive.
3533 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3534 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3535 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3536 },
3537 &quot;urlRewrite&quot;: { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
3538 # to the matched service.
3539 #
3540 # urlRewrite is the only action supported in UrlMaps
3541 # for classic Application Load Balancers.
3542 #
3543 # Not supported when the URL map is bound to a target gRPC proxy that
3544 # has the validateForProxyless field set to true.
3545 # backend service.
3546 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
3547 # host header is replaced with contents of hostRewrite.
3548 #
3549 # The value must be from 1 to 255 characters.
3550 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
3551 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
3552 #
3553 # The value must be from 1 to 1024 characters.
3554 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
3555 # header) using the HTTP template syntax.
3556 #
3557 # A corresponding
3558 # path_template_match must be specified. Any template variables must exist in
3559 # the path_template_match field.
3560 #
3561 #
3562 # - -At least one variable must be specified in the path_template_match
3563 # field
3564 # - You can omit variables from the rewritten URL
3565 # - The * and ** operators cannot be matched
3566 # unless they have a corresponding variable name - e.g.
3567 # {format=*} or {var=**}.
3568 #
3569 # For example, a path_template_match of /static/{format=**}
3570 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
3571 # rewrite, so that /{country}/{format}/{suffix=**} can be
3572 # rewritten as /content/{format}/{country}/{suffix}.
3573 #
3574 # At least
3575 # one non-empty routeRules[].matchRules[].path_template_match is
3576 # required.
3577 #
3578 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
3579 },
3580 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
3581 # occurs. The weights determine the fraction of traffic that flows to
3582 # their corresponding backend service. If all traffic needs to
3583 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
3584 #
3585 # After a backend service is identified and before forwarding
3586 # the request to
3587 # the backend service, advanced routing actions such as URL rewrites and
3588 # header transformations are applied depending on additional settings
3589 # specified in this HttpRouteAction.
3590 { # In contrast to a single BackendService in
3591 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
3592 # multiple backend services. The volume of traffic for each
3593 # backend service is proportional to the weight specified
3594 # in each WeightedBackendService
3595 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
3596 # resource. Before
3597 # forwarding the request to backendService, the load balancer
3598 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
3599 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
3600 # effect for the selected backendService.
3601 #
3602 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
3603 #
3604 # headerAction is not supported for load balancers that have
3605 # their loadBalancingScheme set to EXTERNAL.
3606 #
3607 # Not supported when the URL map is bound to a target gRPC proxy that
3608 # has validateForProxyless field set to true.
3609 # the request is passed along to the selected backendService.
3610 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
3611 { # Specification determining how headers are added to requests or responses.
3612 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
3613 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
3614 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
3615 # that already
3616 # exist for the header. If true, headerValue is set for the
3617 # header, discarding any values that were set for that header.
3618 #
3619 # The default value is true,
3620 # unless a variable is present in headerValue,
3621 # in which case the default value is false.
3622 # .
3623 },
3624 ],
3625 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
3626 # request before forwarding the request to the backendService.
3627 &quot;A String&quot;,
3628 ],
3629 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
3630 # client.
3631 { # Specification determining how headers are added to requests or responses.
3632 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
3633 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
3634 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
3635 # that already
3636 # exist for the header. If true, headerValue is set for the
3637 # header, discarding any values that were set for that header.
3638 #
3639 # The default value is true,
3640 # unless a variable is present in headerValue,
3641 # in which case the default value is false.
3642 # .
3643 },
3644 ],
3645 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
3646 # response before sending the response back to the client.
3647 &quot;A String&quot;,
3648 ],
3649 },
3650 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
3651 # computed asweight / (sum of all weightedBackendService weights in routeAction).
3652 #
3653 # The selection of a backend service is determined only for new traffic.
3654 # Once a user&#x27;s request has been directed to a backend service,
3655 # subsequent requests are sent to the same backend service as
3656 # determined by the backend service&#x27;s session affinity policy.
3657 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
3658 # splitting. If you do, the weighted traffic splitting configuration takes
3659 # precedence.
3660 #
3661 # The value must be from 0 to 1000.
3662 },
3663 ],
3664 },
3665 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
3666 # is directed if this rule is matched. If routeAction is
3667 # also specified, advanced routing actions, such as URL rewrites,
3668 # take effect before sending the request to the backend.
3669 #
3670 #
3671 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
3672 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
3673 # specified by urlRedirect.
3674 #
3675 #
3676 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
3677 #
3678 #
3679 # Not supported when the URL map is bound to a target gRPC proxy.
3680 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
3681 # was supplied in the request.
3682 #
3683 # The value must be from 1 to 255
3684 # characters.
3685 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
3686 # set to HTTPS.
3687 # If set to false, the URL scheme of the redirected request
3688 # remains the same as that of the request.
3689 #
3690 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
3691 #
3692 # The default is set to false.
3693 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
3694 # that was supplied in the request.
3695 #
3696 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
3697 # supplied, the path of the original request is used for the redirect.
3698 #
3699 # The value must be from 1 to 1024 characters.
3700 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
3701 # the HttpRouteRuleMatch, retaining the remaining portion
3702 # of the URL before redirecting the request.
3703 #
3704 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
3705 # supplied, the path of the original request is used for the redirect.
3706 #
3707 # The value must be from 1 to 1024 characters.
3708 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
3709 #
3710 # Supported values are:
3711 #
3712 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
3713 # to 301.
3714 # - FOUND, which corresponds to 302.
3715 # - SEE_OTHER which corresponds to 303.
3716 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
3717 # method is retained.
3718 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
3719 # method is retained.
3720 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
3721 # URL is
3722 # removed before redirecting the request. If set to false, the
3723 # query portion of the original URL is retained.
3724 #
3725 # The default is set to false.
3726 },
3727 },
3728 ],
3729 },
3730 ],
3731 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the regional URL map resides.
3732 # This field is not applicable to global URL maps.
3733 # You must specify this field as part of the HTTP request URL. It is
3734 # not settable as a field in the request body.
3735 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
3736 &quot;tests&quot;: [ # The list of expected URL mapping tests. Request to update theUrlMap succeeds only if all test cases pass. You can specify a
3737 # maximum of 100 tests per UrlMap.
3738 #
3739 # Not supported when the URL map is bound to a target gRPC proxy that
3740 # has validateForProxyless field set to true.
3741 { # Message for the expected URL mappings.
3742 &quot;description&quot;: &quot;A String&quot;, # Description of this test case.
3743 &quot;expectedOutputUrl&quot;: &quot;A String&quot;, # The expected output URL evaluated by the load balancer
3744 # containing the scheme, host, path and query parameters.
3745 #
3746 # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
3747 # the load balancer to backends. For rules with urlRewrite,
3748 # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
3749 #
3750 # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer&#x27;s
3751 # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
3752 # If urlRedirect specifies strip_query, the test
3753 # passes only if expectedOutputUrl does not contain any query
3754 # parameters.
3755 #
3756 # expectedOutputUrl is optional whenservice is specified.
3757 &quot;expectedRedirectResponseCode&quot;: 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
3758 # load balancer&#x27;s redirect response.
3759 #
3760 # expectedRedirectResponseCode cannot be set whenservice is set.
3761 &quot;headers&quot;: [ # HTTP headers for this request. If headers contains
3762 # a host header, then host must also match the header value.
3763 { # HTTP headers used in UrlMapTests.
3764 &quot;name&quot;: &quot;A String&quot;, # Header name.
3765 &quot;value&quot;: &quot;A String&quot;, # Header value.
3766 },
3767 ],
3768 &quot;host&quot;: &quot;A String&quot;, # Host portion of the URL. If headers contains a host header,
3769 # then host must also match the header value.
3770 &quot;path&quot;: &quot;A String&quot;, # Path portion of the URL.
3771 &quot;service&quot;: &quot;A String&quot;, # Expected BackendService or BackendBucket resource
3772 # the given URL should be mapped to.
3773 #
3774 # The service field cannot
3775 # be set if expectedRedirectResponseCode is set.
3776 },
3777 ],
3778 },
3779 ],
3780 &quot;warning&quot;: { # Informational warning which replaces the list of
3781 # backend services when the list is empty.
3782 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
3783 # Engine returns NO_RESULTS_ON_PAGE if there
3784 # are no results in the response.
3785 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
3786 # value format. For example:
3787 #
3788 # &quot;data&quot;: [
3789 # {
3790 # &quot;key&quot;: &quot;scope&quot;,
3791 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
3792 # }
3793 {
3794 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
3795 # returned. For example, for warnings where there are no results in a list
3796 # request for a particular zone, this key might be scope and
3797 # the key value might be the zone name. Other examples might be a key
3798 # indicating a deprecated resource and a suggested replacement, or a
3799 # warning about invalid network settings (for example, if an instance
3800 # attempts to perform IP forwarding but is not enabled for IP forwarding).
3801 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
3802 },
3803 ],
3804 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
3805 },
3806 },
3807 },
3808 &quot;kind&quot;: &quot;compute#urlMapsAggregatedList&quot;, # Output only. Type of resource.
3809 &quot;nextPageToken&quot;: &quot;A String&quot;, # [Output Only] This token allows you to get the next page of results for
3810 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
3811 # the query parameter pageToken in the next list request.
3812 # Subsequent list requests will have their own nextPageToken to
3813 # continue paging through the results.
3814 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource.
3815 &quot;unreachables&quot;: [ # Output only. [Output Only] Unreachable resources.
3816 &quot;A String&quot;,
3817 ],
3818 &quot;warning&quot;: { # [Output Only] Informational warning message.
3819 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
3820 # Engine returns NO_RESULTS_ON_PAGE if there
3821 # are no results in the response.
3822 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
3823 # value format. For example:
3824 #
3825 # &quot;data&quot;: [
3826 # {
3827 # &quot;key&quot;: &quot;scope&quot;,
3828 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
3829 # }
3830 {
3831 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
3832 # returned. For example, for warnings where there are no results in a list
3833 # request for a particular zone, this key might be scope and
3834 # the key value might be the zone name. Other examples might be a key
3835 # indicating a deprecated resource and a suggested replacement, or a
3836 # warning about invalid network settings (for example, if an instance
3837 # attempts to perform IP forwarding but is not enabled for IP forwarding).
3838 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
3839 },
3840 ],
3841 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
3842 },
3843 }</pre>
3844 </div>
3845
3846 <div class="method">
3847 <code class="details" id="aggregatedList_next">aggregatedList_next()</code>
3848 <pre>Retrieves the next page of results.
3849
3850 Args:
3851 previous_request: The request for the previous page. (required)
3852 previous_response: The response from the request for the previous page. (required)
3853
3854 Returns:
3855 A request object that you can call &#x27;execute()&#x27; on to request the next
3856 page. Returns None if there are no more items in the collection.
3857 </pre>
3858 </div>
3859
3860 <div class="method">
3861 <code class="details" id="close">close()</code>
3862 <pre>Close httplib2 connections.</pre>
3863 </div>
3864
3865 <div class="method">
3866 <code class="details" id="delete">delete(project, urlMap, requestId=None, x__xgafv=None)</code>
3867 <pre>Deletes the specified UrlMap resource.
3868
3869 Args:
3870 project: string, Project ID for this request. (required)
3871 urlMap: string, Name of the UrlMap resource to delete. (required)
3872 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
3873 that if you must retry your request, the server will know to ignore the
3874 request if it has already been completed.
3875
3876 For example, consider a situation where you make an initial request and
3877 the request times out. If you make the request again with the same
3878 request ID, the server can check if original operation with the same
3879 request ID was received, and if so, will ignore the second request. This
3880 prevents clients from accidentally creating duplicate commitments.
3881
3882 The request ID must be
3883 a valid UUID with the exception that zero UUID is not supported
3884 (00000000-0000-0000-0000-000000000000).
3885 x__xgafv: string, V1 error format.
3886 Allowed values
3887 1 - v1 error format
3888 2 - v2 error format
3889
3890 Returns:
3891 An object of the form:
3892
3893 { # Represents an Operation resource.
3894 #
3895 # Google Compute Engine has three Operation resources:
3896 #
3897 # * [Global](/compute/docs/reference/rest/v1/globalOperations)
3898 # * [Regional](/compute/docs/reference/rest/v1/regionOperations)
3899 # * [Zonal](/compute/docs/reference/rest/v1/zoneOperations)
3900 #
3901 # You can use an operation resource to manage asynchronous API requests.
3902 # For more information, readHandling
3903 # API responses.
3904 #
3905 # Operations can be global, regional or zonal.
3906 #
3907 # - For global operations, use the `globalOperations`
3908 # resource.
3909 # - For regional operations, use the
3910 # `regionOperations` resource.
3911 # - For zonal operations, use
3912 # the `zoneOperations` resource.
3913 #
3914 #
3915 #
3916 # For more information, read
3917 # Global, Regional, and Zonal Resources.
3918 #
3919 # Note that completed Operation resources have a limited
3920 # retention period.
3921 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
3922 # Not present otherwise.
3923 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
3924 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
3925 # set when the operation is created.
3926 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
3927 # text format.
3928 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
3929 # this field will be populated.
3930 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
3931 # operation.
3932 {
3933 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
3934 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
3935 # details. There is a set of defined message types to use for providing
3936 # details.The syntax depends on the error code. For example,
3937 # QuotaExceededInfo will have details when the error code is
3938 # QUOTA_EXCEEDED.
3939 {
3940 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
3941 #
3942 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
3943 # is not enabled:
3944 #
3945 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
3946 # &quot;domain&quot;: &quot;googleapis.com&quot;
3947 # &quot;metadata&quot;: {
3948 # &quot;resource&quot;: &quot;projects/123&quot;,
3949 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
3950 # }
3951 # }
3952 #
3953 # This response indicates that the pubsub.googleapis.com API is not enabled.
3954 #
3955 # Example of an error that is returned when attempting to create a Spanner
3956 # instance in a region that is out of stock:
3957 #
3958 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
3959 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
3960 # &quot;metadata&quot;: {
3961 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
3962 # }
3963 # }
3964 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
3965 # is typically the registered service name of the tool or product that
3966 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
3967 # generated by some common infrastructure, the error domain must be a
3968 # globally unique value that identifies the infrastructure. For Google API
3969 # infrastructure, the error domain is &quot;googleapis.com&quot;.
3970 &quot;metadatas&quot;: { # Additional structured details about this error.
3971 #
3972 # Keys must match a regular expression of `a-z+` but should
3973 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
3974 # length. When identifying the current value of an exceeded limit, the units
3975 # should be contained in the key, not the value. For example, rather than
3976 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
3977 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
3978 # instances that can be created in a single (batch) request.
3979 &quot;a_key&quot;: &quot;A String&quot;,
3980 },
3981 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
3982 # proximate cause of the error. Error reasons are unique within a particular
3983 # domain of errors. This should be at most 63 characters and match a
3984 # regular expression of `A-Z+[A-Z0-9]`, which represents
3985 # UPPER_SNAKE_CASE.
3986 },
3987 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
3988 #
3989 # For example, if a quota check failed with an error indicating the calling
3990 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
3991 # directly to the right place in the developer console to flip the bit.
3992 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
3993 { # Describes a URL link.
3994 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
3995 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
3996 },
3997 ],
3998 },
3999 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
4000 # which can be attached to an RPC error.
4001 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
4002 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
4003 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
4004 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
4005 },
4006 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
4007 &quot;dimensions&quot;: { # The map holding related quota dimensions.
4008 &quot;a_key&quot;: &quot;A String&quot;,
4009 },
4010 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
4011 # type or metric.
4012 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
4013 # or metric.
4014 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
4015 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
4016 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
4017 },
4018 },
4019 ],
4020 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
4021 # This property is optional.
4022 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
4023 },
4024 ],
4025 },
4026 &quot;getVersionOperationMetadata&quot;: {
4027 &quot;inlineSbomInfo&quot;: {
4028 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
4029 # appropriate identifiers.
4030 &quot;a_key&quot;: &quot;A String&quot;,
4031 },
4032 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
4033 # identifiers.
4034 &quot;a_key&quot;: &quot;A String&quot;,
4035 },
4036 },
4037 },
4038 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
4039 # message that was returned, such as `NOT FOUND`.
4040 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
4041 # status code that was returned. For example, a `404` means the
4042 # resource was not found.
4043 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
4044 # defined by the server.
4045 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
4046 # This value is inRFC3339
4047 # text format.
4048 &quot;instancesBulkInsertOperationMetadata&quot;: {
4049 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
4050 # Example key: zones/us-central1-a
4051 &quot;a_key&quot;: {
4052 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
4053 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
4054 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
4055 # error.
4056 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
4057 # if the flow is rolling forward or rolling back.
4058 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
4059 },
4060 },
4061 },
4062 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
4063 # Operation resources.
4064 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
4065 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
4066 # group of operations results from a `bulkInsert` API request.
4067 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
4068 # `update`, or `delete`, and so on.
4069 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
4070 # There is no requirement that this be linear or support any granularity of
4071 # operations. This should not be used to guess when the operation will be
4072 # complete. This number should monotonically increase as the operation
4073 # progresses.
4074 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
4075 # applicable when performing regional operations.
4076 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
4077 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
4078 # this field will contain information on all underlying zonal actions and
4079 # their state.
4080 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
4081 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
4082 # Example key: zones/us-central1-a
4083 &quot;a_key&quot;: {
4084 &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
4085 # populated.
4086 # different programming environments, including REST APIs and RPC APIs. It is
4087 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
4088 # three pieces of data: error code, error message, and error details.
4089 #
4090 # You can find out more about this error model and how to work with it in the
4091 # [API Design Guide](https://cloud.google.com/apis/design/errors).
4092 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
4093 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
4094 # message types for APIs to use.
4095 {
4096 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
4097 },
4098 ],
4099 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
4100 # user-facing error message should be localized and sent in the
4101 # google.rpc.Status.details field, or localized by the client.
4102 },
4103 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
4104 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
4105 },
4106 },
4107 },
4108 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
4109 # This value is inRFC3339
4110 # text format.
4111 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
4112 # following:
4113 # `PENDING`, `RUNNING`, or `DONE`.
4114 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
4115 # operation.
4116 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
4117 # of the target resource.
4118 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
4119 # operations related to creating a snapshot, this points to the disk
4120 # that the snapshot was created from.
4121 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
4122 # `[email protected]` or
4123 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
4124 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
4125 # operation, this field will be populated.
4126 {
4127 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
4128 # Engine returns NO_RESULTS_ON_PAGE if there
4129 # are no results in the response.
4130 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
4131 # value format. For example:
4132 #
4133 # &quot;data&quot;: [
4134 # {
4135 # &quot;key&quot;: &quot;scope&quot;,
4136 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
4137 # }
4138 {
4139 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
4140 # returned. For example, for warnings where there are no results in a list
4141 # request for a particular zone, this key might be scope and
4142 # the key value might be the zone name. Other examples might be a key
4143 # indicating a deprecated resource and a suggested replacement, or a
4144 # warning about invalid network settings (for example, if an instance
4145 # attempts to perform IP forwarding but is not enabled for IP forwarding).
4146 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
4147 },
4148 ],
4149 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
4150 },
4151 ],
4152 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
4153 # applicable when performing per-zone operations.
4154 }</pre>
4155 </div>
4156
4157 <div class="method">
4158 <code class="details" id="get">get(project, urlMap, x__xgafv=None)</code>
4159 <pre>Returns the specified UrlMap resource.
4160
4161 Args:
4162 project: string, Project ID for this request. (required)
4163 urlMap: string, Name of the UrlMap resource to return. (required)
4164 x__xgafv: string, V1 error format.
4165 Allowed values
4166 1 - v1 error format
4167 2 - v2 error format
4168
4169 Returns:
4170 An object of the form:
4171
4172 { # Represents a URL Map resource.
4173 #
4174 # Compute Engine has two URL Map resources:
4175 #
4176 # * [Global](/compute/docs/reference/rest/v1/urlMaps)
4177 # * [Regional](/compute/docs/reference/rest/v1/regionUrlMaps)
4178 #
4179 # A URL map resource is a component of certain types of cloud load balancers
4180 # and Traffic Director:
4181 #
4182 # * urlMaps are used by global external Application Load
4183 # Balancers, classic Application Load Balancers, and cross-region internal
4184 # Application Load Balancers.
4185 # * regionUrlMaps are used by internal Application Load Balancers,
4186 # regional external Application Load Balancers and regional internal
4187 # Application Load Balancers.
4188 #
4189 # For a list of supported URL map features by the load balancer type, see the
4190 # Load balancing features: Routing and traffic management table.
4191 #
4192 # For a list of supported URL map features for Traffic Director, see the
4193 # Traffic Director features: Routing and traffic management table.
4194 #
4195 # This resource defines mappings from hostnames and URL paths to either a
4196 # backend service or a backend bucket.
4197 #
4198 # To use the global urlMaps resource, the backend service must
4199 # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
4200 # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
4201 # information, read URL
4202 # Map Concepts.
4203 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
4204 # text format.
4205 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
4206 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
4207 #
4208 # This policy takes
4209 # effect at the load balancer level and applies only when no policy has been
4210 # defined for the error code at lower levels like PathMatcher, RouteRule and
4211 # PathRule within this UrlMap.
4212 #
4213 # For example, consider a UrlMap with the
4214 # following configuration:
4215 #
4216 #
4217 # - defaultCustomErrorResponsePolicy containing policies for
4218 # responding to 5xx and 4xx errors
4219 # - A PathMatcher configured for *.example.com has
4220 # defaultCustomErrorResponsePolicy for 4xx.
4221 #
4222 # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
4223 # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
4224 # a request that does not match any host in *.example.com such
4225 # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
4226 # takes effect.
4227 #
4228 # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
4229 # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
4230 # a retry, if load balancer is successful in reaching the
4231 # service, the defaultCustomErrorResponsePolicy is ignored and
4232 # the response from the service is returned to the client.
4233 #
4234 # defaultCustomErrorResponsePolicy is supported only for
4235 # global external Application Load Balancers.
4236 # backend service or backend bucket responds with an error.
4237 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
4238 #
4239 # In a given policy, if you specify rules for both a range of error codes
4240 # as well as rules for specific error codes then rules with specific error
4241 # codes have a higher priority. For example, assume that you configure a rule
4242 # for 401 (Un-authorized) code, and another for all 4 series
4243 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
4244 # However if the backend service returns a 403, the rule for4xx takes effect.
4245 { # Specifies the mapping between the response code that will be returned along
4246 # with the custom error content and the response code returned by the backend
4247 # service.
4248 &quot;matchResponseCodes&quot;: [ # Valid values include:
4249 #
4250 #
4251 # - A number between 400 and 599: For example
4252 # 401 or 503, in which case the load balancer
4253 # applies the policy if the error code exactly matches this value.
4254 # - 5xx: Load Balancer will apply the policy if the
4255 # backend service responds with any response code in the range of
4256 # 500 to 599.
4257 # - 4xx: Load
4258 # Balancer will apply the policy if the backend service responds with any
4259 # response code in the range of 400 to
4260 # 499.
4261 #
4262 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
4263 &quot;A String&quot;,
4264 ],
4265 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
4266 # error content. If overrideResponseCode is not supplied, the
4267 # same response code returned by the original backend bucket or backend
4268 # service is returned to the client.
4269 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
4270 #
4271 # path must start
4272 # with a leading slash. path cannot have trailing slashes.
4273 #
4274 # If the file is not available in backendBucket or the
4275 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
4276 #
4277 # The value must
4278 # be from 1 to 1024 characters
4279 },
4280 ],
4281 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
4282 # contains the custom error content. Examples are:
4283 #
4284 #
4285 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
4286 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
4287 # - global/backendBuckets/myBackendBucket
4288 #
4289 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
4290 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
4291 #
4292 # If load balancer cannot reach
4293 # the backendBucket, a simple Not Found Error will
4294 # be returned, with the original response code (oroverrideResponseCode if configured).
4295 #
4296 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
4297 },
4298 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
4299 # hostRules match. The load balancer performs advanced routing
4300 # actions, such as URL rewrites and header transformations, before forwarding
4301 # the request to the selected backend.
4302 #
4303 #
4304 # Only one of defaultUrlRedirect, defaultService
4305 # or defaultRouteAction.weightedBackendService can be set.
4306 #
4307 #
4308 # URL maps for classic Application Load Balancers only support
4309 # the urlRewrite action within defaultRouteAction.
4310 #
4311 #
4312 # defaultRouteAction has no effect when the URL map is bound
4313 # to a target gRPC proxy that has the validateForProxyless field
4314 # set to true.
4315 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
4316 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
4317 # property must be specified. This policy cannot be specified if any target
4318 # backend has Identity-Aware Proxy enabled.
4319 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
4320 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
4321 # header names can be specified. The cache is bypassed for all `cacheMode`
4322 # values.
4323 &quot;A String&quot;,
4324 ],
4325 &quot;cacheKeyPolicy&quot;: { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
4326 # on the backend type: for Backend Services, the complete request URI is
4327 # used; for Backend Buckets, the request URI is used without the protocol or
4328 # host, and only query parameters known to Cloud Storage are included.
4329 # Policy defined on Route Action.
4330 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
4331 # parameters will be included. Either specify `excludedQueryParameters`
4332 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
4333 # encoded and not treated as delimiters.
4334 #
4335 # Note: This field applies to routes that use backend services. Attempting
4336 # to set it on a route that points exclusively to Backend Buckets will
4337 # result in a configuration error. For routes that point to a Backend
4338 # Bucket, use `includedQueryParameters` to define which parameters should
4339 # be part of the cache key.
4340 &quot;A String&quot;,
4341 ],
4342 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
4343 #
4344 # Note: This setting is only applicable to routes that use a Backend
4345 # Service. It does not affect requests served by a Backend Bucket, as the
4346 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
4347 # it on a route that points exclusively to Backend Buckets will result in a
4348 # configuration error.
4349 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
4350 #
4351 # Note: This setting is only applicable to routes that use a Backend
4352 # Service. It does not affect requests served by a Backend Bucket, as the
4353 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
4354 # set on a route that points exclusively to Backend Buckets will result in
4355 # a configuration error.
4356 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
4357 # `includedQueryParameters` and `excludedQueryParameters`. If neither
4358 # is set, the entire query string will be included. If false, the query
4359 # string will be excluded from the cache key entirely.
4360 #
4361 # Note: This field applies to routes that use backend services. Attempting
4362 # to set it on a route that points exclusively to Backend Buckets will
4363 # result in a configuration error. For routes that point to a Backend
4364 # Bucket, use `includedQueryParameters` to define which parameters should
4365 # be part of the cache key.
4366 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
4367 # The name=value pair will be used in the cache key Cloud CDN generates.
4368 #
4369 # Note: This setting is only applicable to routes that use a Backend
4370 # Service. It does not affect requests served by a Backend Bucket.
4371 # Attempting to set it on a route that points exclusively to Backend
4372 # Buckets will result in a configuration error. Up to 5 cookie names can be
4373 # specified.
4374 &quot;A String&quot;,
4375 ],
4376 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
4377 &quot;A String&quot;,
4378 ],
4379 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
4380 # parameters will be excluded. Either specify `includedQueryParameters`
4381 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
4382 # encoded and not treated as delimiters.
4383 &quot;A String&quot;,
4384 ],
4385 },
4386 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
4387 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
4388 &quot;clientTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
4389 # content. This is used to clamp the max-age (or Expires) value sent to the
4390 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
4391 # is used for the response max-age directive, along with a &quot;public&quot;
4392 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
4393 # clamps the max-age from the origin (if specified), or else sets the
4394 # response max-age directive to the lesser of the `clientTtl` and
4395 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
4396 # present. The maximum allowed value is 31,622,400s (1 year). If not
4397 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
4398 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
4399 # `USE_ORIGIN_HEADERS`.
4400 # as a count of seconds and fractions of seconds at nanosecond
4401 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4402 # or &quot;month&quot;. Range is approximately 10,000 years.
4403 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4404 # Durations less than one second are represented with a 0
4405 # `seconds` field and a positive `nanos` field. Must be from 0
4406 # to 999,999,999 inclusive.
4407 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4408 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4409 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4410 },
4411 &quot;defaultTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
4412 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
4413 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
4414 # greater than that of `maxTtl`. When the `cacheMode` is set to
4415 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
4416 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
4417 # accessed objects may be evicted from the cache before the defined TTL. If
4418 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
4419 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
4420 # `USE_ORIGIN_HEADERS`.
4421 # as a count of seconds and fractions of seconds at nanosecond
4422 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4423 # or &quot;month&quot;. Range is approximately 10,000 years.
4424 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4425 # Durations less than one second are represented with a 0
4426 # `seconds` field and a positive `nanos` field. Must be from 0
4427 # to 999,999,999 inclusive.
4428 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4429 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4430 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4431 },
4432 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
4433 # attempt to set a max-age or s-maxage higher than this, or an Expires header
4434 # more than `maxTtl` seconds in the future will be capped at the value of
4435 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
4436 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
4437 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
4438 # Infrequently accessed objects may be evicted from the cache before the
4439 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
4440 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
4441 # mode.
4442 # as a count of seconds and fractions of seconds at nanosecond
4443 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4444 # or &quot;month&quot;. Range is approximately 10,000 years.
4445 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4446 # Durations less than one second are represented with a 0
4447 # `seconds` field and a positive `nanos` field. Must be from 0
4448 # to 999,999,999 inclusive.
4449 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4450 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4451 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4452 },
4453 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
4454 # to apply fine-grained caching for common errors or redirects.
4455 # This can reduce the load on your origin and improve end-user
4456 # experience by reducing response latency.
4457 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
4458 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
4459 # the specified response code that lack any Cache-Control, Expires, or
4460 # Pragma: no-cache directives. When the `cacheMode` is set to
4461 # `FORCE_CACHE_ALL`, negative caching applies to all responses
4462 # with the specified response code, and overrides any caching headers. By
4463 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
4464 #
4465 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
4466 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
4467 # * 405 (Method Not Found), 501 (Not Implemented): 60s
4468 #
4469 # These defaults can be overridden in `negativeCachingPolicy`.
4470 # If not specified, Cloud CDN applies negative caching by default.
4471 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
4472 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
4473 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
4474 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
4475 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
4476 # all response codes that you wish to cache. Cloud CDN will not apply any
4477 # default negative caching when a policy exists.
4478 { # Specify CDN TTLs for response error codes.
4479 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
4480 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
4481 # specified as values, and you cannot specify a status code more than
4482 # once.
4483 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
4484 # corresponding status code.
4485 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
4486 # objects may be evicted from the cache before the defined TTL.
4487 # as a count of seconds and fractions of seconds at nanosecond
4488 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4489 # or &quot;month&quot;. Range is approximately 10,000 years.
4490 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4491 # Durations less than one second are represented with a 0
4492 # `seconds` field and a positive `nanos` field. Must be from 0
4493 # to 999,999,999 inclusive.
4494 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4495 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4496 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4497 },
4498 },
4499 ],
4500 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
4501 # requests into a small number of requests to the origin. If not specified,
4502 # Cloud CDN applies request coalescing by default.
4503 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
4504 # content with the origin, or when an error is encountered when refreshing
4505 # the cache.
4506 # This setting defines the default &quot;max-stale&quot; duration for any cached
4507 # responses that do not specify a max-stale directive. Stale responses that
4508 # exceed the TTL configured here will not be served. The default limit
4509 # (max-stale) is 86400s (1 day), which will allow stale content to be
4510 # served up to this limit beyond the max-age (or s-maxage) of a cached
4511 # response.
4512 # The maximum allowed value is 604800 (1 week).
4513 # Set this to zero (0) to disable serve-while-stale.
4514 # as a count of seconds and fractions of seconds at nanosecond
4515 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4516 # or &quot;month&quot;. Range is approximately 10,000 years.
4517 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4518 # Durations less than one second are represented with a 0
4519 # `seconds` field and a positive `nanos` field. Must be from 0
4520 # to 999,999,999 inclusive.
4521 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4522 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4523 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4524 },
4525 },
4526 &quot;corsPolicy&quot;: { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
4527 # information about the W3C recommendation for cross-origin resource sharing
4528 # (CORS), see Fetch API Living
4529 # Standard.
4530 #
4531 # Not supported when the URL map is bound to a target gRPC proxy.
4532 # information about the W3C recommendation for cross-origin resource sharing
4533 # (CORS), see Fetch API Living
4534 # Standard.
4535 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
4536 # indicates that
4537 # the actual request can include user credentials. This field translates to
4538 # the Access-Control-Allow-Credentials header.
4539 #
4540 # Default is false.
4541 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
4542 # header.
4543 &quot;A String&quot;,
4544 ],
4545 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
4546 # header.
4547 &quot;A String&quot;,
4548 ],
4549 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
4550 # more information, see regular expression syntax.
4551 #
4552 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
4553 #
4554 # Regular expressions can only be used when the loadBalancingScheme is
4555 # set to INTERNAL_SELF_MANAGED.
4556 &quot;A String&quot;,
4557 ],
4558 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
4559 #
4560 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
4561 &quot;A String&quot;,
4562 ],
4563 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
4564 # The default value is false, which indicates that the CORS
4565 # policy is in effect.
4566 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
4567 # header.
4568 &quot;A String&quot;,
4569 ],
4570 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
4571 # seconds. This field translates to the Access-Control-Max-Age
4572 # header.
4573 },
4574 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
4575 # the resiliency of clients to backend service failure. As part of fault
4576 # injection, when clients send requests to a backend service, delays can be
4577 # introduced by a load balancer on a percentage of requests before sending
4578 # those requests to the backend service. Similarly requests from clients can
4579 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
4580 # that are configured with a fault_injection_policy if:
4581 # 1. The traffic is generated by fault injection AND
4582 # 2. The fault injection is not a delay fault injection.
4583 # Fault injection is not supported with the classic Application Load Balancer
4584 # . To see which load balancers support fault injection,
4585 # see Load
4586 # balancing: Routing and traffic management features.
4587 # the resiliency of clients to backend service failure. As part of fault
4588 # injection, when clients send requests to a backend service, delays can be
4589 # introduced by the load balancer on a percentage of requests before sending
4590 # those request to the backend service. Similarly requests from clients can be
4591 # aborted by the load balancer for a percentage of requests.
4592 &quot;abort&quot;: { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
4593 # injection.
4594 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
4595 #
4596 # The value must be from 200 to 599 inclusive.
4597 #
4598 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
4599 # according to this
4600 # mapping table. HTTP status 200 is mapped to gRPC status
4601 # UNKNOWN. Injecting an OK status is currently not supported by
4602 # Traffic Director.
4603 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
4604 # that is aborted as part of fault injection.
4605 #
4606 # The value must be from 0.0 to 100.0 inclusive.
4607 },
4608 &quot;delay&quot;: { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
4609 # injection, before being sent to a backend service.
4610 # request to the backend service as part of fault injection.
4611 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
4612 # as a count of seconds and fractions of seconds at nanosecond
4613 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4614 # or &quot;month&quot;. Range is approximately 10,000 years.
4615 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4616 # Durations less than one second are represented with a 0
4617 # `seconds` field and a positive `nanos` field. Must be from 0
4618 # to 999,999,999 inclusive.
4619 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4620 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4621 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4622 },
4623 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
4624 # which a delay is introduced as part of fault injection.
4625 #
4626 # The value must be from 0.0 to 100.0 inclusive.
4627 },
4628 },
4629 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
4630 # Unlike the timeout field where the timeout duration starts
4631 # from the time the request has been fully processed (known as*end-of-stream*),
4632 # the duration in this field is computed from the beginning of the stream
4633 # until the response has been processed, including all retries. A
4634 # stream that does not complete in this duration is closed.
4635 #
4636 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
4637 # with the route.
4638 #
4639 # This field is only allowed if the Url map is used with backend services
4640 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
4641 # as a count of seconds and fractions of seconds at nanosecond
4642 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4643 # or &quot;month&quot;. Range is approximately 10,000 years.
4644 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4645 # Durations less than one second are represented with a 0
4646 # `seconds` field and a positive `nanos` field. Must be from 0
4647 # to 999,999,999 inclusive.
4648 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4649 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4650 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4651 },
4652 &quot;requestMirrorPolicy&quot;: { # A policy that specifies how requests intended for the route&#x27;s backends # Specifies the policy on how requests intended for the route&#x27;s backends
4653 # are shadowed to a separate mirrored backend service. The load balancer does
4654 # not wait for responses from the shadow service. Before sending traffic
4655 # to the shadow service, the host / authority header is suffixed with-shadow.
4656 #
4657 # Not supported when the URL map is bound to a target gRPC proxy that
4658 # has the validateForProxyless field set to true.
4659 # are shadowed to a separate mirrored backend service. The load balancer
4660 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
4661 # to the shadow service, the host or authority header is suffixed with-shadow.
4662 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
4663 # mirrored to.
4664 #
4665 # The backend service configured for a mirroring
4666 # policy must reference backends that are of the same type as the original
4667 # backend service matched in the URL map.
4668 #
4669 # Serverless NEG backends are not currently supported as a mirrored
4670 # backend service.
4671 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
4672 },
4673 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
4674 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
4675 # If not specified, defaults to 1.
4676 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
4677 #
4678 # If not specified, will use the timeout set in theHttpRouteAction field.
4679 # If timeout in the HttpRouteAction field is not set, this field
4680 # uses the largest timeout
4681 # among all backend services associated with the route.
4682 #
4683 # Not supported when the URL map is bound to a target gRPC proxy that
4684 # has the validateForProxyless field set to true.
4685 # as a count of seconds and fractions of seconds at nanosecond
4686 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4687 # or &quot;month&quot;. Range is approximately 10,000 years.
4688 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4689 # Durations less than one second are represented with a 0
4690 # `seconds` field and a positive `nanos` field. Must be from 0
4691 # to 999,999,999 inclusive.
4692 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4693 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4694 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4695 },
4696 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
4697 # values are:
4698 #
4699 # - 5xx: retry is attempted if the instance or endpoint
4700 # responds with any 5xx response code, or if the instance or
4701 # endpoint does not respond at all. For example, disconnects, reset, read
4702 # timeout, connection failure, and refused streams.
4703 # - gateway-error: Similar to 5xx, but only
4704 # applies to response codes 502, 503 or504.
4705 # - connect-failure: a retry is attempted on failures
4706 # connecting to the instance or endpoint. For example, connection
4707 # timeouts.
4708 # - retriable-4xx: a retry is attempted if the instance
4709 # or endpoint responds with a 4xx response code.
4710 # The only error that you can retry is error code 409.
4711 # - refused-stream: a retry is attempted if the instance
4712 # or endpoint resets the stream with a REFUSED_STREAM error
4713 # code. This reset type indicates that it is safe to retry.
4714 # - cancelled: a retry is attempted if the gRPC status
4715 # code in the response header is set to cancelled.
4716 # - deadline-exceeded: a retry is attempted if the gRPC
4717 # status code in the response header is set todeadline-exceeded.
4718 # - internal: a retry is attempted if the gRPC
4719 # status code in the response header is set tointernal.
4720 # - resource-exhausted: a retry is attempted if the gRPC
4721 # status code in the response header is set toresource-exhausted.
4722 # - unavailable: a retry is attempted if the gRPC
4723 # status code in the response header is set tounavailable.
4724 #
4725 # Only the following codes are supported when the URL map is bound to
4726 # target gRPC proxy that has validateForProxyless field set to true.
4727 #
4728 # - cancelled
4729 # - deadline-exceeded
4730 # - internal
4731 # - resource-exhausted
4732 # - unavailable
4733 &quot;A String&quot;,
4734 ],
4735 },
4736 &quot;timeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
4737 # time the request has been fully processed (known as *end-of-stream*)
4738 # up until the response has been processed. Timeout includes
4739 # all retries.
4740 #
4741 # If not specified, this field uses the largest timeout among all backend
4742 # services associated with the route.
4743 #
4744 # Not supported when the URL map is bound to a target gRPC proxy that
4745 # has validateForProxyless field set to true.
4746 # as a count of seconds and fractions of seconds at nanosecond
4747 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4748 # or &quot;month&quot;. Range is approximately 10,000 years.
4749 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4750 # Durations less than one second are represented with a 0
4751 # `seconds` field and a positive `nanos` field. Must be from 0
4752 # to 999,999,999 inclusive.
4753 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4754 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4755 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4756 },
4757 &quot;urlRewrite&quot;: { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
4758 # to the matched service.
4759 #
4760 # urlRewrite is the only action supported in UrlMaps
4761 # for classic Application Load Balancers.
4762 #
4763 # Not supported when the URL map is bound to a target gRPC proxy that
4764 # has the validateForProxyless field set to true.
4765 # backend service.
4766 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
4767 # host header is replaced with contents of hostRewrite.
4768 #
4769 # The value must be from 1 to 255 characters.
4770 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
4771 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
4772 #
4773 # The value must be from 1 to 1024 characters.
4774 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
4775 # header) using the HTTP template syntax.
4776 #
4777 # A corresponding
4778 # path_template_match must be specified. Any template variables must exist in
4779 # the path_template_match field.
4780 #
4781 #
4782 # - -At least one variable must be specified in the path_template_match
4783 # field
4784 # - You can omit variables from the rewritten URL
4785 # - The * and ** operators cannot be matched
4786 # unless they have a corresponding variable name - e.g.
4787 # {format=*} or {var=**}.
4788 #
4789 # For example, a path_template_match of /static/{format=**}
4790 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
4791 # rewrite, so that /{country}/{format}/{suffix=**} can be
4792 # rewritten as /content/{format}/{country}/{suffix}.
4793 #
4794 # At least
4795 # one non-empty routeRules[].matchRules[].path_template_match is
4796 # required.
4797 #
4798 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
4799 },
4800 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
4801 # occurs. The weights determine the fraction of traffic that flows to
4802 # their corresponding backend service. If all traffic needs to
4803 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
4804 #
4805 # After a backend service is identified and before forwarding
4806 # the request to
4807 # the backend service, advanced routing actions such as URL rewrites and
4808 # header transformations are applied depending on additional settings
4809 # specified in this HttpRouteAction.
4810 { # In contrast to a single BackendService in
4811 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
4812 # multiple backend services. The volume of traffic for each
4813 # backend service is proportional to the weight specified
4814 # in each WeightedBackendService
4815 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
4816 # resource. Before
4817 # forwarding the request to backendService, the load balancer
4818 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
4819 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
4820 # effect for the selected backendService.
4821 #
4822 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
4823 #
4824 # headerAction is not supported for load balancers that have
4825 # their loadBalancingScheme set to EXTERNAL.
4826 #
4827 # Not supported when the URL map is bound to a target gRPC proxy that
4828 # has validateForProxyless field set to true.
4829 # the request is passed along to the selected backendService.
4830 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
4831 { # Specification determining how headers are added to requests or responses.
4832 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
4833 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
4834 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
4835 # that already
4836 # exist for the header. If true, headerValue is set for the
4837 # header, discarding any values that were set for that header.
4838 #
4839 # The default value is true,
4840 # unless a variable is present in headerValue,
4841 # in which case the default value is false.
4842 # .
4843 },
4844 ],
4845 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
4846 # request before forwarding the request to the backendService.
4847 &quot;A String&quot;,
4848 ],
4849 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
4850 # client.
4851 { # Specification determining how headers are added to requests or responses.
4852 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
4853 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
4854 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
4855 # that already
4856 # exist for the header. If true, headerValue is set for the
4857 # header, discarding any values that were set for that header.
4858 #
4859 # The default value is true,
4860 # unless a variable is present in headerValue,
4861 # in which case the default value is false.
4862 # .
4863 },
4864 ],
4865 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
4866 # response before sending the response back to the client.
4867 &quot;A String&quot;,
4868 ],
4869 },
4870 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
4871 # computed asweight / (sum of all weightedBackendService weights in routeAction).
4872 #
4873 # The selection of a backend service is determined only for new traffic.
4874 # Once a user&#x27;s request has been directed to a backend service,
4875 # subsequent requests are sent to the same backend service as
4876 # determined by the backend service&#x27;s session affinity policy.
4877 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
4878 # splitting. If you do, the weighted traffic splitting configuration takes
4879 # precedence.
4880 #
4881 # The value must be from 0 to 1000.
4882 },
4883 ],
4884 },
4885 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL of the defaultService resource to
4886 # which traffic is directed if none of the hostRules match.
4887 # If defaultRouteAction is also specified, advanced
4888 # routing actions, such as URL rewrites, take effect before sending the
4889 # request to the backend.
4890 #
4891 #
4892 # Only one of defaultUrlRedirect, defaultService
4893 # or defaultRouteAction.weightedBackendService can be set.
4894 #
4895 #
4896 # defaultService has no effect when the URL map is bound
4897 # to a target gRPC proxy that has the validateForProxyless field
4898 # set to true.
4899 &quot;defaultUrlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
4900 # is redirected to a URL specified by defaultUrlRedirect.
4901 #
4902 #
4903 # Only one of defaultUrlRedirect, defaultService
4904 # or defaultRouteAction.weightedBackendService can be set.
4905 #
4906 #
4907 # Not supported when the URL map is bound to a target gRPC proxy.
4908 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
4909 # was supplied in the request.
4910 #
4911 # The value must be from 1 to 255
4912 # characters.
4913 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
4914 # set to HTTPS.
4915 # If set to false, the URL scheme of the redirected request
4916 # remains the same as that of the request.
4917 #
4918 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
4919 #
4920 # The default is set to false.
4921 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
4922 # that was supplied in the request.
4923 #
4924 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
4925 # supplied, the path of the original request is used for the redirect.
4926 #
4927 # The value must be from 1 to 1024 characters.
4928 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
4929 # the HttpRouteRuleMatch, retaining the remaining portion
4930 # of the URL before redirecting the request.
4931 #
4932 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
4933 # supplied, the path of the original request is used for the redirect.
4934 #
4935 # The value must be from 1 to 1024 characters.
4936 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
4937 #
4938 # Supported values are:
4939 #
4940 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
4941 # to 301.
4942 # - FOUND, which corresponds to 302.
4943 # - SEE_OTHER which corresponds to 303.
4944 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
4945 # method is retained.
4946 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
4947 # method is retained.
4948 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
4949 # URL is
4950 # removed before redirecting the request. If set to false, the
4951 # query portion of the original URL is retained.
4952 #
4953 # The default is set to false.
4954 },
4955 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
4956 # create the resource.
4957 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. A hash of the contents stored in this object.
4958 # This field is used in optimistic locking. This field is ignored when
4959 # inserting a UrlMap. An up-to-date fingerprint must be provided
4960 # in order to update the UrlMap, otherwise the request will
4961 # fail with error 412 conditionNotMet.
4962 #
4963 # To see the latest fingerprint, make a get() request to
4964 # retrieve a UrlMap.
4965 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
4966 # for the selected backendService.
4967 #
4968 # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
4969 #
4970 # headerAction is not supported for load balancers
4971 # that have
4972 # their loadBalancingScheme set to EXTERNAL.
4973 #
4974 # Not supported when the URL map is bound to a target gRPC proxy that
4975 # has validateForProxyless field set to true.
4976 # the request is passed along to the selected backendService.
4977 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
4978 { # Specification determining how headers are added to requests or responses.
4979 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
4980 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
4981 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
4982 # that already
4983 # exist for the header. If true, headerValue is set for the
4984 # header, discarding any values that were set for that header.
4985 #
4986 # The default value is true,
4987 # unless a variable is present in headerValue,
4988 # in which case the default value is false.
4989 # .
4990 },
4991 ],
4992 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
4993 # request before forwarding the request to the backendService.
4994 &quot;A String&quot;,
4995 ],
4996 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
4997 # client.
4998 { # Specification determining how headers are added to requests or responses.
4999 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
5000 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
5001 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
5002 # that already
5003 # exist for the header. If true, headerValue is set for the
5004 # header, discarding any values that were set for that header.
5005 #
5006 # The default value is true,
5007 # unless a variable is present in headerValue,
5008 # in which case the default value is false.
5009 # .
5010 },
5011 ],
5012 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
5013 # response before sending the response back to the client.
5014 &quot;A String&quot;,
5015 ],
5016 },
5017 &quot;hostRules&quot;: [ # The list of host rules to use against the URL.
5018 { # UrlMaps
5019 # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
5020 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
5021 # create the resource.
5022 &quot;hosts&quot;: [ # The list of host patterns to match. They must be valid hostnames with
5023 # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
5024 # that case, * must be the first character, and if followed by
5025 # anything, the immediate following character must be either -
5026 # or ..
5027 #
5028 # * based matching is not supported when the URL map is bound
5029 # to a target gRPC proxy that has the validateForProxyless field
5030 # set to true.
5031 &quot;A String&quot;,
5032 ],
5033 &quot;pathMatcher&quot;: &quot;A String&quot;, # The name of the PathMatcher to use to match the path portion
5034 # of the URL if the hostRule matches the URL&#x27;s host portion.
5035 },
5036 ],
5037 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the resource. This identifier is
5038 # defined by the server.
5039 &quot;kind&quot;: &quot;compute#urlMap&quot;, # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
5040 # url maps.
5041 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
5042 # The name must be 1-63 characters long, and comply withRFC1035.
5043 # Specifically, the name must be 1-63 characters long and match the regular
5044 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
5045 # character must be a lowercase letter, and all following characters must
5046 # be a dash, lowercase letter, or digit, except the last character, which
5047 # cannot be a dash.
5048 &quot;pathMatchers&quot;: [ # The list of named PathMatchers to use against the URL.
5049 { # A matcher for the path portion of the URL. The BackendService
5050 # from the longest-matched rule will serve the URL. If no rule was matched, the
5051 # default service is used.
5052 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
5053 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
5054 #
5055 # This policy takes
5056 # effect at the PathMatcher level and applies only when no
5057 # policy has been defined for the error code at lower levels likeRouteRule and PathRule within thisPathMatcher. If an error code does not have a policy defined
5058 # in defaultCustomErrorResponsePolicy, then a policy defined for
5059 # the error code in UrlMap.defaultCustomErrorResponsePolicy
5060 # takes effect.
5061 #
5062 # For example, consider a UrlMap with the following
5063 # configuration:
5064 #
5065 #
5066 # - UrlMap.defaultCustomErrorResponsePolicy is configured
5067 # with policies for 5xx and 4xx errors
5068 # - A RouteRule for /coming_soon/ is configured for the
5069 # error code 404.
5070 #
5071 # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher&#x27;s policy
5072 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
5073 # the policy in RouteRule.customErrorResponsePolicy takes
5074 # effect. If any of the requests in this example encounter a 500
5075 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
5076 #
5077 # When
5078 # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
5079 # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
5080 # a retry, if load balancer is successful in reaching the
5081 # service, the defaultCustomErrorResponsePolicy is ignored and
5082 # the response from the service is returned to the client.
5083 #
5084 # defaultCustomErrorResponsePolicy is supported only for
5085 # global external Application Load Balancers.
5086 # backend service or backend bucket responds with an error.
5087 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
5088 #
5089 # In a given policy, if you specify rules for both a range of error codes
5090 # as well as rules for specific error codes then rules with specific error
5091 # codes have a higher priority. For example, assume that you configure a rule
5092 # for 401 (Un-authorized) code, and another for all 4 series
5093 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
5094 # However if the backend service returns a 403, the rule for4xx takes effect.
5095 { # Specifies the mapping between the response code that will be returned along
5096 # with the custom error content and the response code returned by the backend
5097 # service.
5098 &quot;matchResponseCodes&quot;: [ # Valid values include:
5099 #
5100 #
5101 # - A number between 400 and 599: For example
5102 # 401 or 503, in which case the load balancer
5103 # applies the policy if the error code exactly matches this value.
5104 # - 5xx: Load Balancer will apply the policy if the
5105 # backend service responds with any response code in the range of
5106 # 500 to 599.
5107 # - 4xx: Load
5108 # Balancer will apply the policy if the backend service responds with any
5109 # response code in the range of 400 to
5110 # 499.
5111 #
5112 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
5113 &quot;A String&quot;,
5114 ],
5115 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
5116 # error content. If overrideResponseCode is not supplied, the
5117 # same response code returned by the original backend bucket or backend
5118 # service is returned to the client.
5119 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
5120 #
5121 # path must start
5122 # with a leading slash. path cannot have trailing slashes.
5123 #
5124 # If the file is not available in backendBucket or the
5125 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
5126 #
5127 # The value must
5128 # be from 1 to 1024 characters
5129 },
5130 ],
5131 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
5132 # contains the custom error content. Examples are:
5133 #
5134 #
5135 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
5136 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
5137 # - global/backendBuckets/myBackendBucket
5138 #
5139 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
5140 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
5141 #
5142 # If load balancer cannot reach
5143 # the backendBucket, a simple Not Found Error will
5144 # be returned, with the original response code (oroverrideResponseCode if configured).
5145 #
5146 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
5147 },
5148 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
5149 # pathRules or routeRules match. The load balancer
5150 # performs advanced routing actions, such as URL rewrites and
5151 # header transformations, before forwarding the request to the
5152 # selected backend.
5153 #
5154 #
5155 # Only one of defaultUrlRedirect, defaultService
5156 # or defaultRouteAction.weightedBackendService can be set.
5157 #
5158 #
5159 # URL maps for classic Application Load Balancers only support
5160 # the urlRewrite action within a path matcher&#x27;sdefaultRouteAction.
5161 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
5162 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
5163 # property must be specified. This policy cannot be specified if any target
5164 # backend has Identity-Aware Proxy enabled.
5165 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
5166 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
5167 # header names can be specified. The cache is bypassed for all `cacheMode`
5168 # values.
5169 &quot;A String&quot;,
5170 ],
5171 &quot;cacheKeyPolicy&quot;: { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
5172 # on the backend type: for Backend Services, the complete request URI is
5173 # used; for Backend Buckets, the request URI is used without the protocol or
5174 # host, and only query parameters known to Cloud Storage are included.
5175 # Policy defined on Route Action.
5176 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
5177 # parameters will be included. Either specify `excludedQueryParameters`
5178 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
5179 # encoded and not treated as delimiters.
5180 #
5181 # Note: This field applies to routes that use backend services. Attempting
5182 # to set it on a route that points exclusively to Backend Buckets will
5183 # result in a configuration error. For routes that point to a Backend
5184 # Bucket, use `includedQueryParameters` to define which parameters should
5185 # be part of the cache key.
5186 &quot;A String&quot;,
5187 ],
5188 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
5189 #
5190 # Note: This setting is only applicable to routes that use a Backend
5191 # Service. It does not affect requests served by a Backend Bucket, as the
5192 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
5193 # it on a route that points exclusively to Backend Buckets will result in a
5194 # configuration error.
5195 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
5196 #
5197 # Note: This setting is only applicable to routes that use a Backend
5198 # Service. It does not affect requests served by a Backend Bucket, as the
5199 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
5200 # set on a route that points exclusively to Backend Buckets will result in
5201 # a configuration error.
5202 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
5203 # `includedQueryParameters` and `excludedQueryParameters`. If neither
5204 # is set, the entire query string will be included. If false, the query
5205 # string will be excluded from the cache key entirely.
5206 #
5207 # Note: This field applies to routes that use backend services. Attempting
5208 # to set it on a route that points exclusively to Backend Buckets will
5209 # result in a configuration error. For routes that point to a Backend
5210 # Bucket, use `includedQueryParameters` to define which parameters should
5211 # be part of the cache key.
5212 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
5213 # The name=value pair will be used in the cache key Cloud CDN generates.
5214 #
5215 # Note: This setting is only applicable to routes that use a Backend
5216 # Service. It does not affect requests served by a Backend Bucket.
5217 # Attempting to set it on a route that points exclusively to Backend
5218 # Buckets will result in a configuration error. Up to 5 cookie names can be
5219 # specified.
5220 &quot;A String&quot;,
5221 ],
5222 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
5223 &quot;A String&quot;,
5224 ],
5225 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
5226 # parameters will be excluded. Either specify `includedQueryParameters`
5227 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
5228 # encoded and not treated as delimiters.
5229 &quot;A String&quot;,
5230 ],
5231 },
5232 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
5233 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
5234 &quot;clientTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
5235 # content. This is used to clamp the max-age (or Expires) value sent to the
5236 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
5237 # is used for the response max-age directive, along with a &quot;public&quot;
5238 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
5239 # clamps the max-age from the origin (if specified), or else sets the
5240 # response max-age directive to the lesser of the `clientTtl` and
5241 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
5242 # present. The maximum allowed value is 31,622,400s (1 year). If not
5243 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
5244 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
5245 # `USE_ORIGIN_HEADERS`.
5246 # as a count of seconds and fractions of seconds at nanosecond
5247 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5248 # or &quot;month&quot;. Range is approximately 10,000 years.
5249 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5250 # Durations less than one second are represented with a 0
5251 # `seconds` field and a positive `nanos` field. Must be from 0
5252 # to 999,999,999 inclusive.
5253 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5254 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5255 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5256 },
5257 &quot;defaultTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
5258 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
5259 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
5260 # greater than that of `maxTtl`. When the `cacheMode` is set to
5261 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
5262 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
5263 # accessed objects may be evicted from the cache before the defined TTL. If
5264 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
5265 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
5266 # `USE_ORIGIN_HEADERS`.
5267 # as a count of seconds and fractions of seconds at nanosecond
5268 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5269 # or &quot;month&quot;. Range is approximately 10,000 years.
5270 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5271 # Durations less than one second are represented with a 0
5272 # `seconds` field and a positive `nanos` field. Must be from 0
5273 # to 999,999,999 inclusive.
5274 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5275 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5276 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5277 },
5278 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
5279 # attempt to set a max-age or s-maxage higher than this, or an Expires header
5280 # more than `maxTtl` seconds in the future will be capped at the value of
5281 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
5282 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
5283 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
5284 # Infrequently accessed objects may be evicted from the cache before the
5285 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
5286 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
5287 # mode.
5288 # as a count of seconds and fractions of seconds at nanosecond
5289 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5290 # or &quot;month&quot;. Range is approximately 10,000 years.
5291 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5292 # Durations less than one second are represented with a 0
5293 # `seconds` field and a positive `nanos` field. Must be from 0
5294 # to 999,999,999 inclusive.
5295 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5296 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5297 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5298 },
5299 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
5300 # to apply fine-grained caching for common errors or redirects.
5301 # This can reduce the load on your origin and improve end-user
5302 # experience by reducing response latency.
5303 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
5304 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
5305 # the specified response code that lack any Cache-Control, Expires, or
5306 # Pragma: no-cache directives. When the `cacheMode` is set to
5307 # `FORCE_CACHE_ALL`, negative caching applies to all responses
5308 # with the specified response code, and overrides any caching headers. By
5309 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
5310 #
5311 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
5312 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
5313 # * 405 (Method Not Found), 501 (Not Implemented): 60s
5314 #
5315 # These defaults can be overridden in `negativeCachingPolicy`.
5316 # If not specified, Cloud CDN applies negative caching by default.
5317 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
5318 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
5319 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
5320 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
5321 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
5322 # all response codes that you wish to cache. Cloud CDN will not apply any
5323 # default negative caching when a policy exists.
5324 { # Specify CDN TTLs for response error codes.
5325 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
5326 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
5327 # specified as values, and you cannot specify a status code more than
5328 # once.
5329 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
5330 # corresponding status code.
5331 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
5332 # objects may be evicted from the cache before the defined TTL.
5333 # as a count of seconds and fractions of seconds at nanosecond
5334 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5335 # or &quot;month&quot;. Range is approximately 10,000 years.
5336 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5337 # Durations less than one second are represented with a 0
5338 # `seconds` field and a positive `nanos` field. Must be from 0
5339 # to 999,999,999 inclusive.
5340 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5341 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5342 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5343 },
5344 },
5345 ],
5346 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
5347 # requests into a small number of requests to the origin. If not specified,
5348 # Cloud CDN applies request coalescing by default.
5349 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
5350 # content with the origin, or when an error is encountered when refreshing
5351 # the cache.
5352 # This setting defines the default &quot;max-stale&quot; duration for any cached
5353 # responses that do not specify a max-stale directive. Stale responses that
5354 # exceed the TTL configured here will not be served. The default limit
5355 # (max-stale) is 86400s (1 day), which will allow stale content to be
5356 # served up to this limit beyond the max-age (or s-maxage) of a cached
5357 # response.
5358 # The maximum allowed value is 604800 (1 week).
5359 # Set this to zero (0) to disable serve-while-stale.
5360 # as a count of seconds and fractions of seconds at nanosecond
5361 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5362 # or &quot;month&quot;. Range is approximately 10,000 years.
5363 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5364 # Durations less than one second are represented with a 0
5365 # `seconds` field and a positive `nanos` field. Must be from 0
5366 # to 999,999,999 inclusive.
5367 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5368 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5369 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5370 },
5371 },
5372 &quot;corsPolicy&quot;: { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
5373 # information about the W3C recommendation for cross-origin resource sharing
5374 # (CORS), see Fetch API Living
5375 # Standard.
5376 #
5377 # Not supported when the URL map is bound to a target gRPC proxy.
5378 # information about the W3C recommendation for cross-origin resource sharing
5379 # (CORS), see Fetch API Living
5380 # Standard.
5381 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
5382 # indicates that
5383 # the actual request can include user credentials. This field translates to
5384 # the Access-Control-Allow-Credentials header.
5385 #
5386 # Default is false.
5387 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
5388 # header.
5389 &quot;A String&quot;,
5390 ],
5391 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
5392 # header.
5393 &quot;A String&quot;,
5394 ],
5395 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
5396 # more information, see regular expression syntax.
5397 #
5398 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
5399 #
5400 # Regular expressions can only be used when the loadBalancingScheme is
5401 # set to INTERNAL_SELF_MANAGED.
5402 &quot;A String&quot;,
5403 ],
5404 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
5405 #
5406 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
5407 &quot;A String&quot;,
5408 ],
5409 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
5410 # The default value is false, which indicates that the CORS
5411 # policy is in effect.
5412 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
5413 # header.
5414 &quot;A String&quot;,
5415 ],
5416 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
5417 # seconds. This field translates to the Access-Control-Max-Age
5418 # header.
5419 },
5420 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
5421 # the resiliency of clients to backend service failure. As part of fault
5422 # injection, when clients send requests to a backend service, delays can be
5423 # introduced by a load balancer on a percentage of requests before sending
5424 # those requests to the backend service. Similarly requests from clients can
5425 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
5426 # that are configured with a fault_injection_policy if:
5427 # 1. The traffic is generated by fault injection AND
5428 # 2. The fault injection is not a delay fault injection.
5429 # Fault injection is not supported with the classic Application Load Balancer
5430 # . To see which load balancers support fault injection,
5431 # see Load
5432 # balancing: Routing and traffic management features.
5433 # the resiliency of clients to backend service failure. As part of fault
5434 # injection, when clients send requests to a backend service, delays can be
5435 # introduced by the load balancer on a percentage of requests before sending
5436 # those request to the backend service. Similarly requests from clients can be
5437 # aborted by the load balancer for a percentage of requests.
5438 &quot;abort&quot;: { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
5439 # injection.
5440 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
5441 #
5442 # The value must be from 200 to 599 inclusive.
5443 #
5444 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
5445 # according to this
5446 # mapping table. HTTP status 200 is mapped to gRPC status
5447 # UNKNOWN. Injecting an OK status is currently not supported by
5448 # Traffic Director.
5449 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
5450 # that is aborted as part of fault injection.
5451 #
5452 # The value must be from 0.0 to 100.0 inclusive.
5453 },
5454 &quot;delay&quot;: { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
5455 # injection, before being sent to a backend service.
5456 # request to the backend service as part of fault injection.
5457 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
5458 # as a count of seconds and fractions of seconds at nanosecond
5459 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5460 # or &quot;month&quot;. Range is approximately 10,000 years.
5461 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5462 # Durations less than one second are represented with a 0
5463 # `seconds` field and a positive `nanos` field. Must be from 0
5464 # to 999,999,999 inclusive.
5465 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5466 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5467 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5468 },
5469 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
5470 # which a delay is introduced as part of fault injection.
5471 #
5472 # The value must be from 0.0 to 100.0 inclusive.
5473 },
5474 },
5475 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
5476 # Unlike the timeout field where the timeout duration starts
5477 # from the time the request has been fully processed (known as*end-of-stream*),
5478 # the duration in this field is computed from the beginning of the stream
5479 # until the response has been processed, including all retries. A
5480 # stream that does not complete in this duration is closed.
5481 #
5482 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
5483 # with the route.
5484 #
5485 # This field is only allowed if the Url map is used with backend services
5486 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
5487 # as a count of seconds and fractions of seconds at nanosecond
5488 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5489 # or &quot;month&quot;. Range is approximately 10,000 years.
5490 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5491 # Durations less than one second are represented with a 0
5492 # `seconds` field and a positive `nanos` field. Must be from 0
5493 # to 999,999,999 inclusive.
5494 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5495 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5496 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5497 },
5498 &quot;requestMirrorPolicy&quot;: { # A policy that specifies how requests intended for the route&#x27;s backends # Specifies the policy on how requests intended for the route&#x27;s backends
5499 # are shadowed to a separate mirrored backend service. The load balancer does
5500 # not wait for responses from the shadow service. Before sending traffic
5501 # to the shadow service, the host / authority header is suffixed with-shadow.
5502 #
5503 # Not supported when the URL map is bound to a target gRPC proxy that
5504 # has the validateForProxyless field set to true.
5505 # are shadowed to a separate mirrored backend service. The load balancer
5506 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
5507 # to the shadow service, the host or authority header is suffixed with-shadow.
5508 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
5509 # mirrored to.
5510 #
5511 # The backend service configured for a mirroring
5512 # policy must reference backends that are of the same type as the original
5513 # backend service matched in the URL map.
5514 #
5515 # Serverless NEG backends are not currently supported as a mirrored
5516 # backend service.
5517 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
5518 },
5519 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
5520 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
5521 # If not specified, defaults to 1.
5522 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
5523 #
5524 # If not specified, will use the timeout set in theHttpRouteAction field.
5525 # If timeout in the HttpRouteAction field is not set, this field
5526 # uses the largest timeout
5527 # among all backend services associated with the route.
5528 #
5529 # Not supported when the URL map is bound to a target gRPC proxy that
5530 # has the validateForProxyless field set to true.
5531 # as a count of seconds and fractions of seconds at nanosecond
5532 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5533 # or &quot;month&quot;. Range is approximately 10,000 years.
5534 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5535 # Durations less than one second are represented with a 0
5536 # `seconds` field and a positive `nanos` field. Must be from 0
5537 # to 999,999,999 inclusive.
5538 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5539 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5540 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5541 },
5542 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
5543 # values are:
5544 #
5545 # - 5xx: retry is attempted if the instance or endpoint
5546 # responds with any 5xx response code, or if the instance or
5547 # endpoint does not respond at all. For example, disconnects, reset, read
5548 # timeout, connection failure, and refused streams.
5549 # - gateway-error: Similar to 5xx, but only
5550 # applies to response codes 502, 503 or504.
5551 # - connect-failure: a retry is attempted on failures
5552 # connecting to the instance or endpoint. For example, connection
5553 # timeouts.
5554 # - retriable-4xx: a retry is attempted if the instance
5555 # or endpoint responds with a 4xx response code.
5556 # The only error that you can retry is error code 409.
5557 # - refused-stream: a retry is attempted if the instance
5558 # or endpoint resets the stream with a REFUSED_STREAM error
5559 # code. This reset type indicates that it is safe to retry.
5560 # - cancelled: a retry is attempted if the gRPC status
5561 # code in the response header is set to cancelled.
5562 # - deadline-exceeded: a retry is attempted if the gRPC
5563 # status code in the response header is set todeadline-exceeded.
5564 # - internal: a retry is attempted if the gRPC
5565 # status code in the response header is set tointernal.
5566 # - resource-exhausted: a retry is attempted if the gRPC
5567 # status code in the response header is set toresource-exhausted.
5568 # - unavailable: a retry is attempted if the gRPC
5569 # status code in the response header is set tounavailable.
5570 #
5571 # Only the following codes are supported when the URL map is bound to
5572 # target gRPC proxy that has validateForProxyless field set to true.
5573 #
5574 # - cancelled
5575 # - deadline-exceeded
5576 # - internal
5577 # - resource-exhausted
5578 # - unavailable
5579 &quot;A String&quot;,
5580 ],
5581 },
5582 &quot;timeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
5583 # time the request has been fully processed (known as *end-of-stream*)
5584 # up until the response has been processed. Timeout includes
5585 # all retries.
5586 #
5587 # If not specified, this field uses the largest timeout among all backend
5588 # services associated with the route.
5589 #
5590 # Not supported when the URL map is bound to a target gRPC proxy that
5591 # has validateForProxyless field set to true.
5592 # as a count of seconds and fractions of seconds at nanosecond
5593 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5594 # or &quot;month&quot;. Range is approximately 10,000 years.
5595 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5596 # Durations less than one second are represented with a 0
5597 # `seconds` field and a positive `nanos` field. Must be from 0
5598 # to 999,999,999 inclusive.
5599 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5600 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5601 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5602 },
5603 &quot;urlRewrite&quot;: { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
5604 # to the matched service.
5605 #
5606 # urlRewrite is the only action supported in UrlMaps
5607 # for classic Application Load Balancers.
5608 #
5609 # Not supported when the URL map is bound to a target gRPC proxy that
5610 # has the validateForProxyless field set to true.
5611 # backend service.
5612 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
5613 # host header is replaced with contents of hostRewrite.
5614 #
5615 # The value must be from 1 to 255 characters.
5616 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
5617 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
5618 #
5619 # The value must be from 1 to 1024 characters.
5620 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
5621 # header) using the HTTP template syntax.
5622 #
5623 # A corresponding
5624 # path_template_match must be specified. Any template variables must exist in
5625 # the path_template_match field.
5626 #
5627 #
5628 # - -At least one variable must be specified in the path_template_match
5629 # field
5630 # - You can omit variables from the rewritten URL
5631 # - The * and ** operators cannot be matched
5632 # unless they have a corresponding variable name - e.g.
5633 # {format=*} or {var=**}.
5634 #
5635 # For example, a path_template_match of /static/{format=**}
5636 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
5637 # rewrite, so that /{country}/{format}/{suffix=**} can be
5638 # rewritten as /content/{format}/{country}/{suffix}.
5639 #
5640 # At least
5641 # one non-empty routeRules[].matchRules[].path_template_match is
5642 # required.
5643 #
5644 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
5645 },
5646 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
5647 # occurs. The weights determine the fraction of traffic that flows to
5648 # their corresponding backend service. If all traffic needs to
5649 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
5650 #
5651 # After a backend service is identified and before forwarding
5652 # the request to
5653 # the backend service, advanced routing actions such as URL rewrites and
5654 # header transformations are applied depending on additional settings
5655 # specified in this HttpRouteAction.
5656 { # In contrast to a single BackendService in
5657 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
5658 # multiple backend services. The volume of traffic for each
5659 # backend service is proportional to the weight specified
5660 # in each WeightedBackendService
5661 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
5662 # resource. Before
5663 # forwarding the request to backendService, the load balancer
5664 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
5665 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
5666 # effect for the selected backendService.
5667 #
5668 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
5669 #
5670 # headerAction is not supported for load balancers that have
5671 # their loadBalancingScheme set to EXTERNAL.
5672 #
5673 # Not supported when the URL map is bound to a target gRPC proxy that
5674 # has validateForProxyless field set to true.
5675 # the request is passed along to the selected backendService.
5676 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
5677 { # Specification determining how headers are added to requests or responses.
5678 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
5679 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
5680 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
5681 # that already
5682 # exist for the header. If true, headerValue is set for the
5683 # header, discarding any values that were set for that header.
5684 #
5685 # The default value is true,
5686 # unless a variable is present in headerValue,
5687 # in which case the default value is false.
5688 # .
5689 },
5690 ],
5691 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
5692 # request before forwarding the request to the backendService.
5693 &quot;A String&quot;,
5694 ],
5695 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
5696 # client.
5697 { # Specification determining how headers are added to requests or responses.
5698 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
5699 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
5700 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
5701 # that already
5702 # exist for the header. If true, headerValue is set for the
5703 # header, discarding any values that were set for that header.
5704 #
5705 # The default value is true,
5706 # unless a variable is present in headerValue,
5707 # in which case the default value is false.
5708 # .
5709 },
5710 ],
5711 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
5712 # response before sending the response back to the client.
5713 &quot;A String&quot;,
5714 ],
5715 },
5716 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
5717 # computed asweight / (sum of all weightedBackendService weights in routeAction).
5718 #
5719 # The selection of a backend service is determined only for new traffic.
5720 # Once a user&#x27;s request has been directed to a backend service,
5721 # subsequent requests are sent to the same backend service as
5722 # determined by the backend service&#x27;s session affinity policy.
5723 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
5724 # splitting. If you do, the weighted traffic splitting configuration takes
5725 # precedence.
5726 #
5727 # The value must be from 0 to 1000.
5728 },
5729 ],
5730 },
5731 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource. This
5732 # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
5733 # matched. For example, the
5734 # following are all valid URLs to a BackendService resource:
5735 #
5736 #
5737 # - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
5738 # - compute/v1/projects/project/global/backendServices/backendService
5739 # - global/backendServices/backendService
5740 #
5741 #
5742 # If defaultRouteAction is also specified, advanced
5743 # routing actions, such as URL rewrites, take effect before sending the
5744 # request to the backend.
5745 #
5746 #
5747 # Only one of defaultUrlRedirect, defaultService
5748 # or defaultRouteAction.weightedBackendService can be set.
5749 #
5750 #
5751 # Authorization requires one or more of the following Google IAM permissions on the
5752 # specified resource default_service:
5753 #
5754 #
5755 # - compute.backendBuckets.use
5756 # - compute.backendServices.use
5757 &quot;defaultUrlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When none of the specified pathRules orrouteRules match, the request is redirected to a URL specified
5758 # by defaultUrlRedirect.
5759 #
5760 #
5761 # Only one of defaultUrlRedirect, defaultService
5762 # or defaultRouteAction.weightedBackendService can be set.
5763 #
5764 #
5765 # Not supported when the URL map is bound to a target gRPC proxy.
5766 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
5767 # was supplied in the request.
5768 #
5769 # The value must be from 1 to 255
5770 # characters.
5771 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
5772 # set to HTTPS.
5773 # If set to false, the URL scheme of the redirected request
5774 # remains the same as that of the request.
5775 #
5776 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
5777 #
5778 # The default is set to false.
5779 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
5780 # that was supplied in the request.
5781 #
5782 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
5783 # supplied, the path of the original request is used for the redirect.
5784 #
5785 # The value must be from 1 to 1024 characters.
5786 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
5787 # the HttpRouteRuleMatch, retaining the remaining portion
5788 # of the URL before redirecting the request.
5789 #
5790 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
5791 # supplied, the path of the original request is used for the redirect.
5792 #
5793 # The value must be from 1 to 1024 characters.
5794 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
5795 #
5796 # Supported values are:
5797 #
5798 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
5799 # to 301.
5800 # - FOUND, which corresponds to 302.
5801 # - SEE_OTHER which corresponds to 303.
5802 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
5803 # method is retained.
5804 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
5805 # method is retained.
5806 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
5807 # URL is
5808 # removed before redirecting the request. If set to false, the
5809 # query portion of the original URL is retained.
5810 #
5811 # The default is set to false.
5812 },
5813 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
5814 # create the resource.
5815 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
5816 # for the selected backend service.
5817 #
5818 # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
5819 #
5820 # HeaderAction is not supported for load balancers
5821 # that have
5822 # their loadBalancingScheme set to EXTERNAL.
5823 #
5824 # Not supported when the URL map is bound to a target gRPC proxy that
5825 # has validateForProxyless field set to true.
5826 # the request is passed along to the selected backendService.
5827 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
5828 { # Specification determining how headers are added to requests or responses.
5829 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
5830 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
5831 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
5832 # that already
5833 # exist for the header. If true, headerValue is set for the
5834 # header, discarding any values that were set for that header.
5835 #
5836 # The default value is true,
5837 # unless a variable is present in headerValue,
5838 # in which case the default value is false.
5839 # .
5840 },
5841 ],
5842 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
5843 # request before forwarding the request to the backendService.
5844 &quot;A String&quot;,
5845 ],
5846 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
5847 # client.
5848 { # Specification determining how headers are added to requests or responses.
5849 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
5850 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
5851 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
5852 # that already
5853 # exist for the header. If true, headerValue is set for the
5854 # header, discarding any values that were set for that header.
5855 #
5856 # The default value is true,
5857 # unless a variable is present in headerValue,
5858 # in which case the default value is false.
5859 # .
5860 },
5861 ],
5862 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
5863 # response before sending the response back to the client.
5864 &quot;A String&quot;,
5865 ],
5866 },
5867 &quot;name&quot;: &quot;A String&quot;, # The name to which this PathMatcher is referred by theHostRule.
5868 &quot;pathRules&quot;: [ # The list of path rules. Use this list instead of routeRules
5869 # when routing based on simple path matching is all that&#x27;s required. A path
5870 # rule can only include a wildcard character (*) after a
5871 # forward slash character (&quot;/&quot;).
5872 #
5873 # The order by which path rules are specified does not matter.
5874 # Matches are always done on the longest-path-first basis.
5875 #
5876 # For example: a pathRule with a path /a/b/c/* will match
5877 # before /a/b/* irrespective of the order in which those paths appear in this
5878 # list.
5879 #
5880 # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
5881 { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
5882 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
5883 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
5884 #
5885 # If a policy for an
5886 # error code is not configured for the PathRule, a policy for
5887 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
5888 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
5889 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
5890 # effect.
5891 #
5892 # For example, consider a UrlMap with the following configuration:
5893 #
5894 #
5895 # - UrlMap.defaultCustomErrorResponsePolicy are configured
5896 # with policies for 5xx and 4xx errors
5897 # - A PathRule for /coming_soon/ is configured for the error
5898 # code 404.
5899 #
5900 # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher&#x27;s policy
5901 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
5902 # the policy in PathRule.customErrorResponsePolicy takes
5903 # effect. If any of the requests in this example encounter a 500
5904 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
5905 #
5906 # customErrorResponsePolicy is supported only for
5907 # global external Application Load Balancers.
5908 # backend service or backend bucket responds with an error.
5909 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
5910 #
5911 # In a given policy, if you specify rules for both a range of error codes
5912 # as well as rules for specific error codes then rules with specific error
5913 # codes have a higher priority. For example, assume that you configure a rule
5914 # for 401 (Un-authorized) code, and another for all 4 series
5915 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
5916 # However if the backend service returns a 403, the rule for4xx takes effect.
5917 { # Specifies the mapping between the response code that will be returned along
5918 # with the custom error content and the response code returned by the backend
5919 # service.
5920 &quot;matchResponseCodes&quot;: [ # Valid values include:
5921 #
5922 #
5923 # - A number between 400 and 599: For example
5924 # 401 or 503, in which case the load balancer
5925 # applies the policy if the error code exactly matches this value.
5926 # - 5xx: Load Balancer will apply the policy if the
5927 # backend service responds with any response code in the range of
5928 # 500 to 599.
5929 # - 4xx: Load
5930 # Balancer will apply the policy if the backend service responds with any
5931 # response code in the range of 400 to
5932 # 499.
5933 #
5934 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
5935 &quot;A String&quot;,
5936 ],
5937 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
5938 # error content. If overrideResponseCode is not supplied, the
5939 # same response code returned by the original backend bucket or backend
5940 # service is returned to the client.
5941 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
5942 #
5943 # path must start
5944 # with a leading slash. path cannot have trailing slashes.
5945 #
5946 # If the file is not available in backendBucket or the
5947 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
5948 #
5949 # The value must
5950 # be from 1 to 1024 characters
5951 },
5952 ],
5953 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
5954 # contains the custom error content. Examples are:
5955 #
5956 #
5957 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
5958 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
5959 # - global/backendBuckets/myBackendBucket
5960 #
5961 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
5962 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
5963 #
5964 # If load balancer cannot reach
5965 # the backendBucket, a simple Not Found Error will
5966 # be returned, with the original response code (oroverrideResponseCode if configured).
5967 #
5968 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
5969 },
5970 &quot;paths&quot;: [ # The list of path patterns to match. Each must start with /
5971 # and the only place a * is allowed is at the end following
5972 # a /. The string fed to the path matcher does not include
5973 # any text after the first ? or #, and
5974 # those chars are not allowed here.
5975 &quot;A String&quot;,
5976 ],
5977 &quot;routeAction&quot;: { # In response to a matching path, the load balancer
5978 # performs advanced routing actions, such as URL rewrites and header
5979 # transformations, before forwarding the request to the selected
5980 # backend.
5981 #
5982 #
5983 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
5984 #
5985 #
5986 # URL maps for classic Application Load Balancers only support
5987 # the urlRewrite action within a path rule&#x27;srouteAction.
5988 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
5989 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
5990 # property must be specified. This policy cannot be specified if any target
5991 # backend has Identity-Aware Proxy enabled.
5992 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
5993 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
5994 # header names can be specified. The cache is bypassed for all `cacheMode`
5995 # values.
5996 &quot;A String&quot;,
5997 ],
5998 &quot;cacheKeyPolicy&quot;: { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
5999 # on the backend type: for Backend Services, the complete request URI is
6000 # used; for Backend Buckets, the request URI is used without the protocol or
6001 # host, and only query parameters known to Cloud Storage are included.
6002 # Policy defined on Route Action.
6003 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
6004 # parameters will be included. Either specify `excludedQueryParameters`
6005 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
6006 # encoded and not treated as delimiters.
6007 #
6008 # Note: This field applies to routes that use backend services. Attempting
6009 # to set it on a route that points exclusively to Backend Buckets will
6010 # result in a configuration error. For routes that point to a Backend
6011 # Bucket, use `includedQueryParameters` to define which parameters should
6012 # be part of the cache key.
6013 &quot;A String&quot;,
6014 ],
6015 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
6016 #
6017 # Note: This setting is only applicable to routes that use a Backend
6018 # Service. It does not affect requests served by a Backend Bucket, as the
6019 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
6020 # it on a route that points exclusively to Backend Buckets will result in a
6021 # configuration error.
6022 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
6023 #
6024 # Note: This setting is only applicable to routes that use a Backend
6025 # Service. It does not affect requests served by a Backend Bucket, as the
6026 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
6027 # set on a route that points exclusively to Backend Buckets will result in
6028 # a configuration error.
6029 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
6030 # `includedQueryParameters` and `excludedQueryParameters`. If neither
6031 # is set, the entire query string will be included. If false, the query
6032 # string will be excluded from the cache key entirely.
6033 #
6034 # Note: This field applies to routes that use backend services. Attempting
6035 # to set it on a route that points exclusively to Backend Buckets will
6036 # result in a configuration error. For routes that point to a Backend
6037 # Bucket, use `includedQueryParameters` to define which parameters should
6038 # be part of the cache key.
6039 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
6040 # The name=value pair will be used in the cache key Cloud CDN generates.
6041 #
6042 # Note: This setting is only applicable to routes that use a Backend
6043 # Service. It does not affect requests served by a Backend Bucket.
6044 # Attempting to set it on a route that points exclusively to Backend
6045 # Buckets will result in a configuration error. Up to 5 cookie names can be
6046 # specified.
6047 &quot;A String&quot;,
6048 ],
6049 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
6050 &quot;A String&quot;,
6051 ],
6052 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
6053 # parameters will be excluded. Either specify `includedQueryParameters`
6054 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
6055 # encoded and not treated as delimiters.
6056 &quot;A String&quot;,
6057 ],
6058 },
6059 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
6060 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
6061 &quot;clientTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
6062 # content. This is used to clamp the max-age (or Expires) value sent to the
6063 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
6064 # is used for the response max-age directive, along with a &quot;public&quot;
6065 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
6066 # clamps the max-age from the origin (if specified), or else sets the
6067 # response max-age directive to the lesser of the `clientTtl` and
6068 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
6069 # present. The maximum allowed value is 31,622,400s (1 year). If not
6070 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
6071 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
6072 # `USE_ORIGIN_HEADERS`.
6073 # as a count of seconds and fractions of seconds at nanosecond
6074 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6075 # or &quot;month&quot;. Range is approximately 10,000 years.
6076 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6077 # Durations less than one second are represented with a 0
6078 # `seconds` field and a positive `nanos` field. Must be from 0
6079 # to 999,999,999 inclusive.
6080 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6081 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6082 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6083 },
6084 &quot;defaultTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
6085 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
6086 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
6087 # greater than that of `maxTtl`. When the `cacheMode` is set to
6088 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
6089 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
6090 # accessed objects may be evicted from the cache before the defined TTL. If
6091 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
6092 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
6093 # `USE_ORIGIN_HEADERS`.
6094 # as a count of seconds and fractions of seconds at nanosecond
6095 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6096 # or &quot;month&quot;. Range is approximately 10,000 years.
6097 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6098 # Durations less than one second are represented with a 0
6099 # `seconds` field and a positive `nanos` field. Must be from 0
6100 # to 999,999,999 inclusive.
6101 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6102 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6103 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6104 },
6105 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
6106 # attempt to set a max-age or s-maxage higher than this, or an Expires header
6107 # more than `maxTtl` seconds in the future will be capped at the value of
6108 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
6109 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
6110 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
6111 # Infrequently accessed objects may be evicted from the cache before the
6112 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
6113 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
6114 # mode.
6115 # as a count of seconds and fractions of seconds at nanosecond
6116 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6117 # or &quot;month&quot;. Range is approximately 10,000 years.
6118 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6119 # Durations less than one second are represented with a 0
6120 # `seconds` field and a positive `nanos` field. Must be from 0
6121 # to 999,999,999 inclusive.
6122 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6123 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6124 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6125 },
6126 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
6127 # to apply fine-grained caching for common errors or redirects.
6128 # This can reduce the load on your origin and improve end-user
6129 # experience by reducing response latency.
6130 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
6131 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
6132 # the specified response code that lack any Cache-Control, Expires, or
6133 # Pragma: no-cache directives. When the `cacheMode` is set to
6134 # `FORCE_CACHE_ALL`, negative caching applies to all responses
6135 # with the specified response code, and overrides any caching headers. By
6136 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
6137 #
6138 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
6139 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
6140 # * 405 (Method Not Found), 501 (Not Implemented): 60s
6141 #
6142 # These defaults can be overridden in `negativeCachingPolicy`.
6143 # If not specified, Cloud CDN applies negative caching by default.
6144 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
6145 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
6146 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
6147 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
6148 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
6149 # all response codes that you wish to cache. Cloud CDN will not apply any
6150 # default negative caching when a policy exists.
6151 { # Specify CDN TTLs for response error codes.
6152 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
6153 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
6154 # specified as values, and you cannot specify a status code more than
6155 # once.
6156 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
6157 # corresponding status code.
6158 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
6159 # objects may be evicted from the cache before the defined TTL.
6160 # as a count of seconds and fractions of seconds at nanosecond
6161 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6162 # or &quot;month&quot;. Range is approximately 10,000 years.
6163 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6164 # Durations less than one second are represented with a 0
6165 # `seconds` field and a positive `nanos` field. Must be from 0
6166 # to 999,999,999 inclusive.
6167 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6168 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6169 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6170 },
6171 },
6172 ],
6173 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
6174 # requests into a small number of requests to the origin. If not specified,
6175 # Cloud CDN applies request coalescing by default.
6176 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
6177 # content with the origin, or when an error is encountered when refreshing
6178 # the cache.
6179 # This setting defines the default &quot;max-stale&quot; duration for any cached
6180 # responses that do not specify a max-stale directive. Stale responses that
6181 # exceed the TTL configured here will not be served. The default limit
6182 # (max-stale) is 86400s (1 day), which will allow stale content to be
6183 # served up to this limit beyond the max-age (or s-maxage) of a cached
6184 # response.
6185 # The maximum allowed value is 604800 (1 week).
6186 # Set this to zero (0) to disable serve-while-stale.
6187 # as a count of seconds and fractions of seconds at nanosecond
6188 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6189 # or &quot;month&quot;. Range is approximately 10,000 years.
6190 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6191 # Durations less than one second are represented with a 0
6192 # `seconds` field and a positive `nanos` field. Must be from 0
6193 # to 999,999,999 inclusive.
6194 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6195 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6196 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6197 },
6198 },
6199 &quot;corsPolicy&quot;: { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
6200 # information about the W3C recommendation for cross-origin resource sharing
6201 # (CORS), see Fetch API Living
6202 # Standard.
6203 #
6204 # Not supported when the URL map is bound to a target gRPC proxy.
6205 # information about the W3C recommendation for cross-origin resource sharing
6206 # (CORS), see Fetch API Living
6207 # Standard.
6208 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
6209 # indicates that
6210 # the actual request can include user credentials. This field translates to
6211 # the Access-Control-Allow-Credentials header.
6212 #
6213 # Default is false.
6214 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
6215 # header.
6216 &quot;A String&quot;,
6217 ],
6218 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
6219 # header.
6220 &quot;A String&quot;,
6221 ],
6222 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
6223 # more information, see regular expression syntax.
6224 #
6225 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
6226 #
6227 # Regular expressions can only be used when the loadBalancingScheme is
6228 # set to INTERNAL_SELF_MANAGED.
6229 &quot;A String&quot;,
6230 ],
6231 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
6232 #
6233 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
6234 &quot;A String&quot;,
6235 ],
6236 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
6237 # The default value is false, which indicates that the CORS
6238 # policy is in effect.
6239 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
6240 # header.
6241 &quot;A String&quot;,
6242 ],
6243 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
6244 # seconds. This field translates to the Access-Control-Max-Age
6245 # header.
6246 },
6247 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
6248 # the resiliency of clients to backend service failure. As part of fault
6249 # injection, when clients send requests to a backend service, delays can be
6250 # introduced by a load balancer on a percentage of requests before sending
6251 # those requests to the backend service. Similarly requests from clients can
6252 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
6253 # that are configured with a fault_injection_policy if:
6254 # 1. The traffic is generated by fault injection AND
6255 # 2. The fault injection is not a delay fault injection.
6256 # Fault injection is not supported with the classic Application Load Balancer
6257 # . To see which load balancers support fault injection,
6258 # see Load
6259 # balancing: Routing and traffic management features.
6260 # the resiliency of clients to backend service failure. As part of fault
6261 # injection, when clients send requests to a backend service, delays can be
6262 # introduced by the load balancer on a percentage of requests before sending
6263 # those request to the backend service. Similarly requests from clients can be
6264 # aborted by the load balancer for a percentage of requests.
6265 &quot;abort&quot;: { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
6266 # injection.
6267 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
6268 #
6269 # The value must be from 200 to 599 inclusive.
6270 #
6271 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
6272 # according to this
6273 # mapping table. HTTP status 200 is mapped to gRPC status
6274 # UNKNOWN. Injecting an OK status is currently not supported by
6275 # Traffic Director.
6276 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
6277 # that is aborted as part of fault injection.
6278 #
6279 # The value must be from 0.0 to 100.0 inclusive.
6280 },
6281 &quot;delay&quot;: { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
6282 # injection, before being sent to a backend service.
6283 # request to the backend service as part of fault injection.
6284 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
6285 # as a count of seconds and fractions of seconds at nanosecond
6286 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6287 # or &quot;month&quot;. Range is approximately 10,000 years.
6288 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6289 # Durations less than one second are represented with a 0
6290 # `seconds` field and a positive `nanos` field. Must be from 0
6291 # to 999,999,999 inclusive.
6292 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6293 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6294 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6295 },
6296 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
6297 # which a delay is introduced as part of fault injection.
6298 #
6299 # The value must be from 0.0 to 100.0 inclusive.
6300 },
6301 },
6302 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
6303 # Unlike the timeout field where the timeout duration starts
6304 # from the time the request has been fully processed (known as*end-of-stream*),
6305 # the duration in this field is computed from the beginning of the stream
6306 # until the response has been processed, including all retries. A
6307 # stream that does not complete in this duration is closed.
6308 #
6309 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
6310 # with the route.
6311 #
6312 # This field is only allowed if the Url map is used with backend services
6313 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
6314 # as a count of seconds and fractions of seconds at nanosecond
6315 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6316 # or &quot;month&quot;. Range is approximately 10,000 years.
6317 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6318 # Durations less than one second are represented with a 0
6319 # `seconds` field and a positive `nanos` field. Must be from 0
6320 # to 999,999,999 inclusive.
6321 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6322 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6323 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6324 },
6325 &quot;requestMirrorPolicy&quot;: { # A policy that specifies how requests intended for the route&#x27;s backends # Specifies the policy on how requests intended for the route&#x27;s backends
6326 # are shadowed to a separate mirrored backend service. The load balancer does
6327 # not wait for responses from the shadow service. Before sending traffic
6328 # to the shadow service, the host / authority header is suffixed with-shadow.
6329 #
6330 # Not supported when the URL map is bound to a target gRPC proxy that
6331 # has the validateForProxyless field set to true.
6332 # are shadowed to a separate mirrored backend service. The load balancer
6333 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
6334 # to the shadow service, the host or authority header is suffixed with-shadow.
6335 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
6336 # mirrored to.
6337 #
6338 # The backend service configured for a mirroring
6339 # policy must reference backends that are of the same type as the original
6340 # backend service matched in the URL map.
6341 #
6342 # Serverless NEG backends are not currently supported as a mirrored
6343 # backend service.
6344 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
6345 },
6346 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
6347 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
6348 # If not specified, defaults to 1.
6349 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
6350 #
6351 # If not specified, will use the timeout set in theHttpRouteAction field.
6352 # If timeout in the HttpRouteAction field is not set, this field
6353 # uses the largest timeout
6354 # among all backend services associated with the route.
6355 #
6356 # Not supported when the URL map is bound to a target gRPC proxy that
6357 # has the validateForProxyless field set to true.
6358 # as a count of seconds and fractions of seconds at nanosecond
6359 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6360 # or &quot;month&quot;. Range is approximately 10,000 years.
6361 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6362 # Durations less than one second are represented with a 0
6363 # `seconds` field and a positive `nanos` field. Must be from 0
6364 # to 999,999,999 inclusive.
6365 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6366 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6367 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6368 },
6369 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
6370 # values are:
6371 #
6372 # - 5xx: retry is attempted if the instance or endpoint
6373 # responds with any 5xx response code, or if the instance or
6374 # endpoint does not respond at all. For example, disconnects, reset, read
6375 # timeout, connection failure, and refused streams.
6376 # - gateway-error: Similar to 5xx, but only
6377 # applies to response codes 502, 503 or504.
6378 # - connect-failure: a retry is attempted on failures
6379 # connecting to the instance or endpoint. For example, connection
6380 # timeouts.
6381 # - retriable-4xx: a retry is attempted if the instance
6382 # or endpoint responds with a 4xx response code.
6383 # The only error that you can retry is error code 409.
6384 # - refused-stream: a retry is attempted if the instance
6385 # or endpoint resets the stream with a REFUSED_STREAM error
6386 # code. This reset type indicates that it is safe to retry.
6387 # - cancelled: a retry is attempted if the gRPC status
6388 # code in the response header is set to cancelled.
6389 # - deadline-exceeded: a retry is attempted if the gRPC
6390 # status code in the response header is set todeadline-exceeded.
6391 # - internal: a retry is attempted if the gRPC
6392 # status code in the response header is set tointernal.
6393 # - resource-exhausted: a retry is attempted if the gRPC
6394 # status code in the response header is set toresource-exhausted.
6395 # - unavailable: a retry is attempted if the gRPC
6396 # status code in the response header is set tounavailable.
6397 #
6398 # Only the following codes are supported when the URL map is bound to
6399 # target gRPC proxy that has validateForProxyless field set to true.
6400 #
6401 # - cancelled
6402 # - deadline-exceeded
6403 # - internal
6404 # - resource-exhausted
6405 # - unavailable
6406 &quot;A String&quot;,
6407 ],
6408 },
6409 &quot;timeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
6410 # time the request has been fully processed (known as *end-of-stream*)
6411 # up until the response has been processed. Timeout includes
6412 # all retries.
6413 #
6414 # If not specified, this field uses the largest timeout among all backend
6415 # services associated with the route.
6416 #
6417 # Not supported when the URL map is bound to a target gRPC proxy that
6418 # has validateForProxyless field set to true.
6419 # as a count of seconds and fractions of seconds at nanosecond
6420 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6421 # or &quot;month&quot;. Range is approximately 10,000 years.
6422 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6423 # Durations less than one second are represented with a 0
6424 # `seconds` field and a positive `nanos` field. Must be from 0
6425 # to 999,999,999 inclusive.
6426 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6427 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6428 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6429 },
6430 &quot;urlRewrite&quot;: { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
6431 # to the matched service.
6432 #
6433 # urlRewrite is the only action supported in UrlMaps
6434 # for classic Application Load Balancers.
6435 #
6436 # Not supported when the URL map is bound to a target gRPC proxy that
6437 # has the validateForProxyless field set to true.
6438 # backend service.
6439 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
6440 # host header is replaced with contents of hostRewrite.
6441 #
6442 # The value must be from 1 to 255 characters.
6443 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
6444 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
6445 #
6446 # The value must be from 1 to 1024 characters.
6447 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
6448 # header) using the HTTP template syntax.
6449 #
6450 # A corresponding
6451 # path_template_match must be specified. Any template variables must exist in
6452 # the path_template_match field.
6453 #
6454 #
6455 # - -At least one variable must be specified in the path_template_match
6456 # field
6457 # - You can omit variables from the rewritten URL
6458 # - The * and ** operators cannot be matched
6459 # unless they have a corresponding variable name - e.g.
6460 # {format=*} or {var=**}.
6461 #
6462 # For example, a path_template_match of /static/{format=**}
6463 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
6464 # rewrite, so that /{country}/{format}/{suffix=**} can be
6465 # rewritten as /content/{format}/{country}/{suffix}.
6466 #
6467 # At least
6468 # one non-empty routeRules[].matchRules[].path_template_match is
6469 # required.
6470 #
6471 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
6472 },
6473 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
6474 # occurs. The weights determine the fraction of traffic that flows to
6475 # their corresponding backend service. If all traffic needs to
6476 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
6477 #
6478 # After a backend service is identified and before forwarding
6479 # the request to
6480 # the backend service, advanced routing actions such as URL rewrites and
6481 # header transformations are applied depending on additional settings
6482 # specified in this HttpRouteAction.
6483 { # In contrast to a single BackendService in
6484 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
6485 # multiple backend services. The volume of traffic for each
6486 # backend service is proportional to the weight specified
6487 # in each WeightedBackendService
6488 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
6489 # resource. Before
6490 # forwarding the request to backendService, the load balancer
6491 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
6492 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
6493 # effect for the selected backendService.
6494 #
6495 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
6496 #
6497 # headerAction is not supported for load balancers that have
6498 # their loadBalancingScheme set to EXTERNAL.
6499 #
6500 # Not supported when the URL map is bound to a target gRPC proxy that
6501 # has validateForProxyless field set to true.
6502 # the request is passed along to the selected backendService.
6503 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
6504 { # Specification determining how headers are added to requests or responses.
6505 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
6506 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
6507 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
6508 # that already
6509 # exist for the header. If true, headerValue is set for the
6510 # header, discarding any values that were set for that header.
6511 #
6512 # The default value is true,
6513 # unless a variable is present in headerValue,
6514 # in which case the default value is false.
6515 # .
6516 },
6517 ],
6518 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
6519 # request before forwarding the request to the backendService.
6520 &quot;A String&quot;,
6521 ],
6522 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
6523 # client.
6524 { # Specification determining how headers are added to requests or responses.
6525 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
6526 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
6527 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
6528 # that already
6529 # exist for the header. If true, headerValue is set for the
6530 # header, discarding any values that were set for that header.
6531 #
6532 # The default value is true,
6533 # unless a variable is present in headerValue,
6534 # in which case the default value is false.
6535 # .
6536 },
6537 ],
6538 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
6539 # response before sending the response back to the client.
6540 &quot;A String&quot;,
6541 ],
6542 },
6543 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
6544 # computed asweight / (sum of all weightedBackendService weights in routeAction).
6545 #
6546 # The selection of a backend service is determined only for new traffic.
6547 # Once a user&#x27;s request has been directed to a backend service,
6548 # subsequent requests are sent to the same backend service as
6549 # determined by the backend service&#x27;s session affinity policy.
6550 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
6551 # splitting. If you do, the weighted traffic splitting configuration takes
6552 # precedence.
6553 #
6554 # The value must be from 0 to 1000.
6555 },
6556 ],
6557 },
6558 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
6559 # is directed if this rule is matched. If routeAction is
6560 # also specified, advanced routing actions, such as URL rewrites,
6561 # take effect before sending the request to the backend.
6562 #
6563 #
6564 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
6565 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
6566 # specified by urlRedirect.
6567 #
6568 #
6569 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
6570 #
6571 #
6572 # Not supported when the URL map is bound to a target gRPC proxy.
6573 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
6574 # was supplied in the request.
6575 #
6576 # The value must be from 1 to 255
6577 # characters.
6578 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
6579 # set to HTTPS.
6580 # If set to false, the URL scheme of the redirected request
6581 # remains the same as that of the request.
6582 #
6583 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
6584 #
6585 # The default is set to false.
6586 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
6587 # that was supplied in the request.
6588 #
6589 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
6590 # supplied, the path of the original request is used for the redirect.
6591 #
6592 # The value must be from 1 to 1024 characters.
6593 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
6594 # the HttpRouteRuleMatch, retaining the remaining portion
6595 # of the URL before redirecting the request.
6596 #
6597 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
6598 # supplied, the path of the original request is used for the redirect.
6599 #
6600 # The value must be from 1 to 1024 characters.
6601 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
6602 #
6603 # Supported values are:
6604 #
6605 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
6606 # to 301.
6607 # - FOUND, which corresponds to 302.
6608 # - SEE_OTHER which corresponds to 303.
6609 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
6610 # method is retained.
6611 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
6612 # method is retained.
6613 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
6614 # URL is
6615 # removed before redirecting the request. If set to false, the
6616 # query portion of the original URL is retained.
6617 #
6618 # The default is set to false.
6619 },
6620 },
6621 ],
6622 &quot;routeRules&quot;: [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
6623 # desired. routeRules are evaluated in order of priority, from
6624 # the lowest to highest number.
6625 #
6626 # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
6627 { # The HttpRouteRule setting specifies how to match an HTTP request
6628 # and the corresponding routing action that load balancing proxies perform.
6629 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
6630 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
6631 #
6632 # If a policy for an
6633 # error code is not configured for the RouteRule, a policy for
6634 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
6635 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
6636 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
6637 # effect.
6638 #
6639 # For example, consider a UrlMap with the following configuration:
6640 #
6641 #
6642 # - UrlMap.defaultCustomErrorResponsePolicy are configured
6643 # with policies for 5xx and 4xx errors
6644 # - A RouteRule for /coming_soon/ is configured for the
6645 # error code 404.
6646 #
6647 # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher&#x27;s policy
6648 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
6649 # the policy in RouteRule.customErrorResponsePolicy takes
6650 # effect. If any of the requests in this example encounter a 500
6651 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
6652 #
6653 # When
6654 # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
6655 # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
6656 # a retry, if load balancer is successful in reaching the
6657 # service, the customErrorResponsePolicy is ignored and
6658 # the response from the service is returned to the client.
6659 #
6660 # customErrorResponsePolicy is supported only for
6661 # global external Application Load Balancers.
6662 # backend service or backend bucket responds with an error.
6663 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
6664 #
6665 # In a given policy, if you specify rules for both a range of error codes
6666 # as well as rules for specific error codes then rules with specific error
6667 # codes have a higher priority. For example, assume that you configure a rule
6668 # for 401 (Un-authorized) code, and another for all 4 series
6669 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
6670 # However if the backend service returns a 403, the rule for4xx takes effect.
6671 { # Specifies the mapping between the response code that will be returned along
6672 # with the custom error content and the response code returned by the backend
6673 # service.
6674 &quot;matchResponseCodes&quot;: [ # Valid values include:
6675 #
6676 #
6677 # - A number between 400 and 599: For example
6678 # 401 or 503, in which case the load balancer
6679 # applies the policy if the error code exactly matches this value.
6680 # - 5xx: Load Balancer will apply the policy if the
6681 # backend service responds with any response code in the range of
6682 # 500 to 599.
6683 # - 4xx: Load
6684 # Balancer will apply the policy if the backend service responds with any
6685 # response code in the range of 400 to
6686 # 499.
6687 #
6688 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
6689 &quot;A String&quot;,
6690 ],
6691 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
6692 # error content. If overrideResponseCode is not supplied, the
6693 # same response code returned by the original backend bucket or backend
6694 # service is returned to the client.
6695 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
6696 #
6697 # path must start
6698 # with a leading slash. path cannot have trailing slashes.
6699 #
6700 # If the file is not available in backendBucket or the
6701 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
6702 #
6703 # The value must
6704 # be from 1 to 1024 characters
6705 },
6706 ],
6707 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
6708 # contains the custom error content. Examples are:
6709 #
6710 #
6711 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
6712 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
6713 # - global/backendBuckets/myBackendBucket
6714 #
6715 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
6716 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
6717 #
6718 # If load balancer cannot reach
6719 # the backendBucket, a simple Not Found Error will
6720 # be returned, with the original response code (oroverrideResponseCode if configured).
6721 #
6722 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
6723 },
6724 &quot;description&quot;: &quot;A String&quot;, # The short description conveying the intent of this routeRule.
6725 #
6726 #
6727 # The description can have a maximum length of 1024 characters.
6728 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
6729 # for the selected backendService.
6730 #
6731 # The headerAction value specified here is applied before the
6732 # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
6733 #
6734 # HeaderAction is not supported for load balancers
6735 # that have
6736 # their loadBalancingScheme set to EXTERNAL.
6737 #
6738 # Not supported when the URL map is bound to a target gRPC proxy that
6739 # has validateForProxyless field set to true.
6740 # the request is passed along to the selected backendService.
6741 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
6742 { # Specification determining how headers are added to requests or responses.
6743 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
6744 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
6745 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
6746 # that already
6747 # exist for the header. If true, headerValue is set for the
6748 # header, discarding any values that were set for that header.
6749 #
6750 # The default value is true,
6751 # unless a variable is present in headerValue,
6752 # in which case the default value is false.
6753 # .
6754 },
6755 ],
6756 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
6757 # request before forwarding the request to the backendService.
6758 &quot;A String&quot;,
6759 ],
6760 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
6761 # client.
6762 { # Specification determining how headers are added to requests or responses.
6763 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
6764 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
6765 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
6766 # that already
6767 # exist for the header. If true, headerValue is set for the
6768 # header, discarding any values that were set for that header.
6769 #
6770 # The default value is true,
6771 # unless a variable is present in headerValue,
6772 # in which case the default value is false.
6773 # .
6774 },
6775 ],
6776 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
6777 # response before sending the response back to the client.
6778 &quot;A String&quot;,
6779 ],
6780 },
6781 &quot;matchRules&quot;: [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
6782 # this routeRule when any of thematchRules are satisfied. However predicates within
6783 # a given matchRule have AND semantics. All predicates
6784 # within a matchRule must match for the request to
6785 # match the rule.
6786 { # HttpRouteRuleMatch specifies a set of criteria for matching
6787 # requests to an HttpRouteRule. All specified criteria must
6788 # be satisfied for a match to occur.
6789 &quot;fullPathMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
6790 # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
6791 # that may be part of the original URL.
6792 #
6793 # fullPathMatch must be from 1 to 1024 characters.
6794 #
6795 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
6796 # specified.
6797 &quot;headerMatches&quot;: [ # Specifies a list of header match criteria, all of which must match
6798 # corresponding headers in the request.
6799 { # matchRule criteria for request header matches.
6800 &quot;exactMatch&quot;: &quot;A String&quot;, # The value should exactly match contents of exactMatch.
6801 #
6802 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
6803 &quot;headerName&quot;: &quot;A String&quot;, # The name of the HTTP header to match.
6804 #
6805 # For matching against the HTTP request&#x27;s authority, use a headerMatch
6806 # with the header name &quot;:authority&quot;.
6807 #
6808 # For matching a request&#x27;s method, use the headerName &quot;:method&quot;.
6809 #
6810 # When the URL map is bound to a target gRPC proxy that has
6811 # the validateForProxyless field set to true, only
6812 # non-binary
6813 # user-specified custom metadata and the `content-type` header are supported.
6814 # The following transport-level headers cannot be used in header matching
6815 # rules:
6816 # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
6817 # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
6818 # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
6819 # `grpc-timeout` and `grpc-trace-bin`.
6820 &quot;invertMatch&quot;: True or False, # If set to false, the headerMatch is considered a
6821 # match if the preceding match criteria are met. If set to true,
6822 # the headerMatch is considered a match if the preceding
6823 # match criteria are NOT met.
6824 #
6825 # The default setting is false.
6826 &quot;prefixMatch&quot;: &quot;A String&quot;, # The value of the header must start with the contents ofprefixMatch.
6827 #
6828 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
6829 &quot;presentMatch&quot;: True or False, # A header with the contents of headerName must exist. The
6830 # match takes place whether or not the request&#x27;s header has a value.
6831 #
6832 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
6833 &quot;rangeMatch&quot;: { # HttpRouteRuleMatch criteria for field values that must stay # The header value must be an integer and its value must be in the range
6834 # specified in rangeMatch. If the header does not contain an
6835 # integer, number or is empty, the match fails.
6836 #
6837 # For example for a range [-5, 0]
6838 #
6839 #
6840 # - -3 will match.
6841 # - 0 will not match.
6842 # - 0.25 will not match.
6843 # - -3someString will not match.
6844 #
6845 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
6846 #
6847 # rangeMatch is not supported for load balancers
6848 # that have loadBalancingScheme set to EXTERNAL.
6849 # within the specified integer range.
6850 &quot;rangeEnd&quot;: &quot;A String&quot;, # The end of the range (exclusive) in signed long integer format.
6851 &quot;rangeStart&quot;: &quot;A String&quot;, # The start of the range (inclusive) in signed long integer format.
6852 },
6853 &quot;regexMatch&quot;: &quot;A String&quot;, # The value of the header must match the regular expression specified inregexMatch.
6854 # For more information about regular expression syntax, see Syntax.
6855 #
6856 # For matching against a port specified in the HTTP request, use a
6857 # headerMatch with headerName set to PORT and a regular expression that
6858 # satisfies the RFC2616 Host header&#x27;s port specifier.
6859 #
6860 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
6861 #
6862 # Regular expressions can only be used when the loadBalancingScheme is
6863 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
6864 # (regional scope) or INTERNAL_MANAGED.
6865 &quot;suffixMatch&quot;: &quot;A String&quot;, # The value of the header must end with the contents ofsuffixMatch.
6866 #
6867 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
6868 },
6869 ],
6870 &quot;ignoreCase&quot;: True or False, # Specifies that prefixMatch and fullPathMatch
6871 # matches are case sensitive.
6872 #
6873 # The default value is false.
6874 #
6875 # ignoreCase must not be used with regexMatch.
6876 #
6877 # Not supported when the URL map is bound to a target gRPC proxy.
6878 &quot;metadataFilters&quot;: [ # Opaque filter criteria used by the load balancer to restrict routing
6879 # configuration to a limited set of xDS
6880 # compliant clients. In their xDS requests to the load balancer, xDS clients
6881 # present node
6882 # metadata. When there is a match, the relevant routing configuration
6883 # is made available to those proxies.
6884 #
6885 # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least one of thefilterLabels must match the corresponding label provided in
6886 # the metadata. If its filterMatchCriteria is set to
6887 # MATCH_ALL, then all of its filterLabels must match with
6888 # corresponding labels provided in the metadata. If multiple
6889 # metadata filters are specified, all of them need to be
6890 # satisfied in order to be considered a match.
6891 #
6892 # metadataFilters specified here is applied after those
6893 # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
6894 #
6895 # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
6896 #
6897 # Not supported when the URL map is bound to a target gRPC proxy that
6898 # has validateForProxyless field set to true.
6899 { # Opaque filter criteria used by load balancers to restrict routing
6900 # configuration to a limited set of load balancing proxies. Proxies and
6901 # sidecars involved in load balancing would typically present metadata to the
6902 # load balancers that need to match criteria specified here. If a match takes
6903 # place, the relevant configuration is made available to those
6904 # proxies.
6905 #
6906 # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
6907 # one of thefilterLabels must match the corresponding label provided in
6908 # the metadata. If its filterMatchCriteria is set to
6909 # MATCH_ALL, then all of its filterLabels must match with
6910 # corresponding labels provided in the metadata.
6911 #
6912 # An example for using metadataFilters would be: if
6913 # load balancing involves
6914 # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in of their XDS requests to loadbalancers.
6915 &quot;filterLabels&quot;: [ # The list of label value pairs that must match labels in the provided
6916 # metadata based on filterMatchCriteria
6917 #
6918 # This list must not be empty and can have at the most 64 entries.
6919 { # MetadataFilter label name value pairs that are expected
6920 # to match corresponding labels presented as metadata to the load balancer.
6921 &quot;name&quot;: &quot;A String&quot;, # Name of metadata label.
6922 #
6923 # The name can have a maximum length of 1024 characters and must be at
6924 # least 1 character long.
6925 &quot;value&quot;: &quot;A String&quot;, # The value of the label must match the specified value.
6926 #
6927 # value can have a maximum length of 1024 characters.
6928 },
6929 ],
6930 &quot;filterMatchCriteria&quot;: &quot;A String&quot;, # Specifies how individual filter label matches
6931 # within the list of filterLabels and contributes toward the
6932 # overall metadataFilter match.
6933 #
6934 # Supported values are:
6935 #
6936 # - MATCH_ANY: at least one of the filterLabels
6937 # must have a matching label in the provided metadata.
6938 # - MATCH_ALL: all filterLabels must have
6939 # matching labels in the provided metadata.
6940 },
6941 ],
6942 &quot;pathTemplateMatch&quot;: &quot;A String&quot;, # If specified, this field defines a path template pattern that must match
6943 # the :path header after the query string is removed.
6944 #
6945 # A path template pattern can include variables and wildcards.
6946 # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
6947 # matches a single path segment, and ** that matches zero or
6948 # more path segments. The pattern must follow these rules:
6949 #
6950 #
6951 # - The value must be between 1 and 1024 characters.
6952 # - The pattern must start with a leading slash (&quot;/&quot;).
6953 # - No more than 5 operators (variables or wildcards) may appear in
6954 # the pattern.
6955 #
6956 # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
6957 # set.
6958 &quot;prefixMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the request&#x27;s
6959 # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
6960 #
6961 # The value must be from 1 to 1024 characters.
6962 #
6963 # The * character inside a prefix match is
6964 # treated as a literal character, not as a wildcard.
6965 #
6966 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
6967 # used within a matchRule.
6968 &quot;queryParameterMatches&quot;: [ # Specifies a list of query parameter match criteria, all of which must
6969 # match corresponding query parameters in the request.
6970 #
6971 # Not supported when the URL map is bound to a target gRPC proxy.
6972 { # HttpRouteRuleMatch criteria for a request&#x27;s query parameter.
6973 &quot;exactMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
6974 # parameter exactly matches the contents of exactMatch.
6975 #
6976 # Only one of presentMatch, exactMatch, orregexMatch must be set.
6977 &quot;name&quot;: &quot;A String&quot;, # The name of the query parameter to match. The query parameter must exist in
6978 # the request, in the absence of which the request match fails.
6979 &quot;presentMatch&quot;: True or False, # Specifies that the queryParameterMatch matches if the
6980 # request contains the query parameter, irrespective of whether the
6981 # parameter has a value or not.
6982 #
6983 # Only one of presentMatch, exactMatch, orregexMatch must be set.
6984 &quot;regexMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
6985 # parameter matches the regular expression specified byregexMatch. For
6986 # more information about regular expression syntax, see Syntax.
6987 #
6988 # Only one of presentMatch, exactMatch, orregexMatch must be set.
6989 #
6990 # Regular expressions can only be used when the loadBalancingScheme is
6991 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
6992 # (regional scope) or INTERNAL_MANAGED.
6993 },
6994 ],
6995 &quot;regexMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
6996 # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
6997 # supplied with the original URL. For
6998 # more information about regular expression syntax, see Syntax.
6999 #
7000 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
7001 # specified.
7002 #
7003 # Regular expressions can only be used when the loadBalancingScheme is
7004 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
7005 # (regional scope) or INTERNAL_MANAGED.
7006 },
7007 ],
7008 &quot;priority&quot;: 42, # For routeRules within a given pathMatcher,
7009 # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
7010 # of priority, from the lowest to highest number. The priority of a
7011 # rule decreases as its number increases (1, 2, 3, N+1). The first rule
7012 # that matches the request is applied.
7013 #
7014 #
7015 # You cannot configure two or more routeRules with the same priority.
7016 # Priority for each rule must be set to a number from 0 to 2147483647
7017 # inclusive.
7018 #
7019 #
7020 # Priority numbers can have gaps, which enable you to add or remove rules
7021 # in the future without affecting the rest of the rules. For example, 1, 2,
7022 # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
7023 # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
7024 # without any impact on existing rules.
7025 &quot;routeAction&quot;: { # In response to a matching matchRule, the load balancer
7026 # performs advanced routing actions, such as URL rewrites and header
7027 # transformations, before forwarding the request to the selected backend.
7028 #
7029 #
7030 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
7031 #
7032 #
7033 # URL maps for classic Application Load Balancers only support
7034 # the urlRewrite action within a route rule&#x27;srouteAction.
7035 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
7036 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
7037 # property must be specified. This policy cannot be specified if any target
7038 # backend has Identity-Aware Proxy enabled.
7039 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
7040 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
7041 # header names can be specified. The cache is bypassed for all `cacheMode`
7042 # values.
7043 &quot;A String&quot;,
7044 ],
7045 &quot;cacheKeyPolicy&quot;: { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
7046 # on the backend type: for Backend Services, the complete request URI is
7047 # used; for Backend Buckets, the request URI is used without the protocol or
7048 # host, and only query parameters known to Cloud Storage are included.
7049 # Policy defined on Route Action.
7050 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
7051 # parameters will be included. Either specify `excludedQueryParameters`
7052 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
7053 # encoded and not treated as delimiters.
7054 #
7055 # Note: This field applies to routes that use backend services. Attempting
7056 # to set it on a route that points exclusively to Backend Buckets will
7057 # result in a configuration error. For routes that point to a Backend
7058 # Bucket, use `includedQueryParameters` to define which parameters should
7059 # be part of the cache key.
7060 &quot;A String&quot;,
7061 ],
7062 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
7063 #
7064 # Note: This setting is only applicable to routes that use a Backend
7065 # Service. It does not affect requests served by a Backend Bucket, as the
7066 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
7067 # it on a route that points exclusively to Backend Buckets will result in a
7068 # configuration error.
7069 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
7070 #
7071 # Note: This setting is only applicable to routes that use a Backend
7072 # Service. It does not affect requests served by a Backend Bucket, as the
7073 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
7074 # set on a route that points exclusively to Backend Buckets will result in
7075 # a configuration error.
7076 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
7077 # `includedQueryParameters` and `excludedQueryParameters`. If neither
7078 # is set, the entire query string will be included. If false, the query
7079 # string will be excluded from the cache key entirely.
7080 #
7081 # Note: This field applies to routes that use backend services. Attempting
7082 # to set it on a route that points exclusively to Backend Buckets will
7083 # result in a configuration error. For routes that point to a Backend
7084 # Bucket, use `includedQueryParameters` to define which parameters should
7085 # be part of the cache key.
7086 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
7087 # The name=value pair will be used in the cache key Cloud CDN generates.
7088 #
7089 # Note: This setting is only applicable to routes that use a Backend
7090 # Service. It does not affect requests served by a Backend Bucket.
7091 # Attempting to set it on a route that points exclusively to Backend
7092 # Buckets will result in a configuration error. Up to 5 cookie names can be
7093 # specified.
7094 &quot;A String&quot;,
7095 ],
7096 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
7097 &quot;A String&quot;,
7098 ],
7099 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
7100 # parameters will be excluded. Either specify `includedQueryParameters`
7101 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
7102 # encoded and not treated as delimiters.
7103 &quot;A String&quot;,
7104 ],
7105 },
7106 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
7107 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
7108 &quot;clientTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
7109 # content. This is used to clamp the max-age (or Expires) value sent to the
7110 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
7111 # is used for the response max-age directive, along with a &quot;public&quot;
7112 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
7113 # clamps the max-age from the origin (if specified), or else sets the
7114 # response max-age directive to the lesser of the `clientTtl` and
7115 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
7116 # present. The maximum allowed value is 31,622,400s (1 year). If not
7117 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
7118 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
7119 # `USE_ORIGIN_HEADERS`.
7120 # as a count of seconds and fractions of seconds at nanosecond
7121 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7122 # or &quot;month&quot;. Range is approximately 10,000 years.
7123 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7124 # Durations less than one second are represented with a 0
7125 # `seconds` field and a positive `nanos` field. Must be from 0
7126 # to 999,999,999 inclusive.
7127 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7128 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7129 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7130 },
7131 &quot;defaultTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
7132 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
7133 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
7134 # greater than that of `maxTtl`. When the `cacheMode` is set to
7135 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
7136 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
7137 # accessed objects may be evicted from the cache before the defined TTL. If
7138 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
7139 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
7140 # `USE_ORIGIN_HEADERS`.
7141 # as a count of seconds and fractions of seconds at nanosecond
7142 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7143 # or &quot;month&quot;. Range is approximately 10,000 years.
7144 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7145 # Durations less than one second are represented with a 0
7146 # `seconds` field and a positive `nanos` field. Must be from 0
7147 # to 999,999,999 inclusive.
7148 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7149 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7150 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7151 },
7152 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
7153 # attempt to set a max-age or s-maxage higher than this, or an Expires header
7154 # more than `maxTtl` seconds in the future will be capped at the value of
7155 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
7156 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
7157 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
7158 # Infrequently accessed objects may be evicted from the cache before the
7159 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
7160 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
7161 # mode.
7162 # as a count of seconds and fractions of seconds at nanosecond
7163 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7164 # or &quot;month&quot;. Range is approximately 10,000 years.
7165 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7166 # Durations less than one second are represented with a 0
7167 # `seconds` field and a positive `nanos` field. Must be from 0
7168 # to 999,999,999 inclusive.
7169 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7170 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7171 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7172 },
7173 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
7174 # to apply fine-grained caching for common errors or redirects.
7175 # This can reduce the load on your origin and improve end-user
7176 # experience by reducing response latency.
7177 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
7178 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
7179 # the specified response code that lack any Cache-Control, Expires, or
7180 # Pragma: no-cache directives. When the `cacheMode` is set to
7181 # `FORCE_CACHE_ALL`, negative caching applies to all responses
7182 # with the specified response code, and overrides any caching headers. By
7183 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
7184 #
7185 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
7186 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
7187 # * 405 (Method Not Found), 501 (Not Implemented): 60s
7188 #
7189 # These defaults can be overridden in `negativeCachingPolicy`.
7190 # If not specified, Cloud CDN applies negative caching by default.
7191 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
7192 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
7193 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
7194 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
7195 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
7196 # all response codes that you wish to cache. Cloud CDN will not apply any
7197 # default negative caching when a policy exists.
7198 { # Specify CDN TTLs for response error codes.
7199 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
7200 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
7201 # specified as values, and you cannot specify a status code more than
7202 # once.
7203 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
7204 # corresponding status code.
7205 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
7206 # objects may be evicted from the cache before the defined TTL.
7207 # as a count of seconds and fractions of seconds at nanosecond
7208 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7209 # or &quot;month&quot;. Range is approximately 10,000 years.
7210 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7211 # Durations less than one second are represented with a 0
7212 # `seconds` field and a positive `nanos` field. Must be from 0
7213 # to 999,999,999 inclusive.
7214 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7215 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7216 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7217 },
7218 },
7219 ],
7220 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
7221 # requests into a small number of requests to the origin. If not specified,
7222 # Cloud CDN applies request coalescing by default.
7223 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
7224 # content with the origin, or when an error is encountered when refreshing
7225 # the cache.
7226 # This setting defines the default &quot;max-stale&quot; duration for any cached
7227 # responses that do not specify a max-stale directive. Stale responses that
7228 # exceed the TTL configured here will not be served. The default limit
7229 # (max-stale) is 86400s (1 day), which will allow stale content to be
7230 # served up to this limit beyond the max-age (or s-maxage) of a cached
7231 # response.
7232 # The maximum allowed value is 604800 (1 week).
7233 # Set this to zero (0) to disable serve-while-stale.
7234 # as a count of seconds and fractions of seconds at nanosecond
7235 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7236 # or &quot;month&quot;. Range is approximately 10,000 years.
7237 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7238 # Durations less than one second are represented with a 0
7239 # `seconds` field and a positive `nanos` field. Must be from 0
7240 # to 999,999,999 inclusive.
7241 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7242 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7243 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7244 },
7245 },
7246 &quot;corsPolicy&quot;: { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
7247 # information about the W3C recommendation for cross-origin resource sharing
7248 # (CORS), see Fetch API Living
7249 # Standard.
7250 #
7251 # Not supported when the URL map is bound to a target gRPC proxy.
7252 # information about the W3C recommendation for cross-origin resource sharing
7253 # (CORS), see Fetch API Living
7254 # Standard.
7255 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
7256 # indicates that
7257 # the actual request can include user credentials. This field translates to
7258 # the Access-Control-Allow-Credentials header.
7259 #
7260 # Default is false.
7261 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
7262 # header.
7263 &quot;A String&quot;,
7264 ],
7265 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
7266 # header.
7267 &quot;A String&quot;,
7268 ],
7269 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
7270 # more information, see regular expression syntax.
7271 #
7272 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
7273 #
7274 # Regular expressions can only be used when the loadBalancingScheme is
7275 # set to INTERNAL_SELF_MANAGED.
7276 &quot;A String&quot;,
7277 ],
7278 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
7279 #
7280 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
7281 &quot;A String&quot;,
7282 ],
7283 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
7284 # The default value is false, which indicates that the CORS
7285 # policy is in effect.
7286 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
7287 # header.
7288 &quot;A String&quot;,
7289 ],
7290 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
7291 # seconds. This field translates to the Access-Control-Max-Age
7292 # header.
7293 },
7294 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
7295 # the resiliency of clients to backend service failure. As part of fault
7296 # injection, when clients send requests to a backend service, delays can be
7297 # introduced by a load balancer on a percentage of requests before sending
7298 # those requests to the backend service. Similarly requests from clients can
7299 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
7300 # that are configured with a fault_injection_policy if:
7301 # 1. The traffic is generated by fault injection AND
7302 # 2. The fault injection is not a delay fault injection.
7303 # Fault injection is not supported with the classic Application Load Balancer
7304 # . To see which load balancers support fault injection,
7305 # see Load
7306 # balancing: Routing and traffic management features.
7307 # the resiliency of clients to backend service failure. As part of fault
7308 # injection, when clients send requests to a backend service, delays can be
7309 # introduced by the load balancer on a percentage of requests before sending
7310 # those request to the backend service. Similarly requests from clients can be
7311 # aborted by the load balancer for a percentage of requests.
7312 &quot;abort&quot;: { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
7313 # injection.
7314 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
7315 #
7316 # The value must be from 200 to 599 inclusive.
7317 #
7318 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
7319 # according to this
7320 # mapping table. HTTP status 200 is mapped to gRPC status
7321 # UNKNOWN. Injecting an OK status is currently not supported by
7322 # Traffic Director.
7323 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
7324 # that is aborted as part of fault injection.
7325 #
7326 # The value must be from 0.0 to 100.0 inclusive.
7327 },
7328 &quot;delay&quot;: { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
7329 # injection, before being sent to a backend service.
7330 # request to the backend service as part of fault injection.
7331 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
7332 # as a count of seconds and fractions of seconds at nanosecond
7333 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7334 # or &quot;month&quot;. Range is approximately 10,000 years.
7335 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7336 # Durations less than one second are represented with a 0
7337 # `seconds` field and a positive `nanos` field. Must be from 0
7338 # to 999,999,999 inclusive.
7339 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7340 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7341 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7342 },
7343 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
7344 # which a delay is introduced as part of fault injection.
7345 #
7346 # The value must be from 0.0 to 100.0 inclusive.
7347 },
7348 },
7349 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
7350 # Unlike the timeout field where the timeout duration starts
7351 # from the time the request has been fully processed (known as*end-of-stream*),
7352 # the duration in this field is computed from the beginning of the stream
7353 # until the response has been processed, including all retries. A
7354 # stream that does not complete in this duration is closed.
7355 #
7356 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
7357 # with the route.
7358 #
7359 # This field is only allowed if the Url map is used with backend services
7360 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
7361 # as a count of seconds and fractions of seconds at nanosecond
7362 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7363 # or &quot;month&quot;. Range is approximately 10,000 years.
7364 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7365 # Durations less than one second are represented with a 0
7366 # `seconds` field and a positive `nanos` field. Must be from 0
7367 # to 999,999,999 inclusive.
7368 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7369 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7370 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7371 },
7372 &quot;requestMirrorPolicy&quot;: { # A policy that specifies how requests intended for the route&#x27;s backends # Specifies the policy on how requests intended for the route&#x27;s backends
7373 # are shadowed to a separate mirrored backend service. The load balancer does
7374 # not wait for responses from the shadow service. Before sending traffic
7375 # to the shadow service, the host / authority header is suffixed with-shadow.
7376 #
7377 # Not supported when the URL map is bound to a target gRPC proxy that
7378 # has the validateForProxyless field set to true.
7379 # are shadowed to a separate mirrored backend service. The load balancer
7380 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
7381 # to the shadow service, the host or authority header is suffixed with-shadow.
7382 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
7383 # mirrored to.
7384 #
7385 # The backend service configured for a mirroring
7386 # policy must reference backends that are of the same type as the original
7387 # backend service matched in the URL map.
7388 #
7389 # Serverless NEG backends are not currently supported as a mirrored
7390 # backend service.
7391 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
7392 },
7393 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
7394 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
7395 # If not specified, defaults to 1.
7396 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
7397 #
7398 # If not specified, will use the timeout set in theHttpRouteAction field.
7399 # If timeout in the HttpRouteAction field is not set, this field
7400 # uses the largest timeout
7401 # among all backend services associated with the route.
7402 #
7403 # Not supported when the URL map is bound to a target gRPC proxy that
7404 # has the validateForProxyless field set to true.
7405 # as a count of seconds and fractions of seconds at nanosecond
7406 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7407 # or &quot;month&quot;. Range is approximately 10,000 years.
7408 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7409 # Durations less than one second are represented with a 0
7410 # `seconds` field and a positive `nanos` field. Must be from 0
7411 # to 999,999,999 inclusive.
7412 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7413 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7414 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7415 },
7416 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
7417 # values are:
7418 #
7419 # - 5xx: retry is attempted if the instance or endpoint
7420 # responds with any 5xx response code, or if the instance or
7421 # endpoint does not respond at all. For example, disconnects, reset, read
7422 # timeout, connection failure, and refused streams.
7423 # - gateway-error: Similar to 5xx, but only
7424 # applies to response codes 502, 503 or504.
7425 # - connect-failure: a retry is attempted on failures
7426 # connecting to the instance or endpoint. For example, connection
7427 # timeouts.
7428 # - retriable-4xx: a retry is attempted if the instance
7429 # or endpoint responds with a 4xx response code.
7430 # The only error that you can retry is error code 409.
7431 # - refused-stream: a retry is attempted if the instance
7432 # or endpoint resets the stream with a REFUSED_STREAM error
7433 # code. This reset type indicates that it is safe to retry.
7434 # - cancelled: a retry is attempted if the gRPC status
7435 # code in the response header is set to cancelled.
7436 # - deadline-exceeded: a retry is attempted if the gRPC
7437 # status code in the response header is set todeadline-exceeded.
7438 # - internal: a retry is attempted if the gRPC
7439 # status code in the response header is set tointernal.
7440 # - resource-exhausted: a retry is attempted if the gRPC
7441 # status code in the response header is set toresource-exhausted.
7442 # - unavailable: a retry is attempted if the gRPC
7443 # status code in the response header is set tounavailable.
7444 #
7445 # Only the following codes are supported when the URL map is bound to
7446 # target gRPC proxy that has validateForProxyless field set to true.
7447 #
7448 # - cancelled
7449 # - deadline-exceeded
7450 # - internal
7451 # - resource-exhausted
7452 # - unavailable
7453 &quot;A String&quot;,
7454 ],
7455 },
7456 &quot;timeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
7457 # time the request has been fully processed (known as *end-of-stream*)
7458 # up until the response has been processed. Timeout includes
7459 # all retries.
7460 #
7461 # If not specified, this field uses the largest timeout among all backend
7462 # services associated with the route.
7463 #
7464 # Not supported when the URL map is bound to a target gRPC proxy that
7465 # has validateForProxyless field set to true.
7466 # as a count of seconds and fractions of seconds at nanosecond
7467 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7468 # or &quot;month&quot;. Range is approximately 10,000 years.
7469 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7470 # Durations less than one second are represented with a 0
7471 # `seconds` field and a positive `nanos` field. Must be from 0
7472 # to 999,999,999 inclusive.
7473 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7474 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7475 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7476 },
7477 &quot;urlRewrite&quot;: { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
7478 # to the matched service.
7479 #
7480 # urlRewrite is the only action supported in UrlMaps
7481 # for classic Application Load Balancers.
7482 #
7483 # Not supported when the URL map is bound to a target gRPC proxy that
7484 # has the validateForProxyless field set to true.
7485 # backend service.
7486 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
7487 # host header is replaced with contents of hostRewrite.
7488 #
7489 # The value must be from 1 to 255 characters.
7490 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
7491 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
7492 #
7493 # The value must be from 1 to 1024 characters.
7494 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
7495 # header) using the HTTP template syntax.
7496 #
7497 # A corresponding
7498 # path_template_match must be specified. Any template variables must exist in
7499 # the path_template_match field.
7500 #
7501 #
7502 # - -At least one variable must be specified in the path_template_match
7503 # field
7504 # - You can omit variables from the rewritten URL
7505 # - The * and ** operators cannot be matched
7506 # unless they have a corresponding variable name - e.g.
7507 # {format=*} or {var=**}.
7508 #
7509 # For example, a path_template_match of /static/{format=**}
7510 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
7511 # rewrite, so that /{country}/{format}/{suffix=**} can be
7512 # rewritten as /content/{format}/{country}/{suffix}.
7513 #
7514 # At least
7515 # one non-empty routeRules[].matchRules[].path_template_match is
7516 # required.
7517 #
7518 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
7519 },
7520 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
7521 # occurs. The weights determine the fraction of traffic that flows to
7522 # their corresponding backend service. If all traffic needs to
7523 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
7524 #
7525 # After a backend service is identified and before forwarding
7526 # the request to
7527 # the backend service, advanced routing actions such as URL rewrites and
7528 # header transformations are applied depending on additional settings
7529 # specified in this HttpRouteAction.
7530 { # In contrast to a single BackendService in
7531 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
7532 # multiple backend services. The volume of traffic for each
7533 # backend service is proportional to the weight specified
7534 # in each WeightedBackendService
7535 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
7536 # resource. Before
7537 # forwarding the request to backendService, the load balancer
7538 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
7539 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
7540 # effect for the selected backendService.
7541 #
7542 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
7543 #
7544 # headerAction is not supported for load balancers that have
7545 # their loadBalancingScheme set to EXTERNAL.
7546 #
7547 # Not supported when the URL map is bound to a target gRPC proxy that
7548 # has validateForProxyless field set to true.
7549 # the request is passed along to the selected backendService.
7550 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
7551 { # Specification determining how headers are added to requests or responses.
7552 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
7553 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
7554 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
7555 # that already
7556 # exist for the header. If true, headerValue is set for the
7557 # header, discarding any values that were set for that header.
7558 #
7559 # The default value is true,
7560 # unless a variable is present in headerValue,
7561 # in which case the default value is false.
7562 # .
7563 },
7564 ],
7565 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
7566 # request before forwarding the request to the backendService.
7567 &quot;A String&quot;,
7568 ],
7569 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
7570 # client.
7571 { # Specification determining how headers are added to requests or responses.
7572 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
7573 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
7574 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
7575 # that already
7576 # exist for the header. If true, headerValue is set for the
7577 # header, discarding any values that were set for that header.
7578 #
7579 # The default value is true,
7580 # unless a variable is present in headerValue,
7581 # in which case the default value is false.
7582 # .
7583 },
7584 ],
7585 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
7586 # response before sending the response back to the client.
7587 &quot;A String&quot;,
7588 ],
7589 },
7590 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
7591 # computed asweight / (sum of all weightedBackendService weights in routeAction).
7592 #
7593 # The selection of a backend service is determined only for new traffic.
7594 # Once a user&#x27;s request has been directed to a backend service,
7595 # subsequent requests are sent to the same backend service as
7596 # determined by the backend service&#x27;s session affinity policy.
7597 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
7598 # splitting. If you do, the weighted traffic splitting configuration takes
7599 # precedence.
7600 #
7601 # The value must be from 0 to 1000.
7602 },
7603 ],
7604 },
7605 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
7606 # is directed if this rule is matched. If routeAction is
7607 # also specified, advanced routing actions, such as URL rewrites,
7608 # take effect before sending the request to the backend.
7609 #
7610 #
7611 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
7612 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
7613 # specified by urlRedirect.
7614 #
7615 #
7616 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
7617 #
7618 #
7619 # Not supported when the URL map is bound to a target gRPC proxy.
7620 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
7621 # was supplied in the request.
7622 #
7623 # The value must be from 1 to 255
7624 # characters.
7625 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
7626 # set to HTTPS.
7627 # If set to false, the URL scheme of the redirected request
7628 # remains the same as that of the request.
7629 #
7630 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
7631 #
7632 # The default is set to false.
7633 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
7634 # that was supplied in the request.
7635 #
7636 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
7637 # supplied, the path of the original request is used for the redirect.
7638 #
7639 # The value must be from 1 to 1024 characters.
7640 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
7641 # the HttpRouteRuleMatch, retaining the remaining portion
7642 # of the URL before redirecting the request.
7643 #
7644 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
7645 # supplied, the path of the original request is used for the redirect.
7646 #
7647 # The value must be from 1 to 1024 characters.
7648 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
7649 #
7650 # Supported values are:
7651 #
7652 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
7653 # to 301.
7654 # - FOUND, which corresponds to 302.
7655 # - SEE_OTHER which corresponds to 303.
7656 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
7657 # method is retained.
7658 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
7659 # method is retained.
7660 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
7661 # URL is
7662 # removed before redirecting the request. If set to false, the
7663 # query portion of the original URL is retained.
7664 #
7665 # The default is set to false.
7666 },
7667 },
7668 ],
7669 },
7670 ],
7671 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the regional URL map resides.
7672 # This field is not applicable to global URL maps.
7673 # You must specify this field as part of the HTTP request URL. It is
7674 # not settable as a field in the request body.
7675 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
7676 &quot;tests&quot;: [ # The list of expected URL mapping tests. Request to update theUrlMap succeeds only if all test cases pass. You can specify a
7677 # maximum of 100 tests per UrlMap.
7678 #
7679 # Not supported when the URL map is bound to a target gRPC proxy that
7680 # has validateForProxyless field set to true.
7681 { # Message for the expected URL mappings.
7682 &quot;description&quot;: &quot;A String&quot;, # Description of this test case.
7683 &quot;expectedOutputUrl&quot;: &quot;A String&quot;, # The expected output URL evaluated by the load balancer
7684 # containing the scheme, host, path and query parameters.
7685 #
7686 # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
7687 # the load balancer to backends. For rules with urlRewrite,
7688 # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
7689 #
7690 # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer&#x27;s
7691 # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
7692 # If urlRedirect specifies strip_query, the test
7693 # passes only if expectedOutputUrl does not contain any query
7694 # parameters.
7695 #
7696 # expectedOutputUrl is optional whenservice is specified.
7697 &quot;expectedRedirectResponseCode&quot;: 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
7698 # load balancer&#x27;s redirect response.
7699 #
7700 # expectedRedirectResponseCode cannot be set whenservice is set.
7701 &quot;headers&quot;: [ # HTTP headers for this request. If headers contains
7702 # a host header, then host must also match the header value.
7703 { # HTTP headers used in UrlMapTests.
7704 &quot;name&quot;: &quot;A String&quot;, # Header name.
7705 &quot;value&quot;: &quot;A String&quot;, # Header value.
7706 },
7707 ],
7708 &quot;host&quot;: &quot;A String&quot;, # Host portion of the URL. If headers contains a host header,
7709 # then host must also match the header value.
7710 &quot;path&quot;: &quot;A String&quot;, # Path portion of the URL.
7711 &quot;service&quot;: &quot;A String&quot;, # Expected BackendService or BackendBucket resource
7712 # the given URL should be mapped to.
7713 #
7714 # The service field cannot
7715 # be set if expectedRedirectResponseCode is set.
7716 },
7717 ],
7718 }</pre>
7719 </div>
7720
7721 <div class="method">
7722 <code class="details" id="insert">insert(project, body=None, requestId=None, x__xgafv=None)</code>
7723 <pre>Creates a UrlMap resource in the specified project using
7724 the data included in the request.
7725
7726 Args:
7727 project: string, Project ID for this request. (required)
7728 body: object, The request body.
7729 The object takes the form of:
7730
7731 { # Represents a URL Map resource.
7732 #
7733 # Compute Engine has two URL Map resources:
7734 #
7735 # * [Global](/compute/docs/reference/rest/v1/urlMaps)
7736 # * [Regional](/compute/docs/reference/rest/v1/regionUrlMaps)
7737 #
7738 # A URL map resource is a component of certain types of cloud load balancers
7739 # and Traffic Director:
7740 #
7741 # * urlMaps are used by global external Application Load
7742 # Balancers, classic Application Load Balancers, and cross-region internal
7743 # Application Load Balancers.
7744 # * regionUrlMaps are used by internal Application Load Balancers,
7745 # regional external Application Load Balancers and regional internal
7746 # Application Load Balancers.
7747 #
7748 # For a list of supported URL map features by the load balancer type, see the
7749 # Load balancing features: Routing and traffic management table.
7750 #
7751 # For a list of supported URL map features for Traffic Director, see the
7752 # Traffic Director features: Routing and traffic management table.
7753 #
7754 # This resource defines mappings from hostnames and URL paths to either a
7755 # backend service or a backend bucket.
7756 #
7757 # To use the global urlMaps resource, the backend service must
7758 # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
7759 # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
7760 # information, read URL
7761 # Map Concepts.
7762 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
7763 # text format.
7764 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
7765 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
7766 #
7767 # This policy takes
7768 # effect at the load balancer level and applies only when no policy has been
7769 # defined for the error code at lower levels like PathMatcher, RouteRule and
7770 # PathRule within this UrlMap.
7771 #
7772 # For example, consider a UrlMap with the
7773 # following configuration:
7774 #
7775 #
7776 # - defaultCustomErrorResponsePolicy containing policies for
7777 # responding to 5xx and 4xx errors
7778 # - A PathMatcher configured for *.example.com has
7779 # defaultCustomErrorResponsePolicy for 4xx.
7780 #
7781 # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
7782 # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
7783 # a request that does not match any host in *.example.com such
7784 # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
7785 # takes effect.
7786 #
7787 # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
7788 # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
7789 # a retry, if load balancer is successful in reaching the
7790 # service, the defaultCustomErrorResponsePolicy is ignored and
7791 # the response from the service is returned to the client.
7792 #
7793 # defaultCustomErrorResponsePolicy is supported only for
7794 # global external Application Load Balancers.
7795 # backend service or backend bucket responds with an error.
7796 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
7797 #
7798 # In a given policy, if you specify rules for both a range of error codes
7799 # as well as rules for specific error codes then rules with specific error
7800 # codes have a higher priority. For example, assume that you configure a rule
7801 # for 401 (Un-authorized) code, and another for all 4 series
7802 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
7803 # However if the backend service returns a 403, the rule for4xx takes effect.
7804 { # Specifies the mapping between the response code that will be returned along
7805 # with the custom error content and the response code returned by the backend
7806 # service.
7807 &quot;matchResponseCodes&quot;: [ # Valid values include:
7808 #
7809 #
7810 # - A number between 400 and 599: For example
7811 # 401 or 503, in which case the load balancer
7812 # applies the policy if the error code exactly matches this value.
7813 # - 5xx: Load Balancer will apply the policy if the
7814 # backend service responds with any response code in the range of
7815 # 500 to 599.
7816 # - 4xx: Load
7817 # Balancer will apply the policy if the backend service responds with any
7818 # response code in the range of 400 to
7819 # 499.
7820 #
7821 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
7822 &quot;A String&quot;,
7823 ],
7824 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
7825 # error content. If overrideResponseCode is not supplied, the
7826 # same response code returned by the original backend bucket or backend
7827 # service is returned to the client.
7828 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
7829 #
7830 # path must start
7831 # with a leading slash. path cannot have trailing slashes.
7832 #
7833 # If the file is not available in backendBucket or the
7834 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
7835 #
7836 # The value must
7837 # be from 1 to 1024 characters
7838 },
7839 ],
7840 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
7841 # contains the custom error content. Examples are:
7842 #
7843 #
7844 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
7845 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
7846 # - global/backendBuckets/myBackendBucket
7847 #
7848 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
7849 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
7850 #
7851 # If load balancer cannot reach
7852 # the backendBucket, a simple Not Found Error will
7853 # be returned, with the original response code (oroverrideResponseCode if configured).
7854 #
7855 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
7856 },
7857 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
7858 # hostRules match. The load balancer performs advanced routing
7859 # actions, such as URL rewrites and header transformations, before forwarding
7860 # the request to the selected backend.
7861 #
7862 #
7863 # Only one of defaultUrlRedirect, defaultService
7864 # or defaultRouteAction.weightedBackendService can be set.
7865 #
7866 #
7867 # URL maps for classic Application Load Balancers only support
7868 # the urlRewrite action within defaultRouteAction.
7869 #
7870 #
7871 # defaultRouteAction has no effect when the URL map is bound
7872 # to a target gRPC proxy that has the validateForProxyless field
7873 # set to true.
7874 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
7875 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
7876 # property must be specified. This policy cannot be specified if any target
7877 # backend has Identity-Aware Proxy enabled.
7878 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
7879 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
7880 # header names can be specified. The cache is bypassed for all `cacheMode`
7881 # values.
7882 &quot;A String&quot;,
7883 ],
7884 &quot;cacheKeyPolicy&quot;: { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
7885 # on the backend type: for Backend Services, the complete request URI is
7886 # used; for Backend Buckets, the request URI is used without the protocol or
7887 # host, and only query parameters known to Cloud Storage are included.
7888 # Policy defined on Route Action.
7889 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
7890 # parameters will be included. Either specify `excludedQueryParameters`
7891 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
7892 # encoded and not treated as delimiters.
7893 #
7894 # Note: This field applies to routes that use backend services. Attempting
7895 # to set it on a route that points exclusively to Backend Buckets will
7896 # result in a configuration error. For routes that point to a Backend
7897 # Bucket, use `includedQueryParameters` to define which parameters should
7898 # be part of the cache key.
7899 &quot;A String&quot;,
7900 ],
7901 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
7902 #
7903 # Note: This setting is only applicable to routes that use a Backend
7904 # Service. It does not affect requests served by a Backend Bucket, as the
7905 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
7906 # it on a route that points exclusively to Backend Buckets will result in a
7907 # configuration error.
7908 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
7909 #
7910 # Note: This setting is only applicable to routes that use a Backend
7911 # Service. It does not affect requests served by a Backend Bucket, as the
7912 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
7913 # set on a route that points exclusively to Backend Buckets will result in
7914 # a configuration error.
7915 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
7916 # `includedQueryParameters` and `excludedQueryParameters`. If neither
7917 # is set, the entire query string will be included. If false, the query
7918 # string will be excluded from the cache key entirely.
7919 #
7920 # Note: This field applies to routes that use backend services. Attempting
7921 # to set it on a route that points exclusively to Backend Buckets will
7922 # result in a configuration error. For routes that point to a Backend
7923 # Bucket, use `includedQueryParameters` to define which parameters should
7924 # be part of the cache key.
7925 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
7926 # The name=value pair will be used in the cache key Cloud CDN generates.
7927 #
7928 # Note: This setting is only applicable to routes that use a Backend
7929 # Service. It does not affect requests served by a Backend Bucket.
7930 # Attempting to set it on a route that points exclusively to Backend
7931 # Buckets will result in a configuration error. Up to 5 cookie names can be
7932 # specified.
7933 &quot;A String&quot;,
7934 ],
7935 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
7936 &quot;A String&quot;,
7937 ],
7938 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
7939 # parameters will be excluded. Either specify `includedQueryParameters`
7940 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
7941 # encoded and not treated as delimiters.
7942 &quot;A String&quot;,
7943 ],
7944 },
7945 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
7946 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
7947 &quot;clientTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
7948 # content. This is used to clamp the max-age (or Expires) value sent to the
7949 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
7950 # is used for the response max-age directive, along with a &quot;public&quot;
7951 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
7952 # clamps the max-age from the origin (if specified), or else sets the
7953 # response max-age directive to the lesser of the `clientTtl` and
7954 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
7955 # present. The maximum allowed value is 31,622,400s (1 year). If not
7956 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
7957 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
7958 # `USE_ORIGIN_HEADERS`.
7959 # as a count of seconds and fractions of seconds at nanosecond
7960 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7961 # or &quot;month&quot;. Range is approximately 10,000 years.
7962 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7963 # Durations less than one second are represented with a 0
7964 # `seconds` field and a positive `nanos` field. Must be from 0
7965 # to 999,999,999 inclusive.
7966 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7967 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7968 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7969 },
7970 &quot;defaultTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
7971 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
7972 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
7973 # greater than that of `maxTtl`. When the `cacheMode` is set to
7974 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
7975 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
7976 # accessed objects may be evicted from the cache before the defined TTL. If
7977 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
7978 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
7979 # `USE_ORIGIN_HEADERS`.
7980 # as a count of seconds and fractions of seconds at nanosecond
7981 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7982 # or &quot;month&quot;. Range is approximately 10,000 years.
7983 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7984 # Durations less than one second are represented with a 0
7985 # `seconds` field and a positive `nanos` field. Must be from 0
7986 # to 999,999,999 inclusive.
7987 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7988 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7989 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7990 },
7991 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
7992 # attempt to set a max-age or s-maxage higher than this, or an Expires header
7993 # more than `maxTtl` seconds in the future will be capped at the value of
7994 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
7995 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
7996 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
7997 # Infrequently accessed objects may be evicted from the cache before the
7998 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
7999 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
8000 # mode.
8001 # as a count of seconds and fractions of seconds at nanosecond
8002 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8003 # or &quot;month&quot;. Range is approximately 10,000 years.
8004 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8005 # Durations less than one second are represented with a 0
8006 # `seconds` field and a positive `nanos` field. Must be from 0
8007 # to 999,999,999 inclusive.
8008 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8009 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8010 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8011 },
8012 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
8013 # to apply fine-grained caching for common errors or redirects.
8014 # This can reduce the load on your origin and improve end-user
8015 # experience by reducing response latency.
8016 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
8017 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
8018 # the specified response code that lack any Cache-Control, Expires, or
8019 # Pragma: no-cache directives. When the `cacheMode` is set to
8020 # `FORCE_CACHE_ALL`, negative caching applies to all responses
8021 # with the specified response code, and overrides any caching headers. By
8022 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
8023 #
8024 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
8025 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
8026 # * 405 (Method Not Found), 501 (Not Implemented): 60s
8027 #
8028 # These defaults can be overridden in `negativeCachingPolicy`.
8029 # If not specified, Cloud CDN applies negative caching by default.
8030 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
8031 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
8032 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
8033 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
8034 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
8035 # all response codes that you wish to cache. Cloud CDN will not apply any
8036 # default negative caching when a policy exists.
8037 { # Specify CDN TTLs for response error codes.
8038 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
8039 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
8040 # specified as values, and you cannot specify a status code more than
8041 # once.
8042 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
8043 # corresponding status code.
8044 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
8045 # objects may be evicted from the cache before the defined TTL.
8046 # as a count of seconds and fractions of seconds at nanosecond
8047 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8048 # or &quot;month&quot;. Range is approximately 10,000 years.
8049 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8050 # Durations less than one second are represented with a 0
8051 # `seconds` field and a positive `nanos` field. Must be from 0
8052 # to 999,999,999 inclusive.
8053 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8054 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8055 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8056 },
8057 },
8058 ],
8059 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
8060 # requests into a small number of requests to the origin. If not specified,
8061 # Cloud CDN applies request coalescing by default.
8062 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
8063 # content with the origin, or when an error is encountered when refreshing
8064 # the cache.
8065 # This setting defines the default &quot;max-stale&quot; duration for any cached
8066 # responses that do not specify a max-stale directive. Stale responses that
8067 # exceed the TTL configured here will not be served. The default limit
8068 # (max-stale) is 86400s (1 day), which will allow stale content to be
8069 # served up to this limit beyond the max-age (or s-maxage) of a cached
8070 # response.
8071 # The maximum allowed value is 604800 (1 week).
8072 # Set this to zero (0) to disable serve-while-stale.
8073 # as a count of seconds and fractions of seconds at nanosecond
8074 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8075 # or &quot;month&quot;. Range is approximately 10,000 years.
8076 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8077 # Durations less than one second are represented with a 0
8078 # `seconds` field and a positive `nanos` field. Must be from 0
8079 # to 999,999,999 inclusive.
8080 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8081 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8082 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8083 },
8084 },
8085 &quot;corsPolicy&quot;: { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
8086 # information about the W3C recommendation for cross-origin resource sharing
8087 # (CORS), see Fetch API Living
8088 # Standard.
8089 #
8090 # Not supported when the URL map is bound to a target gRPC proxy.
8091 # information about the W3C recommendation for cross-origin resource sharing
8092 # (CORS), see Fetch API Living
8093 # Standard.
8094 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
8095 # indicates that
8096 # the actual request can include user credentials. This field translates to
8097 # the Access-Control-Allow-Credentials header.
8098 #
8099 # Default is false.
8100 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
8101 # header.
8102 &quot;A String&quot;,
8103 ],
8104 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
8105 # header.
8106 &quot;A String&quot;,
8107 ],
8108 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
8109 # more information, see regular expression syntax.
8110 #
8111 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
8112 #
8113 # Regular expressions can only be used when the loadBalancingScheme is
8114 # set to INTERNAL_SELF_MANAGED.
8115 &quot;A String&quot;,
8116 ],
8117 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
8118 #
8119 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
8120 &quot;A String&quot;,
8121 ],
8122 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
8123 # The default value is false, which indicates that the CORS
8124 # policy is in effect.
8125 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
8126 # header.
8127 &quot;A String&quot;,
8128 ],
8129 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
8130 # seconds. This field translates to the Access-Control-Max-Age
8131 # header.
8132 },
8133 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
8134 # the resiliency of clients to backend service failure. As part of fault
8135 # injection, when clients send requests to a backend service, delays can be
8136 # introduced by a load balancer on a percentage of requests before sending
8137 # those requests to the backend service. Similarly requests from clients can
8138 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
8139 # that are configured with a fault_injection_policy if:
8140 # 1. The traffic is generated by fault injection AND
8141 # 2. The fault injection is not a delay fault injection.
8142 # Fault injection is not supported with the classic Application Load Balancer
8143 # . To see which load balancers support fault injection,
8144 # see Load
8145 # balancing: Routing and traffic management features.
8146 # the resiliency of clients to backend service failure. As part of fault
8147 # injection, when clients send requests to a backend service, delays can be
8148 # introduced by the load balancer on a percentage of requests before sending
8149 # those request to the backend service. Similarly requests from clients can be
8150 # aborted by the load balancer for a percentage of requests.
8151 &quot;abort&quot;: { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
8152 # injection.
8153 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
8154 #
8155 # The value must be from 200 to 599 inclusive.
8156 #
8157 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
8158 # according to this
8159 # mapping table. HTTP status 200 is mapped to gRPC status
8160 # UNKNOWN. Injecting an OK status is currently not supported by
8161 # Traffic Director.
8162 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
8163 # that is aborted as part of fault injection.
8164 #
8165 # The value must be from 0.0 to 100.0 inclusive.
8166 },
8167 &quot;delay&quot;: { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
8168 # injection, before being sent to a backend service.
8169 # request to the backend service as part of fault injection.
8170 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
8171 # as a count of seconds and fractions of seconds at nanosecond
8172 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8173 # or &quot;month&quot;. Range is approximately 10,000 years.
8174 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8175 # Durations less than one second are represented with a 0
8176 # `seconds` field and a positive `nanos` field. Must be from 0
8177 # to 999,999,999 inclusive.
8178 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8179 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8180 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8181 },
8182 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
8183 # which a delay is introduced as part of fault injection.
8184 #
8185 # The value must be from 0.0 to 100.0 inclusive.
8186 },
8187 },
8188 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
8189 # Unlike the timeout field where the timeout duration starts
8190 # from the time the request has been fully processed (known as*end-of-stream*),
8191 # the duration in this field is computed from the beginning of the stream
8192 # until the response has been processed, including all retries. A
8193 # stream that does not complete in this duration is closed.
8194 #
8195 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
8196 # with the route.
8197 #
8198 # This field is only allowed if the Url map is used with backend services
8199 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
8200 # as a count of seconds and fractions of seconds at nanosecond
8201 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8202 # or &quot;month&quot;. Range is approximately 10,000 years.
8203 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8204 # Durations less than one second are represented with a 0
8205 # `seconds` field and a positive `nanos` field. Must be from 0
8206 # to 999,999,999 inclusive.
8207 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8208 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8209 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8210 },
8211 &quot;requestMirrorPolicy&quot;: { # A policy that specifies how requests intended for the route&#x27;s backends # Specifies the policy on how requests intended for the route&#x27;s backends
8212 # are shadowed to a separate mirrored backend service. The load balancer does
8213 # not wait for responses from the shadow service. Before sending traffic
8214 # to the shadow service, the host / authority header is suffixed with-shadow.
8215 #
8216 # Not supported when the URL map is bound to a target gRPC proxy that
8217 # has the validateForProxyless field set to true.
8218 # are shadowed to a separate mirrored backend service. The load balancer
8219 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
8220 # to the shadow service, the host or authority header is suffixed with-shadow.
8221 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
8222 # mirrored to.
8223 #
8224 # The backend service configured for a mirroring
8225 # policy must reference backends that are of the same type as the original
8226 # backend service matched in the URL map.
8227 #
8228 # Serverless NEG backends are not currently supported as a mirrored
8229 # backend service.
8230 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
8231 },
8232 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
8233 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
8234 # If not specified, defaults to 1.
8235 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
8236 #
8237 # If not specified, will use the timeout set in theHttpRouteAction field.
8238 # If timeout in the HttpRouteAction field is not set, this field
8239 # uses the largest timeout
8240 # among all backend services associated with the route.
8241 #
8242 # Not supported when the URL map is bound to a target gRPC proxy that
8243 # has the validateForProxyless field set to true.
8244 # as a count of seconds and fractions of seconds at nanosecond
8245 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8246 # or &quot;month&quot;. Range is approximately 10,000 years.
8247 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8248 # Durations less than one second are represented with a 0
8249 # `seconds` field and a positive `nanos` field. Must be from 0
8250 # to 999,999,999 inclusive.
8251 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8252 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8253 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8254 },
8255 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
8256 # values are:
8257 #
8258 # - 5xx: retry is attempted if the instance or endpoint
8259 # responds with any 5xx response code, or if the instance or
8260 # endpoint does not respond at all. For example, disconnects, reset, read
8261 # timeout, connection failure, and refused streams.
8262 # - gateway-error: Similar to 5xx, but only
8263 # applies to response codes 502, 503 or504.
8264 # - connect-failure: a retry is attempted on failures
8265 # connecting to the instance or endpoint. For example, connection
8266 # timeouts.
8267 # - retriable-4xx: a retry is attempted if the instance
8268 # or endpoint responds with a 4xx response code.
8269 # The only error that you can retry is error code 409.
8270 # - refused-stream: a retry is attempted if the instance
8271 # or endpoint resets the stream with a REFUSED_STREAM error
8272 # code. This reset type indicates that it is safe to retry.
8273 # - cancelled: a retry is attempted if the gRPC status
8274 # code in the response header is set to cancelled.
8275 # - deadline-exceeded: a retry is attempted if the gRPC
8276 # status code in the response header is set todeadline-exceeded.
8277 # - internal: a retry is attempted if the gRPC
8278 # status code in the response header is set tointernal.
8279 # - resource-exhausted: a retry is attempted if the gRPC
8280 # status code in the response header is set toresource-exhausted.
8281 # - unavailable: a retry is attempted if the gRPC
8282 # status code in the response header is set tounavailable.
8283 #
8284 # Only the following codes are supported when the URL map is bound to
8285 # target gRPC proxy that has validateForProxyless field set to true.
8286 #
8287 # - cancelled
8288 # - deadline-exceeded
8289 # - internal
8290 # - resource-exhausted
8291 # - unavailable
8292 &quot;A String&quot;,
8293 ],
8294 },
8295 &quot;timeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
8296 # time the request has been fully processed (known as *end-of-stream*)
8297 # up until the response has been processed. Timeout includes
8298 # all retries.
8299 #
8300 # If not specified, this field uses the largest timeout among all backend
8301 # services associated with the route.
8302 #
8303 # Not supported when the URL map is bound to a target gRPC proxy that
8304 # has validateForProxyless field set to true.
8305 # as a count of seconds and fractions of seconds at nanosecond
8306 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8307 # or &quot;month&quot;. Range is approximately 10,000 years.
8308 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8309 # Durations less than one second are represented with a 0
8310 # `seconds` field and a positive `nanos` field. Must be from 0
8311 # to 999,999,999 inclusive.
8312 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8313 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8314 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8315 },
8316 &quot;urlRewrite&quot;: { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
8317 # to the matched service.
8318 #
8319 # urlRewrite is the only action supported in UrlMaps
8320 # for classic Application Load Balancers.
8321 #
8322 # Not supported when the URL map is bound to a target gRPC proxy that
8323 # has the validateForProxyless field set to true.
8324 # backend service.
8325 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
8326 # host header is replaced with contents of hostRewrite.
8327 #
8328 # The value must be from 1 to 255 characters.
8329 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
8330 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
8331 #
8332 # The value must be from 1 to 1024 characters.
8333 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
8334 # header) using the HTTP template syntax.
8335 #
8336 # A corresponding
8337 # path_template_match must be specified. Any template variables must exist in
8338 # the path_template_match field.
8339 #
8340 #
8341 # - -At least one variable must be specified in the path_template_match
8342 # field
8343 # - You can omit variables from the rewritten URL
8344 # - The * and ** operators cannot be matched
8345 # unless they have a corresponding variable name - e.g.
8346 # {format=*} or {var=**}.
8347 #
8348 # For example, a path_template_match of /static/{format=**}
8349 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
8350 # rewrite, so that /{country}/{format}/{suffix=**} can be
8351 # rewritten as /content/{format}/{country}/{suffix}.
8352 #
8353 # At least
8354 # one non-empty routeRules[].matchRules[].path_template_match is
8355 # required.
8356 #
8357 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
8358 },
8359 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
8360 # occurs. The weights determine the fraction of traffic that flows to
8361 # their corresponding backend service. If all traffic needs to
8362 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
8363 #
8364 # After a backend service is identified and before forwarding
8365 # the request to
8366 # the backend service, advanced routing actions such as URL rewrites and
8367 # header transformations are applied depending on additional settings
8368 # specified in this HttpRouteAction.
8369 { # In contrast to a single BackendService in
8370 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
8371 # multiple backend services. The volume of traffic for each
8372 # backend service is proportional to the weight specified
8373 # in each WeightedBackendService
8374 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
8375 # resource. Before
8376 # forwarding the request to backendService, the load balancer
8377 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
8378 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
8379 # effect for the selected backendService.
8380 #
8381 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
8382 #
8383 # headerAction is not supported for load balancers that have
8384 # their loadBalancingScheme set to EXTERNAL.
8385 #
8386 # Not supported when the URL map is bound to a target gRPC proxy that
8387 # has validateForProxyless field set to true.
8388 # the request is passed along to the selected backendService.
8389 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
8390 { # Specification determining how headers are added to requests or responses.
8391 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
8392 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
8393 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
8394 # that already
8395 # exist for the header. If true, headerValue is set for the
8396 # header, discarding any values that were set for that header.
8397 #
8398 # The default value is true,
8399 # unless a variable is present in headerValue,
8400 # in which case the default value is false.
8401 # .
8402 },
8403 ],
8404 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
8405 # request before forwarding the request to the backendService.
8406 &quot;A String&quot;,
8407 ],
8408 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
8409 # client.
8410 { # Specification determining how headers are added to requests or responses.
8411 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
8412 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
8413 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
8414 # that already
8415 # exist for the header. If true, headerValue is set for the
8416 # header, discarding any values that were set for that header.
8417 #
8418 # The default value is true,
8419 # unless a variable is present in headerValue,
8420 # in which case the default value is false.
8421 # .
8422 },
8423 ],
8424 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
8425 # response before sending the response back to the client.
8426 &quot;A String&quot;,
8427 ],
8428 },
8429 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
8430 # computed asweight / (sum of all weightedBackendService weights in routeAction).
8431 #
8432 # The selection of a backend service is determined only for new traffic.
8433 # Once a user&#x27;s request has been directed to a backend service,
8434 # subsequent requests are sent to the same backend service as
8435 # determined by the backend service&#x27;s session affinity policy.
8436 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
8437 # splitting. If you do, the weighted traffic splitting configuration takes
8438 # precedence.
8439 #
8440 # The value must be from 0 to 1000.
8441 },
8442 ],
8443 },
8444 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL of the defaultService resource to
8445 # which traffic is directed if none of the hostRules match.
8446 # If defaultRouteAction is also specified, advanced
8447 # routing actions, such as URL rewrites, take effect before sending the
8448 # request to the backend.
8449 #
8450 #
8451 # Only one of defaultUrlRedirect, defaultService
8452 # or defaultRouteAction.weightedBackendService can be set.
8453 #
8454 #
8455 # defaultService has no effect when the URL map is bound
8456 # to a target gRPC proxy that has the validateForProxyless field
8457 # set to true.
8458 &quot;defaultUrlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
8459 # is redirected to a URL specified by defaultUrlRedirect.
8460 #
8461 #
8462 # Only one of defaultUrlRedirect, defaultService
8463 # or defaultRouteAction.weightedBackendService can be set.
8464 #
8465 #
8466 # Not supported when the URL map is bound to a target gRPC proxy.
8467 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
8468 # was supplied in the request.
8469 #
8470 # The value must be from 1 to 255
8471 # characters.
8472 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
8473 # set to HTTPS.
8474 # If set to false, the URL scheme of the redirected request
8475 # remains the same as that of the request.
8476 #
8477 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
8478 #
8479 # The default is set to false.
8480 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
8481 # that was supplied in the request.
8482 #
8483 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
8484 # supplied, the path of the original request is used for the redirect.
8485 #
8486 # The value must be from 1 to 1024 characters.
8487 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
8488 # the HttpRouteRuleMatch, retaining the remaining portion
8489 # of the URL before redirecting the request.
8490 #
8491 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
8492 # supplied, the path of the original request is used for the redirect.
8493 #
8494 # The value must be from 1 to 1024 characters.
8495 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
8496 #
8497 # Supported values are:
8498 #
8499 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
8500 # to 301.
8501 # - FOUND, which corresponds to 302.
8502 # - SEE_OTHER which corresponds to 303.
8503 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
8504 # method is retained.
8505 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
8506 # method is retained.
8507 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
8508 # URL is
8509 # removed before redirecting the request. If set to false, the
8510 # query portion of the original URL is retained.
8511 #
8512 # The default is set to false.
8513 },
8514 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
8515 # create the resource.
8516 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. A hash of the contents stored in this object.
8517 # This field is used in optimistic locking. This field is ignored when
8518 # inserting a UrlMap. An up-to-date fingerprint must be provided
8519 # in order to update the UrlMap, otherwise the request will
8520 # fail with error 412 conditionNotMet.
8521 #
8522 # To see the latest fingerprint, make a get() request to
8523 # retrieve a UrlMap.
8524 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
8525 # for the selected backendService.
8526 #
8527 # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
8528 #
8529 # headerAction is not supported for load balancers
8530 # that have
8531 # their loadBalancingScheme set to EXTERNAL.
8532 #
8533 # Not supported when the URL map is bound to a target gRPC proxy that
8534 # has validateForProxyless field set to true.
8535 # the request is passed along to the selected backendService.
8536 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
8537 { # Specification determining how headers are added to requests or responses.
8538 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
8539 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
8540 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
8541 # that already
8542 # exist for the header. If true, headerValue is set for the
8543 # header, discarding any values that were set for that header.
8544 #
8545 # The default value is true,
8546 # unless a variable is present in headerValue,
8547 # in which case the default value is false.
8548 # .
8549 },
8550 ],
8551 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
8552 # request before forwarding the request to the backendService.
8553 &quot;A String&quot;,
8554 ],
8555 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
8556 # client.
8557 { # Specification determining how headers are added to requests or responses.
8558 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
8559 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
8560 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
8561 # that already
8562 # exist for the header. If true, headerValue is set for the
8563 # header, discarding any values that were set for that header.
8564 #
8565 # The default value is true,
8566 # unless a variable is present in headerValue,
8567 # in which case the default value is false.
8568 # .
8569 },
8570 ],
8571 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
8572 # response before sending the response back to the client.
8573 &quot;A String&quot;,
8574 ],
8575 },
8576 &quot;hostRules&quot;: [ # The list of host rules to use against the URL.
8577 { # UrlMaps
8578 # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
8579 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
8580 # create the resource.
8581 &quot;hosts&quot;: [ # The list of host patterns to match. They must be valid hostnames with
8582 # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
8583 # that case, * must be the first character, and if followed by
8584 # anything, the immediate following character must be either -
8585 # or ..
8586 #
8587 # * based matching is not supported when the URL map is bound
8588 # to a target gRPC proxy that has the validateForProxyless field
8589 # set to true.
8590 &quot;A String&quot;,
8591 ],
8592 &quot;pathMatcher&quot;: &quot;A String&quot;, # The name of the PathMatcher to use to match the path portion
8593 # of the URL if the hostRule matches the URL&#x27;s host portion.
8594 },
8595 ],
8596 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the resource. This identifier is
8597 # defined by the server.
8598 &quot;kind&quot;: &quot;compute#urlMap&quot;, # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
8599 # url maps.
8600 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
8601 # The name must be 1-63 characters long, and comply withRFC1035.
8602 # Specifically, the name must be 1-63 characters long and match the regular
8603 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
8604 # character must be a lowercase letter, and all following characters must
8605 # be a dash, lowercase letter, or digit, except the last character, which
8606 # cannot be a dash.
8607 &quot;pathMatchers&quot;: [ # The list of named PathMatchers to use against the URL.
8608 { # A matcher for the path portion of the URL. The BackendService
8609 # from the longest-matched rule will serve the URL. If no rule was matched, the
8610 # default service is used.
8611 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
8612 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
8613 #
8614 # This policy takes
8615 # effect at the PathMatcher level and applies only when no
8616 # policy has been defined for the error code at lower levels likeRouteRule and PathRule within thisPathMatcher. If an error code does not have a policy defined
8617 # in defaultCustomErrorResponsePolicy, then a policy defined for
8618 # the error code in UrlMap.defaultCustomErrorResponsePolicy
8619 # takes effect.
8620 #
8621 # For example, consider a UrlMap with the following
8622 # configuration:
8623 #
8624 #
8625 # - UrlMap.defaultCustomErrorResponsePolicy is configured
8626 # with policies for 5xx and 4xx errors
8627 # - A RouteRule for /coming_soon/ is configured for the
8628 # error code 404.
8629 #
8630 # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher&#x27;s policy
8631 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
8632 # the policy in RouteRule.customErrorResponsePolicy takes
8633 # effect. If any of the requests in this example encounter a 500
8634 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
8635 #
8636 # When
8637 # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
8638 # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
8639 # a retry, if load balancer is successful in reaching the
8640 # service, the defaultCustomErrorResponsePolicy is ignored and
8641 # the response from the service is returned to the client.
8642 #
8643 # defaultCustomErrorResponsePolicy is supported only for
8644 # global external Application Load Balancers.
8645 # backend service or backend bucket responds with an error.
8646 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
8647 #
8648 # In a given policy, if you specify rules for both a range of error codes
8649 # as well as rules for specific error codes then rules with specific error
8650 # codes have a higher priority. For example, assume that you configure a rule
8651 # for 401 (Un-authorized) code, and another for all 4 series
8652 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
8653 # However if the backend service returns a 403, the rule for4xx takes effect.
8654 { # Specifies the mapping between the response code that will be returned along
8655 # with the custom error content and the response code returned by the backend
8656 # service.
8657 &quot;matchResponseCodes&quot;: [ # Valid values include:
8658 #
8659 #
8660 # - A number between 400 and 599: For example
8661 # 401 or 503, in which case the load balancer
8662 # applies the policy if the error code exactly matches this value.
8663 # - 5xx: Load Balancer will apply the policy if the
8664 # backend service responds with any response code in the range of
8665 # 500 to 599.
8666 # - 4xx: Load
8667 # Balancer will apply the policy if the backend service responds with any
8668 # response code in the range of 400 to
8669 # 499.
8670 #
8671 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
8672 &quot;A String&quot;,
8673 ],
8674 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
8675 # error content. If overrideResponseCode is not supplied, the
8676 # same response code returned by the original backend bucket or backend
8677 # service is returned to the client.
8678 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
8679 #
8680 # path must start
8681 # with a leading slash. path cannot have trailing slashes.
8682 #
8683 # If the file is not available in backendBucket or the
8684 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
8685 #
8686 # The value must
8687 # be from 1 to 1024 characters
8688 },
8689 ],
8690 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
8691 # contains the custom error content. Examples are:
8692 #
8693 #
8694 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
8695 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
8696 # - global/backendBuckets/myBackendBucket
8697 #
8698 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
8699 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
8700 #
8701 # If load balancer cannot reach
8702 # the backendBucket, a simple Not Found Error will
8703 # be returned, with the original response code (oroverrideResponseCode if configured).
8704 #
8705 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
8706 },
8707 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
8708 # pathRules or routeRules match. The load balancer
8709 # performs advanced routing actions, such as URL rewrites and
8710 # header transformations, before forwarding the request to the
8711 # selected backend.
8712 #
8713 #
8714 # Only one of defaultUrlRedirect, defaultService
8715 # or defaultRouteAction.weightedBackendService can be set.
8716 #
8717 #
8718 # URL maps for classic Application Load Balancers only support
8719 # the urlRewrite action within a path matcher&#x27;sdefaultRouteAction.
8720 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
8721 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
8722 # property must be specified. This policy cannot be specified if any target
8723 # backend has Identity-Aware Proxy enabled.
8724 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
8725 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
8726 # header names can be specified. The cache is bypassed for all `cacheMode`
8727 # values.
8728 &quot;A String&quot;,
8729 ],
8730 &quot;cacheKeyPolicy&quot;: { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
8731 # on the backend type: for Backend Services, the complete request URI is
8732 # used; for Backend Buckets, the request URI is used without the protocol or
8733 # host, and only query parameters known to Cloud Storage are included.
8734 # Policy defined on Route Action.
8735 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
8736 # parameters will be included. Either specify `excludedQueryParameters`
8737 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
8738 # encoded and not treated as delimiters.
8739 #
8740 # Note: This field applies to routes that use backend services. Attempting
8741 # to set it on a route that points exclusively to Backend Buckets will
8742 # result in a configuration error. For routes that point to a Backend
8743 # Bucket, use `includedQueryParameters` to define which parameters should
8744 # be part of the cache key.
8745 &quot;A String&quot;,
8746 ],
8747 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
8748 #
8749 # Note: This setting is only applicable to routes that use a Backend
8750 # Service. It does not affect requests served by a Backend Bucket, as the
8751 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
8752 # it on a route that points exclusively to Backend Buckets will result in a
8753 # configuration error.
8754 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
8755 #
8756 # Note: This setting is only applicable to routes that use a Backend
8757 # Service. It does not affect requests served by a Backend Bucket, as the
8758 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
8759 # set on a route that points exclusively to Backend Buckets will result in
8760 # a configuration error.
8761 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
8762 # `includedQueryParameters` and `excludedQueryParameters`. If neither
8763 # is set, the entire query string will be included. If false, the query
8764 # string will be excluded from the cache key entirely.
8765 #
8766 # Note: This field applies to routes that use backend services. Attempting
8767 # to set it on a route that points exclusively to Backend Buckets will
8768 # result in a configuration error. For routes that point to a Backend
8769 # Bucket, use `includedQueryParameters` to define which parameters should
8770 # be part of the cache key.
8771 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
8772 # The name=value pair will be used in the cache key Cloud CDN generates.
8773 #
8774 # Note: This setting is only applicable to routes that use a Backend
8775 # Service. It does not affect requests served by a Backend Bucket.
8776 # Attempting to set it on a route that points exclusively to Backend
8777 # Buckets will result in a configuration error. Up to 5 cookie names can be
8778 # specified.
8779 &quot;A String&quot;,
8780 ],
8781 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
8782 &quot;A String&quot;,
8783 ],
8784 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
8785 # parameters will be excluded. Either specify `includedQueryParameters`
8786 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
8787 # encoded and not treated as delimiters.
8788 &quot;A String&quot;,
8789 ],
8790 },
8791 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
8792 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
8793 &quot;clientTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
8794 # content. This is used to clamp the max-age (or Expires) value sent to the
8795 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
8796 # is used for the response max-age directive, along with a &quot;public&quot;
8797 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
8798 # clamps the max-age from the origin (if specified), or else sets the
8799 # response max-age directive to the lesser of the `clientTtl` and
8800 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
8801 # present. The maximum allowed value is 31,622,400s (1 year). If not
8802 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
8803 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
8804 # `USE_ORIGIN_HEADERS`.
8805 # as a count of seconds and fractions of seconds at nanosecond
8806 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8807 # or &quot;month&quot;. Range is approximately 10,000 years.
8808 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8809 # Durations less than one second are represented with a 0
8810 # `seconds` field and a positive `nanos` field. Must be from 0
8811 # to 999,999,999 inclusive.
8812 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8813 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8814 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8815 },
8816 &quot;defaultTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
8817 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
8818 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
8819 # greater than that of `maxTtl`. When the `cacheMode` is set to
8820 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
8821 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
8822 # accessed objects may be evicted from the cache before the defined TTL. If
8823 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
8824 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
8825 # `USE_ORIGIN_HEADERS`.
8826 # as a count of seconds and fractions of seconds at nanosecond
8827 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8828 # or &quot;month&quot;. Range is approximately 10,000 years.
8829 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8830 # Durations less than one second are represented with a 0
8831 # `seconds` field and a positive `nanos` field. Must be from 0
8832 # to 999,999,999 inclusive.
8833 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8834 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8835 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8836 },
8837 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
8838 # attempt to set a max-age or s-maxage higher than this, or an Expires header
8839 # more than `maxTtl` seconds in the future will be capped at the value of
8840 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
8841 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
8842 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
8843 # Infrequently accessed objects may be evicted from the cache before the
8844 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
8845 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
8846 # mode.
8847 # as a count of seconds and fractions of seconds at nanosecond
8848 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8849 # or &quot;month&quot;. Range is approximately 10,000 years.
8850 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8851 # Durations less than one second are represented with a 0
8852 # `seconds` field and a positive `nanos` field. Must be from 0
8853 # to 999,999,999 inclusive.
8854 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8855 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8856 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8857 },
8858 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
8859 # to apply fine-grained caching for common errors or redirects.
8860 # This can reduce the load on your origin and improve end-user
8861 # experience by reducing response latency.
8862 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
8863 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
8864 # the specified response code that lack any Cache-Control, Expires, or
8865 # Pragma: no-cache directives. When the `cacheMode` is set to
8866 # `FORCE_CACHE_ALL`, negative caching applies to all responses
8867 # with the specified response code, and overrides any caching headers. By
8868 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
8869 #
8870 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
8871 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
8872 # * 405 (Method Not Found), 501 (Not Implemented): 60s
8873 #
8874 # These defaults can be overridden in `negativeCachingPolicy`.
8875 # If not specified, Cloud CDN applies negative caching by default.
8876 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
8877 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
8878 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
8879 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
8880 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
8881 # all response codes that you wish to cache. Cloud CDN will not apply any
8882 # default negative caching when a policy exists.
8883 { # Specify CDN TTLs for response error codes.
8884 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
8885 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
8886 # specified as values, and you cannot specify a status code more than
8887 # once.
8888 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
8889 # corresponding status code.
8890 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
8891 # objects may be evicted from the cache before the defined TTL.
8892 # as a count of seconds and fractions of seconds at nanosecond
8893 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8894 # or &quot;month&quot;. Range is approximately 10,000 years.
8895 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8896 # Durations less than one second are represented with a 0
8897 # `seconds` field and a positive `nanos` field. Must be from 0
8898 # to 999,999,999 inclusive.
8899 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8900 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8901 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8902 },
8903 },
8904 ],
8905 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
8906 # requests into a small number of requests to the origin. If not specified,
8907 # Cloud CDN applies request coalescing by default.
8908 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
8909 # content with the origin, or when an error is encountered when refreshing
8910 # the cache.
8911 # This setting defines the default &quot;max-stale&quot; duration for any cached
8912 # responses that do not specify a max-stale directive. Stale responses that
8913 # exceed the TTL configured here will not be served. The default limit
8914 # (max-stale) is 86400s (1 day), which will allow stale content to be
8915 # served up to this limit beyond the max-age (or s-maxage) of a cached
8916 # response.
8917 # The maximum allowed value is 604800 (1 week).
8918 # Set this to zero (0) to disable serve-while-stale.
8919 # as a count of seconds and fractions of seconds at nanosecond
8920 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8921 # or &quot;month&quot;. Range is approximately 10,000 years.
8922 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8923 # Durations less than one second are represented with a 0
8924 # `seconds` field and a positive `nanos` field. Must be from 0
8925 # to 999,999,999 inclusive.
8926 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8927 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8928 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8929 },
8930 },
8931 &quot;corsPolicy&quot;: { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
8932 # information about the W3C recommendation for cross-origin resource sharing
8933 # (CORS), see Fetch API Living
8934 # Standard.
8935 #
8936 # Not supported when the URL map is bound to a target gRPC proxy.
8937 # information about the W3C recommendation for cross-origin resource sharing
8938 # (CORS), see Fetch API Living
8939 # Standard.
8940 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
8941 # indicates that
8942 # the actual request can include user credentials. This field translates to
8943 # the Access-Control-Allow-Credentials header.
8944 #
8945 # Default is false.
8946 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
8947 # header.
8948 &quot;A String&quot;,
8949 ],
8950 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
8951 # header.
8952 &quot;A String&quot;,
8953 ],
8954 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
8955 # more information, see regular expression syntax.
8956 #
8957 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
8958 #
8959 # Regular expressions can only be used when the loadBalancingScheme is
8960 # set to INTERNAL_SELF_MANAGED.
8961 &quot;A String&quot;,
8962 ],
8963 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
8964 #
8965 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
8966 &quot;A String&quot;,
8967 ],
8968 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
8969 # The default value is false, which indicates that the CORS
8970 # policy is in effect.
8971 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
8972 # header.
8973 &quot;A String&quot;,
8974 ],
8975 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
8976 # seconds. This field translates to the Access-Control-Max-Age
8977 # header.
8978 },
8979 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
8980 # the resiliency of clients to backend service failure. As part of fault
8981 # injection, when clients send requests to a backend service, delays can be
8982 # introduced by a load balancer on a percentage of requests before sending
8983 # those requests to the backend service. Similarly requests from clients can
8984 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
8985 # that are configured with a fault_injection_policy if:
8986 # 1. The traffic is generated by fault injection AND
8987 # 2. The fault injection is not a delay fault injection.
8988 # Fault injection is not supported with the classic Application Load Balancer
8989 # . To see which load balancers support fault injection,
8990 # see Load
8991 # balancing: Routing and traffic management features.
8992 # the resiliency of clients to backend service failure. As part of fault
8993 # injection, when clients send requests to a backend service, delays can be
8994 # introduced by the load balancer on a percentage of requests before sending
8995 # those request to the backend service. Similarly requests from clients can be
8996 # aborted by the load balancer for a percentage of requests.
8997 &quot;abort&quot;: { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
8998 # injection.
8999 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
9000 #
9001 # The value must be from 200 to 599 inclusive.
9002 #
9003 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
9004 # according to this
9005 # mapping table. HTTP status 200 is mapped to gRPC status
9006 # UNKNOWN. Injecting an OK status is currently not supported by
9007 # Traffic Director.
9008 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
9009 # that is aborted as part of fault injection.
9010 #
9011 # The value must be from 0.0 to 100.0 inclusive.
9012 },
9013 &quot;delay&quot;: { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
9014 # injection, before being sent to a backend service.
9015 # request to the backend service as part of fault injection.
9016 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
9017 # as a count of seconds and fractions of seconds at nanosecond
9018 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9019 # or &quot;month&quot;. Range is approximately 10,000 years.
9020 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9021 # Durations less than one second are represented with a 0
9022 # `seconds` field and a positive `nanos` field. Must be from 0
9023 # to 999,999,999 inclusive.
9024 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9025 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9026 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9027 },
9028 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
9029 # which a delay is introduced as part of fault injection.
9030 #
9031 # The value must be from 0.0 to 100.0 inclusive.
9032 },
9033 },
9034 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
9035 # Unlike the timeout field where the timeout duration starts
9036 # from the time the request has been fully processed (known as*end-of-stream*),
9037 # the duration in this field is computed from the beginning of the stream
9038 # until the response has been processed, including all retries. A
9039 # stream that does not complete in this duration is closed.
9040 #
9041 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
9042 # with the route.
9043 #
9044 # This field is only allowed if the Url map is used with backend services
9045 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
9046 # as a count of seconds and fractions of seconds at nanosecond
9047 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9048 # or &quot;month&quot;. Range is approximately 10,000 years.
9049 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9050 # Durations less than one second are represented with a 0
9051 # `seconds` field and a positive `nanos` field. Must be from 0
9052 # to 999,999,999 inclusive.
9053 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9054 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9055 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9056 },
9057 &quot;requestMirrorPolicy&quot;: { # A policy that specifies how requests intended for the route&#x27;s backends # Specifies the policy on how requests intended for the route&#x27;s backends
9058 # are shadowed to a separate mirrored backend service. The load balancer does
9059 # not wait for responses from the shadow service. Before sending traffic
9060 # to the shadow service, the host / authority header is suffixed with-shadow.
9061 #
9062 # Not supported when the URL map is bound to a target gRPC proxy that
9063 # has the validateForProxyless field set to true.
9064 # are shadowed to a separate mirrored backend service. The load balancer
9065 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
9066 # to the shadow service, the host or authority header is suffixed with-shadow.
9067 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
9068 # mirrored to.
9069 #
9070 # The backend service configured for a mirroring
9071 # policy must reference backends that are of the same type as the original
9072 # backend service matched in the URL map.
9073 #
9074 # Serverless NEG backends are not currently supported as a mirrored
9075 # backend service.
9076 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
9077 },
9078 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
9079 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
9080 # If not specified, defaults to 1.
9081 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
9082 #
9083 # If not specified, will use the timeout set in theHttpRouteAction field.
9084 # If timeout in the HttpRouteAction field is not set, this field
9085 # uses the largest timeout
9086 # among all backend services associated with the route.
9087 #
9088 # Not supported when the URL map is bound to a target gRPC proxy that
9089 # has the validateForProxyless field set to true.
9090 # as a count of seconds and fractions of seconds at nanosecond
9091 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9092 # or &quot;month&quot;. Range is approximately 10,000 years.
9093 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9094 # Durations less than one second are represented with a 0
9095 # `seconds` field and a positive `nanos` field. Must be from 0
9096 # to 999,999,999 inclusive.
9097 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9098 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9099 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9100 },
9101 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
9102 # values are:
9103 #
9104 # - 5xx: retry is attempted if the instance or endpoint
9105 # responds with any 5xx response code, or if the instance or
9106 # endpoint does not respond at all. For example, disconnects, reset, read
9107 # timeout, connection failure, and refused streams.
9108 # - gateway-error: Similar to 5xx, but only
9109 # applies to response codes 502, 503 or504.
9110 # - connect-failure: a retry is attempted on failures
9111 # connecting to the instance or endpoint. For example, connection
9112 # timeouts.
9113 # - retriable-4xx: a retry is attempted if the instance
9114 # or endpoint responds with a 4xx response code.
9115 # The only error that you can retry is error code 409.
9116 # - refused-stream: a retry is attempted if the instance
9117 # or endpoint resets the stream with a REFUSED_STREAM error
9118 # code. This reset type indicates that it is safe to retry.
9119 # - cancelled: a retry is attempted if the gRPC status
9120 # code in the response header is set to cancelled.
9121 # - deadline-exceeded: a retry is attempted if the gRPC
9122 # status code in the response header is set todeadline-exceeded.
9123 # - internal: a retry is attempted if the gRPC
9124 # status code in the response header is set tointernal.
9125 # - resource-exhausted: a retry is attempted if the gRPC
9126 # status code in the response header is set toresource-exhausted.
9127 # - unavailable: a retry is attempted if the gRPC
9128 # status code in the response header is set tounavailable.
9129 #
9130 # Only the following codes are supported when the URL map is bound to
9131 # target gRPC proxy that has validateForProxyless field set to true.
9132 #
9133 # - cancelled
9134 # - deadline-exceeded
9135 # - internal
9136 # - resource-exhausted
9137 # - unavailable
9138 &quot;A String&quot;,
9139 ],
9140 },
9141 &quot;timeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
9142 # time the request has been fully processed (known as *end-of-stream*)
9143 # up until the response has been processed. Timeout includes
9144 # all retries.
9145 #
9146 # If not specified, this field uses the largest timeout among all backend
9147 # services associated with the route.
9148 #
9149 # Not supported when the URL map is bound to a target gRPC proxy that
9150 # has validateForProxyless field set to true.
9151 # as a count of seconds and fractions of seconds at nanosecond
9152 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9153 # or &quot;month&quot;. Range is approximately 10,000 years.
9154 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9155 # Durations less than one second are represented with a 0
9156 # `seconds` field and a positive `nanos` field. Must be from 0
9157 # to 999,999,999 inclusive.
9158 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9159 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9160 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9161 },
9162 &quot;urlRewrite&quot;: { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
9163 # to the matched service.
9164 #
9165 # urlRewrite is the only action supported in UrlMaps
9166 # for classic Application Load Balancers.
9167 #
9168 # Not supported when the URL map is bound to a target gRPC proxy that
9169 # has the validateForProxyless field set to true.
9170 # backend service.
9171 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
9172 # host header is replaced with contents of hostRewrite.
9173 #
9174 # The value must be from 1 to 255 characters.
9175 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
9176 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
9177 #
9178 # The value must be from 1 to 1024 characters.
9179 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
9180 # header) using the HTTP template syntax.
9181 #
9182 # A corresponding
9183 # path_template_match must be specified. Any template variables must exist in
9184 # the path_template_match field.
9185 #
9186 #
9187 # - -At least one variable must be specified in the path_template_match
9188 # field
9189 # - You can omit variables from the rewritten URL
9190 # - The * and ** operators cannot be matched
9191 # unless they have a corresponding variable name - e.g.
9192 # {format=*} or {var=**}.
9193 #
9194 # For example, a path_template_match of /static/{format=**}
9195 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
9196 # rewrite, so that /{country}/{format}/{suffix=**} can be
9197 # rewritten as /content/{format}/{country}/{suffix}.
9198 #
9199 # At least
9200 # one non-empty routeRules[].matchRules[].path_template_match is
9201 # required.
9202 #
9203 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
9204 },
9205 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
9206 # occurs. The weights determine the fraction of traffic that flows to
9207 # their corresponding backend service. If all traffic needs to
9208 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
9209 #
9210 # After a backend service is identified and before forwarding
9211 # the request to
9212 # the backend service, advanced routing actions such as URL rewrites and
9213 # header transformations are applied depending on additional settings
9214 # specified in this HttpRouteAction.
9215 { # In contrast to a single BackendService in
9216 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
9217 # multiple backend services. The volume of traffic for each
9218 # backend service is proportional to the weight specified
9219 # in each WeightedBackendService
9220 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
9221 # resource. Before
9222 # forwarding the request to backendService, the load balancer
9223 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
9224 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
9225 # effect for the selected backendService.
9226 #
9227 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
9228 #
9229 # headerAction is not supported for load balancers that have
9230 # their loadBalancingScheme set to EXTERNAL.
9231 #
9232 # Not supported when the URL map is bound to a target gRPC proxy that
9233 # has validateForProxyless field set to true.
9234 # the request is passed along to the selected backendService.
9235 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
9236 { # Specification determining how headers are added to requests or responses.
9237 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
9238 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
9239 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
9240 # that already
9241 # exist for the header. If true, headerValue is set for the
9242 # header, discarding any values that were set for that header.
9243 #
9244 # The default value is true,
9245 # unless a variable is present in headerValue,
9246 # in which case the default value is false.
9247 # .
9248 },
9249 ],
9250 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
9251 # request before forwarding the request to the backendService.
9252 &quot;A String&quot;,
9253 ],
9254 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
9255 # client.
9256 { # Specification determining how headers are added to requests or responses.
9257 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
9258 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
9259 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
9260 # that already
9261 # exist for the header. If true, headerValue is set for the
9262 # header, discarding any values that were set for that header.
9263 #
9264 # The default value is true,
9265 # unless a variable is present in headerValue,
9266 # in which case the default value is false.
9267 # .
9268 },
9269 ],
9270 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
9271 # response before sending the response back to the client.
9272 &quot;A String&quot;,
9273 ],
9274 },
9275 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
9276 # computed asweight / (sum of all weightedBackendService weights in routeAction).
9277 #
9278 # The selection of a backend service is determined only for new traffic.
9279 # Once a user&#x27;s request has been directed to a backend service,
9280 # subsequent requests are sent to the same backend service as
9281 # determined by the backend service&#x27;s session affinity policy.
9282 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
9283 # splitting. If you do, the weighted traffic splitting configuration takes
9284 # precedence.
9285 #
9286 # The value must be from 0 to 1000.
9287 },
9288 ],
9289 },
9290 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource. This
9291 # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
9292 # matched. For example, the
9293 # following are all valid URLs to a BackendService resource:
9294 #
9295 #
9296 # - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
9297 # - compute/v1/projects/project/global/backendServices/backendService
9298 # - global/backendServices/backendService
9299 #
9300 #
9301 # If defaultRouteAction is also specified, advanced
9302 # routing actions, such as URL rewrites, take effect before sending the
9303 # request to the backend.
9304 #
9305 #
9306 # Only one of defaultUrlRedirect, defaultService
9307 # or defaultRouteAction.weightedBackendService can be set.
9308 #
9309 #
9310 # Authorization requires one or more of the following Google IAM permissions on the
9311 # specified resource default_service:
9312 #
9313 #
9314 # - compute.backendBuckets.use
9315 # - compute.backendServices.use
9316 &quot;defaultUrlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When none of the specified pathRules orrouteRules match, the request is redirected to a URL specified
9317 # by defaultUrlRedirect.
9318 #
9319 #
9320 # Only one of defaultUrlRedirect, defaultService
9321 # or defaultRouteAction.weightedBackendService can be set.
9322 #
9323 #
9324 # Not supported when the URL map is bound to a target gRPC proxy.
9325 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
9326 # was supplied in the request.
9327 #
9328 # The value must be from 1 to 255
9329 # characters.
9330 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
9331 # set to HTTPS.
9332 # If set to false, the URL scheme of the redirected request
9333 # remains the same as that of the request.
9334 #
9335 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
9336 #
9337 # The default is set to false.
9338 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
9339 # that was supplied in the request.
9340 #
9341 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
9342 # supplied, the path of the original request is used for the redirect.
9343 #
9344 # The value must be from 1 to 1024 characters.
9345 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
9346 # the HttpRouteRuleMatch, retaining the remaining portion
9347 # of the URL before redirecting the request.
9348 #
9349 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
9350 # supplied, the path of the original request is used for the redirect.
9351 #
9352 # The value must be from 1 to 1024 characters.
9353 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
9354 #
9355 # Supported values are:
9356 #
9357 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
9358 # to 301.
9359 # - FOUND, which corresponds to 302.
9360 # - SEE_OTHER which corresponds to 303.
9361 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
9362 # method is retained.
9363 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
9364 # method is retained.
9365 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
9366 # URL is
9367 # removed before redirecting the request. If set to false, the
9368 # query portion of the original URL is retained.
9369 #
9370 # The default is set to false.
9371 },
9372 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
9373 # create the resource.
9374 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
9375 # for the selected backend service.
9376 #
9377 # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
9378 #
9379 # HeaderAction is not supported for load balancers
9380 # that have
9381 # their loadBalancingScheme set to EXTERNAL.
9382 #
9383 # Not supported when the URL map is bound to a target gRPC proxy that
9384 # has validateForProxyless field set to true.
9385 # the request is passed along to the selected backendService.
9386 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
9387 { # Specification determining how headers are added to requests or responses.
9388 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
9389 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
9390 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
9391 # that already
9392 # exist for the header. If true, headerValue is set for the
9393 # header, discarding any values that were set for that header.
9394 #
9395 # The default value is true,
9396 # unless a variable is present in headerValue,
9397 # in which case the default value is false.
9398 # .
9399 },
9400 ],
9401 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
9402 # request before forwarding the request to the backendService.
9403 &quot;A String&quot;,
9404 ],
9405 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
9406 # client.
9407 { # Specification determining how headers are added to requests or responses.
9408 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
9409 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
9410 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
9411 # that already
9412 # exist for the header. If true, headerValue is set for the
9413 # header, discarding any values that were set for that header.
9414 #
9415 # The default value is true,
9416 # unless a variable is present in headerValue,
9417 # in which case the default value is false.
9418 # .
9419 },
9420 ],
9421 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
9422 # response before sending the response back to the client.
9423 &quot;A String&quot;,
9424 ],
9425 },
9426 &quot;name&quot;: &quot;A String&quot;, # The name to which this PathMatcher is referred by theHostRule.
9427 &quot;pathRules&quot;: [ # The list of path rules. Use this list instead of routeRules
9428 # when routing based on simple path matching is all that&#x27;s required. A path
9429 # rule can only include a wildcard character (*) after a
9430 # forward slash character (&quot;/&quot;).
9431 #
9432 # The order by which path rules are specified does not matter.
9433 # Matches are always done on the longest-path-first basis.
9434 #
9435 # For example: a pathRule with a path /a/b/c/* will match
9436 # before /a/b/* irrespective of the order in which those paths appear in this
9437 # list.
9438 #
9439 # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
9440 { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
9441 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
9442 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
9443 #
9444 # If a policy for an
9445 # error code is not configured for the PathRule, a policy for
9446 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
9447 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
9448 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
9449 # effect.
9450 #
9451 # For example, consider a UrlMap with the following configuration:
9452 #
9453 #
9454 # - UrlMap.defaultCustomErrorResponsePolicy are configured
9455 # with policies for 5xx and 4xx errors
9456 # - A PathRule for /coming_soon/ is configured for the error
9457 # code 404.
9458 #
9459 # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher&#x27;s policy
9460 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
9461 # the policy in PathRule.customErrorResponsePolicy takes
9462 # effect. If any of the requests in this example encounter a 500
9463 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
9464 #
9465 # customErrorResponsePolicy is supported only for
9466 # global external Application Load Balancers.
9467 # backend service or backend bucket responds with an error.
9468 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
9469 #
9470 # In a given policy, if you specify rules for both a range of error codes
9471 # as well as rules for specific error codes then rules with specific error
9472 # codes have a higher priority. For example, assume that you configure a rule
9473 # for 401 (Un-authorized) code, and another for all 4 series
9474 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
9475 # However if the backend service returns a 403, the rule for4xx takes effect.
9476 { # Specifies the mapping between the response code that will be returned along
9477 # with the custom error content and the response code returned by the backend
9478 # service.
9479 &quot;matchResponseCodes&quot;: [ # Valid values include:
9480 #
9481 #
9482 # - A number between 400 and 599: For example
9483 # 401 or 503, in which case the load balancer
9484 # applies the policy if the error code exactly matches this value.
9485 # - 5xx: Load Balancer will apply the policy if the
9486 # backend service responds with any response code in the range of
9487 # 500 to 599.
9488 # - 4xx: Load
9489 # Balancer will apply the policy if the backend service responds with any
9490 # response code in the range of 400 to
9491 # 499.
9492 #
9493 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
9494 &quot;A String&quot;,
9495 ],
9496 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
9497 # error content. If overrideResponseCode is not supplied, the
9498 # same response code returned by the original backend bucket or backend
9499 # service is returned to the client.
9500 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
9501 #
9502 # path must start
9503 # with a leading slash. path cannot have trailing slashes.
9504 #
9505 # If the file is not available in backendBucket or the
9506 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
9507 #
9508 # The value must
9509 # be from 1 to 1024 characters
9510 },
9511 ],
9512 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
9513 # contains the custom error content. Examples are:
9514 #
9515 #
9516 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
9517 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
9518 # - global/backendBuckets/myBackendBucket
9519 #
9520 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
9521 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
9522 #
9523 # If load balancer cannot reach
9524 # the backendBucket, a simple Not Found Error will
9525 # be returned, with the original response code (oroverrideResponseCode if configured).
9526 #
9527 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
9528 },
9529 &quot;paths&quot;: [ # The list of path patterns to match. Each must start with /
9530 # and the only place a * is allowed is at the end following
9531 # a /. The string fed to the path matcher does not include
9532 # any text after the first ? or #, and
9533 # those chars are not allowed here.
9534 &quot;A String&quot;,
9535 ],
9536 &quot;routeAction&quot;: { # In response to a matching path, the load balancer
9537 # performs advanced routing actions, such as URL rewrites and header
9538 # transformations, before forwarding the request to the selected
9539 # backend.
9540 #
9541 #
9542 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
9543 #
9544 #
9545 # URL maps for classic Application Load Balancers only support
9546 # the urlRewrite action within a path rule&#x27;srouteAction.
9547 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
9548 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
9549 # property must be specified. This policy cannot be specified if any target
9550 # backend has Identity-Aware Proxy enabled.
9551 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
9552 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
9553 # header names can be specified. The cache is bypassed for all `cacheMode`
9554 # values.
9555 &quot;A String&quot;,
9556 ],
9557 &quot;cacheKeyPolicy&quot;: { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
9558 # on the backend type: for Backend Services, the complete request URI is
9559 # used; for Backend Buckets, the request URI is used without the protocol or
9560 # host, and only query parameters known to Cloud Storage are included.
9561 # Policy defined on Route Action.
9562 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
9563 # parameters will be included. Either specify `excludedQueryParameters`
9564 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
9565 # encoded and not treated as delimiters.
9566 #
9567 # Note: This field applies to routes that use backend services. Attempting
9568 # to set it on a route that points exclusively to Backend Buckets will
9569 # result in a configuration error. For routes that point to a Backend
9570 # Bucket, use `includedQueryParameters` to define which parameters should
9571 # be part of the cache key.
9572 &quot;A String&quot;,
9573 ],
9574 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
9575 #
9576 # Note: This setting is only applicable to routes that use a Backend
9577 # Service. It does not affect requests served by a Backend Bucket, as the
9578 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
9579 # it on a route that points exclusively to Backend Buckets will result in a
9580 # configuration error.
9581 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
9582 #
9583 # Note: This setting is only applicable to routes that use a Backend
9584 # Service. It does not affect requests served by a Backend Bucket, as the
9585 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
9586 # set on a route that points exclusively to Backend Buckets will result in
9587 # a configuration error.
9588 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
9589 # `includedQueryParameters` and `excludedQueryParameters`. If neither
9590 # is set, the entire query string will be included. If false, the query
9591 # string will be excluded from the cache key entirely.
9592 #
9593 # Note: This field applies to routes that use backend services. Attempting
9594 # to set it on a route that points exclusively to Backend Buckets will
9595 # result in a configuration error. For routes that point to a Backend
9596 # Bucket, use `includedQueryParameters` to define which parameters should
9597 # be part of the cache key.
9598 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
9599 # The name=value pair will be used in the cache key Cloud CDN generates.
9600 #
9601 # Note: This setting is only applicable to routes that use a Backend
9602 # Service. It does not affect requests served by a Backend Bucket.
9603 # Attempting to set it on a route that points exclusively to Backend
9604 # Buckets will result in a configuration error. Up to 5 cookie names can be
9605 # specified.
9606 &quot;A String&quot;,
9607 ],
9608 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
9609 &quot;A String&quot;,
9610 ],
9611 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
9612 # parameters will be excluded. Either specify `includedQueryParameters`
9613 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
9614 # encoded and not treated as delimiters.
9615 &quot;A String&quot;,
9616 ],
9617 },
9618 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
9619 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
9620 &quot;clientTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
9621 # content. This is used to clamp the max-age (or Expires) value sent to the
9622 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
9623 # is used for the response max-age directive, along with a &quot;public&quot;
9624 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
9625 # clamps the max-age from the origin (if specified), or else sets the
9626 # response max-age directive to the lesser of the `clientTtl` and
9627 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
9628 # present. The maximum allowed value is 31,622,400s (1 year). If not
9629 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
9630 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
9631 # `USE_ORIGIN_HEADERS`.
9632 # as a count of seconds and fractions of seconds at nanosecond
9633 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9634 # or &quot;month&quot;. Range is approximately 10,000 years.
9635 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9636 # Durations less than one second are represented with a 0
9637 # `seconds` field and a positive `nanos` field. Must be from 0
9638 # to 999,999,999 inclusive.
9639 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9640 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9641 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9642 },
9643 &quot;defaultTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
9644 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
9645 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
9646 # greater than that of `maxTtl`. When the `cacheMode` is set to
9647 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
9648 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
9649 # accessed objects may be evicted from the cache before the defined TTL. If
9650 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
9651 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
9652 # `USE_ORIGIN_HEADERS`.
9653 # as a count of seconds and fractions of seconds at nanosecond
9654 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9655 # or &quot;month&quot;. Range is approximately 10,000 years.
9656 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9657 # Durations less than one second are represented with a 0
9658 # `seconds` field and a positive `nanos` field. Must be from 0
9659 # to 999,999,999 inclusive.
9660 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9661 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9662 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9663 },
9664 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
9665 # attempt to set a max-age or s-maxage higher than this, or an Expires header
9666 # more than `maxTtl` seconds in the future will be capped at the value of
9667 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
9668 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
9669 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
9670 # Infrequently accessed objects may be evicted from the cache before the
9671 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
9672 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
9673 # mode.
9674 # as a count of seconds and fractions of seconds at nanosecond
9675 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9676 # or &quot;month&quot;. Range is approximately 10,000 years.
9677 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9678 # Durations less than one second are represented with a 0
9679 # `seconds` field and a positive `nanos` field. Must be from 0
9680 # to 999,999,999 inclusive.
9681 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9682 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9683 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9684 },
9685 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
9686 # to apply fine-grained caching for common errors or redirects.
9687 # This can reduce the load on your origin and improve end-user
9688 # experience by reducing response latency.
9689 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
9690 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
9691 # the specified response code that lack any Cache-Control, Expires, or
9692 # Pragma: no-cache directives. When the `cacheMode` is set to
9693 # `FORCE_CACHE_ALL`, negative caching applies to all responses
9694 # with the specified response code, and overrides any caching headers. By
9695 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
9696 #
9697 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
9698 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
9699 # * 405 (Method Not Found), 501 (Not Implemented): 60s
9700 #
9701 # These defaults can be overridden in `negativeCachingPolicy`.
9702 # If not specified, Cloud CDN applies negative caching by default.
9703 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
9704 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
9705 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
9706 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
9707 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
9708 # all response codes that you wish to cache. Cloud CDN will not apply any
9709 # default negative caching when a policy exists.
9710 { # Specify CDN TTLs for response error codes.
9711 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
9712 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
9713 # specified as values, and you cannot specify a status code more than
9714 # once.
9715 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
9716 # corresponding status code.
9717 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
9718 # objects may be evicted from the cache before the defined TTL.
9719 # as a count of seconds and fractions of seconds at nanosecond
9720 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9721 # or &quot;month&quot;. Range is approximately 10,000 years.
9722 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9723 # Durations less than one second are represented with a 0
9724 # `seconds` field and a positive `nanos` field. Must be from 0
9725 # to 999,999,999 inclusive.
9726 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9727 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9728 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9729 },
9730 },
9731 ],
9732 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
9733 # requests into a small number of requests to the origin. If not specified,
9734 # Cloud CDN applies request coalescing by default.
9735 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
9736 # content with the origin, or when an error is encountered when refreshing
9737 # the cache.
9738 # This setting defines the default &quot;max-stale&quot; duration for any cached
9739 # responses that do not specify a max-stale directive. Stale responses that
9740 # exceed the TTL configured here will not be served. The default limit
9741 # (max-stale) is 86400s (1 day), which will allow stale content to be
9742 # served up to this limit beyond the max-age (or s-maxage) of a cached
9743 # response.
9744 # The maximum allowed value is 604800 (1 week).
9745 # Set this to zero (0) to disable serve-while-stale.
9746 # as a count of seconds and fractions of seconds at nanosecond
9747 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9748 # or &quot;month&quot;. Range is approximately 10,000 years.
9749 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9750 # Durations less than one second are represented with a 0
9751 # `seconds` field and a positive `nanos` field. Must be from 0
9752 # to 999,999,999 inclusive.
9753 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9754 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9755 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9756 },
9757 },
9758 &quot;corsPolicy&quot;: { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
9759 # information about the W3C recommendation for cross-origin resource sharing
9760 # (CORS), see Fetch API Living
9761 # Standard.
9762 #
9763 # Not supported when the URL map is bound to a target gRPC proxy.
9764 # information about the W3C recommendation for cross-origin resource sharing
9765 # (CORS), see Fetch API Living
9766 # Standard.
9767 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
9768 # indicates that
9769 # the actual request can include user credentials. This field translates to
9770 # the Access-Control-Allow-Credentials header.
9771 #
9772 # Default is false.
9773 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
9774 # header.
9775 &quot;A String&quot;,
9776 ],
9777 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
9778 # header.
9779 &quot;A String&quot;,
9780 ],
9781 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
9782 # more information, see regular expression syntax.
9783 #
9784 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
9785 #
9786 # Regular expressions can only be used when the loadBalancingScheme is
9787 # set to INTERNAL_SELF_MANAGED.
9788 &quot;A String&quot;,
9789 ],
9790 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
9791 #
9792 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
9793 &quot;A String&quot;,
9794 ],
9795 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
9796 # The default value is false, which indicates that the CORS
9797 # policy is in effect.
9798 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
9799 # header.
9800 &quot;A String&quot;,
9801 ],
9802 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
9803 # seconds. This field translates to the Access-Control-Max-Age
9804 # header.
9805 },
9806 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
9807 # the resiliency of clients to backend service failure. As part of fault
9808 # injection, when clients send requests to a backend service, delays can be
9809 # introduced by a load balancer on a percentage of requests before sending
9810 # those requests to the backend service. Similarly requests from clients can
9811 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
9812 # that are configured with a fault_injection_policy if:
9813 # 1. The traffic is generated by fault injection AND
9814 # 2. The fault injection is not a delay fault injection.
9815 # Fault injection is not supported with the classic Application Load Balancer
9816 # . To see which load balancers support fault injection,
9817 # see Load
9818 # balancing: Routing and traffic management features.
9819 # the resiliency of clients to backend service failure. As part of fault
9820 # injection, when clients send requests to a backend service, delays can be
9821 # introduced by the load balancer on a percentage of requests before sending
9822 # those request to the backend service. Similarly requests from clients can be
9823 # aborted by the load balancer for a percentage of requests.
9824 &quot;abort&quot;: { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
9825 # injection.
9826 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
9827 #
9828 # The value must be from 200 to 599 inclusive.
9829 #
9830 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
9831 # according to this
9832 # mapping table. HTTP status 200 is mapped to gRPC status
9833 # UNKNOWN. Injecting an OK status is currently not supported by
9834 # Traffic Director.
9835 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
9836 # that is aborted as part of fault injection.
9837 #
9838 # The value must be from 0.0 to 100.0 inclusive.
9839 },
9840 &quot;delay&quot;: { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
9841 # injection, before being sent to a backend service.
9842 # request to the backend service as part of fault injection.
9843 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
9844 # as a count of seconds and fractions of seconds at nanosecond
9845 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9846 # or &quot;month&quot;. Range is approximately 10,000 years.
9847 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9848 # Durations less than one second are represented with a 0
9849 # `seconds` field and a positive `nanos` field. Must be from 0
9850 # to 999,999,999 inclusive.
9851 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9852 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9853 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9854 },
9855 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
9856 # which a delay is introduced as part of fault injection.
9857 #
9858 # The value must be from 0.0 to 100.0 inclusive.
9859 },
9860 },
9861 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
9862 # Unlike the timeout field where the timeout duration starts
9863 # from the time the request has been fully processed (known as*end-of-stream*),
9864 # the duration in this field is computed from the beginning of the stream
9865 # until the response has been processed, including all retries. A
9866 # stream that does not complete in this duration is closed.
9867 #
9868 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
9869 # with the route.
9870 #
9871 # This field is only allowed if the Url map is used with backend services
9872 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
9873 # as a count of seconds and fractions of seconds at nanosecond
9874 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9875 # or &quot;month&quot;. Range is approximately 10,000 years.
9876 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9877 # Durations less than one second are represented with a 0
9878 # `seconds` field and a positive `nanos` field. Must be from 0
9879 # to 999,999,999 inclusive.
9880 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9881 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9882 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9883 },
9884 &quot;requestMirrorPolicy&quot;: { # A policy that specifies how requests intended for the route&#x27;s backends # Specifies the policy on how requests intended for the route&#x27;s backends
9885 # are shadowed to a separate mirrored backend service. The load balancer does
9886 # not wait for responses from the shadow service. Before sending traffic
9887 # to the shadow service, the host / authority header is suffixed with-shadow.
9888 #
9889 # Not supported when the URL map is bound to a target gRPC proxy that
9890 # has the validateForProxyless field set to true.
9891 # are shadowed to a separate mirrored backend service. The load balancer
9892 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
9893 # to the shadow service, the host or authority header is suffixed with-shadow.
9894 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
9895 # mirrored to.
9896 #
9897 # The backend service configured for a mirroring
9898 # policy must reference backends that are of the same type as the original
9899 # backend service matched in the URL map.
9900 #
9901 # Serverless NEG backends are not currently supported as a mirrored
9902 # backend service.
9903 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
9904 },
9905 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
9906 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
9907 # If not specified, defaults to 1.
9908 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
9909 #
9910 # If not specified, will use the timeout set in theHttpRouteAction field.
9911 # If timeout in the HttpRouteAction field is not set, this field
9912 # uses the largest timeout
9913 # among all backend services associated with the route.
9914 #
9915 # Not supported when the URL map is bound to a target gRPC proxy that
9916 # has the validateForProxyless field set to true.
9917 # as a count of seconds and fractions of seconds at nanosecond
9918 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9919 # or &quot;month&quot;. Range is approximately 10,000 years.
9920 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9921 # Durations less than one second are represented with a 0
9922 # `seconds` field and a positive `nanos` field. Must be from 0
9923 # to 999,999,999 inclusive.
9924 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9925 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9926 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9927 },
9928 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
9929 # values are:
9930 #
9931 # - 5xx: retry is attempted if the instance or endpoint
9932 # responds with any 5xx response code, or if the instance or
9933 # endpoint does not respond at all. For example, disconnects, reset, read
9934 # timeout, connection failure, and refused streams.
9935 # - gateway-error: Similar to 5xx, but only
9936 # applies to response codes 502, 503 or504.
9937 # - connect-failure: a retry is attempted on failures
9938 # connecting to the instance or endpoint. For example, connection
9939 # timeouts.
9940 # - retriable-4xx: a retry is attempted if the instance
9941 # or endpoint responds with a 4xx response code.
9942 # The only error that you can retry is error code 409.
9943 # - refused-stream: a retry is attempted if the instance
9944 # or endpoint resets the stream with a REFUSED_STREAM error
9945 # code. This reset type indicates that it is safe to retry.
9946 # - cancelled: a retry is attempted if the gRPC status
9947 # code in the response header is set to cancelled.
9948 # - deadline-exceeded: a retry is attempted if the gRPC
9949 # status code in the response header is set todeadline-exceeded.
9950 # - internal: a retry is attempted if the gRPC
9951 # status code in the response header is set tointernal.
9952 # - resource-exhausted: a retry is attempted if the gRPC
9953 # status code in the response header is set toresource-exhausted.
9954 # - unavailable: a retry is attempted if the gRPC
9955 # status code in the response header is set tounavailable.
9956 #
9957 # Only the following codes are supported when the URL map is bound to
9958 # target gRPC proxy that has validateForProxyless field set to true.
9959 #
9960 # - cancelled
9961 # - deadline-exceeded
9962 # - internal
9963 # - resource-exhausted
9964 # - unavailable
9965 &quot;A String&quot;,
9966 ],
9967 },
9968 &quot;timeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
9969 # time the request has been fully processed (known as *end-of-stream*)
9970 # up until the response has been processed. Timeout includes
9971 # all retries.
9972 #
9973 # If not specified, this field uses the largest timeout among all backend
9974 # services associated with the route.
9975 #
9976 # Not supported when the URL map is bound to a target gRPC proxy that
9977 # has validateForProxyless field set to true.
9978 # as a count of seconds and fractions of seconds at nanosecond
9979 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9980 # or &quot;month&quot;. Range is approximately 10,000 years.
9981 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9982 # Durations less than one second are represented with a 0
9983 # `seconds` field and a positive `nanos` field. Must be from 0
9984 # to 999,999,999 inclusive.
9985 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9986 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9987 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9988 },
9989 &quot;urlRewrite&quot;: { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
9990 # to the matched service.
9991 #
9992 # urlRewrite is the only action supported in UrlMaps
9993 # for classic Application Load Balancers.
9994 #
9995 # Not supported when the URL map is bound to a target gRPC proxy that
9996 # has the validateForProxyless field set to true.
9997 # backend service.
9998 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
9999 # host header is replaced with contents of hostRewrite.
10000 #
10001 # The value must be from 1 to 255 characters.
10002 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
10003 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
10004 #
10005 # The value must be from 1 to 1024 characters.
10006 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
10007 # header) using the HTTP template syntax.
10008 #
10009 # A corresponding
10010 # path_template_match must be specified. Any template variables must exist in
10011 # the path_template_match field.
10012 #
10013 #
10014 # - -At least one variable must be specified in the path_template_match
10015 # field
10016 # - You can omit variables from the rewritten URL
10017 # - The * and ** operators cannot be matched
10018 # unless they have a corresponding variable name - e.g.
10019 # {format=*} or {var=**}.
10020 #
10021 # For example, a path_template_match of /static/{format=**}
10022 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
10023 # rewrite, so that /{country}/{format}/{suffix=**} can be
10024 # rewritten as /content/{format}/{country}/{suffix}.
10025 #
10026 # At least
10027 # one non-empty routeRules[].matchRules[].path_template_match is
10028 # required.
10029 #
10030 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
10031 },
10032 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
10033 # occurs. The weights determine the fraction of traffic that flows to
10034 # their corresponding backend service. If all traffic needs to
10035 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
10036 #
10037 # After a backend service is identified and before forwarding
10038 # the request to
10039 # the backend service, advanced routing actions such as URL rewrites and
10040 # header transformations are applied depending on additional settings
10041 # specified in this HttpRouteAction.
10042 { # In contrast to a single BackendService in
10043 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
10044 # multiple backend services. The volume of traffic for each
10045 # backend service is proportional to the weight specified
10046 # in each WeightedBackendService
10047 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
10048 # resource. Before
10049 # forwarding the request to backendService, the load balancer
10050 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
10051 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
10052 # effect for the selected backendService.
10053 #
10054 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
10055 #
10056 # headerAction is not supported for load balancers that have
10057 # their loadBalancingScheme set to EXTERNAL.
10058 #
10059 # Not supported when the URL map is bound to a target gRPC proxy that
10060 # has validateForProxyless field set to true.
10061 # the request is passed along to the selected backendService.
10062 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
10063 { # Specification determining how headers are added to requests or responses.
10064 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
10065 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
10066 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
10067 # that already
10068 # exist for the header. If true, headerValue is set for the
10069 # header, discarding any values that were set for that header.
10070 #
10071 # The default value is true,
10072 # unless a variable is present in headerValue,
10073 # in which case the default value is false.
10074 # .
10075 },
10076 ],
10077 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
10078 # request before forwarding the request to the backendService.
10079 &quot;A String&quot;,
10080 ],
10081 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
10082 # client.
10083 { # Specification determining how headers are added to requests or responses.
10084 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
10085 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
10086 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
10087 # that already
10088 # exist for the header. If true, headerValue is set for the
10089 # header, discarding any values that were set for that header.
10090 #
10091 # The default value is true,
10092 # unless a variable is present in headerValue,
10093 # in which case the default value is false.
10094 # .
10095 },
10096 ],
10097 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
10098 # response before sending the response back to the client.
10099 &quot;A String&quot;,
10100 ],
10101 },
10102 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
10103 # computed asweight / (sum of all weightedBackendService weights in routeAction).
10104 #
10105 # The selection of a backend service is determined only for new traffic.
10106 # Once a user&#x27;s request has been directed to a backend service,
10107 # subsequent requests are sent to the same backend service as
10108 # determined by the backend service&#x27;s session affinity policy.
10109 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
10110 # splitting. If you do, the weighted traffic splitting configuration takes
10111 # precedence.
10112 #
10113 # The value must be from 0 to 1000.
10114 },
10115 ],
10116 },
10117 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
10118 # is directed if this rule is matched. If routeAction is
10119 # also specified, advanced routing actions, such as URL rewrites,
10120 # take effect before sending the request to the backend.
10121 #
10122 #
10123 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
10124 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
10125 # specified by urlRedirect.
10126 #
10127 #
10128 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
10129 #
10130 #
10131 # Not supported when the URL map is bound to a target gRPC proxy.
10132 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
10133 # was supplied in the request.
10134 #
10135 # The value must be from 1 to 255
10136 # characters.
10137 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
10138 # set to HTTPS.
10139 # If set to false, the URL scheme of the redirected request
10140 # remains the same as that of the request.
10141 #
10142 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
10143 #
10144 # The default is set to false.
10145 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
10146 # that was supplied in the request.
10147 #
10148 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
10149 # supplied, the path of the original request is used for the redirect.
10150 #
10151 # The value must be from 1 to 1024 characters.
10152 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
10153 # the HttpRouteRuleMatch, retaining the remaining portion
10154 # of the URL before redirecting the request.
10155 #
10156 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
10157 # supplied, the path of the original request is used for the redirect.
10158 #
10159 # The value must be from 1 to 1024 characters.
10160 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
10161 #
10162 # Supported values are:
10163 #
10164 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
10165 # to 301.
10166 # - FOUND, which corresponds to 302.
10167 # - SEE_OTHER which corresponds to 303.
10168 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
10169 # method is retained.
10170 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
10171 # method is retained.
10172 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
10173 # URL is
10174 # removed before redirecting the request. If set to false, the
10175 # query portion of the original URL is retained.
10176 #
10177 # The default is set to false.
10178 },
10179 },
10180 ],
10181 &quot;routeRules&quot;: [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
10182 # desired. routeRules are evaluated in order of priority, from
10183 # the lowest to highest number.
10184 #
10185 # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
10186 { # The HttpRouteRule setting specifies how to match an HTTP request
10187 # and the corresponding routing action that load balancing proxies perform.
10188 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
10189 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
10190 #
10191 # If a policy for an
10192 # error code is not configured for the RouteRule, a policy for
10193 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
10194 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
10195 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
10196 # effect.
10197 #
10198 # For example, consider a UrlMap with the following configuration:
10199 #
10200 #
10201 # - UrlMap.defaultCustomErrorResponsePolicy are configured
10202 # with policies for 5xx and 4xx errors
10203 # - A RouteRule for /coming_soon/ is configured for the
10204 # error code 404.
10205 #
10206 # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher&#x27;s policy
10207 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
10208 # the policy in RouteRule.customErrorResponsePolicy takes
10209 # effect. If any of the requests in this example encounter a 500
10210 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
10211 #
10212 # When
10213 # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
10214 # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
10215 # a retry, if load balancer is successful in reaching the
10216 # service, the customErrorResponsePolicy is ignored and
10217 # the response from the service is returned to the client.
10218 #
10219 # customErrorResponsePolicy is supported only for
10220 # global external Application Load Balancers.
10221 # backend service or backend bucket responds with an error.
10222 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
10223 #
10224 # In a given policy, if you specify rules for both a range of error codes
10225 # as well as rules for specific error codes then rules with specific error
10226 # codes have a higher priority. For example, assume that you configure a rule
10227 # for 401 (Un-authorized) code, and another for all 4 series
10228 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
10229 # However if the backend service returns a 403, the rule for4xx takes effect.
10230 { # Specifies the mapping between the response code that will be returned along
10231 # with the custom error content and the response code returned by the backend
10232 # service.
10233 &quot;matchResponseCodes&quot;: [ # Valid values include:
10234 #
10235 #
10236 # - A number between 400 and 599: For example
10237 # 401 or 503, in which case the load balancer
10238 # applies the policy if the error code exactly matches this value.
10239 # - 5xx: Load Balancer will apply the policy if the
10240 # backend service responds with any response code in the range of
10241 # 500 to 599.
10242 # - 4xx: Load
10243 # Balancer will apply the policy if the backend service responds with any
10244 # response code in the range of 400 to
10245 # 499.
10246 #
10247 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
10248 &quot;A String&quot;,
10249 ],
10250 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
10251 # error content. If overrideResponseCode is not supplied, the
10252 # same response code returned by the original backend bucket or backend
10253 # service is returned to the client.
10254 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
10255 #
10256 # path must start
10257 # with a leading slash. path cannot have trailing slashes.
10258 #
10259 # If the file is not available in backendBucket or the
10260 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
10261 #
10262 # The value must
10263 # be from 1 to 1024 characters
10264 },
10265 ],
10266 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
10267 # contains the custom error content. Examples are:
10268 #
10269 #
10270 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
10271 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
10272 # - global/backendBuckets/myBackendBucket
10273 #
10274 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
10275 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
10276 #
10277 # If load balancer cannot reach
10278 # the backendBucket, a simple Not Found Error will
10279 # be returned, with the original response code (oroverrideResponseCode if configured).
10280 #
10281 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
10282 },
10283 &quot;description&quot;: &quot;A String&quot;, # The short description conveying the intent of this routeRule.
10284 #
10285 #
10286 # The description can have a maximum length of 1024 characters.
10287 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
10288 # for the selected backendService.
10289 #
10290 # The headerAction value specified here is applied before the
10291 # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
10292 #
10293 # HeaderAction is not supported for load balancers
10294 # that have
10295 # their loadBalancingScheme set to EXTERNAL.
10296 #
10297 # Not supported when the URL map is bound to a target gRPC proxy that
10298 # has validateForProxyless field set to true.
10299 # the request is passed along to the selected backendService.
10300 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
10301 { # Specification determining how headers are added to requests or responses.
10302 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
10303 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
10304 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
10305 # that already
10306 # exist for the header. If true, headerValue is set for the
10307 # header, discarding any values that were set for that header.
10308 #
10309 # The default value is true,
10310 # unless a variable is present in headerValue,
10311 # in which case the default value is false.
10312 # .
10313 },
10314 ],
10315 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
10316 # request before forwarding the request to the backendService.
10317 &quot;A String&quot;,
10318 ],
10319 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
10320 # client.
10321 { # Specification determining how headers are added to requests or responses.
10322 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
10323 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
10324 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
10325 # that already
10326 # exist for the header. If true, headerValue is set for the
10327 # header, discarding any values that were set for that header.
10328 #
10329 # The default value is true,
10330 # unless a variable is present in headerValue,
10331 # in which case the default value is false.
10332 # .
10333 },
10334 ],
10335 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
10336 # response before sending the response back to the client.
10337 &quot;A String&quot;,
10338 ],
10339 },
10340 &quot;matchRules&quot;: [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
10341 # this routeRule when any of thematchRules are satisfied. However predicates within
10342 # a given matchRule have AND semantics. All predicates
10343 # within a matchRule must match for the request to
10344 # match the rule.
10345 { # HttpRouteRuleMatch specifies a set of criteria for matching
10346 # requests to an HttpRouteRule. All specified criteria must
10347 # be satisfied for a match to occur.
10348 &quot;fullPathMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
10349 # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
10350 # that may be part of the original URL.
10351 #
10352 # fullPathMatch must be from 1 to 1024 characters.
10353 #
10354 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
10355 # specified.
10356 &quot;headerMatches&quot;: [ # Specifies a list of header match criteria, all of which must match
10357 # corresponding headers in the request.
10358 { # matchRule criteria for request header matches.
10359 &quot;exactMatch&quot;: &quot;A String&quot;, # The value should exactly match contents of exactMatch.
10360 #
10361 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
10362 &quot;headerName&quot;: &quot;A String&quot;, # The name of the HTTP header to match.
10363 #
10364 # For matching against the HTTP request&#x27;s authority, use a headerMatch
10365 # with the header name &quot;:authority&quot;.
10366 #
10367 # For matching a request&#x27;s method, use the headerName &quot;:method&quot;.
10368 #
10369 # When the URL map is bound to a target gRPC proxy that has
10370 # the validateForProxyless field set to true, only
10371 # non-binary
10372 # user-specified custom metadata and the `content-type` header are supported.
10373 # The following transport-level headers cannot be used in header matching
10374 # rules:
10375 # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
10376 # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
10377 # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
10378 # `grpc-timeout` and `grpc-trace-bin`.
10379 &quot;invertMatch&quot;: True or False, # If set to false, the headerMatch is considered a
10380 # match if the preceding match criteria are met. If set to true,
10381 # the headerMatch is considered a match if the preceding
10382 # match criteria are NOT met.
10383 #
10384 # The default setting is false.
10385 &quot;prefixMatch&quot;: &quot;A String&quot;, # The value of the header must start with the contents ofprefixMatch.
10386 #
10387 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
10388 &quot;presentMatch&quot;: True or False, # A header with the contents of headerName must exist. The
10389 # match takes place whether or not the request&#x27;s header has a value.
10390 #
10391 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
10392 &quot;rangeMatch&quot;: { # HttpRouteRuleMatch criteria for field values that must stay # The header value must be an integer and its value must be in the range
10393 # specified in rangeMatch. If the header does not contain an
10394 # integer, number or is empty, the match fails.
10395 #
10396 # For example for a range [-5, 0]
10397 #
10398 #
10399 # - -3 will match.
10400 # - 0 will not match.
10401 # - 0.25 will not match.
10402 # - -3someString will not match.
10403 #
10404 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
10405 #
10406 # rangeMatch is not supported for load balancers
10407 # that have loadBalancingScheme set to EXTERNAL.
10408 # within the specified integer range.
10409 &quot;rangeEnd&quot;: &quot;A String&quot;, # The end of the range (exclusive) in signed long integer format.
10410 &quot;rangeStart&quot;: &quot;A String&quot;, # The start of the range (inclusive) in signed long integer format.
10411 },
10412 &quot;regexMatch&quot;: &quot;A String&quot;, # The value of the header must match the regular expression specified inregexMatch.
10413 # For more information about regular expression syntax, see Syntax.
10414 #
10415 # For matching against a port specified in the HTTP request, use a
10416 # headerMatch with headerName set to PORT and a regular expression that
10417 # satisfies the RFC2616 Host header&#x27;s port specifier.
10418 #
10419 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
10420 #
10421 # Regular expressions can only be used when the loadBalancingScheme is
10422 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
10423 # (regional scope) or INTERNAL_MANAGED.
10424 &quot;suffixMatch&quot;: &quot;A String&quot;, # The value of the header must end with the contents ofsuffixMatch.
10425 #
10426 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
10427 },
10428 ],
10429 &quot;ignoreCase&quot;: True or False, # Specifies that prefixMatch and fullPathMatch
10430 # matches are case sensitive.
10431 #
10432 # The default value is false.
10433 #
10434 # ignoreCase must not be used with regexMatch.
10435 #
10436 # Not supported when the URL map is bound to a target gRPC proxy.
10437 &quot;metadataFilters&quot;: [ # Opaque filter criteria used by the load balancer to restrict routing
10438 # configuration to a limited set of xDS
10439 # compliant clients. In their xDS requests to the load balancer, xDS clients
10440 # present node
10441 # metadata. When there is a match, the relevant routing configuration
10442 # is made available to those proxies.
10443 #
10444 # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least one of thefilterLabels must match the corresponding label provided in
10445 # the metadata. If its filterMatchCriteria is set to
10446 # MATCH_ALL, then all of its filterLabels must match with
10447 # corresponding labels provided in the metadata. If multiple
10448 # metadata filters are specified, all of them need to be
10449 # satisfied in order to be considered a match.
10450 #
10451 # metadataFilters specified here is applied after those
10452 # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
10453 #
10454 # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
10455 #
10456 # Not supported when the URL map is bound to a target gRPC proxy that
10457 # has validateForProxyless field set to true.
10458 { # Opaque filter criteria used by load balancers to restrict routing
10459 # configuration to a limited set of load balancing proxies. Proxies and
10460 # sidecars involved in load balancing would typically present metadata to the
10461 # load balancers that need to match criteria specified here. If a match takes
10462 # place, the relevant configuration is made available to those
10463 # proxies.
10464 #
10465 # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
10466 # one of thefilterLabels must match the corresponding label provided in
10467 # the metadata. If its filterMatchCriteria is set to
10468 # MATCH_ALL, then all of its filterLabels must match with
10469 # corresponding labels provided in the metadata.
10470 #
10471 # An example for using metadataFilters would be: if
10472 # load balancing involves
10473 # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in of their XDS requests to loadbalancers.
10474 &quot;filterLabels&quot;: [ # The list of label value pairs that must match labels in the provided
10475 # metadata based on filterMatchCriteria
10476 #
10477 # This list must not be empty and can have at the most 64 entries.
10478 { # MetadataFilter label name value pairs that are expected
10479 # to match corresponding labels presented as metadata to the load balancer.
10480 &quot;name&quot;: &quot;A String&quot;, # Name of metadata label.
10481 #
10482 # The name can have a maximum length of 1024 characters and must be at
10483 # least 1 character long.
10484 &quot;value&quot;: &quot;A String&quot;, # The value of the label must match the specified value.
10485 #
10486 # value can have a maximum length of 1024 characters.
10487 },
10488 ],
10489 &quot;filterMatchCriteria&quot;: &quot;A String&quot;, # Specifies how individual filter label matches
10490 # within the list of filterLabels and contributes toward the
10491 # overall metadataFilter match.
10492 #
10493 # Supported values are:
10494 #
10495 # - MATCH_ANY: at least one of the filterLabels
10496 # must have a matching label in the provided metadata.
10497 # - MATCH_ALL: all filterLabels must have
10498 # matching labels in the provided metadata.
10499 },
10500 ],
10501 &quot;pathTemplateMatch&quot;: &quot;A String&quot;, # If specified, this field defines a path template pattern that must match
10502 # the :path header after the query string is removed.
10503 #
10504 # A path template pattern can include variables and wildcards.
10505 # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
10506 # matches a single path segment, and ** that matches zero or
10507 # more path segments. The pattern must follow these rules:
10508 #
10509 #
10510 # - The value must be between 1 and 1024 characters.
10511 # - The pattern must start with a leading slash (&quot;/&quot;).
10512 # - No more than 5 operators (variables or wildcards) may appear in
10513 # the pattern.
10514 #
10515 # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
10516 # set.
10517 &quot;prefixMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the request&#x27;s
10518 # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
10519 #
10520 # The value must be from 1 to 1024 characters.
10521 #
10522 # The * character inside a prefix match is
10523 # treated as a literal character, not as a wildcard.
10524 #
10525 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
10526 # used within a matchRule.
10527 &quot;queryParameterMatches&quot;: [ # Specifies a list of query parameter match criteria, all of which must
10528 # match corresponding query parameters in the request.
10529 #
10530 # Not supported when the URL map is bound to a target gRPC proxy.
10531 { # HttpRouteRuleMatch criteria for a request&#x27;s query parameter.
10532 &quot;exactMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
10533 # parameter exactly matches the contents of exactMatch.
10534 #
10535 # Only one of presentMatch, exactMatch, orregexMatch must be set.
10536 &quot;name&quot;: &quot;A String&quot;, # The name of the query parameter to match. The query parameter must exist in
10537 # the request, in the absence of which the request match fails.
10538 &quot;presentMatch&quot;: True or False, # Specifies that the queryParameterMatch matches if the
10539 # request contains the query parameter, irrespective of whether the
10540 # parameter has a value or not.
10541 #
10542 # Only one of presentMatch, exactMatch, orregexMatch must be set.
10543 &quot;regexMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
10544 # parameter matches the regular expression specified byregexMatch. For
10545 # more information about regular expression syntax, see Syntax.
10546 #
10547 # Only one of presentMatch, exactMatch, orregexMatch must be set.
10548 #
10549 # Regular expressions can only be used when the loadBalancingScheme is
10550 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
10551 # (regional scope) or INTERNAL_MANAGED.
10552 },
10553 ],
10554 &quot;regexMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
10555 # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
10556 # supplied with the original URL. For
10557 # more information about regular expression syntax, see Syntax.
10558 #
10559 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
10560 # specified.
10561 #
10562 # Regular expressions can only be used when the loadBalancingScheme is
10563 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
10564 # (regional scope) or INTERNAL_MANAGED.
10565 },
10566 ],
10567 &quot;priority&quot;: 42, # For routeRules within a given pathMatcher,
10568 # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
10569 # of priority, from the lowest to highest number. The priority of a
10570 # rule decreases as its number increases (1, 2, 3, N+1). The first rule
10571 # that matches the request is applied.
10572 #
10573 #
10574 # You cannot configure two or more routeRules with the same priority.
10575 # Priority for each rule must be set to a number from 0 to 2147483647
10576 # inclusive.
10577 #
10578 #
10579 # Priority numbers can have gaps, which enable you to add or remove rules
10580 # in the future without affecting the rest of the rules. For example, 1, 2,
10581 # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
10582 # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
10583 # without any impact on existing rules.
10584 &quot;routeAction&quot;: { # In response to a matching matchRule, the load balancer
10585 # performs advanced routing actions, such as URL rewrites and header
10586 # transformations, before forwarding the request to the selected backend.
10587 #
10588 #
10589 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
10590 #
10591 #
10592 # URL maps for classic Application Load Balancers only support
10593 # the urlRewrite action within a route rule&#x27;srouteAction.
10594 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
10595 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
10596 # property must be specified. This policy cannot be specified if any target
10597 # backend has Identity-Aware Proxy enabled.
10598 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
10599 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
10600 # header names can be specified. The cache is bypassed for all `cacheMode`
10601 # values.
10602 &quot;A String&quot;,
10603 ],
10604 &quot;cacheKeyPolicy&quot;: { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
10605 # on the backend type: for Backend Services, the complete request URI is
10606 # used; for Backend Buckets, the request URI is used without the protocol or
10607 # host, and only query parameters known to Cloud Storage are included.
10608 # Policy defined on Route Action.
10609 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
10610 # parameters will be included. Either specify `excludedQueryParameters`
10611 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
10612 # encoded and not treated as delimiters.
10613 #
10614 # Note: This field applies to routes that use backend services. Attempting
10615 # to set it on a route that points exclusively to Backend Buckets will
10616 # result in a configuration error. For routes that point to a Backend
10617 # Bucket, use `includedQueryParameters` to define which parameters should
10618 # be part of the cache key.
10619 &quot;A String&quot;,
10620 ],
10621 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
10622 #
10623 # Note: This setting is only applicable to routes that use a Backend
10624 # Service. It does not affect requests served by a Backend Bucket, as the
10625 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
10626 # it on a route that points exclusively to Backend Buckets will result in a
10627 # configuration error.
10628 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
10629 #
10630 # Note: This setting is only applicable to routes that use a Backend
10631 # Service. It does not affect requests served by a Backend Bucket, as the
10632 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
10633 # set on a route that points exclusively to Backend Buckets will result in
10634 # a configuration error.
10635 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
10636 # `includedQueryParameters` and `excludedQueryParameters`. If neither
10637 # is set, the entire query string will be included. If false, the query
10638 # string will be excluded from the cache key entirely.
10639 #
10640 # Note: This field applies to routes that use backend services. Attempting
10641 # to set it on a route that points exclusively to Backend Buckets will
10642 # result in a configuration error. For routes that point to a Backend
10643 # Bucket, use `includedQueryParameters` to define which parameters should
10644 # be part of the cache key.
10645 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
10646 # The name=value pair will be used in the cache key Cloud CDN generates.
10647 #
10648 # Note: This setting is only applicable to routes that use a Backend
10649 # Service. It does not affect requests served by a Backend Bucket.
10650 # Attempting to set it on a route that points exclusively to Backend
10651 # Buckets will result in a configuration error. Up to 5 cookie names can be
10652 # specified.
10653 &quot;A String&quot;,
10654 ],
10655 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
10656 &quot;A String&quot;,
10657 ],
10658 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
10659 # parameters will be excluded. Either specify `includedQueryParameters`
10660 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
10661 # encoded and not treated as delimiters.
10662 &quot;A String&quot;,
10663 ],
10664 },
10665 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
10666 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
10667 &quot;clientTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
10668 # content. This is used to clamp the max-age (or Expires) value sent to the
10669 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
10670 # is used for the response max-age directive, along with a &quot;public&quot;
10671 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
10672 # clamps the max-age from the origin (if specified), or else sets the
10673 # response max-age directive to the lesser of the `clientTtl` and
10674 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
10675 # present. The maximum allowed value is 31,622,400s (1 year). If not
10676 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
10677 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
10678 # `USE_ORIGIN_HEADERS`.
10679 # as a count of seconds and fractions of seconds at nanosecond
10680 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10681 # or &quot;month&quot;. Range is approximately 10,000 years.
10682 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10683 # Durations less than one second are represented with a 0
10684 # `seconds` field and a positive `nanos` field. Must be from 0
10685 # to 999,999,999 inclusive.
10686 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10687 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10688 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10689 },
10690 &quot;defaultTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
10691 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
10692 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
10693 # greater than that of `maxTtl`. When the `cacheMode` is set to
10694 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
10695 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
10696 # accessed objects may be evicted from the cache before the defined TTL. If
10697 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
10698 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
10699 # `USE_ORIGIN_HEADERS`.
10700 # as a count of seconds and fractions of seconds at nanosecond
10701 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10702 # or &quot;month&quot;. Range is approximately 10,000 years.
10703 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10704 # Durations less than one second are represented with a 0
10705 # `seconds` field and a positive `nanos` field. Must be from 0
10706 # to 999,999,999 inclusive.
10707 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10708 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10709 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10710 },
10711 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
10712 # attempt to set a max-age or s-maxage higher than this, or an Expires header
10713 # more than `maxTtl` seconds in the future will be capped at the value of
10714 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
10715 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
10716 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
10717 # Infrequently accessed objects may be evicted from the cache before the
10718 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
10719 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
10720 # mode.
10721 # as a count of seconds and fractions of seconds at nanosecond
10722 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10723 # or &quot;month&quot;. Range is approximately 10,000 years.
10724 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10725 # Durations less than one second are represented with a 0
10726 # `seconds` field and a positive `nanos` field. Must be from 0
10727 # to 999,999,999 inclusive.
10728 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10729 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10730 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10731 },
10732 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
10733 # to apply fine-grained caching for common errors or redirects.
10734 # This can reduce the load on your origin and improve end-user
10735 # experience by reducing response latency.
10736 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
10737 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
10738 # the specified response code that lack any Cache-Control, Expires, or
10739 # Pragma: no-cache directives. When the `cacheMode` is set to
10740 # `FORCE_CACHE_ALL`, negative caching applies to all responses
10741 # with the specified response code, and overrides any caching headers. By
10742 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
10743 #
10744 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
10745 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
10746 # * 405 (Method Not Found), 501 (Not Implemented): 60s
10747 #
10748 # These defaults can be overridden in `negativeCachingPolicy`.
10749 # If not specified, Cloud CDN applies negative caching by default.
10750 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
10751 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
10752 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
10753 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
10754 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
10755 # all response codes that you wish to cache. Cloud CDN will not apply any
10756 # default negative caching when a policy exists.
10757 { # Specify CDN TTLs for response error codes.
10758 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
10759 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
10760 # specified as values, and you cannot specify a status code more than
10761 # once.
10762 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
10763 # corresponding status code.
10764 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
10765 # objects may be evicted from the cache before the defined TTL.
10766 # as a count of seconds and fractions of seconds at nanosecond
10767 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10768 # or &quot;month&quot;. Range is approximately 10,000 years.
10769 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10770 # Durations less than one second are represented with a 0
10771 # `seconds` field and a positive `nanos` field. Must be from 0
10772 # to 999,999,999 inclusive.
10773 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10774 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10775 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10776 },
10777 },
10778 ],
10779 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
10780 # requests into a small number of requests to the origin. If not specified,
10781 # Cloud CDN applies request coalescing by default.
10782 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
10783 # content with the origin, or when an error is encountered when refreshing
10784 # the cache.
10785 # This setting defines the default &quot;max-stale&quot; duration for any cached
10786 # responses that do not specify a max-stale directive. Stale responses that
10787 # exceed the TTL configured here will not be served. The default limit
10788 # (max-stale) is 86400s (1 day), which will allow stale content to be
10789 # served up to this limit beyond the max-age (or s-maxage) of a cached
10790 # response.
10791 # The maximum allowed value is 604800 (1 week).
10792 # Set this to zero (0) to disable serve-while-stale.
10793 # as a count of seconds and fractions of seconds at nanosecond
10794 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10795 # or &quot;month&quot;. Range is approximately 10,000 years.
10796 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10797 # Durations less than one second are represented with a 0
10798 # `seconds` field and a positive `nanos` field. Must be from 0
10799 # to 999,999,999 inclusive.
10800 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10801 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10802 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10803 },
10804 },
10805 &quot;corsPolicy&quot;: { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
10806 # information about the W3C recommendation for cross-origin resource sharing
10807 # (CORS), see Fetch API Living
10808 # Standard.
10809 #
10810 # Not supported when the URL map is bound to a target gRPC proxy.
10811 # information about the W3C recommendation for cross-origin resource sharing
10812 # (CORS), see Fetch API Living
10813 # Standard.
10814 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
10815 # indicates that
10816 # the actual request can include user credentials. This field translates to
10817 # the Access-Control-Allow-Credentials header.
10818 #
10819 # Default is false.
10820 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
10821 # header.
10822 &quot;A String&quot;,
10823 ],
10824 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
10825 # header.
10826 &quot;A String&quot;,
10827 ],
10828 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
10829 # more information, see regular expression syntax.
10830 #
10831 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
10832 #
10833 # Regular expressions can only be used when the loadBalancingScheme is
10834 # set to INTERNAL_SELF_MANAGED.
10835 &quot;A String&quot;,
10836 ],
10837 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
10838 #
10839 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
10840 &quot;A String&quot;,
10841 ],
10842 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
10843 # The default value is false, which indicates that the CORS
10844 # policy is in effect.
10845 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
10846 # header.
10847 &quot;A String&quot;,
10848 ],
10849 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
10850 # seconds. This field translates to the Access-Control-Max-Age
10851 # header.
10852 },
10853 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
10854 # the resiliency of clients to backend service failure. As part of fault
10855 # injection, when clients send requests to a backend service, delays can be
10856 # introduced by a load balancer on a percentage of requests before sending
10857 # those requests to the backend service. Similarly requests from clients can
10858 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
10859 # that are configured with a fault_injection_policy if:
10860 # 1. The traffic is generated by fault injection AND
10861 # 2. The fault injection is not a delay fault injection.
10862 # Fault injection is not supported with the classic Application Load Balancer
10863 # . To see which load balancers support fault injection,
10864 # see Load
10865 # balancing: Routing and traffic management features.
10866 # the resiliency of clients to backend service failure. As part of fault
10867 # injection, when clients send requests to a backend service, delays can be
10868 # introduced by the load balancer on a percentage of requests before sending
10869 # those request to the backend service. Similarly requests from clients can be
10870 # aborted by the load balancer for a percentage of requests.
10871 &quot;abort&quot;: { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
10872 # injection.
10873 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
10874 #
10875 # The value must be from 200 to 599 inclusive.
10876 #
10877 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
10878 # according to this
10879 # mapping table. HTTP status 200 is mapped to gRPC status
10880 # UNKNOWN. Injecting an OK status is currently not supported by
10881 # Traffic Director.
10882 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
10883 # that is aborted as part of fault injection.
10884 #
10885 # The value must be from 0.0 to 100.0 inclusive.
10886 },
10887 &quot;delay&quot;: { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
10888 # injection, before being sent to a backend service.
10889 # request to the backend service as part of fault injection.
10890 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
10891 # as a count of seconds and fractions of seconds at nanosecond
10892 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10893 # or &quot;month&quot;. Range is approximately 10,000 years.
10894 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10895 # Durations less than one second are represented with a 0
10896 # `seconds` field and a positive `nanos` field. Must be from 0
10897 # to 999,999,999 inclusive.
10898 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10899 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10900 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10901 },
10902 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
10903 # which a delay is introduced as part of fault injection.
10904 #
10905 # The value must be from 0.0 to 100.0 inclusive.
10906 },
10907 },
10908 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
10909 # Unlike the timeout field where the timeout duration starts
10910 # from the time the request has been fully processed (known as*end-of-stream*),
10911 # the duration in this field is computed from the beginning of the stream
10912 # until the response has been processed, including all retries. A
10913 # stream that does not complete in this duration is closed.
10914 #
10915 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
10916 # with the route.
10917 #
10918 # This field is only allowed if the Url map is used with backend services
10919 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
10920 # as a count of seconds and fractions of seconds at nanosecond
10921 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10922 # or &quot;month&quot;. Range is approximately 10,000 years.
10923 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10924 # Durations less than one second are represented with a 0
10925 # `seconds` field and a positive `nanos` field. Must be from 0
10926 # to 999,999,999 inclusive.
10927 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10928 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10929 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10930 },
10931 &quot;requestMirrorPolicy&quot;: { # A policy that specifies how requests intended for the route&#x27;s backends # Specifies the policy on how requests intended for the route&#x27;s backends
10932 # are shadowed to a separate mirrored backend service. The load balancer does
10933 # not wait for responses from the shadow service. Before sending traffic
10934 # to the shadow service, the host / authority header is suffixed with-shadow.
10935 #
10936 # Not supported when the URL map is bound to a target gRPC proxy that
10937 # has the validateForProxyless field set to true.
10938 # are shadowed to a separate mirrored backend service. The load balancer
10939 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
10940 # to the shadow service, the host or authority header is suffixed with-shadow.
10941 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
10942 # mirrored to.
10943 #
10944 # The backend service configured for a mirroring
10945 # policy must reference backends that are of the same type as the original
10946 # backend service matched in the URL map.
10947 #
10948 # Serverless NEG backends are not currently supported as a mirrored
10949 # backend service.
10950 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
10951 },
10952 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
10953 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
10954 # If not specified, defaults to 1.
10955 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
10956 #
10957 # If not specified, will use the timeout set in theHttpRouteAction field.
10958 # If timeout in the HttpRouteAction field is not set, this field
10959 # uses the largest timeout
10960 # among all backend services associated with the route.
10961 #
10962 # Not supported when the URL map is bound to a target gRPC proxy that
10963 # has the validateForProxyless field set to true.
10964 # as a count of seconds and fractions of seconds at nanosecond
10965 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10966 # or &quot;month&quot;. Range is approximately 10,000 years.
10967 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10968 # Durations less than one second are represented with a 0
10969 # `seconds` field and a positive `nanos` field. Must be from 0
10970 # to 999,999,999 inclusive.
10971 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10972 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10973 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10974 },
10975 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
10976 # values are:
10977 #
10978 # - 5xx: retry is attempted if the instance or endpoint
10979 # responds with any 5xx response code, or if the instance or
10980 # endpoint does not respond at all. For example, disconnects, reset, read
10981 # timeout, connection failure, and refused streams.
10982 # - gateway-error: Similar to 5xx, but only
10983 # applies to response codes 502, 503 or504.
10984 # - connect-failure: a retry is attempted on failures
10985 # connecting to the instance or endpoint. For example, connection
10986 # timeouts.
10987 # - retriable-4xx: a retry is attempted if the instance
10988 # or endpoint responds with a 4xx response code.
10989 # The only error that you can retry is error code 409.
10990 # - refused-stream: a retry is attempted if the instance
10991 # or endpoint resets the stream with a REFUSED_STREAM error
10992 # code. This reset type indicates that it is safe to retry.
10993 # - cancelled: a retry is attempted if the gRPC status
10994 # code in the response header is set to cancelled.
10995 # - deadline-exceeded: a retry is attempted if the gRPC
10996 # status code in the response header is set todeadline-exceeded.
10997 # - internal: a retry is attempted if the gRPC
10998 # status code in the response header is set tointernal.
10999 # - resource-exhausted: a retry is attempted if the gRPC
11000 # status code in the response header is set toresource-exhausted.
11001 # - unavailable: a retry is attempted if the gRPC
11002 # status code in the response header is set tounavailable.
11003 #
11004 # Only the following codes are supported when the URL map is bound to
11005 # target gRPC proxy that has validateForProxyless field set to true.
11006 #
11007 # - cancelled
11008 # - deadline-exceeded
11009 # - internal
11010 # - resource-exhausted
11011 # - unavailable
11012 &quot;A String&quot;,
11013 ],
11014 },
11015 &quot;timeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
11016 # time the request has been fully processed (known as *end-of-stream*)
11017 # up until the response has been processed. Timeout includes
11018 # all retries.
11019 #
11020 # If not specified, this field uses the largest timeout among all backend
11021 # services associated with the route.
11022 #
11023 # Not supported when the URL map is bound to a target gRPC proxy that
11024 # has validateForProxyless field set to true.
11025 # as a count of seconds and fractions of seconds at nanosecond
11026 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
11027 # or &quot;month&quot;. Range is approximately 10,000 years.
11028 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
11029 # Durations less than one second are represented with a 0
11030 # `seconds` field and a positive `nanos` field. Must be from 0
11031 # to 999,999,999 inclusive.
11032 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
11033 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
11034 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
11035 },
11036 &quot;urlRewrite&quot;: { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
11037 # to the matched service.
11038 #
11039 # urlRewrite is the only action supported in UrlMaps
11040 # for classic Application Load Balancers.
11041 #
11042 # Not supported when the URL map is bound to a target gRPC proxy that
11043 # has the validateForProxyless field set to true.
11044 # backend service.
11045 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
11046 # host header is replaced with contents of hostRewrite.
11047 #
11048 # The value must be from 1 to 255 characters.
11049 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
11050 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
11051 #
11052 # The value must be from 1 to 1024 characters.
11053 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
11054 # header) using the HTTP template syntax.
11055 #
11056 # A corresponding
11057 # path_template_match must be specified. Any template variables must exist in
11058 # the path_template_match field.
11059 #
11060 #
11061 # - -At least one variable must be specified in the path_template_match
11062 # field
11063 # - You can omit variables from the rewritten URL
11064 # - The * and ** operators cannot be matched
11065 # unless they have a corresponding variable name - e.g.
11066 # {format=*} or {var=**}.
11067 #
11068 # For example, a path_template_match of /static/{format=**}
11069 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
11070 # rewrite, so that /{country}/{format}/{suffix=**} can be
11071 # rewritten as /content/{format}/{country}/{suffix}.
11072 #
11073 # At least
11074 # one non-empty routeRules[].matchRules[].path_template_match is
11075 # required.
11076 #
11077 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
11078 },
11079 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
11080 # occurs. The weights determine the fraction of traffic that flows to
11081 # their corresponding backend service. If all traffic needs to
11082 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
11083 #
11084 # After a backend service is identified and before forwarding
11085 # the request to
11086 # the backend service, advanced routing actions such as URL rewrites and
11087 # header transformations are applied depending on additional settings
11088 # specified in this HttpRouteAction.
11089 { # In contrast to a single BackendService in
11090 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
11091 # multiple backend services. The volume of traffic for each
11092 # backend service is proportional to the weight specified
11093 # in each WeightedBackendService
11094 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
11095 # resource. Before
11096 # forwarding the request to backendService, the load balancer
11097 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
11098 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
11099 # effect for the selected backendService.
11100 #
11101 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
11102 #
11103 # headerAction is not supported for load balancers that have
11104 # their loadBalancingScheme set to EXTERNAL.
11105 #
11106 # Not supported when the URL map is bound to a target gRPC proxy that
11107 # has validateForProxyless field set to true.
11108 # the request is passed along to the selected backendService.
11109 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
11110 { # Specification determining how headers are added to requests or responses.
11111 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
11112 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
11113 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
11114 # that already
11115 # exist for the header. If true, headerValue is set for the
11116 # header, discarding any values that were set for that header.
11117 #
11118 # The default value is true,
11119 # unless a variable is present in headerValue,
11120 # in which case the default value is false.
11121 # .
11122 },
11123 ],
11124 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
11125 # request before forwarding the request to the backendService.
11126 &quot;A String&quot;,
11127 ],
11128 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
11129 # client.
11130 { # Specification determining how headers are added to requests or responses.
11131 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
11132 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
11133 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
11134 # that already
11135 # exist for the header. If true, headerValue is set for the
11136 # header, discarding any values that were set for that header.
11137 #
11138 # The default value is true,
11139 # unless a variable is present in headerValue,
11140 # in which case the default value is false.
11141 # .
11142 },
11143 ],
11144 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
11145 # response before sending the response back to the client.
11146 &quot;A String&quot;,
11147 ],
11148 },
11149 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
11150 # computed asweight / (sum of all weightedBackendService weights in routeAction).
11151 #
11152 # The selection of a backend service is determined only for new traffic.
11153 # Once a user&#x27;s request has been directed to a backend service,
11154 # subsequent requests are sent to the same backend service as
11155 # determined by the backend service&#x27;s session affinity policy.
11156 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
11157 # splitting. If you do, the weighted traffic splitting configuration takes
11158 # precedence.
11159 #
11160 # The value must be from 0 to 1000.
11161 },
11162 ],
11163 },
11164 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
11165 # is directed if this rule is matched. If routeAction is
11166 # also specified, advanced routing actions, such as URL rewrites,
11167 # take effect before sending the request to the backend.
11168 #
11169 #
11170 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
11171 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
11172 # specified by urlRedirect.
11173 #
11174 #
11175 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
11176 #
11177 #
11178 # Not supported when the URL map is bound to a target gRPC proxy.
11179 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
11180 # was supplied in the request.
11181 #
11182 # The value must be from 1 to 255
11183 # characters.
11184 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
11185 # set to HTTPS.
11186 # If set to false, the URL scheme of the redirected request
11187 # remains the same as that of the request.
11188 #
11189 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
11190 #
11191 # The default is set to false.
11192 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
11193 # that was supplied in the request.
11194 #
11195 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
11196 # supplied, the path of the original request is used for the redirect.
11197 #
11198 # The value must be from 1 to 1024 characters.
11199 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
11200 # the HttpRouteRuleMatch, retaining the remaining portion
11201 # of the URL before redirecting the request.
11202 #
11203 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
11204 # supplied, the path of the original request is used for the redirect.
11205 #
11206 # The value must be from 1 to 1024 characters.
11207 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
11208 #
11209 # Supported values are:
11210 #
11211 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
11212 # to 301.
11213 # - FOUND, which corresponds to 302.
11214 # - SEE_OTHER which corresponds to 303.
11215 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
11216 # method is retained.
11217 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
11218 # method is retained.
11219 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
11220 # URL is
11221 # removed before redirecting the request. If set to false, the
11222 # query portion of the original URL is retained.
11223 #
11224 # The default is set to false.
11225 },
11226 },
11227 ],
11228 },
11229 ],
11230 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the regional URL map resides.
11231 # This field is not applicable to global URL maps.
11232 # You must specify this field as part of the HTTP request URL. It is
11233 # not settable as a field in the request body.
11234 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
11235 &quot;tests&quot;: [ # The list of expected URL mapping tests. Request to update theUrlMap succeeds only if all test cases pass. You can specify a
11236 # maximum of 100 tests per UrlMap.
11237 #
11238 # Not supported when the URL map is bound to a target gRPC proxy that
11239 # has validateForProxyless field set to true.
11240 { # Message for the expected URL mappings.
11241 &quot;description&quot;: &quot;A String&quot;, # Description of this test case.
11242 &quot;expectedOutputUrl&quot;: &quot;A String&quot;, # The expected output URL evaluated by the load balancer
11243 # containing the scheme, host, path and query parameters.
11244 #
11245 # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
11246 # the load balancer to backends. For rules with urlRewrite,
11247 # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
11248 #
11249 # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer&#x27;s
11250 # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
11251 # If urlRedirect specifies strip_query, the test
11252 # passes only if expectedOutputUrl does not contain any query
11253 # parameters.
11254 #
11255 # expectedOutputUrl is optional whenservice is specified.
11256 &quot;expectedRedirectResponseCode&quot;: 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
11257 # load balancer&#x27;s redirect response.
11258 #
11259 # expectedRedirectResponseCode cannot be set whenservice is set.
11260 &quot;headers&quot;: [ # HTTP headers for this request. If headers contains
11261 # a host header, then host must also match the header value.
11262 { # HTTP headers used in UrlMapTests.
11263 &quot;name&quot;: &quot;A String&quot;, # Header name.
11264 &quot;value&quot;: &quot;A String&quot;, # Header value.
11265 },
11266 ],
11267 &quot;host&quot;: &quot;A String&quot;, # Host portion of the URL. If headers contains a host header,
11268 # then host must also match the header value.
11269 &quot;path&quot;: &quot;A String&quot;, # Path portion of the URL.
11270 &quot;service&quot;: &quot;A String&quot;, # Expected BackendService or BackendBucket resource
11271 # the given URL should be mapped to.
11272 #
11273 # The service field cannot
11274 # be set if expectedRedirectResponseCode is set.
11275 },
11276 ],
11277 }
11278
11279 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
11280 that if you must retry your request, the server will know to ignore the
11281 request if it has already been completed.
11282
11283 For example, consider a situation where you make an initial request and
11284 the request times out. If you make the request again with the same
11285 request ID, the server can check if original operation with the same
11286 request ID was received, and if so, will ignore the second request. This
11287 prevents clients from accidentally creating duplicate commitments.
11288
11289 The request ID must be
11290 a valid UUID with the exception that zero UUID is not supported
11291 (00000000-0000-0000-0000-000000000000).
11292 x__xgafv: string, V1 error format.
11293 Allowed values
11294 1 - v1 error format
11295 2 - v2 error format
11296
11297 Returns:
11298 An object of the form:
11299
11300 { # Represents an Operation resource.
11301 #
11302 # Google Compute Engine has three Operation resources:
11303 #
11304 # * [Global](/compute/docs/reference/rest/v1/globalOperations)
11305 # * [Regional](/compute/docs/reference/rest/v1/regionOperations)
11306 # * [Zonal](/compute/docs/reference/rest/v1/zoneOperations)
11307 #
11308 # You can use an operation resource to manage asynchronous API requests.
11309 # For more information, readHandling
11310 # API responses.
11311 #
11312 # Operations can be global, regional or zonal.
11313 #
11314 # - For global operations, use the `globalOperations`
11315 # resource.
11316 # - For regional operations, use the
11317 # `regionOperations` resource.
11318 # - For zonal operations, use
11319 # the `zoneOperations` resource.
11320 #
11321 #
11322 #
11323 # For more information, read
11324 # Global, Regional, and Zonal Resources.
11325 #
11326 # Note that completed Operation resources have a limited
11327 # retention period.
11328 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
11329 # Not present otherwise.
11330 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
11331 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
11332 # set when the operation is created.
11333 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
11334 # text format.
11335 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
11336 # this field will be populated.
11337 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
11338 # operation.
11339 {
11340 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
11341 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
11342 # details. There is a set of defined message types to use for providing
11343 # details.The syntax depends on the error code. For example,
11344 # QuotaExceededInfo will have details when the error code is
11345 # QUOTA_EXCEEDED.
11346 {
11347 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
11348 #
11349 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
11350 # is not enabled:
11351 #
11352 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
11353 # &quot;domain&quot;: &quot;googleapis.com&quot;
11354 # &quot;metadata&quot;: {
11355 # &quot;resource&quot;: &quot;projects/123&quot;,
11356 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
11357 # }
11358 # }
11359 #
11360 # This response indicates that the pubsub.googleapis.com API is not enabled.
11361 #
11362 # Example of an error that is returned when attempting to create a Spanner
11363 # instance in a region that is out of stock:
11364 #
11365 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
11366 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
11367 # &quot;metadata&quot;: {
11368 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
11369 # }
11370 # }
11371 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
11372 # is typically the registered service name of the tool or product that
11373 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
11374 # generated by some common infrastructure, the error domain must be a
11375 # globally unique value that identifies the infrastructure. For Google API
11376 # infrastructure, the error domain is &quot;googleapis.com&quot;.
11377 &quot;metadatas&quot;: { # Additional structured details about this error.
11378 #
11379 # Keys must match a regular expression of `a-z+` but should
11380 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
11381 # length. When identifying the current value of an exceeded limit, the units
11382 # should be contained in the key, not the value. For example, rather than
11383 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
11384 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
11385 # instances that can be created in a single (batch) request.
11386 &quot;a_key&quot;: &quot;A String&quot;,
11387 },
11388 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
11389 # proximate cause of the error. Error reasons are unique within a particular
11390 # domain of errors. This should be at most 63 characters and match a
11391 # regular expression of `A-Z+[A-Z0-9]`, which represents
11392 # UPPER_SNAKE_CASE.
11393 },
11394 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
11395 #
11396 # For example, if a quota check failed with an error indicating the calling
11397 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
11398 # directly to the right place in the developer console to flip the bit.
11399 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
11400 { # Describes a URL link.
11401 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
11402 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
11403 },
11404 ],
11405 },
11406 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
11407 # which can be attached to an RPC error.
11408 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
11409 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
11410 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
11411 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
11412 },
11413 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
11414 &quot;dimensions&quot;: { # The map holding related quota dimensions.
11415 &quot;a_key&quot;: &quot;A String&quot;,
11416 },
11417 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
11418 # type or metric.
11419 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
11420 # or metric.
11421 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
11422 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
11423 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
11424 },
11425 },
11426 ],
11427 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
11428 # This property is optional.
11429 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
11430 },
11431 ],
11432 },
11433 &quot;getVersionOperationMetadata&quot;: {
11434 &quot;inlineSbomInfo&quot;: {
11435 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
11436 # appropriate identifiers.
11437 &quot;a_key&quot;: &quot;A String&quot;,
11438 },
11439 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
11440 # identifiers.
11441 &quot;a_key&quot;: &quot;A String&quot;,
11442 },
11443 },
11444 },
11445 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
11446 # message that was returned, such as `NOT FOUND`.
11447 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
11448 # status code that was returned. For example, a `404` means the
11449 # resource was not found.
11450 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
11451 # defined by the server.
11452 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
11453 # This value is inRFC3339
11454 # text format.
11455 &quot;instancesBulkInsertOperationMetadata&quot;: {
11456 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
11457 # Example key: zones/us-central1-a
11458 &quot;a_key&quot;: {
11459 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
11460 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
11461 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
11462 # error.
11463 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
11464 # if the flow is rolling forward or rolling back.
11465 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
11466 },
11467 },
11468 },
11469 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
11470 # Operation resources.
11471 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
11472 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
11473 # group of operations results from a `bulkInsert` API request.
11474 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
11475 # `update`, or `delete`, and so on.
11476 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
11477 # There is no requirement that this be linear or support any granularity of
11478 # operations. This should not be used to guess when the operation will be
11479 # complete. This number should monotonically increase as the operation
11480 # progresses.
11481 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
11482 # applicable when performing regional operations.
11483 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
11484 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
11485 # this field will contain information on all underlying zonal actions and
11486 # their state.
11487 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
11488 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
11489 # Example key: zones/us-central1-a
11490 &quot;a_key&quot;: {
11491 &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
11492 # populated.
11493 # different programming environments, including REST APIs and RPC APIs. It is
11494 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
11495 # three pieces of data: error code, error message, and error details.
11496 #
11497 # You can find out more about this error model and how to work with it in the
11498 # [API Design Guide](https://cloud.google.com/apis/design/errors).
11499 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
11500 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
11501 # message types for APIs to use.
11502 {
11503 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
11504 },
11505 ],
11506 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
11507 # user-facing error message should be localized and sent in the
11508 # google.rpc.Status.details field, or localized by the client.
11509 },
11510 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
11511 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
11512 },
11513 },
11514 },
11515 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
11516 # This value is inRFC3339
11517 # text format.
11518 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
11519 # following:
11520 # `PENDING`, `RUNNING`, or `DONE`.
11521 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
11522 # operation.
11523 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
11524 # of the target resource.
11525 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
11526 # operations related to creating a snapshot, this points to the disk
11527 # that the snapshot was created from.
11528 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
11529 # `[email protected]` or
11530 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
11531 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
11532 # operation, this field will be populated.
11533 {
11534 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
11535 # Engine returns NO_RESULTS_ON_PAGE if there
11536 # are no results in the response.
11537 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
11538 # value format. For example:
11539 #
11540 # &quot;data&quot;: [
11541 # {
11542 # &quot;key&quot;: &quot;scope&quot;,
11543 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
11544 # }
11545 {
11546 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
11547 # returned. For example, for warnings where there are no results in a list
11548 # request for a particular zone, this key might be scope and
11549 # the key value might be the zone name. Other examples might be a key
11550 # indicating a deprecated resource and a suggested replacement, or a
11551 # warning about invalid network settings (for example, if an instance
11552 # attempts to perform IP forwarding but is not enabled for IP forwarding).
11553 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
11554 },
11555 ],
11556 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
11557 },
11558 ],
11559 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
11560 # applicable when performing per-zone operations.
11561 }</pre>
11562 </div>
11563
11564 <div class="method">
11565 <code class="details" id="invalidateCache">invalidateCache(project, urlMap, body=None, requestId=None, x__xgafv=None)</code>
11566 <pre>Initiates a cache invalidation operation, invalidating the specified path,
11567 scoped to the specified UrlMap.
11568
11569 For more information, see [Invalidating cached
11570 content](/cdn/docs/invalidating-cached-content).
11571
11572 Args:
11573 project: string, Project ID for this request. (required)
11574 urlMap: string, Name of the UrlMap scoping this request. (required)
11575 body: object, The request body.
11576 The object takes the form of:
11577
11578 {
11579 &quot;cacheTags&quot;: [ # A list of cache tags used to identify cached objects.
11580 #
11581 #
11582 # - Cache tags are specified when the response is first cached, by setting
11583 # the `Cache-Tag` response header at the origin.
11584 # - Multiple cache tags in the same invalidation request are treated as
11585 # Boolean `OR` - for example, `tag1 OR tag2 OR tag3`.
11586 # - If other fields are also specified, these are treated as Boolean `AND`
11587 # with any tags.
11588 #
11589 #
11590 # Up to 10 tags can be specified in a single invalidation request.
11591 &quot;A String&quot;,
11592 ],
11593 &quot;host&quot;: &quot;A String&quot;, # If set, this invalidation rule will only apply to requests with a Host
11594 # header matching host.
11595 &quot;path&quot;: &quot;A String&quot;,
11596 }
11597
11598 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
11599 that if you must retry your request, the server will know to ignore the
11600 request if it has already been completed.
11601
11602 For example, consider a situation where you make an initial request and
11603 the request times out. If you make the request again with the same
11604 request ID, the server can check if original operation with the same
11605 request ID was received, and if so, will ignore the second request. This
11606 prevents clients from accidentally creating duplicate commitments.
11607
11608 The request ID must be
11609 a valid UUID with the exception that zero UUID is not supported
11610 (00000000-0000-0000-0000-000000000000).
11611 x__xgafv: string, V1 error format.
11612 Allowed values
11613 1 - v1 error format
11614 2 - v2 error format
11615
11616 Returns:
11617 An object of the form:
11618
11619 { # Represents an Operation resource.
11620 #
11621 # Google Compute Engine has three Operation resources:
11622 #
11623 # * [Global](/compute/docs/reference/rest/v1/globalOperations)
11624 # * [Regional](/compute/docs/reference/rest/v1/regionOperations)
11625 # * [Zonal](/compute/docs/reference/rest/v1/zoneOperations)
11626 #
11627 # You can use an operation resource to manage asynchronous API requests.
11628 # For more information, readHandling
11629 # API responses.
11630 #
11631 # Operations can be global, regional or zonal.
11632 #
11633 # - For global operations, use the `globalOperations`
11634 # resource.
11635 # - For regional operations, use the
11636 # `regionOperations` resource.
11637 # - For zonal operations, use
11638 # the `zoneOperations` resource.
11639 #
11640 #
11641 #
11642 # For more information, read
11643 # Global, Regional, and Zonal Resources.
11644 #
11645 # Note that completed Operation resources have a limited
11646 # retention period.
11647 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
11648 # Not present otherwise.
11649 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
11650 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
11651 # set when the operation is created.
11652 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
11653 # text format.
11654 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
11655 # this field will be populated.
11656 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
11657 # operation.
11658 {
11659 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
11660 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
11661 # details. There is a set of defined message types to use for providing
11662 # details.The syntax depends on the error code. For example,
11663 # QuotaExceededInfo will have details when the error code is
11664 # QUOTA_EXCEEDED.
11665 {
11666 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
11667 #
11668 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
11669 # is not enabled:
11670 #
11671 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
11672 # &quot;domain&quot;: &quot;googleapis.com&quot;
11673 # &quot;metadata&quot;: {
11674 # &quot;resource&quot;: &quot;projects/123&quot;,
11675 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
11676 # }
11677 # }
11678 #
11679 # This response indicates that the pubsub.googleapis.com API is not enabled.
11680 #
11681 # Example of an error that is returned when attempting to create a Spanner
11682 # instance in a region that is out of stock:
11683 #
11684 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
11685 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
11686 # &quot;metadata&quot;: {
11687 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
11688 # }
11689 # }
11690 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
11691 # is typically the registered service name of the tool or product that
11692 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
11693 # generated by some common infrastructure, the error domain must be a
11694 # globally unique value that identifies the infrastructure. For Google API
11695 # infrastructure, the error domain is &quot;googleapis.com&quot;.
11696 &quot;metadatas&quot;: { # Additional structured details about this error.
11697 #
11698 # Keys must match a regular expression of `a-z+` but should
11699 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
11700 # length. When identifying the current value of an exceeded limit, the units
11701 # should be contained in the key, not the value. For example, rather than
11702 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
11703 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
11704 # instances that can be created in a single (batch) request.
11705 &quot;a_key&quot;: &quot;A String&quot;,
11706 },
11707 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
11708 # proximate cause of the error. Error reasons are unique within a particular
11709 # domain of errors. This should be at most 63 characters and match a
11710 # regular expression of `A-Z+[A-Z0-9]`, which represents
11711 # UPPER_SNAKE_CASE.
11712 },
11713 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
11714 #
11715 # For example, if a quota check failed with an error indicating the calling
11716 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
11717 # directly to the right place in the developer console to flip the bit.
11718 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
11719 { # Describes a URL link.
11720 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
11721 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
11722 },
11723 ],
11724 },
11725 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
11726 # which can be attached to an RPC error.
11727 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
11728 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
11729 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
11730 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
11731 },
11732 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
11733 &quot;dimensions&quot;: { # The map holding related quota dimensions.
11734 &quot;a_key&quot;: &quot;A String&quot;,
11735 },
11736 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
11737 # type or metric.
11738 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
11739 # or metric.
11740 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
11741 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
11742 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
11743 },
11744 },
11745 ],
11746 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
11747 # This property is optional.
11748 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
11749 },
11750 ],
11751 },
11752 &quot;getVersionOperationMetadata&quot;: {
11753 &quot;inlineSbomInfo&quot;: {
11754 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
11755 # appropriate identifiers.
11756 &quot;a_key&quot;: &quot;A String&quot;,
11757 },
11758 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
11759 # identifiers.
11760 &quot;a_key&quot;: &quot;A String&quot;,
11761 },
11762 },
11763 },
11764 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
11765 # message that was returned, such as `NOT FOUND`.
11766 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
11767 # status code that was returned. For example, a `404` means the
11768 # resource was not found.
11769 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
11770 # defined by the server.
11771 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
11772 # This value is inRFC3339
11773 # text format.
11774 &quot;instancesBulkInsertOperationMetadata&quot;: {
11775 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
11776 # Example key: zones/us-central1-a
11777 &quot;a_key&quot;: {
11778 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
11779 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
11780 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
11781 # error.
11782 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
11783 # if the flow is rolling forward or rolling back.
11784 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
11785 },
11786 },
11787 },
11788 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
11789 # Operation resources.
11790 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
11791 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
11792 # group of operations results from a `bulkInsert` API request.
11793 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
11794 # `update`, or `delete`, and so on.
11795 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
11796 # There is no requirement that this be linear or support any granularity of
11797 # operations. This should not be used to guess when the operation will be
11798 # complete. This number should monotonically increase as the operation
11799 # progresses.
11800 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
11801 # applicable when performing regional operations.
11802 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
11803 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
11804 # this field will contain information on all underlying zonal actions and
11805 # their state.
11806 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
11807 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
11808 # Example key: zones/us-central1-a
11809 &quot;a_key&quot;: {
11810 &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
11811 # populated.
11812 # different programming environments, including REST APIs and RPC APIs. It is
11813 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
11814 # three pieces of data: error code, error message, and error details.
11815 #
11816 # You can find out more about this error model and how to work with it in the
11817 # [API Design Guide](https://cloud.google.com/apis/design/errors).
11818 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
11819 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
11820 # message types for APIs to use.
11821 {
11822 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
11823 },
11824 ],
11825 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
11826 # user-facing error message should be localized and sent in the
11827 # google.rpc.Status.details field, or localized by the client.
11828 },
11829 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
11830 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
11831 },
11832 },
11833 },
11834 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
11835 # This value is inRFC3339
11836 # text format.
11837 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
11838 # following:
11839 # `PENDING`, `RUNNING`, or `DONE`.
11840 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
11841 # operation.
11842 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
11843 # of the target resource.
11844 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
11845 # operations related to creating a snapshot, this points to the disk
11846 # that the snapshot was created from.
11847 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
11848 # `[email protected]` or
11849 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
11850 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
11851 # operation, this field will be populated.
11852 {
11853 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
11854 # Engine returns NO_RESULTS_ON_PAGE if there
11855 # are no results in the response.
11856 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
11857 # value format. For example:
11858 #
11859 # &quot;data&quot;: [
11860 # {
11861 # &quot;key&quot;: &quot;scope&quot;,
11862 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
11863 # }
11864 {
11865 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
11866 # returned. For example, for warnings where there are no results in a list
11867 # request for a particular zone, this key might be scope and
11868 # the key value might be the zone name. Other examples might be a key
11869 # indicating a deprecated resource and a suggested replacement, or a
11870 # warning about invalid network settings (for example, if an instance
11871 # attempts to perform IP forwarding but is not enabled for IP forwarding).
11872 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
11873 },
11874 ],
11875 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
11876 },
11877 ],
11878 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
11879 # applicable when performing per-zone operations.
11880 }</pre>
11881 </div>
11882
11883 <div class="method">
11884 <code class="details" id="list">list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</code>
11885 <pre>Retrieves the list of UrlMap resources available to the specified
11886 project.
11887
11888 Args:
11889 project: string, Project ID for this request. (required)
11890 filter: string, A filter expression that filters resources listed in the response. Most
11891 Compute resources support two types of filter expressions:
11892 expressions that support regular expressions and expressions that follow
11893 API improvement proposal AIP-160.
11894 These two types of filter expressions cannot be mixed in one request.
11895
11896 If you want to use AIP-160, your expression must specify the field name, an
11897 operator, and the value that you want to use for filtering. The value
11898 must be a string, a number, or a boolean. The operator
11899 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
11900
11901 For example, if you are filtering Compute Engine instances, you can
11902 exclude instances named `example-instance` by specifying
11903 `name != example-instance`.
11904
11905 The `:*` comparison can be used to test whether a key has been defined.
11906 For example, to find all objects with `owner` label use:
11907 ```
11908 labels.owner:*
11909 ```
11910
11911 You can also filter nested fields. For example, you could specify
11912 `scheduling.automaticRestart = false` to include instances only
11913 if they are not scheduled for automatic restarts. You can use filtering
11914 on nested fields to filter based onresource labels.
11915
11916 To filter on multiple expressions, provide each separate expression within
11917 parentheses. For example:
11918 ```
11919 (scheduling.automaticRestart = true)
11920 (cpuPlatform = &quot;Intel Skylake&quot;)
11921 ```
11922 By default, each expression is an `AND` expression. However, you
11923 can include `AND` and `OR` expressions explicitly.
11924 For example:
11925 ```
11926 (cpuPlatform = &quot;Intel Skylake&quot;) OR
11927 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
11928 (scheduling.automaticRestart = true)
11929 ```
11930
11931 If you want to use a regular expression, use the `eq` (equal) or `ne`
11932 (not equal) operator against a single un-parenthesized expression with or
11933 without quotes or against multiple parenthesized expressions. Examples:
11934
11935 `fieldname eq unquoted literal`
11936 `fieldname eq &#x27;single quoted literal&#x27;`
11937 `fieldname eq &quot;double quoted literal&quot;`
11938 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
11939
11940 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
11941 The literal value must match the entire field.
11942
11943 For example, to filter for instances that do not end with name &quot;instance&quot;,
11944 you would use `name ne .*instance`.
11945
11946 You cannot combine constraints on multiple fields using regular
11947 expressions.
11948 maxResults: integer, The maximum number of results per page that should be returned.
11949 If the number of available results is larger than `maxResults`,
11950 Compute Engine returns a `nextPageToken` that can be used to get
11951 the next page of results in subsequent list requests. Acceptable values are
11952 `0` to `500`, inclusive. (Default: `500`)
11953 orderBy: string, Sorts list results by a certain order. By default, results
11954 are returned in alphanumerical order based on the resource name.
11955
11956 You can also sort results in descending order based on the creation
11957 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
11958 results based on the `creationTimestamp` field in
11959 reverse chronological order (newest result first). Use this to sort
11960 resources like operations so that the newest operation is returned first.
11961
11962 Currently, only sorting by `name` or
11963 `creationTimestamp desc` is supported.
11964 pageToken: string, Specifies a page token to use. Set `pageToken` to the
11965 `nextPageToken` returned by a previous list request to get
11966 the next page of results.
11967 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
11968 of failure. The default value is false.
11969
11970 For example, when partial success behavior is enabled, aggregatedList for a
11971 single zone scope either returns all resources in the zone or no resources,
11972 with an error code.
11973 x__xgafv: string, V1 error format.
11974 Allowed values
11975 1 - v1 error format
11976 2 - v2 error format
11977
11978 Returns:
11979 An object of the form:
11980
11981 { # Contains a list of UrlMap resources.
11982 &quot;id&quot;: &quot;A String&quot;, # [Output Only] Unique identifier for the resource; defined by the server.
11983 &quot;items&quot;: [ # A list of UrlMap resources.
11984 { # Represents a URL Map resource.
11985 #
11986 # Compute Engine has two URL Map resources:
11987 #
11988 # * [Global](/compute/docs/reference/rest/v1/urlMaps)
11989 # * [Regional](/compute/docs/reference/rest/v1/regionUrlMaps)
11990 #
11991 # A URL map resource is a component of certain types of cloud load balancers
11992 # and Traffic Director:
11993 #
11994 # * urlMaps are used by global external Application Load
11995 # Balancers, classic Application Load Balancers, and cross-region internal
11996 # Application Load Balancers.
11997 # * regionUrlMaps are used by internal Application Load Balancers,
11998 # regional external Application Load Balancers and regional internal
11999 # Application Load Balancers.
12000 #
12001 # For a list of supported URL map features by the load balancer type, see the
12002 # Load balancing features: Routing and traffic management table.
12003 #
12004 # For a list of supported URL map features for Traffic Director, see the
12005 # Traffic Director features: Routing and traffic management table.
12006 #
12007 # This resource defines mappings from hostnames and URL paths to either a
12008 # backend service or a backend bucket.
12009 #
12010 # To use the global urlMaps resource, the backend service must
12011 # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
12012 # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
12013 # information, read URL
12014 # Map Concepts.
12015 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
12016 # text format.
12017 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
12018 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
12019 #
12020 # This policy takes
12021 # effect at the load balancer level and applies only when no policy has been
12022 # defined for the error code at lower levels like PathMatcher, RouteRule and
12023 # PathRule within this UrlMap.
12024 #
12025 # For example, consider a UrlMap with the
12026 # following configuration:
12027 #
12028 #
12029 # - defaultCustomErrorResponsePolicy containing policies for
12030 # responding to 5xx and 4xx errors
12031 # - A PathMatcher configured for *.example.com has
12032 # defaultCustomErrorResponsePolicy for 4xx.
12033 #
12034 # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
12035 # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
12036 # a request that does not match any host in *.example.com such
12037 # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
12038 # takes effect.
12039 #
12040 # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
12041 # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
12042 # a retry, if load balancer is successful in reaching the
12043 # service, the defaultCustomErrorResponsePolicy is ignored and
12044 # the response from the service is returned to the client.
12045 #
12046 # defaultCustomErrorResponsePolicy is supported only for
12047 # global external Application Load Balancers.
12048 # backend service or backend bucket responds with an error.
12049 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
12050 #
12051 # In a given policy, if you specify rules for both a range of error codes
12052 # as well as rules for specific error codes then rules with specific error
12053 # codes have a higher priority. For example, assume that you configure a rule
12054 # for 401 (Un-authorized) code, and another for all 4 series
12055 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
12056 # However if the backend service returns a 403, the rule for4xx takes effect.
12057 { # Specifies the mapping between the response code that will be returned along
12058 # with the custom error content and the response code returned by the backend
12059 # service.
12060 &quot;matchResponseCodes&quot;: [ # Valid values include:
12061 #
12062 #
12063 # - A number between 400 and 599: For example
12064 # 401 or 503, in which case the load balancer
12065 # applies the policy if the error code exactly matches this value.
12066 # - 5xx: Load Balancer will apply the policy if the
12067 # backend service responds with any response code in the range of
12068 # 500 to 599.
12069 # - 4xx: Load
12070 # Balancer will apply the policy if the backend service responds with any
12071 # response code in the range of 400 to
12072 # 499.
12073 #
12074 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
12075 &quot;A String&quot;,
12076 ],
12077 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
12078 # error content. If overrideResponseCode is not supplied, the
12079 # same response code returned by the original backend bucket or backend
12080 # service is returned to the client.
12081 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
12082 #
12083 # path must start
12084 # with a leading slash. path cannot have trailing slashes.
12085 #
12086 # If the file is not available in backendBucket or the
12087 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
12088 #
12089 # The value must
12090 # be from 1 to 1024 characters
12091 },
12092 ],
12093 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
12094 # contains the custom error content. Examples are:
12095 #
12096 #
12097 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
12098 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
12099 # - global/backendBuckets/myBackendBucket
12100 #
12101 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
12102 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
12103 #
12104 # If load balancer cannot reach
12105 # the backendBucket, a simple Not Found Error will
12106 # be returned, with the original response code (oroverrideResponseCode if configured).
12107 #
12108 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
12109 },
12110 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
12111 # hostRules match. The load balancer performs advanced routing
12112 # actions, such as URL rewrites and header transformations, before forwarding
12113 # the request to the selected backend.
12114 #
12115 #
12116 # Only one of defaultUrlRedirect, defaultService
12117 # or defaultRouteAction.weightedBackendService can be set.
12118 #
12119 #
12120 # URL maps for classic Application Load Balancers only support
12121 # the urlRewrite action within defaultRouteAction.
12122 #
12123 #
12124 # defaultRouteAction has no effect when the URL map is bound
12125 # to a target gRPC proxy that has the validateForProxyless field
12126 # set to true.
12127 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
12128 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
12129 # property must be specified. This policy cannot be specified if any target
12130 # backend has Identity-Aware Proxy enabled.
12131 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
12132 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
12133 # header names can be specified. The cache is bypassed for all `cacheMode`
12134 # values.
12135 &quot;A String&quot;,
12136 ],
12137 &quot;cacheKeyPolicy&quot;: { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
12138 # on the backend type: for Backend Services, the complete request URI is
12139 # used; for Backend Buckets, the request URI is used without the protocol or
12140 # host, and only query parameters known to Cloud Storage are included.
12141 # Policy defined on Route Action.
12142 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
12143 # parameters will be included. Either specify `excludedQueryParameters`
12144 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
12145 # encoded and not treated as delimiters.
12146 #
12147 # Note: This field applies to routes that use backend services. Attempting
12148 # to set it on a route that points exclusively to Backend Buckets will
12149 # result in a configuration error. For routes that point to a Backend
12150 # Bucket, use `includedQueryParameters` to define which parameters should
12151 # be part of the cache key.
12152 &quot;A String&quot;,
12153 ],
12154 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
12155 #
12156 # Note: This setting is only applicable to routes that use a Backend
12157 # Service. It does not affect requests served by a Backend Bucket, as the
12158 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
12159 # it on a route that points exclusively to Backend Buckets will result in a
12160 # configuration error.
12161 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
12162 #
12163 # Note: This setting is only applicable to routes that use a Backend
12164 # Service. It does not affect requests served by a Backend Bucket, as the
12165 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
12166 # set on a route that points exclusively to Backend Buckets will result in
12167 # a configuration error.
12168 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
12169 # `includedQueryParameters` and `excludedQueryParameters`. If neither
12170 # is set, the entire query string will be included. If false, the query
12171 # string will be excluded from the cache key entirely.
12172 #
12173 # Note: This field applies to routes that use backend services. Attempting
12174 # to set it on a route that points exclusively to Backend Buckets will
12175 # result in a configuration error. For routes that point to a Backend
12176 # Bucket, use `includedQueryParameters` to define which parameters should
12177 # be part of the cache key.
12178 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
12179 # The name=value pair will be used in the cache key Cloud CDN generates.
12180 #
12181 # Note: This setting is only applicable to routes that use a Backend
12182 # Service. It does not affect requests served by a Backend Bucket.
12183 # Attempting to set it on a route that points exclusively to Backend
12184 # Buckets will result in a configuration error. Up to 5 cookie names can be
12185 # specified.
12186 &quot;A String&quot;,
12187 ],
12188 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
12189 &quot;A String&quot;,
12190 ],
12191 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
12192 # parameters will be excluded. Either specify `includedQueryParameters`
12193 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
12194 # encoded and not treated as delimiters.
12195 &quot;A String&quot;,
12196 ],
12197 },
12198 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
12199 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
12200 &quot;clientTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
12201 # content. This is used to clamp the max-age (or Expires) value sent to the
12202 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
12203 # is used for the response max-age directive, along with a &quot;public&quot;
12204 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
12205 # clamps the max-age from the origin (if specified), or else sets the
12206 # response max-age directive to the lesser of the `clientTtl` and
12207 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
12208 # present. The maximum allowed value is 31,622,400s (1 year). If not
12209 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
12210 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
12211 # `USE_ORIGIN_HEADERS`.
12212 # as a count of seconds and fractions of seconds at nanosecond
12213 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12214 # or &quot;month&quot;. Range is approximately 10,000 years.
12215 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12216 # Durations less than one second are represented with a 0
12217 # `seconds` field and a positive `nanos` field. Must be from 0
12218 # to 999,999,999 inclusive.
12219 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12220 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12221 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12222 },
12223 &quot;defaultTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
12224 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
12225 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
12226 # greater than that of `maxTtl`. When the `cacheMode` is set to
12227 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
12228 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
12229 # accessed objects may be evicted from the cache before the defined TTL. If
12230 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
12231 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
12232 # `USE_ORIGIN_HEADERS`.
12233 # as a count of seconds and fractions of seconds at nanosecond
12234 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12235 # or &quot;month&quot;. Range is approximately 10,000 years.
12236 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12237 # Durations less than one second are represented with a 0
12238 # `seconds` field and a positive `nanos` field. Must be from 0
12239 # to 999,999,999 inclusive.
12240 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12241 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12242 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12243 },
12244 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
12245 # attempt to set a max-age or s-maxage higher than this, or an Expires header
12246 # more than `maxTtl` seconds in the future will be capped at the value of
12247 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
12248 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
12249 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
12250 # Infrequently accessed objects may be evicted from the cache before the
12251 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
12252 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
12253 # mode.
12254 # as a count of seconds and fractions of seconds at nanosecond
12255 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12256 # or &quot;month&quot;. Range is approximately 10,000 years.
12257 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12258 # Durations less than one second are represented with a 0
12259 # `seconds` field and a positive `nanos` field. Must be from 0
12260 # to 999,999,999 inclusive.
12261 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12262 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12263 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12264 },
12265 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
12266 # to apply fine-grained caching for common errors or redirects.
12267 # This can reduce the load on your origin and improve end-user
12268 # experience by reducing response latency.
12269 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
12270 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
12271 # the specified response code that lack any Cache-Control, Expires, or
12272 # Pragma: no-cache directives. When the `cacheMode` is set to
12273 # `FORCE_CACHE_ALL`, negative caching applies to all responses
12274 # with the specified response code, and overrides any caching headers. By
12275 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
12276 #
12277 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
12278 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
12279 # * 405 (Method Not Found), 501 (Not Implemented): 60s
12280 #
12281 # These defaults can be overridden in `negativeCachingPolicy`.
12282 # If not specified, Cloud CDN applies negative caching by default.
12283 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
12284 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
12285 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
12286 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
12287 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
12288 # all response codes that you wish to cache. Cloud CDN will not apply any
12289 # default negative caching when a policy exists.
12290 { # Specify CDN TTLs for response error codes.
12291 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
12292 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
12293 # specified as values, and you cannot specify a status code more than
12294 # once.
12295 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
12296 # corresponding status code.
12297 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
12298 # objects may be evicted from the cache before the defined TTL.
12299 # as a count of seconds and fractions of seconds at nanosecond
12300 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12301 # or &quot;month&quot;. Range is approximately 10,000 years.
12302 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12303 # Durations less than one second are represented with a 0
12304 # `seconds` field and a positive `nanos` field. Must be from 0
12305 # to 999,999,999 inclusive.
12306 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12307 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12308 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12309 },
12310 },
12311 ],
12312 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
12313 # requests into a small number of requests to the origin. If not specified,
12314 # Cloud CDN applies request coalescing by default.
12315 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
12316 # content with the origin, or when an error is encountered when refreshing
12317 # the cache.
12318 # This setting defines the default &quot;max-stale&quot; duration for any cached
12319 # responses that do not specify a max-stale directive. Stale responses that
12320 # exceed the TTL configured here will not be served. The default limit
12321 # (max-stale) is 86400s (1 day), which will allow stale content to be
12322 # served up to this limit beyond the max-age (or s-maxage) of a cached
12323 # response.
12324 # The maximum allowed value is 604800 (1 week).
12325 # Set this to zero (0) to disable serve-while-stale.
12326 # as a count of seconds and fractions of seconds at nanosecond
12327 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12328 # or &quot;month&quot;. Range is approximately 10,000 years.
12329 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12330 # Durations less than one second are represented with a 0
12331 # `seconds` field and a positive `nanos` field. Must be from 0
12332 # to 999,999,999 inclusive.
12333 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12334 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12335 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12336 },
12337 },
12338 &quot;corsPolicy&quot;: { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
12339 # information about the W3C recommendation for cross-origin resource sharing
12340 # (CORS), see Fetch API Living
12341 # Standard.
12342 #
12343 # Not supported when the URL map is bound to a target gRPC proxy.
12344 # information about the W3C recommendation for cross-origin resource sharing
12345 # (CORS), see Fetch API Living
12346 # Standard.
12347 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
12348 # indicates that
12349 # the actual request can include user credentials. This field translates to
12350 # the Access-Control-Allow-Credentials header.
12351 #
12352 # Default is false.
12353 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
12354 # header.
12355 &quot;A String&quot;,
12356 ],
12357 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
12358 # header.
12359 &quot;A String&quot;,
12360 ],
12361 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
12362 # more information, see regular expression syntax.
12363 #
12364 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
12365 #
12366 # Regular expressions can only be used when the loadBalancingScheme is
12367 # set to INTERNAL_SELF_MANAGED.
12368 &quot;A String&quot;,
12369 ],
12370 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
12371 #
12372 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
12373 &quot;A String&quot;,
12374 ],
12375 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
12376 # The default value is false, which indicates that the CORS
12377 # policy is in effect.
12378 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
12379 # header.
12380 &quot;A String&quot;,
12381 ],
12382 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
12383 # seconds. This field translates to the Access-Control-Max-Age
12384 # header.
12385 },
12386 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
12387 # the resiliency of clients to backend service failure. As part of fault
12388 # injection, when clients send requests to a backend service, delays can be
12389 # introduced by a load balancer on a percentage of requests before sending
12390 # those requests to the backend service. Similarly requests from clients can
12391 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
12392 # that are configured with a fault_injection_policy if:
12393 # 1. The traffic is generated by fault injection AND
12394 # 2. The fault injection is not a delay fault injection.
12395 # Fault injection is not supported with the classic Application Load Balancer
12396 # . To see which load balancers support fault injection,
12397 # see Load
12398 # balancing: Routing and traffic management features.
12399 # the resiliency of clients to backend service failure. As part of fault
12400 # injection, when clients send requests to a backend service, delays can be
12401 # introduced by the load balancer on a percentage of requests before sending
12402 # those request to the backend service. Similarly requests from clients can be
12403 # aborted by the load balancer for a percentage of requests.
12404 &quot;abort&quot;: { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
12405 # injection.
12406 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
12407 #
12408 # The value must be from 200 to 599 inclusive.
12409 #
12410 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
12411 # according to this
12412 # mapping table. HTTP status 200 is mapped to gRPC status
12413 # UNKNOWN. Injecting an OK status is currently not supported by
12414 # Traffic Director.
12415 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
12416 # that is aborted as part of fault injection.
12417 #
12418 # The value must be from 0.0 to 100.0 inclusive.
12419 },
12420 &quot;delay&quot;: { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
12421 # injection, before being sent to a backend service.
12422 # request to the backend service as part of fault injection.
12423 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
12424 # as a count of seconds and fractions of seconds at nanosecond
12425 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12426 # or &quot;month&quot;. Range is approximately 10,000 years.
12427 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12428 # Durations less than one second are represented with a 0
12429 # `seconds` field and a positive `nanos` field. Must be from 0
12430 # to 999,999,999 inclusive.
12431 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12432 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12433 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12434 },
12435 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
12436 # which a delay is introduced as part of fault injection.
12437 #
12438 # The value must be from 0.0 to 100.0 inclusive.
12439 },
12440 },
12441 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
12442 # Unlike the timeout field where the timeout duration starts
12443 # from the time the request has been fully processed (known as*end-of-stream*),
12444 # the duration in this field is computed from the beginning of the stream
12445 # until the response has been processed, including all retries. A
12446 # stream that does not complete in this duration is closed.
12447 #
12448 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
12449 # with the route.
12450 #
12451 # This field is only allowed if the Url map is used with backend services
12452 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
12453 # as a count of seconds and fractions of seconds at nanosecond
12454 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12455 # or &quot;month&quot;. Range is approximately 10,000 years.
12456 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12457 # Durations less than one second are represented with a 0
12458 # `seconds` field and a positive `nanos` field. Must be from 0
12459 # to 999,999,999 inclusive.
12460 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12461 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12462 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12463 },
12464 &quot;requestMirrorPolicy&quot;: { # A policy that specifies how requests intended for the route&#x27;s backends # Specifies the policy on how requests intended for the route&#x27;s backends
12465 # are shadowed to a separate mirrored backend service. The load balancer does
12466 # not wait for responses from the shadow service. Before sending traffic
12467 # to the shadow service, the host / authority header is suffixed with-shadow.
12468 #
12469 # Not supported when the URL map is bound to a target gRPC proxy that
12470 # has the validateForProxyless field set to true.
12471 # are shadowed to a separate mirrored backend service. The load balancer
12472 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
12473 # to the shadow service, the host or authority header is suffixed with-shadow.
12474 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
12475 # mirrored to.
12476 #
12477 # The backend service configured for a mirroring
12478 # policy must reference backends that are of the same type as the original
12479 # backend service matched in the URL map.
12480 #
12481 # Serverless NEG backends are not currently supported as a mirrored
12482 # backend service.
12483 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
12484 },
12485 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
12486 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
12487 # If not specified, defaults to 1.
12488 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
12489 #
12490 # If not specified, will use the timeout set in theHttpRouteAction field.
12491 # If timeout in the HttpRouteAction field is not set, this field
12492 # uses the largest timeout
12493 # among all backend services associated with the route.
12494 #
12495 # Not supported when the URL map is bound to a target gRPC proxy that
12496 # has the validateForProxyless field set to true.
12497 # as a count of seconds and fractions of seconds at nanosecond
12498 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12499 # or &quot;month&quot;. Range is approximately 10,000 years.
12500 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12501 # Durations less than one second are represented with a 0
12502 # `seconds` field and a positive `nanos` field. Must be from 0
12503 # to 999,999,999 inclusive.
12504 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12505 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12506 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12507 },
12508 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
12509 # values are:
12510 #
12511 # - 5xx: retry is attempted if the instance or endpoint
12512 # responds with any 5xx response code, or if the instance or
12513 # endpoint does not respond at all. For example, disconnects, reset, read
12514 # timeout, connection failure, and refused streams.
12515 # - gateway-error: Similar to 5xx, but only
12516 # applies to response codes 502, 503 or504.
12517 # - connect-failure: a retry is attempted on failures
12518 # connecting to the instance or endpoint. For example, connection
12519 # timeouts.
12520 # - retriable-4xx: a retry is attempted if the instance
12521 # or endpoint responds with a 4xx response code.
12522 # The only error that you can retry is error code 409.
12523 # - refused-stream: a retry is attempted if the instance
12524 # or endpoint resets the stream with a REFUSED_STREAM error
12525 # code. This reset type indicates that it is safe to retry.
12526 # - cancelled: a retry is attempted if the gRPC status
12527 # code in the response header is set to cancelled.
12528 # - deadline-exceeded: a retry is attempted if the gRPC
12529 # status code in the response header is set todeadline-exceeded.
12530 # - internal: a retry is attempted if the gRPC
12531 # status code in the response header is set tointernal.
12532 # - resource-exhausted: a retry is attempted if the gRPC
12533 # status code in the response header is set toresource-exhausted.
12534 # - unavailable: a retry is attempted if the gRPC
12535 # status code in the response header is set tounavailable.
12536 #
12537 # Only the following codes are supported when the URL map is bound to
12538 # target gRPC proxy that has validateForProxyless field set to true.
12539 #
12540 # - cancelled
12541 # - deadline-exceeded
12542 # - internal
12543 # - resource-exhausted
12544 # - unavailable
12545 &quot;A String&quot;,
12546 ],
12547 },
12548 &quot;timeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
12549 # time the request has been fully processed (known as *end-of-stream*)
12550 # up until the response has been processed. Timeout includes
12551 # all retries.
12552 #
12553 # If not specified, this field uses the largest timeout among all backend
12554 # services associated with the route.
12555 #
12556 # Not supported when the URL map is bound to a target gRPC proxy that
12557 # has validateForProxyless field set to true.
12558 # as a count of seconds and fractions of seconds at nanosecond
12559 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12560 # or &quot;month&quot;. Range is approximately 10,000 years.
12561 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12562 # Durations less than one second are represented with a 0
12563 # `seconds` field and a positive `nanos` field. Must be from 0
12564 # to 999,999,999 inclusive.
12565 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12566 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12567 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12568 },
12569 &quot;urlRewrite&quot;: { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
12570 # to the matched service.
12571 #
12572 # urlRewrite is the only action supported in UrlMaps
12573 # for classic Application Load Balancers.
12574 #
12575 # Not supported when the URL map is bound to a target gRPC proxy that
12576 # has the validateForProxyless field set to true.
12577 # backend service.
12578 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
12579 # host header is replaced with contents of hostRewrite.
12580 #
12581 # The value must be from 1 to 255 characters.
12582 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
12583 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
12584 #
12585 # The value must be from 1 to 1024 characters.
12586 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
12587 # header) using the HTTP template syntax.
12588 #
12589 # A corresponding
12590 # path_template_match must be specified. Any template variables must exist in
12591 # the path_template_match field.
12592 #
12593 #
12594 # - -At least one variable must be specified in the path_template_match
12595 # field
12596 # - You can omit variables from the rewritten URL
12597 # - The * and ** operators cannot be matched
12598 # unless they have a corresponding variable name - e.g.
12599 # {format=*} or {var=**}.
12600 #
12601 # For example, a path_template_match of /static/{format=**}
12602 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
12603 # rewrite, so that /{country}/{format}/{suffix=**} can be
12604 # rewritten as /content/{format}/{country}/{suffix}.
12605 #
12606 # At least
12607 # one non-empty routeRules[].matchRules[].path_template_match is
12608 # required.
12609 #
12610 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
12611 },
12612 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
12613 # occurs. The weights determine the fraction of traffic that flows to
12614 # their corresponding backend service. If all traffic needs to
12615 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
12616 #
12617 # After a backend service is identified and before forwarding
12618 # the request to
12619 # the backend service, advanced routing actions such as URL rewrites and
12620 # header transformations are applied depending on additional settings
12621 # specified in this HttpRouteAction.
12622 { # In contrast to a single BackendService in
12623 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
12624 # multiple backend services. The volume of traffic for each
12625 # backend service is proportional to the weight specified
12626 # in each WeightedBackendService
12627 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
12628 # resource. Before
12629 # forwarding the request to backendService, the load balancer
12630 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
12631 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
12632 # effect for the selected backendService.
12633 #
12634 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
12635 #
12636 # headerAction is not supported for load balancers that have
12637 # their loadBalancingScheme set to EXTERNAL.
12638 #
12639 # Not supported when the URL map is bound to a target gRPC proxy that
12640 # has validateForProxyless field set to true.
12641 # the request is passed along to the selected backendService.
12642 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
12643 { # Specification determining how headers are added to requests or responses.
12644 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
12645 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
12646 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
12647 # that already
12648 # exist for the header. If true, headerValue is set for the
12649 # header, discarding any values that were set for that header.
12650 #
12651 # The default value is true,
12652 # unless a variable is present in headerValue,
12653 # in which case the default value is false.
12654 # .
12655 },
12656 ],
12657 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
12658 # request before forwarding the request to the backendService.
12659 &quot;A String&quot;,
12660 ],
12661 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
12662 # client.
12663 { # Specification determining how headers are added to requests or responses.
12664 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
12665 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
12666 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
12667 # that already
12668 # exist for the header. If true, headerValue is set for the
12669 # header, discarding any values that were set for that header.
12670 #
12671 # The default value is true,
12672 # unless a variable is present in headerValue,
12673 # in which case the default value is false.
12674 # .
12675 },
12676 ],
12677 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
12678 # response before sending the response back to the client.
12679 &quot;A String&quot;,
12680 ],
12681 },
12682 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
12683 # computed asweight / (sum of all weightedBackendService weights in routeAction).
12684 #
12685 # The selection of a backend service is determined only for new traffic.
12686 # Once a user&#x27;s request has been directed to a backend service,
12687 # subsequent requests are sent to the same backend service as
12688 # determined by the backend service&#x27;s session affinity policy.
12689 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
12690 # splitting. If you do, the weighted traffic splitting configuration takes
12691 # precedence.
12692 #
12693 # The value must be from 0 to 1000.
12694 },
12695 ],
12696 },
12697 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL of the defaultService resource to
12698 # which traffic is directed if none of the hostRules match.
12699 # If defaultRouteAction is also specified, advanced
12700 # routing actions, such as URL rewrites, take effect before sending the
12701 # request to the backend.
12702 #
12703 #
12704 # Only one of defaultUrlRedirect, defaultService
12705 # or defaultRouteAction.weightedBackendService can be set.
12706 #
12707 #
12708 # defaultService has no effect when the URL map is bound
12709 # to a target gRPC proxy that has the validateForProxyless field
12710 # set to true.
12711 &quot;defaultUrlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
12712 # is redirected to a URL specified by defaultUrlRedirect.
12713 #
12714 #
12715 # Only one of defaultUrlRedirect, defaultService
12716 # or defaultRouteAction.weightedBackendService can be set.
12717 #
12718 #
12719 # Not supported when the URL map is bound to a target gRPC proxy.
12720 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
12721 # was supplied in the request.
12722 #
12723 # The value must be from 1 to 255
12724 # characters.
12725 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
12726 # set to HTTPS.
12727 # If set to false, the URL scheme of the redirected request
12728 # remains the same as that of the request.
12729 #
12730 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
12731 #
12732 # The default is set to false.
12733 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
12734 # that was supplied in the request.
12735 #
12736 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
12737 # supplied, the path of the original request is used for the redirect.
12738 #
12739 # The value must be from 1 to 1024 characters.
12740 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
12741 # the HttpRouteRuleMatch, retaining the remaining portion
12742 # of the URL before redirecting the request.
12743 #
12744 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
12745 # supplied, the path of the original request is used for the redirect.
12746 #
12747 # The value must be from 1 to 1024 characters.
12748 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
12749 #
12750 # Supported values are:
12751 #
12752 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
12753 # to 301.
12754 # - FOUND, which corresponds to 302.
12755 # - SEE_OTHER which corresponds to 303.
12756 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
12757 # method is retained.
12758 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
12759 # method is retained.
12760 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
12761 # URL is
12762 # removed before redirecting the request. If set to false, the
12763 # query portion of the original URL is retained.
12764 #
12765 # The default is set to false.
12766 },
12767 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
12768 # create the resource.
12769 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. A hash of the contents stored in this object.
12770 # This field is used in optimistic locking. This field is ignored when
12771 # inserting a UrlMap. An up-to-date fingerprint must be provided
12772 # in order to update the UrlMap, otherwise the request will
12773 # fail with error 412 conditionNotMet.
12774 #
12775 # To see the latest fingerprint, make a get() request to
12776 # retrieve a UrlMap.
12777 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
12778 # for the selected backendService.
12779 #
12780 # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
12781 #
12782 # headerAction is not supported for load balancers
12783 # that have
12784 # their loadBalancingScheme set to EXTERNAL.
12785 #
12786 # Not supported when the URL map is bound to a target gRPC proxy that
12787 # has validateForProxyless field set to true.
12788 # the request is passed along to the selected backendService.
12789 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
12790 { # Specification determining how headers are added to requests or responses.
12791 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
12792 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
12793 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
12794 # that already
12795 # exist for the header. If true, headerValue is set for the
12796 # header, discarding any values that were set for that header.
12797 #
12798 # The default value is true,
12799 # unless a variable is present in headerValue,
12800 # in which case the default value is false.
12801 # .
12802 },
12803 ],
12804 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
12805 # request before forwarding the request to the backendService.
12806 &quot;A String&quot;,
12807 ],
12808 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
12809 # client.
12810 { # Specification determining how headers are added to requests or responses.
12811 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
12812 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
12813 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
12814 # that already
12815 # exist for the header. If true, headerValue is set for the
12816 # header, discarding any values that were set for that header.
12817 #
12818 # The default value is true,
12819 # unless a variable is present in headerValue,
12820 # in which case the default value is false.
12821 # .
12822 },
12823 ],
12824 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
12825 # response before sending the response back to the client.
12826 &quot;A String&quot;,
12827 ],
12828 },
12829 &quot;hostRules&quot;: [ # The list of host rules to use against the URL.
12830 { # UrlMaps
12831 # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
12832 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
12833 # create the resource.
12834 &quot;hosts&quot;: [ # The list of host patterns to match. They must be valid hostnames with
12835 # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
12836 # that case, * must be the first character, and if followed by
12837 # anything, the immediate following character must be either -
12838 # or ..
12839 #
12840 # * based matching is not supported when the URL map is bound
12841 # to a target gRPC proxy that has the validateForProxyless field
12842 # set to true.
12843 &quot;A String&quot;,
12844 ],
12845 &quot;pathMatcher&quot;: &quot;A String&quot;, # The name of the PathMatcher to use to match the path portion
12846 # of the URL if the hostRule matches the URL&#x27;s host portion.
12847 },
12848 ],
12849 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the resource. This identifier is
12850 # defined by the server.
12851 &quot;kind&quot;: &quot;compute#urlMap&quot;, # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
12852 # url maps.
12853 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
12854 # The name must be 1-63 characters long, and comply withRFC1035.
12855 # Specifically, the name must be 1-63 characters long and match the regular
12856 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
12857 # character must be a lowercase letter, and all following characters must
12858 # be a dash, lowercase letter, or digit, except the last character, which
12859 # cannot be a dash.
12860 &quot;pathMatchers&quot;: [ # The list of named PathMatchers to use against the URL.
12861 { # A matcher for the path portion of the URL. The BackendService
12862 # from the longest-matched rule will serve the URL. If no rule was matched, the
12863 # default service is used.
12864 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
12865 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
12866 #
12867 # This policy takes
12868 # effect at the PathMatcher level and applies only when no
12869 # policy has been defined for the error code at lower levels likeRouteRule and PathRule within thisPathMatcher. If an error code does not have a policy defined
12870 # in defaultCustomErrorResponsePolicy, then a policy defined for
12871 # the error code in UrlMap.defaultCustomErrorResponsePolicy
12872 # takes effect.
12873 #
12874 # For example, consider a UrlMap with the following
12875 # configuration:
12876 #
12877 #
12878 # - UrlMap.defaultCustomErrorResponsePolicy is configured
12879 # with policies for 5xx and 4xx errors
12880 # - A RouteRule for /coming_soon/ is configured for the
12881 # error code 404.
12882 #
12883 # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher&#x27;s policy
12884 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
12885 # the policy in RouteRule.customErrorResponsePolicy takes
12886 # effect. If any of the requests in this example encounter a 500
12887 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
12888 #
12889 # When
12890 # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
12891 # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
12892 # a retry, if load balancer is successful in reaching the
12893 # service, the defaultCustomErrorResponsePolicy is ignored and
12894 # the response from the service is returned to the client.
12895 #
12896 # defaultCustomErrorResponsePolicy is supported only for
12897 # global external Application Load Balancers.
12898 # backend service or backend bucket responds with an error.
12899 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
12900 #
12901 # In a given policy, if you specify rules for both a range of error codes
12902 # as well as rules for specific error codes then rules with specific error
12903 # codes have a higher priority. For example, assume that you configure a rule
12904 # for 401 (Un-authorized) code, and another for all 4 series
12905 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
12906 # However if the backend service returns a 403, the rule for4xx takes effect.
12907 { # Specifies the mapping between the response code that will be returned along
12908 # with the custom error content and the response code returned by the backend
12909 # service.
12910 &quot;matchResponseCodes&quot;: [ # Valid values include:
12911 #
12912 #
12913 # - A number between 400 and 599: For example
12914 # 401 or 503, in which case the load balancer
12915 # applies the policy if the error code exactly matches this value.
12916 # - 5xx: Load Balancer will apply the policy if the
12917 # backend service responds with any response code in the range of
12918 # 500 to 599.
12919 # - 4xx: Load
12920 # Balancer will apply the policy if the backend service responds with any
12921 # response code in the range of 400 to
12922 # 499.
12923 #
12924 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
12925 &quot;A String&quot;,
12926 ],
12927 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
12928 # error content. If overrideResponseCode is not supplied, the
12929 # same response code returned by the original backend bucket or backend
12930 # service is returned to the client.
12931 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
12932 #
12933 # path must start
12934 # with a leading slash. path cannot have trailing slashes.
12935 #
12936 # If the file is not available in backendBucket or the
12937 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
12938 #
12939 # The value must
12940 # be from 1 to 1024 characters
12941 },
12942 ],
12943 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
12944 # contains the custom error content. Examples are:
12945 #
12946 #
12947 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
12948 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
12949 # - global/backendBuckets/myBackendBucket
12950 #
12951 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
12952 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
12953 #
12954 # If load balancer cannot reach
12955 # the backendBucket, a simple Not Found Error will
12956 # be returned, with the original response code (oroverrideResponseCode if configured).
12957 #
12958 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
12959 },
12960 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
12961 # pathRules or routeRules match. The load balancer
12962 # performs advanced routing actions, such as URL rewrites and
12963 # header transformations, before forwarding the request to the
12964 # selected backend.
12965 #
12966 #
12967 # Only one of defaultUrlRedirect, defaultService
12968 # or defaultRouteAction.weightedBackendService can be set.
12969 #
12970 #
12971 # URL maps for classic Application Load Balancers only support
12972 # the urlRewrite action within a path matcher&#x27;sdefaultRouteAction.
12973 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
12974 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
12975 # property must be specified. This policy cannot be specified if any target
12976 # backend has Identity-Aware Proxy enabled.
12977 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
12978 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
12979 # header names can be specified. The cache is bypassed for all `cacheMode`
12980 # values.
12981 &quot;A String&quot;,
12982 ],
12983 &quot;cacheKeyPolicy&quot;: { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
12984 # on the backend type: for Backend Services, the complete request URI is
12985 # used; for Backend Buckets, the request URI is used without the protocol or
12986 # host, and only query parameters known to Cloud Storage are included.
12987 # Policy defined on Route Action.
12988 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
12989 # parameters will be included. Either specify `excludedQueryParameters`
12990 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
12991 # encoded and not treated as delimiters.
12992 #
12993 # Note: This field applies to routes that use backend services. Attempting
12994 # to set it on a route that points exclusively to Backend Buckets will
12995 # result in a configuration error. For routes that point to a Backend
12996 # Bucket, use `includedQueryParameters` to define which parameters should
12997 # be part of the cache key.
12998 &quot;A String&quot;,
12999 ],
13000 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
13001 #
13002 # Note: This setting is only applicable to routes that use a Backend
13003 # Service. It does not affect requests served by a Backend Bucket, as the
13004 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
13005 # it on a route that points exclusively to Backend Buckets will result in a
13006 # configuration error.
13007 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
13008 #
13009 # Note: This setting is only applicable to routes that use a Backend
13010 # Service. It does not affect requests served by a Backend Bucket, as the
13011 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
13012 # set on a route that points exclusively to Backend Buckets will result in
13013 # a configuration error.
13014 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
13015 # `includedQueryParameters` and `excludedQueryParameters`. If neither
13016 # is set, the entire query string will be included. If false, the query
13017 # string will be excluded from the cache key entirely.
13018 #
13019 # Note: This field applies to routes that use backend services. Attempting
13020 # to set it on a route that points exclusively to Backend Buckets will
13021 # result in a configuration error. For routes that point to a Backend
13022 # Bucket, use `includedQueryParameters` to define which parameters should
13023 # be part of the cache key.
13024 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
13025 # The name=value pair will be used in the cache key Cloud CDN generates.
13026 #
13027 # Note: This setting is only applicable to routes that use a Backend
13028 # Service. It does not affect requests served by a Backend Bucket.
13029 # Attempting to set it on a route that points exclusively to Backend
13030 # Buckets will result in a configuration error. Up to 5 cookie names can be
13031 # specified.
13032 &quot;A String&quot;,
13033 ],
13034 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
13035 &quot;A String&quot;,
13036 ],
13037 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
13038 # parameters will be excluded. Either specify `includedQueryParameters`
13039 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
13040 # encoded and not treated as delimiters.
13041 &quot;A String&quot;,
13042 ],
13043 },
13044 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
13045 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
13046 &quot;clientTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
13047 # content. This is used to clamp the max-age (or Expires) value sent to the
13048 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
13049 # is used for the response max-age directive, along with a &quot;public&quot;
13050 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
13051 # clamps the max-age from the origin (if specified), or else sets the
13052 # response max-age directive to the lesser of the `clientTtl` and
13053 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
13054 # present. The maximum allowed value is 31,622,400s (1 year). If not
13055 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
13056 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
13057 # `USE_ORIGIN_HEADERS`.
13058 # as a count of seconds and fractions of seconds at nanosecond
13059 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13060 # or &quot;month&quot;. Range is approximately 10,000 years.
13061 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13062 # Durations less than one second are represented with a 0
13063 # `seconds` field and a positive `nanos` field. Must be from 0
13064 # to 999,999,999 inclusive.
13065 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13066 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13067 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13068 },
13069 &quot;defaultTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
13070 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
13071 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
13072 # greater than that of `maxTtl`. When the `cacheMode` is set to
13073 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
13074 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
13075 # accessed objects may be evicted from the cache before the defined TTL. If
13076 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
13077 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
13078 # `USE_ORIGIN_HEADERS`.
13079 # as a count of seconds and fractions of seconds at nanosecond
13080 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13081 # or &quot;month&quot;. Range is approximately 10,000 years.
13082 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13083 # Durations less than one second are represented with a 0
13084 # `seconds` field and a positive `nanos` field. Must be from 0
13085 # to 999,999,999 inclusive.
13086 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13087 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13088 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13089 },
13090 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
13091 # attempt to set a max-age or s-maxage higher than this, or an Expires header
13092 # more than `maxTtl` seconds in the future will be capped at the value of
13093 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
13094 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
13095 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
13096 # Infrequently accessed objects may be evicted from the cache before the
13097 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
13098 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
13099 # mode.
13100 # as a count of seconds and fractions of seconds at nanosecond
13101 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13102 # or &quot;month&quot;. Range is approximately 10,000 years.
13103 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13104 # Durations less than one second are represented with a 0
13105 # `seconds` field and a positive `nanos` field. Must be from 0
13106 # to 999,999,999 inclusive.
13107 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13108 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13109 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13110 },
13111 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
13112 # to apply fine-grained caching for common errors or redirects.
13113 # This can reduce the load on your origin and improve end-user
13114 # experience by reducing response latency.
13115 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
13116 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
13117 # the specified response code that lack any Cache-Control, Expires, or
13118 # Pragma: no-cache directives. When the `cacheMode` is set to
13119 # `FORCE_CACHE_ALL`, negative caching applies to all responses
13120 # with the specified response code, and overrides any caching headers. By
13121 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
13122 #
13123 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
13124 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
13125 # * 405 (Method Not Found), 501 (Not Implemented): 60s
13126 #
13127 # These defaults can be overridden in `negativeCachingPolicy`.
13128 # If not specified, Cloud CDN applies negative caching by default.
13129 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
13130 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
13131 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
13132 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
13133 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
13134 # all response codes that you wish to cache. Cloud CDN will not apply any
13135 # default negative caching when a policy exists.
13136 { # Specify CDN TTLs for response error codes.
13137 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
13138 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
13139 # specified as values, and you cannot specify a status code more than
13140 # once.
13141 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
13142 # corresponding status code.
13143 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
13144 # objects may be evicted from the cache before the defined TTL.
13145 # as a count of seconds and fractions of seconds at nanosecond
13146 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13147 # or &quot;month&quot;. Range is approximately 10,000 years.
13148 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13149 # Durations less than one second are represented with a 0
13150 # `seconds` field and a positive `nanos` field. Must be from 0
13151 # to 999,999,999 inclusive.
13152 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13153 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13154 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13155 },
13156 },
13157 ],
13158 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
13159 # requests into a small number of requests to the origin. If not specified,
13160 # Cloud CDN applies request coalescing by default.
13161 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
13162 # content with the origin, or when an error is encountered when refreshing
13163 # the cache.
13164 # This setting defines the default &quot;max-stale&quot; duration for any cached
13165 # responses that do not specify a max-stale directive. Stale responses that
13166 # exceed the TTL configured here will not be served. The default limit
13167 # (max-stale) is 86400s (1 day), which will allow stale content to be
13168 # served up to this limit beyond the max-age (or s-maxage) of a cached
13169 # response.
13170 # The maximum allowed value is 604800 (1 week).
13171 # Set this to zero (0) to disable serve-while-stale.
13172 # as a count of seconds and fractions of seconds at nanosecond
13173 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13174 # or &quot;month&quot;. Range is approximately 10,000 years.
13175 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13176 # Durations less than one second are represented with a 0
13177 # `seconds` field and a positive `nanos` field. Must be from 0
13178 # to 999,999,999 inclusive.
13179 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13180 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13181 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13182 },
13183 },
13184 &quot;corsPolicy&quot;: { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
13185 # information about the W3C recommendation for cross-origin resource sharing
13186 # (CORS), see Fetch API Living
13187 # Standard.
13188 #
13189 # Not supported when the URL map is bound to a target gRPC proxy.
13190 # information about the W3C recommendation for cross-origin resource sharing
13191 # (CORS), see Fetch API Living
13192 # Standard.
13193 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
13194 # indicates that
13195 # the actual request can include user credentials. This field translates to
13196 # the Access-Control-Allow-Credentials header.
13197 #
13198 # Default is false.
13199 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
13200 # header.
13201 &quot;A String&quot;,
13202 ],
13203 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
13204 # header.
13205 &quot;A String&quot;,
13206 ],
13207 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
13208 # more information, see regular expression syntax.
13209 #
13210 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
13211 #
13212 # Regular expressions can only be used when the loadBalancingScheme is
13213 # set to INTERNAL_SELF_MANAGED.
13214 &quot;A String&quot;,
13215 ],
13216 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
13217 #
13218 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
13219 &quot;A String&quot;,
13220 ],
13221 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
13222 # The default value is false, which indicates that the CORS
13223 # policy is in effect.
13224 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
13225 # header.
13226 &quot;A String&quot;,
13227 ],
13228 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
13229 # seconds. This field translates to the Access-Control-Max-Age
13230 # header.
13231 },
13232 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
13233 # the resiliency of clients to backend service failure. As part of fault
13234 # injection, when clients send requests to a backend service, delays can be
13235 # introduced by a load balancer on a percentage of requests before sending
13236 # those requests to the backend service. Similarly requests from clients can
13237 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
13238 # that are configured with a fault_injection_policy if:
13239 # 1. The traffic is generated by fault injection AND
13240 # 2. The fault injection is not a delay fault injection.
13241 # Fault injection is not supported with the classic Application Load Balancer
13242 # . To see which load balancers support fault injection,
13243 # see Load
13244 # balancing: Routing and traffic management features.
13245 # the resiliency of clients to backend service failure. As part of fault
13246 # injection, when clients send requests to a backend service, delays can be
13247 # introduced by the load balancer on a percentage of requests before sending
13248 # those request to the backend service. Similarly requests from clients can be
13249 # aborted by the load balancer for a percentage of requests.
13250 &quot;abort&quot;: { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
13251 # injection.
13252 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
13253 #
13254 # The value must be from 200 to 599 inclusive.
13255 #
13256 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
13257 # according to this
13258 # mapping table. HTTP status 200 is mapped to gRPC status
13259 # UNKNOWN. Injecting an OK status is currently not supported by
13260 # Traffic Director.
13261 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
13262 # that is aborted as part of fault injection.
13263 #
13264 # The value must be from 0.0 to 100.0 inclusive.
13265 },
13266 &quot;delay&quot;: { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
13267 # injection, before being sent to a backend service.
13268 # request to the backend service as part of fault injection.
13269 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
13270 # as a count of seconds and fractions of seconds at nanosecond
13271 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13272 # or &quot;month&quot;. Range is approximately 10,000 years.
13273 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13274 # Durations less than one second are represented with a 0
13275 # `seconds` field and a positive `nanos` field. Must be from 0
13276 # to 999,999,999 inclusive.
13277 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13278 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13279 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13280 },
13281 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
13282 # which a delay is introduced as part of fault injection.
13283 #
13284 # The value must be from 0.0 to 100.0 inclusive.
13285 },
13286 },
13287 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
13288 # Unlike the timeout field where the timeout duration starts
13289 # from the time the request has been fully processed (known as*end-of-stream*),
13290 # the duration in this field is computed from the beginning of the stream
13291 # until the response has been processed, including all retries. A
13292 # stream that does not complete in this duration is closed.
13293 #
13294 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
13295 # with the route.
13296 #
13297 # This field is only allowed if the Url map is used with backend services
13298 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
13299 # as a count of seconds and fractions of seconds at nanosecond
13300 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13301 # or &quot;month&quot;. Range is approximately 10,000 years.
13302 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13303 # Durations less than one second are represented with a 0
13304 # `seconds` field and a positive `nanos` field. Must be from 0
13305 # to 999,999,999 inclusive.
13306 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13307 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13308 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13309 },
13310 &quot;requestMirrorPolicy&quot;: { # A policy that specifies how requests intended for the route&#x27;s backends # Specifies the policy on how requests intended for the route&#x27;s backends
13311 # are shadowed to a separate mirrored backend service. The load balancer does
13312 # not wait for responses from the shadow service. Before sending traffic
13313 # to the shadow service, the host / authority header is suffixed with-shadow.
13314 #
13315 # Not supported when the URL map is bound to a target gRPC proxy that
13316 # has the validateForProxyless field set to true.
13317 # are shadowed to a separate mirrored backend service. The load balancer
13318 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
13319 # to the shadow service, the host or authority header is suffixed with-shadow.
13320 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
13321 # mirrored to.
13322 #
13323 # The backend service configured for a mirroring
13324 # policy must reference backends that are of the same type as the original
13325 # backend service matched in the URL map.
13326 #
13327 # Serverless NEG backends are not currently supported as a mirrored
13328 # backend service.
13329 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
13330 },
13331 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
13332 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
13333 # If not specified, defaults to 1.
13334 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
13335 #
13336 # If not specified, will use the timeout set in theHttpRouteAction field.
13337 # If timeout in the HttpRouteAction field is not set, this field
13338 # uses the largest timeout
13339 # among all backend services associated with the route.
13340 #
13341 # Not supported when the URL map is bound to a target gRPC proxy that
13342 # has the validateForProxyless field set to true.
13343 # as a count of seconds and fractions of seconds at nanosecond
13344 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13345 # or &quot;month&quot;. Range is approximately 10,000 years.
13346 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13347 # Durations less than one second are represented with a 0
13348 # `seconds` field and a positive `nanos` field. Must be from 0
13349 # to 999,999,999 inclusive.
13350 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13351 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13352 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13353 },
13354 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
13355 # values are:
13356 #
13357 # - 5xx: retry is attempted if the instance or endpoint
13358 # responds with any 5xx response code, or if the instance or
13359 # endpoint does not respond at all. For example, disconnects, reset, read
13360 # timeout, connection failure, and refused streams.
13361 # - gateway-error: Similar to 5xx, but only
13362 # applies to response codes 502, 503 or504.
13363 # - connect-failure: a retry is attempted on failures
13364 # connecting to the instance or endpoint. For example, connection
13365 # timeouts.
13366 # - retriable-4xx: a retry is attempted if the instance
13367 # or endpoint responds with a 4xx response code.
13368 # The only error that you can retry is error code 409.
13369 # - refused-stream: a retry is attempted if the instance
13370 # or endpoint resets the stream with a REFUSED_STREAM error
13371 # code. This reset type indicates that it is safe to retry.
13372 # - cancelled: a retry is attempted if the gRPC status
13373 # code in the response header is set to cancelled.
13374 # - deadline-exceeded: a retry is attempted if the gRPC
13375 # status code in the response header is set todeadline-exceeded.
13376 # - internal: a retry is attempted if the gRPC
13377 # status code in the response header is set tointernal.
13378 # - resource-exhausted: a retry is attempted if the gRPC
13379 # status code in the response header is set toresource-exhausted.
13380 # - unavailable: a retry is attempted if the gRPC
13381 # status code in the response header is set tounavailable.
13382 #
13383 # Only the following codes are supported when the URL map is bound to
13384 # target gRPC proxy that has validateForProxyless field set to true.
13385 #
13386 # - cancelled
13387 # - deadline-exceeded
13388 # - internal
13389 # - resource-exhausted
13390 # - unavailable
13391 &quot;A String&quot;,
13392 ],
13393 },
13394 &quot;timeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
13395 # time the request has been fully processed (known as *end-of-stream*)
13396 # up until the response has been processed. Timeout includes
13397 # all retries.
13398 #
13399 # If not specified, this field uses the largest timeout among all backend
13400 # services associated with the route.
13401 #
13402 # Not supported when the URL map is bound to a target gRPC proxy that
13403 # has validateForProxyless field set to true.
13404 # as a count of seconds and fractions of seconds at nanosecond
13405 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13406 # or &quot;month&quot;. Range is approximately 10,000 years.
13407 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13408 # Durations less than one second are represented with a 0
13409 # `seconds` field and a positive `nanos` field. Must be from 0
13410 # to 999,999,999 inclusive.
13411 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13412 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13413 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13414 },
13415 &quot;urlRewrite&quot;: { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
13416 # to the matched service.
13417 #
13418 # urlRewrite is the only action supported in UrlMaps
13419 # for classic Application Load Balancers.
13420 #
13421 # Not supported when the URL map is bound to a target gRPC proxy that
13422 # has the validateForProxyless field set to true.
13423 # backend service.
13424 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
13425 # host header is replaced with contents of hostRewrite.
13426 #
13427 # The value must be from 1 to 255 characters.
13428 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
13429 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
13430 #
13431 # The value must be from 1 to 1024 characters.
13432 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
13433 # header) using the HTTP template syntax.
13434 #
13435 # A corresponding
13436 # path_template_match must be specified. Any template variables must exist in
13437 # the path_template_match field.
13438 #
13439 #
13440 # - -At least one variable must be specified in the path_template_match
13441 # field
13442 # - You can omit variables from the rewritten URL
13443 # - The * and ** operators cannot be matched
13444 # unless they have a corresponding variable name - e.g.
13445 # {format=*} or {var=**}.
13446 #
13447 # For example, a path_template_match of /static/{format=**}
13448 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
13449 # rewrite, so that /{country}/{format}/{suffix=**} can be
13450 # rewritten as /content/{format}/{country}/{suffix}.
13451 #
13452 # At least
13453 # one non-empty routeRules[].matchRules[].path_template_match is
13454 # required.
13455 #
13456 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
13457 },
13458 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
13459 # occurs. The weights determine the fraction of traffic that flows to
13460 # their corresponding backend service. If all traffic needs to
13461 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
13462 #
13463 # After a backend service is identified and before forwarding
13464 # the request to
13465 # the backend service, advanced routing actions such as URL rewrites and
13466 # header transformations are applied depending on additional settings
13467 # specified in this HttpRouteAction.
13468 { # In contrast to a single BackendService in
13469 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
13470 # multiple backend services. The volume of traffic for each
13471 # backend service is proportional to the weight specified
13472 # in each WeightedBackendService
13473 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
13474 # resource. Before
13475 # forwarding the request to backendService, the load balancer
13476 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
13477 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
13478 # effect for the selected backendService.
13479 #
13480 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
13481 #
13482 # headerAction is not supported for load balancers that have
13483 # their loadBalancingScheme set to EXTERNAL.
13484 #
13485 # Not supported when the URL map is bound to a target gRPC proxy that
13486 # has validateForProxyless field set to true.
13487 # the request is passed along to the selected backendService.
13488 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
13489 { # Specification determining how headers are added to requests or responses.
13490 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
13491 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
13492 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
13493 # that already
13494 # exist for the header. If true, headerValue is set for the
13495 # header, discarding any values that were set for that header.
13496 #
13497 # The default value is true,
13498 # unless a variable is present in headerValue,
13499 # in which case the default value is false.
13500 # .
13501 },
13502 ],
13503 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
13504 # request before forwarding the request to the backendService.
13505 &quot;A String&quot;,
13506 ],
13507 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
13508 # client.
13509 { # Specification determining how headers are added to requests or responses.
13510 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
13511 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
13512 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
13513 # that already
13514 # exist for the header. If true, headerValue is set for the
13515 # header, discarding any values that were set for that header.
13516 #
13517 # The default value is true,
13518 # unless a variable is present in headerValue,
13519 # in which case the default value is false.
13520 # .
13521 },
13522 ],
13523 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
13524 # response before sending the response back to the client.
13525 &quot;A String&quot;,
13526 ],
13527 },
13528 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
13529 # computed asweight / (sum of all weightedBackendService weights in routeAction).
13530 #
13531 # The selection of a backend service is determined only for new traffic.
13532 # Once a user&#x27;s request has been directed to a backend service,
13533 # subsequent requests are sent to the same backend service as
13534 # determined by the backend service&#x27;s session affinity policy.
13535 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
13536 # splitting. If you do, the weighted traffic splitting configuration takes
13537 # precedence.
13538 #
13539 # The value must be from 0 to 1000.
13540 },
13541 ],
13542 },
13543 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource. This
13544 # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
13545 # matched. For example, the
13546 # following are all valid URLs to a BackendService resource:
13547 #
13548 #
13549 # - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
13550 # - compute/v1/projects/project/global/backendServices/backendService
13551 # - global/backendServices/backendService
13552 #
13553 #
13554 # If defaultRouteAction is also specified, advanced
13555 # routing actions, such as URL rewrites, take effect before sending the
13556 # request to the backend.
13557 #
13558 #
13559 # Only one of defaultUrlRedirect, defaultService
13560 # or defaultRouteAction.weightedBackendService can be set.
13561 #
13562 #
13563 # Authorization requires one or more of the following Google IAM permissions on the
13564 # specified resource default_service:
13565 #
13566 #
13567 # - compute.backendBuckets.use
13568 # - compute.backendServices.use
13569 &quot;defaultUrlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When none of the specified pathRules orrouteRules match, the request is redirected to a URL specified
13570 # by defaultUrlRedirect.
13571 #
13572 #
13573 # Only one of defaultUrlRedirect, defaultService
13574 # or defaultRouteAction.weightedBackendService can be set.
13575 #
13576 #
13577 # Not supported when the URL map is bound to a target gRPC proxy.
13578 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
13579 # was supplied in the request.
13580 #
13581 # The value must be from 1 to 255
13582 # characters.
13583 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
13584 # set to HTTPS.
13585 # If set to false, the URL scheme of the redirected request
13586 # remains the same as that of the request.
13587 #
13588 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
13589 #
13590 # The default is set to false.
13591 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
13592 # that was supplied in the request.
13593 #
13594 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
13595 # supplied, the path of the original request is used for the redirect.
13596 #
13597 # The value must be from 1 to 1024 characters.
13598 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
13599 # the HttpRouteRuleMatch, retaining the remaining portion
13600 # of the URL before redirecting the request.
13601 #
13602 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
13603 # supplied, the path of the original request is used for the redirect.
13604 #
13605 # The value must be from 1 to 1024 characters.
13606 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
13607 #
13608 # Supported values are:
13609 #
13610 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
13611 # to 301.
13612 # - FOUND, which corresponds to 302.
13613 # - SEE_OTHER which corresponds to 303.
13614 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
13615 # method is retained.
13616 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
13617 # method is retained.
13618 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
13619 # URL is
13620 # removed before redirecting the request. If set to false, the
13621 # query portion of the original URL is retained.
13622 #
13623 # The default is set to false.
13624 },
13625 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
13626 # create the resource.
13627 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
13628 # for the selected backend service.
13629 #
13630 # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
13631 #
13632 # HeaderAction is not supported for load balancers
13633 # that have
13634 # their loadBalancingScheme set to EXTERNAL.
13635 #
13636 # Not supported when the URL map is bound to a target gRPC proxy that
13637 # has validateForProxyless field set to true.
13638 # the request is passed along to the selected backendService.
13639 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
13640 { # Specification determining how headers are added to requests or responses.
13641 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
13642 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
13643 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
13644 # that already
13645 # exist for the header. If true, headerValue is set for the
13646 # header, discarding any values that were set for that header.
13647 #
13648 # The default value is true,
13649 # unless a variable is present in headerValue,
13650 # in which case the default value is false.
13651 # .
13652 },
13653 ],
13654 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
13655 # request before forwarding the request to the backendService.
13656 &quot;A String&quot;,
13657 ],
13658 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
13659 # client.
13660 { # Specification determining how headers are added to requests or responses.
13661 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
13662 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
13663 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
13664 # that already
13665 # exist for the header. If true, headerValue is set for the
13666 # header, discarding any values that were set for that header.
13667 #
13668 # The default value is true,
13669 # unless a variable is present in headerValue,
13670 # in which case the default value is false.
13671 # .
13672 },
13673 ],
13674 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
13675 # response before sending the response back to the client.
13676 &quot;A String&quot;,
13677 ],
13678 },
13679 &quot;name&quot;: &quot;A String&quot;, # The name to which this PathMatcher is referred by theHostRule.
13680 &quot;pathRules&quot;: [ # The list of path rules. Use this list instead of routeRules
13681 # when routing based on simple path matching is all that&#x27;s required. A path
13682 # rule can only include a wildcard character (*) after a
13683 # forward slash character (&quot;/&quot;).
13684 #
13685 # The order by which path rules are specified does not matter.
13686 # Matches are always done on the longest-path-first basis.
13687 #
13688 # For example: a pathRule with a path /a/b/c/* will match
13689 # before /a/b/* irrespective of the order in which those paths appear in this
13690 # list.
13691 #
13692 # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
13693 { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
13694 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
13695 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
13696 #
13697 # If a policy for an
13698 # error code is not configured for the PathRule, a policy for
13699 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
13700 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
13701 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
13702 # effect.
13703 #
13704 # For example, consider a UrlMap with the following configuration:
13705 #
13706 #
13707 # - UrlMap.defaultCustomErrorResponsePolicy are configured
13708 # with policies for 5xx and 4xx errors
13709 # - A PathRule for /coming_soon/ is configured for the error
13710 # code 404.
13711 #
13712 # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher&#x27;s policy
13713 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
13714 # the policy in PathRule.customErrorResponsePolicy takes
13715 # effect. If any of the requests in this example encounter a 500
13716 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
13717 #
13718 # customErrorResponsePolicy is supported only for
13719 # global external Application Load Balancers.
13720 # backend service or backend bucket responds with an error.
13721 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
13722 #
13723 # In a given policy, if you specify rules for both a range of error codes
13724 # as well as rules for specific error codes then rules with specific error
13725 # codes have a higher priority. For example, assume that you configure a rule
13726 # for 401 (Un-authorized) code, and another for all 4 series
13727 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
13728 # However if the backend service returns a 403, the rule for4xx takes effect.
13729 { # Specifies the mapping between the response code that will be returned along
13730 # with the custom error content and the response code returned by the backend
13731 # service.
13732 &quot;matchResponseCodes&quot;: [ # Valid values include:
13733 #
13734 #
13735 # - A number between 400 and 599: For example
13736 # 401 or 503, in which case the load balancer
13737 # applies the policy if the error code exactly matches this value.
13738 # - 5xx: Load Balancer will apply the policy if the
13739 # backend service responds with any response code in the range of
13740 # 500 to 599.
13741 # - 4xx: Load
13742 # Balancer will apply the policy if the backend service responds with any
13743 # response code in the range of 400 to
13744 # 499.
13745 #
13746 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
13747 &quot;A String&quot;,
13748 ],
13749 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
13750 # error content. If overrideResponseCode is not supplied, the
13751 # same response code returned by the original backend bucket or backend
13752 # service is returned to the client.
13753 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
13754 #
13755 # path must start
13756 # with a leading slash. path cannot have trailing slashes.
13757 #
13758 # If the file is not available in backendBucket or the
13759 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
13760 #
13761 # The value must
13762 # be from 1 to 1024 characters
13763 },
13764 ],
13765 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
13766 # contains the custom error content. Examples are:
13767 #
13768 #
13769 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
13770 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
13771 # - global/backendBuckets/myBackendBucket
13772 #
13773 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
13774 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
13775 #
13776 # If load balancer cannot reach
13777 # the backendBucket, a simple Not Found Error will
13778 # be returned, with the original response code (oroverrideResponseCode if configured).
13779 #
13780 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
13781 },
13782 &quot;paths&quot;: [ # The list of path patterns to match. Each must start with /
13783 # and the only place a * is allowed is at the end following
13784 # a /. The string fed to the path matcher does not include
13785 # any text after the first ? or #, and
13786 # those chars are not allowed here.
13787 &quot;A String&quot;,
13788 ],
13789 &quot;routeAction&quot;: { # In response to a matching path, the load balancer
13790 # performs advanced routing actions, such as URL rewrites and header
13791 # transformations, before forwarding the request to the selected
13792 # backend.
13793 #
13794 #
13795 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
13796 #
13797 #
13798 # URL maps for classic Application Load Balancers only support
13799 # the urlRewrite action within a path rule&#x27;srouteAction.
13800 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
13801 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
13802 # property must be specified. This policy cannot be specified if any target
13803 # backend has Identity-Aware Proxy enabled.
13804 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
13805 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
13806 # header names can be specified. The cache is bypassed for all `cacheMode`
13807 # values.
13808 &quot;A String&quot;,
13809 ],
13810 &quot;cacheKeyPolicy&quot;: { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
13811 # on the backend type: for Backend Services, the complete request URI is
13812 # used; for Backend Buckets, the request URI is used without the protocol or
13813 # host, and only query parameters known to Cloud Storage are included.
13814 # Policy defined on Route Action.
13815 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
13816 # parameters will be included. Either specify `excludedQueryParameters`
13817 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
13818 # encoded and not treated as delimiters.
13819 #
13820 # Note: This field applies to routes that use backend services. Attempting
13821 # to set it on a route that points exclusively to Backend Buckets will
13822 # result in a configuration error. For routes that point to a Backend
13823 # Bucket, use `includedQueryParameters` to define which parameters should
13824 # be part of the cache key.
13825 &quot;A String&quot;,
13826 ],
13827 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
13828 #
13829 # Note: This setting is only applicable to routes that use a Backend
13830 # Service. It does not affect requests served by a Backend Bucket, as the
13831 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
13832 # it on a route that points exclusively to Backend Buckets will result in a
13833 # configuration error.
13834 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
13835 #
13836 # Note: This setting is only applicable to routes that use a Backend
13837 # Service. It does not affect requests served by a Backend Bucket, as the
13838 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
13839 # set on a route that points exclusively to Backend Buckets will result in
13840 # a configuration error.
13841 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
13842 # `includedQueryParameters` and `excludedQueryParameters`. If neither
13843 # is set, the entire query string will be included. If false, the query
13844 # string will be excluded from the cache key entirely.
13845 #
13846 # Note: This field applies to routes that use backend services. Attempting
13847 # to set it on a route that points exclusively to Backend Buckets will
13848 # result in a configuration error. For routes that point to a Backend
13849 # Bucket, use `includedQueryParameters` to define which parameters should
13850 # be part of the cache key.
13851 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
13852 # The name=value pair will be used in the cache key Cloud CDN generates.
13853 #
13854 # Note: This setting is only applicable to routes that use a Backend
13855 # Service. It does not affect requests served by a Backend Bucket.
13856 # Attempting to set it on a route that points exclusively to Backend
13857 # Buckets will result in a configuration error. Up to 5 cookie names can be
13858 # specified.
13859 &quot;A String&quot;,
13860 ],
13861 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
13862 &quot;A String&quot;,
13863 ],
13864 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
13865 # parameters will be excluded. Either specify `includedQueryParameters`
13866 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
13867 # encoded and not treated as delimiters.
13868 &quot;A String&quot;,
13869 ],
13870 },
13871 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
13872 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
13873 &quot;clientTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
13874 # content. This is used to clamp the max-age (or Expires) value sent to the
13875 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
13876 # is used for the response max-age directive, along with a &quot;public&quot;
13877 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
13878 # clamps the max-age from the origin (if specified), or else sets the
13879 # response max-age directive to the lesser of the `clientTtl` and
13880 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
13881 # present. The maximum allowed value is 31,622,400s (1 year). If not
13882 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
13883 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
13884 # `USE_ORIGIN_HEADERS`.
13885 # as a count of seconds and fractions of seconds at nanosecond
13886 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13887 # or &quot;month&quot;. Range is approximately 10,000 years.
13888 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13889 # Durations less than one second are represented with a 0
13890 # `seconds` field and a positive `nanos` field. Must be from 0
13891 # to 999,999,999 inclusive.
13892 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13893 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13894 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13895 },
13896 &quot;defaultTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
13897 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
13898 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
13899 # greater than that of `maxTtl`. When the `cacheMode` is set to
13900 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
13901 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
13902 # accessed objects may be evicted from the cache before the defined TTL. If
13903 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
13904 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
13905 # `USE_ORIGIN_HEADERS`.
13906 # as a count of seconds and fractions of seconds at nanosecond
13907 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13908 # or &quot;month&quot;. Range is approximately 10,000 years.
13909 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13910 # Durations less than one second are represented with a 0
13911 # `seconds` field and a positive `nanos` field. Must be from 0
13912 # to 999,999,999 inclusive.
13913 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13914 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13915 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13916 },
13917 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
13918 # attempt to set a max-age or s-maxage higher than this, or an Expires header
13919 # more than `maxTtl` seconds in the future will be capped at the value of
13920 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
13921 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
13922 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
13923 # Infrequently accessed objects may be evicted from the cache before the
13924 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
13925 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
13926 # mode.
13927 # as a count of seconds and fractions of seconds at nanosecond
13928 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13929 # or &quot;month&quot;. Range is approximately 10,000 years.
13930 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13931 # Durations less than one second are represented with a 0
13932 # `seconds` field and a positive `nanos` field. Must be from 0
13933 # to 999,999,999 inclusive.
13934 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13935 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13936 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13937 },
13938 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
13939 # to apply fine-grained caching for common errors or redirects.
13940 # This can reduce the load on your origin and improve end-user
13941 # experience by reducing response latency.
13942 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
13943 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
13944 # the specified response code that lack any Cache-Control, Expires, or
13945 # Pragma: no-cache directives. When the `cacheMode` is set to
13946 # `FORCE_CACHE_ALL`, negative caching applies to all responses
13947 # with the specified response code, and overrides any caching headers. By
13948 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
13949 #
13950 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
13951 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
13952 # * 405 (Method Not Found), 501 (Not Implemented): 60s
13953 #
13954 # These defaults can be overridden in `negativeCachingPolicy`.
13955 # If not specified, Cloud CDN applies negative caching by default.
13956 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
13957 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
13958 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
13959 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
13960 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
13961 # all response codes that you wish to cache. Cloud CDN will not apply any
13962 # default negative caching when a policy exists.
13963 { # Specify CDN TTLs for response error codes.
13964 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
13965 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
13966 # specified as values, and you cannot specify a status code more than
13967 # once.
13968 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
13969 # corresponding status code.
13970 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
13971 # objects may be evicted from the cache before the defined TTL.
13972 # as a count of seconds and fractions of seconds at nanosecond
13973 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13974 # or &quot;month&quot;. Range is approximately 10,000 years.
13975 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13976 # Durations less than one second are represented with a 0
13977 # `seconds` field and a positive `nanos` field. Must be from 0
13978 # to 999,999,999 inclusive.
13979 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13980 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13981 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13982 },
13983 },
13984 ],
13985 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
13986 # requests into a small number of requests to the origin. If not specified,
13987 # Cloud CDN applies request coalescing by default.
13988 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
13989 # content with the origin, or when an error is encountered when refreshing
13990 # the cache.
13991 # This setting defines the default &quot;max-stale&quot; duration for any cached
13992 # responses that do not specify a max-stale directive. Stale responses that
13993 # exceed the TTL configured here will not be served. The default limit
13994 # (max-stale) is 86400s (1 day), which will allow stale content to be
13995 # served up to this limit beyond the max-age (or s-maxage) of a cached
13996 # response.
13997 # The maximum allowed value is 604800 (1 week).
13998 # Set this to zero (0) to disable serve-while-stale.
13999 # as a count of seconds and fractions of seconds at nanosecond
14000 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14001 # or &quot;month&quot;. Range is approximately 10,000 years.
14002 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14003 # Durations less than one second are represented with a 0
14004 # `seconds` field and a positive `nanos` field. Must be from 0
14005 # to 999,999,999 inclusive.
14006 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14007 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14008 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14009 },
14010 },
14011 &quot;corsPolicy&quot;: { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
14012 # information about the W3C recommendation for cross-origin resource sharing
14013 # (CORS), see Fetch API Living
14014 # Standard.
14015 #
14016 # Not supported when the URL map is bound to a target gRPC proxy.
14017 # information about the W3C recommendation for cross-origin resource sharing
14018 # (CORS), see Fetch API Living
14019 # Standard.
14020 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
14021 # indicates that
14022 # the actual request can include user credentials. This field translates to
14023 # the Access-Control-Allow-Credentials header.
14024 #
14025 # Default is false.
14026 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
14027 # header.
14028 &quot;A String&quot;,
14029 ],
14030 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
14031 # header.
14032 &quot;A String&quot;,
14033 ],
14034 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
14035 # more information, see regular expression syntax.
14036 #
14037 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
14038 #
14039 # Regular expressions can only be used when the loadBalancingScheme is
14040 # set to INTERNAL_SELF_MANAGED.
14041 &quot;A String&quot;,
14042 ],
14043 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
14044 #
14045 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
14046 &quot;A String&quot;,
14047 ],
14048 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
14049 # The default value is false, which indicates that the CORS
14050 # policy is in effect.
14051 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
14052 # header.
14053 &quot;A String&quot;,
14054 ],
14055 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
14056 # seconds. This field translates to the Access-Control-Max-Age
14057 # header.
14058 },
14059 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
14060 # the resiliency of clients to backend service failure. As part of fault
14061 # injection, when clients send requests to a backend service, delays can be
14062 # introduced by a load balancer on a percentage of requests before sending
14063 # those requests to the backend service. Similarly requests from clients can
14064 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
14065 # that are configured with a fault_injection_policy if:
14066 # 1. The traffic is generated by fault injection AND
14067 # 2. The fault injection is not a delay fault injection.
14068 # Fault injection is not supported with the classic Application Load Balancer
14069 # . To see which load balancers support fault injection,
14070 # see Load
14071 # balancing: Routing and traffic management features.
14072 # the resiliency of clients to backend service failure. As part of fault
14073 # injection, when clients send requests to a backend service, delays can be
14074 # introduced by the load balancer on a percentage of requests before sending
14075 # those request to the backend service. Similarly requests from clients can be
14076 # aborted by the load balancer for a percentage of requests.
14077 &quot;abort&quot;: { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
14078 # injection.
14079 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
14080 #
14081 # The value must be from 200 to 599 inclusive.
14082 #
14083 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
14084 # according to this
14085 # mapping table. HTTP status 200 is mapped to gRPC status
14086 # UNKNOWN. Injecting an OK status is currently not supported by
14087 # Traffic Director.
14088 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
14089 # that is aborted as part of fault injection.
14090 #
14091 # The value must be from 0.0 to 100.0 inclusive.
14092 },
14093 &quot;delay&quot;: { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
14094 # injection, before being sent to a backend service.
14095 # request to the backend service as part of fault injection.
14096 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
14097 # as a count of seconds and fractions of seconds at nanosecond
14098 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14099 # or &quot;month&quot;. Range is approximately 10,000 years.
14100 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14101 # Durations less than one second are represented with a 0
14102 # `seconds` field and a positive `nanos` field. Must be from 0
14103 # to 999,999,999 inclusive.
14104 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14105 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14106 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14107 },
14108 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
14109 # which a delay is introduced as part of fault injection.
14110 #
14111 # The value must be from 0.0 to 100.0 inclusive.
14112 },
14113 },
14114 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
14115 # Unlike the timeout field where the timeout duration starts
14116 # from the time the request has been fully processed (known as*end-of-stream*),
14117 # the duration in this field is computed from the beginning of the stream
14118 # until the response has been processed, including all retries. A
14119 # stream that does not complete in this duration is closed.
14120 #
14121 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
14122 # with the route.
14123 #
14124 # This field is only allowed if the Url map is used with backend services
14125 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
14126 # as a count of seconds and fractions of seconds at nanosecond
14127 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14128 # or &quot;month&quot;. Range is approximately 10,000 years.
14129 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14130 # Durations less than one second are represented with a 0
14131 # `seconds` field and a positive `nanos` field. Must be from 0
14132 # to 999,999,999 inclusive.
14133 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14134 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14135 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14136 },
14137 &quot;requestMirrorPolicy&quot;: { # A policy that specifies how requests intended for the route&#x27;s backends # Specifies the policy on how requests intended for the route&#x27;s backends
14138 # are shadowed to a separate mirrored backend service. The load balancer does
14139 # not wait for responses from the shadow service. Before sending traffic
14140 # to the shadow service, the host / authority header is suffixed with-shadow.
14141 #
14142 # Not supported when the URL map is bound to a target gRPC proxy that
14143 # has the validateForProxyless field set to true.
14144 # are shadowed to a separate mirrored backend service. The load balancer
14145 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
14146 # to the shadow service, the host or authority header is suffixed with-shadow.
14147 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
14148 # mirrored to.
14149 #
14150 # The backend service configured for a mirroring
14151 # policy must reference backends that are of the same type as the original
14152 # backend service matched in the URL map.
14153 #
14154 # Serverless NEG backends are not currently supported as a mirrored
14155 # backend service.
14156 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
14157 },
14158 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
14159 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
14160 # If not specified, defaults to 1.
14161 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
14162 #
14163 # If not specified, will use the timeout set in theHttpRouteAction field.
14164 # If timeout in the HttpRouteAction field is not set, this field
14165 # uses the largest timeout
14166 # among all backend services associated with the route.
14167 #
14168 # Not supported when the URL map is bound to a target gRPC proxy that
14169 # has the validateForProxyless field set to true.
14170 # as a count of seconds and fractions of seconds at nanosecond
14171 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14172 # or &quot;month&quot;. Range is approximately 10,000 years.
14173 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14174 # Durations less than one second are represented with a 0
14175 # `seconds` field and a positive `nanos` field. Must be from 0
14176 # to 999,999,999 inclusive.
14177 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14178 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14179 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14180 },
14181 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
14182 # values are:
14183 #
14184 # - 5xx: retry is attempted if the instance or endpoint
14185 # responds with any 5xx response code, or if the instance or
14186 # endpoint does not respond at all. For example, disconnects, reset, read
14187 # timeout, connection failure, and refused streams.
14188 # - gateway-error: Similar to 5xx, but only
14189 # applies to response codes 502, 503 or504.
14190 # - connect-failure: a retry is attempted on failures
14191 # connecting to the instance or endpoint. For example, connection
14192 # timeouts.
14193 # - retriable-4xx: a retry is attempted if the instance
14194 # or endpoint responds with a 4xx response code.
14195 # The only error that you can retry is error code 409.
14196 # - refused-stream: a retry is attempted if the instance
14197 # or endpoint resets the stream with a REFUSED_STREAM error
14198 # code. This reset type indicates that it is safe to retry.
14199 # - cancelled: a retry is attempted if the gRPC status
14200 # code in the response header is set to cancelled.
14201 # - deadline-exceeded: a retry is attempted if the gRPC
14202 # status code in the response header is set todeadline-exceeded.
14203 # - internal: a retry is attempted if the gRPC
14204 # status code in the response header is set tointernal.
14205 # - resource-exhausted: a retry is attempted if the gRPC
14206 # status code in the response header is set toresource-exhausted.
14207 # - unavailable: a retry is attempted if the gRPC
14208 # status code in the response header is set tounavailable.
14209 #
14210 # Only the following codes are supported when the URL map is bound to
14211 # target gRPC proxy that has validateForProxyless field set to true.
14212 #
14213 # - cancelled
14214 # - deadline-exceeded
14215 # - internal
14216 # - resource-exhausted
14217 # - unavailable
14218 &quot;A String&quot;,
14219 ],
14220 },
14221 &quot;timeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
14222 # time the request has been fully processed (known as *end-of-stream*)
14223 # up until the response has been processed. Timeout includes
14224 # all retries.
14225 #
14226 # If not specified, this field uses the largest timeout among all backend
14227 # services associated with the route.
14228 #
14229 # Not supported when the URL map is bound to a target gRPC proxy that
14230 # has validateForProxyless field set to true.
14231 # as a count of seconds and fractions of seconds at nanosecond
14232 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14233 # or &quot;month&quot;. Range is approximately 10,000 years.
14234 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14235 # Durations less than one second are represented with a 0
14236 # `seconds` field and a positive `nanos` field. Must be from 0
14237 # to 999,999,999 inclusive.
14238 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14239 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14240 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14241 },
14242 &quot;urlRewrite&quot;: { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
14243 # to the matched service.
14244 #
14245 # urlRewrite is the only action supported in UrlMaps
14246 # for classic Application Load Balancers.
14247 #
14248 # Not supported when the URL map is bound to a target gRPC proxy that
14249 # has the validateForProxyless field set to true.
14250 # backend service.
14251 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
14252 # host header is replaced with contents of hostRewrite.
14253 #
14254 # The value must be from 1 to 255 characters.
14255 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
14256 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
14257 #
14258 # The value must be from 1 to 1024 characters.
14259 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
14260 # header) using the HTTP template syntax.
14261 #
14262 # A corresponding
14263 # path_template_match must be specified. Any template variables must exist in
14264 # the path_template_match field.
14265 #
14266 #
14267 # - -At least one variable must be specified in the path_template_match
14268 # field
14269 # - You can omit variables from the rewritten URL
14270 # - The * and ** operators cannot be matched
14271 # unless they have a corresponding variable name - e.g.
14272 # {format=*} or {var=**}.
14273 #
14274 # For example, a path_template_match of /static/{format=**}
14275 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
14276 # rewrite, so that /{country}/{format}/{suffix=**} can be
14277 # rewritten as /content/{format}/{country}/{suffix}.
14278 #
14279 # At least
14280 # one non-empty routeRules[].matchRules[].path_template_match is
14281 # required.
14282 #
14283 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
14284 },
14285 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
14286 # occurs. The weights determine the fraction of traffic that flows to
14287 # their corresponding backend service. If all traffic needs to
14288 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
14289 #
14290 # After a backend service is identified and before forwarding
14291 # the request to
14292 # the backend service, advanced routing actions such as URL rewrites and
14293 # header transformations are applied depending on additional settings
14294 # specified in this HttpRouteAction.
14295 { # In contrast to a single BackendService in
14296 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
14297 # multiple backend services. The volume of traffic for each
14298 # backend service is proportional to the weight specified
14299 # in each WeightedBackendService
14300 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
14301 # resource. Before
14302 # forwarding the request to backendService, the load balancer
14303 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
14304 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
14305 # effect for the selected backendService.
14306 #
14307 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
14308 #
14309 # headerAction is not supported for load balancers that have
14310 # their loadBalancingScheme set to EXTERNAL.
14311 #
14312 # Not supported when the URL map is bound to a target gRPC proxy that
14313 # has validateForProxyless field set to true.
14314 # the request is passed along to the selected backendService.
14315 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
14316 { # Specification determining how headers are added to requests or responses.
14317 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
14318 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
14319 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
14320 # that already
14321 # exist for the header. If true, headerValue is set for the
14322 # header, discarding any values that were set for that header.
14323 #
14324 # The default value is true,
14325 # unless a variable is present in headerValue,
14326 # in which case the default value is false.
14327 # .
14328 },
14329 ],
14330 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
14331 # request before forwarding the request to the backendService.
14332 &quot;A String&quot;,
14333 ],
14334 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
14335 # client.
14336 { # Specification determining how headers are added to requests or responses.
14337 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
14338 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
14339 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
14340 # that already
14341 # exist for the header. If true, headerValue is set for the
14342 # header, discarding any values that were set for that header.
14343 #
14344 # The default value is true,
14345 # unless a variable is present in headerValue,
14346 # in which case the default value is false.
14347 # .
14348 },
14349 ],
14350 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
14351 # response before sending the response back to the client.
14352 &quot;A String&quot;,
14353 ],
14354 },
14355 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
14356 # computed asweight / (sum of all weightedBackendService weights in routeAction).
14357 #
14358 # The selection of a backend service is determined only for new traffic.
14359 # Once a user&#x27;s request has been directed to a backend service,
14360 # subsequent requests are sent to the same backend service as
14361 # determined by the backend service&#x27;s session affinity policy.
14362 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
14363 # splitting. If you do, the weighted traffic splitting configuration takes
14364 # precedence.
14365 #
14366 # The value must be from 0 to 1000.
14367 },
14368 ],
14369 },
14370 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
14371 # is directed if this rule is matched. If routeAction is
14372 # also specified, advanced routing actions, such as URL rewrites,
14373 # take effect before sending the request to the backend.
14374 #
14375 #
14376 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
14377 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
14378 # specified by urlRedirect.
14379 #
14380 #
14381 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
14382 #
14383 #
14384 # Not supported when the URL map is bound to a target gRPC proxy.
14385 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
14386 # was supplied in the request.
14387 #
14388 # The value must be from 1 to 255
14389 # characters.
14390 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
14391 # set to HTTPS.
14392 # If set to false, the URL scheme of the redirected request
14393 # remains the same as that of the request.
14394 #
14395 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
14396 #
14397 # The default is set to false.
14398 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
14399 # that was supplied in the request.
14400 #
14401 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
14402 # supplied, the path of the original request is used for the redirect.
14403 #
14404 # The value must be from 1 to 1024 characters.
14405 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
14406 # the HttpRouteRuleMatch, retaining the remaining portion
14407 # of the URL before redirecting the request.
14408 #
14409 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
14410 # supplied, the path of the original request is used for the redirect.
14411 #
14412 # The value must be from 1 to 1024 characters.
14413 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
14414 #
14415 # Supported values are:
14416 #
14417 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
14418 # to 301.
14419 # - FOUND, which corresponds to 302.
14420 # - SEE_OTHER which corresponds to 303.
14421 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
14422 # method is retained.
14423 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
14424 # method is retained.
14425 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
14426 # URL is
14427 # removed before redirecting the request. If set to false, the
14428 # query portion of the original URL is retained.
14429 #
14430 # The default is set to false.
14431 },
14432 },
14433 ],
14434 &quot;routeRules&quot;: [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
14435 # desired. routeRules are evaluated in order of priority, from
14436 # the lowest to highest number.
14437 #
14438 # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
14439 { # The HttpRouteRule setting specifies how to match an HTTP request
14440 # and the corresponding routing action that load balancing proxies perform.
14441 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
14442 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
14443 #
14444 # If a policy for an
14445 # error code is not configured for the RouteRule, a policy for
14446 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
14447 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
14448 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
14449 # effect.
14450 #
14451 # For example, consider a UrlMap with the following configuration:
14452 #
14453 #
14454 # - UrlMap.defaultCustomErrorResponsePolicy are configured
14455 # with policies for 5xx and 4xx errors
14456 # - A RouteRule for /coming_soon/ is configured for the
14457 # error code 404.
14458 #
14459 # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher&#x27;s policy
14460 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
14461 # the policy in RouteRule.customErrorResponsePolicy takes
14462 # effect. If any of the requests in this example encounter a 500
14463 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
14464 #
14465 # When
14466 # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
14467 # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
14468 # a retry, if load balancer is successful in reaching the
14469 # service, the customErrorResponsePolicy is ignored and
14470 # the response from the service is returned to the client.
14471 #
14472 # customErrorResponsePolicy is supported only for
14473 # global external Application Load Balancers.
14474 # backend service or backend bucket responds with an error.
14475 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
14476 #
14477 # In a given policy, if you specify rules for both a range of error codes
14478 # as well as rules for specific error codes then rules with specific error
14479 # codes have a higher priority. For example, assume that you configure a rule
14480 # for 401 (Un-authorized) code, and another for all 4 series
14481 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
14482 # However if the backend service returns a 403, the rule for4xx takes effect.
14483 { # Specifies the mapping between the response code that will be returned along
14484 # with the custom error content and the response code returned by the backend
14485 # service.
14486 &quot;matchResponseCodes&quot;: [ # Valid values include:
14487 #
14488 #
14489 # - A number between 400 and 599: For example
14490 # 401 or 503, in which case the load balancer
14491 # applies the policy if the error code exactly matches this value.
14492 # - 5xx: Load Balancer will apply the policy if the
14493 # backend service responds with any response code in the range of
14494 # 500 to 599.
14495 # - 4xx: Load
14496 # Balancer will apply the policy if the backend service responds with any
14497 # response code in the range of 400 to
14498 # 499.
14499 #
14500 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
14501 &quot;A String&quot;,
14502 ],
14503 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
14504 # error content. If overrideResponseCode is not supplied, the
14505 # same response code returned by the original backend bucket or backend
14506 # service is returned to the client.
14507 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
14508 #
14509 # path must start
14510 # with a leading slash. path cannot have trailing slashes.
14511 #
14512 # If the file is not available in backendBucket or the
14513 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
14514 #
14515 # The value must
14516 # be from 1 to 1024 characters
14517 },
14518 ],
14519 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
14520 # contains the custom error content. Examples are:
14521 #
14522 #
14523 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
14524 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
14525 # - global/backendBuckets/myBackendBucket
14526 #
14527 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
14528 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
14529 #
14530 # If load balancer cannot reach
14531 # the backendBucket, a simple Not Found Error will
14532 # be returned, with the original response code (oroverrideResponseCode if configured).
14533 #
14534 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
14535 },
14536 &quot;description&quot;: &quot;A String&quot;, # The short description conveying the intent of this routeRule.
14537 #
14538 #
14539 # The description can have a maximum length of 1024 characters.
14540 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
14541 # for the selected backendService.
14542 #
14543 # The headerAction value specified here is applied before the
14544 # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
14545 #
14546 # HeaderAction is not supported for load balancers
14547 # that have
14548 # their loadBalancingScheme set to EXTERNAL.
14549 #
14550 # Not supported when the URL map is bound to a target gRPC proxy that
14551 # has validateForProxyless field set to true.
14552 # the request is passed along to the selected backendService.
14553 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
14554 { # Specification determining how headers are added to requests or responses.
14555 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
14556 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
14557 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
14558 # that already
14559 # exist for the header. If true, headerValue is set for the
14560 # header, discarding any values that were set for that header.
14561 #
14562 # The default value is true,
14563 # unless a variable is present in headerValue,
14564 # in which case the default value is false.
14565 # .
14566 },
14567 ],
14568 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
14569 # request before forwarding the request to the backendService.
14570 &quot;A String&quot;,
14571 ],
14572 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
14573 # client.
14574 { # Specification determining how headers are added to requests or responses.
14575 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
14576 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
14577 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
14578 # that already
14579 # exist for the header. If true, headerValue is set for the
14580 # header, discarding any values that were set for that header.
14581 #
14582 # The default value is true,
14583 # unless a variable is present in headerValue,
14584 # in which case the default value is false.
14585 # .
14586 },
14587 ],
14588 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
14589 # response before sending the response back to the client.
14590 &quot;A String&quot;,
14591 ],
14592 },
14593 &quot;matchRules&quot;: [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
14594 # this routeRule when any of thematchRules are satisfied. However predicates within
14595 # a given matchRule have AND semantics. All predicates
14596 # within a matchRule must match for the request to
14597 # match the rule.
14598 { # HttpRouteRuleMatch specifies a set of criteria for matching
14599 # requests to an HttpRouteRule. All specified criteria must
14600 # be satisfied for a match to occur.
14601 &quot;fullPathMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
14602 # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
14603 # that may be part of the original URL.
14604 #
14605 # fullPathMatch must be from 1 to 1024 characters.
14606 #
14607 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
14608 # specified.
14609 &quot;headerMatches&quot;: [ # Specifies a list of header match criteria, all of which must match
14610 # corresponding headers in the request.
14611 { # matchRule criteria for request header matches.
14612 &quot;exactMatch&quot;: &quot;A String&quot;, # The value should exactly match contents of exactMatch.
14613 #
14614 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
14615 &quot;headerName&quot;: &quot;A String&quot;, # The name of the HTTP header to match.
14616 #
14617 # For matching against the HTTP request&#x27;s authority, use a headerMatch
14618 # with the header name &quot;:authority&quot;.
14619 #
14620 # For matching a request&#x27;s method, use the headerName &quot;:method&quot;.
14621 #
14622 # When the URL map is bound to a target gRPC proxy that has
14623 # the validateForProxyless field set to true, only
14624 # non-binary
14625 # user-specified custom metadata and the `content-type` header are supported.
14626 # The following transport-level headers cannot be used in header matching
14627 # rules:
14628 # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
14629 # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
14630 # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
14631 # `grpc-timeout` and `grpc-trace-bin`.
14632 &quot;invertMatch&quot;: True or False, # If set to false, the headerMatch is considered a
14633 # match if the preceding match criteria are met. If set to true,
14634 # the headerMatch is considered a match if the preceding
14635 # match criteria are NOT met.
14636 #
14637 # The default setting is false.
14638 &quot;prefixMatch&quot;: &quot;A String&quot;, # The value of the header must start with the contents ofprefixMatch.
14639 #
14640 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
14641 &quot;presentMatch&quot;: True or False, # A header with the contents of headerName must exist. The
14642 # match takes place whether or not the request&#x27;s header has a value.
14643 #
14644 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
14645 &quot;rangeMatch&quot;: { # HttpRouteRuleMatch criteria for field values that must stay # The header value must be an integer and its value must be in the range
14646 # specified in rangeMatch. If the header does not contain an
14647 # integer, number or is empty, the match fails.
14648 #
14649 # For example for a range [-5, 0]
14650 #
14651 #
14652 # - -3 will match.
14653 # - 0 will not match.
14654 # - 0.25 will not match.
14655 # - -3someString will not match.
14656 #
14657 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
14658 #
14659 # rangeMatch is not supported for load balancers
14660 # that have loadBalancingScheme set to EXTERNAL.
14661 # within the specified integer range.
14662 &quot;rangeEnd&quot;: &quot;A String&quot;, # The end of the range (exclusive) in signed long integer format.
14663 &quot;rangeStart&quot;: &quot;A String&quot;, # The start of the range (inclusive) in signed long integer format.
14664 },
14665 &quot;regexMatch&quot;: &quot;A String&quot;, # The value of the header must match the regular expression specified inregexMatch.
14666 # For more information about regular expression syntax, see Syntax.
14667 #
14668 # For matching against a port specified in the HTTP request, use a
14669 # headerMatch with headerName set to PORT and a regular expression that
14670 # satisfies the RFC2616 Host header&#x27;s port specifier.
14671 #
14672 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
14673 #
14674 # Regular expressions can only be used when the loadBalancingScheme is
14675 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
14676 # (regional scope) or INTERNAL_MANAGED.
14677 &quot;suffixMatch&quot;: &quot;A String&quot;, # The value of the header must end with the contents ofsuffixMatch.
14678 #
14679 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
14680 },
14681 ],
14682 &quot;ignoreCase&quot;: True or False, # Specifies that prefixMatch and fullPathMatch
14683 # matches are case sensitive.
14684 #
14685 # The default value is false.
14686 #
14687 # ignoreCase must not be used with regexMatch.
14688 #
14689 # Not supported when the URL map is bound to a target gRPC proxy.
14690 &quot;metadataFilters&quot;: [ # Opaque filter criteria used by the load balancer to restrict routing
14691 # configuration to a limited set of xDS
14692 # compliant clients. In their xDS requests to the load balancer, xDS clients
14693 # present node
14694 # metadata. When there is a match, the relevant routing configuration
14695 # is made available to those proxies.
14696 #
14697 # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least one of thefilterLabels must match the corresponding label provided in
14698 # the metadata. If its filterMatchCriteria is set to
14699 # MATCH_ALL, then all of its filterLabels must match with
14700 # corresponding labels provided in the metadata. If multiple
14701 # metadata filters are specified, all of them need to be
14702 # satisfied in order to be considered a match.
14703 #
14704 # metadataFilters specified here is applied after those
14705 # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
14706 #
14707 # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
14708 #
14709 # Not supported when the URL map is bound to a target gRPC proxy that
14710 # has validateForProxyless field set to true.
14711 { # Opaque filter criteria used by load balancers to restrict routing
14712 # configuration to a limited set of load balancing proxies. Proxies and
14713 # sidecars involved in load balancing would typically present metadata to the
14714 # load balancers that need to match criteria specified here. If a match takes
14715 # place, the relevant configuration is made available to those
14716 # proxies.
14717 #
14718 # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
14719 # one of thefilterLabels must match the corresponding label provided in
14720 # the metadata. If its filterMatchCriteria is set to
14721 # MATCH_ALL, then all of its filterLabels must match with
14722 # corresponding labels provided in the metadata.
14723 #
14724 # An example for using metadataFilters would be: if
14725 # load balancing involves
14726 # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in of their XDS requests to loadbalancers.
14727 &quot;filterLabels&quot;: [ # The list of label value pairs that must match labels in the provided
14728 # metadata based on filterMatchCriteria
14729 #
14730 # This list must not be empty and can have at the most 64 entries.
14731 { # MetadataFilter label name value pairs that are expected
14732 # to match corresponding labels presented as metadata to the load balancer.
14733 &quot;name&quot;: &quot;A String&quot;, # Name of metadata label.
14734 #
14735 # The name can have a maximum length of 1024 characters and must be at
14736 # least 1 character long.
14737 &quot;value&quot;: &quot;A String&quot;, # The value of the label must match the specified value.
14738 #
14739 # value can have a maximum length of 1024 characters.
14740 },
14741 ],
14742 &quot;filterMatchCriteria&quot;: &quot;A String&quot;, # Specifies how individual filter label matches
14743 # within the list of filterLabels and contributes toward the
14744 # overall metadataFilter match.
14745 #
14746 # Supported values are:
14747 #
14748 # - MATCH_ANY: at least one of the filterLabels
14749 # must have a matching label in the provided metadata.
14750 # - MATCH_ALL: all filterLabels must have
14751 # matching labels in the provided metadata.
14752 },
14753 ],
14754 &quot;pathTemplateMatch&quot;: &quot;A String&quot;, # If specified, this field defines a path template pattern that must match
14755 # the :path header after the query string is removed.
14756 #
14757 # A path template pattern can include variables and wildcards.
14758 # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
14759 # matches a single path segment, and ** that matches zero or
14760 # more path segments. The pattern must follow these rules:
14761 #
14762 #
14763 # - The value must be between 1 and 1024 characters.
14764 # - The pattern must start with a leading slash (&quot;/&quot;).
14765 # - No more than 5 operators (variables or wildcards) may appear in
14766 # the pattern.
14767 #
14768 # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
14769 # set.
14770 &quot;prefixMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the request&#x27;s
14771 # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
14772 #
14773 # The value must be from 1 to 1024 characters.
14774 #
14775 # The * character inside a prefix match is
14776 # treated as a literal character, not as a wildcard.
14777 #
14778 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
14779 # used within a matchRule.
14780 &quot;queryParameterMatches&quot;: [ # Specifies a list of query parameter match criteria, all of which must
14781 # match corresponding query parameters in the request.
14782 #
14783 # Not supported when the URL map is bound to a target gRPC proxy.
14784 { # HttpRouteRuleMatch criteria for a request&#x27;s query parameter.
14785 &quot;exactMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
14786 # parameter exactly matches the contents of exactMatch.
14787 #
14788 # Only one of presentMatch, exactMatch, orregexMatch must be set.
14789 &quot;name&quot;: &quot;A String&quot;, # The name of the query parameter to match. The query parameter must exist in
14790 # the request, in the absence of which the request match fails.
14791 &quot;presentMatch&quot;: True or False, # Specifies that the queryParameterMatch matches if the
14792 # request contains the query parameter, irrespective of whether the
14793 # parameter has a value or not.
14794 #
14795 # Only one of presentMatch, exactMatch, orregexMatch must be set.
14796 &quot;regexMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
14797 # parameter matches the regular expression specified byregexMatch. For
14798 # more information about regular expression syntax, see Syntax.
14799 #
14800 # Only one of presentMatch, exactMatch, orregexMatch must be set.
14801 #
14802 # Regular expressions can only be used when the loadBalancingScheme is
14803 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
14804 # (regional scope) or INTERNAL_MANAGED.
14805 },
14806 ],
14807 &quot;regexMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
14808 # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
14809 # supplied with the original URL. For
14810 # more information about regular expression syntax, see Syntax.
14811 #
14812 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
14813 # specified.
14814 #
14815 # Regular expressions can only be used when the loadBalancingScheme is
14816 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
14817 # (regional scope) or INTERNAL_MANAGED.
14818 },
14819 ],
14820 &quot;priority&quot;: 42, # For routeRules within a given pathMatcher,
14821 # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
14822 # of priority, from the lowest to highest number. The priority of a
14823 # rule decreases as its number increases (1, 2, 3, N+1). The first rule
14824 # that matches the request is applied.
14825 #
14826 #
14827 # You cannot configure two or more routeRules with the same priority.
14828 # Priority for each rule must be set to a number from 0 to 2147483647
14829 # inclusive.
14830 #
14831 #
14832 # Priority numbers can have gaps, which enable you to add or remove rules
14833 # in the future without affecting the rest of the rules. For example, 1, 2,
14834 # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
14835 # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
14836 # without any impact on existing rules.
14837 &quot;routeAction&quot;: { # In response to a matching matchRule, the load balancer
14838 # performs advanced routing actions, such as URL rewrites and header
14839 # transformations, before forwarding the request to the selected backend.
14840 #
14841 #
14842 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
14843 #
14844 #
14845 # URL maps for classic Application Load Balancers only support
14846 # the urlRewrite action within a route rule&#x27;srouteAction.
14847 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
14848 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
14849 # property must be specified. This policy cannot be specified if any target
14850 # backend has Identity-Aware Proxy enabled.
14851 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
14852 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
14853 # header names can be specified. The cache is bypassed for all `cacheMode`
14854 # values.
14855 &quot;A String&quot;,
14856 ],
14857 &quot;cacheKeyPolicy&quot;: { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
14858 # on the backend type: for Backend Services, the complete request URI is
14859 # used; for Backend Buckets, the request URI is used without the protocol or
14860 # host, and only query parameters known to Cloud Storage are included.
14861 # Policy defined on Route Action.
14862 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
14863 # parameters will be included. Either specify `excludedQueryParameters`
14864 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
14865 # encoded and not treated as delimiters.
14866 #
14867 # Note: This field applies to routes that use backend services. Attempting
14868 # to set it on a route that points exclusively to Backend Buckets will
14869 # result in a configuration error. For routes that point to a Backend
14870 # Bucket, use `includedQueryParameters` to define which parameters should
14871 # be part of the cache key.
14872 &quot;A String&quot;,
14873 ],
14874 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
14875 #
14876 # Note: This setting is only applicable to routes that use a Backend
14877 # Service. It does not affect requests served by a Backend Bucket, as the
14878 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
14879 # it on a route that points exclusively to Backend Buckets will result in a
14880 # configuration error.
14881 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
14882 #
14883 # Note: This setting is only applicable to routes that use a Backend
14884 # Service. It does not affect requests served by a Backend Bucket, as the
14885 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
14886 # set on a route that points exclusively to Backend Buckets will result in
14887 # a configuration error.
14888 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
14889 # `includedQueryParameters` and `excludedQueryParameters`. If neither
14890 # is set, the entire query string will be included. If false, the query
14891 # string will be excluded from the cache key entirely.
14892 #
14893 # Note: This field applies to routes that use backend services. Attempting
14894 # to set it on a route that points exclusively to Backend Buckets will
14895 # result in a configuration error. For routes that point to a Backend
14896 # Bucket, use `includedQueryParameters` to define which parameters should
14897 # be part of the cache key.
14898 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
14899 # The name=value pair will be used in the cache key Cloud CDN generates.
14900 #
14901 # Note: This setting is only applicable to routes that use a Backend
14902 # Service. It does not affect requests served by a Backend Bucket.
14903 # Attempting to set it on a route that points exclusively to Backend
14904 # Buckets will result in a configuration error. Up to 5 cookie names can be
14905 # specified.
14906 &quot;A String&quot;,
14907 ],
14908 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
14909 &quot;A String&quot;,
14910 ],
14911 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
14912 # parameters will be excluded. Either specify `includedQueryParameters`
14913 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
14914 # encoded and not treated as delimiters.
14915 &quot;A String&quot;,
14916 ],
14917 },
14918 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
14919 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
14920 &quot;clientTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
14921 # content. This is used to clamp the max-age (or Expires) value sent to the
14922 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
14923 # is used for the response max-age directive, along with a &quot;public&quot;
14924 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
14925 # clamps the max-age from the origin (if specified), or else sets the
14926 # response max-age directive to the lesser of the `clientTtl` and
14927 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
14928 # present. The maximum allowed value is 31,622,400s (1 year). If not
14929 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
14930 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
14931 # `USE_ORIGIN_HEADERS`.
14932 # as a count of seconds and fractions of seconds at nanosecond
14933 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14934 # or &quot;month&quot;. Range is approximately 10,000 years.
14935 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14936 # Durations less than one second are represented with a 0
14937 # `seconds` field and a positive `nanos` field. Must be from 0
14938 # to 999,999,999 inclusive.
14939 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14940 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14941 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14942 },
14943 &quot;defaultTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
14944 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
14945 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
14946 # greater than that of `maxTtl`. When the `cacheMode` is set to
14947 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
14948 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
14949 # accessed objects may be evicted from the cache before the defined TTL. If
14950 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
14951 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
14952 # `USE_ORIGIN_HEADERS`.
14953 # as a count of seconds and fractions of seconds at nanosecond
14954 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14955 # or &quot;month&quot;. Range is approximately 10,000 years.
14956 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14957 # Durations less than one second are represented with a 0
14958 # `seconds` field and a positive `nanos` field. Must be from 0
14959 # to 999,999,999 inclusive.
14960 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14961 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14962 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14963 },
14964 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
14965 # attempt to set a max-age or s-maxage higher than this, or an Expires header
14966 # more than `maxTtl` seconds in the future will be capped at the value of
14967 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
14968 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
14969 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
14970 # Infrequently accessed objects may be evicted from the cache before the
14971 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
14972 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
14973 # mode.
14974 # as a count of seconds and fractions of seconds at nanosecond
14975 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14976 # or &quot;month&quot;. Range is approximately 10,000 years.
14977 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14978 # Durations less than one second are represented with a 0
14979 # `seconds` field and a positive `nanos` field. Must be from 0
14980 # to 999,999,999 inclusive.
14981 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14982 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14983 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14984 },
14985 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
14986 # to apply fine-grained caching for common errors or redirects.
14987 # This can reduce the load on your origin and improve end-user
14988 # experience by reducing response latency.
14989 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
14990 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
14991 # the specified response code that lack any Cache-Control, Expires, or
14992 # Pragma: no-cache directives. When the `cacheMode` is set to
14993 # `FORCE_CACHE_ALL`, negative caching applies to all responses
14994 # with the specified response code, and overrides any caching headers. By
14995 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
14996 #
14997 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
14998 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
14999 # * 405 (Method Not Found), 501 (Not Implemented): 60s
15000 #
15001 # These defaults can be overridden in `negativeCachingPolicy`.
15002 # If not specified, Cloud CDN applies negative caching by default.
15003 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
15004 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
15005 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
15006 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
15007 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
15008 # all response codes that you wish to cache. Cloud CDN will not apply any
15009 # default negative caching when a policy exists.
15010 { # Specify CDN TTLs for response error codes.
15011 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
15012 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
15013 # specified as values, and you cannot specify a status code more than
15014 # once.
15015 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
15016 # corresponding status code.
15017 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
15018 # objects may be evicted from the cache before the defined TTL.
15019 # as a count of seconds and fractions of seconds at nanosecond
15020 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15021 # or &quot;month&quot;. Range is approximately 10,000 years.
15022 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15023 # Durations less than one second are represented with a 0
15024 # `seconds` field and a positive `nanos` field. Must be from 0
15025 # to 999,999,999 inclusive.
15026 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15027 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15028 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15029 },
15030 },
15031 ],
15032 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
15033 # requests into a small number of requests to the origin. If not specified,
15034 # Cloud CDN applies request coalescing by default.
15035 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
15036 # content with the origin, or when an error is encountered when refreshing
15037 # the cache.
15038 # This setting defines the default &quot;max-stale&quot; duration for any cached
15039 # responses that do not specify a max-stale directive. Stale responses that
15040 # exceed the TTL configured here will not be served. The default limit
15041 # (max-stale) is 86400s (1 day), which will allow stale content to be
15042 # served up to this limit beyond the max-age (or s-maxage) of a cached
15043 # response.
15044 # The maximum allowed value is 604800 (1 week).
15045 # Set this to zero (0) to disable serve-while-stale.
15046 # as a count of seconds and fractions of seconds at nanosecond
15047 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15048 # or &quot;month&quot;. Range is approximately 10,000 years.
15049 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15050 # Durations less than one second are represented with a 0
15051 # `seconds` field and a positive `nanos` field. Must be from 0
15052 # to 999,999,999 inclusive.
15053 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15054 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15055 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15056 },
15057 },
15058 &quot;corsPolicy&quot;: { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
15059 # information about the W3C recommendation for cross-origin resource sharing
15060 # (CORS), see Fetch API Living
15061 # Standard.
15062 #
15063 # Not supported when the URL map is bound to a target gRPC proxy.
15064 # information about the W3C recommendation for cross-origin resource sharing
15065 # (CORS), see Fetch API Living
15066 # Standard.
15067 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
15068 # indicates that
15069 # the actual request can include user credentials. This field translates to
15070 # the Access-Control-Allow-Credentials header.
15071 #
15072 # Default is false.
15073 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
15074 # header.
15075 &quot;A String&quot;,
15076 ],
15077 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
15078 # header.
15079 &quot;A String&quot;,
15080 ],
15081 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
15082 # more information, see regular expression syntax.
15083 #
15084 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
15085 #
15086 # Regular expressions can only be used when the loadBalancingScheme is
15087 # set to INTERNAL_SELF_MANAGED.
15088 &quot;A String&quot;,
15089 ],
15090 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
15091 #
15092 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
15093 &quot;A String&quot;,
15094 ],
15095 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
15096 # The default value is false, which indicates that the CORS
15097 # policy is in effect.
15098 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
15099 # header.
15100 &quot;A String&quot;,
15101 ],
15102 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
15103 # seconds. This field translates to the Access-Control-Max-Age
15104 # header.
15105 },
15106 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
15107 # the resiliency of clients to backend service failure. As part of fault
15108 # injection, when clients send requests to a backend service, delays can be
15109 # introduced by a load balancer on a percentage of requests before sending
15110 # those requests to the backend service. Similarly requests from clients can
15111 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
15112 # that are configured with a fault_injection_policy if:
15113 # 1. The traffic is generated by fault injection AND
15114 # 2. The fault injection is not a delay fault injection.
15115 # Fault injection is not supported with the classic Application Load Balancer
15116 # . To see which load balancers support fault injection,
15117 # see Load
15118 # balancing: Routing and traffic management features.
15119 # the resiliency of clients to backend service failure. As part of fault
15120 # injection, when clients send requests to a backend service, delays can be
15121 # introduced by the load balancer on a percentage of requests before sending
15122 # those request to the backend service. Similarly requests from clients can be
15123 # aborted by the load balancer for a percentage of requests.
15124 &quot;abort&quot;: { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
15125 # injection.
15126 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
15127 #
15128 # The value must be from 200 to 599 inclusive.
15129 #
15130 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
15131 # according to this
15132 # mapping table. HTTP status 200 is mapped to gRPC status
15133 # UNKNOWN. Injecting an OK status is currently not supported by
15134 # Traffic Director.
15135 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
15136 # that is aborted as part of fault injection.
15137 #
15138 # The value must be from 0.0 to 100.0 inclusive.
15139 },
15140 &quot;delay&quot;: { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
15141 # injection, before being sent to a backend service.
15142 # request to the backend service as part of fault injection.
15143 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
15144 # as a count of seconds and fractions of seconds at nanosecond
15145 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15146 # or &quot;month&quot;. Range is approximately 10,000 years.
15147 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15148 # Durations less than one second are represented with a 0
15149 # `seconds` field and a positive `nanos` field. Must be from 0
15150 # to 999,999,999 inclusive.
15151 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15152 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15153 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15154 },
15155 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
15156 # which a delay is introduced as part of fault injection.
15157 #
15158 # The value must be from 0.0 to 100.0 inclusive.
15159 },
15160 },
15161 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
15162 # Unlike the timeout field where the timeout duration starts
15163 # from the time the request has been fully processed (known as*end-of-stream*),
15164 # the duration in this field is computed from the beginning of the stream
15165 # until the response has been processed, including all retries. A
15166 # stream that does not complete in this duration is closed.
15167 #
15168 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
15169 # with the route.
15170 #
15171 # This field is only allowed if the Url map is used with backend services
15172 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
15173 # as a count of seconds and fractions of seconds at nanosecond
15174 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15175 # or &quot;month&quot;. Range is approximately 10,000 years.
15176 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15177 # Durations less than one second are represented with a 0
15178 # `seconds` field and a positive `nanos` field. Must be from 0
15179 # to 999,999,999 inclusive.
15180 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15181 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15182 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15183 },
15184 &quot;requestMirrorPolicy&quot;: { # A policy that specifies how requests intended for the route&#x27;s backends # Specifies the policy on how requests intended for the route&#x27;s backends
15185 # are shadowed to a separate mirrored backend service. The load balancer does
15186 # not wait for responses from the shadow service. Before sending traffic
15187 # to the shadow service, the host / authority header is suffixed with-shadow.
15188 #
15189 # Not supported when the URL map is bound to a target gRPC proxy that
15190 # has the validateForProxyless field set to true.
15191 # are shadowed to a separate mirrored backend service. The load balancer
15192 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
15193 # to the shadow service, the host or authority header is suffixed with-shadow.
15194 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
15195 # mirrored to.
15196 #
15197 # The backend service configured for a mirroring
15198 # policy must reference backends that are of the same type as the original
15199 # backend service matched in the URL map.
15200 #
15201 # Serverless NEG backends are not currently supported as a mirrored
15202 # backend service.
15203 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
15204 },
15205 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
15206 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
15207 # If not specified, defaults to 1.
15208 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
15209 #
15210 # If not specified, will use the timeout set in theHttpRouteAction field.
15211 # If timeout in the HttpRouteAction field is not set, this field
15212 # uses the largest timeout
15213 # among all backend services associated with the route.
15214 #
15215 # Not supported when the URL map is bound to a target gRPC proxy that
15216 # has the validateForProxyless field set to true.
15217 # as a count of seconds and fractions of seconds at nanosecond
15218 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15219 # or &quot;month&quot;. Range is approximately 10,000 years.
15220 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15221 # Durations less than one second are represented with a 0
15222 # `seconds` field and a positive `nanos` field. Must be from 0
15223 # to 999,999,999 inclusive.
15224 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15225 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15226 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15227 },
15228 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
15229 # values are:
15230 #
15231 # - 5xx: retry is attempted if the instance or endpoint
15232 # responds with any 5xx response code, or if the instance or
15233 # endpoint does not respond at all. For example, disconnects, reset, read
15234 # timeout, connection failure, and refused streams.
15235 # - gateway-error: Similar to 5xx, but only
15236 # applies to response codes 502, 503 or504.
15237 # - connect-failure: a retry is attempted on failures
15238 # connecting to the instance or endpoint. For example, connection
15239 # timeouts.
15240 # - retriable-4xx: a retry is attempted if the instance
15241 # or endpoint responds with a 4xx response code.
15242 # The only error that you can retry is error code 409.
15243 # - refused-stream: a retry is attempted if the instance
15244 # or endpoint resets the stream with a REFUSED_STREAM error
15245 # code. This reset type indicates that it is safe to retry.
15246 # - cancelled: a retry is attempted if the gRPC status
15247 # code in the response header is set to cancelled.
15248 # - deadline-exceeded: a retry is attempted if the gRPC
15249 # status code in the response header is set todeadline-exceeded.
15250 # - internal: a retry is attempted if the gRPC
15251 # status code in the response header is set tointernal.
15252 # - resource-exhausted: a retry is attempted if the gRPC
15253 # status code in the response header is set toresource-exhausted.
15254 # - unavailable: a retry is attempted if the gRPC
15255 # status code in the response header is set tounavailable.
15256 #
15257 # Only the following codes are supported when the URL map is bound to
15258 # target gRPC proxy that has validateForProxyless field set to true.
15259 #
15260 # - cancelled
15261 # - deadline-exceeded
15262 # - internal
15263 # - resource-exhausted
15264 # - unavailable
15265 &quot;A String&quot;,
15266 ],
15267 },
15268 &quot;timeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
15269 # time the request has been fully processed (known as *end-of-stream*)
15270 # up until the response has been processed. Timeout includes
15271 # all retries.
15272 #
15273 # If not specified, this field uses the largest timeout among all backend
15274 # services associated with the route.
15275 #
15276 # Not supported when the URL map is bound to a target gRPC proxy that
15277 # has validateForProxyless field set to true.
15278 # as a count of seconds and fractions of seconds at nanosecond
15279 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15280 # or &quot;month&quot;. Range is approximately 10,000 years.
15281 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15282 # Durations less than one second are represented with a 0
15283 # `seconds` field and a positive `nanos` field. Must be from 0
15284 # to 999,999,999 inclusive.
15285 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15286 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15287 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15288 },
15289 &quot;urlRewrite&quot;: { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
15290 # to the matched service.
15291 #
15292 # urlRewrite is the only action supported in UrlMaps
15293 # for classic Application Load Balancers.
15294 #
15295 # Not supported when the URL map is bound to a target gRPC proxy that
15296 # has the validateForProxyless field set to true.
15297 # backend service.
15298 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
15299 # host header is replaced with contents of hostRewrite.
15300 #
15301 # The value must be from 1 to 255 characters.
15302 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
15303 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
15304 #
15305 # The value must be from 1 to 1024 characters.
15306 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
15307 # header) using the HTTP template syntax.
15308 #
15309 # A corresponding
15310 # path_template_match must be specified. Any template variables must exist in
15311 # the path_template_match field.
15312 #
15313 #
15314 # - -At least one variable must be specified in the path_template_match
15315 # field
15316 # - You can omit variables from the rewritten URL
15317 # - The * and ** operators cannot be matched
15318 # unless they have a corresponding variable name - e.g.
15319 # {format=*} or {var=**}.
15320 #
15321 # For example, a path_template_match of /static/{format=**}
15322 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
15323 # rewrite, so that /{country}/{format}/{suffix=**} can be
15324 # rewritten as /content/{format}/{country}/{suffix}.
15325 #
15326 # At least
15327 # one non-empty routeRules[].matchRules[].path_template_match is
15328 # required.
15329 #
15330 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
15331 },
15332 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
15333 # occurs. The weights determine the fraction of traffic that flows to
15334 # their corresponding backend service. If all traffic needs to
15335 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
15336 #
15337 # After a backend service is identified and before forwarding
15338 # the request to
15339 # the backend service, advanced routing actions such as URL rewrites and
15340 # header transformations are applied depending on additional settings
15341 # specified in this HttpRouteAction.
15342 { # In contrast to a single BackendService in
15343 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
15344 # multiple backend services. The volume of traffic for each
15345 # backend service is proportional to the weight specified
15346 # in each WeightedBackendService
15347 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
15348 # resource. Before
15349 # forwarding the request to backendService, the load balancer
15350 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
15351 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
15352 # effect for the selected backendService.
15353 #
15354 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
15355 #
15356 # headerAction is not supported for load balancers that have
15357 # their loadBalancingScheme set to EXTERNAL.
15358 #
15359 # Not supported when the URL map is bound to a target gRPC proxy that
15360 # has validateForProxyless field set to true.
15361 # the request is passed along to the selected backendService.
15362 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
15363 { # Specification determining how headers are added to requests or responses.
15364 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
15365 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
15366 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
15367 # that already
15368 # exist for the header. If true, headerValue is set for the
15369 # header, discarding any values that were set for that header.
15370 #
15371 # The default value is true,
15372 # unless a variable is present in headerValue,
15373 # in which case the default value is false.
15374 # .
15375 },
15376 ],
15377 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
15378 # request before forwarding the request to the backendService.
15379 &quot;A String&quot;,
15380 ],
15381 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
15382 # client.
15383 { # Specification determining how headers are added to requests or responses.
15384 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
15385 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
15386 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
15387 # that already
15388 # exist for the header. If true, headerValue is set for the
15389 # header, discarding any values that were set for that header.
15390 #
15391 # The default value is true,
15392 # unless a variable is present in headerValue,
15393 # in which case the default value is false.
15394 # .
15395 },
15396 ],
15397 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
15398 # response before sending the response back to the client.
15399 &quot;A String&quot;,
15400 ],
15401 },
15402 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
15403 # computed asweight / (sum of all weightedBackendService weights in routeAction).
15404 #
15405 # The selection of a backend service is determined only for new traffic.
15406 # Once a user&#x27;s request has been directed to a backend service,
15407 # subsequent requests are sent to the same backend service as
15408 # determined by the backend service&#x27;s session affinity policy.
15409 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
15410 # splitting. If you do, the weighted traffic splitting configuration takes
15411 # precedence.
15412 #
15413 # The value must be from 0 to 1000.
15414 },
15415 ],
15416 },
15417 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
15418 # is directed if this rule is matched. If routeAction is
15419 # also specified, advanced routing actions, such as URL rewrites,
15420 # take effect before sending the request to the backend.
15421 #
15422 #
15423 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
15424 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
15425 # specified by urlRedirect.
15426 #
15427 #
15428 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
15429 #
15430 #
15431 # Not supported when the URL map is bound to a target gRPC proxy.
15432 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
15433 # was supplied in the request.
15434 #
15435 # The value must be from 1 to 255
15436 # characters.
15437 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
15438 # set to HTTPS.
15439 # If set to false, the URL scheme of the redirected request
15440 # remains the same as that of the request.
15441 #
15442 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
15443 #
15444 # The default is set to false.
15445 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
15446 # that was supplied in the request.
15447 #
15448 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
15449 # supplied, the path of the original request is used for the redirect.
15450 #
15451 # The value must be from 1 to 1024 characters.
15452 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
15453 # the HttpRouteRuleMatch, retaining the remaining portion
15454 # of the URL before redirecting the request.
15455 #
15456 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
15457 # supplied, the path of the original request is used for the redirect.
15458 #
15459 # The value must be from 1 to 1024 characters.
15460 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
15461 #
15462 # Supported values are:
15463 #
15464 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
15465 # to 301.
15466 # - FOUND, which corresponds to 302.
15467 # - SEE_OTHER which corresponds to 303.
15468 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
15469 # method is retained.
15470 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
15471 # method is retained.
15472 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
15473 # URL is
15474 # removed before redirecting the request. If set to false, the
15475 # query portion of the original URL is retained.
15476 #
15477 # The default is set to false.
15478 },
15479 },
15480 ],
15481 },
15482 ],
15483 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the regional URL map resides.
15484 # This field is not applicable to global URL maps.
15485 # You must specify this field as part of the HTTP request URL. It is
15486 # not settable as a field in the request body.
15487 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
15488 &quot;tests&quot;: [ # The list of expected URL mapping tests. Request to update theUrlMap succeeds only if all test cases pass. You can specify a
15489 # maximum of 100 tests per UrlMap.
15490 #
15491 # Not supported when the URL map is bound to a target gRPC proxy that
15492 # has validateForProxyless field set to true.
15493 { # Message for the expected URL mappings.
15494 &quot;description&quot;: &quot;A String&quot;, # Description of this test case.
15495 &quot;expectedOutputUrl&quot;: &quot;A String&quot;, # The expected output URL evaluated by the load balancer
15496 # containing the scheme, host, path and query parameters.
15497 #
15498 # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
15499 # the load balancer to backends. For rules with urlRewrite,
15500 # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
15501 #
15502 # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer&#x27;s
15503 # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
15504 # If urlRedirect specifies strip_query, the test
15505 # passes only if expectedOutputUrl does not contain any query
15506 # parameters.
15507 #
15508 # expectedOutputUrl is optional whenservice is specified.
15509 &quot;expectedRedirectResponseCode&quot;: 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
15510 # load balancer&#x27;s redirect response.
15511 #
15512 # expectedRedirectResponseCode cannot be set whenservice is set.
15513 &quot;headers&quot;: [ # HTTP headers for this request. If headers contains
15514 # a host header, then host must also match the header value.
15515 { # HTTP headers used in UrlMapTests.
15516 &quot;name&quot;: &quot;A String&quot;, # Header name.
15517 &quot;value&quot;: &quot;A String&quot;, # Header value.
15518 },
15519 ],
15520 &quot;host&quot;: &quot;A String&quot;, # Host portion of the URL. If headers contains a host header,
15521 # then host must also match the header value.
15522 &quot;path&quot;: &quot;A String&quot;, # Path portion of the URL.
15523 &quot;service&quot;: &quot;A String&quot;, # Expected BackendService or BackendBucket resource
15524 # the given URL should be mapped to.
15525 #
15526 # The service field cannot
15527 # be set if expectedRedirectResponseCode is set.
15528 },
15529 ],
15530 },
15531 ],
15532 &quot;kind&quot;: &quot;compute#urlMapList&quot;, # Output only. Type of resource.
15533 &quot;nextPageToken&quot;: &quot;A String&quot;, # [Output Only] This token allows you to get the next page of results for
15534 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
15535 # the query parameter pageToken in the next list request.
15536 # Subsequent list requests will have their own nextPageToken to
15537 # continue paging through the results.
15538 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource.
15539 &quot;warning&quot;: { # [Output Only] Informational warning message.
15540 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
15541 # Engine returns NO_RESULTS_ON_PAGE if there
15542 # are no results in the response.
15543 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
15544 # value format. For example:
15545 #
15546 # &quot;data&quot;: [
15547 # {
15548 # &quot;key&quot;: &quot;scope&quot;,
15549 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
15550 # }
15551 {
15552 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
15553 # returned. For example, for warnings where there are no results in a list
15554 # request for a particular zone, this key might be scope and
15555 # the key value might be the zone name. Other examples might be a key
15556 # indicating a deprecated resource and a suggested replacement, or a
15557 # warning about invalid network settings (for example, if an instance
15558 # attempts to perform IP forwarding but is not enabled for IP forwarding).
15559 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
15560 },
15561 ],
15562 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
15563 },
15564 }</pre>
15565 </div>
15566
15567 <div class="method">
15568 <code class="details" id="list_next">list_next()</code>
15569 <pre>Retrieves the next page of results.
15570
15571 Args:
15572 previous_request: The request for the previous page. (required)
15573 previous_response: The response from the request for the previous page. (required)
15574
15575 Returns:
15576 A request object that you can call &#x27;execute()&#x27; on to request the next
15577 page. Returns None if there are no more items in the collection.
15578 </pre>
15579 </div>
15580
15581 <div class="method">
15582 <code class="details" id="patch">patch(project, urlMap, body=None, requestId=None, x__xgafv=None)</code>
15583 <pre>Patches the specified UrlMap resource with the data included in the
15584 request. This method supportsPATCH
15585 semantics and uses theJSON merge
15586 patch format and processing rules.
15587
15588 Args:
15589 project: string, Project ID for this request. (required)
15590 urlMap: string, Name of the UrlMap resource to patch. (required)
15591 body: object, The request body.
15592 The object takes the form of:
15593
15594 { # Represents a URL Map resource.
15595 #
15596 # Compute Engine has two URL Map resources:
15597 #
15598 # * [Global](/compute/docs/reference/rest/v1/urlMaps)
15599 # * [Regional](/compute/docs/reference/rest/v1/regionUrlMaps)
15600 #
15601 # A URL map resource is a component of certain types of cloud load balancers
15602 # and Traffic Director:
15603 #
15604 # * urlMaps are used by global external Application Load
15605 # Balancers, classic Application Load Balancers, and cross-region internal
15606 # Application Load Balancers.
15607 # * regionUrlMaps are used by internal Application Load Balancers,
15608 # regional external Application Load Balancers and regional internal
15609 # Application Load Balancers.
15610 #
15611 # For a list of supported URL map features by the load balancer type, see the
15612 # Load balancing features: Routing and traffic management table.
15613 #
15614 # For a list of supported URL map features for Traffic Director, see the
15615 # Traffic Director features: Routing and traffic management table.
15616 #
15617 # This resource defines mappings from hostnames and URL paths to either a
15618 # backend service or a backend bucket.
15619 #
15620 # To use the global urlMaps resource, the backend service must
15621 # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
15622 # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
15623 # information, read URL
15624 # Map Concepts.
15625 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
15626 # text format.
15627 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
15628 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
15629 #
15630 # This policy takes
15631 # effect at the load balancer level and applies only when no policy has been
15632 # defined for the error code at lower levels like PathMatcher, RouteRule and
15633 # PathRule within this UrlMap.
15634 #
15635 # For example, consider a UrlMap with the
15636 # following configuration:
15637 #
15638 #
15639 # - defaultCustomErrorResponsePolicy containing policies for
15640 # responding to 5xx and 4xx errors
15641 # - A PathMatcher configured for *.example.com has
15642 # defaultCustomErrorResponsePolicy for 4xx.
15643 #
15644 # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
15645 # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
15646 # a request that does not match any host in *.example.com such
15647 # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
15648 # takes effect.
15649 #
15650 # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
15651 # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
15652 # a retry, if load balancer is successful in reaching the
15653 # service, the defaultCustomErrorResponsePolicy is ignored and
15654 # the response from the service is returned to the client.
15655 #
15656 # defaultCustomErrorResponsePolicy is supported only for
15657 # global external Application Load Balancers.
15658 # backend service or backend bucket responds with an error.
15659 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
15660 #
15661 # In a given policy, if you specify rules for both a range of error codes
15662 # as well as rules for specific error codes then rules with specific error
15663 # codes have a higher priority. For example, assume that you configure a rule
15664 # for 401 (Un-authorized) code, and another for all 4 series
15665 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
15666 # However if the backend service returns a 403, the rule for4xx takes effect.
15667 { # Specifies the mapping between the response code that will be returned along
15668 # with the custom error content and the response code returned by the backend
15669 # service.
15670 &quot;matchResponseCodes&quot;: [ # Valid values include:
15671 #
15672 #
15673 # - A number between 400 and 599: For example
15674 # 401 or 503, in which case the load balancer
15675 # applies the policy if the error code exactly matches this value.
15676 # - 5xx: Load Balancer will apply the policy if the
15677 # backend service responds with any response code in the range of
15678 # 500 to 599.
15679 # - 4xx: Load
15680 # Balancer will apply the policy if the backend service responds with any
15681 # response code in the range of 400 to
15682 # 499.
15683 #
15684 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
15685 &quot;A String&quot;,
15686 ],
15687 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
15688 # error content. If overrideResponseCode is not supplied, the
15689 # same response code returned by the original backend bucket or backend
15690 # service is returned to the client.
15691 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
15692 #
15693 # path must start
15694 # with a leading slash. path cannot have trailing slashes.
15695 #
15696 # If the file is not available in backendBucket or the
15697 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
15698 #
15699 # The value must
15700 # be from 1 to 1024 characters
15701 },
15702 ],
15703 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
15704 # contains the custom error content. Examples are:
15705 #
15706 #
15707 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
15708 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
15709 # - global/backendBuckets/myBackendBucket
15710 #
15711 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
15712 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
15713 #
15714 # If load balancer cannot reach
15715 # the backendBucket, a simple Not Found Error will
15716 # be returned, with the original response code (oroverrideResponseCode if configured).
15717 #
15718 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
15719 },
15720 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
15721 # hostRules match. The load balancer performs advanced routing
15722 # actions, such as URL rewrites and header transformations, before forwarding
15723 # the request to the selected backend.
15724 #
15725 #
15726 # Only one of defaultUrlRedirect, defaultService
15727 # or defaultRouteAction.weightedBackendService can be set.
15728 #
15729 #
15730 # URL maps for classic Application Load Balancers only support
15731 # the urlRewrite action within defaultRouteAction.
15732 #
15733 #
15734 # defaultRouteAction has no effect when the URL map is bound
15735 # to a target gRPC proxy that has the validateForProxyless field
15736 # set to true.
15737 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
15738 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
15739 # property must be specified. This policy cannot be specified if any target
15740 # backend has Identity-Aware Proxy enabled.
15741 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
15742 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
15743 # header names can be specified. The cache is bypassed for all `cacheMode`
15744 # values.
15745 &quot;A String&quot;,
15746 ],
15747 &quot;cacheKeyPolicy&quot;: { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
15748 # on the backend type: for Backend Services, the complete request URI is
15749 # used; for Backend Buckets, the request URI is used without the protocol or
15750 # host, and only query parameters known to Cloud Storage are included.
15751 # Policy defined on Route Action.
15752 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
15753 # parameters will be included. Either specify `excludedQueryParameters`
15754 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
15755 # encoded and not treated as delimiters.
15756 #
15757 # Note: This field applies to routes that use backend services. Attempting
15758 # to set it on a route that points exclusively to Backend Buckets will
15759 # result in a configuration error. For routes that point to a Backend
15760 # Bucket, use `includedQueryParameters` to define which parameters should
15761 # be part of the cache key.
15762 &quot;A String&quot;,
15763 ],
15764 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
15765 #
15766 # Note: This setting is only applicable to routes that use a Backend
15767 # Service. It does not affect requests served by a Backend Bucket, as the
15768 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
15769 # it on a route that points exclusively to Backend Buckets will result in a
15770 # configuration error.
15771 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
15772 #
15773 # Note: This setting is only applicable to routes that use a Backend
15774 # Service. It does not affect requests served by a Backend Bucket, as the
15775 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
15776 # set on a route that points exclusively to Backend Buckets will result in
15777 # a configuration error.
15778 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
15779 # `includedQueryParameters` and `excludedQueryParameters`. If neither
15780 # is set, the entire query string will be included. If false, the query
15781 # string will be excluded from the cache key entirely.
15782 #
15783 # Note: This field applies to routes that use backend services. Attempting
15784 # to set it on a route that points exclusively to Backend Buckets will
15785 # result in a configuration error. For routes that point to a Backend
15786 # Bucket, use `includedQueryParameters` to define which parameters should
15787 # be part of the cache key.
15788 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
15789 # The name=value pair will be used in the cache key Cloud CDN generates.
15790 #
15791 # Note: This setting is only applicable to routes that use a Backend
15792 # Service. It does not affect requests served by a Backend Bucket.
15793 # Attempting to set it on a route that points exclusively to Backend
15794 # Buckets will result in a configuration error. Up to 5 cookie names can be
15795 # specified.
15796 &quot;A String&quot;,
15797 ],
15798 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
15799 &quot;A String&quot;,
15800 ],
15801 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
15802 # parameters will be excluded. Either specify `includedQueryParameters`
15803 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
15804 # encoded and not treated as delimiters.
15805 &quot;A String&quot;,
15806 ],
15807 },
15808 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
15809 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
15810 &quot;clientTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
15811 # content. This is used to clamp the max-age (or Expires) value sent to the
15812 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
15813 # is used for the response max-age directive, along with a &quot;public&quot;
15814 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
15815 # clamps the max-age from the origin (if specified), or else sets the
15816 # response max-age directive to the lesser of the `clientTtl` and
15817 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
15818 # present. The maximum allowed value is 31,622,400s (1 year). If not
15819 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
15820 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
15821 # `USE_ORIGIN_HEADERS`.
15822 # as a count of seconds and fractions of seconds at nanosecond
15823 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15824 # or &quot;month&quot;. Range is approximately 10,000 years.
15825 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15826 # Durations less than one second are represented with a 0
15827 # `seconds` field and a positive `nanos` field. Must be from 0
15828 # to 999,999,999 inclusive.
15829 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15830 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15831 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15832 },
15833 &quot;defaultTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
15834 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
15835 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
15836 # greater than that of `maxTtl`. When the `cacheMode` is set to
15837 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
15838 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
15839 # accessed objects may be evicted from the cache before the defined TTL. If
15840 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
15841 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
15842 # `USE_ORIGIN_HEADERS`.
15843 # as a count of seconds and fractions of seconds at nanosecond
15844 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15845 # or &quot;month&quot;. Range is approximately 10,000 years.
15846 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15847 # Durations less than one second are represented with a 0
15848 # `seconds` field and a positive `nanos` field. Must be from 0
15849 # to 999,999,999 inclusive.
15850 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15851 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15852 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15853 },
15854 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
15855 # attempt to set a max-age or s-maxage higher than this, or an Expires header
15856 # more than `maxTtl` seconds in the future will be capped at the value of
15857 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
15858 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
15859 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
15860 # Infrequently accessed objects may be evicted from the cache before the
15861 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
15862 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
15863 # mode.
15864 # as a count of seconds and fractions of seconds at nanosecond
15865 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15866 # or &quot;month&quot;. Range is approximately 10,000 years.
15867 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15868 # Durations less than one second are represented with a 0
15869 # `seconds` field and a positive `nanos` field. Must be from 0
15870 # to 999,999,999 inclusive.
15871 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15872 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15873 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15874 },
15875 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
15876 # to apply fine-grained caching for common errors or redirects.
15877 # This can reduce the load on your origin and improve end-user
15878 # experience by reducing response latency.
15879 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
15880 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
15881 # the specified response code that lack any Cache-Control, Expires, or
15882 # Pragma: no-cache directives. When the `cacheMode` is set to
15883 # `FORCE_CACHE_ALL`, negative caching applies to all responses
15884 # with the specified response code, and overrides any caching headers. By
15885 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
15886 #
15887 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
15888 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
15889 # * 405 (Method Not Found), 501 (Not Implemented): 60s
15890 #
15891 # These defaults can be overridden in `negativeCachingPolicy`.
15892 # If not specified, Cloud CDN applies negative caching by default.
15893 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
15894 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
15895 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
15896 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
15897 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
15898 # all response codes that you wish to cache. Cloud CDN will not apply any
15899 # default negative caching when a policy exists.
15900 { # Specify CDN TTLs for response error codes.
15901 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
15902 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
15903 # specified as values, and you cannot specify a status code more than
15904 # once.
15905 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
15906 # corresponding status code.
15907 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
15908 # objects may be evicted from the cache before the defined TTL.
15909 # as a count of seconds and fractions of seconds at nanosecond
15910 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15911 # or &quot;month&quot;. Range is approximately 10,000 years.
15912 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15913 # Durations less than one second are represented with a 0
15914 # `seconds` field and a positive `nanos` field. Must be from 0
15915 # to 999,999,999 inclusive.
15916 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15917 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15918 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15919 },
15920 },
15921 ],
15922 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
15923 # requests into a small number of requests to the origin. If not specified,
15924 # Cloud CDN applies request coalescing by default.
15925 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
15926 # content with the origin, or when an error is encountered when refreshing
15927 # the cache.
15928 # This setting defines the default &quot;max-stale&quot; duration for any cached
15929 # responses that do not specify a max-stale directive. Stale responses that
15930 # exceed the TTL configured here will not be served. The default limit
15931 # (max-stale) is 86400s (1 day), which will allow stale content to be
15932 # served up to this limit beyond the max-age (or s-maxage) of a cached
15933 # response.
15934 # The maximum allowed value is 604800 (1 week).
15935 # Set this to zero (0) to disable serve-while-stale.
15936 # as a count of seconds and fractions of seconds at nanosecond
15937 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15938 # or &quot;month&quot;. Range is approximately 10,000 years.
15939 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15940 # Durations less than one second are represented with a 0
15941 # `seconds` field and a positive `nanos` field. Must be from 0
15942 # to 999,999,999 inclusive.
15943 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15944 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15945 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15946 },
15947 },
15948 &quot;corsPolicy&quot;: { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
15949 # information about the W3C recommendation for cross-origin resource sharing
15950 # (CORS), see Fetch API Living
15951 # Standard.
15952 #
15953 # Not supported when the URL map is bound to a target gRPC proxy.
15954 # information about the W3C recommendation for cross-origin resource sharing
15955 # (CORS), see Fetch API Living
15956 # Standard.
15957 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
15958 # indicates that
15959 # the actual request can include user credentials. This field translates to
15960 # the Access-Control-Allow-Credentials header.
15961 #
15962 # Default is false.
15963 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
15964 # header.
15965 &quot;A String&quot;,
15966 ],
15967 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
15968 # header.
15969 &quot;A String&quot;,
15970 ],
15971 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
15972 # more information, see regular expression syntax.
15973 #
15974 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
15975 #
15976 # Regular expressions can only be used when the loadBalancingScheme is
15977 # set to INTERNAL_SELF_MANAGED.
15978 &quot;A String&quot;,
15979 ],
15980 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
15981 #
15982 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
15983 &quot;A String&quot;,
15984 ],
15985 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
15986 # The default value is false, which indicates that the CORS
15987 # policy is in effect.
15988 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
15989 # header.
15990 &quot;A String&quot;,
15991 ],
15992 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
15993 # seconds. This field translates to the Access-Control-Max-Age
15994 # header.
15995 },
15996 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
15997 # the resiliency of clients to backend service failure. As part of fault
15998 # injection, when clients send requests to a backend service, delays can be
15999 # introduced by a load balancer on a percentage of requests before sending
16000 # those requests to the backend service. Similarly requests from clients can
16001 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
16002 # that are configured with a fault_injection_policy if:
16003 # 1. The traffic is generated by fault injection AND
16004 # 2. The fault injection is not a delay fault injection.
16005 # Fault injection is not supported with the classic Application Load Balancer
16006 # . To see which load balancers support fault injection,
16007 # see Load
16008 # balancing: Routing and traffic management features.
16009 # the resiliency of clients to backend service failure. As part of fault
16010 # injection, when clients send requests to a backend service, delays can be
16011 # introduced by the load balancer on a percentage of requests before sending
16012 # those request to the backend service. Similarly requests from clients can be
16013 # aborted by the load balancer for a percentage of requests.
16014 &quot;abort&quot;: { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
16015 # injection.
16016 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
16017 #
16018 # The value must be from 200 to 599 inclusive.
16019 #
16020 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
16021 # according to this
16022 # mapping table. HTTP status 200 is mapped to gRPC status
16023 # UNKNOWN. Injecting an OK status is currently not supported by
16024 # Traffic Director.
16025 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
16026 # that is aborted as part of fault injection.
16027 #
16028 # The value must be from 0.0 to 100.0 inclusive.
16029 },
16030 &quot;delay&quot;: { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
16031 # injection, before being sent to a backend service.
16032 # request to the backend service as part of fault injection.
16033 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
16034 # as a count of seconds and fractions of seconds at nanosecond
16035 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16036 # or &quot;month&quot;. Range is approximately 10,000 years.
16037 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16038 # Durations less than one second are represented with a 0
16039 # `seconds` field and a positive `nanos` field. Must be from 0
16040 # to 999,999,999 inclusive.
16041 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16042 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16043 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16044 },
16045 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
16046 # which a delay is introduced as part of fault injection.
16047 #
16048 # The value must be from 0.0 to 100.0 inclusive.
16049 },
16050 },
16051 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
16052 # Unlike the timeout field where the timeout duration starts
16053 # from the time the request has been fully processed (known as*end-of-stream*),
16054 # the duration in this field is computed from the beginning of the stream
16055 # until the response has been processed, including all retries. A
16056 # stream that does not complete in this duration is closed.
16057 #
16058 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
16059 # with the route.
16060 #
16061 # This field is only allowed if the Url map is used with backend services
16062 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
16063 # as a count of seconds and fractions of seconds at nanosecond
16064 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16065 # or &quot;month&quot;. Range is approximately 10,000 years.
16066 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16067 # Durations less than one second are represented with a 0
16068 # `seconds` field and a positive `nanos` field. Must be from 0
16069 # to 999,999,999 inclusive.
16070 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16071 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16072 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16073 },
16074 &quot;requestMirrorPolicy&quot;: { # A policy that specifies how requests intended for the route&#x27;s backends # Specifies the policy on how requests intended for the route&#x27;s backends
16075 # are shadowed to a separate mirrored backend service. The load balancer does
16076 # not wait for responses from the shadow service. Before sending traffic
16077 # to the shadow service, the host / authority header is suffixed with-shadow.
16078 #
16079 # Not supported when the URL map is bound to a target gRPC proxy that
16080 # has the validateForProxyless field set to true.
16081 # are shadowed to a separate mirrored backend service. The load balancer
16082 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
16083 # to the shadow service, the host or authority header is suffixed with-shadow.
16084 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
16085 # mirrored to.
16086 #
16087 # The backend service configured for a mirroring
16088 # policy must reference backends that are of the same type as the original
16089 # backend service matched in the URL map.
16090 #
16091 # Serverless NEG backends are not currently supported as a mirrored
16092 # backend service.
16093 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
16094 },
16095 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
16096 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
16097 # If not specified, defaults to 1.
16098 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
16099 #
16100 # If not specified, will use the timeout set in theHttpRouteAction field.
16101 # If timeout in the HttpRouteAction field is not set, this field
16102 # uses the largest timeout
16103 # among all backend services associated with the route.
16104 #
16105 # Not supported when the URL map is bound to a target gRPC proxy that
16106 # has the validateForProxyless field set to true.
16107 # as a count of seconds and fractions of seconds at nanosecond
16108 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16109 # or &quot;month&quot;. Range is approximately 10,000 years.
16110 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16111 # Durations less than one second are represented with a 0
16112 # `seconds` field and a positive `nanos` field. Must be from 0
16113 # to 999,999,999 inclusive.
16114 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16115 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16116 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16117 },
16118 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
16119 # values are:
16120 #
16121 # - 5xx: retry is attempted if the instance or endpoint
16122 # responds with any 5xx response code, or if the instance or
16123 # endpoint does not respond at all. For example, disconnects, reset, read
16124 # timeout, connection failure, and refused streams.
16125 # - gateway-error: Similar to 5xx, but only
16126 # applies to response codes 502, 503 or504.
16127 # - connect-failure: a retry is attempted on failures
16128 # connecting to the instance or endpoint. For example, connection
16129 # timeouts.
16130 # - retriable-4xx: a retry is attempted if the instance
16131 # or endpoint responds with a 4xx response code.
16132 # The only error that you can retry is error code 409.
16133 # - refused-stream: a retry is attempted if the instance
16134 # or endpoint resets the stream with a REFUSED_STREAM error
16135 # code. This reset type indicates that it is safe to retry.
16136 # - cancelled: a retry is attempted if the gRPC status
16137 # code in the response header is set to cancelled.
16138 # - deadline-exceeded: a retry is attempted if the gRPC
16139 # status code in the response header is set todeadline-exceeded.
16140 # - internal: a retry is attempted if the gRPC
16141 # status code in the response header is set tointernal.
16142 # - resource-exhausted: a retry is attempted if the gRPC
16143 # status code in the response header is set toresource-exhausted.
16144 # - unavailable: a retry is attempted if the gRPC
16145 # status code in the response header is set tounavailable.
16146 #
16147 # Only the following codes are supported when the URL map is bound to
16148 # target gRPC proxy that has validateForProxyless field set to true.
16149 #
16150 # - cancelled
16151 # - deadline-exceeded
16152 # - internal
16153 # - resource-exhausted
16154 # - unavailable
16155 &quot;A String&quot;,
16156 ],
16157 },
16158 &quot;timeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
16159 # time the request has been fully processed (known as *end-of-stream*)
16160 # up until the response has been processed. Timeout includes
16161 # all retries.
16162 #
16163 # If not specified, this field uses the largest timeout among all backend
16164 # services associated with the route.
16165 #
16166 # Not supported when the URL map is bound to a target gRPC proxy that
16167 # has validateForProxyless field set to true.
16168 # as a count of seconds and fractions of seconds at nanosecond
16169 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16170 # or &quot;month&quot;. Range is approximately 10,000 years.
16171 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16172 # Durations less than one second are represented with a 0
16173 # `seconds` field and a positive `nanos` field. Must be from 0
16174 # to 999,999,999 inclusive.
16175 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16176 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16177 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16178 },
16179 &quot;urlRewrite&quot;: { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
16180 # to the matched service.
16181 #
16182 # urlRewrite is the only action supported in UrlMaps
16183 # for classic Application Load Balancers.
16184 #
16185 # Not supported when the URL map is bound to a target gRPC proxy that
16186 # has the validateForProxyless field set to true.
16187 # backend service.
16188 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
16189 # host header is replaced with contents of hostRewrite.
16190 #
16191 # The value must be from 1 to 255 characters.
16192 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
16193 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
16194 #
16195 # The value must be from 1 to 1024 characters.
16196 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
16197 # header) using the HTTP template syntax.
16198 #
16199 # A corresponding
16200 # path_template_match must be specified. Any template variables must exist in
16201 # the path_template_match field.
16202 #
16203 #
16204 # - -At least one variable must be specified in the path_template_match
16205 # field
16206 # - You can omit variables from the rewritten URL
16207 # - The * and ** operators cannot be matched
16208 # unless they have a corresponding variable name - e.g.
16209 # {format=*} or {var=**}.
16210 #
16211 # For example, a path_template_match of /static/{format=**}
16212 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
16213 # rewrite, so that /{country}/{format}/{suffix=**} can be
16214 # rewritten as /content/{format}/{country}/{suffix}.
16215 #
16216 # At least
16217 # one non-empty routeRules[].matchRules[].path_template_match is
16218 # required.
16219 #
16220 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
16221 },
16222 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
16223 # occurs. The weights determine the fraction of traffic that flows to
16224 # their corresponding backend service. If all traffic needs to
16225 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
16226 #
16227 # After a backend service is identified and before forwarding
16228 # the request to
16229 # the backend service, advanced routing actions such as URL rewrites and
16230 # header transformations are applied depending on additional settings
16231 # specified in this HttpRouteAction.
16232 { # In contrast to a single BackendService in
16233 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
16234 # multiple backend services. The volume of traffic for each
16235 # backend service is proportional to the weight specified
16236 # in each WeightedBackendService
16237 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
16238 # resource. Before
16239 # forwarding the request to backendService, the load balancer
16240 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
16241 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
16242 # effect for the selected backendService.
16243 #
16244 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
16245 #
16246 # headerAction is not supported for load balancers that have
16247 # their loadBalancingScheme set to EXTERNAL.
16248 #
16249 # Not supported when the URL map is bound to a target gRPC proxy that
16250 # has validateForProxyless field set to true.
16251 # the request is passed along to the selected backendService.
16252 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
16253 { # Specification determining how headers are added to requests or responses.
16254 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
16255 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
16256 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
16257 # that already
16258 # exist for the header. If true, headerValue is set for the
16259 # header, discarding any values that were set for that header.
16260 #
16261 # The default value is true,
16262 # unless a variable is present in headerValue,
16263 # in which case the default value is false.
16264 # .
16265 },
16266 ],
16267 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
16268 # request before forwarding the request to the backendService.
16269 &quot;A String&quot;,
16270 ],
16271 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
16272 # client.
16273 { # Specification determining how headers are added to requests or responses.
16274 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
16275 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
16276 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
16277 # that already
16278 # exist for the header. If true, headerValue is set for the
16279 # header, discarding any values that were set for that header.
16280 #
16281 # The default value is true,
16282 # unless a variable is present in headerValue,
16283 # in which case the default value is false.
16284 # .
16285 },
16286 ],
16287 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
16288 # response before sending the response back to the client.
16289 &quot;A String&quot;,
16290 ],
16291 },
16292 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
16293 # computed asweight / (sum of all weightedBackendService weights in routeAction).
16294 #
16295 # The selection of a backend service is determined only for new traffic.
16296 # Once a user&#x27;s request has been directed to a backend service,
16297 # subsequent requests are sent to the same backend service as
16298 # determined by the backend service&#x27;s session affinity policy.
16299 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
16300 # splitting. If you do, the weighted traffic splitting configuration takes
16301 # precedence.
16302 #
16303 # The value must be from 0 to 1000.
16304 },
16305 ],
16306 },
16307 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL of the defaultService resource to
16308 # which traffic is directed if none of the hostRules match.
16309 # If defaultRouteAction is also specified, advanced
16310 # routing actions, such as URL rewrites, take effect before sending the
16311 # request to the backend.
16312 #
16313 #
16314 # Only one of defaultUrlRedirect, defaultService
16315 # or defaultRouteAction.weightedBackendService can be set.
16316 #
16317 #
16318 # defaultService has no effect when the URL map is bound
16319 # to a target gRPC proxy that has the validateForProxyless field
16320 # set to true.
16321 &quot;defaultUrlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
16322 # is redirected to a URL specified by defaultUrlRedirect.
16323 #
16324 #
16325 # Only one of defaultUrlRedirect, defaultService
16326 # or defaultRouteAction.weightedBackendService can be set.
16327 #
16328 #
16329 # Not supported when the URL map is bound to a target gRPC proxy.
16330 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
16331 # was supplied in the request.
16332 #
16333 # The value must be from 1 to 255
16334 # characters.
16335 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
16336 # set to HTTPS.
16337 # If set to false, the URL scheme of the redirected request
16338 # remains the same as that of the request.
16339 #
16340 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
16341 #
16342 # The default is set to false.
16343 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
16344 # that was supplied in the request.
16345 #
16346 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
16347 # supplied, the path of the original request is used for the redirect.
16348 #
16349 # The value must be from 1 to 1024 characters.
16350 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
16351 # the HttpRouteRuleMatch, retaining the remaining portion
16352 # of the URL before redirecting the request.
16353 #
16354 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
16355 # supplied, the path of the original request is used for the redirect.
16356 #
16357 # The value must be from 1 to 1024 characters.
16358 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
16359 #
16360 # Supported values are:
16361 #
16362 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
16363 # to 301.
16364 # - FOUND, which corresponds to 302.
16365 # - SEE_OTHER which corresponds to 303.
16366 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
16367 # method is retained.
16368 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
16369 # method is retained.
16370 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
16371 # URL is
16372 # removed before redirecting the request. If set to false, the
16373 # query portion of the original URL is retained.
16374 #
16375 # The default is set to false.
16376 },
16377 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
16378 # create the resource.
16379 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. A hash of the contents stored in this object.
16380 # This field is used in optimistic locking. This field is ignored when
16381 # inserting a UrlMap. An up-to-date fingerprint must be provided
16382 # in order to update the UrlMap, otherwise the request will
16383 # fail with error 412 conditionNotMet.
16384 #
16385 # To see the latest fingerprint, make a get() request to
16386 # retrieve a UrlMap.
16387 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
16388 # for the selected backendService.
16389 #
16390 # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
16391 #
16392 # headerAction is not supported for load balancers
16393 # that have
16394 # their loadBalancingScheme set to EXTERNAL.
16395 #
16396 # Not supported when the URL map is bound to a target gRPC proxy that
16397 # has validateForProxyless field set to true.
16398 # the request is passed along to the selected backendService.
16399 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
16400 { # Specification determining how headers are added to requests or responses.
16401 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
16402 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
16403 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
16404 # that already
16405 # exist for the header. If true, headerValue is set for the
16406 # header, discarding any values that were set for that header.
16407 #
16408 # The default value is true,
16409 # unless a variable is present in headerValue,
16410 # in which case the default value is false.
16411 # .
16412 },
16413 ],
16414 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
16415 # request before forwarding the request to the backendService.
16416 &quot;A String&quot;,
16417 ],
16418 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
16419 # client.
16420 { # Specification determining how headers are added to requests or responses.
16421 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
16422 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
16423 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
16424 # that already
16425 # exist for the header. If true, headerValue is set for the
16426 # header, discarding any values that were set for that header.
16427 #
16428 # The default value is true,
16429 # unless a variable is present in headerValue,
16430 # in which case the default value is false.
16431 # .
16432 },
16433 ],
16434 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
16435 # response before sending the response back to the client.
16436 &quot;A String&quot;,
16437 ],
16438 },
16439 &quot;hostRules&quot;: [ # The list of host rules to use against the URL.
16440 { # UrlMaps
16441 # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
16442 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
16443 # create the resource.
16444 &quot;hosts&quot;: [ # The list of host patterns to match. They must be valid hostnames with
16445 # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
16446 # that case, * must be the first character, and if followed by
16447 # anything, the immediate following character must be either -
16448 # or ..
16449 #
16450 # * based matching is not supported when the URL map is bound
16451 # to a target gRPC proxy that has the validateForProxyless field
16452 # set to true.
16453 &quot;A String&quot;,
16454 ],
16455 &quot;pathMatcher&quot;: &quot;A String&quot;, # The name of the PathMatcher to use to match the path portion
16456 # of the URL if the hostRule matches the URL&#x27;s host portion.
16457 },
16458 ],
16459 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the resource. This identifier is
16460 # defined by the server.
16461 &quot;kind&quot;: &quot;compute#urlMap&quot;, # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
16462 # url maps.
16463 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
16464 # The name must be 1-63 characters long, and comply withRFC1035.
16465 # Specifically, the name must be 1-63 characters long and match the regular
16466 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
16467 # character must be a lowercase letter, and all following characters must
16468 # be a dash, lowercase letter, or digit, except the last character, which
16469 # cannot be a dash.
16470 &quot;pathMatchers&quot;: [ # The list of named PathMatchers to use against the URL.
16471 { # A matcher for the path portion of the URL. The BackendService
16472 # from the longest-matched rule will serve the URL. If no rule was matched, the
16473 # default service is used.
16474 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
16475 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
16476 #
16477 # This policy takes
16478 # effect at the PathMatcher level and applies only when no
16479 # policy has been defined for the error code at lower levels likeRouteRule and PathRule within thisPathMatcher. If an error code does not have a policy defined
16480 # in defaultCustomErrorResponsePolicy, then a policy defined for
16481 # the error code in UrlMap.defaultCustomErrorResponsePolicy
16482 # takes effect.
16483 #
16484 # For example, consider a UrlMap with the following
16485 # configuration:
16486 #
16487 #
16488 # - UrlMap.defaultCustomErrorResponsePolicy is configured
16489 # with policies for 5xx and 4xx errors
16490 # - A RouteRule for /coming_soon/ is configured for the
16491 # error code 404.
16492 #
16493 # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher&#x27;s policy
16494 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
16495 # the policy in RouteRule.customErrorResponsePolicy takes
16496 # effect. If any of the requests in this example encounter a 500
16497 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
16498 #
16499 # When
16500 # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
16501 # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
16502 # a retry, if load balancer is successful in reaching the
16503 # service, the defaultCustomErrorResponsePolicy is ignored and
16504 # the response from the service is returned to the client.
16505 #
16506 # defaultCustomErrorResponsePolicy is supported only for
16507 # global external Application Load Balancers.
16508 # backend service or backend bucket responds with an error.
16509 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
16510 #
16511 # In a given policy, if you specify rules for both a range of error codes
16512 # as well as rules for specific error codes then rules with specific error
16513 # codes have a higher priority. For example, assume that you configure a rule
16514 # for 401 (Un-authorized) code, and another for all 4 series
16515 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
16516 # However if the backend service returns a 403, the rule for4xx takes effect.
16517 { # Specifies the mapping between the response code that will be returned along
16518 # with the custom error content and the response code returned by the backend
16519 # service.
16520 &quot;matchResponseCodes&quot;: [ # Valid values include:
16521 #
16522 #
16523 # - A number between 400 and 599: For example
16524 # 401 or 503, in which case the load balancer
16525 # applies the policy if the error code exactly matches this value.
16526 # - 5xx: Load Balancer will apply the policy if the
16527 # backend service responds with any response code in the range of
16528 # 500 to 599.
16529 # - 4xx: Load
16530 # Balancer will apply the policy if the backend service responds with any
16531 # response code in the range of 400 to
16532 # 499.
16533 #
16534 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
16535 &quot;A String&quot;,
16536 ],
16537 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
16538 # error content. If overrideResponseCode is not supplied, the
16539 # same response code returned by the original backend bucket or backend
16540 # service is returned to the client.
16541 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
16542 #
16543 # path must start
16544 # with a leading slash. path cannot have trailing slashes.
16545 #
16546 # If the file is not available in backendBucket or the
16547 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
16548 #
16549 # The value must
16550 # be from 1 to 1024 characters
16551 },
16552 ],
16553 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
16554 # contains the custom error content. Examples are:
16555 #
16556 #
16557 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
16558 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
16559 # - global/backendBuckets/myBackendBucket
16560 #
16561 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
16562 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
16563 #
16564 # If load balancer cannot reach
16565 # the backendBucket, a simple Not Found Error will
16566 # be returned, with the original response code (oroverrideResponseCode if configured).
16567 #
16568 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
16569 },
16570 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
16571 # pathRules or routeRules match. The load balancer
16572 # performs advanced routing actions, such as URL rewrites and
16573 # header transformations, before forwarding the request to the
16574 # selected backend.
16575 #
16576 #
16577 # Only one of defaultUrlRedirect, defaultService
16578 # or defaultRouteAction.weightedBackendService can be set.
16579 #
16580 #
16581 # URL maps for classic Application Load Balancers only support
16582 # the urlRewrite action within a path matcher&#x27;sdefaultRouteAction.
16583 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
16584 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
16585 # property must be specified. This policy cannot be specified if any target
16586 # backend has Identity-Aware Proxy enabled.
16587 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
16588 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
16589 # header names can be specified. The cache is bypassed for all `cacheMode`
16590 # values.
16591 &quot;A String&quot;,
16592 ],
16593 &quot;cacheKeyPolicy&quot;: { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
16594 # on the backend type: for Backend Services, the complete request URI is
16595 # used; for Backend Buckets, the request URI is used without the protocol or
16596 # host, and only query parameters known to Cloud Storage are included.
16597 # Policy defined on Route Action.
16598 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
16599 # parameters will be included. Either specify `excludedQueryParameters`
16600 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
16601 # encoded and not treated as delimiters.
16602 #
16603 # Note: This field applies to routes that use backend services. Attempting
16604 # to set it on a route that points exclusively to Backend Buckets will
16605 # result in a configuration error. For routes that point to a Backend
16606 # Bucket, use `includedQueryParameters` to define which parameters should
16607 # be part of the cache key.
16608 &quot;A String&quot;,
16609 ],
16610 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
16611 #
16612 # Note: This setting is only applicable to routes that use a Backend
16613 # Service. It does not affect requests served by a Backend Bucket, as the
16614 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
16615 # it on a route that points exclusively to Backend Buckets will result in a
16616 # configuration error.
16617 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
16618 #
16619 # Note: This setting is only applicable to routes that use a Backend
16620 # Service. It does not affect requests served by a Backend Bucket, as the
16621 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
16622 # set on a route that points exclusively to Backend Buckets will result in
16623 # a configuration error.
16624 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
16625 # `includedQueryParameters` and `excludedQueryParameters`. If neither
16626 # is set, the entire query string will be included. If false, the query
16627 # string will be excluded from the cache key entirely.
16628 #
16629 # Note: This field applies to routes that use backend services. Attempting
16630 # to set it on a route that points exclusively to Backend Buckets will
16631 # result in a configuration error. For routes that point to a Backend
16632 # Bucket, use `includedQueryParameters` to define which parameters should
16633 # be part of the cache key.
16634 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
16635 # The name=value pair will be used in the cache key Cloud CDN generates.
16636 #
16637 # Note: This setting is only applicable to routes that use a Backend
16638 # Service. It does not affect requests served by a Backend Bucket.
16639 # Attempting to set it on a route that points exclusively to Backend
16640 # Buckets will result in a configuration error. Up to 5 cookie names can be
16641 # specified.
16642 &quot;A String&quot;,
16643 ],
16644 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
16645 &quot;A String&quot;,
16646 ],
16647 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
16648 # parameters will be excluded. Either specify `includedQueryParameters`
16649 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
16650 # encoded and not treated as delimiters.
16651 &quot;A String&quot;,
16652 ],
16653 },
16654 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
16655 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
16656 &quot;clientTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
16657 # content. This is used to clamp the max-age (or Expires) value sent to the
16658 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
16659 # is used for the response max-age directive, along with a &quot;public&quot;
16660 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
16661 # clamps the max-age from the origin (if specified), or else sets the
16662 # response max-age directive to the lesser of the `clientTtl` and
16663 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
16664 # present. The maximum allowed value is 31,622,400s (1 year). If not
16665 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
16666 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
16667 # `USE_ORIGIN_HEADERS`.
16668 # as a count of seconds and fractions of seconds at nanosecond
16669 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16670 # or &quot;month&quot;. Range is approximately 10,000 years.
16671 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16672 # Durations less than one second are represented with a 0
16673 # `seconds` field and a positive `nanos` field. Must be from 0
16674 # to 999,999,999 inclusive.
16675 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16676 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16677 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16678 },
16679 &quot;defaultTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
16680 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
16681 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
16682 # greater than that of `maxTtl`. When the `cacheMode` is set to
16683 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
16684 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
16685 # accessed objects may be evicted from the cache before the defined TTL. If
16686 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
16687 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
16688 # `USE_ORIGIN_HEADERS`.
16689 # as a count of seconds and fractions of seconds at nanosecond
16690 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16691 # or &quot;month&quot;. Range is approximately 10,000 years.
16692 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16693 # Durations less than one second are represented with a 0
16694 # `seconds` field and a positive `nanos` field. Must be from 0
16695 # to 999,999,999 inclusive.
16696 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16697 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16698 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16699 },
16700 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
16701 # attempt to set a max-age or s-maxage higher than this, or an Expires header
16702 # more than `maxTtl` seconds in the future will be capped at the value of
16703 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
16704 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
16705 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
16706 # Infrequently accessed objects may be evicted from the cache before the
16707 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
16708 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
16709 # mode.
16710 # as a count of seconds and fractions of seconds at nanosecond
16711 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16712 # or &quot;month&quot;. Range is approximately 10,000 years.
16713 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16714 # Durations less than one second are represented with a 0
16715 # `seconds` field and a positive `nanos` field. Must be from 0
16716 # to 999,999,999 inclusive.
16717 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16718 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16719 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16720 },
16721 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
16722 # to apply fine-grained caching for common errors or redirects.
16723 # This can reduce the load on your origin and improve end-user
16724 # experience by reducing response latency.
16725 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
16726 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
16727 # the specified response code that lack any Cache-Control, Expires, or
16728 # Pragma: no-cache directives. When the `cacheMode` is set to
16729 # `FORCE_CACHE_ALL`, negative caching applies to all responses
16730 # with the specified response code, and overrides any caching headers. By
16731 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
16732 #
16733 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
16734 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
16735 # * 405 (Method Not Found), 501 (Not Implemented): 60s
16736 #
16737 # These defaults can be overridden in `negativeCachingPolicy`.
16738 # If not specified, Cloud CDN applies negative caching by default.
16739 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
16740 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
16741 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
16742 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
16743 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
16744 # all response codes that you wish to cache. Cloud CDN will not apply any
16745 # default negative caching when a policy exists.
16746 { # Specify CDN TTLs for response error codes.
16747 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
16748 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
16749 # specified as values, and you cannot specify a status code more than
16750 # once.
16751 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
16752 # corresponding status code.
16753 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
16754 # objects may be evicted from the cache before the defined TTL.
16755 # as a count of seconds and fractions of seconds at nanosecond
16756 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16757 # or &quot;month&quot;. Range is approximately 10,000 years.
16758 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16759 # Durations less than one second are represented with a 0
16760 # `seconds` field and a positive `nanos` field. Must be from 0
16761 # to 999,999,999 inclusive.
16762 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16763 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16764 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16765 },
16766 },
16767 ],
16768 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
16769 # requests into a small number of requests to the origin. If not specified,
16770 # Cloud CDN applies request coalescing by default.
16771 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
16772 # content with the origin, or when an error is encountered when refreshing
16773 # the cache.
16774 # This setting defines the default &quot;max-stale&quot; duration for any cached
16775 # responses that do not specify a max-stale directive. Stale responses that
16776 # exceed the TTL configured here will not be served. The default limit
16777 # (max-stale) is 86400s (1 day), which will allow stale content to be
16778 # served up to this limit beyond the max-age (or s-maxage) of a cached
16779 # response.
16780 # The maximum allowed value is 604800 (1 week).
16781 # Set this to zero (0) to disable serve-while-stale.
16782 # as a count of seconds and fractions of seconds at nanosecond
16783 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16784 # or &quot;month&quot;. Range is approximately 10,000 years.
16785 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16786 # Durations less than one second are represented with a 0
16787 # `seconds` field and a positive `nanos` field. Must be from 0
16788 # to 999,999,999 inclusive.
16789 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16790 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16791 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16792 },
16793 },
16794 &quot;corsPolicy&quot;: { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
16795 # information about the W3C recommendation for cross-origin resource sharing
16796 # (CORS), see Fetch API Living
16797 # Standard.
16798 #
16799 # Not supported when the URL map is bound to a target gRPC proxy.
16800 # information about the W3C recommendation for cross-origin resource sharing
16801 # (CORS), see Fetch API Living
16802 # Standard.
16803 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
16804 # indicates that
16805 # the actual request can include user credentials. This field translates to
16806 # the Access-Control-Allow-Credentials header.
16807 #
16808 # Default is false.
16809 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
16810 # header.
16811 &quot;A String&quot;,
16812 ],
16813 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
16814 # header.
16815 &quot;A String&quot;,
16816 ],
16817 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
16818 # more information, see regular expression syntax.
16819 #
16820 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
16821 #
16822 # Regular expressions can only be used when the loadBalancingScheme is
16823 # set to INTERNAL_SELF_MANAGED.
16824 &quot;A String&quot;,
16825 ],
16826 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
16827 #
16828 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
16829 &quot;A String&quot;,
16830 ],
16831 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
16832 # The default value is false, which indicates that the CORS
16833 # policy is in effect.
16834 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
16835 # header.
16836 &quot;A String&quot;,
16837 ],
16838 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
16839 # seconds. This field translates to the Access-Control-Max-Age
16840 # header.
16841 },
16842 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
16843 # the resiliency of clients to backend service failure. As part of fault
16844 # injection, when clients send requests to a backend service, delays can be
16845 # introduced by a load balancer on a percentage of requests before sending
16846 # those requests to the backend service. Similarly requests from clients can
16847 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
16848 # that are configured with a fault_injection_policy if:
16849 # 1. The traffic is generated by fault injection AND
16850 # 2. The fault injection is not a delay fault injection.
16851 # Fault injection is not supported with the classic Application Load Balancer
16852 # . To see which load balancers support fault injection,
16853 # see Load
16854 # balancing: Routing and traffic management features.
16855 # the resiliency of clients to backend service failure. As part of fault
16856 # injection, when clients send requests to a backend service, delays can be
16857 # introduced by the load balancer on a percentage of requests before sending
16858 # those request to the backend service. Similarly requests from clients can be
16859 # aborted by the load balancer for a percentage of requests.
16860 &quot;abort&quot;: { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
16861 # injection.
16862 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
16863 #
16864 # The value must be from 200 to 599 inclusive.
16865 #
16866 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
16867 # according to this
16868 # mapping table. HTTP status 200 is mapped to gRPC status
16869 # UNKNOWN. Injecting an OK status is currently not supported by
16870 # Traffic Director.
16871 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
16872 # that is aborted as part of fault injection.
16873 #
16874 # The value must be from 0.0 to 100.0 inclusive.
16875 },
16876 &quot;delay&quot;: { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
16877 # injection, before being sent to a backend service.
16878 # request to the backend service as part of fault injection.
16879 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
16880 # as a count of seconds and fractions of seconds at nanosecond
16881 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16882 # or &quot;month&quot;. Range is approximately 10,000 years.
16883 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16884 # Durations less than one second are represented with a 0
16885 # `seconds` field and a positive `nanos` field. Must be from 0
16886 # to 999,999,999 inclusive.
16887 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16888 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16889 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16890 },
16891 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
16892 # which a delay is introduced as part of fault injection.
16893 #
16894 # The value must be from 0.0 to 100.0 inclusive.
16895 },
16896 },
16897 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
16898 # Unlike the timeout field where the timeout duration starts
16899 # from the time the request has been fully processed (known as*end-of-stream*),
16900 # the duration in this field is computed from the beginning of the stream
16901 # until the response has been processed, including all retries. A
16902 # stream that does not complete in this duration is closed.
16903 #
16904 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
16905 # with the route.
16906 #
16907 # This field is only allowed if the Url map is used with backend services
16908 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
16909 # as a count of seconds and fractions of seconds at nanosecond
16910 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16911 # or &quot;month&quot;. Range is approximately 10,000 years.
16912 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16913 # Durations less than one second are represented with a 0
16914 # `seconds` field and a positive `nanos` field. Must be from 0
16915 # to 999,999,999 inclusive.
16916 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16917 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16918 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16919 },
16920 &quot;requestMirrorPolicy&quot;: { # A policy that specifies how requests intended for the route&#x27;s backends # Specifies the policy on how requests intended for the route&#x27;s backends
16921 # are shadowed to a separate mirrored backend service. The load balancer does
16922 # not wait for responses from the shadow service. Before sending traffic
16923 # to the shadow service, the host / authority header is suffixed with-shadow.
16924 #
16925 # Not supported when the URL map is bound to a target gRPC proxy that
16926 # has the validateForProxyless field set to true.
16927 # are shadowed to a separate mirrored backend service. The load balancer
16928 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
16929 # to the shadow service, the host or authority header is suffixed with-shadow.
16930 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
16931 # mirrored to.
16932 #
16933 # The backend service configured for a mirroring
16934 # policy must reference backends that are of the same type as the original
16935 # backend service matched in the URL map.
16936 #
16937 # Serverless NEG backends are not currently supported as a mirrored
16938 # backend service.
16939 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
16940 },
16941 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
16942 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
16943 # If not specified, defaults to 1.
16944 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
16945 #
16946 # If not specified, will use the timeout set in theHttpRouteAction field.
16947 # If timeout in the HttpRouteAction field is not set, this field
16948 # uses the largest timeout
16949 # among all backend services associated with the route.
16950 #
16951 # Not supported when the URL map is bound to a target gRPC proxy that
16952 # has the validateForProxyless field set to true.
16953 # as a count of seconds and fractions of seconds at nanosecond
16954 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16955 # or &quot;month&quot;. Range is approximately 10,000 years.
16956 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16957 # Durations less than one second are represented with a 0
16958 # `seconds` field and a positive `nanos` field. Must be from 0
16959 # to 999,999,999 inclusive.
16960 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16961 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16962 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16963 },
16964 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
16965 # values are:
16966 #
16967 # - 5xx: retry is attempted if the instance or endpoint
16968 # responds with any 5xx response code, or if the instance or
16969 # endpoint does not respond at all. For example, disconnects, reset, read
16970 # timeout, connection failure, and refused streams.
16971 # - gateway-error: Similar to 5xx, but only
16972 # applies to response codes 502, 503 or504.
16973 # - connect-failure: a retry is attempted on failures
16974 # connecting to the instance or endpoint. For example, connection
16975 # timeouts.
16976 # - retriable-4xx: a retry is attempted if the instance
16977 # or endpoint responds with a 4xx response code.
16978 # The only error that you can retry is error code 409.
16979 # - refused-stream: a retry is attempted if the instance
16980 # or endpoint resets the stream with a REFUSED_STREAM error
16981 # code. This reset type indicates that it is safe to retry.
16982 # - cancelled: a retry is attempted if the gRPC status
16983 # code in the response header is set to cancelled.
16984 # - deadline-exceeded: a retry is attempted if the gRPC
16985 # status code in the response header is set todeadline-exceeded.
16986 # - internal: a retry is attempted if the gRPC
16987 # status code in the response header is set tointernal.
16988 # - resource-exhausted: a retry is attempted if the gRPC
16989 # status code in the response header is set toresource-exhausted.
16990 # - unavailable: a retry is attempted if the gRPC
16991 # status code in the response header is set tounavailable.
16992 #
16993 # Only the following codes are supported when the URL map is bound to
16994 # target gRPC proxy that has validateForProxyless field set to true.
16995 #
16996 # - cancelled
16997 # - deadline-exceeded
16998 # - internal
16999 # - resource-exhausted
17000 # - unavailable
17001 &quot;A String&quot;,
17002 ],
17003 },
17004 &quot;timeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
17005 # time the request has been fully processed (known as *end-of-stream*)
17006 # up until the response has been processed. Timeout includes
17007 # all retries.
17008 #
17009 # If not specified, this field uses the largest timeout among all backend
17010 # services associated with the route.
17011 #
17012 # Not supported when the URL map is bound to a target gRPC proxy that
17013 # has validateForProxyless field set to true.
17014 # as a count of seconds and fractions of seconds at nanosecond
17015 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17016 # or &quot;month&quot;. Range is approximately 10,000 years.
17017 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17018 # Durations less than one second are represented with a 0
17019 # `seconds` field and a positive `nanos` field. Must be from 0
17020 # to 999,999,999 inclusive.
17021 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17022 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17023 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17024 },
17025 &quot;urlRewrite&quot;: { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
17026 # to the matched service.
17027 #
17028 # urlRewrite is the only action supported in UrlMaps
17029 # for classic Application Load Balancers.
17030 #
17031 # Not supported when the URL map is bound to a target gRPC proxy that
17032 # has the validateForProxyless field set to true.
17033 # backend service.
17034 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
17035 # host header is replaced with contents of hostRewrite.
17036 #
17037 # The value must be from 1 to 255 characters.
17038 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
17039 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
17040 #
17041 # The value must be from 1 to 1024 characters.
17042 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
17043 # header) using the HTTP template syntax.
17044 #
17045 # A corresponding
17046 # path_template_match must be specified. Any template variables must exist in
17047 # the path_template_match field.
17048 #
17049 #
17050 # - -At least one variable must be specified in the path_template_match
17051 # field
17052 # - You can omit variables from the rewritten URL
17053 # - The * and ** operators cannot be matched
17054 # unless they have a corresponding variable name - e.g.
17055 # {format=*} or {var=**}.
17056 #
17057 # For example, a path_template_match of /static/{format=**}
17058 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
17059 # rewrite, so that /{country}/{format}/{suffix=**} can be
17060 # rewritten as /content/{format}/{country}/{suffix}.
17061 #
17062 # At least
17063 # one non-empty routeRules[].matchRules[].path_template_match is
17064 # required.
17065 #
17066 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
17067 },
17068 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
17069 # occurs. The weights determine the fraction of traffic that flows to
17070 # their corresponding backend service. If all traffic needs to
17071 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
17072 #
17073 # After a backend service is identified and before forwarding
17074 # the request to
17075 # the backend service, advanced routing actions such as URL rewrites and
17076 # header transformations are applied depending on additional settings
17077 # specified in this HttpRouteAction.
17078 { # In contrast to a single BackendService in
17079 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
17080 # multiple backend services. The volume of traffic for each
17081 # backend service is proportional to the weight specified
17082 # in each WeightedBackendService
17083 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
17084 # resource. Before
17085 # forwarding the request to backendService, the load balancer
17086 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
17087 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
17088 # effect for the selected backendService.
17089 #
17090 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
17091 #
17092 # headerAction is not supported for load balancers that have
17093 # their loadBalancingScheme set to EXTERNAL.
17094 #
17095 # Not supported when the URL map is bound to a target gRPC proxy that
17096 # has validateForProxyless field set to true.
17097 # the request is passed along to the selected backendService.
17098 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
17099 { # Specification determining how headers are added to requests or responses.
17100 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
17101 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
17102 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
17103 # that already
17104 # exist for the header. If true, headerValue is set for the
17105 # header, discarding any values that were set for that header.
17106 #
17107 # The default value is true,
17108 # unless a variable is present in headerValue,
17109 # in which case the default value is false.
17110 # .
17111 },
17112 ],
17113 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
17114 # request before forwarding the request to the backendService.
17115 &quot;A String&quot;,
17116 ],
17117 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
17118 # client.
17119 { # Specification determining how headers are added to requests or responses.
17120 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
17121 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
17122 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
17123 # that already
17124 # exist for the header. If true, headerValue is set for the
17125 # header, discarding any values that were set for that header.
17126 #
17127 # The default value is true,
17128 # unless a variable is present in headerValue,
17129 # in which case the default value is false.
17130 # .
17131 },
17132 ],
17133 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
17134 # response before sending the response back to the client.
17135 &quot;A String&quot;,
17136 ],
17137 },
17138 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
17139 # computed asweight / (sum of all weightedBackendService weights in routeAction).
17140 #
17141 # The selection of a backend service is determined only for new traffic.
17142 # Once a user&#x27;s request has been directed to a backend service,
17143 # subsequent requests are sent to the same backend service as
17144 # determined by the backend service&#x27;s session affinity policy.
17145 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
17146 # splitting. If you do, the weighted traffic splitting configuration takes
17147 # precedence.
17148 #
17149 # The value must be from 0 to 1000.
17150 },
17151 ],
17152 },
17153 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource. This
17154 # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
17155 # matched. For example, the
17156 # following are all valid URLs to a BackendService resource:
17157 #
17158 #
17159 # - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
17160 # - compute/v1/projects/project/global/backendServices/backendService
17161 # - global/backendServices/backendService
17162 #
17163 #
17164 # If defaultRouteAction is also specified, advanced
17165 # routing actions, such as URL rewrites, take effect before sending the
17166 # request to the backend.
17167 #
17168 #
17169 # Only one of defaultUrlRedirect, defaultService
17170 # or defaultRouteAction.weightedBackendService can be set.
17171 #
17172 #
17173 # Authorization requires one or more of the following Google IAM permissions on the
17174 # specified resource default_service:
17175 #
17176 #
17177 # - compute.backendBuckets.use
17178 # - compute.backendServices.use
17179 &quot;defaultUrlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When none of the specified pathRules orrouteRules match, the request is redirected to a URL specified
17180 # by defaultUrlRedirect.
17181 #
17182 #
17183 # Only one of defaultUrlRedirect, defaultService
17184 # or defaultRouteAction.weightedBackendService can be set.
17185 #
17186 #
17187 # Not supported when the URL map is bound to a target gRPC proxy.
17188 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
17189 # was supplied in the request.
17190 #
17191 # The value must be from 1 to 255
17192 # characters.
17193 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
17194 # set to HTTPS.
17195 # If set to false, the URL scheme of the redirected request
17196 # remains the same as that of the request.
17197 #
17198 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
17199 #
17200 # The default is set to false.
17201 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
17202 # that was supplied in the request.
17203 #
17204 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
17205 # supplied, the path of the original request is used for the redirect.
17206 #
17207 # The value must be from 1 to 1024 characters.
17208 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
17209 # the HttpRouteRuleMatch, retaining the remaining portion
17210 # of the URL before redirecting the request.
17211 #
17212 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
17213 # supplied, the path of the original request is used for the redirect.
17214 #
17215 # The value must be from 1 to 1024 characters.
17216 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
17217 #
17218 # Supported values are:
17219 #
17220 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
17221 # to 301.
17222 # - FOUND, which corresponds to 302.
17223 # - SEE_OTHER which corresponds to 303.
17224 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
17225 # method is retained.
17226 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
17227 # method is retained.
17228 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
17229 # URL is
17230 # removed before redirecting the request. If set to false, the
17231 # query portion of the original URL is retained.
17232 #
17233 # The default is set to false.
17234 },
17235 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
17236 # create the resource.
17237 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
17238 # for the selected backend service.
17239 #
17240 # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
17241 #
17242 # HeaderAction is not supported for load balancers
17243 # that have
17244 # their loadBalancingScheme set to EXTERNAL.
17245 #
17246 # Not supported when the URL map is bound to a target gRPC proxy that
17247 # has validateForProxyless field set to true.
17248 # the request is passed along to the selected backendService.
17249 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
17250 { # Specification determining how headers are added to requests or responses.
17251 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
17252 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
17253 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
17254 # that already
17255 # exist for the header. If true, headerValue is set for the
17256 # header, discarding any values that were set for that header.
17257 #
17258 # The default value is true,
17259 # unless a variable is present in headerValue,
17260 # in which case the default value is false.
17261 # .
17262 },
17263 ],
17264 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
17265 # request before forwarding the request to the backendService.
17266 &quot;A String&quot;,
17267 ],
17268 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
17269 # client.
17270 { # Specification determining how headers are added to requests or responses.
17271 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
17272 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
17273 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
17274 # that already
17275 # exist for the header. If true, headerValue is set for the
17276 # header, discarding any values that were set for that header.
17277 #
17278 # The default value is true,
17279 # unless a variable is present in headerValue,
17280 # in which case the default value is false.
17281 # .
17282 },
17283 ],
17284 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
17285 # response before sending the response back to the client.
17286 &quot;A String&quot;,
17287 ],
17288 },
17289 &quot;name&quot;: &quot;A String&quot;, # The name to which this PathMatcher is referred by theHostRule.
17290 &quot;pathRules&quot;: [ # The list of path rules. Use this list instead of routeRules
17291 # when routing based on simple path matching is all that&#x27;s required. A path
17292 # rule can only include a wildcard character (*) after a
17293 # forward slash character (&quot;/&quot;).
17294 #
17295 # The order by which path rules are specified does not matter.
17296 # Matches are always done on the longest-path-first basis.
17297 #
17298 # For example: a pathRule with a path /a/b/c/* will match
17299 # before /a/b/* irrespective of the order in which those paths appear in this
17300 # list.
17301 #
17302 # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
17303 { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
17304 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
17305 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
17306 #
17307 # If a policy for an
17308 # error code is not configured for the PathRule, a policy for
17309 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
17310 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
17311 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
17312 # effect.
17313 #
17314 # For example, consider a UrlMap with the following configuration:
17315 #
17316 #
17317 # - UrlMap.defaultCustomErrorResponsePolicy are configured
17318 # with policies for 5xx and 4xx errors
17319 # - A PathRule for /coming_soon/ is configured for the error
17320 # code 404.
17321 #
17322 # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher&#x27;s policy
17323 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
17324 # the policy in PathRule.customErrorResponsePolicy takes
17325 # effect. If any of the requests in this example encounter a 500
17326 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
17327 #
17328 # customErrorResponsePolicy is supported only for
17329 # global external Application Load Balancers.
17330 # backend service or backend bucket responds with an error.
17331 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
17332 #
17333 # In a given policy, if you specify rules for both a range of error codes
17334 # as well as rules for specific error codes then rules with specific error
17335 # codes have a higher priority. For example, assume that you configure a rule
17336 # for 401 (Un-authorized) code, and another for all 4 series
17337 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
17338 # However if the backend service returns a 403, the rule for4xx takes effect.
17339 { # Specifies the mapping between the response code that will be returned along
17340 # with the custom error content and the response code returned by the backend
17341 # service.
17342 &quot;matchResponseCodes&quot;: [ # Valid values include:
17343 #
17344 #
17345 # - A number between 400 and 599: For example
17346 # 401 or 503, in which case the load balancer
17347 # applies the policy if the error code exactly matches this value.
17348 # - 5xx: Load Balancer will apply the policy if the
17349 # backend service responds with any response code in the range of
17350 # 500 to 599.
17351 # - 4xx: Load
17352 # Balancer will apply the policy if the backend service responds with any
17353 # response code in the range of 400 to
17354 # 499.
17355 #
17356 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
17357 &quot;A String&quot;,
17358 ],
17359 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
17360 # error content. If overrideResponseCode is not supplied, the
17361 # same response code returned by the original backend bucket or backend
17362 # service is returned to the client.
17363 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
17364 #
17365 # path must start
17366 # with a leading slash. path cannot have trailing slashes.
17367 #
17368 # If the file is not available in backendBucket or the
17369 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
17370 #
17371 # The value must
17372 # be from 1 to 1024 characters
17373 },
17374 ],
17375 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
17376 # contains the custom error content. Examples are:
17377 #
17378 #
17379 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
17380 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
17381 # - global/backendBuckets/myBackendBucket
17382 #
17383 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
17384 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
17385 #
17386 # If load balancer cannot reach
17387 # the backendBucket, a simple Not Found Error will
17388 # be returned, with the original response code (oroverrideResponseCode if configured).
17389 #
17390 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
17391 },
17392 &quot;paths&quot;: [ # The list of path patterns to match. Each must start with /
17393 # and the only place a * is allowed is at the end following
17394 # a /. The string fed to the path matcher does not include
17395 # any text after the first ? or #, and
17396 # those chars are not allowed here.
17397 &quot;A String&quot;,
17398 ],
17399 &quot;routeAction&quot;: { # In response to a matching path, the load balancer
17400 # performs advanced routing actions, such as URL rewrites and header
17401 # transformations, before forwarding the request to the selected
17402 # backend.
17403 #
17404 #
17405 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
17406 #
17407 #
17408 # URL maps for classic Application Load Balancers only support
17409 # the urlRewrite action within a path rule&#x27;srouteAction.
17410 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
17411 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
17412 # property must be specified. This policy cannot be specified if any target
17413 # backend has Identity-Aware Proxy enabled.
17414 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
17415 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
17416 # header names can be specified. The cache is bypassed for all `cacheMode`
17417 # values.
17418 &quot;A String&quot;,
17419 ],
17420 &quot;cacheKeyPolicy&quot;: { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
17421 # on the backend type: for Backend Services, the complete request URI is
17422 # used; for Backend Buckets, the request URI is used without the protocol or
17423 # host, and only query parameters known to Cloud Storage are included.
17424 # Policy defined on Route Action.
17425 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
17426 # parameters will be included. Either specify `excludedQueryParameters`
17427 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
17428 # encoded and not treated as delimiters.
17429 #
17430 # Note: This field applies to routes that use backend services. Attempting
17431 # to set it on a route that points exclusively to Backend Buckets will
17432 # result in a configuration error. For routes that point to a Backend
17433 # Bucket, use `includedQueryParameters` to define which parameters should
17434 # be part of the cache key.
17435 &quot;A String&quot;,
17436 ],
17437 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
17438 #
17439 # Note: This setting is only applicable to routes that use a Backend
17440 # Service. It does not affect requests served by a Backend Bucket, as the
17441 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
17442 # it on a route that points exclusively to Backend Buckets will result in a
17443 # configuration error.
17444 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
17445 #
17446 # Note: This setting is only applicable to routes that use a Backend
17447 # Service. It does not affect requests served by a Backend Bucket, as the
17448 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
17449 # set on a route that points exclusively to Backend Buckets will result in
17450 # a configuration error.
17451 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
17452 # `includedQueryParameters` and `excludedQueryParameters`. If neither
17453 # is set, the entire query string will be included. If false, the query
17454 # string will be excluded from the cache key entirely.
17455 #
17456 # Note: This field applies to routes that use backend services. Attempting
17457 # to set it on a route that points exclusively to Backend Buckets will
17458 # result in a configuration error. For routes that point to a Backend
17459 # Bucket, use `includedQueryParameters` to define which parameters should
17460 # be part of the cache key.
17461 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
17462 # The name=value pair will be used in the cache key Cloud CDN generates.
17463 #
17464 # Note: This setting is only applicable to routes that use a Backend
17465 # Service. It does not affect requests served by a Backend Bucket.
17466 # Attempting to set it on a route that points exclusively to Backend
17467 # Buckets will result in a configuration error. Up to 5 cookie names can be
17468 # specified.
17469 &quot;A String&quot;,
17470 ],
17471 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
17472 &quot;A String&quot;,
17473 ],
17474 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
17475 # parameters will be excluded. Either specify `includedQueryParameters`
17476 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
17477 # encoded and not treated as delimiters.
17478 &quot;A String&quot;,
17479 ],
17480 },
17481 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
17482 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
17483 &quot;clientTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
17484 # content. This is used to clamp the max-age (or Expires) value sent to the
17485 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
17486 # is used for the response max-age directive, along with a &quot;public&quot;
17487 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
17488 # clamps the max-age from the origin (if specified), or else sets the
17489 # response max-age directive to the lesser of the `clientTtl` and
17490 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
17491 # present. The maximum allowed value is 31,622,400s (1 year). If not
17492 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
17493 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
17494 # `USE_ORIGIN_HEADERS`.
17495 # as a count of seconds and fractions of seconds at nanosecond
17496 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17497 # or &quot;month&quot;. Range is approximately 10,000 years.
17498 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17499 # Durations less than one second are represented with a 0
17500 # `seconds` field and a positive `nanos` field. Must be from 0
17501 # to 999,999,999 inclusive.
17502 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17503 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17504 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17505 },
17506 &quot;defaultTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
17507 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
17508 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
17509 # greater than that of `maxTtl`. When the `cacheMode` is set to
17510 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
17511 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
17512 # accessed objects may be evicted from the cache before the defined TTL. If
17513 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
17514 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
17515 # `USE_ORIGIN_HEADERS`.
17516 # as a count of seconds and fractions of seconds at nanosecond
17517 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17518 # or &quot;month&quot;. Range is approximately 10,000 years.
17519 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17520 # Durations less than one second are represented with a 0
17521 # `seconds` field and a positive `nanos` field. Must be from 0
17522 # to 999,999,999 inclusive.
17523 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17524 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17525 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17526 },
17527 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
17528 # attempt to set a max-age or s-maxage higher than this, or an Expires header
17529 # more than `maxTtl` seconds in the future will be capped at the value of
17530 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
17531 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
17532 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
17533 # Infrequently accessed objects may be evicted from the cache before the
17534 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
17535 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
17536 # mode.
17537 # as a count of seconds and fractions of seconds at nanosecond
17538 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17539 # or &quot;month&quot;. Range is approximately 10,000 years.
17540 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17541 # Durations less than one second are represented with a 0
17542 # `seconds` field and a positive `nanos` field. Must be from 0
17543 # to 999,999,999 inclusive.
17544 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17545 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17546 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17547 },
17548 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
17549 # to apply fine-grained caching for common errors or redirects.
17550 # This can reduce the load on your origin and improve end-user
17551 # experience by reducing response latency.
17552 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
17553 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
17554 # the specified response code that lack any Cache-Control, Expires, or
17555 # Pragma: no-cache directives. When the `cacheMode` is set to
17556 # `FORCE_CACHE_ALL`, negative caching applies to all responses
17557 # with the specified response code, and overrides any caching headers. By
17558 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
17559 #
17560 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
17561 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
17562 # * 405 (Method Not Found), 501 (Not Implemented): 60s
17563 #
17564 # These defaults can be overridden in `negativeCachingPolicy`.
17565 # If not specified, Cloud CDN applies negative caching by default.
17566 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
17567 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
17568 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
17569 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
17570 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
17571 # all response codes that you wish to cache. Cloud CDN will not apply any
17572 # default negative caching when a policy exists.
17573 { # Specify CDN TTLs for response error codes.
17574 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
17575 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
17576 # specified as values, and you cannot specify a status code more than
17577 # once.
17578 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
17579 # corresponding status code.
17580 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
17581 # objects may be evicted from the cache before the defined TTL.
17582 # as a count of seconds and fractions of seconds at nanosecond
17583 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17584 # or &quot;month&quot;. Range is approximately 10,000 years.
17585 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17586 # Durations less than one second are represented with a 0
17587 # `seconds` field and a positive `nanos` field. Must be from 0
17588 # to 999,999,999 inclusive.
17589 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17590 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17591 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17592 },
17593 },
17594 ],
17595 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
17596 # requests into a small number of requests to the origin. If not specified,
17597 # Cloud CDN applies request coalescing by default.
17598 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
17599 # content with the origin, or when an error is encountered when refreshing
17600 # the cache.
17601 # This setting defines the default &quot;max-stale&quot; duration for any cached
17602 # responses that do not specify a max-stale directive. Stale responses that
17603 # exceed the TTL configured here will not be served. The default limit
17604 # (max-stale) is 86400s (1 day), which will allow stale content to be
17605 # served up to this limit beyond the max-age (or s-maxage) of a cached
17606 # response.
17607 # The maximum allowed value is 604800 (1 week).
17608 # Set this to zero (0) to disable serve-while-stale.
17609 # as a count of seconds and fractions of seconds at nanosecond
17610 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17611 # or &quot;month&quot;. Range is approximately 10,000 years.
17612 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17613 # Durations less than one second are represented with a 0
17614 # `seconds` field and a positive `nanos` field. Must be from 0
17615 # to 999,999,999 inclusive.
17616 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17617 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17618 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17619 },
17620 },
17621 &quot;corsPolicy&quot;: { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
17622 # information about the W3C recommendation for cross-origin resource sharing
17623 # (CORS), see Fetch API Living
17624 # Standard.
17625 #
17626 # Not supported when the URL map is bound to a target gRPC proxy.
17627 # information about the W3C recommendation for cross-origin resource sharing
17628 # (CORS), see Fetch API Living
17629 # Standard.
17630 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
17631 # indicates that
17632 # the actual request can include user credentials. This field translates to
17633 # the Access-Control-Allow-Credentials header.
17634 #
17635 # Default is false.
17636 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
17637 # header.
17638 &quot;A String&quot;,
17639 ],
17640 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
17641 # header.
17642 &quot;A String&quot;,
17643 ],
17644 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
17645 # more information, see regular expression syntax.
17646 #
17647 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
17648 #
17649 # Regular expressions can only be used when the loadBalancingScheme is
17650 # set to INTERNAL_SELF_MANAGED.
17651 &quot;A String&quot;,
17652 ],
17653 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
17654 #
17655 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
17656 &quot;A String&quot;,
17657 ],
17658 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
17659 # The default value is false, which indicates that the CORS
17660 # policy is in effect.
17661 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
17662 # header.
17663 &quot;A String&quot;,
17664 ],
17665 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
17666 # seconds. This field translates to the Access-Control-Max-Age
17667 # header.
17668 },
17669 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
17670 # the resiliency of clients to backend service failure. As part of fault
17671 # injection, when clients send requests to a backend service, delays can be
17672 # introduced by a load balancer on a percentage of requests before sending
17673 # those requests to the backend service. Similarly requests from clients can
17674 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
17675 # that are configured with a fault_injection_policy if:
17676 # 1. The traffic is generated by fault injection AND
17677 # 2. The fault injection is not a delay fault injection.
17678 # Fault injection is not supported with the classic Application Load Balancer
17679 # . To see which load balancers support fault injection,
17680 # see Load
17681 # balancing: Routing and traffic management features.
17682 # the resiliency of clients to backend service failure. As part of fault
17683 # injection, when clients send requests to a backend service, delays can be
17684 # introduced by the load balancer on a percentage of requests before sending
17685 # those request to the backend service. Similarly requests from clients can be
17686 # aborted by the load balancer for a percentage of requests.
17687 &quot;abort&quot;: { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
17688 # injection.
17689 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
17690 #
17691 # The value must be from 200 to 599 inclusive.
17692 #
17693 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
17694 # according to this
17695 # mapping table. HTTP status 200 is mapped to gRPC status
17696 # UNKNOWN. Injecting an OK status is currently not supported by
17697 # Traffic Director.
17698 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
17699 # that is aborted as part of fault injection.
17700 #
17701 # The value must be from 0.0 to 100.0 inclusive.
17702 },
17703 &quot;delay&quot;: { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
17704 # injection, before being sent to a backend service.
17705 # request to the backend service as part of fault injection.
17706 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
17707 # as a count of seconds and fractions of seconds at nanosecond
17708 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17709 # or &quot;month&quot;. Range is approximately 10,000 years.
17710 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17711 # Durations less than one second are represented with a 0
17712 # `seconds` field and a positive `nanos` field. Must be from 0
17713 # to 999,999,999 inclusive.
17714 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17715 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17716 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17717 },
17718 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
17719 # which a delay is introduced as part of fault injection.
17720 #
17721 # The value must be from 0.0 to 100.0 inclusive.
17722 },
17723 },
17724 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
17725 # Unlike the timeout field where the timeout duration starts
17726 # from the time the request has been fully processed (known as*end-of-stream*),
17727 # the duration in this field is computed from the beginning of the stream
17728 # until the response has been processed, including all retries. A
17729 # stream that does not complete in this duration is closed.
17730 #
17731 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
17732 # with the route.
17733 #
17734 # This field is only allowed if the Url map is used with backend services
17735 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
17736 # as a count of seconds and fractions of seconds at nanosecond
17737 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17738 # or &quot;month&quot;. Range is approximately 10,000 years.
17739 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17740 # Durations less than one second are represented with a 0
17741 # `seconds` field and a positive `nanos` field. Must be from 0
17742 # to 999,999,999 inclusive.
17743 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17744 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17745 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17746 },
17747 &quot;requestMirrorPolicy&quot;: { # A policy that specifies how requests intended for the route&#x27;s backends # Specifies the policy on how requests intended for the route&#x27;s backends
17748 # are shadowed to a separate mirrored backend service. The load balancer does
17749 # not wait for responses from the shadow service. Before sending traffic
17750 # to the shadow service, the host / authority header is suffixed with-shadow.
17751 #
17752 # Not supported when the URL map is bound to a target gRPC proxy that
17753 # has the validateForProxyless field set to true.
17754 # are shadowed to a separate mirrored backend service. The load balancer
17755 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
17756 # to the shadow service, the host or authority header is suffixed with-shadow.
17757 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
17758 # mirrored to.
17759 #
17760 # The backend service configured for a mirroring
17761 # policy must reference backends that are of the same type as the original
17762 # backend service matched in the URL map.
17763 #
17764 # Serverless NEG backends are not currently supported as a mirrored
17765 # backend service.
17766 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
17767 },
17768 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
17769 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
17770 # If not specified, defaults to 1.
17771 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
17772 #
17773 # If not specified, will use the timeout set in theHttpRouteAction field.
17774 # If timeout in the HttpRouteAction field is not set, this field
17775 # uses the largest timeout
17776 # among all backend services associated with the route.
17777 #
17778 # Not supported when the URL map is bound to a target gRPC proxy that
17779 # has the validateForProxyless field set to true.
17780 # as a count of seconds and fractions of seconds at nanosecond
17781 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17782 # or &quot;month&quot;. Range is approximately 10,000 years.
17783 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17784 # Durations less than one second are represented with a 0
17785 # `seconds` field and a positive `nanos` field. Must be from 0
17786 # to 999,999,999 inclusive.
17787 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17788 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17789 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17790 },
17791 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
17792 # values are:
17793 #
17794 # - 5xx: retry is attempted if the instance or endpoint
17795 # responds with any 5xx response code, or if the instance or
17796 # endpoint does not respond at all. For example, disconnects, reset, read
17797 # timeout, connection failure, and refused streams.
17798 # - gateway-error: Similar to 5xx, but only
17799 # applies to response codes 502, 503 or504.
17800 # - connect-failure: a retry is attempted on failures
17801 # connecting to the instance or endpoint. For example, connection
17802 # timeouts.
17803 # - retriable-4xx: a retry is attempted if the instance
17804 # or endpoint responds with a 4xx response code.
17805 # The only error that you can retry is error code 409.
17806 # - refused-stream: a retry is attempted if the instance
17807 # or endpoint resets the stream with a REFUSED_STREAM error
17808 # code. This reset type indicates that it is safe to retry.
17809 # - cancelled: a retry is attempted if the gRPC status
17810 # code in the response header is set to cancelled.
17811 # - deadline-exceeded: a retry is attempted if the gRPC
17812 # status code in the response header is set todeadline-exceeded.
17813 # - internal: a retry is attempted if the gRPC
17814 # status code in the response header is set tointernal.
17815 # - resource-exhausted: a retry is attempted if the gRPC
17816 # status code in the response header is set toresource-exhausted.
17817 # - unavailable: a retry is attempted if the gRPC
17818 # status code in the response header is set tounavailable.
17819 #
17820 # Only the following codes are supported when the URL map is bound to
17821 # target gRPC proxy that has validateForProxyless field set to true.
17822 #
17823 # - cancelled
17824 # - deadline-exceeded
17825 # - internal
17826 # - resource-exhausted
17827 # - unavailable
17828 &quot;A String&quot;,
17829 ],
17830 },
17831 &quot;timeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
17832 # time the request has been fully processed (known as *end-of-stream*)
17833 # up until the response has been processed. Timeout includes
17834 # all retries.
17835 #
17836 # If not specified, this field uses the largest timeout among all backend
17837 # services associated with the route.
17838 #
17839 # Not supported when the URL map is bound to a target gRPC proxy that
17840 # has validateForProxyless field set to true.
17841 # as a count of seconds and fractions of seconds at nanosecond
17842 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17843 # or &quot;month&quot;. Range is approximately 10,000 years.
17844 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17845 # Durations less than one second are represented with a 0
17846 # `seconds` field and a positive `nanos` field. Must be from 0
17847 # to 999,999,999 inclusive.
17848 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17849 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17850 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17851 },
17852 &quot;urlRewrite&quot;: { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
17853 # to the matched service.
17854 #
17855 # urlRewrite is the only action supported in UrlMaps
17856 # for classic Application Load Balancers.
17857 #
17858 # Not supported when the URL map is bound to a target gRPC proxy that
17859 # has the validateForProxyless field set to true.
17860 # backend service.
17861 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
17862 # host header is replaced with contents of hostRewrite.
17863 #
17864 # The value must be from 1 to 255 characters.
17865 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
17866 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
17867 #
17868 # The value must be from 1 to 1024 characters.
17869 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
17870 # header) using the HTTP template syntax.
17871 #
17872 # A corresponding
17873 # path_template_match must be specified. Any template variables must exist in
17874 # the path_template_match field.
17875 #
17876 #
17877 # - -At least one variable must be specified in the path_template_match
17878 # field
17879 # - You can omit variables from the rewritten URL
17880 # - The * and ** operators cannot be matched
17881 # unless they have a corresponding variable name - e.g.
17882 # {format=*} or {var=**}.
17883 #
17884 # For example, a path_template_match of /static/{format=**}
17885 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
17886 # rewrite, so that /{country}/{format}/{suffix=**} can be
17887 # rewritten as /content/{format}/{country}/{suffix}.
17888 #
17889 # At least
17890 # one non-empty routeRules[].matchRules[].path_template_match is
17891 # required.
17892 #
17893 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
17894 },
17895 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
17896 # occurs. The weights determine the fraction of traffic that flows to
17897 # their corresponding backend service. If all traffic needs to
17898 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
17899 #
17900 # After a backend service is identified and before forwarding
17901 # the request to
17902 # the backend service, advanced routing actions such as URL rewrites and
17903 # header transformations are applied depending on additional settings
17904 # specified in this HttpRouteAction.
17905 { # In contrast to a single BackendService in
17906 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
17907 # multiple backend services. The volume of traffic for each
17908 # backend service is proportional to the weight specified
17909 # in each WeightedBackendService
17910 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
17911 # resource. Before
17912 # forwarding the request to backendService, the load balancer
17913 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
17914 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
17915 # effect for the selected backendService.
17916 #
17917 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
17918 #
17919 # headerAction is not supported for load balancers that have
17920 # their loadBalancingScheme set to EXTERNAL.
17921 #
17922 # Not supported when the URL map is bound to a target gRPC proxy that
17923 # has validateForProxyless field set to true.
17924 # the request is passed along to the selected backendService.
17925 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
17926 { # Specification determining how headers are added to requests or responses.
17927 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
17928 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
17929 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
17930 # that already
17931 # exist for the header. If true, headerValue is set for the
17932 # header, discarding any values that were set for that header.
17933 #
17934 # The default value is true,
17935 # unless a variable is present in headerValue,
17936 # in which case the default value is false.
17937 # .
17938 },
17939 ],
17940 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
17941 # request before forwarding the request to the backendService.
17942 &quot;A String&quot;,
17943 ],
17944 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
17945 # client.
17946 { # Specification determining how headers are added to requests or responses.
17947 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
17948 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
17949 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
17950 # that already
17951 # exist for the header. If true, headerValue is set for the
17952 # header, discarding any values that were set for that header.
17953 #
17954 # The default value is true,
17955 # unless a variable is present in headerValue,
17956 # in which case the default value is false.
17957 # .
17958 },
17959 ],
17960 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
17961 # response before sending the response back to the client.
17962 &quot;A String&quot;,
17963 ],
17964 },
17965 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
17966 # computed asweight / (sum of all weightedBackendService weights in routeAction).
17967 #
17968 # The selection of a backend service is determined only for new traffic.
17969 # Once a user&#x27;s request has been directed to a backend service,
17970 # subsequent requests are sent to the same backend service as
17971 # determined by the backend service&#x27;s session affinity policy.
17972 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
17973 # splitting. If you do, the weighted traffic splitting configuration takes
17974 # precedence.
17975 #
17976 # The value must be from 0 to 1000.
17977 },
17978 ],
17979 },
17980 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
17981 # is directed if this rule is matched. If routeAction is
17982 # also specified, advanced routing actions, such as URL rewrites,
17983 # take effect before sending the request to the backend.
17984 #
17985 #
17986 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
17987 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
17988 # specified by urlRedirect.
17989 #
17990 #
17991 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
17992 #
17993 #
17994 # Not supported when the URL map is bound to a target gRPC proxy.
17995 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
17996 # was supplied in the request.
17997 #
17998 # The value must be from 1 to 255
17999 # characters.
18000 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
18001 # set to HTTPS.
18002 # If set to false, the URL scheme of the redirected request
18003 # remains the same as that of the request.
18004 #
18005 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
18006 #
18007 # The default is set to false.
18008 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
18009 # that was supplied in the request.
18010 #
18011 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
18012 # supplied, the path of the original request is used for the redirect.
18013 #
18014 # The value must be from 1 to 1024 characters.
18015 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
18016 # the HttpRouteRuleMatch, retaining the remaining portion
18017 # of the URL before redirecting the request.
18018 #
18019 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
18020 # supplied, the path of the original request is used for the redirect.
18021 #
18022 # The value must be from 1 to 1024 characters.
18023 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
18024 #
18025 # Supported values are:
18026 #
18027 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
18028 # to 301.
18029 # - FOUND, which corresponds to 302.
18030 # - SEE_OTHER which corresponds to 303.
18031 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
18032 # method is retained.
18033 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
18034 # method is retained.
18035 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
18036 # URL is
18037 # removed before redirecting the request. If set to false, the
18038 # query portion of the original URL is retained.
18039 #
18040 # The default is set to false.
18041 },
18042 },
18043 ],
18044 &quot;routeRules&quot;: [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
18045 # desired. routeRules are evaluated in order of priority, from
18046 # the lowest to highest number.
18047 #
18048 # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
18049 { # The HttpRouteRule setting specifies how to match an HTTP request
18050 # and the corresponding routing action that load balancing proxies perform.
18051 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
18052 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
18053 #
18054 # If a policy for an
18055 # error code is not configured for the RouteRule, a policy for
18056 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
18057 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
18058 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
18059 # effect.
18060 #
18061 # For example, consider a UrlMap with the following configuration:
18062 #
18063 #
18064 # - UrlMap.defaultCustomErrorResponsePolicy are configured
18065 # with policies for 5xx and 4xx errors
18066 # - A RouteRule for /coming_soon/ is configured for the
18067 # error code 404.
18068 #
18069 # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher&#x27;s policy
18070 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
18071 # the policy in RouteRule.customErrorResponsePolicy takes
18072 # effect. If any of the requests in this example encounter a 500
18073 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
18074 #
18075 # When
18076 # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
18077 # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
18078 # a retry, if load balancer is successful in reaching the
18079 # service, the customErrorResponsePolicy is ignored and
18080 # the response from the service is returned to the client.
18081 #
18082 # customErrorResponsePolicy is supported only for
18083 # global external Application Load Balancers.
18084 # backend service or backend bucket responds with an error.
18085 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
18086 #
18087 # In a given policy, if you specify rules for both a range of error codes
18088 # as well as rules for specific error codes then rules with specific error
18089 # codes have a higher priority. For example, assume that you configure a rule
18090 # for 401 (Un-authorized) code, and another for all 4 series
18091 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
18092 # However if the backend service returns a 403, the rule for4xx takes effect.
18093 { # Specifies the mapping between the response code that will be returned along
18094 # with the custom error content and the response code returned by the backend
18095 # service.
18096 &quot;matchResponseCodes&quot;: [ # Valid values include:
18097 #
18098 #
18099 # - A number between 400 and 599: For example
18100 # 401 or 503, in which case the load balancer
18101 # applies the policy if the error code exactly matches this value.
18102 # - 5xx: Load Balancer will apply the policy if the
18103 # backend service responds with any response code in the range of
18104 # 500 to 599.
18105 # - 4xx: Load
18106 # Balancer will apply the policy if the backend service responds with any
18107 # response code in the range of 400 to
18108 # 499.
18109 #
18110 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
18111 &quot;A String&quot;,
18112 ],
18113 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
18114 # error content. If overrideResponseCode is not supplied, the
18115 # same response code returned by the original backend bucket or backend
18116 # service is returned to the client.
18117 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
18118 #
18119 # path must start
18120 # with a leading slash. path cannot have trailing slashes.
18121 #
18122 # If the file is not available in backendBucket or the
18123 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
18124 #
18125 # The value must
18126 # be from 1 to 1024 characters
18127 },
18128 ],
18129 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
18130 # contains the custom error content. Examples are:
18131 #
18132 #
18133 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
18134 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
18135 # - global/backendBuckets/myBackendBucket
18136 #
18137 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
18138 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
18139 #
18140 # If load balancer cannot reach
18141 # the backendBucket, a simple Not Found Error will
18142 # be returned, with the original response code (oroverrideResponseCode if configured).
18143 #
18144 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
18145 },
18146 &quot;description&quot;: &quot;A String&quot;, # The short description conveying the intent of this routeRule.
18147 #
18148 #
18149 # The description can have a maximum length of 1024 characters.
18150 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
18151 # for the selected backendService.
18152 #
18153 # The headerAction value specified here is applied before the
18154 # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
18155 #
18156 # HeaderAction is not supported for load balancers
18157 # that have
18158 # their loadBalancingScheme set to EXTERNAL.
18159 #
18160 # Not supported when the URL map is bound to a target gRPC proxy that
18161 # has validateForProxyless field set to true.
18162 # the request is passed along to the selected backendService.
18163 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
18164 { # Specification determining how headers are added to requests or responses.
18165 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
18166 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
18167 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
18168 # that already
18169 # exist for the header. If true, headerValue is set for the
18170 # header, discarding any values that were set for that header.
18171 #
18172 # The default value is true,
18173 # unless a variable is present in headerValue,
18174 # in which case the default value is false.
18175 # .
18176 },
18177 ],
18178 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
18179 # request before forwarding the request to the backendService.
18180 &quot;A String&quot;,
18181 ],
18182 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
18183 # client.
18184 { # Specification determining how headers are added to requests or responses.
18185 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
18186 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
18187 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
18188 # that already
18189 # exist for the header. If true, headerValue is set for the
18190 # header, discarding any values that were set for that header.
18191 #
18192 # The default value is true,
18193 # unless a variable is present in headerValue,
18194 # in which case the default value is false.
18195 # .
18196 },
18197 ],
18198 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
18199 # response before sending the response back to the client.
18200 &quot;A String&quot;,
18201 ],
18202 },
18203 &quot;matchRules&quot;: [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
18204 # this routeRule when any of thematchRules are satisfied. However predicates within
18205 # a given matchRule have AND semantics. All predicates
18206 # within a matchRule must match for the request to
18207 # match the rule.
18208 { # HttpRouteRuleMatch specifies a set of criteria for matching
18209 # requests to an HttpRouteRule. All specified criteria must
18210 # be satisfied for a match to occur.
18211 &quot;fullPathMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
18212 # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
18213 # that may be part of the original URL.
18214 #
18215 # fullPathMatch must be from 1 to 1024 characters.
18216 #
18217 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
18218 # specified.
18219 &quot;headerMatches&quot;: [ # Specifies a list of header match criteria, all of which must match
18220 # corresponding headers in the request.
18221 { # matchRule criteria for request header matches.
18222 &quot;exactMatch&quot;: &quot;A String&quot;, # The value should exactly match contents of exactMatch.
18223 #
18224 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
18225 &quot;headerName&quot;: &quot;A String&quot;, # The name of the HTTP header to match.
18226 #
18227 # For matching against the HTTP request&#x27;s authority, use a headerMatch
18228 # with the header name &quot;:authority&quot;.
18229 #
18230 # For matching a request&#x27;s method, use the headerName &quot;:method&quot;.
18231 #
18232 # When the URL map is bound to a target gRPC proxy that has
18233 # the validateForProxyless field set to true, only
18234 # non-binary
18235 # user-specified custom metadata and the `content-type` header are supported.
18236 # The following transport-level headers cannot be used in header matching
18237 # rules:
18238 # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
18239 # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
18240 # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
18241 # `grpc-timeout` and `grpc-trace-bin`.
18242 &quot;invertMatch&quot;: True or False, # If set to false, the headerMatch is considered a
18243 # match if the preceding match criteria are met. If set to true,
18244 # the headerMatch is considered a match if the preceding
18245 # match criteria are NOT met.
18246 #
18247 # The default setting is false.
18248 &quot;prefixMatch&quot;: &quot;A String&quot;, # The value of the header must start with the contents ofprefixMatch.
18249 #
18250 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
18251 &quot;presentMatch&quot;: True or False, # A header with the contents of headerName must exist. The
18252 # match takes place whether or not the request&#x27;s header has a value.
18253 #
18254 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
18255 &quot;rangeMatch&quot;: { # HttpRouteRuleMatch criteria for field values that must stay # The header value must be an integer and its value must be in the range
18256 # specified in rangeMatch. If the header does not contain an
18257 # integer, number or is empty, the match fails.
18258 #
18259 # For example for a range [-5, 0]
18260 #
18261 #
18262 # - -3 will match.
18263 # - 0 will not match.
18264 # - 0.25 will not match.
18265 # - -3someString will not match.
18266 #
18267 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
18268 #
18269 # rangeMatch is not supported for load balancers
18270 # that have loadBalancingScheme set to EXTERNAL.
18271 # within the specified integer range.
18272 &quot;rangeEnd&quot;: &quot;A String&quot;, # The end of the range (exclusive) in signed long integer format.
18273 &quot;rangeStart&quot;: &quot;A String&quot;, # The start of the range (inclusive) in signed long integer format.
18274 },
18275 &quot;regexMatch&quot;: &quot;A String&quot;, # The value of the header must match the regular expression specified inregexMatch.
18276 # For more information about regular expression syntax, see Syntax.
18277 #
18278 # For matching against a port specified in the HTTP request, use a
18279 # headerMatch with headerName set to PORT and a regular expression that
18280 # satisfies the RFC2616 Host header&#x27;s port specifier.
18281 #
18282 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
18283 #
18284 # Regular expressions can only be used when the loadBalancingScheme is
18285 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
18286 # (regional scope) or INTERNAL_MANAGED.
18287 &quot;suffixMatch&quot;: &quot;A String&quot;, # The value of the header must end with the contents ofsuffixMatch.
18288 #
18289 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
18290 },
18291 ],
18292 &quot;ignoreCase&quot;: True or False, # Specifies that prefixMatch and fullPathMatch
18293 # matches are case sensitive.
18294 #
18295 # The default value is false.
18296 #
18297 # ignoreCase must not be used with regexMatch.
18298 #
18299 # Not supported when the URL map is bound to a target gRPC proxy.
18300 &quot;metadataFilters&quot;: [ # Opaque filter criteria used by the load balancer to restrict routing
18301 # configuration to a limited set of xDS
18302 # compliant clients. In their xDS requests to the load balancer, xDS clients
18303 # present node
18304 # metadata. When there is a match, the relevant routing configuration
18305 # is made available to those proxies.
18306 #
18307 # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least one of thefilterLabels must match the corresponding label provided in
18308 # the metadata. If its filterMatchCriteria is set to
18309 # MATCH_ALL, then all of its filterLabels must match with
18310 # corresponding labels provided in the metadata. If multiple
18311 # metadata filters are specified, all of them need to be
18312 # satisfied in order to be considered a match.
18313 #
18314 # metadataFilters specified here is applied after those
18315 # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
18316 #
18317 # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
18318 #
18319 # Not supported when the URL map is bound to a target gRPC proxy that
18320 # has validateForProxyless field set to true.
18321 { # Opaque filter criteria used by load balancers to restrict routing
18322 # configuration to a limited set of load balancing proxies. Proxies and
18323 # sidecars involved in load balancing would typically present metadata to the
18324 # load balancers that need to match criteria specified here. If a match takes
18325 # place, the relevant configuration is made available to those
18326 # proxies.
18327 #
18328 # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
18329 # one of thefilterLabels must match the corresponding label provided in
18330 # the metadata. If its filterMatchCriteria is set to
18331 # MATCH_ALL, then all of its filterLabels must match with
18332 # corresponding labels provided in the metadata.
18333 #
18334 # An example for using metadataFilters would be: if
18335 # load balancing involves
18336 # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in of their XDS requests to loadbalancers.
18337 &quot;filterLabels&quot;: [ # The list of label value pairs that must match labels in the provided
18338 # metadata based on filterMatchCriteria
18339 #
18340 # This list must not be empty and can have at the most 64 entries.
18341 { # MetadataFilter label name value pairs that are expected
18342 # to match corresponding labels presented as metadata to the load balancer.
18343 &quot;name&quot;: &quot;A String&quot;, # Name of metadata label.
18344 #
18345 # The name can have a maximum length of 1024 characters and must be at
18346 # least 1 character long.
18347 &quot;value&quot;: &quot;A String&quot;, # The value of the label must match the specified value.
18348 #
18349 # value can have a maximum length of 1024 characters.
18350 },
18351 ],
18352 &quot;filterMatchCriteria&quot;: &quot;A String&quot;, # Specifies how individual filter label matches
18353 # within the list of filterLabels and contributes toward the
18354 # overall metadataFilter match.
18355 #
18356 # Supported values are:
18357 #
18358 # - MATCH_ANY: at least one of the filterLabels
18359 # must have a matching label in the provided metadata.
18360 # - MATCH_ALL: all filterLabels must have
18361 # matching labels in the provided metadata.
18362 },
18363 ],
18364 &quot;pathTemplateMatch&quot;: &quot;A String&quot;, # If specified, this field defines a path template pattern that must match
18365 # the :path header after the query string is removed.
18366 #
18367 # A path template pattern can include variables and wildcards.
18368 # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
18369 # matches a single path segment, and ** that matches zero or
18370 # more path segments. The pattern must follow these rules:
18371 #
18372 #
18373 # - The value must be between 1 and 1024 characters.
18374 # - The pattern must start with a leading slash (&quot;/&quot;).
18375 # - No more than 5 operators (variables or wildcards) may appear in
18376 # the pattern.
18377 #
18378 # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
18379 # set.
18380 &quot;prefixMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the request&#x27;s
18381 # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
18382 #
18383 # The value must be from 1 to 1024 characters.
18384 #
18385 # The * character inside a prefix match is
18386 # treated as a literal character, not as a wildcard.
18387 #
18388 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
18389 # used within a matchRule.
18390 &quot;queryParameterMatches&quot;: [ # Specifies a list of query parameter match criteria, all of which must
18391 # match corresponding query parameters in the request.
18392 #
18393 # Not supported when the URL map is bound to a target gRPC proxy.
18394 { # HttpRouteRuleMatch criteria for a request&#x27;s query parameter.
18395 &quot;exactMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
18396 # parameter exactly matches the contents of exactMatch.
18397 #
18398 # Only one of presentMatch, exactMatch, orregexMatch must be set.
18399 &quot;name&quot;: &quot;A String&quot;, # The name of the query parameter to match. The query parameter must exist in
18400 # the request, in the absence of which the request match fails.
18401 &quot;presentMatch&quot;: True or False, # Specifies that the queryParameterMatch matches if the
18402 # request contains the query parameter, irrespective of whether the
18403 # parameter has a value or not.
18404 #
18405 # Only one of presentMatch, exactMatch, orregexMatch must be set.
18406 &quot;regexMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
18407 # parameter matches the regular expression specified byregexMatch. For
18408 # more information about regular expression syntax, see Syntax.
18409 #
18410 # Only one of presentMatch, exactMatch, orregexMatch must be set.
18411 #
18412 # Regular expressions can only be used when the loadBalancingScheme is
18413 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
18414 # (regional scope) or INTERNAL_MANAGED.
18415 },
18416 ],
18417 &quot;regexMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
18418 # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
18419 # supplied with the original URL. For
18420 # more information about regular expression syntax, see Syntax.
18421 #
18422 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
18423 # specified.
18424 #
18425 # Regular expressions can only be used when the loadBalancingScheme is
18426 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
18427 # (regional scope) or INTERNAL_MANAGED.
18428 },
18429 ],
18430 &quot;priority&quot;: 42, # For routeRules within a given pathMatcher,
18431 # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
18432 # of priority, from the lowest to highest number. The priority of a
18433 # rule decreases as its number increases (1, 2, 3, N+1). The first rule
18434 # that matches the request is applied.
18435 #
18436 #
18437 # You cannot configure two or more routeRules with the same priority.
18438 # Priority for each rule must be set to a number from 0 to 2147483647
18439 # inclusive.
18440 #
18441 #
18442 # Priority numbers can have gaps, which enable you to add or remove rules
18443 # in the future without affecting the rest of the rules. For example, 1, 2,
18444 # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
18445 # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
18446 # without any impact on existing rules.
18447 &quot;routeAction&quot;: { # In response to a matching matchRule, the load balancer
18448 # performs advanced routing actions, such as URL rewrites and header
18449 # transformations, before forwarding the request to the selected backend.
18450 #
18451 #
18452 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
18453 #
18454 #
18455 # URL maps for classic Application Load Balancers only support
18456 # the urlRewrite action within a route rule&#x27;srouteAction.
18457 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
18458 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
18459 # property must be specified. This policy cannot be specified if any target
18460 # backend has Identity-Aware Proxy enabled.
18461 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
18462 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
18463 # header names can be specified. The cache is bypassed for all `cacheMode`
18464 # values.
18465 &quot;A String&quot;,
18466 ],
18467 &quot;cacheKeyPolicy&quot;: { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
18468 # on the backend type: for Backend Services, the complete request URI is
18469 # used; for Backend Buckets, the request URI is used without the protocol or
18470 # host, and only query parameters known to Cloud Storage are included.
18471 # Policy defined on Route Action.
18472 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
18473 # parameters will be included. Either specify `excludedQueryParameters`
18474 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
18475 # encoded and not treated as delimiters.
18476 #
18477 # Note: This field applies to routes that use backend services. Attempting
18478 # to set it on a route that points exclusively to Backend Buckets will
18479 # result in a configuration error. For routes that point to a Backend
18480 # Bucket, use `includedQueryParameters` to define which parameters should
18481 # be part of the cache key.
18482 &quot;A String&quot;,
18483 ],
18484 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
18485 #
18486 # Note: This setting is only applicable to routes that use a Backend
18487 # Service. It does not affect requests served by a Backend Bucket, as the
18488 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
18489 # it on a route that points exclusively to Backend Buckets will result in a
18490 # configuration error.
18491 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
18492 #
18493 # Note: This setting is only applicable to routes that use a Backend
18494 # Service. It does not affect requests served by a Backend Bucket, as the
18495 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
18496 # set on a route that points exclusively to Backend Buckets will result in
18497 # a configuration error.
18498 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
18499 # `includedQueryParameters` and `excludedQueryParameters`. If neither
18500 # is set, the entire query string will be included. If false, the query
18501 # string will be excluded from the cache key entirely.
18502 #
18503 # Note: This field applies to routes that use backend services. Attempting
18504 # to set it on a route that points exclusively to Backend Buckets will
18505 # result in a configuration error. For routes that point to a Backend
18506 # Bucket, use `includedQueryParameters` to define which parameters should
18507 # be part of the cache key.
18508 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
18509 # The name=value pair will be used in the cache key Cloud CDN generates.
18510 #
18511 # Note: This setting is only applicable to routes that use a Backend
18512 # Service. It does not affect requests served by a Backend Bucket.
18513 # Attempting to set it on a route that points exclusively to Backend
18514 # Buckets will result in a configuration error. Up to 5 cookie names can be
18515 # specified.
18516 &quot;A String&quot;,
18517 ],
18518 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
18519 &quot;A String&quot;,
18520 ],
18521 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
18522 # parameters will be excluded. Either specify `includedQueryParameters`
18523 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
18524 # encoded and not treated as delimiters.
18525 &quot;A String&quot;,
18526 ],
18527 },
18528 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
18529 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
18530 &quot;clientTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
18531 # content. This is used to clamp the max-age (or Expires) value sent to the
18532 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
18533 # is used for the response max-age directive, along with a &quot;public&quot;
18534 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
18535 # clamps the max-age from the origin (if specified), or else sets the
18536 # response max-age directive to the lesser of the `clientTtl` and
18537 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
18538 # present. The maximum allowed value is 31,622,400s (1 year). If not
18539 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
18540 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
18541 # `USE_ORIGIN_HEADERS`.
18542 # as a count of seconds and fractions of seconds at nanosecond
18543 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18544 # or &quot;month&quot;. Range is approximately 10,000 years.
18545 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18546 # Durations less than one second are represented with a 0
18547 # `seconds` field and a positive `nanos` field. Must be from 0
18548 # to 999,999,999 inclusive.
18549 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18550 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18551 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18552 },
18553 &quot;defaultTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
18554 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
18555 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
18556 # greater than that of `maxTtl`. When the `cacheMode` is set to
18557 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
18558 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
18559 # accessed objects may be evicted from the cache before the defined TTL. If
18560 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
18561 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
18562 # `USE_ORIGIN_HEADERS`.
18563 # as a count of seconds and fractions of seconds at nanosecond
18564 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18565 # or &quot;month&quot;. Range is approximately 10,000 years.
18566 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18567 # Durations less than one second are represented with a 0
18568 # `seconds` field and a positive `nanos` field. Must be from 0
18569 # to 999,999,999 inclusive.
18570 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18571 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18572 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18573 },
18574 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
18575 # attempt to set a max-age or s-maxage higher than this, or an Expires header
18576 # more than `maxTtl` seconds in the future will be capped at the value of
18577 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
18578 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
18579 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
18580 # Infrequently accessed objects may be evicted from the cache before the
18581 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
18582 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
18583 # mode.
18584 # as a count of seconds and fractions of seconds at nanosecond
18585 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18586 # or &quot;month&quot;. Range is approximately 10,000 years.
18587 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18588 # Durations less than one second are represented with a 0
18589 # `seconds` field and a positive `nanos` field. Must be from 0
18590 # to 999,999,999 inclusive.
18591 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18592 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18593 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18594 },
18595 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
18596 # to apply fine-grained caching for common errors or redirects.
18597 # This can reduce the load on your origin and improve end-user
18598 # experience by reducing response latency.
18599 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
18600 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
18601 # the specified response code that lack any Cache-Control, Expires, or
18602 # Pragma: no-cache directives. When the `cacheMode` is set to
18603 # `FORCE_CACHE_ALL`, negative caching applies to all responses
18604 # with the specified response code, and overrides any caching headers. By
18605 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
18606 #
18607 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
18608 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
18609 # * 405 (Method Not Found), 501 (Not Implemented): 60s
18610 #
18611 # These defaults can be overridden in `negativeCachingPolicy`.
18612 # If not specified, Cloud CDN applies negative caching by default.
18613 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
18614 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
18615 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
18616 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
18617 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
18618 # all response codes that you wish to cache. Cloud CDN will not apply any
18619 # default negative caching when a policy exists.
18620 { # Specify CDN TTLs for response error codes.
18621 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
18622 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
18623 # specified as values, and you cannot specify a status code more than
18624 # once.
18625 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
18626 # corresponding status code.
18627 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
18628 # objects may be evicted from the cache before the defined TTL.
18629 # as a count of seconds and fractions of seconds at nanosecond
18630 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18631 # or &quot;month&quot;. Range is approximately 10,000 years.
18632 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18633 # Durations less than one second are represented with a 0
18634 # `seconds` field and a positive `nanos` field. Must be from 0
18635 # to 999,999,999 inclusive.
18636 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18637 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18638 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18639 },
18640 },
18641 ],
18642 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
18643 # requests into a small number of requests to the origin. If not specified,
18644 # Cloud CDN applies request coalescing by default.
18645 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
18646 # content with the origin, or when an error is encountered when refreshing
18647 # the cache.
18648 # This setting defines the default &quot;max-stale&quot; duration for any cached
18649 # responses that do not specify a max-stale directive. Stale responses that
18650 # exceed the TTL configured here will not be served. The default limit
18651 # (max-stale) is 86400s (1 day), which will allow stale content to be
18652 # served up to this limit beyond the max-age (or s-maxage) of a cached
18653 # response.
18654 # The maximum allowed value is 604800 (1 week).
18655 # Set this to zero (0) to disable serve-while-stale.
18656 # as a count of seconds and fractions of seconds at nanosecond
18657 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18658 # or &quot;month&quot;. Range is approximately 10,000 years.
18659 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18660 # Durations less than one second are represented with a 0
18661 # `seconds` field and a positive `nanos` field. Must be from 0
18662 # to 999,999,999 inclusive.
18663 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18664 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18665 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18666 },
18667 },
18668 &quot;corsPolicy&quot;: { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
18669 # information about the W3C recommendation for cross-origin resource sharing
18670 # (CORS), see Fetch API Living
18671 # Standard.
18672 #
18673 # Not supported when the URL map is bound to a target gRPC proxy.
18674 # information about the W3C recommendation for cross-origin resource sharing
18675 # (CORS), see Fetch API Living
18676 # Standard.
18677 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
18678 # indicates that
18679 # the actual request can include user credentials. This field translates to
18680 # the Access-Control-Allow-Credentials header.
18681 #
18682 # Default is false.
18683 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
18684 # header.
18685 &quot;A String&quot;,
18686 ],
18687 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
18688 # header.
18689 &quot;A String&quot;,
18690 ],
18691 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
18692 # more information, see regular expression syntax.
18693 #
18694 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
18695 #
18696 # Regular expressions can only be used when the loadBalancingScheme is
18697 # set to INTERNAL_SELF_MANAGED.
18698 &quot;A String&quot;,
18699 ],
18700 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
18701 #
18702 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
18703 &quot;A String&quot;,
18704 ],
18705 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
18706 # The default value is false, which indicates that the CORS
18707 # policy is in effect.
18708 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
18709 # header.
18710 &quot;A String&quot;,
18711 ],
18712 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
18713 # seconds. This field translates to the Access-Control-Max-Age
18714 # header.
18715 },
18716 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
18717 # the resiliency of clients to backend service failure. As part of fault
18718 # injection, when clients send requests to a backend service, delays can be
18719 # introduced by a load balancer on a percentage of requests before sending
18720 # those requests to the backend service. Similarly requests from clients can
18721 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
18722 # that are configured with a fault_injection_policy if:
18723 # 1. The traffic is generated by fault injection AND
18724 # 2. The fault injection is not a delay fault injection.
18725 # Fault injection is not supported with the classic Application Load Balancer
18726 # . To see which load balancers support fault injection,
18727 # see Load
18728 # balancing: Routing and traffic management features.
18729 # the resiliency of clients to backend service failure. As part of fault
18730 # injection, when clients send requests to a backend service, delays can be
18731 # introduced by the load balancer on a percentage of requests before sending
18732 # those request to the backend service. Similarly requests from clients can be
18733 # aborted by the load balancer for a percentage of requests.
18734 &quot;abort&quot;: { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
18735 # injection.
18736 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
18737 #
18738 # The value must be from 200 to 599 inclusive.
18739 #
18740 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
18741 # according to this
18742 # mapping table. HTTP status 200 is mapped to gRPC status
18743 # UNKNOWN. Injecting an OK status is currently not supported by
18744 # Traffic Director.
18745 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
18746 # that is aborted as part of fault injection.
18747 #
18748 # The value must be from 0.0 to 100.0 inclusive.
18749 },
18750 &quot;delay&quot;: { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
18751 # injection, before being sent to a backend service.
18752 # request to the backend service as part of fault injection.
18753 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
18754 # as a count of seconds and fractions of seconds at nanosecond
18755 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18756 # or &quot;month&quot;. Range is approximately 10,000 years.
18757 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18758 # Durations less than one second are represented with a 0
18759 # `seconds` field and a positive `nanos` field. Must be from 0
18760 # to 999,999,999 inclusive.
18761 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18762 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18763 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18764 },
18765 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
18766 # which a delay is introduced as part of fault injection.
18767 #
18768 # The value must be from 0.0 to 100.0 inclusive.
18769 },
18770 },
18771 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
18772 # Unlike the timeout field where the timeout duration starts
18773 # from the time the request has been fully processed (known as*end-of-stream*),
18774 # the duration in this field is computed from the beginning of the stream
18775 # until the response has been processed, including all retries. A
18776 # stream that does not complete in this duration is closed.
18777 #
18778 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
18779 # with the route.
18780 #
18781 # This field is only allowed if the Url map is used with backend services
18782 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
18783 # as a count of seconds and fractions of seconds at nanosecond
18784 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18785 # or &quot;month&quot;. Range is approximately 10,000 years.
18786 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18787 # Durations less than one second are represented with a 0
18788 # `seconds` field and a positive `nanos` field. Must be from 0
18789 # to 999,999,999 inclusive.
18790 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18791 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18792 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18793 },
18794 &quot;requestMirrorPolicy&quot;: { # A policy that specifies how requests intended for the route&#x27;s backends # Specifies the policy on how requests intended for the route&#x27;s backends
18795 # are shadowed to a separate mirrored backend service. The load balancer does
18796 # not wait for responses from the shadow service. Before sending traffic
18797 # to the shadow service, the host / authority header is suffixed with-shadow.
18798 #
18799 # Not supported when the URL map is bound to a target gRPC proxy that
18800 # has the validateForProxyless field set to true.
18801 # are shadowed to a separate mirrored backend service. The load balancer
18802 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
18803 # to the shadow service, the host or authority header is suffixed with-shadow.
18804 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
18805 # mirrored to.
18806 #
18807 # The backend service configured for a mirroring
18808 # policy must reference backends that are of the same type as the original
18809 # backend service matched in the URL map.
18810 #
18811 # Serverless NEG backends are not currently supported as a mirrored
18812 # backend service.
18813 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
18814 },
18815 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
18816 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
18817 # If not specified, defaults to 1.
18818 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
18819 #
18820 # If not specified, will use the timeout set in theHttpRouteAction field.
18821 # If timeout in the HttpRouteAction field is not set, this field
18822 # uses the largest timeout
18823 # among all backend services associated with the route.
18824 #
18825 # Not supported when the URL map is bound to a target gRPC proxy that
18826 # has the validateForProxyless field set to true.
18827 # as a count of seconds and fractions of seconds at nanosecond
18828 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18829 # or &quot;month&quot;. Range is approximately 10,000 years.
18830 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18831 # Durations less than one second are represented with a 0
18832 # `seconds` field and a positive `nanos` field. Must be from 0
18833 # to 999,999,999 inclusive.
18834 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18835 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18836 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18837 },
18838 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
18839 # values are:
18840 #
18841 # - 5xx: retry is attempted if the instance or endpoint
18842 # responds with any 5xx response code, or if the instance or
18843 # endpoint does not respond at all. For example, disconnects, reset, read
18844 # timeout, connection failure, and refused streams.
18845 # - gateway-error: Similar to 5xx, but only
18846 # applies to response codes 502, 503 or504.
18847 # - connect-failure: a retry is attempted on failures
18848 # connecting to the instance or endpoint. For example, connection
18849 # timeouts.
18850 # - retriable-4xx: a retry is attempted if the instance
18851 # or endpoint responds with a 4xx response code.
18852 # The only error that you can retry is error code 409.
18853 # - refused-stream: a retry is attempted if the instance
18854 # or endpoint resets the stream with a REFUSED_STREAM error
18855 # code. This reset type indicates that it is safe to retry.
18856 # - cancelled: a retry is attempted if the gRPC status
18857 # code in the response header is set to cancelled.
18858 # - deadline-exceeded: a retry is attempted if the gRPC
18859 # status code in the response header is set todeadline-exceeded.
18860 # - internal: a retry is attempted if the gRPC
18861 # status code in the response header is set tointernal.
18862 # - resource-exhausted: a retry is attempted if the gRPC
18863 # status code in the response header is set toresource-exhausted.
18864 # - unavailable: a retry is attempted if the gRPC
18865 # status code in the response header is set tounavailable.
18866 #
18867 # Only the following codes are supported when the URL map is bound to
18868 # target gRPC proxy that has validateForProxyless field set to true.
18869 #
18870 # - cancelled
18871 # - deadline-exceeded
18872 # - internal
18873 # - resource-exhausted
18874 # - unavailable
18875 &quot;A String&quot;,
18876 ],
18877 },
18878 &quot;timeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
18879 # time the request has been fully processed (known as *end-of-stream*)
18880 # up until the response has been processed. Timeout includes
18881 # all retries.
18882 #
18883 # If not specified, this field uses the largest timeout among all backend
18884 # services associated with the route.
18885 #
18886 # Not supported when the URL map is bound to a target gRPC proxy that
18887 # has validateForProxyless field set to true.
18888 # as a count of seconds and fractions of seconds at nanosecond
18889 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18890 # or &quot;month&quot;. Range is approximately 10,000 years.
18891 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18892 # Durations less than one second are represented with a 0
18893 # `seconds` field and a positive `nanos` field. Must be from 0
18894 # to 999,999,999 inclusive.
18895 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18896 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18897 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18898 },
18899 &quot;urlRewrite&quot;: { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
18900 # to the matched service.
18901 #
18902 # urlRewrite is the only action supported in UrlMaps
18903 # for classic Application Load Balancers.
18904 #
18905 # Not supported when the URL map is bound to a target gRPC proxy that
18906 # has the validateForProxyless field set to true.
18907 # backend service.
18908 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
18909 # host header is replaced with contents of hostRewrite.
18910 #
18911 # The value must be from 1 to 255 characters.
18912 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
18913 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
18914 #
18915 # The value must be from 1 to 1024 characters.
18916 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
18917 # header) using the HTTP template syntax.
18918 #
18919 # A corresponding
18920 # path_template_match must be specified. Any template variables must exist in
18921 # the path_template_match field.
18922 #
18923 #
18924 # - -At least one variable must be specified in the path_template_match
18925 # field
18926 # - You can omit variables from the rewritten URL
18927 # - The * and ** operators cannot be matched
18928 # unless they have a corresponding variable name - e.g.
18929 # {format=*} or {var=**}.
18930 #
18931 # For example, a path_template_match of /static/{format=**}
18932 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
18933 # rewrite, so that /{country}/{format}/{suffix=**} can be
18934 # rewritten as /content/{format}/{country}/{suffix}.
18935 #
18936 # At least
18937 # one non-empty routeRules[].matchRules[].path_template_match is
18938 # required.
18939 #
18940 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
18941 },
18942 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
18943 # occurs. The weights determine the fraction of traffic that flows to
18944 # their corresponding backend service. If all traffic needs to
18945 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
18946 #
18947 # After a backend service is identified and before forwarding
18948 # the request to
18949 # the backend service, advanced routing actions such as URL rewrites and
18950 # header transformations are applied depending on additional settings
18951 # specified in this HttpRouteAction.
18952 { # In contrast to a single BackendService in
18953 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
18954 # multiple backend services. The volume of traffic for each
18955 # backend service is proportional to the weight specified
18956 # in each WeightedBackendService
18957 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
18958 # resource. Before
18959 # forwarding the request to backendService, the load balancer
18960 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
18961 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
18962 # effect for the selected backendService.
18963 #
18964 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
18965 #
18966 # headerAction is not supported for load balancers that have
18967 # their loadBalancingScheme set to EXTERNAL.
18968 #
18969 # Not supported when the URL map is bound to a target gRPC proxy that
18970 # has validateForProxyless field set to true.
18971 # the request is passed along to the selected backendService.
18972 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
18973 { # Specification determining how headers are added to requests or responses.
18974 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
18975 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
18976 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
18977 # that already
18978 # exist for the header. If true, headerValue is set for the
18979 # header, discarding any values that were set for that header.
18980 #
18981 # The default value is true,
18982 # unless a variable is present in headerValue,
18983 # in which case the default value is false.
18984 # .
18985 },
18986 ],
18987 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
18988 # request before forwarding the request to the backendService.
18989 &quot;A String&quot;,
18990 ],
18991 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
18992 # client.
18993 { # Specification determining how headers are added to requests or responses.
18994 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
18995 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
18996 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
18997 # that already
18998 # exist for the header. If true, headerValue is set for the
18999 # header, discarding any values that were set for that header.
19000 #
19001 # The default value is true,
19002 # unless a variable is present in headerValue,
19003 # in which case the default value is false.
19004 # .
19005 },
19006 ],
19007 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
19008 # response before sending the response back to the client.
19009 &quot;A String&quot;,
19010 ],
19011 },
19012 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
19013 # computed asweight / (sum of all weightedBackendService weights in routeAction).
19014 #
19015 # The selection of a backend service is determined only for new traffic.
19016 # Once a user&#x27;s request has been directed to a backend service,
19017 # subsequent requests are sent to the same backend service as
19018 # determined by the backend service&#x27;s session affinity policy.
19019 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
19020 # splitting. If you do, the weighted traffic splitting configuration takes
19021 # precedence.
19022 #
19023 # The value must be from 0 to 1000.
19024 },
19025 ],
19026 },
19027 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
19028 # is directed if this rule is matched. If routeAction is
19029 # also specified, advanced routing actions, such as URL rewrites,
19030 # take effect before sending the request to the backend.
19031 #
19032 #
19033 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
19034 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
19035 # specified by urlRedirect.
19036 #
19037 #
19038 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
19039 #
19040 #
19041 # Not supported when the URL map is bound to a target gRPC proxy.
19042 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
19043 # was supplied in the request.
19044 #
19045 # The value must be from 1 to 255
19046 # characters.
19047 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
19048 # set to HTTPS.
19049 # If set to false, the URL scheme of the redirected request
19050 # remains the same as that of the request.
19051 #
19052 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
19053 #
19054 # The default is set to false.
19055 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
19056 # that was supplied in the request.
19057 #
19058 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
19059 # supplied, the path of the original request is used for the redirect.
19060 #
19061 # The value must be from 1 to 1024 characters.
19062 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
19063 # the HttpRouteRuleMatch, retaining the remaining portion
19064 # of the URL before redirecting the request.
19065 #
19066 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
19067 # supplied, the path of the original request is used for the redirect.
19068 #
19069 # The value must be from 1 to 1024 characters.
19070 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
19071 #
19072 # Supported values are:
19073 #
19074 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
19075 # to 301.
19076 # - FOUND, which corresponds to 302.
19077 # - SEE_OTHER which corresponds to 303.
19078 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
19079 # method is retained.
19080 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
19081 # method is retained.
19082 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
19083 # URL is
19084 # removed before redirecting the request. If set to false, the
19085 # query portion of the original URL is retained.
19086 #
19087 # The default is set to false.
19088 },
19089 },
19090 ],
19091 },
19092 ],
19093 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the regional URL map resides.
19094 # This field is not applicable to global URL maps.
19095 # You must specify this field as part of the HTTP request URL. It is
19096 # not settable as a field in the request body.
19097 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
19098 &quot;tests&quot;: [ # The list of expected URL mapping tests. Request to update theUrlMap succeeds only if all test cases pass. You can specify a
19099 # maximum of 100 tests per UrlMap.
19100 #
19101 # Not supported when the URL map is bound to a target gRPC proxy that
19102 # has validateForProxyless field set to true.
19103 { # Message for the expected URL mappings.
19104 &quot;description&quot;: &quot;A String&quot;, # Description of this test case.
19105 &quot;expectedOutputUrl&quot;: &quot;A String&quot;, # The expected output URL evaluated by the load balancer
19106 # containing the scheme, host, path and query parameters.
19107 #
19108 # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
19109 # the load balancer to backends. For rules with urlRewrite,
19110 # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
19111 #
19112 # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer&#x27;s
19113 # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
19114 # If urlRedirect specifies strip_query, the test
19115 # passes only if expectedOutputUrl does not contain any query
19116 # parameters.
19117 #
19118 # expectedOutputUrl is optional whenservice is specified.
19119 &quot;expectedRedirectResponseCode&quot;: 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
19120 # load balancer&#x27;s redirect response.
19121 #
19122 # expectedRedirectResponseCode cannot be set whenservice is set.
19123 &quot;headers&quot;: [ # HTTP headers for this request. If headers contains
19124 # a host header, then host must also match the header value.
19125 { # HTTP headers used in UrlMapTests.
19126 &quot;name&quot;: &quot;A String&quot;, # Header name.
19127 &quot;value&quot;: &quot;A String&quot;, # Header value.
19128 },
19129 ],
19130 &quot;host&quot;: &quot;A String&quot;, # Host portion of the URL. If headers contains a host header,
19131 # then host must also match the header value.
19132 &quot;path&quot;: &quot;A String&quot;, # Path portion of the URL.
19133 &quot;service&quot;: &quot;A String&quot;, # Expected BackendService or BackendBucket resource
19134 # the given URL should be mapped to.
19135 #
19136 # The service field cannot
19137 # be set if expectedRedirectResponseCode is set.
19138 },
19139 ],
19140 }
19141
19142 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
19143 that if you must retry your request, the server will know to ignore the
19144 request if it has already been completed.
19145
19146 For example, consider a situation where you make an initial request and
19147 the request times out. If you make the request again with the same
19148 request ID, the server can check if original operation with the same
19149 request ID was received, and if so, will ignore the second request. This
19150 prevents clients from accidentally creating duplicate commitments.
19151
19152 The request ID must be
19153 a valid UUID with the exception that zero UUID is not supported
19154 (00000000-0000-0000-0000-000000000000).
19155 x__xgafv: string, V1 error format.
19156 Allowed values
19157 1 - v1 error format
19158 2 - v2 error format
19159
19160 Returns:
19161 An object of the form:
19162
19163 { # Represents an Operation resource.
19164 #
19165 # Google Compute Engine has three Operation resources:
19166 #
19167 # * [Global](/compute/docs/reference/rest/v1/globalOperations)
19168 # * [Regional](/compute/docs/reference/rest/v1/regionOperations)
19169 # * [Zonal](/compute/docs/reference/rest/v1/zoneOperations)
19170 #
19171 # You can use an operation resource to manage asynchronous API requests.
19172 # For more information, readHandling
19173 # API responses.
19174 #
19175 # Operations can be global, regional or zonal.
19176 #
19177 # - For global operations, use the `globalOperations`
19178 # resource.
19179 # - For regional operations, use the
19180 # `regionOperations` resource.
19181 # - For zonal operations, use
19182 # the `zoneOperations` resource.
19183 #
19184 #
19185 #
19186 # For more information, read
19187 # Global, Regional, and Zonal Resources.
19188 #
19189 # Note that completed Operation resources have a limited
19190 # retention period.
19191 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
19192 # Not present otherwise.
19193 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
19194 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
19195 # set when the operation is created.
19196 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
19197 # text format.
19198 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
19199 # this field will be populated.
19200 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
19201 # operation.
19202 {
19203 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
19204 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
19205 # details. There is a set of defined message types to use for providing
19206 # details.The syntax depends on the error code. For example,
19207 # QuotaExceededInfo will have details when the error code is
19208 # QUOTA_EXCEEDED.
19209 {
19210 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
19211 #
19212 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
19213 # is not enabled:
19214 #
19215 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
19216 # &quot;domain&quot;: &quot;googleapis.com&quot;
19217 # &quot;metadata&quot;: {
19218 # &quot;resource&quot;: &quot;projects/123&quot;,
19219 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
19220 # }
19221 # }
19222 #
19223 # This response indicates that the pubsub.googleapis.com API is not enabled.
19224 #
19225 # Example of an error that is returned when attempting to create a Spanner
19226 # instance in a region that is out of stock:
19227 #
19228 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
19229 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
19230 # &quot;metadata&quot;: {
19231 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
19232 # }
19233 # }
19234 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
19235 # is typically the registered service name of the tool or product that
19236 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
19237 # generated by some common infrastructure, the error domain must be a
19238 # globally unique value that identifies the infrastructure. For Google API
19239 # infrastructure, the error domain is &quot;googleapis.com&quot;.
19240 &quot;metadatas&quot;: { # Additional structured details about this error.
19241 #
19242 # Keys must match a regular expression of `a-z+` but should
19243 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
19244 # length. When identifying the current value of an exceeded limit, the units
19245 # should be contained in the key, not the value. For example, rather than
19246 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
19247 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
19248 # instances that can be created in a single (batch) request.
19249 &quot;a_key&quot;: &quot;A String&quot;,
19250 },
19251 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
19252 # proximate cause of the error. Error reasons are unique within a particular
19253 # domain of errors. This should be at most 63 characters and match a
19254 # regular expression of `A-Z+[A-Z0-9]`, which represents
19255 # UPPER_SNAKE_CASE.
19256 },
19257 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
19258 #
19259 # For example, if a quota check failed with an error indicating the calling
19260 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
19261 # directly to the right place in the developer console to flip the bit.
19262 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
19263 { # Describes a URL link.
19264 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
19265 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
19266 },
19267 ],
19268 },
19269 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
19270 # which can be attached to an RPC error.
19271 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
19272 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
19273 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
19274 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
19275 },
19276 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
19277 &quot;dimensions&quot;: { # The map holding related quota dimensions.
19278 &quot;a_key&quot;: &quot;A String&quot;,
19279 },
19280 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
19281 # type or metric.
19282 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
19283 # or metric.
19284 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
19285 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
19286 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
19287 },
19288 },
19289 ],
19290 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
19291 # This property is optional.
19292 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
19293 },
19294 ],
19295 },
19296 &quot;getVersionOperationMetadata&quot;: {
19297 &quot;inlineSbomInfo&quot;: {
19298 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
19299 # appropriate identifiers.
19300 &quot;a_key&quot;: &quot;A String&quot;,
19301 },
19302 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
19303 # identifiers.
19304 &quot;a_key&quot;: &quot;A String&quot;,
19305 },
19306 },
19307 },
19308 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
19309 # message that was returned, such as `NOT FOUND`.
19310 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
19311 # status code that was returned. For example, a `404` means the
19312 # resource was not found.
19313 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
19314 # defined by the server.
19315 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
19316 # This value is inRFC3339
19317 # text format.
19318 &quot;instancesBulkInsertOperationMetadata&quot;: {
19319 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
19320 # Example key: zones/us-central1-a
19321 &quot;a_key&quot;: {
19322 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
19323 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
19324 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
19325 # error.
19326 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
19327 # if the flow is rolling forward or rolling back.
19328 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
19329 },
19330 },
19331 },
19332 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
19333 # Operation resources.
19334 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
19335 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
19336 # group of operations results from a `bulkInsert` API request.
19337 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
19338 # `update`, or `delete`, and so on.
19339 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
19340 # There is no requirement that this be linear or support any granularity of
19341 # operations. This should not be used to guess when the operation will be
19342 # complete. This number should monotonically increase as the operation
19343 # progresses.
19344 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
19345 # applicable when performing regional operations.
19346 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
19347 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
19348 # this field will contain information on all underlying zonal actions and
19349 # their state.
19350 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
19351 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
19352 # Example key: zones/us-central1-a
19353 &quot;a_key&quot;: {
19354 &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
19355 # populated.
19356 # different programming environments, including REST APIs and RPC APIs. It is
19357 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
19358 # three pieces of data: error code, error message, and error details.
19359 #
19360 # You can find out more about this error model and how to work with it in the
19361 # [API Design Guide](https://cloud.google.com/apis/design/errors).
19362 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
19363 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
19364 # message types for APIs to use.
19365 {
19366 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
19367 },
19368 ],
19369 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
19370 # user-facing error message should be localized and sent in the
19371 # google.rpc.Status.details field, or localized by the client.
19372 },
19373 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
19374 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
19375 },
19376 },
19377 },
19378 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
19379 # This value is inRFC3339
19380 # text format.
19381 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
19382 # following:
19383 # `PENDING`, `RUNNING`, or `DONE`.
19384 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
19385 # operation.
19386 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
19387 # of the target resource.
19388 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
19389 # operations related to creating a snapshot, this points to the disk
19390 # that the snapshot was created from.
19391 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
19392 # `[email protected]` or
19393 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
19394 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
19395 # operation, this field will be populated.
19396 {
19397 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
19398 # Engine returns NO_RESULTS_ON_PAGE if there
19399 # are no results in the response.
19400 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
19401 # value format. For example:
19402 #
19403 # &quot;data&quot;: [
19404 # {
19405 # &quot;key&quot;: &quot;scope&quot;,
19406 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
19407 # }
19408 {
19409 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
19410 # returned. For example, for warnings where there are no results in a list
19411 # request for a particular zone, this key might be scope and
19412 # the key value might be the zone name. Other examples might be a key
19413 # indicating a deprecated resource and a suggested replacement, or a
19414 # warning about invalid network settings (for example, if an instance
19415 # attempts to perform IP forwarding but is not enabled for IP forwarding).
19416 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
19417 },
19418 ],
19419 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
19420 },
19421 ],
19422 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
19423 # applicable when performing per-zone operations.
19424 }</pre>
19425 </div>
19426
19427 <div class="method">
19428 <code class="details" id="testIamPermissions">testIamPermissions(project, resource, body=None, x__xgafv=None)</code>
19429 <pre>Returns permissions that a caller has on the specified resource.
19430
19431 Args:
19432 project: string, Project ID for this request. (required)
19433 resource: string, Name or id of the resource for this request. (required)
19434 body: object, The request body.
19435 The object takes the form of:
19436
19437 {
19438 &quot;permissions&quot;: [ # The set of permissions to check for the &#x27;resource&#x27;. Permissions with
19439 # wildcards (such as &#x27;*&#x27; or &#x27;storage.*&#x27;) are not allowed.
19440 &quot;A String&quot;,
19441 ],
19442 }
19443
19444 x__xgafv: string, V1 error format.
19445 Allowed values
19446 1 - v1 error format
19447 2 - v2 error format
19448
19449 Returns:
19450 An object of the form:
19451
19452 {
19453 &quot;permissions&quot;: [ # A subset of `TestPermissionsRequest.permissions` that the caller is
19454 # allowed.
19455 &quot;A String&quot;,
19456 ],
19457 }</pre>
19458 </div>
19459
19460 <div class="method">
19461 <code class="details" id="update">update(project, urlMap, body=None, requestId=None, x__xgafv=None)</code>
19462 <pre>Updates the specified UrlMap resource with the data included in the
19463 request.
19464
19465 Args:
19466 project: string, Project ID for this request. (required)
19467 urlMap: string, Name of the UrlMap resource to update. (required)
19468 body: object, The request body.
19469 The object takes the form of:
19470
19471 { # Represents a URL Map resource.
19472 #
19473 # Compute Engine has two URL Map resources:
19474 #
19475 # * [Global](/compute/docs/reference/rest/v1/urlMaps)
19476 # * [Regional](/compute/docs/reference/rest/v1/regionUrlMaps)
19477 #
19478 # A URL map resource is a component of certain types of cloud load balancers
19479 # and Traffic Director:
19480 #
19481 # * urlMaps are used by global external Application Load
19482 # Balancers, classic Application Load Balancers, and cross-region internal
19483 # Application Load Balancers.
19484 # * regionUrlMaps are used by internal Application Load Balancers,
19485 # regional external Application Load Balancers and regional internal
19486 # Application Load Balancers.
19487 #
19488 # For a list of supported URL map features by the load balancer type, see the
19489 # Load balancing features: Routing and traffic management table.
19490 #
19491 # For a list of supported URL map features for Traffic Director, see the
19492 # Traffic Director features: Routing and traffic management table.
19493 #
19494 # This resource defines mappings from hostnames and URL paths to either a
19495 # backend service or a backend bucket.
19496 #
19497 # To use the global urlMaps resource, the backend service must
19498 # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
19499 # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
19500 # information, read URL
19501 # Map Concepts.
19502 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
19503 # text format.
19504 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
19505 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
19506 #
19507 # This policy takes
19508 # effect at the load balancer level and applies only when no policy has been
19509 # defined for the error code at lower levels like PathMatcher, RouteRule and
19510 # PathRule within this UrlMap.
19511 #
19512 # For example, consider a UrlMap with the
19513 # following configuration:
19514 #
19515 #
19516 # - defaultCustomErrorResponsePolicy containing policies for
19517 # responding to 5xx and 4xx errors
19518 # - A PathMatcher configured for *.example.com has
19519 # defaultCustomErrorResponsePolicy for 4xx.
19520 #
19521 # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
19522 # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
19523 # a request that does not match any host in *.example.com such
19524 # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
19525 # takes effect.
19526 #
19527 # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
19528 # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
19529 # a retry, if load balancer is successful in reaching the
19530 # service, the defaultCustomErrorResponsePolicy is ignored and
19531 # the response from the service is returned to the client.
19532 #
19533 # defaultCustomErrorResponsePolicy is supported only for
19534 # global external Application Load Balancers.
19535 # backend service or backend bucket responds with an error.
19536 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
19537 #
19538 # In a given policy, if you specify rules for both a range of error codes
19539 # as well as rules for specific error codes then rules with specific error
19540 # codes have a higher priority. For example, assume that you configure a rule
19541 # for 401 (Un-authorized) code, and another for all 4 series
19542 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
19543 # However if the backend service returns a 403, the rule for4xx takes effect.
19544 { # Specifies the mapping between the response code that will be returned along
19545 # with the custom error content and the response code returned by the backend
19546 # service.
19547 &quot;matchResponseCodes&quot;: [ # Valid values include:
19548 #
19549 #
19550 # - A number between 400 and 599: For example
19551 # 401 or 503, in which case the load balancer
19552 # applies the policy if the error code exactly matches this value.
19553 # - 5xx: Load Balancer will apply the policy if the
19554 # backend service responds with any response code in the range of
19555 # 500 to 599.
19556 # - 4xx: Load
19557 # Balancer will apply the policy if the backend service responds with any
19558 # response code in the range of 400 to
19559 # 499.
19560 #
19561 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
19562 &quot;A String&quot;,
19563 ],
19564 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
19565 # error content. If overrideResponseCode is not supplied, the
19566 # same response code returned by the original backend bucket or backend
19567 # service is returned to the client.
19568 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
19569 #
19570 # path must start
19571 # with a leading slash. path cannot have trailing slashes.
19572 #
19573 # If the file is not available in backendBucket or the
19574 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
19575 #
19576 # The value must
19577 # be from 1 to 1024 characters
19578 },
19579 ],
19580 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
19581 # contains the custom error content. Examples are:
19582 #
19583 #
19584 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
19585 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
19586 # - global/backendBuckets/myBackendBucket
19587 #
19588 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
19589 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
19590 #
19591 # If load balancer cannot reach
19592 # the backendBucket, a simple Not Found Error will
19593 # be returned, with the original response code (oroverrideResponseCode if configured).
19594 #
19595 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
19596 },
19597 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
19598 # hostRules match. The load balancer performs advanced routing
19599 # actions, such as URL rewrites and header transformations, before forwarding
19600 # the request to the selected backend.
19601 #
19602 #
19603 # Only one of defaultUrlRedirect, defaultService
19604 # or defaultRouteAction.weightedBackendService can be set.
19605 #
19606 #
19607 # URL maps for classic Application Load Balancers only support
19608 # the urlRewrite action within defaultRouteAction.
19609 #
19610 #
19611 # defaultRouteAction has no effect when the URL map is bound
19612 # to a target gRPC proxy that has the validateForProxyless field
19613 # set to true.
19614 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
19615 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
19616 # property must be specified. This policy cannot be specified if any target
19617 # backend has Identity-Aware Proxy enabled.
19618 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
19619 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
19620 # header names can be specified. The cache is bypassed for all `cacheMode`
19621 # values.
19622 &quot;A String&quot;,
19623 ],
19624 &quot;cacheKeyPolicy&quot;: { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
19625 # on the backend type: for Backend Services, the complete request URI is
19626 # used; for Backend Buckets, the request URI is used without the protocol or
19627 # host, and only query parameters known to Cloud Storage are included.
19628 # Policy defined on Route Action.
19629 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
19630 # parameters will be included. Either specify `excludedQueryParameters`
19631 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
19632 # encoded and not treated as delimiters.
19633 #
19634 # Note: This field applies to routes that use backend services. Attempting
19635 # to set it on a route that points exclusively to Backend Buckets will
19636 # result in a configuration error. For routes that point to a Backend
19637 # Bucket, use `includedQueryParameters` to define which parameters should
19638 # be part of the cache key.
19639 &quot;A String&quot;,
19640 ],
19641 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
19642 #
19643 # Note: This setting is only applicable to routes that use a Backend
19644 # Service. It does not affect requests served by a Backend Bucket, as the
19645 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
19646 # it on a route that points exclusively to Backend Buckets will result in a
19647 # configuration error.
19648 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
19649 #
19650 # Note: This setting is only applicable to routes that use a Backend
19651 # Service. It does not affect requests served by a Backend Bucket, as the
19652 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
19653 # set on a route that points exclusively to Backend Buckets will result in
19654 # a configuration error.
19655 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
19656 # `includedQueryParameters` and `excludedQueryParameters`. If neither
19657 # is set, the entire query string will be included. If false, the query
19658 # string will be excluded from the cache key entirely.
19659 #
19660 # Note: This field applies to routes that use backend services. Attempting
19661 # to set it on a route that points exclusively to Backend Buckets will
19662 # result in a configuration error. For routes that point to a Backend
19663 # Bucket, use `includedQueryParameters` to define which parameters should
19664 # be part of the cache key.
19665 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
19666 # The name=value pair will be used in the cache key Cloud CDN generates.
19667 #
19668 # Note: This setting is only applicable to routes that use a Backend
19669 # Service. It does not affect requests served by a Backend Bucket.
19670 # Attempting to set it on a route that points exclusively to Backend
19671 # Buckets will result in a configuration error. Up to 5 cookie names can be
19672 # specified.
19673 &quot;A String&quot;,
19674 ],
19675 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
19676 &quot;A String&quot;,
19677 ],
19678 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
19679 # parameters will be excluded. Either specify `includedQueryParameters`
19680 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
19681 # encoded and not treated as delimiters.
19682 &quot;A String&quot;,
19683 ],
19684 },
19685 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
19686 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
19687 &quot;clientTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
19688 # content. This is used to clamp the max-age (or Expires) value sent to the
19689 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
19690 # is used for the response max-age directive, along with a &quot;public&quot;
19691 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
19692 # clamps the max-age from the origin (if specified), or else sets the
19693 # response max-age directive to the lesser of the `clientTtl` and
19694 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
19695 # present. The maximum allowed value is 31,622,400s (1 year). If not
19696 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
19697 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
19698 # `USE_ORIGIN_HEADERS`.
19699 # as a count of seconds and fractions of seconds at nanosecond
19700 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19701 # or &quot;month&quot;. Range is approximately 10,000 years.
19702 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19703 # Durations less than one second are represented with a 0
19704 # `seconds` field and a positive `nanos` field. Must be from 0
19705 # to 999,999,999 inclusive.
19706 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19707 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19708 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19709 },
19710 &quot;defaultTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
19711 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
19712 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
19713 # greater than that of `maxTtl`. When the `cacheMode` is set to
19714 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
19715 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
19716 # accessed objects may be evicted from the cache before the defined TTL. If
19717 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
19718 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
19719 # `USE_ORIGIN_HEADERS`.
19720 # as a count of seconds and fractions of seconds at nanosecond
19721 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19722 # or &quot;month&quot;. Range is approximately 10,000 years.
19723 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19724 # Durations less than one second are represented with a 0
19725 # `seconds` field and a positive `nanos` field. Must be from 0
19726 # to 999,999,999 inclusive.
19727 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19728 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19729 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19730 },
19731 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
19732 # attempt to set a max-age or s-maxage higher than this, or an Expires header
19733 # more than `maxTtl` seconds in the future will be capped at the value of
19734 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
19735 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
19736 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
19737 # Infrequently accessed objects may be evicted from the cache before the
19738 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
19739 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
19740 # mode.
19741 # as a count of seconds and fractions of seconds at nanosecond
19742 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19743 # or &quot;month&quot;. Range is approximately 10,000 years.
19744 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19745 # Durations less than one second are represented with a 0
19746 # `seconds` field and a positive `nanos` field. Must be from 0
19747 # to 999,999,999 inclusive.
19748 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19749 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19750 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19751 },
19752 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
19753 # to apply fine-grained caching for common errors or redirects.
19754 # This can reduce the load on your origin and improve end-user
19755 # experience by reducing response latency.
19756 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
19757 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
19758 # the specified response code that lack any Cache-Control, Expires, or
19759 # Pragma: no-cache directives. When the `cacheMode` is set to
19760 # `FORCE_CACHE_ALL`, negative caching applies to all responses
19761 # with the specified response code, and overrides any caching headers. By
19762 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
19763 #
19764 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
19765 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
19766 # * 405 (Method Not Found), 501 (Not Implemented): 60s
19767 #
19768 # These defaults can be overridden in `negativeCachingPolicy`.
19769 # If not specified, Cloud CDN applies negative caching by default.
19770 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
19771 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
19772 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
19773 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
19774 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
19775 # all response codes that you wish to cache. Cloud CDN will not apply any
19776 # default negative caching when a policy exists.
19777 { # Specify CDN TTLs for response error codes.
19778 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
19779 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
19780 # specified as values, and you cannot specify a status code more than
19781 # once.
19782 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
19783 # corresponding status code.
19784 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
19785 # objects may be evicted from the cache before the defined TTL.
19786 # as a count of seconds and fractions of seconds at nanosecond
19787 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19788 # or &quot;month&quot;. Range is approximately 10,000 years.
19789 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19790 # Durations less than one second are represented with a 0
19791 # `seconds` field and a positive `nanos` field. Must be from 0
19792 # to 999,999,999 inclusive.
19793 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19794 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19795 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19796 },
19797 },
19798 ],
19799 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
19800 # requests into a small number of requests to the origin. If not specified,
19801 # Cloud CDN applies request coalescing by default.
19802 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
19803 # content with the origin, or when an error is encountered when refreshing
19804 # the cache.
19805 # This setting defines the default &quot;max-stale&quot; duration for any cached
19806 # responses that do not specify a max-stale directive. Stale responses that
19807 # exceed the TTL configured here will not be served. The default limit
19808 # (max-stale) is 86400s (1 day), which will allow stale content to be
19809 # served up to this limit beyond the max-age (or s-maxage) of a cached
19810 # response.
19811 # The maximum allowed value is 604800 (1 week).
19812 # Set this to zero (0) to disable serve-while-stale.
19813 # as a count of seconds and fractions of seconds at nanosecond
19814 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19815 # or &quot;month&quot;. Range is approximately 10,000 years.
19816 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19817 # Durations less than one second are represented with a 0
19818 # `seconds` field and a positive `nanos` field. Must be from 0
19819 # to 999,999,999 inclusive.
19820 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19821 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19822 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19823 },
19824 },
19825 &quot;corsPolicy&quot;: { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
19826 # information about the W3C recommendation for cross-origin resource sharing
19827 # (CORS), see Fetch API Living
19828 # Standard.
19829 #
19830 # Not supported when the URL map is bound to a target gRPC proxy.
19831 # information about the W3C recommendation for cross-origin resource sharing
19832 # (CORS), see Fetch API Living
19833 # Standard.
19834 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
19835 # indicates that
19836 # the actual request can include user credentials. This field translates to
19837 # the Access-Control-Allow-Credentials header.
19838 #
19839 # Default is false.
19840 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
19841 # header.
19842 &quot;A String&quot;,
19843 ],
19844 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
19845 # header.
19846 &quot;A String&quot;,
19847 ],
19848 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
19849 # more information, see regular expression syntax.
19850 #
19851 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
19852 #
19853 # Regular expressions can only be used when the loadBalancingScheme is
19854 # set to INTERNAL_SELF_MANAGED.
19855 &quot;A String&quot;,
19856 ],
19857 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
19858 #
19859 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
19860 &quot;A String&quot;,
19861 ],
19862 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
19863 # The default value is false, which indicates that the CORS
19864 # policy is in effect.
19865 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
19866 # header.
19867 &quot;A String&quot;,
19868 ],
19869 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
19870 # seconds. This field translates to the Access-Control-Max-Age
19871 # header.
19872 },
19873 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
19874 # the resiliency of clients to backend service failure. As part of fault
19875 # injection, when clients send requests to a backend service, delays can be
19876 # introduced by a load balancer on a percentage of requests before sending
19877 # those requests to the backend service. Similarly requests from clients can
19878 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
19879 # that are configured with a fault_injection_policy if:
19880 # 1. The traffic is generated by fault injection AND
19881 # 2. The fault injection is not a delay fault injection.
19882 # Fault injection is not supported with the classic Application Load Balancer
19883 # . To see which load balancers support fault injection,
19884 # see Load
19885 # balancing: Routing and traffic management features.
19886 # the resiliency of clients to backend service failure. As part of fault
19887 # injection, when clients send requests to a backend service, delays can be
19888 # introduced by the load balancer on a percentage of requests before sending
19889 # those request to the backend service. Similarly requests from clients can be
19890 # aborted by the load balancer for a percentage of requests.
19891 &quot;abort&quot;: { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
19892 # injection.
19893 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
19894 #
19895 # The value must be from 200 to 599 inclusive.
19896 #
19897 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
19898 # according to this
19899 # mapping table. HTTP status 200 is mapped to gRPC status
19900 # UNKNOWN. Injecting an OK status is currently not supported by
19901 # Traffic Director.
19902 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
19903 # that is aborted as part of fault injection.
19904 #
19905 # The value must be from 0.0 to 100.0 inclusive.
19906 },
19907 &quot;delay&quot;: { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
19908 # injection, before being sent to a backend service.
19909 # request to the backend service as part of fault injection.
19910 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
19911 # as a count of seconds and fractions of seconds at nanosecond
19912 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19913 # or &quot;month&quot;. Range is approximately 10,000 years.
19914 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19915 # Durations less than one second are represented with a 0
19916 # `seconds` field and a positive `nanos` field. Must be from 0
19917 # to 999,999,999 inclusive.
19918 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19919 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19920 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19921 },
19922 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
19923 # which a delay is introduced as part of fault injection.
19924 #
19925 # The value must be from 0.0 to 100.0 inclusive.
19926 },
19927 },
19928 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
19929 # Unlike the timeout field where the timeout duration starts
19930 # from the time the request has been fully processed (known as*end-of-stream*),
19931 # the duration in this field is computed from the beginning of the stream
19932 # until the response has been processed, including all retries. A
19933 # stream that does not complete in this duration is closed.
19934 #
19935 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
19936 # with the route.
19937 #
19938 # This field is only allowed if the Url map is used with backend services
19939 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
19940 # as a count of seconds and fractions of seconds at nanosecond
19941 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19942 # or &quot;month&quot;. Range is approximately 10,000 years.
19943 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19944 # Durations less than one second are represented with a 0
19945 # `seconds` field and a positive `nanos` field. Must be from 0
19946 # to 999,999,999 inclusive.
19947 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19948 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19949 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19950 },
19951 &quot;requestMirrorPolicy&quot;: { # A policy that specifies how requests intended for the route&#x27;s backends # Specifies the policy on how requests intended for the route&#x27;s backends
19952 # are shadowed to a separate mirrored backend service. The load balancer does
19953 # not wait for responses from the shadow service. Before sending traffic
19954 # to the shadow service, the host / authority header is suffixed with-shadow.
19955 #
19956 # Not supported when the URL map is bound to a target gRPC proxy that
19957 # has the validateForProxyless field set to true.
19958 # are shadowed to a separate mirrored backend service. The load balancer
19959 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
19960 # to the shadow service, the host or authority header is suffixed with-shadow.
19961 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
19962 # mirrored to.
19963 #
19964 # The backend service configured for a mirroring
19965 # policy must reference backends that are of the same type as the original
19966 # backend service matched in the URL map.
19967 #
19968 # Serverless NEG backends are not currently supported as a mirrored
19969 # backend service.
19970 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
19971 },
19972 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
19973 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
19974 # If not specified, defaults to 1.
19975 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
19976 #
19977 # If not specified, will use the timeout set in theHttpRouteAction field.
19978 # If timeout in the HttpRouteAction field is not set, this field
19979 # uses the largest timeout
19980 # among all backend services associated with the route.
19981 #
19982 # Not supported when the URL map is bound to a target gRPC proxy that
19983 # has the validateForProxyless field set to true.
19984 # as a count of seconds and fractions of seconds at nanosecond
19985 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19986 # or &quot;month&quot;. Range is approximately 10,000 years.
19987 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19988 # Durations less than one second are represented with a 0
19989 # `seconds` field and a positive `nanos` field. Must be from 0
19990 # to 999,999,999 inclusive.
19991 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19992 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19993 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19994 },
19995 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
19996 # values are:
19997 #
19998 # - 5xx: retry is attempted if the instance or endpoint
19999 # responds with any 5xx response code, or if the instance or
20000 # endpoint does not respond at all. For example, disconnects, reset, read
20001 # timeout, connection failure, and refused streams.
20002 # - gateway-error: Similar to 5xx, but only
20003 # applies to response codes 502, 503 or504.
20004 # - connect-failure: a retry is attempted on failures
20005 # connecting to the instance or endpoint. For example, connection
20006 # timeouts.
20007 # - retriable-4xx: a retry is attempted if the instance
20008 # or endpoint responds with a 4xx response code.
20009 # The only error that you can retry is error code 409.
20010 # - refused-stream: a retry is attempted if the instance
20011 # or endpoint resets the stream with a REFUSED_STREAM error
20012 # code. This reset type indicates that it is safe to retry.
20013 # - cancelled: a retry is attempted if the gRPC status
20014 # code in the response header is set to cancelled.
20015 # - deadline-exceeded: a retry is attempted if the gRPC
20016 # status code in the response header is set todeadline-exceeded.
20017 # - internal: a retry is attempted if the gRPC
20018 # status code in the response header is set tointernal.
20019 # - resource-exhausted: a retry is attempted if the gRPC
20020 # status code in the response header is set toresource-exhausted.
20021 # - unavailable: a retry is attempted if the gRPC
20022 # status code in the response header is set tounavailable.
20023 #
20024 # Only the following codes are supported when the URL map is bound to
20025 # target gRPC proxy that has validateForProxyless field set to true.
20026 #
20027 # - cancelled
20028 # - deadline-exceeded
20029 # - internal
20030 # - resource-exhausted
20031 # - unavailable
20032 &quot;A String&quot;,
20033 ],
20034 },
20035 &quot;timeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
20036 # time the request has been fully processed (known as *end-of-stream*)
20037 # up until the response has been processed. Timeout includes
20038 # all retries.
20039 #
20040 # If not specified, this field uses the largest timeout among all backend
20041 # services associated with the route.
20042 #
20043 # Not supported when the URL map is bound to a target gRPC proxy that
20044 # has validateForProxyless field set to true.
20045 # as a count of seconds and fractions of seconds at nanosecond
20046 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
20047 # or &quot;month&quot;. Range is approximately 10,000 years.
20048 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
20049 # Durations less than one second are represented with a 0
20050 # `seconds` field and a positive `nanos` field. Must be from 0
20051 # to 999,999,999 inclusive.
20052 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
20053 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
20054 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
20055 },
20056 &quot;urlRewrite&quot;: { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
20057 # to the matched service.
20058 #
20059 # urlRewrite is the only action supported in UrlMaps
20060 # for classic Application Load Balancers.
20061 #
20062 # Not supported when the URL map is bound to a target gRPC proxy that
20063 # has the validateForProxyless field set to true.
20064 # backend service.
20065 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
20066 # host header is replaced with contents of hostRewrite.
20067 #
20068 # The value must be from 1 to 255 characters.
20069 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
20070 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
20071 #
20072 # The value must be from 1 to 1024 characters.
20073 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
20074 # header) using the HTTP template syntax.
20075 #
20076 # A corresponding
20077 # path_template_match must be specified. Any template variables must exist in
20078 # the path_template_match field.
20079 #
20080 #
20081 # - -At least one variable must be specified in the path_template_match
20082 # field
20083 # - You can omit variables from the rewritten URL
20084 # - The * and ** operators cannot be matched
20085 # unless they have a corresponding variable name - e.g.
20086 # {format=*} or {var=**}.
20087 #
20088 # For example, a path_template_match of /static/{format=**}
20089 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
20090 # rewrite, so that /{country}/{format}/{suffix=**} can be
20091 # rewritten as /content/{format}/{country}/{suffix}.
20092 #
20093 # At least
20094 # one non-empty routeRules[].matchRules[].path_template_match is
20095 # required.
20096 #
20097 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
20098 },
20099 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
20100 # occurs. The weights determine the fraction of traffic that flows to
20101 # their corresponding backend service. If all traffic needs to
20102 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
20103 #
20104 # After a backend service is identified and before forwarding
20105 # the request to
20106 # the backend service, advanced routing actions such as URL rewrites and
20107 # header transformations are applied depending on additional settings
20108 # specified in this HttpRouteAction.
20109 { # In contrast to a single BackendService in
20110 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
20111 # multiple backend services. The volume of traffic for each
20112 # backend service is proportional to the weight specified
20113 # in each WeightedBackendService
20114 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
20115 # resource. Before
20116 # forwarding the request to backendService, the load balancer
20117 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
20118 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
20119 # effect for the selected backendService.
20120 #
20121 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
20122 #
20123 # headerAction is not supported for load balancers that have
20124 # their loadBalancingScheme set to EXTERNAL.
20125 #
20126 # Not supported when the URL map is bound to a target gRPC proxy that
20127 # has validateForProxyless field set to true.
20128 # the request is passed along to the selected backendService.
20129 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
20130 { # Specification determining how headers are added to requests or responses.
20131 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
20132 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
20133 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
20134 # that already
20135 # exist for the header. If true, headerValue is set for the
20136 # header, discarding any values that were set for that header.
20137 #
20138 # The default value is true,
20139 # unless a variable is present in headerValue,
20140 # in which case the default value is false.
20141 # .
20142 },
20143 ],
20144 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
20145 # request before forwarding the request to the backendService.
20146 &quot;A String&quot;,
20147 ],
20148 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
20149 # client.
20150 { # Specification determining how headers are added to requests or responses.
20151 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
20152 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
20153 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
20154 # that already
20155 # exist for the header. If true, headerValue is set for the
20156 # header, discarding any values that were set for that header.
20157 #
20158 # The default value is true,
20159 # unless a variable is present in headerValue,
20160 # in which case the default value is false.
20161 # .
20162 },
20163 ],
20164 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
20165 # response before sending the response back to the client.
20166 &quot;A String&quot;,
20167 ],
20168 },
20169 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
20170 # computed asweight / (sum of all weightedBackendService weights in routeAction).
20171 #
20172 # The selection of a backend service is determined only for new traffic.
20173 # Once a user&#x27;s request has been directed to a backend service,
20174 # subsequent requests are sent to the same backend service as
20175 # determined by the backend service&#x27;s session affinity policy.
20176 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
20177 # splitting. If you do, the weighted traffic splitting configuration takes
20178 # precedence.
20179 #
20180 # The value must be from 0 to 1000.
20181 },
20182 ],
20183 },
20184 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL of the defaultService resource to
20185 # which traffic is directed if none of the hostRules match.
20186 # If defaultRouteAction is also specified, advanced
20187 # routing actions, such as URL rewrites, take effect before sending the
20188 # request to the backend.
20189 #
20190 #
20191 # Only one of defaultUrlRedirect, defaultService
20192 # or defaultRouteAction.weightedBackendService can be set.
20193 #
20194 #
20195 # defaultService has no effect when the URL map is bound
20196 # to a target gRPC proxy that has the validateForProxyless field
20197 # set to true.
20198 &quot;defaultUrlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
20199 # is redirected to a URL specified by defaultUrlRedirect.
20200 #
20201 #
20202 # Only one of defaultUrlRedirect, defaultService
20203 # or defaultRouteAction.weightedBackendService can be set.
20204 #
20205 #
20206 # Not supported when the URL map is bound to a target gRPC proxy.
20207 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
20208 # was supplied in the request.
20209 #
20210 # The value must be from 1 to 255
20211 # characters.
20212 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
20213 # set to HTTPS.
20214 # If set to false, the URL scheme of the redirected request
20215 # remains the same as that of the request.
20216 #
20217 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
20218 #
20219 # The default is set to false.
20220 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
20221 # that was supplied in the request.
20222 #
20223 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
20224 # supplied, the path of the original request is used for the redirect.
20225 #
20226 # The value must be from 1 to 1024 characters.
20227 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
20228 # the HttpRouteRuleMatch, retaining the remaining portion
20229 # of the URL before redirecting the request.
20230 #
20231 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
20232 # supplied, the path of the original request is used for the redirect.
20233 #
20234 # The value must be from 1 to 1024 characters.
20235 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
20236 #
20237 # Supported values are:
20238 #
20239 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
20240 # to 301.
20241 # - FOUND, which corresponds to 302.
20242 # - SEE_OTHER which corresponds to 303.
20243 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
20244 # method is retained.
20245 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
20246 # method is retained.
20247 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
20248 # URL is
20249 # removed before redirecting the request. If set to false, the
20250 # query portion of the original URL is retained.
20251 #
20252 # The default is set to false.
20253 },
20254 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
20255 # create the resource.
20256 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. A hash of the contents stored in this object.
20257 # This field is used in optimistic locking. This field is ignored when
20258 # inserting a UrlMap. An up-to-date fingerprint must be provided
20259 # in order to update the UrlMap, otherwise the request will
20260 # fail with error 412 conditionNotMet.
20261 #
20262 # To see the latest fingerprint, make a get() request to
20263 # retrieve a UrlMap.
20264 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
20265 # for the selected backendService.
20266 #
20267 # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
20268 #
20269 # headerAction is not supported for load balancers
20270 # that have
20271 # their loadBalancingScheme set to EXTERNAL.
20272 #
20273 # Not supported when the URL map is bound to a target gRPC proxy that
20274 # has validateForProxyless field set to true.
20275 # the request is passed along to the selected backendService.
20276 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
20277 { # Specification determining how headers are added to requests or responses.
20278 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
20279 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
20280 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
20281 # that already
20282 # exist for the header. If true, headerValue is set for the
20283 # header, discarding any values that were set for that header.
20284 #
20285 # The default value is true,
20286 # unless a variable is present in headerValue,
20287 # in which case the default value is false.
20288 # .
20289 },
20290 ],
20291 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
20292 # request before forwarding the request to the backendService.
20293 &quot;A String&quot;,
20294 ],
20295 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
20296 # client.
20297 { # Specification determining how headers are added to requests or responses.
20298 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
20299 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
20300 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
20301 # that already
20302 # exist for the header. If true, headerValue is set for the
20303 # header, discarding any values that were set for that header.
20304 #
20305 # The default value is true,
20306 # unless a variable is present in headerValue,
20307 # in which case the default value is false.
20308 # .
20309 },
20310 ],
20311 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
20312 # response before sending the response back to the client.
20313 &quot;A String&quot;,
20314 ],
20315 },
20316 &quot;hostRules&quot;: [ # The list of host rules to use against the URL.
20317 { # UrlMaps
20318 # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
20319 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
20320 # create the resource.
20321 &quot;hosts&quot;: [ # The list of host patterns to match. They must be valid hostnames with
20322 # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
20323 # that case, * must be the first character, and if followed by
20324 # anything, the immediate following character must be either -
20325 # or ..
20326 #
20327 # * based matching is not supported when the URL map is bound
20328 # to a target gRPC proxy that has the validateForProxyless field
20329 # set to true.
20330 &quot;A String&quot;,
20331 ],
20332 &quot;pathMatcher&quot;: &quot;A String&quot;, # The name of the PathMatcher to use to match the path portion
20333 # of the URL if the hostRule matches the URL&#x27;s host portion.
20334 },
20335 ],
20336 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the resource. This identifier is
20337 # defined by the server.
20338 &quot;kind&quot;: &quot;compute#urlMap&quot;, # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
20339 # url maps.
20340 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
20341 # The name must be 1-63 characters long, and comply withRFC1035.
20342 # Specifically, the name must be 1-63 characters long and match the regular
20343 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
20344 # character must be a lowercase letter, and all following characters must
20345 # be a dash, lowercase letter, or digit, except the last character, which
20346 # cannot be a dash.
20347 &quot;pathMatchers&quot;: [ # The list of named PathMatchers to use against the URL.
20348 { # A matcher for the path portion of the URL. The BackendService
20349 # from the longest-matched rule will serve the URL. If no rule was matched, the
20350 # default service is used.
20351 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
20352 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
20353 #
20354 # This policy takes
20355 # effect at the PathMatcher level and applies only when no
20356 # policy has been defined for the error code at lower levels likeRouteRule and PathRule within thisPathMatcher. If an error code does not have a policy defined
20357 # in defaultCustomErrorResponsePolicy, then a policy defined for
20358 # the error code in UrlMap.defaultCustomErrorResponsePolicy
20359 # takes effect.
20360 #
20361 # For example, consider a UrlMap with the following
20362 # configuration:
20363 #
20364 #
20365 # - UrlMap.defaultCustomErrorResponsePolicy is configured
20366 # with policies for 5xx and 4xx errors
20367 # - A RouteRule for /coming_soon/ is configured for the
20368 # error code 404.
20369 #
20370 # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher&#x27;s policy
20371 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
20372 # the policy in RouteRule.customErrorResponsePolicy takes
20373 # effect. If any of the requests in this example encounter a 500
20374 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
20375 #
20376 # When
20377 # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
20378 # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
20379 # a retry, if load balancer is successful in reaching the
20380 # service, the defaultCustomErrorResponsePolicy is ignored and
20381 # the response from the service is returned to the client.
20382 #
20383 # defaultCustomErrorResponsePolicy is supported only for
20384 # global external Application Load Balancers.
20385 # backend service or backend bucket responds with an error.
20386 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
20387 #
20388 # In a given policy, if you specify rules for both a range of error codes
20389 # as well as rules for specific error codes then rules with specific error
20390 # codes have a higher priority. For example, assume that you configure a rule
20391 # for 401 (Un-authorized) code, and another for all 4 series
20392 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
20393 # However if the backend service returns a 403, the rule for4xx takes effect.
20394 { # Specifies the mapping between the response code that will be returned along
20395 # with the custom error content and the response code returned by the backend
20396 # service.
20397 &quot;matchResponseCodes&quot;: [ # Valid values include:
20398 #
20399 #
20400 # - A number between 400 and 599: For example
20401 # 401 or 503, in which case the load balancer
20402 # applies the policy if the error code exactly matches this value.
20403 # - 5xx: Load Balancer will apply the policy if the
20404 # backend service responds with any response code in the range of
20405 # 500 to 599.
20406 # - 4xx: Load
20407 # Balancer will apply the policy if the backend service responds with any
20408 # response code in the range of 400 to
20409 # 499.
20410 #
20411 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
20412 &quot;A String&quot;,
20413 ],
20414 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
20415 # error content. If overrideResponseCode is not supplied, the
20416 # same response code returned by the original backend bucket or backend
20417 # service is returned to the client.
20418 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
20419 #
20420 # path must start
20421 # with a leading slash. path cannot have trailing slashes.
20422 #
20423 # If the file is not available in backendBucket or the
20424 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
20425 #
20426 # The value must
20427 # be from 1 to 1024 characters
20428 },
20429 ],
20430 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
20431 # contains the custom error content. Examples are:
20432 #
20433 #
20434 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
20435 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
20436 # - global/backendBuckets/myBackendBucket
20437 #
20438 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
20439 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
20440 #
20441 # If load balancer cannot reach
20442 # the backendBucket, a simple Not Found Error will
20443 # be returned, with the original response code (oroverrideResponseCode if configured).
20444 #
20445 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
20446 },
20447 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
20448 # pathRules or routeRules match. The load balancer
20449 # performs advanced routing actions, such as URL rewrites and
20450 # header transformations, before forwarding the request to the
20451 # selected backend.
20452 #
20453 #
20454 # Only one of defaultUrlRedirect, defaultService
20455 # or defaultRouteAction.weightedBackendService can be set.
20456 #
20457 #
20458 # URL maps for classic Application Load Balancers only support
20459 # the urlRewrite action within a path matcher&#x27;sdefaultRouteAction.
20460 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
20461 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
20462 # property must be specified. This policy cannot be specified if any target
20463 # backend has Identity-Aware Proxy enabled.
20464 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
20465 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
20466 # header names can be specified. The cache is bypassed for all `cacheMode`
20467 # values.
20468 &quot;A String&quot;,
20469 ],
20470 &quot;cacheKeyPolicy&quot;: { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
20471 # on the backend type: for Backend Services, the complete request URI is
20472 # used; for Backend Buckets, the request URI is used without the protocol or
20473 # host, and only query parameters known to Cloud Storage are included.
20474 # Policy defined on Route Action.
20475 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
20476 # parameters will be included. Either specify `excludedQueryParameters`
20477 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
20478 # encoded and not treated as delimiters.
20479 #
20480 # Note: This field applies to routes that use backend services. Attempting
20481 # to set it on a route that points exclusively to Backend Buckets will
20482 # result in a configuration error. For routes that point to a Backend
20483 # Bucket, use `includedQueryParameters` to define which parameters should
20484 # be part of the cache key.
20485 &quot;A String&quot;,
20486 ],
20487 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
20488 #
20489 # Note: This setting is only applicable to routes that use a Backend
20490 # Service. It does not affect requests served by a Backend Bucket, as the
20491 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
20492 # it on a route that points exclusively to Backend Buckets will result in a
20493 # configuration error.
20494 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
20495 #
20496 # Note: This setting is only applicable to routes that use a Backend
20497 # Service. It does not affect requests served by a Backend Bucket, as the
20498 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
20499 # set on a route that points exclusively to Backend Buckets will result in
20500 # a configuration error.
20501 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
20502 # `includedQueryParameters` and `excludedQueryParameters`. If neither
20503 # is set, the entire query string will be included. If false, the query
20504 # string will be excluded from the cache key entirely.
20505 #
20506 # Note: This field applies to routes that use backend services. Attempting
20507 # to set it on a route that points exclusively to Backend Buckets will
20508 # result in a configuration error. For routes that point to a Backend
20509 # Bucket, use `includedQueryParameters` to define which parameters should
20510 # be part of the cache key.
20511 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
20512 # The name=value pair will be used in the cache key Cloud CDN generates.
20513 #
20514 # Note: This setting is only applicable to routes that use a Backend
20515 # Service. It does not affect requests served by a Backend Bucket.
20516 # Attempting to set it on a route that points exclusively to Backend
20517 # Buckets will result in a configuration error. Up to 5 cookie names can be
20518 # specified.
20519 &quot;A String&quot;,
20520 ],
20521 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
20522 &quot;A String&quot;,
20523 ],
20524 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
20525 # parameters will be excluded. Either specify `includedQueryParameters`
20526 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
20527 # encoded and not treated as delimiters.
20528 &quot;A String&quot;,
20529 ],
20530 },
20531 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
20532 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
20533 &quot;clientTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
20534 # content. This is used to clamp the max-age (or Expires) value sent to the
20535 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
20536 # is used for the response max-age directive, along with a &quot;public&quot;
20537 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
20538 # clamps the max-age from the origin (if specified), or else sets the
20539 # response max-age directive to the lesser of the `clientTtl` and
20540 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
20541 # present. The maximum allowed value is 31,622,400s (1 year). If not
20542 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
20543 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
20544 # `USE_ORIGIN_HEADERS`.
20545 # as a count of seconds and fractions of seconds at nanosecond
20546 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
20547 # or &quot;month&quot;. Range is approximately 10,000 years.
20548 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
20549 # Durations less than one second are represented with a 0
20550 # `seconds` field and a positive `nanos` field. Must be from 0
20551 # to 999,999,999 inclusive.
20552 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
20553 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
20554 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
20555 },
20556 &quot;defaultTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
20557 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
20558 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
20559 # greater than that of `maxTtl`. When the `cacheMode` is set to
20560 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
20561 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
20562 # accessed objects may be evicted from the cache before the defined TTL. If
20563 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
20564 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
20565 # `USE_ORIGIN_HEADERS`.
20566 # as a count of seconds and fractions of seconds at nanosecond
20567 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
20568 # or &quot;month&quot;. Range is approximately 10,000 years.
20569 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
20570 # Durations less than one second are represented with a 0
20571 # `seconds` field and a positive `nanos` field. Must be from 0
20572 # to 999,999,999 inclusive.
20573 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
20574 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
20575 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
20576 },
20577 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
20578 # attempt to set a max-age or s-maxage higher than this, or an Expires header
20579 # more than `maxTtl` seconds in the future will be capped at the value of
20580 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
20581 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
20582 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
20583 # Infrequently accessed objects may be evicted from the cache before the
20584 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
20585 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
20586 # mode.
20587 # as a count of seconds and fractions of seconds at nanosecond
20588 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
20589 # or &quot;month&quot;. Range is approximately 10,000 years.
20590 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
20591 # Durations less than one second are represented with a 0
20592 # `seconds` field and a positive `nanos` field. Must be from 0
20593 # to 999,999,999 inclusive.
20594 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
20595 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
20596 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
20597 },
20598 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
20599 # to apply fine-grained caching for common errors or redirects.
20600 # This can reduce the load on your origin and improve end-user
20601 # experience by reducing response latency.
20602 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
20603 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
20604 # the specified response code that lack any Cache-Control, Expires, or
20605 # Pragma: no-cache directives. When the `cacheMode` is set to
20606 # `FORCE_CACHE_ALL`, negative caching applies to all responses
20607 # with the specified response code, and overrides any caching headers. By
20608 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
20609 #
20610 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
20611 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
20612 # * 405 (Method Not Found), 501 (Not Implemented): 60s
20613 #
20614 # These defaults can be overridden in `negativeCachingPolicy`.
20615 # If not specified, Cloud CDN applies negative caching by default.
20616 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
20617 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
20618 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
20619 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
20620 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
20621 # all response codes that you wish to cache. Cloud CDN will not apply any
20622 # default negative caching when a policy exists.
20623 { # Specify CDN TTLs for response error codes.
20624 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
20625 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
20626 # specified as values, and you cannot specify a status code more than
20627 # once.
20628 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
20629 # corresponding status code.
20630 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
20631 # objects may be evicted from the cache before the defined TTL.
20632 # as a count of seconds and fractions of seconds at nanosecond
20633 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
20634 # or &quot;month&quot;. Range is approximately 10,000 years.
20635 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
20636 # Durations less than one second are represented with a 0
20637 # `seconds` field and a positive `nanos` field. Must be from 0
20638 # to 999,999,999 inclusive.
20639 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
20640 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
20641 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
20642 },
20643 },
20644 ],
20645 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
20646 # requests into a small number of requests to the origin. If not specified,
20647 # Cloud CDN applies request coalescing by default.
20648 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
20649 # content with the origin, or when an error is encountered when refreshing
20650 # the cache.
20651 # This setting defines the default &quot;max-stale&quot; duration for any cached
20652 # responses that do not specify a max-stale directive. Stale responses that
20653 # exceed the TTL configured here will not be served. The default limit
20654 # (max-stale) is 86400s (1 day), which will allow stale content to be
20655 # served up to this limit beyond the max-age (or s-maxage) of a cached
20656 # response.
20657 # The maximum allowed value is 604800 (1 week).
20658 # Set this to zero (0) to disable serve-while-stale.
20659 # as a count of seconds and fractions of seconds at nanosecond
20660 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
20661 # or &quot;month&quot;. Range is approximately 10,000 years.
20662 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
20663 # Durations less than one second are represented with a 0
20664 # `seconds` field and a positive `nanos` field. Must be from 0
20665 # to 999,999,999 inclusive.
20666 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
20667 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
20668 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
20669 },
20670 },
20671 &quot;corsPolicy&quot;: { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
20672 # information about the W3C recommendation for cross-origin resource sharing
20673 # (CORS), see Fetch API Living
20674 # Standard.
20675 #
20676 # Not supported when the URL map is bound to a target gRPC proxy.
20677 # information about the W3C recommendation for cross-origin resource sharing
20678 # (CORS), see Fetch API Living
20679 # Standard.
20680 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
20681 # indicates that
20682 # the actual request can include user credentials. This field translates to
20683 # the Access-Control-Allow-Credentials header.
20684 #
20685 # Default is false.
20686 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
20687 # header.
20688 &quot;A String&quot;,
20689 ],
20690 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
20691 # header.
20692 &quot;A String&quot;,
20693 ],
20694 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
20695 # more information, see regular expression syntax.
20696 #
20697 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
20698 #
20699 # Regular expressions can only be used when the loadBalancingScheme is
20700 # set to INTERNAL_SELF_MANAGED.
20701 &quot;A String&quot;,
20702 ],
20703 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
20704 #
20705 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
20706 &quot;A String&quot;,
20707 ],
20708 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
20709 # The default value is false, which indicates that the CORS
20710 # policy is in effect.
20711 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
20712 # header.
20713 &quot;A String&quot;,
20714 ],
20715 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
20716 # seconds. This field translates to the Access-Control-Max-Age
20717 # header.
20718 },
20719 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
20720 # the resiliency of clients to backend service failure. As part of fault
20721 # injection, when clients send requests to a backend service, delays can be
20722 # introduced by a load balancer on a percentage of requests before sending
20723 # those requests to the backend service. Similarly requests from clients can
20724 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
20725 # that are configured with a fault_injection_policy if:
20726 # 1. The traffic is generated by fault injection AND
20727 # 2. The fault injection is not a delay fault injection.
20728 # Fault injection is not supported with the classic Application Load Balancer
20729 # . To see which load balancers support fault injection,
20730 # see Load
20731 # balancing: Routing and traffic management features.
20732 # the resiliency of clients to backend service failure. As part of fault
20733 # injection, when clients send requests to a backend service, delays can be
20734 # introduced by the load balancer on a percentage of requests before sending
20735 # those request to the backend service. Similarly requests from clients can be
20736 # aborted by the load balancer for a percentage of requests.
20737 &quot;abort&quot;: { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
20738 # injection.
20739 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
20740 #
20741 # The value must be from 200 to 599 inclusive.
20742 #
20743 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
20744 # according to this
20745 # mapping table. HTTP status 200 is mapped to gRPC status
20746 # UNKNOWN. Injecting an OK status is currently not supported by
20747 # Traffic Director.
20748 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
20749 # that is aborted as part of fault injection.
20750 #
20751 # The value must be from 0.0 to 100.0 inclusive.
20752 },
20753 &quot;delay&quot;: { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
20754 # injection, before being sent to a backend service.
20755 # request to the backend service as part of fault injection.
20756 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
20757 # as a count of seconds and fractions of seconds at nanosecond
20758 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
20759 # or &quot;month&quot;. Range is approximately 10,000 years.
20760 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
20761 # Durations less than one second are represented with a 0
20762 # `seconds` field and a positive `nanos` field. Must be from 0
20763 # to 999,999,999 inclusive.
20764 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
20765 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
20766 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
20767 },
20768 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
20769 # which a delay is introduced as part of fault injection.
20770 #
20771 # The value must be from 0.0 to 100.0 inclusive.
20772 },
20773 },
20774 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
20775 # Unlike the timeout field where the timeout duration starts
20776 # from the time the request has been fully processed (known as*end-of-stream*),
20777 # the duration in this field is computed from the beginning of the stream
20778 # until the response has been processed, including all retries. A
20779 # stream that does not complete in this duration is closed.
20780 #
20781 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
20782 # with the route.
20783 #
20784 # This field is only allowed if the Url map is used with backend services
20785 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
20786 # as a count of seconds and fractions of seconds at nanosecond
20787 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
20788 # or &quot;month&quot;. Range is approximately 10,000 years.
20789 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
20790 # Durations less than one second are represented with a 0
20791 # `seconds` field and a positive `nanos` field. Must be from 0
20792 # to 999,999,999 inclusive.
20793 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
20794 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
20795 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
20796 },
20797 &quot;requestMirrorPolicy&quot;: { # A policy that specifies how requests intended for the route&#x27;s backends # Specifies the policy on how requests intended for the route&#x27;s backends
20798 # are shadowed to a separate mirrored backend service. The load balancer does
20799 # not wait for responses from the shadow service. Before sending traffic
20800 # to the shadow service, the host / authority header is suffixed with-shadow.
20801 #
20802 # Not supported when the URL map is bound to a target gRPC proxy that
20803 # has the validateForProxyless field set to true.
20804 # are shadowed to a separate mirrored backend service. The load balancer
20805 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
20806 # to the shadow service, the host or authority header is suffixed with-shadow.
20807 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
20808 # mirrored to.
20809 #
20810 # The backend service configured for a mirroring
20811 # policy must reference backends that are of the same type as the original
20812 # backend service matched in the URL map.
20813 #
20814 # Serverless NEG backends are not currently supported as a mirrored
20815 # backend service.
20816 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
20817 },
20818 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
20819 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
20820 # If not specified, defaults to 1.
20821 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
20822 #
20823 # If not specified, will use the timeout set in theHttpRouteAction field.
20824 # If timeout in the HttpRouteAction field is not set, this field
20825 # uses the largest timeout
20826 # among all backend services associated with the route.
20827 #
20828 # Not supported when the URL map is bound to a target gRPC proxy that
20829 # has the validateForProxyless field set to true.
20830 # as a count of seconds and fractions of seconds at nanosecond
20831 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
20832 # or &quot;month&quot;. Range is approximately 10,000 years.
20833 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
20834 # Durations less than one second are represented with a 0
20835 # `seconds` field and a positive `nanos` field. Must be from 0
20836 # to 999,999,999 inclusive.
20837 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
20838 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
20839 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
20840 },
20841 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
20842 # values are:
20843 #
20844 # - 5xx: retry is attempted if the instance or endpoint
20845 # responds with any 5xx response code, or if the instance or
20846 # endpoint does not respond at all. For example, disconnects, reset, read
20847 # timeout, connection failure, and refused streams.
20848 # - gateway-error: Similar to 5xx, but only
20849 # applies to response codes 502, 503 or504.
20850 # - connect-failure: a retry is attempted on failures
20851 # connecting to the instance or endpoint. For example, connection
20852 # timeouts.
20853 # - retriable-4xx: a retry is attempted if the instance
20854 # or endpoint responds with a 4xx response code.
20855 # The only error that you can retry is error code 409.
20856 # - refused-stream: a retry is attempted if the instance
20857 # or endpoint resets the stream with a REFUSED_STREAM error
20858 # code. This reset type indicates that it is safe to retry.
20859 # - cancelled: a retry is attempted if the gRPC status
20860 # code in the response header is set to cancelled.
20861 # - deadline-exceeded: a retry is attempted if the gRPC
20862 # status code in the response header is set todeadline-exceeded.
20863 # - internal: a retry is attempted if the gRPC
20864 # status code in the response header is set tointernal.
20865 # - resource-exhausted: a retry is attempted if the gRPC
20866 # status code in the response header is set toresource-exhausted.
20867 # - unavailable: a retry is attempted if the gRPC
20868 # status code in the response header is set tounavailable.
20869 #
20870 # Only the following codes are supported when the URL map is bound to
20871 # target gRPC proxy that has validateForProxyless field set to true.
20872 #
20873 # - cancelled
20874 # - deadline-exceeded
20875 # - internal
20876 # - resource-exhausted
20877 # - unavailable
20878 &quot;A String&quot;,
20879 ],
20880 },
20881 &quot;timeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
20882 # time the request has been fully processed (known as *end-of-stream*)
20883 # up until the response has been processed. Timeout includes
20884 # all retries.
20885 #
20886 # If not specified, this field uses the largest timeout among all backend
20887 # services associated with the route.
20888 #
20889 # Not supported when the URL map is bound to a target gRPC proxy that
20890 # has validateForProxyless field set to true.
20891 # as a count of seconds and fractions of seconds at nanosecond
20892 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
20893 # or &quot;month&quot;. Range is approximately 10,000 years.
20894 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
20895 # Durations less than one second are represented with a 0
20896 # `seconds` field and a positive `nanos` field. Must be from 0
20897 # to 999,999,999 inclusive.
20898 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
20899 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
20900 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
20901 },
20902 &quot;urlRewrite&quot;: { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
20903 # to the matched service.
20904 #
20905 # urlRewrite is the only action supported in UrlMaps
20906 # for classic Application Load Balancers.
20907 #
20908 # Not supported when the URL map is bound to a target gRPC proxy that
20909 # has the validateForProxyless field set to true.
20910 # backend service.
20911 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
20912 # host header is replaced with contents of hostRewrite.
20913 #
20914 # The value must be from 1 to 255 characters.
20915 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
20916 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
20917 #
20918 # The value must be from 1 to 1024 characters.
20919 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
20920 # header) using the HTTP template syntax.
20921 #
20922 # A corresponding
20923 # path_template_match must be specified. Any template variables must exist in
20924 # the path_template_match field.
20925 #
20926 #
20927 # - -At least one variable must be specified in the path_template_match
20928 # field
20929 # - You can omit variables from the rewritten URL
20930 # - The * and ** operators cannot be matched
20931 # unless they have a corresponding variable name - e.g.
20932 # {format=*} or {var=**}.
20933 #
20934 # For example, a path_template_match of /static/{format=**}
20935 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
20936 # rewrite, so that /{country}/{format}/{suffix=**} can be
20937 # rewritten as /content/{format}/{country}/{suffix}.
20938 #
20939 # At least
20940 # one non-empty routeRules[].matchRules[].path_template_match is
20941 # required.
20942 #
20943 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
20944 },
20945 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
20946 # occurs. The weights determine the fraction of traffic that flows to
20947 # their corresponding backend service. If all traffic needs to
20948 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
20949 #
20950 # After a backend service is identified and before forwarding
20951 # the request to
20952 # the backend service, advanced routing actions such as URL rewrites and
20953 # header transformations are applied depending on additional settings
20954 # specified in this HttpRouteAction.
20955 { # In contrast to a single BackendService in
20956 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
20957 # multiple backend services. The volume of traffic for each
20958 # backend service is proportional to the weight specified
20959 # in each WeightedBackendService
20960 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
20961 # resource. Before
20962 # forwarding the request to backendService, the load balancer
20963 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
20964 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
20965 # effect for the selected backendService.
20966 #
20967 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
20968 #
20969 # headerAction is not supported for load balancers that have
20970 # their loadBalancingScheme set to EXTERNAL.
20971 #
20972 # Not supported when the URL map is bound to a target gRPC proxy that
20973 # has validateForProxyless field set to true.
20974 # the request is passed along to the selected backendService.
20975 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
20976 { # Specification determining how headers are added to requests or responses.
20977 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
20978 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
20979 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
20980 # that already
20981 # exist for the header. If true, headerValue is set for the
20982 # header, discarding any values that were set for that header.
20983 #
20984 # The default value is true,
20985 # unless a variable is present in headerValue,
20986 # in which case the default value is false.
20987 # .
20988 },
20989 ],
20990 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
20991 # request before forwarding the request to the backendService.
20992 &quot;A String&quot;,
20993 ],
20994 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
20995 # client.
20996 { # Specification determining how headers are added to requests or responses.
20997 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
20998 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
20999 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
21000 # that already
21001 # exist for the header. If true, headerValue is set for the
21002 # header, discarding any values that were set for that header.
21003 #
21004 # The default value is true,
21005 # unless a variable is present in headerValue,
21006 # in which case the default value is false.
21007 # .
21008 },
21009 ],
21010 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
21011 # response before sending the response back to the client.
21012 &quot;A String&quot;,
21013 ],
21014 },
21015 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
21016 # computed asweight / (sum of all weightedBackendService weights in routeAction).
21017 #
21018 # The selection of a backend service is determined only for new traffic.
21019 # Once a user&#x27;s request has been directed to a backend service,
21020 # subsequent requests are sent to the same backend service as
21021 # determined by the backend service&#x27;s session affinity policy.
21022 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
21023 # splitting. If you do, the weighted traffic splitting configuration takes
21024 # precedence.
21025 #
21026 # The value must be from 0 to 1000.
21027 },
21028 ],
21029 },
21030 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource. This
21031 # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
21032 # matched. For example, the
21033 # following are all valid URLs to a BackendService resource:
21034 #
21035 #
21036 # - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
21037 # - compute/v1/projects/project/global/backendServices/backendService
21038 # - global/backendServices/backendService
21039 #
21040 #
21041 # If defaultRouteAction is also specified, advanced
21042 # routing actions, such as URL rewrites, take effect before sending the
21043 # request to the backend.
21044 #
21045 #
21046 # Only one of defaultUrlRedirect, defaultService
21047 # or defaultRouteAction.weightedBackendService can be set.
21048 #
21049 #
21050 # Authorization requires one or more of the following Google IAM permissions on the
21051 # specified resource default_service:
21052 #
21053 #
21054 # - compute.backendBuckets.use
21055 # - compute.backendServices.use
21056 &quot;defaultUrlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When none of the specified pathRules orrouteRules match, the request is redirected to a URL specified
21057 # by defaultUrlRedirect.
21058 #
21059 #
21060 # Only one of defaultUrlRedirect, defaultService
21061 # or defaultRouteAction.weightedBackendService can be set.
21062 #
21063 #
21064 # Not supported when the URL map is bound to a target gRPC proxy.
21065 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
21066 # was supplied in the request.
21067 #
21068 # The value must be from 1 to 255
21069 # characters.
21070 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
21071 # set to HTTPS.
21072 # If set to false, the URL scheme of the redirected request
21073 # remains the same as that of the request.
21074 #
21075 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
21076 #
21077 # The default is set to false.
21078 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
21079 # that was supplied in the request.
21080 #
21081 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
21082 # supplied, the path of the original request is used for the redirect.
21083 #
21084 # The value must be from 1 to 1024 characters.
21085 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
21086 # the HttpRouteRuleMatch, retaining the remaining portion
21087 # of the URL before redirecting the request.
21088 #
21089 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
21090 # supplied, the path of the original request is used for the redirect.
21091 #
21092 # The value must be from 1 to 1024 characters.
21093 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
21094 #
21095 # Supported values are:
21096 #
21097 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
21098 # to 301.
21099 # - FOUND, which corresponds to 302.
21100 # - SEE_OTHER which corresponds to 303.
21101 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
21102 # method is retained.
21103 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
21104 # method is retained.
21105 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
21106 # URL is
21107 # removed before redirecting the request. If set to false, the
21108 # query portion of the original URL is retained.
21109 #
21110 # The default is set to false.
21111 },
21112 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
21113 # create the resource.
21114 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
21115 # for the selected backend service.
21116 #
21117 # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
21118 #
21119 # HeaderAction is not supported for load balancers
21120 # that have
21121 # their loadBalancingScheme set to EXTERNAL.
21122 #
21123 # Not supported when the URL map is bound to a target gRPC proxy that
21124 # has validateForProxyless field set to true.
21125 # the request is passed along to the selected backendService.
21126 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
21127 { # Specification determining how headers are added to requests or responses.
21128 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
21129 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
21130 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
21131 # that already
21132 # exist for the header. If true, headerValue is set for the
21133 # header, discarding any values that were set for that header.
21134 #
21135 # The default value is true,
21136 # unless a variable is present in headerValue,
21137 # in which case the default value is false.
21138 # .
21139 },
21140 ],
21141 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
21142 # request before forwarding the request to the backendService.
21143 &quot;A String&quot;,
21144 ],
21145 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
21146 # client.
21147 { # Specification determining how headers are added to requests or responses.
21148 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
21149 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
21150 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
21151 # that already
21152 # exist for the header. If true, headerValue is set for the
21153 # header, discarding any values that were set for that header.
21154 #
21155 # The default value is true,
21156 # unless a variable is present in headerValue,
21157 # in which case the default value is false.
21158 # .
21159 },
21160 ],
21161 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
21162 # response before sending the response back to the client.
21163 &quot;A String&quot;,
21164 ],
21165 },
21166 &quot;name&quot;: &quot;A String&quot;, # The name to which this PathMatcher is referred by theHostRule.
21167 &quot;pathRules&quot;: [ # The list of path rules. Use this list instead of routeRules
21168 # when routing based on simple path matching is all that&#x27;s required. A path
21169 # rule can only include a wildcard character (*) after a
21170 # forward slash character (&quot;/&quot;).
21171 #
21172 # The order by which path rules are specified does not matter.
21173 # Matches are always done on the longest-path-first basis.
21174 #
21175 # For example: a pathRule with a path /a/b/c/* will match
21176 # before /a/b/* irrespective of the order in which those paths appear in this
21177 # list.
21178 #
21179 # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
21180 { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
21181 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
21182 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
21183 #
21184 # If a policy for an
21185 # error code is not configured for the PathRule, a policy for
21186 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
21187 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
21188 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
21189 # effect.
21190 #
21191 # For example, consider a UrlMap with the following configuration:
21192 #
21193 #
21194 # - UrlMap.defaultCustomErrorResponsePolicy are configured
21195 # with policies for 5xx and 4xx errors
21196 # - A PathRule for /coming_soon/ is configured for the error
21197 # code 404.
21198 #
21199 # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher&#x27;s policy
21200 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
21201 # the policy in PathRule.customErrorResponsePolicy takes
21202 # effect. If any of the requests in this example encounter a 500
21203 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
21204 #
21205 # customErrorResponsePolicy is supported only for
21206 # global external Application Load Balancers.
21207 # backend service or backend bucket responds with an error.
21208 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
21209 #
21210 # In a given policy, if you specify rules for both a range of error codes
21211 # as well as rules for specific error codes then rules with specific error
21212 # codes have a higher priority. For example, assume that you configure a rule
21213 # for 401 (Un-authorized) code, and another for all 4 series
21214 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
21215 # However if the backend service returns a 403, the rule for4xx takes effect.
21216 { # Specifies the mapping between the response code that will be returned along
21217 # with the custom error content and the response code returned by the backend
21218 # service.
21219 &quot;matchResponseCodes&quot;: [ # Valid values include:
21220 #
21221 #
21222 # - A number between 400 and 599: For example
21223 # 401 or 503, in which case the load balancer
21224 # applies the policy if the error code exactly matches this value.
21225 # - 5xx: Load Balancer will apply the policy if the
21226 # backend service responds with any response code in the range of
21227 # 500 to 599.
21228 # - 4xx: Load
21229 # Balancer will apply the policy if the backend service responds with any
21230 # response code in the range of 400 to
21231 # 499.
21232 #
21233 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
21234 &quot;A String&quot;,
21235 ],
21236 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
21237 # error content. If overrideResponseCode is not supplied, the
21238 # same response code returned by the original backend bucket or backend
21239 # service is returned to the client.
21240 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
21241 #
21242 # path must start
21243 # with a leading slash. path cannot have trailing slashes.
21244 #
21245 # If the file is not available in backendBucket or the
21246 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
21247 #
21248 # The value must
21249 # be from 1 to 1024 characters
21250 },
21251 ],
21252 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
21253 # contains the custom error content. Examples are:
21254 #
21255 #
21256 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
21257 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
21258 # - global/backendBuckets/myBackendBucket
21259 #
21260 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
21261 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
21262 #
21263 # If load balancer cannot reach
21264 # the backendBucket, a simple Not Found Error will
21265 # be returned, with the original response code (oroverrideResponseCode if configured).
21266 #
21267 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
21268 },
21269 &quot;paths&quot;: [ # The list of path patterns to match. Each must start with /
21270 # and the only place a * is allowed is at the end following
21271 # a /. The string fed to the path matcher does not include
21272 # any text after the first ? or #, and
21273 # those chars are not allowed here.
21274 &quot;A String&quot;,
21275 ],
21276 &quot;routeAction&quot;: { # In response to a matching path, the load balancer
21277 # performs advanced routing actions, such as URL rewrites and header
21278 # transformations, before forwarding the request to the selected
21279 # backend.
21280 #
21281 #
21282 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
21283 #
21284 #
21285 # URL maps for classic Application Load Balancers only support
21286 # the urlRewrite action within a path rule&#x27;srouteAction.
21287 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
21288 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
21289 # property must be specified. This policy cannot be specified if any target
21290 # backend has Identity-Aware Proxy enabled.
21291 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
21292 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
21293 # header names can be specified. The cache is bypassed for all `cacheMode`
21294 # values.
21295 &quot;A String&quot;,
21296 ],
21297 &quot;cacheKeyPolicy&quot;: { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
21298 # on the backend type: for Backend Services, the complete request URI is
21299 # used; for Backend Buckets, the request URI is used without the protocol or
21300 # host, and only query parameters known to Cloud Storage are included.
21301 # Policy defined on Route Action.
21302 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
21303 # parameters will be included. Either specify `excludedQueryParameters`
21304 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
21305 # encoded and not treated as delimiters.
21306 #
21307 # Note: This field applies to routes that use backend services. Attempting
21308 # to set it on a route that points exclusively to Backend Buckets will
21309 # result in a configuration error. For routes that point to a Backend
21310 # Bucket, use `includedQueryParameters` to define which parameters should
21311 # be part of the cache key.
21312 &quot;A String&quot;,
21313 ],
21314 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
21315 #
21316 # Note: This setting is only applicable to routes that use a Backend
21317 # Service. It does not affect requests served by a Backend Bucket, as the
21318 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
21319 # it on a route that points exclusively to Backend Buckets will result in a
21320 # configuration error.
21321 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
21322 #
21323 # Note: This setting is only applicable to routes that use a Backend
21324 # Service. It does not affect requests served by a Backend Bucket, as the
21325 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
21326 # set on a route that points exclusively to Backend Buckets will result in
21327 # a configuration error.
21328 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
21329 # `includedQueryParameters` and `excludedQueryParameters`. If neither
21330 # is set, the entire query string will be included. If false, the query
21331 # string will be excluded from the cache key entirely.
21332 #
21333 # Note: This field applies to routes that use backend services. Attempting
21334 # to set it on a route that points exclusively to Backend Buckets will
21335 # result in a configuration error. For routes that point to a Backend
21336 # Bucket, use `includedQueryParameters` to define which parameters should
21337 # be part of the cache key.
21338 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
21339 # The name=value pair will be used in the cache key Cloud CDN generates.
21340 #
21341 # Note: This setting is only applicable to routes that use a Backend
21342 # Service. It does not affect requests served by a Backend Bucket.
21343 # Attempting to set it on a route that points exclusively to Backend
21344 # Buckets will result in a configuration error. Up to 5 cookie names can be
21345 # specified.
21346 &quot;A String&quot;,
21347 ],
21348 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
21349 &quot;A String&quot;,
21350 ],
21351 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
21352 # parameters will be excluded. Either specify `includedQueryParameters`
21353 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
21354 # encoded and not treated as delimiters.
21355 &quot;A String&quot;,
21356 ],
21357 },
21358 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
21359 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
21360 &quot;clientTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
21361 # content. This is used to clamp the max-age (or Expires) value sent to the
21362 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
21363 # is used for the response max-age directive, along with a &quot;public&quot;
21364 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
21365 # clamps the max-age from the origin (if specified), or else sets the
21366 # response max-age directive to the lesser of the `clientTtl` and
21367 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
21368 # present. The maximum allowed value is 31,622,400s (1 year). If not
21369 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
21370 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
21371 # `USE_ORIGIN_HEADERS`.
21372 # as a count of seconds and fractions of seconds at nanosecond
21373 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21374 # or &quot;month&quot;. Range is approximately 10,000 years.
21375 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21376 # Durations less than one second are represented with a 0
21377 # `seconds` field and a positive `nanos` field. Must be from 0
21378 # to 999,999,999 inclusive.
21379 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21380 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21381 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21382 },
21383 &quot;defaultTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
21384 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
21385 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
21386 # greater than that of `maxTtl`. When the `cacheMode` is set to
21387 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
21388 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
21389 # accessed objects may be evicted from the cache before the defined TTL. If
21390 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
21391 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
21392 # `USE_ORIGIN_HEADERS`.
21393 # as a count of seconds and fractions of seconds at nanosecond
21394 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21395 # or &quot;month&quot;. Range is approximately 10,000 years.
21396 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21397 # Durations less than one second are represented with a 0
21398 # `seconds` field and a positive `nanos` field. Must be from 0
21399 # to 999,999,999 inclusive.
21400 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21401 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21402 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21403 },
21404 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
21405 # attempt to set a max-age or s-maxage higher than this, or an Expires header
21406 # more than `maxTtl` seconds in the future will be capped at the value of
21407 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
21408 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
21409 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
21410 # Infrequently accessed objects may be evicted from the cache before the
21411 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
21412 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
21413 # mode.
21414 # as a count of seconds and fractions of seconds at nanosecond
21415 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21416 # or &quot;month&quot;. Range is approximately 10,000 years.
21417 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21418 # Durations less than one second are represented with a 0
21419 # `seconds` field and a positive `nanos` field. Must be from 0
21420 # to 999,999,999 inclusive.
21421 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21422 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21423 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21424 },
21425 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
21426 # to apply fine-grained caching for common errors or redirects.
21427 # This can reduce the load on your origin and improve end-user
21428 # experience by reducing response latency.
21429 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
21430 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
21431 # the specified response code that lack any Cache-Control, Expires, or
21432 # Pragma: no-cache directives. When the `cacheMode` is set to
21433 # `FORCE_CACHE_ALL`, negative caching applies to all responses
21434 # with the specified response code, and overrides any caching headers. By
21435 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
21436 #
21437 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
21438 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
21439 # * 405 (Method Not Found), 501 (Not Implemented): 60s
21440 #
21441 # These defaults can be overridden in `negativeCachingPolicy`.
21442 # If not specified, Cloud CDN applies negative caching by default.
21443 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
21444 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
21445 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
21446 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
21447 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
21448 # all response codes that you wish to cache. Cloud CDN will not apply any
21449 # default negative caching when a policy exists.
21450 { # Specify CDN TTLs for response error codes.
21451 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
21452 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
21453 # specified as values, and you cannot specify a status code more than
21454 # once.
21455 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
21456 # corresponding status code.
21457 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
21458 # objects may be evicted from the cache before the defined TTL.
21459 # as a count of seconds and fractions of seconds at nanosecond
21460 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21461 # or &quot;month&quot;. Range is approximately 10,000 years.
21462 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21463 # Durations less than one second are represented with a 0
21464 # `seconds` field and a positive `nanos` field. Must be from 0
21465 # to 999,999,999 inclusive.
21466 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21467 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21468 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21469 },
21470 },
21471 ],
21472 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
21473 # requests into a small number of requests to the origin. If not specified,
21474 # Cloud CDN applies request coalescing by default.
21475 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
21476 # content with the origin, or when an error is encountered when refreshing
21477 # the cache.
21478 # This setting defines the default &quot;max-stale&quot; duration for any cached
21479 # responses that do not specify a max-stale directive. Stale responses that
21480 # exceed the TTL configured here will not be served. The default limit
21481 # (max-stale) is 86400s (1 day), which will allow stale content to be
21482 # served up to this limit beyond the max-age (or s-maxage) of a cached
21483 # response.
21484 # The maximum allowed value is 604800 (1 week).
21485 # Set this to zero (0) to disable serve-while-stale.
21486 # as a count of seconds and fractions of seconds at nanosecond
21487 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21488 # or &quot;month&quot;. Range is approximately 10,000 years.
21489 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21490 # Durations less than one second are represented with a 0
21491 # `seconds` field and a positive `nanos` field. Must be from 0
21492 # to 999,999,999 inclusive.
21493 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21494 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21495 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21496 },
21497 },
21498 &quot;corsPolicy&quot;: { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
21499 # information about the W3C recommendation for cross-origin resource sharing
21500 # (CORS), see Fetch API Living
21501 # Standard.
21502 #
21503 # Not supported when the URL map is bound to a target gRPC proxy.
21504 # information about the W3C recommendation for cross-origin resource sharing
21505 # (CORS), see Fetch API Living
21506 # Standard.
21507 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
21508 # indicates that
21509 # the actual request can include user credentials. This field translates to
21510 # the Access-Control-Allow-Credentials header.
21511 #
21512 # Default is false.
21513 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
21514 # header.
21515 &quot;A String&quot;,
21516 ],
21517 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
21518 # header.
21519 &quot;A String&quot;,
21520 ],
21521 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
21522 # more information, see regular expression syntax.
21523 #
21524 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
21525 #
21526 # Regular expressions can only be used when the loadBalancingScheme is
21527 # set to INTERNAL_SELF_MANAGED.
21528 &quot;A String&quot;,
21529 ],
21530 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
21531 #
21532 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
21533 &quot;A String&quot;,
21534 ],
21535 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
21536 # The default value is false, which indicates that the CORS
21537 # policy is in effect.
21538 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
21539 # header.
21540 &quot;A String&quot;,
21541 ],
21542 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
21543 # seconds. This field translates to the Access-Control-Max-Age
21544 # header.
21545 },
21546 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
21547 # the resiliency of clients to backend service failure. As part of fault
21548 # injection, when clients send requests to a backend service, delays can be
21549 # introduced by a load balancer on a percentage of requests before sending
21550 # those requests to the backend service. Similarly requests from clients can
21551 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
21552 # that are configured with a fault_injection_policy if:
21553 # 1. The traffic is generated by fault injection AND
21554 # 2. The fault injection is not a delay fault injection.
21555 # Fault injection is not supported with the classic Application Load Balancer
21556 # . To see which load balancers support fault injection,
21557 # see Load
21558 # balancing: Routing and traffic management features.
21559 # the resiliency of clients to backend service failure. As part of fault
21560 # injection, when clients send requests to a backend service, delays can be
21561 # introduced by the load balancer on a percentage of requests before sending
21562 # those request to the backend service. Similarly requests from clients can be
21563 # aborted by the load balancer for a percentage of requests.
21564 &quot;abort&quot;: { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
21565 # injection.
21566 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
21567 #
21568 # The value must be from 200 to 599 inclusive.
21569 #
21570 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
21571 # according to this
21572 # mapping table. HTTP status 200 is mapped to gRPC status
21573 # UNKNOWN. Injecting an OK status is currently not supported by
21574 # Traffic Director.
21575 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
21576 # that is aborted as part of fault injection.
21577 #
21578 # The value must be from 0.0 to 100.0 inclusive.
21579 },
21580 &quot;delay&quot;: { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
21581 # injection, before being sent to a backend service.
21582 # request to the backend service as part of fault injection.
21583 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
21584 # as a count of seconds and fractions of seconds at nanosecond
21585 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21586 # or &quot;month&quot;. Range is approximately 10,000 years.
21587 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21588 # Durations less than one second are represented with a 0
21589 # `seconds` field and a positive `nanos` field. Must be from 0
21590 # to 999,999,999 inclusive.
21591 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21592 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21593 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21594 },
21595 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
21596 # which a delay is introduced as part of fault injection.
21597 #
21598 # The value must be from 0.0 to 100.0 inclusive.
21599 },
21600 },
21601 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
21602 # Unlike the timeout field where the timeout duration starts
21603 # from the time the request has been fully processed (known as*end-of-stream*),
21604 # the duration in this field is computed from the beginning of the stream
21605 # until the response has been processed, including all retries. A
21606 # stream that does not complete in this duration is closed.
21607 #
21608 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
21609 # with the route.
21610 #
21611 # This field is only allowed if the Url map is used with backend services
21612 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
21613 # as a count of seconds and fractions of seconds at nanosecond
21614 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21615 # or &quot;month&quot;. Range is approximately 10,000 years.
21616 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21617 # Durations less than one second are represented with a 0
21618 # `seconds` field and a positive `nanos` field. Must be from 0
21619 # to 999,999,999 inclusive.
21620 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21621 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21622 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21623 },
21624 &quot;requestMirrorPolicy&quot;: { # A policy that specifies how requests intended for the route&#x27;s backends # Specifies the policy on how requests intended for the route&#x27;s backends
21625 # are shadowed to a separate mirrored backend service. The load balancer does
21626 # not wait for responses from the shadow service. Before sending traffic
21627 # to the shadow service, the host / authority header is suffixed with-shadow.
21628 #
21629 # Not supported when the URL map is bound to a target gRPC proxy that
21630 # has the validateForProxyless field set to true.
21631 # are shadowed to a separate mirrored backend service. The load balancer
21632 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
21633 # to the shadow service, the host or authority header is suffixed with-shadow.
21634 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
21635 # mirrored to.
21636 #
21637 # The backend service configured for a mirroring
21638 # policy must reference backends that are of the same type as the original
21639 # backend service matched in the URL map.
21640 #
21641 # Serverless NEG backends are not currently supported as a mirrored
21642 # backend service.
21643 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
21644 },
21645 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
21646 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
21647 # If not specified, defaults to 1.
21648 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
21649 #
21650 # If not specified, will use the timeout set in theHttpRouteAction field.
21651 # If timeout in the HttpRouteAction field is not set, this field
21652 # uses the largest timeout
21653 # among all backend services associated with the route.
21654 #
21655 # Not supported when the URL map is bound to a target gRPC proxy that
21656 # has the validateForProxyless field set to true.
21657 # as a count of seconds and fractions of seconds at nanosecond
21658 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21659 # or &quot;month&quot;. Range is approximately 10,000 years.
21660 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21661 # Durations less than one second are represented with a 0
21662 # `seconds` field and a positive `nanos` field. Must be from 0
21663 # to 999,999,999 inclusive.
21664 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21665 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21666 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21667 },
21668 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
21669 # values are:
21670 #
21671 # - 5xx: retry is attempted if the instance or endpoint
21672 # responds with any 5xx response code, or if the instance or
21673 # endpoint does not respond at all. For example, disconnects, reset, read
21674 # timeout, connection failure, and refused streams.
21675 # - gateway-error: Similar to 5xx, but only
21676 # applies to response codes 502, 503 or504.
21677 # - connect-failure: a retry is attempted on failures
21678 # connecting to the instance or endpoint. For example, connection
21679 # timeouts.
21680 # - retriable-4xx: a retry is attempted if the instance
21681 # or endpoint responds with a 4xx response code.
21682 # The only error that you can retry is error code 409.
21683 # - refused-stream: a retry is attempted if the instance
21684 # or endpoint resets the stream with a REFUSED_STREAM error
21685 # code. This reset type indicates that it is safe to retry.
21686 # - cancelled: a retry is attempted if the gRPC status
21687 # code in the response header is set to cancelled.
21688 # - deadline-exceeded: a retry is attempted if the gRPC
21689 # status code in the response header is set todeadline-exceeded.
21690 # - internal: a retry is attempted if the gRPC
21691 # status code in the response header is set tointernal.
21692 # - resource-exhausted: a retry is attempted if the gRPC
21693 # status code in the response header is set toresource-exhausted.
21694 # - unavailable: a retry is attempted if the gRPC
21695 # status code in the response header is set tounavailable.
21696 #
21697 # Only the following codes are supported when the URL map is bound to
21698 # target gRPC proxy that has validateForProxyless field set to true.
21699 #
21700 # - cancelled
21701 # - deadline-exceeded
21702 # - internal
21703 # - resource-exhausted
21704 # - unavailable
21705 &quot;A String&quot;,
21706 ],
21707 },
21708 &quot;timeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
21709 # time the request has been fully processed (known as *end-of-stream*)
21710 # up until the response has been processed. Timeout includes
21711 # all retries.
21712 #
21713 # If not specified, this field uses the largest timeout among all backend
21714 # services associated with the route.
21715 #
21716 # Not supported when the URL map is bound to a target gRPC proxy that
21717 # has validateForProxyless field set to true.
21718 # as a count of seconds and fractions of seconds at nanosecond
21719 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21720 # or &quot;month&quot;. Range is approximately 10,000 years.
21721 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21722 # Durations less than one second are represented with a 0
21723 # `seconds` field and a positive `nanos` field. Must be from 0
21724 # to 999,999,999 inclusive.
21725 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21726 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21727 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21728 },
21729 &quot;urlRewrite&quot;: { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
21730 # to the matched service.
21731 #
21732 # urlRewrite is the only action supported in UrlMaps
21733 # for classic Application Load Balancers.
21734 #
21735 # Not supported when the URL map is bound to a target gRPC proxy that
21736 # has the validateForProxyless field set to true.
21737 # backend service.
21738 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
21739 # host header is replaced with contents of hostRewrite.
21740 #
21741 # The value must be from 1 to 255 characters.
21742 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
21743 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
21744 #
21745 # The value must be from 1 to 1024 characters.
21746 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
21747 # header) using the HTTP template syntax.
21748 #
21749 # A corresponding
21750 # path_template_match must be specified. Any template variables must exist in
21751 # the path_template_match field.
21752 #
21753 #
21754 # - -At least one variable must be specified in the path_template_match
21755 # field
21756 # - You can omit variables from the rewritten URL
21757 # - The * and ** operators cannot be matched
21758 # unless they have a corresponding variable name - e.g.
21759 # {format=*} or {var=**}.
21760 #
21761 # For example, a path_template_match of /static/{format=**}
21762 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
21763 # rewrite, so that /{country}/{format}/{suffix=**} can be
21764 # rewritten as /content/{format}/{country}/{suffix}.
21765 #
21766 # At least
21767 # one non-empty routeRules[].matchRules[].path_template_match is
21768 # required.
21769 #
21770 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
21771 },
21772 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
21773 # occurs. The weights determine the fraction of traffic that flows to
21774 # their corresponding backend service. If all traffic needs to
21775 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
21776 #
21777 # After a backend service is identified and before forwarding
21778 # the request to
21779 # the backend service, advanced routing actions such as URL rewrites and
21780 # header transformations are applied depending on additional settings
21781 # specified in this HttpRouteAction.
21782 { # In contrast to a single BackendService in
21783 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
21784 # multiple backend services. The volume of traffic for each
21785 # backend service is proportional to the weight specified
21786 # in each WeightedBackendService
21787 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
21788 # resource. Before
21789 # forwarding the request to backendService, the load balancer
21790 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
21791 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
21792 # effect for the selected backendService.
21793 #
21794 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
21795 #
21796 # headerAction is not supported for load balancers that have
21797 # their loadBalancingScheme set to EXTERNAL.
21798 #
21799 # Not supported when the URL map is bound to a target gRPC proxy that
21800 # has validateForProxyless field set to true.
21801 # the request is passed along to the selected backendService.
21802 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
21803 { # Specification determining how headers are added to requests or responses.
21804 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
21805 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
21806 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
21807 # that already
21808 # exist for the header. If true, headerValue is set for the
21809 # header, discarding any values that were set for that header.
21810 #
21811 # The default value is true,
21812 # unless a variable is present in headerValue,
21813 # in which case the default value is false.
21814 # .
21815 },
21816 ],
21817 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
21818 # request before forwarding the request to the backendService.
21819 &quot;A String&quot;,
21820 ],
21821 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
21822 # client.
21823 { # Specification determining how headers are added to requests or responses.
21824 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
21825 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
21826 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
21827 # that already
21828 # exist for the header. If true, headerValue is set for the
21829 # header, discarding any values that were set for that header.
21830 #
21831 # The default value is true,
21832 # unless a variable is present in headerValue,
21833 # in which case the default value is false.
21834 # .
21835 },
21836 ],
21837 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
21838 # response before sending the response back to the client.
21839 &quot;A String&quot;,
21840 ],
21841 },
21842 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
21843 # computed asweight / (sum of all weightedBackendService weights in routeAction).
21844 #
21845 # The selection of a backend service is determined only for new traffic.
21846 # Once a user&#x27;s request has been directed to a backend service,
21847 # subsequent requests are sent to the same backend service as
21848 # determined by the backend service&#x27;s session affinity policy.
21849 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
21850 # splitting. If you do, the weighted traffic splitting configuration takes
21851 # precedence.
21852 #
21853 # The value must be from 0 to 1000.
21854 },
21855 ],
21856 },
21857 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
21858 # is directed if this rule is matched. If routeAction is
21859 # also specified, advanced routing actions, such as URL rewrites,
21860 # take effect before sending the request to the backend.
21861 #
21862 #
21863 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
21864 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
21865 # specified by urlRedirect.
21866 #
21867 #
21868 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
21869 #
21870 #
21871 # Not supported when the URL map is bound to a target gRPC proxy.
21872 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
21873 # was supplied in the request.
21874 #
21875 # The value must be from 1 to 255
21876 # characters.
21877 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
21878 # set to HTTPS.
21879 # If set to false, the URL scheme of the redirected request
21880 # remains the same as that of the request.
21881 #
21882 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
21883 #
21884 # The default is set to false.
21885 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
21886 # that was supplied in the request.
21887 #
21888 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
21889 # supplied, the path of the original request is used for the redirect.
21890 #
21891 # The value must be from 1 to 1024 characters.
21892 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
21893 # the HttpRouteRuleMatch, retaining the remaining portion
21894 # of the URL before redirecting the request.
21895 #
21896 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
21897 # supplied, the path of the original request is used for the redirect.
21898 #
21899 # The value must be from 1 to 1024 characters.
21900 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
21901 #
21902 # Supported values are:
21903 #
21904 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
21905 # to 301.
21906 # - FOUND, which corresponds to 302.
21907 # - SEE_OTHER which corresponds to 303.
21908 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
21909 # method is retained.
21910 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
21911 # method is retained.
21912 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
21913 # URL is
21914 # removed before redirecting the request. If set to false, the
21915 # query portion of the original URL is retained.
21916 #
21917 # The default is set to false.
21918 },
21919 },
21920 ],
21921 &quot;routeRules&quot;: [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
21922 # desired. routeRules are evaluated in order of priority, from
21923 # the lowest to highest number.
21924 #
21925 # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
21926 { # The HttpRouteRule setting specifies how to match an HTTP request
21927 # and the corresponding routing action that load balancing proxies perform.
21928 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
21929 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
21930 #
21931 # If a policy for an
21932 # error code is not configured for the RouteRule, a policy for
21933 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
21934 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
21935 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
21936 # effect.
21937 #
21938 # For example, consider a UrlMap with the following configuration:
21939 #
21940 #
21941 # - UrlMap.defaultCustomErrorResponsePolicy are configured
21942 # with policies for 5xx and 4xx errors
21943 # - A RouteRule for /coming_soon/ is configured for the
21944 # error code 404.
21945 #
21946 # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher&#x27;s policy
21947 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
21948 # the policy in RouteRule.customErrorResponsePolicy takes
21949 # effect. If any of the requests in this example encounter a 500
21950 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
21951 #
21952 # When
21953 # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
21954 # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
21955 # a retry, if load balancer is successful in reaching the
21956 # service, the customErrorResponsePolicy is ignored and
21957 # the response from the service is returned to the client.
21958 #
21959 # customErrorResponsePolicy is supported only for
21960 # global external Application Load Balancers.
21961 # backend service or backend bucket responds with an error.
21962 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
21963 #
21964 # In a given policy, if you specify rules for both a range of error codes
21965 # as well as rules for specific error codes then rules with specific error
21966 # codes have a higher priority. For example, assume that you configure a rule
21967 # for 401 (Un-authorized) code, and another for all 4 series
21968 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
21969 # However if the backend service returns a 403, the rule for4xx takes effect.
21970 { # Specifies the mapping between the response code that will be returned along
21971 # with the custom error content and the response code returned by the backend
21972 # service.
21973 &quot;matchResponseCodes&quot;: [ # Valid values include:
21974 #
21975 #
21976 # - A number between 400 and 599: For example
21977 # 401 or 503, in which case the load balancer
21978 # applies the policy if the error code exactly matches this value.
21979 # - 5xx: Load Balancer will apply the policy if the
21980 # backend service responds with any response code in the range of
21981 # 500 to 599.
21982 # - 4xx: Load
21983 # Balancer will apply the policy if the backend service responds with any
21984 # response code in the range of 400 to
21985 # 499.
21986 #
21987 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
21988 &quot;A String&quot;,
21989 ],
21990 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
21991 # error content. If overrideResponseCode is not supplied, the
21992 # same response code returned by the original backend bucket or backend
21993 # service is returned to the client.
21994 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
21995 #
21996 # path must start
21997 # with a leading slash. path cannot have trailing slashes.
21998 #
21999 # If the file is not available in backendBucket or the
22000 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
22001 #
22002 # The value must
22003 # be from 1 to 1024 characters
22004 },
22005 ],
22006 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
22007 # contains the custom error content. Examples are:
22008 #
22009 #
22010 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
22011 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
22012 # - global/backendBuckets/myBackendBucket
22013 #
22014 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
22015 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
22016 #
22017 # If load balancer cannot reach
22018 # the backendBucket, a simple Not Found Error will
22019 # be returned, with the original response code (oroverrideResponseCode if configured).
22020 #
22021 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
22022 },
22023 &quot;description&quot;: &quot;A String&quot;, # The short description conveying the intent of this routeRule.
22024 #
22025 #
22026 # The description can have a maximum length of 1024 characters.
22027 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
22028 # for the selected backendService.
22029 #
22030 # The headerAction value specified here is applied before the
22031 # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
22032 #
22033 # HeaderAction is not supported for load balancers
22034 # that have
22035 # their loadBalancingScheme set to EXTERNAL.
22036 #
22037 # Not supported when the URL map is bound to a target gRPC proxy that
22038 # has validateForProxyless field set to true.
22039 # the request is passed along to the selected backendService.
22040 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
22041 { # Specification determining how headers are added to requests or responses.
22042 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
22043 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
22044 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
22045 # that already
22046 # exist for the header. If true, headerValue is set for the
22047 # header, discarding any values that were set for that header.
22048 #
22049 # The default value is true,
22050 # unless a variable is present in headerValue,
22051 # in which case the default value is false.
22052 # .
22053 },
22054 ],
22055 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
22056 # request before forwarding the request to the backendService.
22057 &quot;A String&quot;,
22058 ],
22059 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
22060 # client.
22061 { # Specification determining how headers are added to requests or responses.
22062 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
22063 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
22064 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
22065 # that already
22066 # exist for the header. If true, headerValue is set for the
22067 # header, discarding any values that were set for that header.
22068 #
22069 # The default value is true,
22070 # unless a variable is present in headerValue,
22071 # in which case the default value is false.
22072 # .
22073 },
22074 ],
22075 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
22076 # response before sending the response back to the client.
22077 &quot;A String&quot;,
22078 ],
22079 },
22080 &quot;matchRules&quot;: [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
22081 # this routeRule when any of thematchRules are satisfied. However predicates within
22082 # a given matchRule have AND semantics. All predicates
22083 # within a matchRule must match for the request to
22084 # match the rule.
22085 { # HttpRouteRuleMatch specifies a set of criteria for matching
22086 # requests to an HttpRouteRule. All specified criteria must
22087 # be satisfied for a match to occur.
22088 &quot;fullPathMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
22089 # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
22090 # that may be part of the original URL.
22091 #
22092 # fullPathMatch must be from 1 to 1024 characters.
22093 #
22094 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
22095 # specified.
22096 &quot;headerMatches&quot;: [ # Specifies a list of header match criteria, all of which must match
22097 # corresponding headers in the request.
22098 { # matchRule criteria for request header matches.
22099 &quot;exactMatch&quot;: &quot;A String&quot;, # The value should exactly match contents of exactMatch.
22100 #
22101 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
22102 &quot;headerName&quot;: &quot;A String&quot;, # The name of the HTTP header to match.
22103 #
22104 # For matching against the HTTP request&#x27;s authority, use a headerMatch
22105 # with the header name &quot;:authority&quot;.
22106 #
22107 # For matching a request&#x27;s method, use the headerName &quot;:method&quot;.
22108 #
22109 # When the URL map is bound to a target gRPC proxy that has
22110 # the validateForProxyless field set to true, only
22111 # non-binary
22112 # user-specified custom metadata and the `content-type` header are supported.
22113 # The following transport-level headers cannot be used in header matching
22114 # rules:
22115 # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
22116 # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
22117 # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
22118 # `grpc-timeout` and `grpc-trace-bin`.
22119 &quot;invertMatch&quot;: True or False, # If set to false, the headerMatch is considered a
22120 # match if the preceding match criteria are met. If set to true,
22121 # the headerMatch is considered a match if the preceding
22122 # match criteria are NOT met.
22123 #
22124 # The default setting is false.
22125 &quot;prefixMatch&quot;: &quot;A String&quot;, # The value of the header must start with the contents ofprefixMatch.
22126 #
22127 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
22128 &quot;presentMatch&quot;: True or False, # A header with the contents of headerName must exist. The
22129 # match takes place whether or not the request&#x27;s header has a value.
22130 #
22131 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
22132 &quot;rangeMatch&quot;: { # HttpRouteRuleMatch criteria for field values that must stay # The header value must be an integer and its value must be in the range
22133 # specified in rangeMatch. If the header does not contain an
22134 # integer, number or is empty, the match fails.
22135 #
22136 # For example for a range [-5, 0]
22137 #
22138 #
22139 # - -3 will match.
22140 # - 0 will not match.
22141 # - 0.25 will not match.
22142 # - -3someString will not match.
22143 #
22144 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
22145 #
22146 # rangeMatch is not supported for load balancers
22147 # that have loadBalancingScheme set to EXTERNAL.
22148 # within the specified integer range.
22149 &quot;rangeEnd&quot;: &quot;A String&quot;, # The end of the range (exclusive) in signed long integer format.
22150 &quot;rangeStart&quot;: &quot;A String&quot;, # The start of the range (inclusive) in signed long integer format.
22151 },
22152 &quot;regexMatch&quot;: &quot;A String&quot;, # The value of the header must match the regular expression specified inregexMatch.
22153 # For more information about regular expression syntax, see Syntax.
22154 #
22155 # For matching against a port specified in the HTTP request, use a
22156 # headerMatch with headerName set to PORT and a regular expression that
22157 # satisfies the RFC2616 Host header&#x27;s port specifier.
22158 #
22159 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
22160 #
22161 # Regular expressions can only be used when the loadBalancingScheme is
22162 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
22163 # (regional scope) or INTERNAL_MANAGED.
22164 &quot;suffixMatch&quot;: &quot;A String&quot;, # The value of the header must end with the contents ofsuffixMatch.
22165 #
22166 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
22167 },
22168 ],
22169 &quot;ignoreCase&quot;: True or False, # Specifies that prefixMatch and fullPathMatch
22170 # matches are case sensitive.
22171 #
22172 # The default value is false.
22173 #
22174 # ignoreCase must not be used with regexMatch.
22175 #
22176 # Not supported when the URL map is bound to a target gRPC proxy.
22177 &quot;metadataFilters&quot;: [ # Opaque filter criteria used by the load balancer to restrict routing
22178 # configuration to a limited set of xDS
22179 # compliant clients. In their xDS requests to the load balancer, xDS clients
22180 # present node
22181 # metadata. When there is a match, the relevant routing configuration
22182 # is made available to those proxies.
22183 #
22184 # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least one of thefilterLabels must match the corresponding label provided in
22185 # the metadata. If its filterMatchCriteria is set to
22186 # MATCH_ALL, then all of its filterLabels must match with
22187 # corresponding labels provided in the metadata. If multiple
22188 # metadata filters are specified, all of them need to be
22189 # satisfied in order to be considered a match.
22190 #
22191 # metadataFilters specified here is applied after those
22192 # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
22193 #
22194 # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
22195 #
22196 # Not supported when the URL map is bound to a target gRPC proxy that
22197 # has validateForProxyless field set to true.
22198 { # Opaque filter criteria used by load balancers to restrict routing
22199 # configuration to a limited set of load balancing proxies. Proxies and
22200 # sidecars involved in load balancing would typically present metadata to the
22201 # load balancers that need to match criteria specified here. If a match takes
22202 # place, the relevant configuration is made available to those
22203 # proxies.
22204 #
22205 # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
22206 # one of thefilterLabels must match the corresponding label provided in
22207 # the metadata. If its filterMatchCriteria is set to
22208 # MATCH_ALL, then all of its filterLabels must match with
22209 # corresponding labels provided in the metadata.
22210 #
22211 # An example for using metadataFilters would be: if
22212 # load balancing involves
22213 # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in of their XDS requests to loadbalancers.
22214 &quot;filterLabels&quot;: [ # The list of label value pairs that must match labels in the provided
22215 # metadata based on filterMatchCriteria
22216 #
22217 # This list must not be empty and can have at the most 64 entries.
22218 { # MetadataFilter label name value pairs that are expected
22219 # to match corresponding labels presented as metadata to the load balancer.
22220 &quot;name&quot;: &quot;A String&quot;, # Name of metadata label.
22221 #
22222 # The name can have a maximum length of 1024 characters and must be at
22223 # least 1 character long.
22224 &quot;value&quot;: &quot;A String&quot;, # The value of the label must match the specified value.
22225 #
22226 # value can have a maximum length of 1024 characters.
22227 },
22228 ],
22229 &quot;filterMatchCriteria&quot;: &quot;A String&quot;, # Specifies how individual filter label matches
22230 # within the list of filterLabels and contributes toward the
22231 # overall metadataFilter match.
22232 #
22233 # Supported values are:
22234 #
22235 # - MATCH_ANY: at least one of the filterLabels
22236 # must have a matching label in the provided metadata.
22237 # - MATCH_ALL: all filterLabels must have
22238 # matching labels in the provided metadata.
22239 },
22240 ],
22241 &quot;pathTemplateMatch&quot;: &quot;A String&quot;, # If specified, this field defines a path template pattern that must match
22242 # the :path header after the query string is removed.
22243 #
22244 # A path template pattern can include variables and wildcards.
22245 # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
22246 # matches a single path segment, and ** that matches zero or
22247 # more path segments. The pattern must follow these rules:
22248 #
22249 #
22250 # - The value must be between 1 and 1024 characters.
22251 # - The pattern must start with a leading slash (&quot;/&quot;).
22252 # - No more than 5 operators (variables or wildcards) may appear in
22253 # the pattern.
22254 #
22255 # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
22256 # set.
22257 &quot;prefixMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the request&#x27;s
22258 # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
22259 #
22260 # The value must be from 1 to 1024 characters.
22261 #
22262 # The * character inside a prefix match is
22263 # treated as a literal character, not as a wildcard.
22264 #
22265 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
22266 # used within a matchRule.
22267 &quot;queryParameterMatches&quot;: [ # Specifies a list of query parameter match criteria, all of which must
22268 # match corresponding query parameters in the request.
22269 #
22270 # Not supported when the URL map is bound to a target gRPC proxy.
22271 { # HttpRouteRuleMatch criteria for a request&#x27;s query parameter.
22272 &quot;exactMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
22273 # parameter exactly matches the contents of exactMatch.
22274 #
22275 # Only one of presentMatch, exactMatch, orregexMatch must be set.
22276 &quot;name&quot;: &quot;A String&quot;, # The name of the query parameter to match. The query parameter must exist in
22277 # the request, in the absence of which the request match fails.
22278 &quot;presentMatch&quot;: True or False, # Specifies that the queryParameterMatch matches if the
22279 # request contains the query parameter, irrespective of whether the
22280 # parameter has a value or not.
22281 #
22282 # Only one of presentMatch, exactMatch, orregexMatch must be set.
22283 &quot;regexMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
22284 # parameter matches the regular expression specified byregexMatch. For
22285 # more information about regular expression syntax, see Syntax.
22286 #
22287 # Only one of presentMatch, exactMatch, orregexMatch must be set.
22288 #
22289 # Regular expressions can only be used when the loadBalancingScheme is
22290 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
22291 # (regional scope) or INTERNAL_MANAGED.
22292 },
22293 ],
22294 &quot;regexMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
22295 # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
22296 # supplied with the original URL. For
22297 # more information about regular expression syntax, see Syntax.
22298 #
22299 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
22300 # specified.
22301 #
22302 # Regular expressions can only be used when the loadBalancingScheme is
22303 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
22304 # (regional scope) or INTERNAL_MANAGED.
22305 },
22306 ],
22307 &quot;priority&quot;: 42, # For routeRules within a given pathMatcher,
22308 # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
22309 # of priority, from the lowest to highest number. The priority of a
22310 # rule decreases as its number increases (1, 2, 3, N+1). The first rule
22311 # that matches the request is applied.
22312 #
22313 #
22314 # You cannot configure two or more routeRules with the same priority.
22315 # Priority for each rule must be set to a number from 0 to 2147483647
22316 # inclusive.
22317 #
22318 #
22319 # Priority numbers can have gaps, which enable you to add or remove rules
22320 # in the future without affecting the rest of the rules. For example, 1, 2,
22321 # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
22322 # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
22323 # without any impact on existing rules.
22324 &quot;routeAction&quot;: { # In response to a matching matchRule, the load balancer
22325 # performs advanced routing actions, such as URL rewrites and header
22326 # transformations, before forwarding the request to the selected backend.
22327 #
22328 #
22329 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
22330 #
22331 #
22332 # URL maps for classic Application Load Balancers only support
22333 # the urlRewrite action within a route rule&#x27;srouteAction.
22334 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
22335 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
22336 # property must be specified. This policy cannot be specified if any target
22337 # backend has Identity-Aware Proxy enabled.
22338 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
22339 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
22340 # header names can be specified. The cache is bypassed for all `cacheMode`
22341 # values.
22342 &quot;A String&quot;,
22343 ],
22344 &quot;cacheKeyPolicy&quot;: { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
22345 # on the backend type: for Backend Services, the complete request URI is
22346 # used; for Backend Buckets, the request URI is used without the protocol or
22347 # host, and only query parameters known to Cloud Storage are included.
22348 # Policy defined on Route Action.
22349 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
22350 # parameters will be included. Either specify `excludedQueryParameters`
22351 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
22352 # encoded and not treated as delimiters.
22353 #
22354 # Note: This field applies to routes that use backend services. Attempting
22355 # to set it on a route that points exclusively to Backend Buckets will
22356 # result in a configuration error. For routes that point to a Backend
22357 # Bucket, use `includedQueryParameters` to define which parameters should
22358 # be part of the cache key.
22359 &quot;A String&quot;,
22360 ],
22361 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
22362 #
22363 # Note: This setting is only applicable to routes that use a Backend
22364 # Service. It does not affect requests served by a Backend Bucket, as the
22365 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
22366 # it on a route that points exclusively to Backend Buckets will result in a
22367 # configuration error.
22368 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
22369 #
22370 # Note: This setting is only applicable to routes that use a Backend
22371 # Service. It does not affect requests served by a Backend Bucket, as the
22372 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
22373 # set on a route that points exclusively to Backend Buckets will result in
22374 # a configuration error.
22375 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
22376 # `includedQueryParameters` and `excludedQueryParameters`. If neither
22377 # is set, the entire query string will be included. If false, the query
22378 # string will be excluded from the cache key entirely.
22379 #
22380 # Note: This field applies to routes that use backend services. Attempting
22381 # to set it on a route that points exclusively to Backend Buckets will
22382 # result in a configuration error. For routes that point to a Backend
22383 # Bucket, use `includedQueryParameters` to define which parameters should
22384 # be part of the cache key.
22385 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
22386 # The name=value pair will be used in the cache key Cloud CDN generates.
22387 #
22388 # Note: This setting is only applicable to routes that use a Backend
22389 # Service. It does not affect requests served by a Backend Bucket.
22390 # Attempting to set it on a route that points exclusively to Backend
22391 # Buckets will result in a configuration error. Up to 5 cookie names can be
22392 # specified.
22393 &quot;A String&quot;,
22394 ],
22395 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
22396 &quot;A String&quot;,
22397 ],
22398 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
22399 # parameters will be excluded. Either specify `includedQueryParameters`
22400 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
22401 # encoded and not treated as delimiters.
22402 &quot;A String&quot;,
22403 ],
22404 },
22405 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
22406 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
22407 &quot;clientTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
22408 # content. This is used to clamp the max-age (or Expires) value sent to the
22409 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
22410 # is used for the response max-age directive, along with a &quot;public&quot;
22411 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
22412 # clamps the max-age from the origin (if specified), or else sets the
22413 # response max-age directive to the lesser of the `clientTtl` and
22414 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
22415 # present. The maximum allowed value is 31,622,400s (1 year). If not
22416 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
22417 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
22418 # `USE_ORIGIN_HEADERS`.
22419 # as a count of seconds and fractions of seconds at nanosecond
22420 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
22421 # or &quot;month&quot;. Range is approximately 10,000 years.
22422 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
22423 # Durations less than one second are represented with a 0
22424 # `seconds` field and a positive `nanos` field. Must be from 0
22425 # to 999,999,999 inclusive.
22426 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22427 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22428 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22429 },
22430 &quot;defaultTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
22431 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
22432 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
22433 # greater than that of `maxTtl`. When the `cacheMode` is set to
22434 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
22435 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
22436 # accessed objects may be evicted from the cache before the defined TTL. If
22437 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
22438 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
22439 # `USE_ORIGIN_HEADERS`.
22440 # as a count of seconds and fractions of seconds at nanosecond
22441 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
22442 # or &quot;month&quot;. Range is approximately 10,000 years.
22443 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
22444 # Durations less than one second are represented with a 0
22445 # `seconds` field and a positive `nanos` field. Must be from 0
22446 # to 999,999,999 inclusive.
22447 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22448 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22449 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22450 },
22451 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
22452 # attempt to set a max-age or s-maxage higher than this, or an Expires header
22453 # more than `maxTtl` seconds in the future will be capped at the value of
22454 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
22455 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
22456 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
22457 # Infrequently accessed objects may be evicted from the cache before the
22458 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
22459 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
22460 # mode.
22461 # as a count of seconds and fractions of seconds at nanosecond
22462 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
22463 # or &quot;month&quot;. Range is approximately 10,000 years.
22464 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
22465 # Durations less than one second are represented with a 0
22466 # `seconds` field and a positive `nanos` field. Must be from 0
22467 # to 999,999,999 inclusive.
22468 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22469 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22470 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22471 },
22472 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
22473 # to apply fine-grained caching for common errors or redirects.
22474 # This can reduce the load on your origin and improve end-user
22475 # experience by reducing response latency.
22476 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
22477 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
22478 # the specified response code that lack any Cache-Control, Expires, or
22479 # Pragma: no-cache directives. When the `cacheMode` is set to
22480 # `FORCE_CACHE_ALL`, negative caching applies to all responses
22481 # with the specified response code, and overrides any caching headers. By
22482 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
22483 #
22484 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
22485 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
22486 # * 405 (Method Not Found), 501 (Not Implemented): 60s
22487 #
22488 # These defaults can be overridden in `negativeCachingPolicy`.
22489 # If not specified, Cloud CDN applies negative caching by default.
22490 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
22491 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
22492 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
22493 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
22494 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
22495 # all response codes that you wish to cache. Cloud CDN will not apply any
22496 # default negative caching when a policy exists.
22497 { # Specify CDN TTLs for response error codes.
22498 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
22499 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
22500 # specified as values, and you cannot specify a status code more than
22501 # once.
22502 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
22503 # corresponding status code.
22504 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
22505 # objects may be evicted from the cache before the defined TTL.
22506 # as a count of seconds and fractions of seconds at nanosecond
22507 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
22508 # or &quot;month&quot;. Range is approximately 10,000 years.
22509 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
22510 # Durations less than one second are represented with a 0
22511 # `seconds` field and a positive `nanos` field. Must be from 0
22512 # to 999,999,999 inclusive.
22513 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22514 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22515 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22516 },
22517 },
22518 ],
22519 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
22520 # requests into a small number of requests to the origin. If not specified,
22521 # Cloud CDN applies request coalescing by default.
22522 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
22523 # content with the origin, or when an error is encountered when refreshing
22524 # the cache.
22525 # This setting defines the default &quot;max-stale&quot; duration for any cached
22526 # responses that do not specify a max-stale directive. Stale responses that
22527 # exceed the TTL configured here will not be served. The default limit
22528 # (max-stale) is 86400s (1 day), which will allow stale content to be
22529 # served up to this limit beyond the max-age (or s-maxage) of a cached
22530 # response.
22531 # The maximum allowed value is 604800 (1 week).
22532 # Set this to zero (0) to disable serve-while-stale.
22533 # as a count of seconds and fractions of seconds at nanosecond
22534 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
22535 # or &quot;month&quot;. Range is approximately 10,000 years.
22536 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
22537 # Durations less than one second are represented with a 0
22538 # `seconds` field and a positive `nanos` field. Must be from 0
22539 # to 999,999,999 inclusive.
22540 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22541 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22542 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22543 },
22544 },
22545 &quot;corsPolicy&quot;: { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
22546 # information about the W3C recommendation for cross-origin resource sharing
22547 # (CORS), see Fetch API Living
22548 # Standard.
22549 #
22550 # Not supported when the URL map is bound to a target gRPC proxy.
22551 # information about the W3C recommendation for cross-origin resource sharing
22552 # (CORS), see Fetch API Living
22553 # Standard.
22554 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
22555 # indicates that
22556 # the actual request can include user credentials. This field translates to
22557 # the Access-Control-Allow-Credentials header.
22558 #
22559 # Default is false.
22560 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
22561 # header.
22562 &quot;A String&quot;,
22563 ],
22564 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
22565 # header.
22566 &quot;A String&quot;,
22567 ],
22568 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
22569 # more information, see regular expression syntax.
22570 #
22571 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
22572 #
22573 # Regular expressions can only be used when the loadBalancingScheme is
22574 # set to INTERNAL_SELF_MANAGED.
22575 &quot;A String&quot;,
22576 ],
22577 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
22578 #
22579 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
22580 &quot;A String&quot;,
22581 ],
22582 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
22583 # The default value is false, which indicates that the CORS
22584 # policy is in effect.
22585 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
22586 # header.
22587 &quot;A String&quot;,
22588 ],
22589 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
22590 # seconds. This field translates to the Access-Control-Max-Age
22591 # header.
22592 },
22593 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
22594 # the resiliency of clients to backend service failure. As part of fault
22595 # injection, when clients send requests to a backend service, delays can be
22596 # introduced by a load balancer on a percentage of requests before sending
22597 # those requests to the backend service. Similarly requests from clients can
22598 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
22599 # that are configured with a fault_injection_policy if:
22600 # 1. The traffic is generated by fault injection AND
22601 # 2. The fault injection is not a delay fault injection.
22602 # Fault injection is not supported with the classic Application Load Balancer
22603 # . To see which load balancers support fault injection,
22604 # see Load
22605 # balancing: Routing and traffic management features.
22606 # the resiliency of clients to backend service failure. As part of fault
22607 # injection, when clients send requests to a backend service, delays can be
22608 # introduced by the load balancer on a percentage of requests before sending
22609 # those request to the backend service. Similarly requests from clients can be
22610 # aborted by the load balancer for a percentage of requests.
22611 &quot;abort&quot;: { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
22612 # injection.
22613 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
22614 #
22615 # The value must be from 200 to 599 inclusive.
22616 #
22617 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
22618 # according to this
22619 # mapping table. HTTP status 200 is mapped to gRPC status
22620 # UNKNOWN. Injecting an OK status is currently not supported by
22621 # Traffic Director.
22622 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
22623 # that is aborted as part of fault injection.
22624 #
22625 # The value must be from 0.0 to 100.0 inclusive.
22626 },
22627 &quot;delay&quot;: { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
22628 # injection, before being sent to a backend service.
22629 # request to the backend service as part of fault injection.
22630 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
22631 # as a count of seconds and fractions of seconds at nanosecond
22632 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
22633 # or &quot;month&quot;. Range is approximately 10,000 years.
22634 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
22635 # Durations less than one second are represented with a 0
22636 # `seconds` field and a positive `nanos` field. Must be from 0
22637 # to 999,999,999 inclusive.
22638 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22639 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22640 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22641 },
22642 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
22643 # which a delay is introduced as part of fault injection.
22644 #
22645 # The value must be from 0.0 to 100.0 inclusive.
22646 },
22647 },
22648 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
22649 # Unlike the timeout field where the timeout duration starts
22650 # from the time the request has been fully processed (known as*end-of-stream*),
22651 # the duration in this field is computed from the beginning of the stream
22652 # until the response has been processed, including all retries. A
22653 # stream that does not complete in this duration is closed.
22654 #
22655 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
22656 # with the route.
22657 #
22658 # This field is only allowed if the Url map is used with backend services
22659 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
22660 # as a count of seconds and fractions of seconds at nanosecond
22661 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
22662 # or &quot;month&quot;. Range is approximately 10,000 years.
22663 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
22664 # Durations less than one second are represented with a 0
22665 # `seconds` field and a positive `nanos` field. Must be from 0
22666 # to 999,999,999 inclusive.
22667 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22668 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22669 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22670 },
22671 &quot;requestMirrorPolicy&quot;: { # A policy that specifies how requests intended for the route&#x27;s backends # Specifies the policy on how requests intended for the route&#x27;s backends
22672 # are shadowed to a separate mirrored backend service. The load balancer does
22673 # not wait for responses from the shadow service. Before sending traffic
22674 # to the shadow service, the host / authority header is suffixed with-shadow.
22675 #
22676 # Not supported when the URL map is bound to a target gRPC proxy that
22677 # has the validateForProxyless field set to true.
22678 # are shadowed to a separate mirrored backend service. The load balancer
22679 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
22680 # to the shadow service, the host or authority header is suffixed with-shadow.
22681 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
22682 # mirrored to.
22683 #
22684 # The backend service configured for a mirroring
22685 # policy must reference backends that are of the same type as the original
22686 # backend service matched in the URL map.
22687 #
22688 # Serverless NEG backends are not currently supported as a mirrored
22689 # backend service.
22690 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
22691 },
22692 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
22693 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
22694 # If not specified, defaults to 1.
22695 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
22696 #
22697 # If not specified, will use the timeout set in theHttpRouteAction field.
22698 # If timeout in the HttpRouteAction field is not set, this field
22699 # uses the largest timeout
22700 # among all backend services associated with the route.
22701 #
22702 # Not supported when the URL map is bound to a target gRPC proxy that
22703 # has the validateForProxyless field set to true.
22704 # as a count of seconds and fractions of seconds at nanosecond
22705 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
22706 # or &quot;month&quot;. Range is approximately 10,000 years.
22707 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
22708 # Durations less than one second are represented with a 0
22709 # `seconds` field and a positive `nanos` field. Must be from 0
22710 # to 999,999,999 inclusive.
22711 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22712 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22713 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22714 },
22715 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
22716 # values are:
22717 #
22718 # - 5xx: retry is attempted if the instance or endpoint
22719 # responds with any 5xx response code, or if the instance or
22720 # endpoint does not respond at all. For example, disconnects, reset, read
22721 # timeout, connection failure, and refused streams.
22722 # - gateway-error: Similar to 5xx, but only
22723 # applies to response codes 502, 503 or504.
22724 # - connect-failure: a retry is attempted on failures
22725 # connecting to the instance or endpoint. For example, connection
22726 # timeouts.
22727 # - retriable-4xx: a retry is attempted if the instance
22728 # or endpoint responds with a 4xx response code.
22729 # The only error that you can retry is error code 409.
22730 # - refused-stream: a retry is attempted if the instance
22731 # or endpoint resets the stream with a REFUSED_STREAM error
22732 # code. This reset type indicates that it is safe to retry.
22733 # - cancelled: a retry is attempted if the gRPC status
22734 # code in the response header is set to cancelled.
22735 # - deadline-exceeded: a retry is attempted if the gRPC
22736 # status code in the response header is set todeadline-exceeded.
22737 # - internal: a retry is attempted if the gRPC
22738 # status code in the response header is set tointernal.
22739 # - resource-exhausted: a retry is attempted if the gRPC
22740 # status code in the response header is set toresource-exhausted.
22741 # - unavailable: a retry is attempted if the gRPC
22742 # status code in the response header is set tounavailable.
22743 #
22744 # Only the following codes are supported when the URL map is bound to
22745 # target gRPC proxy that has validateForProxyless field set to true.
22746 #
22747 # - cancelled
22748 # - deadline-exceeded
22749 # - internal
22750 # - resource-exhausted
22751 # - unavailable
22752 &quot;A String&quot;,
22753 ],
22754 },
22755 &quot;timeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
22756 # time the request has been fully processed (known as *end-of-stream*)
22757 # up until the response has been processed. Timeout includes
22758 # all retries.
22759 #
22760 # If not specified, this field uses the largest timeout among all backend
22761 # services associated with the route.
22762 #
22763 # Not supported when the URL map is bound to a target gRPC proxy that
22764 # has validateForProxyless field set to true.
22765 # as a count of seconds and fractions of seconds at nanosecond
22766 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
22767 # or &quot;month&quot;. Range is approximately 10,000 years.
22768 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
22769 # Durations less than one second are represented with a 0
22770 # `seconds` field and a positive `nanos` field. Must be from 0
22771 # to 999,999,999 inclusive.
22772 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22773 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22774 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22775 },
22776 &quot;urlRewrite&quot;: { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
22777 # to the matched service.
22778 #
22779 # urlRewrite is the only action supported in UrlMaps
22780 # for classic Application Load Balancers.
22781 #
22782 # Not supported when the URL map is bound to a target gRPC proxy that
22783 # has the validateForProxyless field set to true.
22784 # backend service.
22785 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
22786 # host header is replaced with contents of hostRewrite.
22787 #
22788 # The value must be from 1 to 255 characters.
22789 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
22790 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
22791 #
22792 # The value must be from 1 to 1024 characters.
22793 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
22794 # header) using the HTTP template syntax.
22795 #
22796 # A corresponding
22797 # path_template_match must be specified. Any template variables must exist in
22798 # the path_template_match field.
22799 #
22800 #
22801 # - -At least one variable must be specified in the path_template_match
22802 # field
22803 # - You can omit variables from the rewritten URL
22804 # - The * and ** operators cannot be matched
22805 # unless they have a corresponding variable name - e.g.
22806 # {format=*} or {var=**}.
22807 #
22808 # For example, a path_template_match of /static/{format=**}
22809 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
22810 # rewrite, so that /{country}/{format}/{suffix=**} can be
22811 # rewritten as /content/{format}/{country}/{suffix}.
22812 #
22813 # At least
22814 # one non-empty routeRules[].matchRules[].path_template_match is
22815 # required.
22816 #
22817 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
22818 },
22819 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
22820 # occurs. The weights determine the fraction of traffic that flows to
22821 # their corresponding backend service. If all traffic needs to
22822 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
22823 #
22824 # After a backend service is identified and before forwarding
22825 # the request to
22826 # the backend service, advanced routing actions such as URL rewrites and
22827 # header transformations are applied depending on additional settings
22828 # specified in this HttpRouteAction.
22829 { # In contrast to a single BackendService in
22830 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
22831 # multiple backend services. The volume of traffic for each
22832 # backend service is proportional to the weight specified
22833 # in each WeightedBackendService
22834 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
22835 # resource. Before
22836 # forwarding the request to backendService, the load balancer
22837 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
22838 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
22839 # effect for the selected backendService.
22840 #
22841 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
22842 #
22843 # headerAction is not supported for load balancers that have
22844 # their loadBalancingScheme set to EXTERNAL.
22845 #
22846 # Not supported when the URL map is bound to a target gRPC proxy that
22847 # has validateForProxyless field set to true.
22848 # the request is passed along to the selected backendService.
22849 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
22850 { # Specification determining how headers are added to requests or responses.
22851 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
22852 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
22853 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
22854 # that already
22855 # exist for the header. If true, headerValue is set for the
22856 # header, discarding any values that were set for that header.
22857 #
22858 # The default value is true,
22859 # unless a variable is present in headerValue,
22860 # in which case the default value is false.
22861 # .
22862 },
22863 ],
22864 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
22865 # request before forwarding the request to the backendService.
22866 &quot;A String&quot;,
22867 ],
22868 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
22869 # client.
22870 { # Specification determining how headers are added to requests or responses.
22871 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
22872 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
22873 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
22874 # that already
22875 # exist for the header. If true, headerValue is set for the
22876 # header, discarding any values that were set for that header.
22877 #
22878 # The default value is true,
22879 # unless a variable is present in headerValue,
22880 # in which case the default value is false.
22881 # .
22882 },
22883 ],
22884 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
22885 # response before sending the response back to the client.
22886 &quot;A String&quot;,
22887 ],
22888 },
22889 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
22890 # computed asweight / (sum of all weightedBackendService weights in routeAction).
22891 #
22892 # The selection of a backend service is determined only for new traffic.
22893 # Once a user&#x27;s request has been directed to a backend service,
22894 # subsequent requests are sent to the same backend service as
22895 # determined by the backend service&#x27;s session affinity policy.
22896 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
22897 # splitting. If you do, the weighted traffic splitting configuration takes
22898 # precedence.
22899 #
22900 # The value must be from 0 to 1000.
22901 },
22902 ],
22903 },
22904 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
22905 # is directed if this rule is matched. If routeAction is
22906 # also specified, advanced routing actions, such as URL rewrites,
22907 # take effect before sending the request to the backend.
22908 #
22909 #
22910 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
22911 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
22912 # specified by urlRedirect.
22913 #
22914 #
22915 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
22916 #
22917 #
22918 # Not supported when the URL map is bound to a target gRPC proxy.
22919 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
22920 # was supplied in the request.
22921 #
22922 # The value must be from 1 to 255
22923 # characters.
22924 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
22925 # set to HTTPS.
22926 # If set to false, the URL scheme of the redirected request
22927 # remains the same as that of the request.
22928 #
22929 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
22930 #
22931 # The default is set to false.
22932 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
22933 # that was supplied in the request.
22934 #
22935 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
22936 # supplied, the path of the original request is used for the redirect.
22937 #
22938 # The value must be from 1 to 1024 characters.
22939 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
22940 # the HttpRouteRuleMatch, retaining the remaining portion
22941 # of the URL before redirecting the request.
22942 #
22943 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
22944 # supplied, the path of the original request is used for the redirect.
22945 #
22946 # The value must be from 1 to 1024 characters.
22947 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
22948 #
22949 # Supported values are:
22950 #
22951 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
22952 # to 301.
22953 # - FOUND, which corresponds to 302.
22954 # - SEE_OTHER which corresponds to 303.
22955 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
22956 # method is retained.
22957 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
22958 # method is retained.
22959 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
22960 # URL is
22961 # removed before redirecting the request. If set to false, the
22962 # query portion of the original URL is retained.
22963 #
22964 # The default is set to false.
22965 },
22966 },
22967 ],
22968 },
22969 ],
22970 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the regional URL map resides.
22971 # This field is not applicable to global URL maps.
22972 # You must specify this field as part of the HTTP request URL. It is
22973 # not settable as a field in the request body.
22974 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
22975 &quot;tests&quot;: [ # The list of expected URL mapping tests. Request to update theUrlMap succeeds only if all test cases pass. You can specify a
22976 # maximum of 100 tests per UrlMap.
22977 #
22978 # Not supported when the URL map is bound to a target gRPC proxy that
22979 # has validateForProxyless field set to true.
22980 { # Message for the expected URL mappings.
22981 &quot;description&quot;: &quot;A String&quot;, # Description of this test case.
22982 &quot;expectedOutputUrl&quot;: &quot;A String&quot;, # The expected output URL evaluated by the load balancer
22983 # containing the scheme, host, path and query parameters.
22984 #
22985 # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
22986 # the load balancer to backends. For rules with urlRewrite,
22987 # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
22988 #
22989 # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer&#x27;s
22990 # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
22991 # If urlRedirect specifies strip_query, the test
22992 # passes only if expectedOutputUrl does not contain any query
22993 # parameters.
22994 #
22995 # expectedOutputUrl is optional whenservice is specified.
22996 &quot;expectedRedirectResponseCode&quot;: 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
22997 # load balancer&#x27;s redirect response.
22998 #
22999 # expectedRedirectResponseCode cannot be set whenservice is set.
23000 &quot;headers&quot;: [ # HTTP headers for this request. If headers contains
23001 # a host header, then host must also match the header value.
23002 { # HTTP headers used in UrlMapTests.
23003 &quot;name&quot;: &quot;A String&quot;, # Header name.
23004 &quot;value&quot;: &quot;A String&quot;, # Header value.
23005 },
23006 ],
23007 &quot;host&quot;: &quot;A String&quot;, # Host portion of the URL. If headers contains a host header,
23008 # then host must also match the header value.
23009 &quot;path&quot;: &quot;A String&quot;, # Path portion of the URL.
23010 &quot;service&quot;: &quot;A String&quot;, # Expected BackendService or BackendBucket resource
23011 # the given URL should be mapped to.
23012 #
23013 # The service field cannot
23014 # be set if expectedRedirectResponseCode is set.
23015 },
23016 ],
23017 }
23018
23019 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
23020 that if you must retry your request, the server will know to ignore the
23021 request if it has already been completed.
23022
23023 For example, consider a situation where you make an initial request and
23024 the request times out. If you make the request again with the same
23025 request ID, the server can check if original operation with the same
23026 request ID was received, and if so, will ignore the second request. This
23027 prevents clients from accidentally creating duplicate commitments.
23028
23029 The request ID must be
23030 a valid UUID with the exception that zero UUID is not supported
23031 (00000000-0000-0000-0000-000000000000).
23032 x__xgafv: string, V1 error format.
23033 Allowed values
23034 1 - v1 error format
23035 2 - v2 error format
23036
23037 Returns:
23038 An object of the form:
23039
23040 { # Represents an Operation resource.
23041 #
23042 # Google Compute Engine has three Operation resources:
23043 #
23044 # * [Global](/compute/docs/reference/rest/v1/globalOperations)
23045 # * [Regional](/compute/docs/reference/rest/v1/regionOperations)
23046 # * [Zonal](/compute/docs/reference/rest/v1/zoneOperations)
23047 #
23048 # You can use an operation resource to manage asynchronous API requests.
23049 # For more information, readHandling
23050 # API responses.
23051 #
23052 # Operations can be global, regional or zonal.
23053 #
23054 # - For global operations, use the `globalOperations`
23055 # resource.
23056 # - For regional operations, use the
23057 # `regionOperations` resource.
23058 # - For zonal operations, use
23059 # the `zoneOperations` resource.
23060 #
23061 #
23062 #
23063 # For more information, read
23064 # Global, Regional, and Zonal Resources.
23065 #
23066 # Note that completed Operation resources have a limited
23067 # retention period.
23068 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
23069 # Not present otherwise.
23070 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
23071 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
23072 # set when the operation is created.
23073 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
23074 # text format.
23075 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
23076 # this field will be populated.
23077 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
23078 # operation.
23079 {
23080 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
23081 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
23082 # details. There is a set of defined message types to use for providing
23083 # details.The syntax depends on the error code. For example,
23084 # QuotaExceededInfo will have details when the error code is
23085 # QUOTA_EXCEEDED.
23086 {
23087 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
23088 #
23089 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
23090 # is not enabled:
23091 #
23092 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
23093 # &quot;domain&quot;: &quot;googleapis.com&quot;
23094 # &quot;metadata&quot;: {
23095 # &quot;resource&quot;: &quot;projects/123&quot;,
23096 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
23097 # }
23098 # }
23099 #
23100 # This response indicates that the pubsub.googleapis.com API is not enabled.
23101 #
23102 # Example of an error that is returned when attempting to create a Spanner
23103 # instance in a region that is out of stock:
23104 #
23105 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
23106 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
23107 # &quot;metadata&quot;: {
23108 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
23109 # }
23110 # }
23111 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
23112 # is typically the registered service name of the tool or product that
23113 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
23114 # generated by some common infrastructure, the error domain must be a
23115 # globally unique value that identifies the infrastructure. For Google API
23116 # infrastructure, the error domain is &quot;googleapis.com&quot;.
23117 &quot;metadatas&quot;: { # Additional structured details about this error.
23118 #
23119 # Keys must match a regular expression of `a-z+` but should
23120 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
23121 # length. When identifying the current value of an exceeded limit, the units
23122 # should be contained in the key, not the value. For example, rather than
23123 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
23124 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
23125 # instances that can be created in a single (batch) request.
23126 &quot;a_key&quot;: &quot;A String&quot;,
23127 },
23128 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
23129 # proximate cause of the error. Error reasons are unique within a particular
23130 # domain of errors. This should be at most 63 characters and match a
23131 # regular expression of `A-Z+[A-Z0-9]`, which represents
23132 # UPPER_SNAKE_CASE.
23133 },
23134 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
23135 #
23136 # For example, if a quota check failed with an error indicating the calling
23137 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
23138 # directly to the right place in the developer console to flip the bit.
23139 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
23140 { # Describes a URL link.
23141 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
23142 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
23143 },
23144 ],
23145 },
23146 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
23147 # which can be attached to an RPC error.
23148 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
23149 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
23150 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
23151 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
23152 },
23153 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
23154 &quot;dimensions&quot;: { # The map holding related quota dimensions.
23155 &quot;a_key&quot;: &quot;A String&quot;,
23156 },
23157 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
23158 # type or metric.
23159 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
23160 # or metric.
23161 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
23162 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
23163 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
23164 },
23165 },
23166 ],
23167 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
23168 # This property is optional.
23169 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
23170 },
23171 ],
23172 },
23173 &quot;getVersionOperationMetadata&quot;: {
23174 &quot;inlineSbomInfo&quot;: {
23175 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
23176 # appropriate identifiers.
23177 &quot;a_key&quot;: &quot;A String&quot;,
23178 },
23179 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
23180 # identifiers.
23181 &quot;a_key&quot;: &quot;A String&quot;,
23182 },
23183 },
23184 },
23185 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
23186 # message that was returned, such as `NOT FOUND`.
23187 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
23188 # status code that was returned. For example, a `404` means the
23189 # resource was not found.
23190 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
23191 # defined by the server.
23192 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
23193 # This value is inRFC3339
23194 # text format.
23195 &quot;instancesBulkInsertOperationMetadata&quot;: {
23196 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
23197 # Example key: zones/us-central1-a
23198 &quot;a_key&quot;: {
23199 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
23200 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
23201 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
23202 # error.
23203 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
23204 # if the flow is rolling forward or rolling back.
23205 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
23206 },
23207 },
23208 },
23209 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
23210 # Operation resources.
23211 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
23212 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
23213 # group of operations results from a `bulkInsert` API request.
23214 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
23215 # `update`, or `delete`, and so on.
23216 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
23217 # There is no requirement that this be linear or support any granularity of
23218 # operations. This should not be used to guess when the operation will be
23219 # complete. This number should monotonically increase as the operation
23220 # progresses.
23221 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
23222 # applicable when performing regional operations.
23223 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
23224 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
23225 # this field will contain information on all underlying zonal actions and
23226 # their state.
23227 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
23228 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
23229 # Example key: zones/us-central1-a
23230 &quot;a_key&quot;: {
23231 &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
23232 # populated.
23233 # different programming environments, including REST APIs and RPC APIs. It is
23234 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
23235 # three pieces of data: error code, error message, and error details.
23236 #
23237 # You can find out more about this error model and how to work with it in the
23238 # [API Design Guide](https://cloud.google.com/apis/design/errors).
23239 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
23240 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
23241 # message types for APIs to use.
23242 {
23243 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
23244 },
23245 ],
23246 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
23247 # user-facing error message should be localized and sent in the
23248 # google.rpc.Status.details field, or localized by the client.
23249 },
23250 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
23251 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
23252 },
23253 },
23254 },
23255 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
23256 # This value is inRFC3339
23257 # text format.
23258 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
23259 # following:
23260 # `PENDING`, `RUNNING`, or `DONE`.
23261 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
23262 # operation.
23263 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
23264 # of the target resource.
23265 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
23266 # operations related to creating a snapshot, this points to the disk
23267 # that the snapshot was created from.
23268 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
23269 # `[email protected]` or
23270 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
23271 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
23272 # operation, this field will be populated.
23273 {
23274 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
23275 # Engine returns NO_RESULTS_ON_PAGE if there
23276 # are no results in the response.
23277 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
23278 # value format. For example:
23279 #
23280 # &quot;data&quot;: [
23281 # {
23282 # &quot;key&quot;: &quot;scope&quot;,
23283 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
23284 # }
23285 {
23286 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
23287 # returned. For example, for warnings where there are no results in a list
23288 # request for a particular zone, this key might be scope and
23289 # the key value might be the zone name. Other examples might be a key
23290 # indicating a deprecated resource and a suggested replacement, or a
23291 # warning about invalid network settings (for example, if an instance
23292 # attempts to perform IP forwarding but is not enabled for IP forwarding).
23293 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
23294 },
23295 ],
23296 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
23297 },
23298 ],
23299 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
23300 # applicable when performing per-zone operations.
23301 }</pre>
23302 </div>
23303
23304 <div class="method">
23305 <code class="details" id="validate">validate(project, urlMap, body=None, x__xgafv=None)</code>
23306 <pre>Runs static validation for the UrlMap. In particular, the tests of the
23307 provided UrlMap will be run. Calling this method does NOT create the
23308 UrlMap.
23309
23310 Args:
23311 project: string, Project ID for this request. (required)
23312 urlMap: string, Name of the UrlMap resource to be validated as. (required)
23313 body: object, The request body.
23314 The object takes the form of:
23315
23316 {
23317 &quot;loadBalancingSchemes&quot;: [ # Specifies the load balancer type(s) this validation request is for. UseEXTERNAL_MANAGED for global external Application Load
23318 # Balancers and regional external Application Load Balancers.
23319 # Use EXTERNAL for classic Application Load Balancers.
23320 #
23321 # Use INTERNAL_MANAGED for internal Application Load Balancers. For more
23322 # information, refer to Choosing
23323 # a load balancer.
23324 #
23325 # If unspecified, the load balancing scheme will be inferred from the backend
23326 # service resources this URL map references. If that can not be inferred (for
23327 # example, this URL map only references backend buckets, or this Url map is
23328 # for rewrites and redirects only and doesn&#x27;t reference any backends),EXTERNAL will be used as the default type.
23329 #
23330 # If specified, the scheme(s) must not conflict with the load balancing
23331 # scheme of the backend service resources this Url map references.
23332 &quot;A String&quot;,
23333 ],
23334 &quot;resource&quot;: { # Represents a URL Map resource. # Content of the UrlMap to be validated.
23335 #
23336 # Compute Engine has two URL Map resources:
23337 #
23338 # * [Global](/compute/docs/reference/rest/v1/urlMaps)
23339 # * [Regional](/compute/docs/reference/rest/v1/regionUrlMaps)
23340 #
23341 # A URL map resource is a component of certain types of cloud load balancers
23342 # and Traffic Director:
23343 #
23344 # * urlMaps are used by global external Application Load
23345 # Balancers, classic Application Load Balancers, and cross-region internal
23346 # Application Load Balancers.
23347 # * regionUrlMaps are used by internal Application Load Balancers,
23348 # regional external Application Load Balancers and regional internal
23349 # Application Load Balancers.
23350 #
23351 # For a list of supported URL map features by the load balancer type, see the
23352 # Load balancing features: Routing and traffic management table.
23353 #
23354 # For a list of supported URL map features for Traffic Director, see the
23355 # Traffic Director features: Routing and traffic management table.
23356 #
23357 # This resource defines mappings from hostnames and URL paths to either a
23358 # backend service or a backend bucket.
23359 #
23360 # To use the global urlMaps resource, the backend service must
23361 # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
23362 # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
23363 # information, read URL
23364 # Map Concepts.
23365 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
23366 # text format.
23367 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
23368 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
23369 #
23370 # This policy takes
23371 # effect at the load balancer level and applies only when no policy has been
23372 # defined for the error code at lower levels like PathMatcher, RouteRule and
23373 # PathRule within this UrlMap.
23374 #
23375 # For example, consider a UrlMap with the
23376 # following configuration:
23377 #
23378 #
23379 # - defaultCustomErrorResponsePolicy containing policies for
23380 # responding to 5xx and 4xx errors
23381 # - A PathMatcher configured for *.example.com has
23382 # defaultCustomErrorResponsePolicy for 4xx.
23383 #
23384 # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
23385 # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
23386 # a request that does not match any host in *.example.com such
23387 # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
23388 # takes effect.
23389 #
23390 # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
23391 # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
23392 # a retry, if load balancer is successful in reaching the
23393 # service, the defaultCustomErrorResponsePolicy is ignored and
23394 # the response from the service is returned to the client.
23395 #
23396 # defaultCustomErrorResponsePolicy is supported only for
23397 # global external Application Load Balancers.
23398 # backend service or backend bucket responds with an error.
23399 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
23400 #
23401 # In a given policy, if you specify rules for both a range of error codes
23402 # as well as rules for specific error codes then rules with specific error
23403 # codes have a higher priority. For example, assume that you configure a rule
23404 # for 401 (Un-authorized) code, and another for all 4 series
23405 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
23406 # However if the backend service returns a 403, the rule for4xx takes effect.
23407 { # Specifies the mapping between the response code that will be returned along
23408 # with the custom error content and the response code returned by the backend
23409 # service.
23410 &quot;matchResponseCodes&quot;: [ # Valid values include:
23411 #
23412 #
23413 # - A number between 400 and 599: For example
23414 # 401 or 503, in which case the load balancer
23415 # applies the policy if the error code exactly matches this value.
23416 # - 5xx: Load Balancer will apply the policy if the
23417 # backend service responds with any response code in the range of
23418 # 500 to 599.
23419 # - 4xx: Load
23420 # Balancer will apply the policy if the backend service responds with any
23421 # response code in the range of 400 to
23422 # 499.
23423 #
23424 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
23425 &quot;A String&quot;,
23426 ],
23427 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
23428 # error content. If overrideResponseCode is not supplied, the
23429 # same response code returned by the original backend bucket or backend
23430 # service is returned to the client.
23431 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
23432 #
23433 # path must start
23434 # with a leading slash. path cannot have trailing slashes.
23435 #
23436 # If the file is not available in backendBucket or the
23437 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
23438 #
23439 # The value must
23440 # be from 1 to 1024 characters
23441 },
23442 ],
23443 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
23444 # contains the custom error content. Examples are:
23445 #
23446 #
23447 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
23448 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
23449 # - global/backendBuckets/myBackendBucket
23450 #
23451 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
23452 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
23453 #
23454 # If load balancer cannot reach
23455 # the backendBucket, a simple Not Found Error will
23456 # be returned, with the original response code (oroverrideResponseCode if configured).
23457 #
23458 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
23459 },
23460 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
23461 # hostRules match. The load balancer performs advanced routing
23462 # actions, such as URL rewrites and header transformations, before forwarding
23463 # the request to the selected backend.
23464 #
23465 #
23466 # Only one of defaultUrlRedirect, defaultService
23467 # or defaultRouteAction.weightedBackendService can be set.
23468 #
23469 #
23470 # URL maps for classic Application Load Balancers only support
23471 # the urlRewrite action within defaultRouteAction.
23472 #
23473 #
23474 # defaultRouteAction has no effect when the URL map is bound
23475 # to a target gRPC proxy that has the validateForProxyless field
23476 # set to true.
23477 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
23478 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
23479 # property must be specified. This policy cannot be specified if any target
23480 # backend has Identity-Aware Proxy enabled.
23481 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
23482 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
23483 # header names can be specified. The cache is bypassed for all `cacheMode`
23484 # values.
23485 &quot;A String&quot;,
23486 ],
23487 &quot;cacheKeyPolicy&quot;: { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
23488 # on the backend type: for Backend Services, the complete request URI is
23489 # used; for Backend Buckets, the request URI is used without the protocol or
23490 # host, and only query parameters known to Cloud Storage are included.
23491 # Policy defined on Route Action.
23492 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
23493 # parameters will be included. Either specify `excludedQueryParameters`
23494 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
23495 # encoded and not treated as delimiters.
23496 #
23497 # Note: This field applies to routes that use backend services. Attempting
23498 # to set it on a route that points exclusively to Backend Buckets will
23499 # result in a configuration error. For routes that point to a Backend
23500 # Bucket, use `includedQueryParameters` to define which parameters should
23501 # be part of the cache key.
23502 &quot;A String&quot;,
23503 ],
23504 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
23505 #
23506 # Note: This setting is only applicable to routes that use a Backend
23507 # Service. It does not affect requests served by a Backend Bucket, as the
23508 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
23509 # it on a route that points exclusively to Backend Buckets will result in a
23510 # configuration error.
23511 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
23512 #
23513 # Note: This setting is only applicable to routes that use a Backend
23514 # Service. It does not affect requests served by a Backend Bucket, as the
23515 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
23516 # set on a route that points exclusively to Backend Buckets will result in
23517 # a configuration error.
23518 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
23519 # `includedQueryParameters` and `excludedQueryParameters`. If neither
23520 # is set, the entire query string will be included. If false, the query
23521 # string will be excluded from the cache key entirely.
23522 #
23523 # Note: This field applies to routes that use backend services. Attempting
23524 # to set it on a route that points exclusively to Backend Buckets will
23525 # result in a configuration error. For routes that point to a Backend
23526 # Bucket, use `includedQueryParameters` to define which parameters should
23527 # be part of the cache key.
23528 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
23529 # The name=value pair will be used in the cache key Cloud CDN generates.
23530 #
23531 # Note: This setting is only applicable to routes that use a Backend
23532 # Service. It does not affect requests served by a Backend Bucket.
23533 # Attempting to set it on a route that points exclusively to Backend
23534 # Buckets will result in a configuration error. Up to 5 cookie names can be
23535 # specified.
23536 &quot;A String&quot;,
23537 ],
23538 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
23539 &quot;A String&quot;,
23540 ],
23541 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
23542 # parameters will be excluded. Either specify `includedQueryParameters`
23543 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
23544 # encoded and not treated as delimiters.
23545 &quot;A String&quot;,
23546 ],
23547 },
23548 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
23549 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
23550 &quot;clientTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
23551 # content. This is used to clamp the max-age (or Expires) value sent to the
23552 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
23553 # is used for the response max-age directive, along with a &quot;public&quot;
23554 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
23555 # clamps the max-age from the origin (if specified), or else sets the
23556 # response max-age directive to the lesser of the `clientTtl` and
23557 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
23558 # present. The maximum allowed value is 31,622,400s (1 year). If not
23559 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
23560 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
23561 # `USE_ORIGIN_HEADERS`.
23562 # as a count of seconds and fractions of seconds at nanosecond
23563 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
23564 # or &quot;month&quot;. Range is approximately 10,000 years.
23565 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
23566 # Durations less than one second are represented with a 0
23567 # `seconds` field and a positive `nanos` field. Must be from 0
23568 # to 999,999,999 inclusive.
23569 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
23570 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
23571 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
23572 },
23573 &quot;defaultTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
23574 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
23575 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
23576 # greater than that of `maxTtl`. When the `cacheMode` is set to
23577 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
23578 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
23579 # accessed objects may be evicted from the cache before the defined TTL. If
23580 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
23581 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
23582 # `USE_ORIGIN_HEADERS`.
23583 # as a count of seconds and fractions of seconds at nanosecond
23584 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
23585 # or &quot;month&quot;. Range is approximately 10,000 years.
23586 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
23587 # Durations less than one second are represented with a 0
23588 # `seconds` field and a positive `nanos` field. Must be from 0
23589 # to 999,999,999 inclusive.
23590 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
23591 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
23592 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
23593 },
23594 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
23595 # attempt to set a max-age or s-maxage higher than this, or an Expires header
23596 # more than `maxTtl` seconds in the future will be capped at the value of
23597 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
23598 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
23599 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
23600 # Infrequently accessed objects may be evicted from the cache before the
23601 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
23602 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
23603 # mode.
23604 # as a count of seconds and fractions of seconds at nanosecond
23605 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
23606 # or &quot;month&quot;. Range is approximately 10,000 years.
23607 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
23608 # Durations less than one second are represented with a 0
23609 # `seconds` field and a positive `nanos` field. Must be from 0
23610 # to 999,999,999 inclusive.
23611 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
23612 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
23613 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
23614 },
23615 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
23616 # to apply fine-grained caching for common errors or redirects.
23617 # This can reduce the load on your origin and improve end-user
23618 # experience by reducing response latency.
23619 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
23620 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
23621 # the specified response code that lack any Cache-Control, Expires, or
23622 # Pragma: no-cache directives. When the `cacheMode` is set to
23623 # `FORCE_CACHE_ALL`, negative caching applies to all responses
23624 # with the specified response code, and overrides any caching headers. By
23625 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
23626 #
23627 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
23628 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
23629 # * 405 (Method Not Found), 501 (Not Implemented): 60s
23630 #
23631 # These defaults can be overridden in `negativeCachingPolicy`.
23632 # If not specified, Cloud CDN applies negative caching by default.
23633 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
23634 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
23635 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
23636 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
23637 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
23638 # all response codes that you wish to cache. Cloud CDN will not apply any
23639 # default negative caching when a policy exists.
23640 { # Specify CDN TTLs for response error codes.
23641 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
23642 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
23643 # specified as values, and you cannot specify a status code more than
23644 # once.
23645 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
23646 # corresponding status code.
23647 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
23648 # objects may be evicted from the cache before the defined TTL.
23649 # as a count of seconds and fractions of seconds at nanosecond
23650 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
23651 # or &quot;month&quot;. Range is approximately 10,000 years.
23652 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
23653 # Durations less than one second are represented with a 0
23654 # `seconds` field and a positive `nanos` field. Must be from 0
23655 # to 999,999,999 inclusive.
23656 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
23657 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
23658 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
23659 },
23660 },
23661 ],
23662 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
23663 # requests into a small number of requests to the origin. If not specified,
23664 # Cloud CDN applies request coalescing by default.
23665 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
23666 # content with the origin, or when an error is encountered when refreshing
23667 # the cache.
23668 # This setting defines the default &quot;max-stale&quot; duration for any cached
23669 # responses that do not specify a max-stale directive. Stale responses that
23670 # exceed the TTL configured here will not be served. The default limit
23671 # (max-stale) is 86400s (1 day), which will allow stale content to be
23672 # served up to this limit beyond the max-age (or s-maxage) of a cached
23673 # response.
23674 # The maximum allowed value is 604800 (1 week).
23675 # Set this to zero (0) to disable serve-while-stale.
23676 # as a count of seconds and fractions of seconds at nanosecond
23677 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
23678 # or &quot;month&quot;. Range is approximately 10,000 years.
23679 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
23680 # Durations less than one second are represented with a 0
23681 # `seconds` field and a positive `nanos` field. Must be from 0
23682 # to 999,999,999 inclusive.
23683 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
23684 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
23685 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
23686 },
23687 },
23688 &quot;corsPolicy&quot;: { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
23689 # information about the W3C recommendation for cross-origin resource sharing
23690 # (CORS), see Fetch API Living
23691 # Standard.
23692 #
23693 # Not supported when the URL map is bound to a target gRPC proxy.
23694 # information about the W3C recommendation for cross-origin resource sharing
23695 # (CORS), see Fetch API Living
23696 # Standard.
23697 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
23698 # indicates that
23699 # the actual request can include user credentials. This field translates to
23700 # the Access-Control-Allow-Credentials header.
23701 #
23702 # Default is false.
23703 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
23704 # header.
23705 &quot;A String&quot;,
23706 ],
23707 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
23708 # header.
23709 &quot;A String&quot;,
23710 ],
23711 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
23712 # more information, see regular expression syntax.
23713 #
23714 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
23715 #
23716 # Regular expressions can only be used when the loadBalancingScheme is
23717 # set to INTERNAL_SELF_MANAGED.
23718 &quot;A String&quot;,
23719 ],
23720 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
23721 #
23722 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
23723 &quot;A String&quot;,
23724 ],
23725 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
23726 # The default value is false, which indicates that the CORS
23727 # policy is in effect.
23728 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
23729 # header.
23730 &quot;A String&quot;,
23731 ],
23732 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
23733 # seconds. This field translates to the Access-Control-Max-Age
23734 # header.
23735 },
23736 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
23737 # the resiliency of clients to backend service failure. As part of fault
23738 # injection, when clients send requests to a backend service, delays can be
23739 # introduced by a load balancer on a percentage of requests before sending
23740 # those requests to the backend service. Similarly requests from clients can
23741 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
23742 # that are configured with a fault_injection_policy if:
23743 # 1. The traffic is generated by fault injection AND
23744 # 2. The fault injection is not a delay fault injection.
23745 # Fault injection is not supported with the classic Application Load Balancer
23746 # . To see which load balancers support fault injection,
23747 # see Load
23748 # balancing: Routing and traffic management features.
23749 # the resiliency of clients to backend service failure. As part of fault
23750 # injection, when clients send requests to a backend service, delays can be
23751 # introduced by the load balancer on a percentage of requests before sending
23752 # those request to the backend service. Similarly requests from clients can be
23753 # aborted by the load balancer for a percentage of requests.
23754 &quot;abort&quot;: { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
23755 # injection.
23756 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
23757 #
23758 # The value must be from 200 to 599 inclusive.
23759 #
23760 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
23761 # according to this
23762 # mapping table. HTTP status 200 is mapped to gRPC status
23763 # UNKNOWN. Injecting an OK status is currently not supported by
23764 # Traffic Director.
23765 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
23766 # that is aborted as part of fault injection.
23767 #
23768 # The value must be from 0.0 to 100.0 inclusive.
23769 },
23770 &quot;delay&quot;: { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
23771 # injection, before being sent to a backend service.
23772 # request to the backend service as part of fault injection.
23773 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
23774 # as a count of seconds and fractions of seconds at nanosecond
23775 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
23776 # or &quot;month&quot;. Range is approximately 10,000 years.
23777 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
23778 # Durations less than one second are represented with a 0
23779 # `seconds` field and a positive `nanos` field. Must be from 0
23780 # to 999,999,999 inclusive.
23781 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
23782 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
23783 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
23784 },
23785 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
23786 # which a delay is introduced as part of fault injection.
23787 #
23788 # The value must be from 0.0 to 100.0 inclusive.
23789 },
23790 },
23791 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
23792 # Unlike the timeout field where the timeout duration starts
23793 # from the time the request has been fully processed (known as*end-of-stream*),
23794 # the duration in this field is computed from the beginning of the stream
23795 # until the response has been processed, including all retries. A
23796 # stream that does not complete in this duration is closed.
23797 #
23798 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
23799 # with the route.
23800 #
23801 # This field is only allowed if the Url map is used with backend services
23802 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
23803 # as a count of seconds and fractions of seconds at nanosecond
23804 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
23805 # or &quot;month&quot;. Range is approximately 10,000 years.
23806 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
23807 # Durations less than one second are represented with a 0
23808 # `seconds` field and a positive `nanos` field. Must be from 0
23809 # to 999,999,999 inclusive.
23810 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
23811 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
23812 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
23813 },
23814 &quot;requestMirrorPolicy&quot;: { # A policy that specifies how requests intended for the route&#x27;s backends # Specifies the policy on how requests intended for the route&#x27;s backends
23815 # are shadowed to a separate mirrored backend service. The load balancer does
23816 # not wait for responses from the shadow service. Before sending traffic
23817 # to the shadow service, the host / authority header is suffixed with-shadow.
23818 #
23819 # Not supported when the URL map is bound to a target gRPC proxy that
23820 # has the validateForProxyless field set to true.
23821 # are shadowed to a separate mirrored backend service. The load balancer
23822 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
23823 # to the shadow service, the host or authority header is suffixed with-shadow.
23824 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
23825 # mirrored to.
23826 #
23827 # The backend service configured for a mirroring
23828 # policy must reference backends that are of the same type as the original
23829 # backend service matched in the URL map.
23830 #
23831 # Serverless NEG backends are not currently supported as a mirrored
23832 # backend service.
23833 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
23834 },
23835 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
23836 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
23837 # If not specified, defaults to 1.
23838 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
23839 #
23840 # If not specified, will use the timeout set in theHttpRouteAction field.
23841 # If timeout in the HttpRouteAction field is not set, this field
23842 # uses the largest timeout
23843 # among all backend services associated with the route.
23844 #
23845 # Not supported when the URL map is bound to a target gRPC proxy that
23846 # has the validateForProxyless field set to true.
23847 # as a count of seconds and fractions of seconds at nanosecond
23848 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
23849 # or &quot;month&quot;. Range is approximately 10,000 years.
23850 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
23851 # Durations less than one second are represented with a 0
23852 # `seconds` field and a positive `nanos` field. Must be from 0
23853 # to 999,999,999 inclusive.
23854 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
23855 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
23856 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
23857 },
23858 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
23859 # values are:
23860 #
23861 # - 5xx: retry is attempted if the instance or endpoint
23862 # responds with any 5xx response code, or if the instance or
23863 # endpoint does not respond at all. For example, disconnects, reset, read
23864 # timeout, connection failure, and refused streams.
23865 # - gateway-error: Similar to 5xx, but only
23866 # applies to response codes 502, 503 or504.
23867 # - connect-failure: a retry is attempted on failures
23868 # connecting to the instance or endpoint. For example, connection
23869 # timeouts.
23870 # - retriable-4xx: a retry is attempted if the instance
23871 # or endpoint responds with a 4xx response code.
23872 # The only error that you can retry is error code 409.
23873 # - refused-stream: a retry is attempted if the instance
23874 # or endpoint resets the stream with a REFUSED_STREAM error
23875 # code. This reset type indicates that it is safe to retry.
23876 # - cancelled: a retry is attempted if the gRPC status
23877 # code in the response header is set to cancelled.
23878 # - deadline-exceeded: a retry is attempted if the gRPC
23879 # status code in the response header is set todeadline-exceeded.
23880 # - internal: a retry is attempted if the gRPC
23881 # status code in the response header is set tointernal.
23882 # - resource-exhausted: a retry is attempted if the gRPC
23883 # status code in the response header is set toresource-exhausted.
23884 # - unavailable: a retry is attempted if the gRPC
23885 # status code in the response header is set tounavailable.
23886 #
23887 # Only the following codes are supported when the URL map is bound to
23888 # target gRPC proxy that has validateForProxyless field set to true.
23889 #
23890 # - cancelled
23891 # - deadline-exceeded
23892 # - internal
23893 # - resource-exhausted
23894 # - unavailable
23895 &quot;A String&quot;,
23896 ],
23897 },
23898 &quot;timeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
23899 # time the request has been fully processed (known as *end-of-stream*)
23900 # up until the response has been processed. Timeout includes
23901 # all retries.
23902 #
23903 # If not specified, this field uses the largest timeout among all backend
23904 # services associated with the route.
23905 #
23906 # Not supported when the URL map is bound to a target gRPC proxy that
23907 # has validateForProxyless field set to true.
23908 # as a count of seconds and fractions of seconds at nanosecond
23909 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
23910 # or &quot;month&quot;. Range is approximately 10,000 years.
23911 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
23912 # Durations less than one second are represented with a 0
23913 # `seconds` field and a positive `nanos` field. Must be from 0
23914 # to 999,999,999 inclusive.
23915 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
23916 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
23917 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
23918 },
23919 &quot;urlRewrite&quot;: { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
23920 # to the matched service.
23921 #
23922 # urlRewrite is the only action supported in UrlMaps
23923 # for classic Application Load Balancers.
23924 #
23925 # Not supported when the URL map is bound to a target gRPC proxy that
23926 # has the validateForProxyless field set to true.
23927 # backend service.
23928 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
23929 # host header is replaced with contents of hostRewrite.
23930 #
23931 # The value must be from 1 to 255 characters.
23932 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
23933 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
23934 #
23935 # The value must be from 1 to 1024 characters.
23936 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
23937 # header) using the HTTP template syntax.
23938 #
23939 # A corresponding
23940 # path_template_match must be specified. Any template variables must exist in
23941 # the path_template_match field.
23942 #
23943 #
23944 # - -At least one variable must be specified in the path_template_match
23945 # field
23946 # - You can omit variables from the rewritten URL
23947 # - The * and ** operators cannot be matched
23948 # unless they have a corresponding variable name - e.g.
23949 # {format=*} or {var=**}.
23950 #
23951 # For example, a path_template_match of /static/{format=**}
23952 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
23953 # rewrite, so that /{country}/{format}/{suffix=**} can be
23954 # rewritten as /content/{format}/{country}/{suffix}.
23955 #
23956 # At least
23957 # one non-empty routeRules[].matchRules[].path_template_match is
23958 # required.
23959 #
23960 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
23961 },
23962 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
23963 # occurs. The weights determine the fraction of traffic that flows to
23964 # their corresponding backend service. If all traffic needs to
23965 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
23966 #
23967 # After a backend service is identified and before forwarding
23968 # the request to
23969 # the backend service, advanced routing actions such as URL rewrites and
23970 # header transformations are applied depending on additional settings
23971 # specified in this HttpRouteAction.
23972 { # In contrast to a single BackendService in
23973 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
23974 # multiple backend services. The volume of traffic for each
23975 # backend service is proportional to the weight specified
23976 # in each WeightedBackendService
23977 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
23978 # resource. Before
23979 # forwarding the request to backendService, the load balancer
23980 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
23981 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
23982 # effect for the selected backendService.
23983 #
23984 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
23985 #
23986 # headerAction is not supported for load balancers that have
23987 # their loadBalancingScheme set to EXTERNAL.
23988 #
23989 # Not supported when the URL map is bound to a target gRPC proxy that
23990 # has validateForProxyless field set to true.
23991 # the request is passed along to the selected backendService.
23992 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
23993 { # Specification determining how headers are added to requests or responses.
23994 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
23995 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
23996 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
23997 # that already
23998 # exist for the header. If true, headerValue is set for the
23999 # header, discarding any values that were set for that header.
24000 #
24001 # The default value is true,
24002 # unless a variable is present in headerValue,
24003 # in which case the default value is false.
24004 # .
24005 },
24006 ],
24007 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
24008 # request before forwarding the request to the backendService.
24009 &quot;A String&quot;,
24010 ],
24011 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
24012 # client.
24013 { # Specification determining how headers are added to requests or responses.
24014 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
24015 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
24016 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
24017 # that already
24018 # exist for the header. If true, headerValue is set for the
24019 # header, discarding any values that were set for that header.
24020 #
24021 # The default value is true,
24022 # unless a variable is present in headerValue,
24023 # in which case the default value is false.
24024 # .
24025 },
24026 ],
24027 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
24028 # response before sending the response back to the client.
24029 &quot;A String&quot;,
24030 ],
24031 },
24032 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
24033 # computed asweight / (sum of all weightedBackendService weights in routeAction).
24034 #
24035 # The selection of a backend service is determined only for new traffic.
24036 # Once a user&#x27;s request has been directed to a backend service,
24037 # subsequent requests are sent to the same backend service as
24038 # determined by the backend service&#x27;s session affinity policy.
24039 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
24040 # splitting. If you do, the weighted traffic splitting configuration takes
24041 # precedence.
24042 #
24043 # The value must be from 0 to 1000.
24044 },
24045 ],
24046 },
24047 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL of the defaultService resource to
24048 # which traffic is directed if none of the hostRules match.
24049 # If defaultRouteAction is also specified, advanced
24050 # routing actions, such as URL rewrites, take effect before sending the
24051 # request to the backend.
24052 #
24053 #
24054 # Only one of defaultUrlRedirect, defaultService
24055 # or defaultRouteAction.weightedBackendService can be set.
24056 #
24057 #
24058 # defaultService has no effect when the URL map is bound
24059 # to a target gRPC proxy that has the validateForProxyless field
24060 # set to true.
24061 &quot;defaultUrlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
24062 # is redirected to a URL specified by defaultUrlRedirect.
24063 #
24064 #
24065 # Only one of defaultUrlRedirect, defaultService
24066 # or defaultRouteAction.weightedBackendService can be set.
24067 #
24068 #
24069 # Not supported when the URL map is bound to a target gRPC proxy.
24070 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
24071 # was supplied in the request.
24072 #
24073 # The value must be from 1 to 255
24074 # characters.
24075 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
24076 # set to HTTPS.
24077 # If set to false, the URL scheme of the redirected request
24078 # remains the same as that of the request.
24079 #
24080 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
24081 #
24082 # The default is set to false.
24083 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
24084 # that was supplied in the request.
24085 #
24086 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
24087 # supplied, the path of the original request is used for the redirect.
24088 #
24089 # The value must be from 1 to 1024 characters.
24090 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
24091 # the HttpRouteRuleMatch, retaining the remaining portion
24092 # of the URL before redirecting the request.
24093 #
24094 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
24095 # supplied, the path of the original request is used for the redirect.
24096 #
24097 # The value must be from 1 to 1024 characters.
24098 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
24099 #
24100 # Supported values are:
24101 #
24102 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
24103 # to 301.
24104 # - FOUND, which corresponds to 302.
24105 # - SEE_OTHER which corresponds to 303.
24106 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
24107 # method is retained.
24108 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
24109 # method is retained.
24110 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
24111 # URL is
24112 # removed before redirecting the request. If set to false, the
24113 # query portion of the original URL is retained.
24114 #
24115 # The default is set to false.
24116 },
24117 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
24118 # create the resource.
24119 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. A hash of the contents stored in this object.
24120 # This field is used in optimistic locking. This field is ignored when
24121 # inserting a UrlMap. An up-to-date fingerprint must be provided
24122 # in order to update the UrlMap, otherwise the request will
24123 # fail with error 412 conditionNotMet.
24124 #
24125 # To see the latest fingerprint, make a get() request to
24126 # retrieve a UrlMap.
24127 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
24128 # for the selected backendService.
24129 #
24130 # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
24131 #
24132 # headerAction is not supported for load balancers
24133 # that have
24134 # their loadBalancingScheme set to EXTERNAL.
24135 #
24136 # Not supported when the URL map is bound to a target gRPC proxy that
24137 # has validateForProxyless field set to true.
24138 # the request is passed along to the selected backendService.
24139 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
24140 { # Specification determining how headers are added to requests or responses.
24141 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
24142 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
24143 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
24144 # that already
24145 # exist for the header. If true, headerValue is set for the
24146 # header, discarding any values that were set for that header.
24147 #
24148 # The default value is true,
24149 # unless a variable is present in headerValue,
24150 # in which case the default value is false.
24151 # .
24152 },
24153 ],
24154 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
24155 # request before forwarding the request to the backendService.
24156 &quot;A String&quot;,
24157 ],
24158 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
24159 # client.
24160 { # Specification determining how headers are added to requests or responses.
24161 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
24162 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
24163 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
24164 # that already
24165 # exist for the header. If true, headerValue is set for the
24166 # header, discarding any values that were set for that header.
24167 #
24168 # The default value is true,
24169 # unless a variable is present in headerValue,
24170 # in which case the default value is false.
24171 # .
24172 },
24173 ],
24174 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
24175 # response before sending the response back to the client.
24176 &quot;A String&quot;,
24177 ],
24178 },
24179 &quot;hostRules&quot;: [ # The list of host rules to use against the URL.
24180 { # UrlMaps
24181 # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
24182 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
24183 # create the resource.
24184 &quot;hosts&quot;: [ # The list of host patterns to match. They must be valid hostnames with
24185 # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
24186 # that case, * must be the first character, and if followed by
24187 # anything, the immediate following character must be either -
24188 # or ..
24189 #
24190 # * based matching is not supported when the URL map is bound
24191 # to a target gRPC proxy that has the validateForProxyless field
24192 # set to true.
24193 &quot;A String&quot;,
24194 ],
24195 &quot;pathMatcher&quot;: &quot;A String&quot;, # The name of the PathMatcher to use to match the path portion
24196 # of the URL if the hostRule matches the URL&#x27;s host portion.
24197 },
24198 ],
24199 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the resource. This identifier is
24200 # defined by the server.
24201 &quot;kind&quot;: &quot;compute#urlMap&quot;, # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
24202 # url maps.
24203 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
24204 # The name must be 1-63 characters long, and comply withRFC1035.
24205 # Specifically, the name must be 1-63 characters long and match the regular
24206 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
24207 # character must be a lowercase letter, and all following characters must
24208 # be a dash, lowercase letter, or digit, except the last character, which
24209 # cannot be a dash.
24210 &quot;pathMatchers&quot;: [ # The list of named PathMatchers to use against the URL.
24211 { # A matcher for the path portion of the URL. The BackendService
24212 # from the longest-matched rule will serve the URL. If no rule was matched, the
24213 # default service is used.
24214 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
24215 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
24216 #
24217 # This policy takes
24218 # effect at the PathMatcher level and applies only when no
24219 # policy has been defined for the error code at lower levels likeRouteRule and PathRule within thisPathMatcher. If an error code does not have a policy defined
24220 # in defaultCustomErrorResponsePolicy, then a policy defined for
24221 # the error code in UrlMap.defaultCustomErrorResponsePolicy
24222 # takes effect.
24223 #
24224 # For example, consider a UrlMap with the following
24225 # configuration:
24226 #
24227 #
24228 # - UrlMap.defaultCustomErrorResponsePolicy is configured
24229 # with policies for 5xx and 4xx errors
24230 # - A RouteRule for /coming_soon/ is configured for the
24231 # error code 404.
24232 #
24233 # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher&#x27;s policy
24234 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
24235 # the policy in RouteRule.customErrorResponsePolicy takes
24236 # effect. If any of the requests in this example encounter a 500
24237 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
24238 #
24239 # When
24240 # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
24241 # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
24242 # a retry, if load balancer is successful in reaching the
24243 # service, the defaultCustomErrorResponsePolicy is ignored and
24244 # the response from the service is returned to the client.
24245 #
24246 # defaultCustomErrorResponsePolicy is supported only for
24247 # global external Application Load Balancers.
24248 # backend service or backend bucket responds with an error.
24249 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
24250 #
24251 # In a given policy, if you specify rules for both a range of error codes
24252 # as well as rules for specific error codes then rules with specific error
24253 # codes have a higher priority. For example, assume that you configure a rule
24254 # for 401 (Un-authorized) code, and another for all 4 series
24255 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
24256 # However if the backend service returns a 403, the rule for4xx takes effect.
24257 { # Specifies the mapping between the response code that will be returned along
24258 # with the custom error content and the response code returned by the backend
24259 # service.
24260 &quot;matchResponseCodes&quot;: [ # Valid values include:
24261 #
24262 #
24263 # - A number between 400 and 599: For example
24264 # 401 or 503, in which case the load balancer
24265 # applies the policy if the error code exactly matches this value.
24266 # - 5xx: Load Balancer will apply the policy if the
24267 # backend service responds with any response code in the range of
24268 # 500 to 599.
24269 # - 4xx: Load
24270 # Balancer will apply the policy if the backend service responds with any
24271 # response code in the range of 400 to
24272 # 499.
24273 #
24274 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
24275 &quot;A String&quot;,
24276 ],
24277 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
24278 # error content. If overrideResponseCode is not supplied, the
24279 # same response code returned by the original backend bucket or backend
24280 # service is returned to the client.
24281 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
24282 #
24283 # path must start
24284 # with a leading slash. path cannot have trailing slashes.
24285 #
24286 # If the file is not available in backendBucket or the
24287 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
24288 #
24289 # The value must
24290 # be from 1 to 1024 characters
24291 },
24292 ],
24293 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
24294 # contains the custom error content. Examples are:
24295 #
24296 #
24297 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
24298 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
24299 # - global/backendBuckets/myBackendBucket
24300 #
24301 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
24302 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
24303 #
24304 # If load balancer cannot reach
24305 # the backendBucket, a simple Not Found Error will
24306 # be returned, with the original response code (oroverrideResponseCode if configured).
24307 #
24308 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
24309 },
24310 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
24311 # pathRules or routeRules match. The load balancer
24312 # performs advanced routing actions, such as URL rewrites and
24313 # header transformations, before forwarding the request to the
24314 # selected backend.
24315 #
24316 #
24317 # Only one of defaultUrlRedirect, defaultService
24318 # or defaultRouteAction.weightedBackendService can be set.
24319 #
24320 #
24321 # URL maps for classic Application Load Balancers only support
24322 # the urlRewrite action within a path matcher&#x27;sdefaultRouteAction.
24323 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
24324 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
24325 # property must be specified. This policy cannot be specified if any target
24326 # backend has Identity-Aware Proxy enabled.
24327 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
24328 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
24329 # header names can be specified. The cache is bypassed for all `cacheMode`
24330 # values.
24331 &quot;A String&quot;,
24332 ],
24333 &quot;cacheKeyPolicy&quot;: { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
24334 # on the backend type: for Backend Services, the complete request URI is
24335 # used; for Backend Buckets, the request URI is used without the protocol or
24336 # host, and only query parameters known to Cloud Storage are included.
24337 # Policy defined on Route Action.
24338 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
24339 # parameters will be included. Either specify `excludedQueryParameters`
24340 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
24341 # encoded and not treated as delimiters.
24342 #
24343 # Note: This field applies to routes that use backend services. Attempting
24344 # to set it on a route that points exclusively to Backend Buckets will
24345 # result in a configuration error. For routes that point to a Backend
24346 # Bucket, use `includedQueryParameters` to define which parameters should
24347 # be part of the cache key.
24348 &quot;A String&quot;,
24349 ],
24350 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
24351 #
24352 # Note: This setting is only applicable to routes that use a Backend
24353 # Service. It does not affect requests served by a Backend Bucket, as the
24354 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
24355 # it on a route that points exclusively to Backend Buckets will result in a
24356 # configuration error.
24357 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
24358 #
24359 # Note: This setting is only applicable to routes that use a Backend
24360 # Service. It does not affect requests served by a Backend Bucket, as the
24361 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
24362 # set on a route that points exclusively to Backend Buckets will result in
24363 # a configuration error.
24364 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
24365 # `includedQueryParameters` and `excludedQueryParameters`. If neither
24366 # is set, the entire query string will be included. If false, the query
24367 # string will be excluded from the cache key entirely.
24368 #
24369 # Note: This field applies to routes that use backend services. Attempting
24370 # to set it on a route that points exclusively to Backend Buckets will
24371 # result in a configuration error. For routes that point to a Backend
24372 # Bucket, use `includedQueryParameters` to define which parameters should
24373 # be part of the cache key.
24374 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
24375 # The name=value pair will be used in the cache key Cloud CDN generates.
24376 #
24377 # Note: This setting is only applicable to routes that use a Backend
24378 # Service. It does not affect requests served by a Backend Bucket.
24379 # Attempting to set it on a route that points exclusively to Backend
24380 # Buckets will result in a configuration error. Up to 5 cookie names can be
24381 # specified.
24382 &quot;A String&quot;,
24383 ],
24384 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
24385 &quot;A String&quot;,
24386 ],
24387 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
24388 # parameters will be excluded. Either specify `includedQueryParameters`
24389 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
24390 # encoded and not treated as delimiters.
24391 &quot;A String&quot;,
24392 ],
24393 },
24394 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
24395 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
24396 &quot;clientTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
24397 # content. This is used to clamp the max-age (or Expires) value sent to the
24398 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
24399 # is used for the response max-age directive, along with a &quot;public&quot;
24400 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
24401 # clamps the max-age from the origin (if specified), or else sets the
24402 # response max-age directive to the lesser of the `clientTtl` and
24403 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
24404 # present. The maximum allowed value is 31,622,400s (1 year). If not
24405 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
24406 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
24407 # `USE_ORIGIN_HEADERS`.
24408 # as a count of seconds and fractions of seconds at nanosecond
24409 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
24410 # or &quot;month&quot;. Range is approximately 10,000 years.
24411 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
24412 # Durations less than one second are represented with a 0
24413 # `seconds` field and a positive `nanos` field. Must be from 0
24414 # to 999,999,999 inclusive.
24415 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
24416 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
24417 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
24418 },
24419 &quot;defaultTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
24420 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
24421 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
24422 # greater than that of `maxTtl`. When the `cacheMode` is set to
24423 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
24424 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
24425 # accessed objects may be evicted from the cache before the defined TTL. If
24426 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
24427 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
24428 # `USE_ORIGIN_HEADERS`.
24429 # as a count of seconds and fractions of seconds at nanosecond
24430 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
24431 # or &quot;month&quot;. Range is approximately 10,000 years.
24432 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
24433 # Durations less than one second are represented with a 0
24434 # `seconds` field and a positive `nanos` field. Must be from 0
24435 # to 999,999,999 inclusive.
24436 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
24437 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
24438 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
24439 },
24440 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
24441 # attempt to set a max-age or s-maxage higher than this, or an Expires header
24442 # more than `maxTtl` seconds in the future will be capped at the value of
24443 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
24444 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
24445 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
24446 # Infrequently accessed objects may be evicted from the cache before the
24447 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
24448 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
24449 # mode.
24450 # as a count of seconds and fractions of seconds at nanosecond
24451 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
24452 # or &quot;month&quot;. Range is approximately 10,000 years.
24453 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
24454 # Durations less than one second are represented with a 0
24455 # `seconds` field and a positive `nanos` field. Must be from 0
24456 # to 999,999,999 inclusive.
24457 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
24458 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
24459 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
24460 },
24461 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
24462 # to apply fine-grained caching for common errors or redirects.
24463 # This can reduce the load on your origin and improve end-user
24464 # experience by reducing response latency.
24465 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
24466 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
24467 # the specified response code that lack any Cache-Control, Expires, or
24468 # Pragma: no-cache directives. When the `cacheMode` is set to
24469 # `FORCE_CACHE_ALL`, negative caching applies to all responses
24470 # with the specified response code, and overrides any caching headers. By
24471 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
24472 #
24473 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
24474 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
24475 # * 405 (Method Not Found), 501 (Not Implemented): 60s
24476 #
24477 # These defaults can be overridden in `negativeCachingPolicy`.
24478 # If not specified, Cloud CDN applies negative caching by default.
24479 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
24480 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
24481 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
24482 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
24483 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
24484 # all response codes that you wish to cache. Cloud CDN will not apply any
24485 # default negative caching when a policy exists.
24486 { # Specify CDN TTLs for response error codes.
24487 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
24488 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
24489 # specified as values, and you cannot specify a status code more than
24490 # once.
24491 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
24492 # corresponding status code.
24493 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
24494 # objects may be evicted from the cache before the defined TTL.
24495 # as a count of seconds and fractions of seconds at nanosecond
24496 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
24497 # or &quot;month&quot;. Range is approximately 10,000 years.
24498 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
24499 # Durations less than one second are represented with a 0
24500 # `seconds` field and a positive `nanos` field. Must be from 0
24501 # to 999,999,999 inclusive.
24502 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
24503 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
24504 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
24505 },
24506 },
24507 ],
24508 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
24509 # requests into a small number of requests to the origin. If not specified,
24510 # Cloud CDN applies request coalescing by default.
24511 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
24512 # content with the origin, or when an error is encountered when refreshing
24513 # the cache.
24514 # This setting defines the default &quot;max-stale&quot; duration for any cached
24515 # responses that do not specify a max-stale directive. Stale responses that
24516 # exceed the TTL configured here will not be served. The default limit
24517 # (max-stale) is 86400s (1 day), which will allow stale content to be
24518 # served up to this limit beyond the max-age (or s-maxage) of a cached
24519 # response.
24520 # The maximum allowed value is 604800 (1 week).
24521 # Set this to zero (0) to disable serve-while-stale.
24522 # as a count of seconds and fractions of seconds at nanosecond
24523 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
24524 # or &quot;month&quot;. Range is approximately 10,000 years.
24525 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
24526 # Durations less than one second are represented with a 0
24527 # `seconds` field and a positive `nanos` field. Must be from 0
24528 # to 999,999,999 inclusive.
24529 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
24530 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
24531 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
24532 },
24533 },
24534 &quot;corsPolicy&quot;: { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
24535 # information about the W3C recommendation for cross-origin resource sharing
24536 # (CORS), see Fetch API Living
24537 # Standard.
24538 #
24539 # Not supported when the URL map is bound to a target gRPC proxy.
24540 # information about the W3C recommendation for cross-origin resource sharing
24541 # (CORS), see Fetch API Living
24542 # Standard.
24543 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
24544 # indicates that
24545 # the actual request can include user credentials. This field translates to
24546 # the Access-Control-Allow-Credentials header.
24547 #
24548 # Default is false.
24549 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
24550 # header.
24551 &quot;A String&quot;,
24552 ],
24553 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
24554 # header.
24555 &quot;A String&quot;,
24556 ],
24557 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
24558 # more information, see regular expression syntax.
24559 #
24560 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
24561 #
24562 # Regular expressions can only be used when the loadBalancingScheme is
24563 # set to INTERNAL_SELF_MANAGED.
24564 &quot;A String&quot;,
24565 ],
24566 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
24567 #
24568 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
24569 &quot;A String&quot;,
24570 ],
24571 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
24572 # The default value is false, which indicates that the CORS
24573 # policy is in effect.
24574 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
24575 # header.
24576 &quot;A String&quot;,
24577 ],
24578 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
24579 # seconds. This field translates to the Access-Control-Max-Age
24580 # header.
24581 },
24582 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
24583 # the resiliency of clients to backend service failure. As part of fault
24584 # injection, when clients send requests to a backend service, delays can be
24585 # introduced by a load balancer on a percentage of requests before sending
24586 # those requests to the backend service. Similarly requests from clients can
24587 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
24588 # that are configured with a fault_injection_policy if:
24589 # 1. The traffic is generated by fault injection AND
24590 # 2. The fault injection is not a delay fault injection.
24591 # Fault injection is not supported with the classic Application Load Balancer
24592 # . To see which load balancers support fault injection,
24593 # see Load
24594 # balancing: Routing and traffic management features.
24595 # the resiliency of clients to backend service failure. As part of fault
24596 # injection, when clients send requests to a backend service, delays can be
24597 # introduced by the load balancer on a percentage of requests before sending
24598 # those request to the backend service. Similarly requests from clients can be
24599 # aborted by the load balancer for a percentage of requests.
24600 &quot;abort&quot;: { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
24601 # injection.
24602 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
24603 #
24604 # The value must be from 200 to 599 inclusive.
24605 #
24606 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
24607 # according to this
24608 # mapping table. HTTP status 200 is mapped to gRPC status
24609 # UNKNOWN. Injecting an OK status is currently not supported by
24610 # Traffic Director.
24611 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
24612 # that is aborted as part of fault injection.
24613 #
24614 # The value must be from 0.0 to 100.0 inclusive.
24615 },
24616 &quot;delay&quot;: { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
24617 # injection, before being sent to a backend service.
24618 # request to the backend service as part of fault injection.
24619 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
24620 # as a count of seconds and fractions of seconds at nanosecond
24621 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
24622 # or &quot;month&quot;. Range is approximately 10,000 years.
24623 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
24624 # Durations less than one second are represented with a 0
24625 # `seconds` field and a positive `nanos` field. Must be from 0
24626 # to 999,999,999 inclusive.
24627 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
24628 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
24629 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
24630 },
24631 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
24632 # which a delay is introduced as part of fault injection.
24633 #
24634 # The value must be from 0.0 to 100.0 inclusive.
24635 },
24636 },
24637 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
24638 # Unlike the timeout field where the timeout duration starts
24639 # from the time the request has been fully processed (known as*end-of-stream*),
24640 # the duration in this field is computed from the beginning of the stream
24641 # until the response has been processed, including all retries. A
24642 # stream that does not complete in this duration is closed.
24643 #
24644 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
24645 # with the route.
24646 #
24647 # This field is only allowed if the Url map is used with backend services
24648 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
24649 # as a count of seconds and fractions of seconds at nanosecond
24650 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
24651 # or &quot;month&quot;. Range is approximately 10,000 years.
24652 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
24653 # Durations less than one second are represented with a 0
24654 # `seconds` field and a positive `nanos` field. Must be from 0
24655 # to 999,999,999 inclusive.
24656 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
24657 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
24658 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
24659 },
24660 &quot;requestMirrorPolicy&quot;: { # A policy that specifies how requests intended for the route&#x27;s backends # Specifies the policy on how requests intended for the route&#x27;s backends
24661 # are shadowed to a separate mirrored backend service. The load balancer does
24662 # not wait for responses from the shadow service. Before sending traffic
24663 # to the shadow service, the host / authority header is suffixed with-shadow.
24664 #
24665 # Not supported when the URL map is bound to a target gRPC proxy that
24666 # has the validateForProxyless field set to true.
24667 # are shadowed to a separate mirrored backend service. The load balancer
24668 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
24669 # to the shadow service, the host or authority header is suffixed with-shadow.
24670 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
24671 # mirrored to.
24672 #
24673 # The backend service configured for a mirroring
24674 # policy must reference backends that are of the same type as the original
24675 # backend service matched in the URL map.
24676 #
24677 # Serverless NEG backends are not currently supported as a mirrored
24678 # backend service.
24679 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
24680 },
24681 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
24682 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
24683 # If not specified, defaults to 1.
24684 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
24685 #
24686 # If not specified, will use the timeout set in theHttpRouteAction field.
24687 # If timeout in the HttpRouteAction field is not set, this field
24688 # uses the largest timeout
24689 # among all backend services associated with the route.
24690 #
24691 # Not supported when the URL map is bound to a target gRPC proxy that
24692 # has the validateForProxyless field set to true.
24693 # as a count of seconds and fractions of seconds at nanosecond
24694 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
24695 # or &quot;month&quot;. Range is approximately 10,000 years.
24696 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
24697 # Durations less than one second are represented with a 0
24698 # `seconds` field and a positive `nanos` field. Must be from 0
24699 # to 999,999,999 inclusive.
24700 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
24701 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
24702 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
24703 },
24704 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
24705 # values are:
24706 #
24707 # - 5xx: retry is attempted if the instance or endpoint
24708 # responds with any 5xx response code, or if the instance or
24709 # endpoint does not respond at all. For example, disconnects, reset, read
24710 # timeout, connection failure, and refused streams.
24711 # - gateway-error: Similar to 5xx, but only
24712 # applies to response codes 502, 503 or504.
24713 # - connect-failure: a retry is attempted on failures
24714 # connecting to the instance or endpoint. For example, connection
24715 # timeouts.
24716 # - retriable-4xx: a retry is attempted if the instance
24717 # or endpoint responds with a 4xx response code.
24718 # The only error that you can retry is error code 409.
24719 # - refused-stream: a retry is attempted if the instance
24720 # or endpoint resets the stream with a REFUSED_STREAM error
24721 # code. This reset type indicates that it is safe to retry.
24722 # - cancelled: a retry is attempted if the gRPC status
24723 # code in the response header is set to cancelled.
24724 # - deadline-exceeded: a retry is attempted if the gRPC
24725 # status code in the response header is set todeadline-exceeded.
24726 # - internal: a retry is attempted if the gRPC
24727 # status code in the response header is set tointernal.
24728 # - resource-exhausted: a retry is attempted if the gRPC
24729 # status code in the response header is set toresource-exhausted.
24730 # - unavailable: a retry is attempted if the gRPC
24731 # status code in the response header is set tounavailable.
24732 #
24733 # Only the following codes are supported when the URL map is bound to
24734 # target gRPC proxy that has validateForProxyless field set to true.
24735 #
24736 # - cancelled
24737 # - deadline-exceeded
24738 # - internal
24739 # - resource-exhausted
24740 # - unavailable
24741 &quot;A String&quot;,
24742 ],
24743 },
24744 &quot;timeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
24745 # time the request has been fully processed (known as *end-of-stream*)
24746 # up until the response has been processed. Timeout includes
24747 # all retries.
24748 #
24749 # If not specified, this field uses the largest timeout among all backend
24750 # services associated with the route.
24751 #
24752 # Not supported when the URL map is bound to a target gRPC proxy that
24753 # has validateForProxyless field set to true.
24754 # as a count of seconds and fractions of seconds at nanosecond
24755 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
24756 # or &quot;month&quot;. Range is approximately 10,000 years.
24757 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
24758 # Durations less than one second are represented with a 0
24759 # `seconds` field and a positive `nanos` field. Must be from 0
24760 # to 999,999,999 inclusive.
24761 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
24762 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
24763 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
24764 },
24765 &quot;urlRewrite&quot;: { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
24766 # to the matched service.
24767 #
24768 # urlRewrite is the only action supported in UrlMaps
24769 # for classic Application Load Balancers.
24770 #
24771 # Not supported when the URL map is bound to a target gRPC proxy that
24772 # has the validateForProxyless field set to true.
24773 # backend service.
24774 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
24775 # host header is replaced with contents of hostRewrite.
24776 #
24777 # The value must be from 1 to 255 characters.
24778 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
24779 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
24780 #
24781 # The value must be from 1 to 1024 characters.
24782 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
24783 # header) using the HTTP template syntax.
24784 #
24785 # A corresponding
24786 # path_template_match must be specified. Any template variables must exist in
24787 # the path_template_match field.
24788 #
24789 #
24790 # - -At least one variable must be specified in the path_template_match
24791 # field
24792 # - You can omit variables from the rewritten URL
24793 # - The * and ** operators cannot be matched
24794 # unless they have a corresponding variable name - e.g.
24795 # {format=*} or {var=**}.
24796 #
24797 # For example, a path_template_match of /static/{format=**}
24798 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
24799 # rewrite, so that /{country}/{format}/{suffix=**} can be
24800 # rewritten as /content/{format}/{country}/{suffix}.
24801 #
24802 # At least
24803 # one non-empty routeRules[].matchRules[].path_template_match is
24804 # required.
24805 #
24806 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
24807 },
24808 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
24809 # occurs. The weights determine the fraction of traffic that flows to
24810 # their corresponding backend service. If all traffic needs to
24811 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
24812 #
24813 # After a backend service is identified and before forwarding
24814 # the request to
24815 # the backend service, advanced routing actions such as URL rewrites and
24816 # header transformations are applied depending on additional settings
24817 # specified in this HttpRouteAction.
24818 { # In contrast to a single BackendService in
24819 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
24820 # multiple backend services. The volume of traffic for each
24821 # backend service is proportional to the weight specified
24822 # in each WeightedBackendService
24823 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
24824 # resource. Before
24825 # forwarding the request to backendService, the load balancer
24826 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
24827 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
24828 # effect for the selected backendService.
24829 #
24830 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
24831 #
24832 # headerAction is not supported for load balancers that have
24833 # their loadBalancingScheme set to EXTERNAL.
24834 #
24835 # Not supported when the URL map is bound to a target gRPC proxy that
24836 # has validateForProxyless field set to true.
24837 # the request is passed along to the selected backendService.
24838 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
24839 { # Specification determining how headers are added to requests or responses.
24840 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
24841 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
24842 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
24843 # that already
24844 # exist for the header. If true, headerValue is set for the
24845 # header, discarding any values that were set for that header.
24846 #
24847 # The default value is true,
24848 # unless a variable is present in headerValue,
24849 # in which case the default value is false.
24850 # .
24851 },
24852 ],
24853 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
24854 # request before forwarding the request to the backendService.
24855 &quot;A String&quot;,
24856 ],
24857 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
24858 # client.
24859 { # Specification determining how headers are added to requests or responses.
24860 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
24861 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
24862 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
24863 # that already
24864 # exist for the header. If true, headerValue is set for the
24865 # header, discarding any values that were set for that header.
24866 #
24867 # The default value is true,
24868 # unless a variable is present in headerValue,
24869 # in which case the default value is false.
24870 # .
24871 },
24872 ],
24873 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
24874 # response before sending the response back to the client.
24875 &quot;A String&quot;,
24876 ],
24877 },
24878 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
24879 # computed asweight / (sum of all weightedBackendService weights in routeAction).
24880 #
24881 # The selection of a backend service is determined only for new traffic.
24882 # Once a user&#x27;s request has been directed to a backend service,
24883 # subsequent requests are sent to the same backend service as
24884 # determined by the backend service&#x27;s session affinity policy.
24885 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
24886 # splitting. If you do, the weighted traffic splitting configuration takes
24887 # precedence.
24888 #
24889 # The value must be from 0 to 1000.
24890 },
24891 ],
24892 },
24893 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource. This
24894 # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
24895 # matched. For example, the
24896 # following are all valid URLs to a BackendService resource:
24897 #
24898 #
24899 # - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
24900 # - compute/v1/projects/project/global/backendServices/backendService
24901 # - global/backendServices/backendService
24902 #
24903 #
24904 # If defaultRouteAction is also specified, advanced
24905 # routing actions, such as URL rewrites, take effect before sending the
24906 # request to the backend.
24907 #
24908 #
24909 # Only one of defaultUrlRedirect, defaultService
24910 # or defaultRouteAction.weightedBackendService can be set.
24911 #
24912 #
24913 # Authorization requires one or more of the following Google IAM permissions on the
24914 # specified resource default_service:
24915 #
24916 #
24917 # - compute.backendBuckets.use
24918 # - compute.backendServices.use
24919 &quot;defaultUrlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When none of the specified pathRules orrouteRules match, the request is redirected to a URL specified
24920 # by defaultUrlRedirect.
24921 #
24922 #
24923 # Only one of defaultUrlRedirect, defaultService
24924 # or defaultRouteAction.weightedBackendService can be set.
24925 #
24926 #
24927 # Not supported when the URL map is bound to a target gRPC proxy.
24928 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
24929 # was supplied in the request.
24930 #
24931 # The value must be from 1 to 255
24932 # characters.
24933 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
24934 # set to HTTPS.
24935 # If set to false, the URL scheme of the redirected request
24936 # remains the same as that of the request.
24937 #
24938 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
24939 #
24940 # The default is set to false.
24941 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
24942 # that was supplied in the request.
24943 #
24944 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
24945 # supplied, the path of the original request is used for the redirect.
24946 #
24947 # The value must be from 1 to 1024 characters.
24948 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
24949 # the HttpRouteRuleMatch, retaining the remaining portion
24950 # of the URL before redirecting the request.
24951 #
24952 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
24953 # supplied, the path of the original request is used for the redirect.
24954 #
24955 # The value must be from 1 to 1024 characters.
24956 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
24957 #
24958 # Supported values are:
24959 #
24960 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
24961 # to 301.
24962 # - FOUND, which corresponds to 302.
24963 # - SEE_OTHER which corresponds to 303.
24964 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
24965 # method is retained.
24966 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
24967 # method is retained.
24968 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
24969 # URL is
24970 # removed before redirecting the request. If set to false, the
24971 # query portion of the original URL is retained.
24972 #
24973 # The default is set to false.
24974 },
24975 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
24976 # create the resource.
24977 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
24978 # for the selected backend service.
24979 #
24980 # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
24981 #
24982 # HeaderAction is not supported for load balancers
24983 # that have
24984 # their loadBalancingScheme set to EXTERNAL.
24985 #
24986 # Not supported when the URL map is bound to a target gRPC proxy that
24987 # has validateForProxyless field set to true.
24988 # the request is passed along to the selected backendService.
24989 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
24990 { # Specification determining how headers are added to requests or responses.
24991 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
24992 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
24993 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
24994 # that already
24995 # exist for the header. If true, headerValue is set for the
24996 # header, discarding any values that were set for that header.
24997 #
24998 # The default value is true,
24999 # unless a variable is present in headerValue,
25000 # in which case the default value is false.
25001 # .
25002 },
25003 ],
25004 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
25005 # request before forwarding the request to the backendService.
25006 &quot;A String&quot;,
25007 ],
25008 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
25009 # client.
25010 { # Specification determining how headers are added to requests or responses.
25011 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
25012 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
25013 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
25014 # that already
25015 # exist for the header. If true, headerValue is set for the
25016 # header, discarding any values that were set for that header.
25017 #
25018 # The default value is true,
25019 # unless a variable is present in headerValue,
25020 # in which case the default value is false.
25021 # .
25022 },
25023 ],
25024 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
25025 # response before sending the response back to the client.
25026 &quot;A String&quot;,
25027 ],
25028 },
25029 &quot;name&quot;: &quot;A String&quot;, # The name to which this PathMatcher is referred by theHostRule.
25030 &quot;pathRules&quot;: [ # The list of path rules. Use this list instead of routeRules
25031 # when routing based on simple path matching is all that&#x27;s required. A path
25032 # rule can only include a wildcard character (*) after a
25033 # forward slash character (&quot;/&quot;).
25034 #
25035 # The order by which path rules are specified does not matter.
25036 # Matches are always done on the longest-path-first basis.
25037 #
25038 # For example: a pathRule with a path /a/b/c/* will match
25039 # before /a/b/* irrespective of the order in which those paths appear in this
25040 # list.
25041 #
25042 # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
25043 { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
25044 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
25045 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
25046 #
25047 # If a policy for an
25048 # error code is not configured for the PathRule, a policy for
25049 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
25050 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
25051 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
25052 # effect.
25053 #
25054 # For example, consider a UrlMap with the following configuration:
25055 #
25056 #
25057 # - UrlMap.defaultCustomErrorResponsePolicy are configured
25058 # with policies for 5xx and 4xx errors
25059 # - A PathRule for /coming_soon/ is configured for the error
25060 # code 404.
25061 #
25062 # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher&#x27;s policy
25063 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
25064 # the policy in PathRule.customErrorResponsePolicy takes
25065 # effect. If any of the requests in this example encounter a 500
25066 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
25067 #
25068 # customErrorResponsePolicy is supported only for
25069 # global external Application Load Balancers.
25070 # backend service or backend bucket responds with an error.
25071 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
25072 #
25073 # In a given policy, if you specify rules for both a range of error codes
25074 # as well as rules for specific error codes then rules with specific error
25075 # codes have a higher priority. For example, assume that you configure a rule
25076 # for 401 (Un-authorized) code, and another for all 4 series
25077 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
25078 # However if the backend service returns a 403, the rule for4xx takes effect.
25079 { # Specifies the mapping between the response code that will be returned along
25080 # with the custom error content and the response code returned by the backend
25081 # service.
25082 &quot;matchResponseCodes&quot;: [ # Valid values include:
25083 #
25084 #
25085 # - A number between 400 and 599: For example
25086 # 401 or 503, in which case the load balancer
25087 # applies the policy if the error code exactly matches this value.
25088 # - 5xx: Load Balancer will apply the policy if the
25089 # backend service responds with any response code in the range of
25090 # 500 to 599.
25091 # - 4xx: Load
25092 # Balancer will apply the policy if the backend service responds with any
25093 # response code in the range of 400 to
25094 # 499.
25095 #
25096 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
25097 &quot;A String&quot;,
25098 ],
25099 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
25100 # error content. If overrideResponseCode is not supplied, the
25101 # same response code returned by the original backend bucket or backend
25102 # service is returned to the client.
25103 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
25104 #
25105 # path must start
25106 # with a leading slash. path cannot have trailing slashes.
25107 #
25108 # If the file is not available in backendBucket or the
25109 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
25110 #
25111 # The value must
25112 # be from 1 to 1024 characters
25113 },
25114 ],
25115 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
25116 # contains the custom error content. Examples are:
25117 #
25118 #
25119 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
25120 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
25121 # - global/backendBuckets/myBackendBucket
25122 #
25123 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
25124 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
25125 #
25126 # If load balancer cannot reach
25127 # the backendBucket, a simple Not Found Error will
25128 # be returned, with the original response code (oroverrideResponseCode if configured).
25129 #
25130 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
25131 },
25132 &quot;paths&quot;: [ # The list of path patterns to match. Each must start with /
25133 # and the only place a * is allowed is at the end following
25134 # a /. The string fed to the path matcher does not include
25135 # any text after the first ? or #, and
25136 # those chars are not allowed here.
25137 &quot;A String&quot;,
25138 ],
25139 &quot;routeAction&quot;: { # In response to a matching path, the load balancer
25140 # performs advanced routing actions, such as URL rewrites and header
25141 # transformations, before forwarding the request to the selected
25142 # backend.
25143 #
25144 #
25145 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
25146 #
25147 #
25148 # URL maps for classic Application Load Balancers only support
25149 # the urlRewrite action within a path rule&#x27;srouteAction.
25150 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
25151 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
25152 # property must be specified. This policy cannot be specified if any target
25153 # backend has Identity-Aware Proxy enabled.
25154 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
25155 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
25156 # header names can be specified. The cache is bypassed for all `cacheMode`
25157 # values.
25158 &quot;A String&quot;,
25159 ],
25160 &quot;cacheKeyPolicy&quot;: { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
25161 # on the backend type: for Backend Services, the complete request URI is
25162 # used; for Backend Buckets, the request URI is used without the protocol or
25163 # host, and only query parameters known to Cloud Storage are included.
25164 # Policy defined on Route Action.
25165 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
25166 # parameters will be included. Either specify `excludedQueryParameters`
25167 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
25168 # encoded and not treated as delimiters.
25169 #
25170 # Note: This field applies to routes that use backend services. Attempting
25171 # to set it on a route that points exclusively to Backend Buckets will
25172 # result in a configuration error. For routes that point to a Backend
25173 # Bucket, use `includedQueryParameters` to define which parameters should
25174 # be part of the cache key.
25175 &quot;A String&quot;,
25176 ],
25177 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
25178 #
25179 # Note: This setting is only applicable to routes that use a Backend
25180 # Service. It does not affect requests served by a Backend Bucket, as the
25181 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
25182 # it on a route that points exclusively to Backend Buckets will result in a
25183 # configuration error.
25184 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
25185 #
25186 # Note: This setting is only applicable to routes that use a Backend
25187 # Service. It does not affect requests served by a Backend Bucket, as the
25188 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
25189 # set on a route that points exclusively to Backend Buckets will result in
25190 # a configuration error.
25191 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
25192 # `includedQueryParameters` and `excludedQueryParameters`. If neither
25193 # is set, the entire query string will be included. If false, the query
25194 # string will be excluded from the cache key entirely.
25195 #
25196 # Note: This field applies to routes that use backend services. Attempting
25197 # to set it on a route that points exclusively to Backend Buckets will
25198 # result in a configuration error. For routes that point to a Backend
25199 # Bucket, use `includedQueryParameters` to define which parameters should
25200 # be part of the cache key.
25201 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
25202 # The name=value pair will be used in the cache key Cloud CDN generates.
25203 #
25204 # Note: This setting is only applicable to routes that use a Backend
25205 # Service. It does not affect requests served by a Backend Bucket.
25206 # Attempting to set it on a route that points exclusively to Backend
25207 # Buckets will result in a configuration error. Up to 5 cookie names can be
25208 # specified.
25209 &quot;A String&quot;,
25210 ],
25211 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
25212 &quot;A String&quot;,
25213 ],
25214 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
25215 # parameters will be excluded. Either specify `includedQueryParameters`
25216 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
25217 # encoded and not treated as delimiters.
25218 &quot;A String&quot;,
25219 ],
25220 },
25221 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
25222 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
25223 &quot;clientTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
25224 # content. This is used to clamp the max-age (or Expires) value sent to the
25225 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
25226 # is used for the response max-age directive, along with a &quot;public&quot;
25227 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
25228 # clamps the max-age from the origin (if specified), or else sets the
25229 # response max-age directive to the lesser of the `clientTtl` and
25230 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
25231 # present. The maximum allowed value is 31,622,400s (1 year). If not
25232 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
25233 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
25234 # `USE_ORIGIN_HEADERS`.
25235 # as a count of seconds and fractions of seconds at nanosecond
25236 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
25237 # or &quot;month&quot;. Range is approximately 10,000 years.
25238 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
25239 # Durations less than one second are represented with a 0
25240 # `seconds` field and a positive `nanos` field. Must be from 0
25241 # to 999,999,999 inclusive.
25242 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
25243 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
25244 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
25245 },
25246 &quot;defaultTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
25247 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
25248 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
25249 # greater than that of `maxTtl`. When the `cacheMode` is set to
25250 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
25251 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
25252 # accessed objects may be evicted from the cache before the defined TTL. If
25253 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
25254 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
25255 # `USE_ORIGIN_HEADERS`.
25256 # as a count of seconds and fractions of seconds at nanosecond
25257 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
25258 # or &quot;month&quot;. Range is approximately 10,000 years.
25259 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
25260 # Durations less than one second are represented with a 0
25261 # `seconds` field and a positive `nanos` field. Must be from 0
25262 # to 999,999,999 inclusive.
25263 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
25264 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
25265 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
25266 },
25267 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
25268 # attempt to set a max-age or s-maxage higher than this, or an Expires header
25269 # more than `maxTtl` seconds in the future will be capped at the value of
25270 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
25271 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
25272 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
25273 # Infrequently accessed objects may be evicted from the cache before the
25274 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
25275 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
25276 # mode.
25277 # as a count of seconds and fractions of seconds at nanosecond
25278 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
25279 # or &quot;month&quot;. Range is approximately 10,000 years.
25280 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
25281 # Durations less than one second are represented with a 0
25282 # `seconds` field and a positive `nanos` field. Must be from 0
25283 # to 999,999,999 inclusive.
25284 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
25285 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
25286 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
25287 },
25288 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
25289 # to apply fine-grained caching for common errors or redirects.
25290 # This can reduce the load on your origin and improve end-user
25291 # experience by reducing response latency.
25292 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
25293 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
25294 # the specified response code that lack any Cache-Control, Expires, or
25295 # Pragma: no-cache directives. When the `cacheMode` is set to
25296 # `FORCE_CACHE_ALL`, negative caching applies to all responses
25297 # with the specified response code, and overrides any caching headers. By
25298 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
25299 #
25300 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
25301 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
25302 # * 405 (Method Not Found), 501 (Not Implemented): 60s
25303 #
25304 # These defaults can be overridden in `negativeCachingPolicy`.
25305 # If not specified, Cloud CDN applies negative caching by default.
25306 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
25307 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
25308 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
25309 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
25310 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
25311 # all response codes that you wish to cache. Cloud CDN will not apply any
25312 # default negative caching when a policy exists.
25313 { # Specify CDN TTLs for response error codes.
25314 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
25315 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
25316 # specified as values, and you cannot specify a status code more than
25317 # once.
25318 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
25319 # corresponding status code.
25320 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
25321 # objects may be evicted from the cache before the defined TTL.
25322 # as a count of seconds and fractions of seconds at nanosecond
25323 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
25324 # or &quot;month&quot;. Range is approximately 10,000 years.
25325 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
25326 # Durations less than one second are represented with a 0
25327 # `seconds` field and a positive `nanos` field. Must be from 0
25328 # to 999,999,999 inclusive.
25329 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
25330 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
25331 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
25332 },
25333 },
25334 ],
25335 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
25336 # requests into a small number of requests to the origin. If not specified,
25337 # Cloud CDN applies request coalescing by default.
25338 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
25339 # content with the origin, or when an error is encountered when refreshing
25340 # the cache.
25341 # This setting defines the default &quot;max-stale&quot; duration for any cached
25342 # responses that do not specify a max-stale directive. Stale responses that
25343 # exceed the TTL configured here will not be served. The default limit
25344 # (max-stale) is 86400s (1 day), which will allow stale content to be
25345 # served up to this limit beyond the max-age (or s-maxage) of a cached
25346 # response.
25347 # The maximum allowed value is 604800 (1 week).
25348 # Set this to zero (0) to disable serve-while-stale.
25349 # as a count of seconds and fractions of seconds at nanosecond
25350 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
25351 # or &quot;month&quot;. Range is approximately 10,000 years.
25352 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
25353 # Durations less than one second are represented with a 0
25354 # `seconds` field and a positive `nanos` field. Must be from 0
25355 # to 999,999,999 inclusive.
25356 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
25357 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
25358 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
25359 },
25360 },
25361 &quot;corsPolicy&quot;: { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
25362 # information about the W3C recommendation for cross-origin resource sharing
25363 # (CORS), see Fetch API Living
25364 # Standard.
25365 #
25366 # Not supported when the URL map is bound to a target gRPC proxy.
25367 # information about the W3C recommendation for cross-origin resource sharing
25368 # (CORS), see Fetch API Living
25369 # Standard.
25370 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
25371 # indicates that
25372 # the actual request can include user credentials. This field translates to
25373 # the Access-Control-Allow-Credentials header.
25374 #
25375 # Default is false.
25376 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
25377 # header.
25378 &quot;A String&quot;,
25379 ],
25380 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
25381 # header.
25382 &quot;A String&quot;,
25383 ],
25384 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
25385 # more information, see regular expression syntax.
25386 #
25387 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
25388 #
25389 # Regular expressions can only be used when the loadBalancingScheme is
25390 # set to INTERNAL_SELF_MANAGED.
25391 &quot;A String&quot;,
25392 ],
25393 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
25394 #
25395 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
25396 &quot;A String&quot;,
25397 ],
25398 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
25399 # The default value is false, which indicates that the CORS
25400 # policy is in effect.
25401 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
25402 # header.
25403 &quot;A String&quot;,
25404 ],
25405 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
25406 # seconds. This field translates to the Access-Control-Max-Age
25407 # header.
25408 },
25409 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
25410 # the resiliency of clients to backend service failure. As part of fault
25411 # injection, when clients send requests to a backend service, delays can be
25412 # introduced by a load balancer on a percentage of requests before sending
25413 # those requests to the backend service. Similarly requests from clients can
25414 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
25415 # that are configured with a fault_injection_policy if:
25416 # 1. The traffic is generated by fault injection AND
25417 # 2. The fault injection is not a delay fault injection.
25418 # Fault injection is not supported with the classic Application Load Balancer
25419 # . To see which load balancers support fault injection,
25420 # see Load
25421 # balancing: Routing and traffic management features.
25422 # the resiliency of clients to backend service failure. As part of fault
25423 # injection, when clients send requests to a backend service, delays can be
25424 # introduced by the load balancer on a percentage of requests before sending
25425 # those request to the backend service. Similarly requests from clients can be
25426 # aborted by the load balancer for a percentage of requests.
25427 &quot;abort&quot;: { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
25428 # injection.
25429 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
25430 #
25431 # The value must be from 200 to 599 inclusive.
25432 #
25433 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
25434 # according to this
25435 # mapping table. HTTP status 200 is mapped to gRPC status
25436 # UNKNOWN. Injecting an OK status is currently not supported by
25437 # Traffic Director.
25438 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
25439 # that is aborted as part of fault injection.
25440 #
25441 # The value must be from 0.0 to 100.0 inclusive.
25442 },
25443 &quot;delay&quot;: { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
25444 # injection, before being sent to a backend service.
25445 # request to the backend service as part of fault injection.
25446 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
25447 # as a count of seconds and fractions of seconds at nanosecond
25448 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
25449 # or &quot;month&quot;. Range is approximately 10,000 years.
25450 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
25451 # Durations less than one second are represented with a 0
25452 # `seconds` field and a positive `nanos` field. Must be from 0
25453 # to 999,999,999 inclusive.
25454 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
25455 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
25456 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
25457 },
25458 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
25459 # which a delay is introduced as part of fault injection.
25460 #
25461 # The value must be from 0.0 to 100.0 inclusive.
25462 },
25463 },
25464 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
25465 # Unlike the timeout field where the timeout duration starts
25466 # from the time the request has been fully processed (known as*end-of-stream*),
25467 # the duration in this field is computed from the beginning of the stream
25468 # until the response has been processed, including all retries. A
25469 # stream that does not complete in this duration is closed.
25470 #
25471 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
25472 # with the route.
25473 #
25474 # This field is only allowed if the Url map is used with backend services
25475 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
25476 # as a count of seconds and fractions of seconds at nanosecond
25477 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
25478 # or &quot;month&quot;. Range is approximately 10,000 years.
25479 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
25480 # Durations less than one second are represented with a 0
25481 # `seconds` field and a positive `nanos` field. Must be from 0
25482 # to 999,999,999 inclusive.
25483 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
25484 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
25485 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
25486 },
25487 &quot;requestMirrorPolicy&quot;: { # A policy that specifies how requests intended for the route&#x27;s backends # Specifies the policy on how requests intended for the route&#x27;s backends
25488 # are shadowed to a separate mirrored backend service. The load balancer does
25489 # not wait for responses from the shadow service. Before sending traffic
25490 # to the shadow service, the host / authority header is suffixed with-shadow.
25491 #
25492 # Not supported when the URL map is bound to a target gRPC proxy that
25493 # has the validateForProxyless field set to true.
25494 # are shadowed to a separate mirrored backend service. The load balancer
25495 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
25496 # to the shadow service, the host or authority header is suffixed with-shadow.
25497 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
25498 # mirrored to.
25499 #
25500 # The backend service configured for a mirroring
25501 # policy must reference backends that are of the same type as the original
25502 # backend service matched in the URL map.
25503 #
25504 # Serverless NEG backends are not currently supported as a mirrored
25505 # backend service.
25506 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
25507 },
25508 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
25509 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
25510 # If not specified, defaults to 1.
25511 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
25512 #
25513 # If not specified, will use the timeout set in theHttpRouteAction field.
25514 # If timeout in the HttpRouteAction field is not set, this field
25515 # uses the largest timeout
25516 # among all backend services associated with the route.
25517 #
25518 # Not supported when the URL map is bound to a target gRPC proxy that
25519 # has the validateForProxyless field set to true.
25520 # as a count of seconds and fractions of seconds at nanosecond
25521 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
25522 # or &quot;month&quot;. Range is approximately 10,000 years.
25523 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
25524 # Durations less than one second are represented with a 0
25525 # `seconds` field and a positive `nanos` field. Must be from 0
25526 # to 999,999,999 inclusive.
25527 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
25528 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
25529 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
25530 },
25531 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
25532 # values are:
25533 #
25534 # - 5xx: retry is attempted if the instance or endpoint
25535 # responds with any 5xx response code, or if the instance or
25536 # endpoint does not respond at all. For example, disconnects, reset, read
25537 # timeout, connection failure, and refused streams.
25538 # - gateway-error: Similar to 5xx, but only
25539 # applies to response codes 502, 503 or504.
25540 # - connect-failure: a retry is attempted on failures
25541 # connecting to the instance or endpoint. For example, connection
25542 # timeouts.
25543 # - retriable-4xx: a retry is attempted if the instance
25544 # or endpoint responds with a 4xx response code.
25545 # The only error that you can retry is error code 409.
25546 # - refused-stream: a retry is attempted if the instance
25547 # or endpoint resets the stream with a REFUSED_STREAM error
25548 # code. This reset type indicates that it is safe to retry.
25549 # - cancelled: a retry is attempted if the gRPC status
25550 # code in the response header is set to cancelled.
25551 # - deadline-exceeded: a retry is attempted if the gRPC
25552 # status code in the response header is set todeadline-exceeded.
25553 # - internal: a retry is attempted if the gRPC
25554 # status code in the response header is set tointernal.
25555 # - resource-exhausted: a retry is attempted if the gRPC
25556 # status code in the response header is set toresource-exhausted.
25557 # - unavailable: a retry is attempted if the gRPC
25558 # status code in the response header is set tounavailable.
25559 #
25560 # Only the following codes are supported when the URL map is bound to
25561 # target gRPC proxy that has validateForProxyless field set to true.
25562 #
25563 # - cancelled
25564 # - deadline-exceeded
25565 # - internal
25566 # - resource-exhausted
25567 # - unavailable
25568 &quot;A String&quot;,
25569 ],
25570 },
25571 &quot;timeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
25572 # time the request has been fully processed (known as *end-of-stream*)
25573 # up until the response has been processed. Timeout includes
25574 # all retries.
25575 #
25576 # If not specified, this field uses the largest timeout among all backend
25577 # services associated with the route.
25578 #
25579 # Not supported when the URL map is bound to a target gRPC proxy that
25580 # has validateForProxyless field set to true.
25581 # as a count of seconds and fractions of seconds at nanosecond
25582 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
25583 # or &quot;month&quot;. Range is approximately 10,000 years.
25584 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
25585 # Durations less than one second are represented with a 0
25586 # `seconds` field and a positive `nanos` field. Must be from 0
25587 # to 999,999,999 inclusive.
25588 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
25589 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
25590 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
25591 },
25592 &quot;urlRewrite&quot;: { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
25593 # to the matched service.
25594 #
25595 # urlRewrite is the only action supported in UrlMaps
25596 # for classic Application Load Balancers.
25597 #
25598 # Not supported when the URL map is bound to a target gRPC proxy that
25599 # has the validateForProxyless field set to true.
25600 # backend service.
25601 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
25602 # host header is replaced with contents of hostRewrite.
25603 #
25604 # The value must be from 1 to 255 characters.
25605 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
25606 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
25607 #
25608 # The value must be from 1 to 1024 characters.
25609 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
25610 # header) using the HTTP template syntax.
25611 #
25612 # A corresponding
25613 # path_template_match must be specified. Any template variables must exist in
25614 # the path_template_match field.
25615 #
25616 #
25617 # - -At least one variable must be specified in the path_template_match
25618 # field
25619 # - You can omit variables from the rewritten URL
25620 # - The * and ** operators cannot be matched
25621 # unless they have a corresponding variable name - e.g.
25622 # {format=*} or {var=**}.
25623 #
25624 # For example, a path_template_match of /static/{format=**}
25625 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
25626 # rewrite, so that /{country}/{format}/{suffix=**} can be
25627 # rewritten as /content/{format}/{country}/{suffix}.
25628 #
25629 # At least
25630 # one non-empty routeRules[].matchRules[].path_template_match is
25631 # required.
25632 #
25633 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
25634 },
25635 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
25636 # occurs. The weights determine the fraction of traffic that flows to
25637 # their corresponding backend service. If all traffic needs to
25638 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
25639 #
25640 # After a backend service is identified and before forwarding
25641 # the request to
25642 # the backend service, advanced routing actions such as URL rewrites and
25643 # header transformations are applied depending on additional settings
25644 # specified in this HttpRouteAction.
25645 { # In contrast to a single BackendService in
25646 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
25647 # multiple backend services. The volume of traffic for each
25648 # backend service is proportional to the weight specified
25649 # in each WeightedBackendService
25650 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
25651 # resource. Before
25652 # forwarding the request to backendService, the load balancer
25653 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
25654 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
25655 # effect for the selected backendService.
25656 #
25657 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
25658 #
25659 # headerAction is not supported for load balancers that have
25660 # their loadBalancingScheme set to EXTERNAL.
25661 #
25662 # Not supported when the URL map is bound to a target gRPC proxy that
25663 # has validateForProxyless field set to true.
25664 # the request is passed along to the selected backendService.
25665 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
25666 { # Specification determining how headers are added to requests or responses.
25667 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
25668 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
25669 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
25670 # that already
25671 # exist for the header. If true, headerValue is set for the
25672 # header, discarding any values that were set for that header.
25673 #
25674 # The default value is true,
25675 # unless a variable is present in headerValue,
25676 # in which case the default value is false.
25677 # .
25678 },
25679 ],
25680 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
25681 # request before forwarding the request to the backendService.
25682 &quot;A String&quot;,
25683 ],
25684 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
25685 # client.
25686 { # Specification determining how headers are added to requests or responses.
25687 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
25688 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
25689 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
25690 # that already
25691 # exist for the header. If true, headerValue is set for the
25692 # header, discarding any values that were set for that header.
25693 #
25694 # The default value is true,
25695 # unless a variable is present in headerValue,
25696 # in which case the default value is false.
25697 # .
25698 },
25699 ],
25700 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
25701 # response before sending the response back to the client.
25702 &quot;A String&quot;,
25703 ],
25704 },
25705 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
25706 # computed asweight / (sum of all weightedBackendService weights in routeAction).
25707 #
25708 # The selection of a backend service is determined only for new traffic.
25709 # Once a user&#x27;s request has been directed to a backend service,
25710 # subsequent requests are sent to the same backend service as
25711 # determined by the backend service&#x27;s session affinity policy.
25712 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
25713 # splitting. If you do, the weighted traffic splitting configuration takes
25714 # precedence.
25715 #
25716 # The value must be from 0 to 1000.
25717 },
25718 ],
25719 },
25720 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
25721 # is directed if this rule is matched. If routeAction is
25722 # also specified, advanced routing actions, such as URL rewrites,
25723 # take effect before sending the request to the backend.
25724 #
25725 #
25726 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
25727 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
25728 # specified by urlRedirect.
25729 #
25730 #
25731 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
25732 #
25733 #
25734 # Not supported when the URL map is bound to a target gRPC proxy.
25735 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
25736 # was supplied in the request.
25737 #
25738 # The value must be from 1 to 255
25739 # characters.
25740 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
25741 # set to HTTPS.
25742 # If set to false, the URL scheme of the redirected request
25743 # remains the same as that of the request.
25744 #
25745 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
25746 #
25747 # The default is set to false.
25748 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
25749 # that was supplied in the request.
25750 #
25751 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
25752 # supplied, the path of the original request is used for the redirect.
25753 #
25754 # The value must be from 1 to 1024 characters.
25755 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
25756 # the HttpRouteRuleMatch, retaining the remaining portion
25757 # of the URL before redirecting the request.
25758 #
25759 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
25760 # supplied, the path of the original request is used for the redirect.
25761 #
25762 # The value must be from 1 to 1024 characters.
25763 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
25764 #
25765 # Supported values are:
25766 #
25767 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
25768 # to 301.
25769 # - FOUND, which corresponds to 302.
25770 # - SEE_OTHER which corresponds to 303.
25771 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
25772 # method is retained.
25773 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
25774 # method is retained.
25775 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
25776 # URL is
25777 # removed before redirecting the request. If set to false, the
25778 # query portion of the original URL is retained.
25779 #
25780 # The default is set to false.
25781 },
25782 },
25783 ],
25784 &quot;routeRules&quot;: [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
25785 # desired. routeRules are evaluated in order of priority, from
25786 # the lowest to highest number.
25787 #
25788 # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
25789 { # The HttpRouteRule setting specifies how to match an HTTP request
25790 # and the corresponding routing action that load balancing proxies perform.
25791 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
25792 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
25793 #
25794 # If a policy for an
25795 # error code is not configured for the RouteRule, a policy for
25796 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
25797 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
25798 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
25799 # effect.
25800 #
25801 # For example, consider a UrlMap with the following configuration:
25802 #
25803 #
25804 # - UrlMap.defaultCustomErrorResponsePolicy are configured
25805 # with policies for 5xx and 4xx errors
25806 # - A RouteRule for /coming_soon/ is configured for the
25807 # error code 404.
25808 #
25809 # If the request is for www.myotherdomain.com and a404 is encountered, the policy underUrlMap.defaultCustomErrorResponsePolicy takes effect. If a404 response is encountered for the requestwww.example.com/current_events/, the pathMatcher&#x27;s policy
25810 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
25811 # the policy in RouteRule.customErrorResponsePolicy takes
25812 # effect. If any of the requests in this example encounter a 500
25813 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
25814 #
25815 # When
25816 # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
25817 # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
25818 # a retry, if load balancer is successful in reaching the
25819 # service, the customErrorResponsePolicy is ignored and
25820 # the response from the service is returned to the client.
25821 #
25822 # customErrorResponsePolicy is supported only for
25823 # global external Application Load Balancers.
25824 # backend service or backend bucket responds with an error.
25825 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
25826 #
25827 # In a given policy, if you specify rules for both a range of error codes
25828 # as well as rules for specific error codes then rules with specific error
25829 # codes have a higher priority. For example, assume that you configure a rule
25830 # for 401 (Un-authorized) code, and another for all 4 series
25831 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
25832 # However if the backend service returns a 403, the rule for4xx takes effect.
25833 { # Specifies the mapping between the response code that will be returned along
25834 # with the custom error content and the response code returned by the backend
25835 # service.
25836 &quot;matchResponseCodes&quot;: [ # Valid values include:
25837 #
25838 #
25839 # - A number between 400 and 599: For example
25840 # 401 or 503, in which case the load balancer
25841 # applies the policy if the error code exactly matches this value.
25842 # - 5xx: Load Balancer will apply the policy if the
25843 # backend service responds with any response code in the range of
25844 # 500 to 599.
25845 # - 4xx: Load
25846 # Balancer will apply the policy if the backend service responds with any
25847 # response code in the range of 400 to
25848 # 499.
25849 #
25850 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
25851 &quot;A String&quot;,
25852 ],
25853 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
25854 # error content. If overrideResponseCode is not supplied, the
25855 # same response code returned by the original backend bucket or backend
25856 # service is returned to the client.
25857 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
25858 #
25859 # path must start
25860 # with a leading slash. path cannot have trailing slashes.
25861 #
25862 # If the file is not available in backendBucket or the
25863 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
25864 #
25865 # The value must
25866 # be from 1 to 1024 characters
25867 },
25868 ],
25869 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
25870 # contains the custom error content. Examples are:
25871 #
25872 #
25873 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
25874 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
25875 # - global/backendBuckets/myBackendBucket
25876 #
25877 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
25878 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
25879 #
25880 # If load balancer cannot reach
25881 # the backendBucket, a simple Not Found Error will
25882 # be returned, with the original response code (oroverrideResponseCode if configured).
25883 #
25884 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
25885 },
25886 &quot;description&quot;: &quot;A String&quot;, # The short description conveying the intent of this routeRule.
25887 #
25888 #
25889 # The description can have a maximum length of 1024 characters.
25890 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take effect
25891 # for the selected backendService.
25892 #
25893 # The headerAction value specified here is applied before the
25894 # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
25895 #
25896 # HeaderAction is not supported for load balancers
25897 # that have
25898 # their loadBalancingScheme set to EXTERNAL.
25899 #
25900 # Not supported when the URL map is bound to a target gRPC proxy that
25901 # has validateForProxyless field set to true.
25902 # the request is passed along to the selected backendService.
25903 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
25904 { # Specification determining how headers are added to requests or responses.
25905 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
25906 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
25907 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
25908 # that already
25909 # exist for the header. If true, headerValue is set for the
25910 # header, discarding any values that were set for that header.
25911 #
25912 # The default value is true,
25913 # unless a variable is present in headerValue,
25914 # in which case the default value is false.
25915 # .
25916 },
25917 ],
25918 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
25919 # request before forwarding the request to the backendService.
25920 &quot;A String&quot;,
25921 ],
25922 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
25923 # client.
25924 { # Specification determining how headers are added to requests or responses.
25925 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
25926 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
25927 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
25928 # that already
25929 # exist for the header. If true, headerValue is set for the
25930 # header, discarding any values that were set for that header.
25931 #
25932 # The default value is true,
25933 # unless a variable is present in headerValue,
25934 # in which case the default value is false.
25935 # .
25936 },
25937 ],
25938 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
25939 # response before sending the response back to the client.
25940 &quot;A String&quot;,
25941 ],
25942 },
25943 &quot;matchRules&quot;: [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
25944 # this routeRule when any of thematchRules are satisfied. However predicates within
25945 # a given matchRule have AND semantics. All predicates
25946 # within a matchRule must match for the request to
25947 # match the rule.
25948 { # HttpRouteRuleMatch specifies a set of criteria for matching
25949 # requests to an HttpRouteRule. All specified criteria must
25950 # be satisfied for a match to occur.
25951 &quot;fullPathMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
25952 # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
25953 # that may be part of the original URL.
25954 #
25955 # fullPathMatch must be from 1 to 1024 characters.
25956 #
25957 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
25958 # specified.
25959 &quot;headerMatches&quot;: [ # Specifies a list of header match criteria, all of which must match
25960 # corresponding headers in the request.
25961 { # matchRule criteria for request header matches.
25962 &quot;exactMatch&quot;: &quot;A String&quot;, # The value should exactly match contents of exactMatch.
25963 #
25964 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
25965 &quot;headerName&quot;: &quot;A String&quot;, # The name of the HTTP header to match.
25966 #
25967 # For matching against the HTTP request&#x27;s authority, use a headerMatch
25968 # with the header name &quot;:authority&quot;.
25969 #
25970 # For matching a request&#x27;s method, use the headerName &quot;:method&quot;.
25971 #
25972 # When the URL map is bound to a target gRPC proxy that has
25973 # the validateForProxyless field set to true, only
25974 # non-binary
25975 # user-specified custom metadata and the `content-type` header are supported.
25976 # The following transport-level headers cannot be used in header matching
25977 # rules:
25978 # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
25979 # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
25980 # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
25981 # `grpc-timeout` and `grpc-trace-bin`.
25982 &quot;invertMatch&quot;: True or False, # If set to false, the headerMatch is considered a
25983 # match if the preceding match criteria are met. If set to true,
25984 # the headerMatch is considered a match if the preceding
25985 # match criteria are NOT met.
25986 #
25987 # The default setting is false.
25988 &quot;prefixMatch&quot;: &quot;A String&quot;, # The value of the header must start with the contents ofprefixMatch.
25989 #
25990 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
25991 &quot;presentMatch&quot;: True or False, # A header with the contents of headerName must exist. The
25992 # match takes place whether or not the request&#x27;s header has a value.
25993 #
25994 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
25995 &quot;rangeMatch&quot;: { # HttpRouteRuleMatch criteria for field values that must stay # The header value must be an integer and its value must be in the range
25996 # specified in rangeMatch. If the header does not contain an
25997 # integer, number or is empty, the match fails.
25998 #
25999 # For example for a range [-5, 0]
26000 #
26001 #
26002 # - -3 will match.
26003 # - 0 will not match.
26004 # - 0.25 will not match.
26005 # - -3someString will not match.
26006 #
26007 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
26008 #
26009 # rangeMatch is not supported for load balancers
26010 # that have loadBalancingScheme set to EXTERNAL.
26011 # within the specified integer range.
26012 &quot;rangeEnd&quot;: &quot;A String&quot;, # The end of the range (exclusive) in signed long integer format.
26013 &quot;rangeStart&quot;: &quot;A String&quot;, # The start of the range (inclusive) in signed long integer format.
26014 },
26015 &quot;regexMatch&quot;: &quot;A String&quot;, # The value of the header must match the regular expression specified inregexMatch.
26016 # For more information about regular expression syntax, see Syntax.
26017 #
26018 # For matching against a port specified in the HTTP request, use a
26019 # headerMatch with headerName set to PORT and a regular expression that
26020 # satisfies the RFC2616 Host header&#x27;s port specifier.
26021 #
26022 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
26023 #
26024 # Regular expressions can only be used when the loadBalancingScheme is
26025 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
26026 # (regional scope) or INTERNAL_MANAGED.
26027 &quot;suffixMatch&quot;: &quot;A String&quot;, # The value of the header must end with the contents ofsuffixMatch.
26028 #
26029 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
26030 },
26031 ],
26032 &quot;ignoreCase&quot;: True or False, # Specifies that prefixMatch and fullPathMatch
26033 # matches are case sensitive.
26034 #
26035 # The default value is false.
26036 #
26037 # ignoreCase must not be used with regexMatch.
26038 #
26039 # Not supported when the URL map is bound to a target gRPC proxy.
26040 &quot;metadataFilters&quot;: [ # Opaque filter criteria used by the load balancer to restrict routing
26041 # configuration to a limited set of xDS
26042 # compliant clients. In their xDS requests to the load balancer, xDS clients
26043 # present node
26044 # metadata. When there is a match, the relevant routing configuration
26045 # is made available to those proxies.
26046 #
26047 # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least one of thefilterLabels must match the corresponding label provided in
26048 # the metadata. If its filterMatchCriteria is set to
26049 # MATCH_ALL, then all of its filterLabels must match with
26050 # corresponding labels provided in the metadata. If multiple
26051 # metadata filters are specified, all of them need to be
26052 # satisfied in order to be considered a match.
26053 #
26054 # metadataFilters specified here is applied after those
26055 # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
26056 #
26057 # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
26058 #
26059 # Not supported when the URL map is bound to a target gRPC proxy that
26060 # has validateForProxyless field set to true.
26061 { # Opaque filter criteria used by load balancers to restrict routing
26062 # configuration to a limited set of load balancing proxies. Proxies and
26063 # sidecars involved in load balancing would typically present metadata to the
26064 # load balancers that need to match criteria specified here. If a match takes
26065 # place, the relevant configuration is made available to those
26066 # proxies.
26067 #
26068 # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
26069 # one of thefilterLabels must match the corresponding label provided in
26070 # the metadata. If its filterMatchCriteria is set to
26071 # MATCH_ALL, then all of its filterLabels must match with
26072 # corresponding labels provided in the metadata.
26073 #
26074 # An example for using metadataFilters would be: if
26075 # load balancing involves
26076 # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in of their XDS requests to loadbalancers.
26077 &quot;filterLabels&quot;: [ # The list of label value pairs that must match labels in the provided
26078 # metadata based on filterMatchCriteria
26079 #
26080 # This list must not be empty and can have at the most 64 entries.
26081 { # MetadataFilter label name value pairs that are expected
26082 # to match corresponding labels presented as metadata to the load balancer.
26083 &quot;name&quot;: &quot;A String&quot;, # Name of metadata label.
26084 #
26085 # The name can have a maximum length of 1024 characters and must be at
26086 # least 1 character long.
26087 &quot;value&quot;: &quot;A String&quot;, # The value of the label must match the specified value.
26088 #
26089 # value can have a maximum length of 1024 characters.
26090 },
26091 ],
26092 &quot;filterMatchCriteria&quot;: &quot;A String&quot;, # Specifies how individual filter label matches
26093 # within the list of filterLabels and contributes toward the
26094 # overall metadataFilter match.
26095 #
26096 # Supported values are:
26097 #
26098 # - MATCH_ANY: at least one of the filterLabels
26099 # must have a matching label in the provided metadata.
26100 # - MATCH_ALL: all filterLabels must have
26101 # matching labels in the provided metadata.
26102 },
26103 ],
26104 &quot;pathTemplateMatch&quot;: &quot;A String&quot;, # If specified, this field defines a path template pattern that must match
26105 # the :path header after the query string is removed.
26106 #
26107 # A path template pattern can include variables and wildcards.
26108 # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
26109 # matches a single path segment, and ** that matches zero or
26110 # more path segments. The pattern must follow these rules:
26111 #
26112 #
26113 # - The value must be between 1 and 1024 characters.
26114 # - The pattern must start with a leading slash (&quot;/&quot;).
26115 # - No more than 5 operators (variables or wildcards) may appear in
26116 # the pattern.
26117 #
26118 # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
26119 # set.
26120 &quot;prefixMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the request&#x27;s
26121 # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
26122 #
26123 # The value must be from 1 to 1024 characters.
26124 #
26125 # The * character inside a prefix match is
26126 # treated as a literal character, not as a wildcard.
26127 #
26128 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
26129 # used within a matchRule.
26130 &quot;queryParameterMatches&quot;: [ # Specifies a list of query parameter match criteria, all of which must
26131 # match corresponding query parameters in the request.
26132 #
26133 # Not supported when the URL map is bound to a target gRPC proxy.
26134 { # HttpRouteRuleMatch criteria for a request&#x27;s query parameter.
26135 &quot;exactMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
26136 # parameter exactly matches the contents of exactMatch.
26137 #
26138 # Only one of presentMatch, exactMatch, orregexMatch must be set.
26139 &quot;name&quot;: &quot;A String&quot;, # The name of the query parameter to match. The query parameter must exist in
26140 # the request, in the absence of which the request match fails.
26141 &quot;presentMatch&quot;: True or False, # Specifies that the queryParameterMatch matches if the
26142 # request contains the query parameter, irrespective of whether the
26143 # parameter has a value or not.
26144 #
26145 # Only one of presentMatch, exactMatch, orregexMatch must be set.
26146 &quot;regexMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
26147 # parameter matches the regular expression specified byregexMatch. For
26148 # more information about regular expression syntax, see Syntax.
26149 #
26150 # Only one of presentMatch, exactMatch, orregexMatch must be set.
26151 #
26152 # Regular expressions can only be used when the loadBalancingScheme is
26153 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
26154 # (regional scope) or INTERNAL_MANAGED.
26155 },
26156 ],
26157 &quot;regexMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
26158 # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
26159 # supplied with the original URL. For
26160 # more information about regular expression syntax, see Syntax.
26161 #
26162 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
26163 # specified.
26164 #
26165 # Regular expressions can only be used when the loadBalancingScheme is
26166 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
26167 # (regional scope) or INTERNAL_MANAGED.
26168 },
26169 ],
26170 &quot;priority&quot;: 42, # For routeRules within a given pathMatcher,
26171 # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
26172 # of priority, from the lowest to highest number. The priority of a
26173 # rule decreases as its number increases (1, 2, 3, N+1). The first rule
26174 # that matches the request is applied.
26175 #
26176 #
26177 # You cannot configure two or more routeRules with the same priority.
26178 # Priority for each rule must be set to a number from 0 to 2147483647
26179 # inclusive.
26180 #
26181 #
26182 # Priority numbers can have gaps, which enable you to add or remove rules
26183 # in the future without affecting the rest of the rules. For example, 1, 2,
26184 # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
26185 # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
26186 # without any impact on existing rules.
26187 &quot;routeAction&quot;: { # In response to a matching matchRule, the load balancer
26188 # performs advanced routing actions, such as URL rewrites and header
26189 # transformations, before forwarding the request to the selected backend.
26190 #
26191 #
26192 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
26193 #
26194 #
26195 # URL maps for classic Application Load Balancers only support
26196 # the urlRewrite action within a route rule&#x27;srouteAction.
26197 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
26198 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
26199 # property must be specified. This policy cannot be specified if any target
26200 # backend has Identity-Aware Proxy enabled.
26201 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
26202 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
26203 # header names can be specified. The cache is bypassed for all `cacheMode`
26204 # values.
26205 &quot;A String&quot;,
26206 ],
26207 &quot;cacheKeyPolicy&quot;: { # Message containing what to include in the cache key for a request for Cache # The cache key configuration. If not specified, the default behavior depends
26208 # on the backend type: for Backend Services, the complete request URI is
26209 # used; for Backend Buckets, the request URI is used without the protocol or
26210 # host, and only query parameters known to Cloud Storage are included.
26211 # Policy defined on Route Action.
26212 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
26213 # parameters will be included. Either specify `excludedQueryParameters`
26214 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
26215 # encoded and not treated as delimiters.
26216 #
26217 # Note: This field applies to routes that use backend services. Attempting
26218 # to set it on a route that points exclusively to Backend Buckets will
26219 # result in a configuration error. For routes that point to a Backend
26220 # Bucket, use `includedQueryParameters` to define which parameters should
26221 # be part of the cache key.
26222 &quot;A String&quot;,
26223 ],
26224 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
26225 #
26226 # Note: This setting is only applicable to routes that use a Backend
26227 # Service. It does not affect requests served by a Backend Bucket, as the
26228 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
26229 # it on a route that points exclusively to Backend Buckets will result in a
26230 # configuration error.
26231 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
26232 #
26233 # Note: This setting is only applicable to routes that use a Backend
26234 # Service. It does not affect requests served by a Backend Bucket, as the
26235 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
26236 # set on a route that points exclusively to Backend Buckets will result in
26237 # a configuration error.
26238 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
26239 # `includedQueryParameters` and `excludedQueryParameters`. If neither
26240 # is set, the entire query string will be included. If false, the query
26241 # string will be excluded from the cache key entirely.
26242 #
26243 # Note: This field applies to routes that use backend services. Attempting
26244 # to set it on a route that points exclusively to Backend Buckets will
26245 # result in a configuration error. For routes that point to a Backend
26246 # Bucket, use `includedQueryParameters` to define which parameters should
26247 # be part of the cache key.
26248 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
26249 # The name=value pair will be used in the cache key Cloud CDN generates.
26250 #
26251 # Note: This setting is only applicable to routes that use a Backend
26252 # Service. It does not affect requests served by a Backend Bucket.
26253 # Attempting to set it on a route that points exclusively to Backend
26254 # Buckets will result in a configuration error. Up to 5 cookie names can be
26255 # specified.
26256 &quot;A String&quot;,
26257 ],
26258 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
26259 &quot;A String&quot;,
26260 ],
26261 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
26262 # parameters will be excluded. Either specify `includedQueryParameters`
26263 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
26264 # encoded and not treated as delimiters.
26265 &quot;A String&quot;,
26266 ],
26267 },
26268 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
26269 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
26270 &quot;clientTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a separate client (e.g. browser client) maximum TTL for cached
26271 # content. This is used to clamp the max-age (or Expires) value sent to the
26272 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
26273 # is used for the response max-age directive, along with a &quot;public&quot;
26274 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
26275 # clamps the max-age from the origin (if specified), or else sets the
26276 # response max-age directive to the lesser of the `clientTtl` and
26277 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
26278 # present. The maximum allowed value is 31,622,400s (1 year). If not
26279 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
26280 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
26281 # `USE_ORIGIN_HEADERS`.
26282 # as a count of seconds and fractions of seconds at nanosecond
26283 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
26284 # or &quot;month&quot;. Range is approximately 10,000 years.
26285 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
26286 # Durations less than one second are represented with a 0
26287 # `seconds` field and a positive `nanos` field. Must be from 0
26288 # to 999,999,999 inclusive.
26289 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
26290 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
26291 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
26292 },
26293 &quot;defaultTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the default TTL for cached content for responses that do not have
26294 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
26295 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
26296 # greater than that of `maxTtl`. When the `cacheMode` is set to
26297 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
26298 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
26299 # accessed objects may be evicted from the cache before the defined TTL. If
26300 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
26301 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
26302 # `USE_ORIGIN_HEADERS`.
26303 # as a count of seconds and fractions of seconds at nanosecond
26304 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
26305 # or &quot;month&quot;. Range is approximately 10,000 years.
26306 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
26307 # Durations less than one second are represented with a 0
26308 # `seconds` field and a positive `nanos` field. Must be from 0
26309 # to 999,999,999 inclusive.
26310 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
26311 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
26312 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
26313 },
26314 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
26315 # attempt to set a max-age or s-maxage higher than this, or an Expires header
26316 # more than `maxTtl` seconds in the future will be capped at the value of
26317 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
26318 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
26319 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
26320 # Infrequently accessed objects may be evicted from the cache before the
26321 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
26322 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
26323 # mode.
26324 # as a count of seconds and fractions of seconds at nanosecond
26325 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
26326 # or &quot;month&quot;. Range is approximately 10,000 years.
26327 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
26328 # Durations less than one second are represented with a 0
26329 # `seconds` field and a positive `nanos` field. Must be from 0
26330 # to 999,999,999 inclusive.
26331 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
26332 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
26333 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
26334 },
26335 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
26336 # to apply fine-grained caching for common errors or redirects.
26337 # This can reduce the load on your origin and improve end-user
26338 # experience by reducing response latency.
26339 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
26340 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
26341 # the specified response code that lack any Cache-Control, Expires, or
26342 # Pragma: no-cache directives. When the `cacheMode` is set to
26343 # `FORCE_CACHE_ALL`, negative caching applies to all responses
26344 # with the specified response code, and overrides any caching headers. By
26345 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
26346 #
26347 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
26348 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
26349 # * 405 (Method Not Found), 501 (Not Implemented): 60s
26350 #
26351 # These defaults can be overridden in `negativeCachingPolicy`.
26352 # If not specified, Cloud CDN applies negative caching by default.
26353 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
26354 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
26355 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
26356 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
26357 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
26358 # all response codes that you wish to cache. Cloud CDN will not apply any
26359 # default negative caching when a policy exists.
26360 { # Specify CDN TTLs for response error codes.
26361 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
26362 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
26363 # specified as values, and you cannot specify a status code more than
26364 # once.
26365 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
26366 # corresponding status code.
26367 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
26368 # objects may be evicted from the cache before the defined TTL.
26369 # as a count of seconds and fractions of seconds at nanosecond
26370 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
26371 # or &quot;month&quot;. Range is approximately 10,000 years.
26372 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
26373 # Durations less than one second are represented with a 0
26374 # `seconds` field and a positive `nanos` field. Must be from 0
26375 # to 999,999,999 inclusive.
26376 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
26377 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
26378 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
26379 },
26380 },
26381 ],
26382 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
26383 # requests into a small number of requests to the origin. If not specified,
26384 # Cloud CDN applies request coalescing by default.
26385 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
26386 # content with the origin, or when an error is encountered when refreshing
26387 # the cache.
26388 # This setting defines the default &quot;max-stale&quot; duration for any cached
26389 # responses that do not specify a max-stale directive. Stale responses that
26390 # exceed the TTL configured here will not be served. The default limit
26391 # (max-stale) is 86400s (1 day), which will allow stale content to be
26392 # served up to this limit beyond the max-age (or s-maxage) of a cached
26393 # response.
26394 # The maximum allowed value is 604800 (1 week).
26395 # Set this to zero (0) to disable serve-while-stale.
26396 # as a count of seconds and fractions of seconds at nanosecond
26397 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
26398 # or &quot;month&quot;. Range is approximately 10,000 years.
26399 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
26400 # Durations less than one second are represented with a 0
26401 # `seconds` field and a positive `nanos` field. Must be from 0
26402 # to 999,999,999 inclusive.
26403 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
26404 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
26405 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
26406 },
26407 },
26408 &quot;corsPolicy&quot;: { # The specification for allowing client-side cross-origin requests. For more # The specification for allowing client-side cross-origin requests. For more
26409 # information about the W3C recommendation for cross-origin resource sharing
26410 # (CORS), see Fetch API Living
26411 # Standard.
26412 #
26413 # Not supported when the URL map is bound to a target gRPC proxy.
26414 # information about the W3C recommendation for cross-origin resource sharing
26415 # (CORS), see Fetch API Living
26416 # Standard.
26417 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
26418 # indicates that
26419 # the actual request can include user credentials. This field translates to
26420 # the Access-Control-Allow-Credentials header.
26421 #
26422 # Default is false.
26423 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
26424 # header.
26425 &quot;A String&quot;,
26426 ],
26427 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
26428 # header.
26429 &quot;A String&quot;,
26430 ],
26431 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
26432 # more information, see regular expression syntax.
26433 #
26434 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
26435 #
26436 # Regular expressions can only be used when the loadBalancingScheme is
26437 # set to INTERNAL_SELF_MANAGED.
26438 &quot;A String&quot;,
26439 ],
26440 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
26441 #
26442 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
26443 &quot;A String&quot;,
26444 ],
26445 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
26446 # The default value is false, which indicates that the CORS
26447 # policy is in effect.
26448 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
26449 # header.
26450 &quot;A String&quot;,
26451 ],
26452 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
26453 # seconds. This field translates to the Access-Control-Max-Age
26454 # header.
26455 },
26456 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
26457 # the resiliency of clients to backend service failure. As part of fault
26458 # injection, when clients send requests to a backend service, delays can be
26459 # introduced by a load balancer on a percentage of requests before sending
26460 # those requests to the backend service. Similarly requests from clients can
26461 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
26462 # that are configured with a fault_injection_policy if:
26463 # 1. The traffic is generated by fault injection AND
26464 # 2. The fault injection is not a delay fault injection.
26465 # Fault injection is not supported with the classic Application Load Balancer
26466 # . To see which load balancers support fault injection,
26467 # see Load
26468 # balancing: Routing and traffic management features.
26469 # the resiliency of clients to backend service failure. As part of fault
26470 # injection, when clients send requests to a backend service, delays can be
26471 # introduced by the load balancer on a percentage of requests before sending
26472 # those request to the backend service. Similarly requests from clients can be
26473 # aborted by the load balancer for a percentage of requests.
26474 &quot;abort&quot;: { # Specification for how requests are aborted as part of fault injection. # The specification for how client requests are aborted as part of fault
26475 # injection.
26476 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
26477 #
26478 # The value must be from 200 to 599 inclusive.
26479 #
26480 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
26481 # according to this
26482 # mapping table. HTTP status 200 is mapped to gRPC status
26483 # UNKNOWN. Injecting an OK status is currently not supported by
26484 # Traffic Director.
26485 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
26486 # that is aborted as part of fault injection.
26487 #
26488 # The value must be from 0.0 to 100.0 inclusive.
26489 },
26490 &quot;delay&quot;: { # Specifies the delay introduced by the load balancer before forwarding the # The specification for how client requests are delayed as part of fault
26491 # injection, before being sent to a backend service.
26492 # request to the backend service as part of fault injection.
26493 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
26494 # as a count of seconds and fractions of seconds at nanosecond
26495 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
26496 # or &quot;month&quot;. Range is approximately 10,000 years.
26497 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
26498 # Durations less than one second are represented with a 0
26499 # `seconds` field and a positive `nanos` field. Must be from 0
26500 # to 999,999,999 inclusive.
26501 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
26502 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
26503 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
26504 },
26505 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
26506 # which a delay is introduced as part of fault injection.
26507 #
26508 # The value must be from 0.0 to 100.0 inclusive.
26509 },
26510 },
26511 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
26512 # Unlike the timeout field where the timeout duration starts
26513 # from the time the request has been fully processed (known as*end-of-stream*),
26514 # the duration in this field is computed from the beginning of the stream
26515 # until the response has been processed, including all retries. A
26516 # stream that does not complete in this duration is closed.
26517 #
26518 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
26519 # with the route.
26520 #
26521 # This field is only allowed if the Url map is used with backend services
26522 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
26523 # as a count of seconds and fractions of seconds at nanosecond
26524 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
26525 # or &quot;month&quot;. Range is approximately 10,000 years.
26526 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
26527 # Durations less than one second are represented with a 0
26528 # `seconds` field and a positive `nanos` field. Must be from 0
26529 # to 999,999,999 inclusive.
26530 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
26531 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
26532 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
26533 },
26534 &quot;requestMirrorPolicy&quot;: { # A policy that specifies how requests intended for the route&#x27;s backends # Specifies the policy on how requests intended for the route&#x27;s backends
26535 # are shadowed to a separate mirrored backend service. The load balancer does
26536 # not wait for responses from the shadow service. Before sending traffic
26537 # to the shadow service, the host / authority header is suffixed with-shadow.
26538 #
26539 # Not supported when the URL map is bound to a target gRPC proxy that
26540 # has the validateForProxyless field set to true.
26541 # are shadowed to a separate mirrored backend service. The load balancer
26542 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
26543 # to the shadow service, the host or authority header is suffixed with-shadow.
26544 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
26545 # mirrored to.
26546 #
26547 # The backend service configured for a mirroring
26548 # policy must reference backends that are of the same type as the original
26549 # backend service matched in the URL map.
26550 #
26551 # Serverless NEG backends are not currently supported as a mirrored
26552 # backend service.
26553 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
26554 },
26555 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
26556 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
26557 # If not specified, defaults to 1.
26558 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
26559 #
26560 # If not specified, will use the timeout set in theHttpRouteAction field.
26561 # If timeout in the HttpRouteAction field is not set, this field
26562 # uses the largest timeout
26563 # among all backend services associated with the route.
26564 #
26565 # Not supported when the URL map is bound to a target gRPC proxy that
26566 # has the validateForProxyless field set to true.
26567 # as a count of seconds and fractions of seconds at nanosecond
26568 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
26569 # or &quot;month&quot;. Range is approximately 10,000 years.
26570 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
26571 # Durations less than one second are represented with a 0
26572 # `seconds` field and a positive `nanos` field. Must be from 0
26573 # to 999,999,999 inclusive.
26574 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
26575 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
26576 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
26577 },
26578 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
26579 # values are:
26580 #
26581 # - 5xx: retry is attempted if the instance or endpoint
26582 # responds with any 5xx response code, or if the instance or
26583 # endpoint does not respond at all. For example, disconnects, reset, read
26584 # timeout, connection failure, and refused streams.
26585 # - gateway-error: Similar to 5xx, but only
26586 # applies to response codes 502, 503 or504.
26587 # - connect-failure: a retry is attempted on failures
26588 # connecting to the instance or endpoint. For example, connection
26589 # timeouts.
26590 # - retriable-4xx: a retry is attempted if the instance
26591 # or endpoint responds with a 4xx response code.
26592 # The only error that you can retry is error code 409.
26593 # - refused-stream: a retry is attempted if the instance
26594 # or endpoint resets the stream with a REFUSED_STREAM error
26595 # code. This reset type indicates that it is safe to retry.
26596 # - cancelled: a retry is attempted if the gRPC status
26597 # code in the response header is set to cancelled.
26598 # - deadline-exceeded: a retry is attempted if the gRPC
26599 # status code in the response header is set todeadline-exceeded.
26600 # - internal: a retry is attempted if the gRPC
26601 # status code in the response header is set tointernal.
26602 # - resource-exhausted: a retry is attempted if the gRPC
26603 # status code in the response header is set toresource-exhausted.
26604 # - unavailable: a retry is attempted if the gRPC
26605 # status code in the response header is set tounavailable.
26606 #
26607 # Only the following codes are supported when the URL map is bound to
26608 # target gRPC proxy that has validateForProxyless field set to true.
26609 #
26610 # - cancelled
26611 # - deadline-exceeded
26612 # - internal
26613 # - resource-exhausted
26614 # - unavailable
26615 &quot;A String&quot;,
26616 ],
26617 },
26618 &quot;timeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the timeout for the selected route. Timeout is computed from the
26619 # time the request has been fully processed (known as *end-of-stream*)
26620 # up until the response has been processed. Timeout includes
26621 # all retries.
26622 #
26623 # If not specified, this field uses the largest timeout among all backend
26624 # services associated with the route.
26625 #
26626 # Not supported when the URL map is bound to a target gRPC proxy that
26627 # has validateForProxyless field set to true.
26628 # as a count of seconds and fractions of seconds at nanosecond
26629 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
26630 # or &quot;month&quot;. Range is approximately 10,000 years.
26631 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
26632 # Durations less than one second are represented with a 0
26633 # `seconds` field and a positive `nanos` field. Must be from 0
26634 # to 999,999,999 inclusive.
26635 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
26636 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
26637 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
26638 },
26639 &quot;urlRewrite&quot;: { # The spec for modifying the path before sending the request to the matched # The spec to modify the URL of the request, before forwarding the request
26640 # to the matched service.
26641 #
26642 # urlRewrite is the only action supported in UrlMaps
26643 # for classic Application Load Balancers.
26644 #
26645 # Not supported when the URL map is bound to a target gRPC proxy that
26646 # has the validateForProxyless field set to true.
26647 # backend service.
26648 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
26649 # host header is replaced with contents of hostRewrite.
26650 #
26651 # The value must be from 1 to 255 characters.
26652 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
26653 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
26654 #
26655 # The value must be from 1 to 1024 characters.
26656 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
26657 # header) using the HTTP template syntax.
26658 #
26659 # A corresponding
26660 # path_template_match must be specified. Any template variables must exist in
26661 # the path_template_match field.
26662 #
26663 #
26664 # - -At least one variable must be specified in the path_template_match
26665 # field
26666 # - You can omit variables from the rewritten URL
26667 # - The * and ** operators cannot be matched
26668 # unless they have a corresponding variable name - e.g.
26669 # {format=*} or {var=**}.
26670 #
26671 # For example, a path_template_match of /static/{format=**}
26672 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
26673 # rewrite, so that /{country}/{format}/{suffix=**} can be
26674 # rewritten as /content/{format}/{country}/{suffix}.
26675 #
26676 # At least
26677 # one non-empty routeRules[].matchRules[].path_template_match is
26678 # required.
26679 #
26680 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
26681 },
26682 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
26683 # occurs. The weights determine the fraction of traffic that flows to
26684 # their corresponding backend service. If all traffic needs to
26685 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
26686 #
26687 # After a backend service is identified and before forwarding
26688 # the request to
26689 # the backend service, advanced routing actions such as URL rewrites and
26690 # header transformations are applied depending on additional settings
26691 # specified in this HttpRouteAction.
26692 { # In contrast to a single BackendService in
26693 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
26694 # multiple backend services. The volume of traffic for each
26695 # backend service is proportional to the weight specified
26696 # in each WeightedBackendService
26697 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
26698 # resource. Before
26699 # forwarding the request to backendService, the load balancer
26700 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
26701 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
26702 # effect for the selected backendService.
26703 #
26704 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
26705 #
26706 # headerAction is not supported for load balancers that have
26707 # their loadBalancingScheme set to EXTERNAL.
26708 #
26709 # Not supported when the URL map is bound to a target gRPC proxy that
26710 # has validateForProxyless field set to true.
26711 # the request is passed along to the selected backendService.
26712 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
26713 { # Specification determining how headers are added to requests or responses.
26714 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
26715 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
26716 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
26717 # that already
26718 # exist for the header. If true, headerValue is set for the
26719 # header, discarding any values that were set for that header.
26720 #
26721 # The default value is true,
26722 # unless a variable is present in headerValue,
26723 # in which case the default value is false.
26724 # .
26725 },
26726 ],
26727 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
26728 # request before forwarding the request to the backendService.
26729 &quot;A String&quot;,
26730 ],
26731 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
26732 # client.
26733 { # Specification determining how headers are added to requests or responses.
26734 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
26735 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
26736 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
26737 # that already
26738 # exist for the header. If true, headerValue is set for the
26739 # header, discarding any values that were set for that header.
26740 #
26741 # The default value is true,
26742 # unless a variable is present in headerValue,
26743 # in which case the default value is false.
26744 # .
26745 },
26746 ],
26747 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
26748 # response before sending the response back to the client.
26749 &quot;A String&quot;,
26750 ],
26751 },
26752 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
26753 # computed asweight / (sum of all weightedBackendService weights in routeAction).
26754 #
26755 # The selection of a backend service is determined only for new traffic.
26756 # Once a user&#x27;s request has been directed to a backend service,
26757 # subsequent requests are sent to the same backend service as
26758 # determined by the backend service&#x27;s session affinity policy.
26759 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
26760 # splitting. If you do, the weighted traffic splitting configuration takes
26761 # precedence.
26762 #
26763 # The value must be from 0 to 1000.
26764 },
26765 ],
26766 },
26767 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
26768 # is directed if this rule is matched. If routeAction is
26769 # also specified, advanced routing actions, such as URL rewrites,
26770 # take effect before sending the request to the backend.
26771 #
26772 #
26773 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
26774 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
26775 # specified by urlRedirect.
26776 #
26777 #
26778 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
26779 #
26780 #
26781 # Not supported when the URL map is bound to a target gRPC proxy.
26782 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
26783 # was supplied in the request.
26784 #
26785 # The value must be from 1 to 255
26786 # characters.
26787 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
26788 # set to HTTPS.
26789 # If set to false, the URL scheme of the redirected request
26790 # remains the same as that of the request.
26791 #
26792 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
26793 #
26794 # The default is set to false.
26795 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
26796 # that was supplied in the request.
26797 #
26798 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
26799 # supplied, the path of the original request is used for the redirect.
26800 #
26801 # The value must be from 1 to 1024 characters.
26802 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
26803 # the HttpRouteRuleMatch, retaining the remaining portion
26804 # of the URL before redirecting the request.
26805 #
26806 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
26807 # supplied, the path of the original request is used for the redirect.
26808 #
26809 # The value must be from 1 to 1024 characters.
26810 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
26811 #
26812 # Supported values are:
26813 #
26814 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
26815 # to 301.
26816 # - FOUND, which corresponds to 302.
26817 # - SEE_OTHER which corresponds to 303.
26818 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
26819 # method is retained.
26820 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
26821 # method is retained.
26822 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
26823 # URL is
26824 # removed before redirecting the request. If set to false, the
26825 # query portion of the original URL is retained.
26826 #
26827 # The default is set to false.
26828 },
26829 },
26830 ],
26831 },
26832 ],
26833 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the regional URL map resides.
26834 # This field is not applicable to global URL maps.
26835 # You must specify this field as part of the HTTP request URL. It is
26836 # not settable as a field in the request body.
26837 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
26838 &quot;tests&quot;: [ # The list of expected URL mapping tests. Request to update theUrlMap succeeds only if all test cases pass. You can specify a
26839 # maximum of 100 tests per UrlMap.
26840 #
26841 # Not supported when the URL map is bound to a target gRPC proxy that
26842 # has validateForProxyless field set to true.
26843 { # Message for the expected URL mappings.
26844 &quot;description&quot;: &quot;A String&quot;, # Description of this test case.
26845 &quot;expectedOutputUrl&quot;: &quot;A String&quot;, # The expected output URL evaluated by the load balancer
26846 # containing the scheme, host, path and query parameters.
26847 #
26848 # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
26849 # the load balancer to backends. For rules with urlRewrite,
26850 # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
26851 #
26852 # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer&#x27;s
26853 # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
26854 # If urlRedirect specifies strip_query, the test
26855 # passes only if expectedOutputUrl does not contain any query
26856 # parameters.
26857 #
26858 # expectedOutputUrl is optional whenservice is specified.
26859 &quot;expectedRedirectResponseCode&quot;: 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
26860 # load balancer&#x27;s redirect response.
26861 #
26862 # expectedRedirectResponseCode cannot be set whenservice is set.
26863 &quot;headers&quot;: [ # HTTP headers for this request. If headers contains
26864 # a host header, then host must also match the header value.
26865 { # HTTP headers used in UrlMapTests.
26866 &quot;name&quot;: &quot;A String&quot;, # Header name.
26867 &quot;value&quot;: &quot;A String&quot;, # Header value.
26868 },
26869 ],
26870 &quot;host&quot;: &quot;A String&quot;, # Host portion of the URL. If headers contains a host header,
26871 # then host must also match the header value.
26872 &quot;path&quot;: &quot;A String&quot;, # Path portion of the URL.
26873 &quot;service&quot;: &quot;A String&quot;, # Expected BackendService or BackendBucket resource
26874 # the given URL should be mapped to.
26875 #
26876 # The service field cannot
26877 # be set if expectedRedirectResponseCode is set.
26878 },
26879 ],
26880 },
26881 }
26882
26883 x__xgafv: string, V1 error format.
26884 Allowed values
26885 1 - v1 error format
26886 2 - v2 error format
26887
26888 Returns:
26889 An object of the form:
26890
26891 {
26892 &quot;result&quot;: { # Message representing the validation result for a UrlMap.
26893 &quot;loadErrors&quot;: [
26894 &quot;A String&quot;,
26895 ],
26896 &quot;loadSucceeded&quot;: True or False, # Whether the given UrlMap can be successfully loaded.
26897 # If false, &#x27;loadErrors&#x27; indicates the reasons.
26898 &quot;testFailures&quot;: [
26899 {
26900 &quot;actualOutputUrl&quot;: &quot;A String&quot;, # The actual output URL evaluated by a load balancer containing the scheme,
26901 # host, path and query parameters.
26902 &quot;actualRedirectResponseCode&quot;: 42, # Actual HTTP status code for rule with `urlRedirect`
26903 # calculated by load balancer
26904 &quot;actualService&quot;: &quot;A String&quot;, # BackendService or BackendBucket returned by load
26905 # balancer.
26906 &quot;expectedOutputUrl&quot;: &quot;A String&quot;, # The expected output URL evaluated by a load balancer containing the scheme,
26907 # host, path and query parameters.
26908 &quot;expectedRedirectResponseCode&quot;: 42, # Expected HTTP status code for rule with `urlRedirect`
26909 # calculated by load balancer
26910 &quot;expectedService&quot;: &quot;A String&quot;, # Expected BackendService or BackendBucket resource
26911 # the given URL should be mapped to.
26912 &quot;headers&quot;: [ # HTTP headers of the request.
26913 { # HTTP headers used in UrlMapTests.
26914 &quot;name&quot;: &quot;A String&quot;, # Header name.
26915 &quot;value&quot;: &quot;A String&quot;, # Header value.
26916 },
26917 ],
26918 &quot;host&quot;: &quot;A String&quot;, # Host portion of the URL.
26919 &quot;path&quot;: &quot;A String&quot;, # Path portion including query parameters in the URL.
26920 },
26921 ],
26922 &quot;testPassed&quot;: True or False, # If successfully loaded, this field indicates whether the test passed.
26923 # If false, &#x27;testFailures&#x27;s indicate the reason of failure.
26924 },
26925 }</pre>
26926 </div>
26927
26928 </body></html>