Debian Codegraph @

docs/dyn/compute_alpha.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_alpha.html">Compute Engine API</a> . <a href="compute_alpha.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/alpha/urlMaps)
237 # * [Regional](/compute/docs/reference/rest/alpha/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;imageOptimizationPolicy&quot;: { # The configuration for Cloud CDN&#x27;s image optimization feature. This feature # Image optimization policy for this URL Map&#x27;s route. Available only for
690 # Global EXTERNAL_MANAGED load balancer schemes.
691 # Either Cloud CDN must be enabled on the backend service or backend bucket
692 # serving the route, or cache policy must be configured on the same route
693 # dynamically processes and delivers images from the network edge.
694 # Image Optimization is only available for Global External Application Load
695 # Balancers.
696 # Either Cloud CDN must be enabled on the backend service or backend bucket
697 # serving the route, or cache policy must be configured on the same route.
698 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
699 },
700 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
701 # Unlike the timeout field where the timeout duration starts
702 # from the time the request has been fully processed (known as*end-of-stream*),
703 # the duration in this field is computed from the beginning of the stream
704 # until the response has been processed, including all retries. A
705 # stream that does not complete in this duration is closed.
706 #
707 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
708 # with the route.
709 #
710 # This field is only allowed if the Url map is used with backend services
711 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
712 # as a count of seconds and fractions of seconds at nanosecond
713 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
714 # or &quot;month&quot;. Range is approximately 10,000 years.
715 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
716 # Durations less than one second are represented with a 0
717 # `seconds` field and a positive `nanos` field. Must be from 0
718 # to 999,999,999 inclusive.
719 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
720 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
721 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
722 },
723 &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
724 # are shadowed to a separate mirrored backend service. The load balancer does
725 # not wait for responses from the shadow service. Before sending traffic
726 # to the shadow service, the host / authority header is suffixed with-shadow.
727 #
728 # Not supported when the URL map is bound to a target gRPC proxy that
729 # has the validateForProxyless field set to true.
730 # are shadowed to a separate mirrored backend service. The load balancer
731 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
732 # to the shadow service, the host or authority header is suffixed with-shadow.
733 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
734 # mirrored to.
735 #
736 # The backend service configured for a mirroring
737 # policy must reference backends that are of the same type as the original
738 # backend service matched in the URL map.
739 #
740 # Serverless NEG backends are not currently supported as a mirrored
741 # backend service.
742 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
743 },
744 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
745 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
746 # If not specified, defaults to 1.
747 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
748 #
749 # If not specified, will use the timeout set in theHttpRouteAction field.
750 # If timeout in the HttpRouteAction field is not set, this field
751 # uses the largest timeout
752 # among all backend services associated with the route.
753 #
754 # Not supported when the URL map is bound to a target gRPC proxy that
755 # has the validateForProxyless field set to true.
756 # as a count of seconds and fractions of seconds at nanosecond
757 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
758 # or &quot;month&quot;. Range is approximately 10,000 years.
759 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
760 # Durations less than one second are represented with a 0
761 # `seconds` field and a positive `nanos` field. Must be from 0
762 # to 999,999,999 inclusive.
763 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
764 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
765 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
766 },
767 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
768 # values are:
769 #
770 # - 5xx: retry is attempted if the instance or endpoint
771 # responds with any 5xx response code, or if the instance or
772 # endpoint does not respond at all. For example, disconnects, reset, read
773 # timeout, connection failure, and refused streams.
774 # - gateway-error: Similar to 5xx, but only
775 # applies to response codes 502, 503 or504.
776 # - connect-failure: a retry is attempted on failures
777 # connecting to the instance or endpoint. For example, connection
778 # timeouts.
779 # - retriable-4xx: a retry is attempted if the instance
780 # or endpoint responds with a 4xx response code.
781 # The only error that you can retry is error code 409.
782 # - refused-stream: a retry is attempted if the instance
783 # or endpoint resets the stream with a REFUSED_STREAM error
784 # code. This reset type indicates that it is safe to retry.
785 # - cancelled: a retry is attempted if the gRPC status
786 # code in the response header is set to cancelled.
787 # - deadline-exceeded: a retry is attempted if the gRPC
788 # status code in the response header is set todeadline-exceeded.
789 # - internal: a retry is attempted if the gRPC
790 # status code in the response header is set tointernal.
791 # - resource-exhausted: a retry is attempted if the gRPC
792 # status code in the response header is set toresource-exhausted.
793 # - unavailable: a retry is attempted if the gRPC
794 # status code in the response header is set tounavailable.
795 #
796 # Only the following codes are supported when the URL map is bound to
797 # target gRPC proxy that has validateForProxyless field set to true.
798 #
799 # - cancelled
800 # - deadline-exceeded
801 # - internal
802 # - resource-exhausted
803 # - unavailable
804 &quot;A String&quot;,
805 ],
806 },
807 &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
808 # time the request has been fully processed (known as *end-of-stream*)
809 # up until the response has been processed. Timeout includes
810 # all retries.
811 #
812 # If not specified, this field uses the largest timeout among all backend
813 # services associated with the route.
814 #
815 # Not supported when the URL map is bound to a target gRPC proxy that
816 # has validateForProxyless field set to true.
817 # as a count of seconds and fractions of seconds at nanosecond
818 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
819 # or &quot;month&quot;. Range is approximately 10,000 years.
820 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
821 # Durations less than one second are represented with a 0
822 # `seconds` field and a positive `nanos` field. Must be from 0
823 # to 999,999,999 inclusive.
824 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
825 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
826 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
827 },
828 &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
829 # to the matched service.
830 #
831 # urlRewrite is the only action supported in UrlMaps
832 # for classic Application Load Balancers.
833 #
834 # Not supported when the URL map is bound to a target gRPC proxy that
835 # has the validateForProxyless field set to true.
836 # backend service.
837 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
838 # host header is replaced with contents of hostRewrite.
839 #
840 # The value must be from 1 to 255 characters.
841 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
842 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
843 #
844 # The value must be from 1 to 1024 characters.
845 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
846 # header) using the HTTP template syntax.
847 #
848 # A corresponding
849 # path_template_match must be specified. Any template variables must exist in
850 # the path_template_match field.
851 #
852 #
853 # - -At least one variable must be specified in the path_template_match
854 # field
855 # - You can omit variables from the rewritten URL
856 # - The * and ** operators cannot be matched
857 # unless they have a corresponding variable name - e.g.
858 # {format=*} or {var=**}.
859 #
860 # For example, a path_template_match of /static/{format=**}
861 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
862 # rewrite, so that /{country}/{format}/{suffix=**} can be
863 # rewritten as /content/{format}/{country}/{suffix}.
864 #
865 # At least
866 # one non-empty routeRules[].matchRules[].path_template_match is
867 # required.
868 #
869 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
870 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
871 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
872 # It uses RE2 syntax with the following constraints:
873 #
874 #
875 # - Any single character operators
876 # - Groups are allowed to have only submatch operator inside
877 # - Groups are allowed only without any char repetition, e.g.
878 # .*
879 # - Any char repetition, e.g. .*, is
880 # only allowed to be used in a single regex together with:
881 #
882 #
883 # - Empty string operators
884 # - Other repetitions
885 # - Ranges
886 # - Repetitions of ranges
887 #
888 #
889 # - Ranges are only allowed to have:
890 #
891 #
892 # - Character range
893 # - Digits range
894 # - Symbols listed in characters allowed for ranges
895 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
896 # the path.
897 },
898 },
899 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
900 # occurs. The weights determine the fraction of traffic that flows to
901 # their corresponding backend service. If all traffic needs to
902 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
903 #
904 # After a backend service is identified and before forwarding
905 # the request to
906 # the backend service, advanced routing actions such as URL rewrites and
907 # header transformations are applied depending on additional settings
908 # specified in this HttpRouteAction.
909 { # In contrast to a single BackendService in
910 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
911 # multiple backend services. The volume of traffic for each
912 # backend service is proportional to the weight specified
913 # in each WeightedBackendService
914 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
915 # resource. Before
916 # forwarding the request to backendService, the load balancer
917 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
918 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
919 # effect for the selected backendService.
920 #
921 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
922 #
923 # headerAction is not supported for load balancers that have
924 # their loadBalancingScheme set to EXTERNAL.
925 #
926 # Not supported when the URL map is bound to a target gRPC proxy that
927 # has validateForProxyless field set to true.
928 # the request is passed along to the selected backendService.
929 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
930 { # Specification determining how headers are added to requests or responses.
931 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
932 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
933 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
934 # that already
935 # exist for the header. If true, headerValue is set for the
936 # header, discarding any values that were set for that header.
937 #
938 # The default value is true,
939 # unless a variable is present in headerValue,
940 # in which case the default value is false.
941 # .
942 },
943 ],
944 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
945 # request before forwarding the request to the backendService.
946 &quot;A String&quot;,
947 ],
948 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
949 # client.
950 { # Specification determining how headers are added to requests or responses.
951 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
952 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
953 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
954 # that already
955 # exist for the header. If true, headerValue is set for the
956 # header, discarding any values that were set for that header.
957 #
958 # The default value is true,
959 # unless a variable is present in headerValue,
960 # in which case the default value is false.
961 # .
962 },
963 ],
964 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
965 # response before sending the response back to the client.
966 &quot;A String&quot;,
967 ],
968 },
969 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
970 # computed asweight / (sum of all weightedBackendService weights in routeAction).
971 #
972 # The selection of a backend service is determined only for new traffic.
973 # Once a user&#x27;s request has been directed to a backend service,
974 # subsequent requests are sent to the same backend service as
975 # determined by the backend service&#x27;s session affinity policy.
976 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
977 # splitting. If you do, the weighted traffic splitting configuration takes
978 # precedence.
979 #
980 # The value must be from 0 to 1000.
981 },
982 ],
983 },
984 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL of the defaultService resource to
985 # which traffic is directed if none of the hostRules match.
986 # If defaultRouteAction is also specified, advanced
987 # routing actions, such as URL rewrites, take effect before sending the
988 # request to the backend.
989 #
990 #
991 # Only one of defaultUrlRedirect, defaultService
992 # or defaultRouteAction.weightedBackendService can be set.
993 #
994 #
995 # defaultService has no effect when the URL map is bound
996 # to a target gRPC proxy that has the validateForProxyless field
997 # set to true.
998 &quot;defaultUrlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
999 # is redirected to a URL specified by defaultUrlRedirect.
1000 #
1001 #
1002 # Only one of defaultUrlRedirect, defaultService
1003 # or defaultRouteAction.weightedBackendService can be set.
1004 #
1005 #
1006 # Not supported when the URL map is bound to a target gRPC proxy.
1007 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
1008 # was supplied in the request.
1009 #
1010 # The value must be from 1 to 255
1011 # characters.
1012 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
1013 # set to HTTPS.
1014 # If set to false, the URL scheme of the redirected request
1015 # remains the same as that of the request.
1016 #
1017 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
1018 #
1019 # The default is set to false.
1020 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
1021 # that was supplied in the request.
1022 #
1023 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
1024 # supplied, the path of the original request is used for the redirect.
1025 #
1026 # The value must be from 1 to 1024 characters.
1027 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
1028 # the HttpRouteRuleMatch, retaining the remaining portion
1029 # of the URL before redirecting the request.
1030 #
1031 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
1032 # supplied, the path of the original request is used for the redirect.
1033 #
1034 # The value must be from 1 to 1024 characters.
1035 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
1036 #
1037 # Supported values are:
1038 #
1039 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
1040 # to 301.
1041 # - FOUND, which corresponds to 302.
1042 # - SEE_OTHER which corresponds to 303.
1043 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
1044 # method is retained.
1045 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
1046 # method is retained.
1047 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
1048 # URL is
1049 # removed before redirecting the request. If set to false, the
1050 # query portion of the original URL is retained.
1051 #
1052 # The default is set to false.
1053 },
1054 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
1055 # create the resource.
1056 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. A hash of the contents stored in this object.
1057 # This field is used in optimistic locking. This field is ignored when
1058 # inserting a UrlMap. An up-to-date fingerprint must be provided
1059 # in order to update the UrlMap, otherwise the request will
1060 # fail with error 412 conditionNotMet.
1061 #
1062 # To see the latest fingerprint, make a get() request to
1063 # retrieve a UrlMap.
1064 &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
1065 # for the selected backendService.
1066 #
1067 # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
1068 #
1069 # headerAction is not supported for load balancers
1070 # that have
1071 # their loadBalancingScheme set to EXTERNAL.
1072 #
1073 # Not supported when the URL map is bound to a target gRPC proxy that
1074 # has validateForProxyless field set to true.
1075 # the request is passed along to the selected backendService.
1076 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
1077 { # Specification determining how headers are added to requests or responses.
1078 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
1079 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
1080 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
1081 # that already
1082 # exist for the header. If true, headerValue is set for the
1083 # header, discarding any values that were set for that header.
1084 #
1085 # The default value is true,
1086 # unless a variable is present in headerValue,
1087 # in which case the default value is false.
1088 # .
1089 },
1090 ],
1091 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
1092 # request before forwarding the request to the backendService.
1093 &quot;A String&quot;,
1094 ],
1095 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
1096 # client.
1097 { # Specification determining how headers are added to requests or responses.
1098 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
1099 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
1100 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
1101 # that already
1102 # exist for the header. If true, headerValue is set for the
1103 # header, discarding any values that were set for that header.
1104 #
1105 # The default value is true,
1106 # unless a variable is present in headerValue,
1107 # in which case the default value is false.
1108 # .
1109 },
1110 ],
1111 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
1112 # response before sending the response back to the client.
1113 &quot;A String&quot;,
1114 ],
1115 },
1116 &quot;hostRules&quot;: [ # The list of host rules to use against the URL.
1117 { # UrlMaps
1118 # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
1119 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
1120 # create the resource.
1121 &quot;hosts&quot;: [ # The list of host patterns to match. They must be valid hostnames with
1122 # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
1123 # that case, * must be the first character, and if followed by
1124 # anything, the immediate following character must be either -
1125 # or ..
1126 #
1127 # * based matching is not supported when the URL map is bound
1128 # to a target gRPC proxy that has the validateForProxyless field
1129 # set to true.
1130 &quot;A String&quot;,
1131 ],
1132 &quot;pathMatcher&quot;: &quot;A String&quot;, # The name of the PathMatcher to use to match the path portion
1133 # of the URL if the hostRule matches the URL&#x27;s host portion.
1134 },
1135 ],
1136 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the resource. This identifier is
1137 # defined by the server.
1138 &quot;kind&quot;: &quot;compute#urlMap&quot;, # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
1139 # url maps.
1140 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
1141 # The name must be 1-63 characters long, and comply withRFC1035.
1142 # Specifically, the name must be 1-63 characters long and match the regular
1143 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
1144 # character must be a lowercase letter, and all following characters must
1145 # be a dash, lowercase letter, or digit, except the last character, which
1146 # cannot be a dash.
1147 &quot;pathMatchers&quot;: [ # The list of named PathMatchers to use against the URL.
1148 { # A matcher for the path portion of the URL. The BackendService
1149 # from the longest-matched rule will serve the URL. If no rule was matched, the
1150 # default service is used.
1151 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
1152 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
1153 #
1154 # This policy takes
1155 # effect at the PathMatcher level and applies only when no
1156 # 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
1157 # in defaultCustomErrorResponsePolicy, then a policy defined for
1158 # the error code in UrlMap.defaultCustomErrorResponsePolicy
1159 # takes effect.
1160 #
1161 # For example, consider a UrlMap with the following
1162 # configuration:
1163 #
1164 #
1165 # - UrlMap.defaultCustomErrorResponsePolicy is configured
1166 # with policies for 5xx and 4xx errors
1167 # - A RouteRule for /coming_soon/ is configured for the
1168 # error code 404.
1169 #
1170 # 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
1171 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
1172 # the policy in RouteRule.customErrorResponsePolicy takes
1173 # effect. If any of the requests in this example encounter a 500
1174 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
1175 #
1176 # When
1177 # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
1178 # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
1179 # a retry, if load balancer is successful in reaching the
1180 # service, the defaultCustomErrorResponsePolicy is ignored and
1181 # the response from the service is returned to the client.
1182 #
1183 # defaultCustomErrorResponsePolicy is supported only for
1184 # global external Application Load Balancers.
1185 # backend service or backend bucket responds with an error.
1186 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
1187 #
1188 # In a given policy, if you specify rules for both a range of error codes
1189 # as well as rules for specific error codes then rules with specific error
1190 # codes have a higher priority. For example, assume that you configure a rule
1191 # for 401 (Un-authorized) code, and another for all 4 series
1192 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
1193 # However if the backend service returns a 403, the rule for4xx takes effect.
1194 { # Specifies the mapping between the response code that will be returned along
1195 # with the custom error content and the response code returned by the backend
1196 # service.
1197 &quot;matchResponseCodes&quot;: [ # Valid values include:
1198 #
1199 #
1200 # - A number between 400 and 599: For example
1201 # 401 or 503, in which case the load balancer
1202 # applies the policy if the error code exactly matches this value.
1203 # - 5xx: Load Balancer will apply the policy if the
1204 # backend service responds with any response code in the range of
1205 # 500 to 599.
1206 # - 4xx: Load
1207 # Balancer will apply the policy if the backend service responds with any
1208 # response code in the range of 400 to
1209 # 499.
1210 #
1211 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
1212 &quot;A String&quot;,
1213 ],
1214 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
1215 # error content. If overrideResponseCode is not supplied, the
1216 # same response code returned by the original backend bucket or backend
1217 # service is returned to the client.
1218 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
1219 #
1220 # path must start
1221 # with a leading slash. path cannot have trailing slashes.
1222 #
1223 # If the file is not available in backendBucket or the
1224 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
1225 #
1226 # The value must
1227 # be from 1 to 1024 characters
1228 },
1229 ],
1230 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
1231 # contains the custom error content. Examples are:
1232 #
1233 #
1234 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
1235 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
1236 # - global/backendBuckets/myBackendBucket
1237 #
1238 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
1239 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
1240 #
1241 # If load balancer cannot reach
1242 # the backendBucket, a simple Not Found Error will
1243 # be returned, with the original response code (oroverrideResponseCode if configured).
1244 #
1245 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
1246 },
1247 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
1248 # pathRules or routeRules match. The load balancer
1249 # performs advanced routing actions, such as URL rewrites and
1250 # header transformations, before forwarding the request to the
1251 # selected backend.
1252 #
1253 #
1254 # Only one of defaultUrlRedirect, defaultService
1255 # or defaultRouteAction.weightedBackendService can be set.
1256 #
1257 #
1258 # URL maps for classic Application Load Balancers only support
1259 # the urlRewrite action within a path matcher&#x27;sdefaultRouteAction.
1260 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
1261 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
1262 # property must be specified. This policy cannot be specified if any target
1263 # backend has Identity-Aware Proxy enabled.
1264 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
1265 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
1266 # header names can be specified. The cache is bypassed for all `cacheMode`
1267 # values.
1268 &quot;A String&quot;,
1269 ],
1270 &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
1271 # on the backend type: for Backend Services, the complete request URI is
1272 # used; for Backend Buckets, the request URI is used without the protocol or
1273 # host, and only query parameters known to Cloud Storage are included.
1274 # Policy defined on Route Action.
1275 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
1276 # parameters will be included. Either specify `excludedQueryParameters`
1277 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
1278 # encoded and not treated as delimiters.
1279 #
1280 # Note: This field applies to routes that use backend services. Attempting
1281 # to set it on a route that points exclusively to Backend Buckets will
1282 # result in a configuration error. For routes that point to a Backend
1283 # Bucket, use `includedQueryParameters` to define which parameters should
1284 # be part of the cache key.
1285 &quot;A String&quot;,
1286 ],
1287 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
1288 #
1289 # Note: This setting is only applicable to routes that use a Backend
1290 # Service. It does not affect requests served by a Backend Bucket, as the
1291 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
1292 # it on a route that points exclusively to Backend Buckets will result in a
1293 # configuration error.
1294 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
1295 #
1296 # Note: This setting is only applicable to routes that use a Backend
1297 # Service. It does not affect requests served by a Backend Bucket, as the
1298 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
1299 # set on a route that points exclusively to Backend Buckets will result in
1300 # a configuration error.
1301 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
1302 # `includedQueryParameters` and `excludedQueryParameters`. If neither
1303 # is set, the entire query string will be included. If false, the query
1304 # string will be excluded from the cache key entirely.
1305 #
1306 # Note: This field applies to routes that use backend services. Attempting
1307 # to set it on a route that points exclusively to Backend Buckets will
1308 # result in a configuration error. For routes that point to a Backend
1309 # Bucket, use `includedQueryParameters` to define which parameters should
1310 # be part of the cache key.
1311 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
1312 # The name=value pair will be used in the cache key Cloud CDN generates.
1313 #
1314 # Note: This setting is only applicable to routes that use a Backend
1315 # Service. It does not affect requests served by a Backend Bucket.
1316 # Attempting to set it on a route that points exclusively to Backend
1317 # Buckets will result in a configuration error. Up to 5 cookie names can be
1318 # specified.
1319 &quot;A String&quot;,
1320 ],
1321 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
1322 &quot;A String&quot;,
1323 ],
1324 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
1325 # parameters will be excluded. Either specify `includedQueryParameters`
1326 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
1327 # encoded and not treated as delimiters.
1328 &quot;A String&quot;,
1329 ],
1330 },
1331 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
1332 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
1333 &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
1334 # content. This is used to clamp the max-age (or Expires) value sent to the
1335 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
1336 # is used for the response max-age directive, along with a &quot;public&quot;
1337 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
1338 # clamps the max-age from the origin (if specified), or else sets the
1339 # response max-age directive to the lesser of the `clientTtl` and
1340 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
1341 # present. The maximum allowed value is 31,622,400s (1 year). If not
1342 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
1343 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
1344 # `USE_ORIGIN_HEADERS`.
1345 # as a count of seconds and fractions of seconds at nanosecond
1346 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1347 # or &quot;month&quot;. Range is approximately 10,000 years.
1348 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1349 # Durations less than one second are represented with a 0
1350 # `seconds` field and a positive `nanos` field. Must be from 0
1351 # to 999,999,999 inclusive.
1352 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1353 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1354 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1355 },
1356 &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
1357 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
1358 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
1359 # greater than that of `maxTtl`. When the `cacheMode` is set to
1360 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
1361 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
1362 # accessed objects may be evicted from the cache before the defined TTL. If
1363 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
1364 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
1365 # `USE_ORIGIN_HEADERS`.
1366 # as a count of seconds and fractions of seconds at nanosecond
1367 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1368 # or &quot;month&quot;. Range is approximately 10,000 years.
1369 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1370 # Durations less than one second are represented with a 0
1371 # `seconds` field and a positive `nanos` field. Must be from 0
1372 # to 999,999,999 inclusive.
1373 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1374 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1375 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1376 },
1377 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
1378 # attempt to set a max-age or s-maxage higher than this, or an Expires header
1379 # more than `maxTtl` seconds in the future will be capped at the value of
1380 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
1381 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
1382 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
1383 # Infrequently accessed objects may be evicted from the cache before the
1384 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
1385 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
1386 # mode.
1387 # as a count of seconds and fractions of seconds at nanosecond
1388 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1389 # or &quot;month&quot;. Range is approximately 10,000 years.
1390 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1391 # Durations less than one second are represented with a 0
1392 # `seconds` field and a positive `nanos` field. Must be from 0
1393 # to 999,999,999 inclusive.
1394 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1395 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1396 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1397 },
1398 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
1399 # to apply fine-grained caching for common errors or redirects.
1400 # This can reduce the load on your origin and improve end-user
1401 # experience by reducing response latency.
1402 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
1403 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
1404 # the specified response code that lack any Cache-Control, Expires, or
1405 # Pragma: no-cache directives. When the `cacheMode` is set to
1406 # `FORCE_CACHE_ALL`, negative caching applies to all responses
1407 # with the specified response code, and overrides any caching headers. By
1408 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
1409 #
1410 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
1411 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
1412 # * 405 (Method Not Found), 501 (Not Implemented): 60s
1413 #
1414 # These defaults can be overridden in `negativeCachingPolicy`.
1415 # If not specified, Cloud CDN applies negative caching by default.
1416 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
1417 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
1418 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
1419 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
1420 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
1421 # all response codes that you wish to cache. Cloud CDN will not apply any
1422 # default negative caching when a policy exists.
1423 { # Specify CDN TTLs for response error codes.
1424 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
1425 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
1426 # specified as values, and you cannot specify a status code more than
1427 # once.
1428 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
1429 # corresponding status code.
1430 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
1431 # objects may be evicted from the cache before the defined TTL.
1432 # as a count of seconds and fractions of seconds at nanosecond
1433 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1434 # or &quot;month&quot;. Range is approximately 10,000 years.
1435 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1436 # Durations less than one second are represented with a 0
1437 # `seconds` field and a positive `nanos` field. Must be from 0
1438 # to 999,999,999 inclusive.
1439 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1440 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1441 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1442 },
1443 },
1444 ],
1445 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
1446 # requests into a small number of requests to the origin. If not specified,
1447 # Cloud CDN applies request coalescing by default.
1448 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
1449 # content with the origin, or when an error is encountered when refreshing
1450 # the cache.
1451 # This setting defines the default &quot;max-stale&quot; duration for any cached
1452 # responses that do not specify a max-stale directive. Stale responses that
1453 # exceed the TTL configured here will not be served. The default limit
1454 # (max-stale) is 86400s (1 day), which will allow stale content to be
1455 # served up to this limit beyond the max-age (or s-maxage) of a cached
1456 # response.
1457 # The maximum allowed value is 604800 (1 week).
1458 # Set this to zero (0) to disable serve-while-stale.
1459 # as a count of seconds and fractions of seconds at nanosecond
1460 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1461 # or &quot;month&quot;. Range is approximately 10,000 years.
1462 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1463 # Durations less than one second are represented with a 0
1464 # `seconds` field and a positive `nanos` field. Must be from 0
1465 # to 999,999,999 inclusive.
1466 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1467 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1468 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1469 },
1470 },
1471 &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
1472 # information about the W3C recommendation for cross-origin resource sharing
1473 # (CORS), see Fetch API Living
1474 # Standard.
1475 #
1476 # Not supported when the URL map is bound to a target gRPC proxy.
1477 # information about the W3C recommendation for cross-origin resource sharing
1478 # (CORS), see Fetch API Living
1479 # Standard.
1480 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
1481 # indicates that
1482 # the actual request can include user credentials. This field translates to
1483 # the Access-Control-Allow-Credentials header.
1484 #
1485 # Default is false.
1486 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
1487 # header.
1488 &quot;A String&quot;,
1489 ],
1490 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
1491 # header.
1492 &quot;A String&quot;,
1493 ],
1494 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
1495 # more information, see regular expression syntax.
1496 #
1497 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
1498 #
1499 # Regular expressions can only be used when the loadBalancingScheme is
1500 # set to INTERNAL_SELF_MANAGED.
1501 &quot;A String&quot;,
1502 ],
1503 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
1504 #
1505 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
1506 &quot;A String&quot;,
1507 ],
1508 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
1509 # The default value is false, which indicates that the CORS
1510 # policy is in effect.
1511 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
1512 # header.
1513 &quot;A String&quot;,
1514 ],
1515 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
1516 # seconds. This field translates to the Access-Control-Max-Age
1517 # header.
1518 },
1519 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
1520 # the resiliency of clients to backend service failure. As part of fault
1521 # injection, when clients send requests to a backend service, delays can be
1522 # introduced by a load balancer on a percentage of requests before sending
1523 # those requests to the backend service. Similarly requests from clients can
1524 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
1525 # that are configured with a fault_injection_policy if:
1526 # 1. The traffic is generated by fault injection AND
1527 # 2. The fault injection is not a delay fault injection.
1528 # Fault injection is not supported with the classic Application Load Balancer
1529 # . To see which load balancers support fault injection,
1530 # see Load
1531 # balancing: Routing and traffic management features.
1532 # the resiliency of clients to backend service failure. As part of fault
1533 # injection, when clients send requests to a backend service, delays can be
1534 # introduced by the load balancer on a percentage of requests before sending
1535 # those request to the backend service. Similarly requests from clients can be
1536 # aborted by the load balancer for a percentage of requests.
1537 &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
1538 # injection.
1539 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
1540 #
1541 # The value must be from 200 to 599 inclusive.
1542 #
1543 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
1544 # according to this
1545 # mapping table. HTTP status 200 is mapped to gRPC status
1546 # UNKNOWN. Injecting an OK status is currently not supported by
1547 # Traffic Director.
1548 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
1549 # that is aborted as part of fault injection.
1550 #
1551 # The value must be from 0.0 to 100.0 inclusive.
1552 },
1553 &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
1554 # injection, before being sent to a backend service.
1555 # request to the backend service as part of fault injection.
1556 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
1557 # as a count of seconds and fractions of seconds at nanosecond
1558 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1559 # or &quot;month&quot;. Range is approximately 10,000 years.
1560 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1561 # Durations less than one second are represented with a 0
1562 # `seconds` field and a positive `nanos` field. Must be from 0
1563 # to 999,999,999 inclusive.
1564 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1565 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1566 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1567 },
1568 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
1569 # which a delay is introduced as part of fault injection.
1570 #
1571 # The value must be from 0.0 to 100.0 inclusive.
1572 },
1573 },
1574 &quot;imageOptimizationPolicy&quot;: { # The configuration for Cloud CDN&#x27;s image optimization feature. This feature # Image optimization policy for this URL Map&#x27;s route. Available only for
1575 # Global EXTERNAL_MANAGED load balancer schemes.
1576 # Either Cloud CDN must be enabled on the backend service or backend bucket
1577 # serving the route, or cache policy must be configured on the same route
1578 # dynamically processes and delivers images from the network edge.
1579 # Image Optimization is only available for Global External Application Load
1580 # Balancers.
1581 # Either Cloud CDN must be enabled on the backend service or backend bucket
1582 # serving the route, or cache policy must be configured on the same route.
1583 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
1584 },
1585 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
1586 # Unlike the timeout field where the timeout duration starts
1587 # from the time the request has been fully processed (known as*end-of-stream*),
1588 # the duration in this field is computed from the beginning of the stream
1589 # until the response has been processed, including all retries. A
1590 # stream that does not complete in this duration is closed.
1591 #
1592 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
1593 # with the route.
1594 #
1595 # This field is only allowed if the Url map is used with backend services
1596 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
1597 # as a count of seconds and fractions of seconds at nanosecond
1598 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1599 # or &quot;month&quot;. Range is approximately 10,000 years.
1600 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1601 # Durations less than one second are represented with a 0
1602 # `seconds` field and a positive `nanos` field. Must be from 0
1603 # to 999,999,999 inclusive.
1604 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1605 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1606 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1607 },
1608 &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
1609 # are shadowed to a separate mirrored backend service. The load balancer does
1610 # not wait for responses from the shadow service. Before sending traffic
1611 # to the shadow service, the host / authority header is suffixed with-shadow.
1612 #
1613 # Not supported when the URL map is bound to a target gRPC proxy that
1614 # has the validateForProxyless field set to true.
1615 # are shadowed to a separate mirrored backend service. The load balancer
1616 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
1617 # to the shadow service, the host or authority header is suffixed with-shadow.
1618 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
1619 # mirrored to.
1620 #
1621 # The backend service configured for a mirroring
1622 # policy must reference backends that are of the same type as the original
1623 # backend service matched in the URL map.
1624 #
1625 # Serverless NEG backends are not currently supported as a mirrored
1626 # backend service.
1627 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
1628 },
1629 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
1630 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
1631 # If not specified, defaults to 1.
1632 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
1633 #
1634 # If not specified, will use the timeout set in theHttpRouteAction field.
1635 # If timeout in the HttpRouteAction field is not set, this field
1636 # uses the largest timeout
1637 # among all backend services associated with the route.
1638 #
1639 # Not supported when the URL map is bound to a target gRPC proxy that
1640 # has the validateForProxyless field set to true.
1641 # as a count of seconds and fractions of seconds at nanosecond
1642 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1643 # or &quot;month&quot;. Range is approximately 10,000 years.
1644 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1645 # Durations less than one second are represented with a 0
1646 # `seconds` field and a positive `nanos` field. Must be from 0
1647 # to 999,999,999 inclusive.
1648 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1649 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1650 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1651 },
1652 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
1653 # values are:
1654 #
1655 # - 5xx: retry is attempted if the instance or endpoint
1656 # responds with any 5xx response code, or if the instance or
1657 # endpoint does not respond at all. For example, disconnects, reset, read
1658 # timeout, connection failure, and refused streams.
1659 # - gateway-error: Similar to 5xx, but only
1660 # applies to response codes 502, 503 or504.
1661 # - connect-failure: a retry is attempted on failures
1662 # connecting to the instance or endpoint. For example, connection
1663 # timeouts.
1664 # - retriable-4xx: a retry is attempted if the instance
1665 # or endpoint responds with a 4xx response code.
1666 # The only error that you can retry is error code 409.
1667 # - refused-stream: a retry is attempted if the instance
1668 # or endpoint resets the stream with a REFUSED_STREAM error
1669 # code. This reset type indicates that it is safe to retry.
1670 # - cancelled: a retry is attempted if the gRPC status
1671 # code in the response header is set to cancelled.
1672 # - deadline-exceeded: a retry is attempted if the gRPC
1673 # status code in the response header is set todeadline-exceeded.
1674 # - internal: a retry is attempted if the gRPC
1675 # status code in the response header is set tointernal.
1676 # - resource-exhausted: a retry is attempted if the gRPC
1677 # status code in the response header is set toresource-exhausted.
1678 # - unavailable: a retry is attempted if the gRPC
1679 # status code in the response header is set tounavailable.
1680 #
1681 # Only the following codes are supported when the URL map is bound to
1682 # target gRPC proxy that has validateForProxyless field set to true.
1683 #
1684 # - cancelled
1685 # - deadline-exceeded
1686 # - internal
1687 # - resource-exhausted
1688 # - unavailable
1689 &quot;A String&quot;,
1690 ],
1691 },
1692 &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
1693 # time the request has been fully processed (known as *end-of-stream*)
1694 # up until the response has been processed. Timeout includes
1695 # all retries.
1696 #
1697 # If not specified, this field uses the largest timeout among all backend
1698 # services associated with the route.
1699 #
1700 # Not supported when the URL map is bound to a target gRPC proxy that
1701 # has validateForProxyless field set to true.
1702 # as a count of seconds and fractions of seconds at nanosecond
1703 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1704 # or &quot;month&quot;. Range is approximately 10,000 years.
1705 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1706 # Durations less than one second are represented with a 0
1707 # `seconds` field and a positive `nanos` field. Must be from 0
1708 # to 999,999,999 inclusive.
1709 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1710 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1711 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1712 },
1713 &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
1714 # to the matched service.
1715 #
1716 # urlRewrite is the only action supported in UrlMaps
1717 # for classic Application Load Balancers.
1718 #
1719 # Not supported when the URL map is bound to a target gRPC proxy that
1720 # has the validateForProxyless field set to true.
1721 # backend service.
1722 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
1723 # host header is replaced with contents of hostRewrite.
1724 #
1725 # The value must be from 1 to 255 characters.
1726 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
1727 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
1728 #
1729 # The value must be from 1 to 1024 characters.
1730 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
1731 # header) using the HTTP template syntax.
1732 #
1733 # A corresponding
1734 # path_template_match must be specified. Any template variables must exist in
1735 # the path_template_match field.
1736 #
1737 #
1738 # - -At least one variable must be specified in the path_template_match
1739 # field
1740 # - You can omit variables from the rewritten URL
1741 # - The * and ** operators cannot be matched
1742 # unless they have a corresponding variable name - e.g.
1743 # {format=*} or {var=**}.
1744 #
1745 # For example, a path_template_match of /static/{format=**}
1746 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
1747 # rewrite, so that /{country}/{format}/{suffix=**} can be
1748 # rewritten as /content/{format}/{country}/{suffix}.
1749 #
1750 # At least
1751 # one non-empty routeRules[].matchRules[].path_template_match is
1752 # required.
1753 #
1754 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
1755 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
1756 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
1757 # It uses RE2 syntax with the following constraints:
1758 #
1759 #
1760 # - Any single character operators
1761 # - Groups are allowed to have only submatch operator inside
1762 # - Groups are allowed only without any char repetition, e.g.
1763 # .*
1764 # - Any char repetition, e.g. .*, is
1765 # only allowed to be used in a single regex together with:
1766 #
1767 #
1768 # - Empty string operators
1769 # - Other repetitions
1770 # - Ranges
1771 # - Repetitions of ranges
1772 #
1773 #
1774 # - Ranges are only allowed to have:
1775 #
1776 #
1777 # - Character range
1778 # - Digits range
1779 # - Symbols listed in characters allowed for ranges
1780 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
1781 # the path.
1782 },
1783 },
1784 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
1785 # occurs. The weights determine the fraction of traffic that flows to
1786 # their corresponding backend service. If all traffic needs to
1787 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
1788 #
1789 # After a backend service is identified and before forwarding
1790 # the request to
1791 # the backend service, advanced routing actions such as URL rewrites and
1792 # header transformations are applied depending on additional settings
1793 # specified in this HttpRouteAction.
1794 { # In contrast to a single BackendService in
1795 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
1796 # multiple backend services. The volume of traffic for each
1797 # backend service is proportional to the weight specified
1798 # in each WeightedBackendService
1799 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
1800 # resource. Before
1801 # forwarding the request to backendService, the load balancer
1802 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
1803 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
1804 # effect for the selected backendService.
1805 #
1806 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
1807 #
1808 # headerAction is not supported for load balancers that have
1809 # their loadBalancingScheme set to EXTERNAL.
1810 #
1811 # Not supported when the URL map is bound to a target gRPC proxy that
1812 # has validateForProxyless field set to true.
1813 # the request is passed along to the selected backendService.
1814 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
1815 { # Specification determining how headers are added to requests or responses.
1816 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
1817 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
1818 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
1819 # that already
1820 # exist for the header. If true, headerValue is set for the
1821 # header, discarding any values that were set for that header.
1822 #
1823 # The default value is true,
1824 # unless a variable is present in headerValue,
1825 # in which case the default value is false.
1826 # .
1827 },
1828 ],
1829 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
1830 # request before forwarding the request to the backendService.
1831 &quot;A String&quot;,
1832 ],
1833 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
1834 # client.
1835 { # Specification determining how headers are added to requests or responses.
1836 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
1837 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
1838 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
1839 # that already
1840 # exist for the header. If true, headerValue is set for the
1841 # header, discarding any values that were set for that header.
1842 #
1843 # The default value is true,
1844 # unless a variable is present in headerValue,
1845 # in which case the default value is false.
1846 # .
1847 },
1848 ],
1849 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
1850 # response before sending the response back to the client.
1851 &quot;A String&quot;,
1852 ],
1853 },
1854 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
1855 # computed asweight / (sum of all weightedBackendService weights in routeAction).
1856 #
1857 # The selection of a backend service is determined only for new traffic.
1858 # Once a user&#x27;s request has been directed to a backend service,
1859 # subsequent requests are sent to the same backend service as
1860 # determined by the backend service&#x27;s session affinity policy.
1861 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
1862 # splitting. If you do, the weighted traffic splitting configuration takes
1863 # precedence.
1864 #
1865 # The value must be from 0 to 1000.
1866 },
1867 ],
1868 },
1869 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource. This
1870 # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
1871 # matched. For example, the
1872 # following are all valid URLs to a BackendService resource:
1873 #
1874 #
1875 # - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
1876 # - compute/v1/projects/project/global/backendServices/backendService
1877 # - global/backendServices/backendService
1878 #
1879 #
1880 # If defaultRouteAction is also specified, advanced
1881 # routing actions, such as URL rewrites, take effect before sending the
1882 # request to the backend.
1883 #
1884 #
1885 # Only one of defaultUrlRedirect, defaultService
1886 # or defaultRouteAction.weightedBackendService can be set.
1887 #
1888 #
1889 # Authorization requires one or more of the following Google IAM permissions on the
1890 # specified resource default_service:
1891 #
1892 #
1893 # - compute.backendBuckets.use
1894 # - compute.backendServices.use
1895 &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
1896 # by defaultUrlRedirect.
1897 #
1898 #
1899 # Only one of defaultUrlRedirect, defaultService
1900 # or defaultRouteAction.weightedBackendService can be set.
1901 #
1902 #
1903 # Not supported when the URL map is bound to a target gRPC proxy.
1904 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
1905 # was supplied in the request.
1906 #
1907 # The value must be from 1 to 255
1908 # characters.
1909 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
1910 # set to HTTPS.
1911 # If set to false, the URL scheme of the redirected request
1912 # remains the same as that of the request.
1913 #
1914 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
1915 #
1916 # The default is set to false.
1917 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
1918 # that was supplied in the request.
1919 #
1920 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
1921 # supplied, the path of the original request is used for the redirect.
1922 #
1923 # The value must be from 1 to 1024 characters.
1924 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
1925 # the HttpRouteRuleMatch, retaining the remaining portion
1926 # of the URL before redirecting the request.
1927 #
1928 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
1929 # supplied, the path of the original request is used for the redirect.
1930 #
1931 # The value must be from 1 to 1024 characters.
1932 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
1933 #
1934 # Supported values are:
1935 #
1936 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
1937 # to 301.
1938 # - FOUND, which corresponds to 302.
1939 # - SEE_OTHER which corresponds to 303.
1940 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
1941 # method is retained.
1942 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
1943 # method is retained.
1944 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
1945 # URL is
1946 # removed before redirecting the request. If set to false, the
1947 # query portion of the original URL is retained.
1948 #
1949 # The default is set to false.
1950 },
1951 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
1952 # create the resource.
1953 &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
1954 # for the selected backend service.
1955 #
1956 # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
1957 #
1958 # HeaderAction is not supported for load balancers
1959 # that have
1960 # their loadBalancingScheme set to EXTERNAL.
1961 #
1962 # Not supported when the URL map is bound to a target gRPC proxy that
1963 # has validateForProxyless field set to true.
1964 # the request is passed along to the selected backendService.
1965 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
1966 { # Specification determining how headers are added to requests or responses.
1967 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
1968 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
1969 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
1970 # that already
1971 # exist for the header. If true, headerValue is set for the
1972 # header, discarding any values that were set for that header.
1973 #
1974 # The default value is true,
1975 # unless a variable is present in headerValue,
1976 # in which case the default value is false.
1977 # .
1978 },
1979 ],
1980 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
1981 # request before forwarding the request to the backendService.
1982 &quot;A String&quot;,
1983 ],
1984 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
1985 # client.
1986 { # Specification determining how headers are added to requests or responses.
1987 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
1988 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
1989 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
1990 # that already
1991 # exist for the header. If true, headerValue is set for the
1992 # header, discarding any values that were set for that header.
1993 #
1994 # The default value is true,
1995 # unless a variable is present in headerValue,
1996 # in which case the default value is false.
1997 # .
1998 },
1999 ],
2000 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
2001 # response before sending the response back to the client.
2002 &quot;A String&quot;,
2003 ],
2004 },
2005 &quot;name&quot;: &quot;A String&quot;, # The name to which this PathMatcher is referred by theHostRule.
2006 &quot;pathRules&quot;: [ # The list of path rules. Use this list instead of routeRules
2007 # when routing based on simple path matching is all that&#x27;s required. A path
2008 # rule can only include a wildcard character (*) after a
2009 # forward slash character (&quot;/&quot;).
2010 #
2011 # The order by which path rules are specified does not matter.
2012 # Matches are always done on the longest-path-first basis.
2013 #
2014 # For example: a pathRule with a path /a/b/c/* will match
2015 # before /a/b/* irrespective of the order in which those paths appear in this
2016 # list.
2017 #
2018 # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
2019 { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
2020 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
2021 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
2022 #
2023 # If a policy for an
2024 # error code is not configured for the PathRule, a policy for
2025 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
2026 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
2027 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
2028 # effect.
2029 #
2030 # For example, consider a UrlMap with the following configuration:
2031 #
2032 #
2033 # - UrlMap.defaultCustomErrorResponsePolicy are configured
2034 # with policies for 5xx and 4xx errors
2035 # - A PathRule for /coming_soon/ is configured for the error
2036 # code 404.
2037 #
2038 # 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
2039 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
2040 # the policy in PathRule.customErrorResponsePolicy takes
2041 # effect. If any of the requests in this example encounter a 500
2042 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
2043 #
2044 # customErrorResponsePolicy is supported only for
2045 # global external Application Load Balancers.
2046 # backend service or backend bucket responds with an error.
2047 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
2048 #
2049 # In a given policy, if you specify rules for both a range of error codes
2050 # as well as rules for specific error codes then rules with specific error
2051 # codes have a higher priority. For example, assume that you configure a rule
2052 # for 401 (Un-authorized) code, and another for all 4 series
2053 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
2054 # However if the backend service returns a 403, the rule for4xx takes effect.
2055 { # Specifies the mapping between the response code that will be returned along
2056 # with the custom error content and the response code returned by the backend
2057 # service.
2058 &quot;matchResponseCodes&quot;: [ # Valid values include:
2059 #
2060 #
2061 # - A number between 400 and 599: For example
2062 # 401 or 503, in which case the load balancer
2063 # applies the policy if the error code exactly matches this value.
2064 # - 5xx: Load Balancer will apply the policy if the
2065 # backend service responds with any response code in the range of
2066 # 500 to 599.
2067 # - 4xx: Load
2068 # Balancer will apply the policy if the backend service responds with any
2069 # response code in the range of 400 to
2070 # 499.
2071 #
2072 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
2073 &quot;A String&quot;,
2074 ],
2075 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
2076 # error content. If overrideResponseCode is not supplied, the
2077 # same response code returned by the original backend bucket or backend
2078 # service is returned to the client.
2079 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
2080 #
2081 # path must start
2082 # with a leading slash. path cannot have trailing slashes.
2083 #
2084 # If the file is not available in backendBucket or the
2085 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
2086 #
2087 # The value must
2088 # be from 1 to 1024 characters
2089 },
2090 ],
2091 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
2092 # contains the custom error content. Examples are:
2093 #
2094 #
2095 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
2096 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
2097 # - global/backendBuckets/myBackendBucket
2098 #
2099 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
2100 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
2101 #
2102 # If load balancer cannot reach
2103 # the backendBucket, a simple Not Found Error will
2104 # be returned, with the original response code (oroverrideResponseCode if configured).
2105 #
2106 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
2107 },
2108 &quot;paths&quot;: [ # The list of path patterns to match. Each must start with /
2109 # and the only place a * is allowed is at the end following
2110 # a /. The string fed to the path matcher does not include
2111 # any text after the first ? or #, and
2112 # those chars are not allowed here.
2113 &quot;A String&quot;,
2114 ],
2115 &quot;routeAction&quot;: { # In response to a matching path, the load balancer
2116 # performs advanced routing actions, such as URL rewrites and header
2117 # transformations, before forwarding the request to the selected
2118 # backend.
2119 #
2120 #
2121 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
2122 #
2123 #
2124 # URL maps for classic Application Load Balancers only support
2125 # the urlRewrite action within a path rule&#x27;srouteAction.
2126 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
2127 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
2128 # property must be specified. This policy cannot be specified if any target
2129 # backend has Identity-Aware Proxy enabled.
2130 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
2131 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
2132 # header names can be specified. The cache is bypassed for all `cacheMode`
2133 # values.
2134 &quot;A String&quot;,
2135 ],
2136 &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
2137 # on the backend type: for Backend Services, the complete request URI is
2138 # used; for Backend Buckets, the request URI is used without the protocol or
2139 # host, and only query parameters known to Cloud Storage are included.
2140 # Policy defined on Route Action.
2141 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
2142 # parameters will be included. Either specify `excludedQueryParameters`
2143 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
2144 # encoded and not treated as delimiters.
2145 #
2146 # Note: This field applies to routes that use backend services. Attempting
2147 # to set it on a route that points exclusively to Backend Buckets will
2148 # result in a configuration error. For routes that point to a Backend
2149 # Bucket, use `includedQueryParameters` to define which parameters should
2150 # be part of the cache key.
2151 &quot;A String&quot;,
2152 ],
2153 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
2154 #
2155 # Note: This setting is only applicable to routes that use a Backend
2156 # Service. It does not affect requests served by a Backend Bucket, as the
2157 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
2158 # it on a route that points exclusively to Backend Buckets will result in a
2159 # configuration error.
2160 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
2161 #
2162 # Note: This setting is only applicable to routes that use a Backend
2163 # Service. It does not affect requests served by a Backend Bucket, as the
2164 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
2165 # set on a route that points exclusively to Backend Buckets will result in
2166 # a configuration error.
2167 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
2168 # `includedQueryParameters` and `excludedQueryParameters`. If neither
2169 # is set, the entire query string will be included. If false, the query
2170 # string will be excluded from the cache key entirely.
2171 #
2172 # Note: This field applies to routes that use backend services. Attempting
2173 # to set it on a route that points exclusively to Backend Buckets will
2174 # result in a configuration error. For routes that point to a Backend
2175 # Bucket, use `includedQueryParameters` to define which parameters should
2176 # be part of the cache key.
2177 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
2178 # The name=value pair will be used in the cache key Cloud CDN generates.
2179 #
2180 # Note: This setting is only applicable to routes that use a Backend
2181 # Service. It does not affect requests served by a Backend Bucket.
2182 # Attempting to set it on a route that points exclusively to Backend
2183 # Buckets will result in a configuration error. Up to 5 cookie names can be
2184 # specified.
2185 &quot;A String&quot;,
2186 ],
2187 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
2188 &quot;A String&quot;,
2189 ],
2190 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
2191 # parameters will be excluded. Either specify `includedQueryParameters`
2192 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
2193 # encoded and not treated as delimiters.
2194 &quot;A String&quot;,
2195 ],
2196 },
2197 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
2198 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
2199 &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
2200 # content. This is used to clamp the max-age (or Expires) value sent to the
2201 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
2202 # is used for the response max-age directive, along with a &quot;public&quot;
2203 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
2204 # clamps the max-age from the origin (if specified), or else sets the
2205 # response max-age directive to the lesser of the `clientTtl` and
2206 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
2207 # present. The maximum allowed value is 31,622,400s (1 year). If not
2208 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
2209 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
2210 # `USE_ORIGIN_HEADERS`.
2211 # as a count of seconds and fractions of seconds at nanosecond
2212 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2213 # or &quot;month&quot;. Range is approximately 10,000 years.
2214 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2215 # Durations less than one second are represented with a 0
2216 # `seconds` field and a positive `nanos` field. Must be from 0
2217 # to 999,999,999 inclusive.
2218 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2219 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2220 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2221 },
2222 &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
2223 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
2224 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
2225 # greater than that of `maxTtl`. When the `cacheMode` is set to
2226 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
2227 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
2228 # accessed objects may be evicted from the cache before the defined TTL. If
2229 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
2230 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
2231 # `USE_ORIGIN_HEADERS`.
2232 # as a count of seconds and fractions of seconds at nanosecond
2233 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2234 # or &quot;month&quot;. Range is approximately 10,000 years.
2235 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2236 # Durations less than one second are represented with a 0
2237 # `seconds` field and a positive `nanos` field. Must be from 0
2238 # to 999,999,999 inclusive.
2239 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2240 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2241 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2242 },
2243 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
2244 # attempt to set a max-age or s-maxage higher than this, or an Expires header
2245 # more than `maxTtl` seconds in the future will be capped at the value of
2246 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
2247 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
2248 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
2249 # Infrequently accessed objects may be evicted from the cache before the
2250 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
2251 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
2252 # mode.
2253 # as a count of seconds and fractions of seconds at nanosecond
2254 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2255 # or &quot;month&quot;. Range is approximately 10,000 years.
2256 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2257 # Durations less than one second are represented with a 0
2258 # `seconds` field and a positive `nanos` field. Must be from 0
2259 # to 999,999,999 inclusive.
2260 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2261 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2262 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2263 },
2264 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
2265 # to apply fine-grained caching for common errors or redirects.
2266 # This can reduce the load on your origin and improve end-user
2267 # experience by reducing response latency.
2268 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
2269 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
2270 # the specified response code that lack any Cache-Control, Expires, or
2271 # Pragma: no-cache directives. When the `cacheMode` is set to
2272 # `FORCE_CACHE_ALL`, negative caching applies to all responses
2273 # with the specified response code, and overrides any caching headers. By
2274 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
2275 #
2276 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
2277 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
2278 # * 405 (Method Not Found), 501 (Not Implemented): 60s
2279 #
2280 # These defaults can be overridden in `negativeCachingPolicy`.
2281 # If not specified, Cloud CDN applies negative caching by default.
2282 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
2283 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
2284 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
2285 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
2286 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
2287 # all response codes that you wish to cache. Cloud CDN will not apply any
2288 # default negative caching when a policy exists.
2289 { # Specify CDN TTLs for response error codes.
2290 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
2291 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
2292 # specified as values, and you cannot specify a status code more than
2293 # once.
2294 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
2295 # corresponding status code.
2296 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
2297 # objects may be evicted from the cache before the defined TTL.
2298 # as a count of seconds and fractions of seconds at nanosecond
2299 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2300 # or &quot;month&quot;. Range is approximately 10,000 years.
2301 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2302 # Durations less than one second are represented with a 0
2303 # `seconds` field and a positive `nanos` field. Must be from 0
2304 # to 999,999,999 inclusive.
2305 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2306 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2307 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2308 },
2309 },
2310 ],
2311 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
2312 # requests into a small number of requests to the origin. If not specified,
2313 # Cloud CDN applies request coalescing by default.
2314 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
2315 # content with the origin, or when an error is encountered when refreshing
2316 # the cache.
2317 # This setting defines the default &quot;max-stale&quot; duration for any cached
2318 # responses that do not specify a max-stale directive. Stale responses that
2319 # exceed the TTL configured here will not be served. The default limit
2320 # (max-stale) is 86400s (1 day), which will allow stale content to be
2321 # served up to this limit beyond the max-age (or s-maxage) of a cached
2322 # response.
2323 # The maximum allowed value is 604800 (1 week).
2324 # Set this to zero (0) to disable serve-while-stale.
2325 # as a count of seconds and fractions of seconds at nanosecond
2326 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2327 # or &quot;month&quot;. Range is approximately 10,000 years.
2328 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2329 # Durations less than one second are represented with a 0
2330 # `seconds` field and a positive `nanos` field. Must be from 0
2331 # to 999,999,999 inclusive.
2332 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2333 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2334 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2335 },
2336 },
2337 &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
2338 # information about the W3C recommendation for cross-origin resource sharing
2339 # (CORS), see Fetch API Living
2340 # Standard.
2341 #
2342 # Not supported when the URL map is bound to a target gRPC proxy.
2343 # information about the W3C recommendation for cross-origin resource sharing
2344 # (CORS), see Fetch API Living
2345 # Standard.
2346 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
2347 # indicates that
2348 # the actual request can include user credentials. This field translates to
2349 # the Access-Control-Allow-Credentials header.
2350 #
2351 # Default is false.
2352 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
2353 # header.
2354 &quot;A String&quot;,
2355 ],
2356 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
2357 # header.
2358 &quot;A String&quot;,
2359 ],
2360 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
2361 # more information, see regular expression syntax.
2362 #
2363 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
2364 #
2365 # Regular expressions can only be used when the loadBalancingScheme is
2366 # set to INTERNAL_SELF_MANAGED.
2367 &quot;A String&quot;,
2368 ],
2369 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
2370 #
2371 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
2372 &quot;A String&quot;,
2373 ],
2374 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
2375 # The default value is false, which indicates that the CORS
2376 # policy is in effect.
2377 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
2378 # header.
2379 &quot;A String&quot;,
2380 ],
2381 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
2382 # seconds. This field translates to the Access-Control-Max-Age
2383 # header.
2384 },
2385 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
2386 # the resiliency of clients to backend service failure. As part of fault
2387 # injection, when clients send requests to a backend service, delays can be
2388 # introduced by a load balancer on a percentage of requests before sending
2389 # those requests to the backend service. Similarly requests from clients can
2390 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
2391 # that are configured with a fault_injection_policy if:
2392 # 1. The traffic is generated by fault injection AND
2393 # 2. The fault injection is not a delay fault injection.
2394 # Fault injection is not supported with the classic Application Load Balancer
2395 # . To see which load balancers support fault injection,
2396 # see Load
2397 # balancing: Routing and traffic management features.
2398 # the resiliency of clients to backend service failure. As part of fault
2399 # injection, when clients send requests to a backend service, delays can be
2400 # introduced by the load balancer on a percentage of requests before sending
2401 # those request to the backend service. Similarly requests from clients can be
2402 # aborted by the load balancer for a percentage of requests.
2403 &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
2404 # injection.
2405 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
2406 #
2407 # The value must be from 200 to 599 inclusive.
2408 #
2409 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
2410 # according to this
2411 # mapping table. HTTP status 200 is mapped to gRPC status
2412 # UNKNOWN. Injecting an OK status is currently not supported by
2413 # Traffic Director.
2414 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
2415 # that is aborted as part of fault injection.
2416 #
2417 # The value must be from 0.0 to 100.0 inclusive.
2418 },
2419 &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
2420 # injection, before being sent to a backend service.
2421 # request to the backend service as part of fault injection.
2422 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
2423 # as a count of seconds and fractions of seconds at nanosecond
2424 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2425 # or &quot;month&quot;. Range is approximately 10,000 years.
2426 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2427 # Durations less than one second are represented with a 0
2428 # `seconds` field and a positive `nanos` field. Must be from 0
2429 # to 999,999,999 inclusive.
2430 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2431 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2432 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2433 },
2434 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
2435 # which a delay is introduced as part of fault injection.
2436 #
2437 # The value must be from 0.0 to 100.0 inclusive.
2438 },
2439 },
2440 &quot;imageOptimizationPolicy&quot;: { # The configuration for Cloud CDN&#x27;s image optimization feature. This feature # Image optimization policy for this URL Map&#x27;s route. Available only for
2441 # Global EXTERNAL_MANAGED load balancer schemes.
2442 # Either Cloud CDN must be enabled on the backend service or backend bucket
2443 # serving the route, or cache policy must be configured on the same route
2444 # dynamically processes and delivers images from the network edge.
2445 # Image Optimization is only available for Global External Application Load
2446 # Balancers.
2447 # Either Cloud CDN must be enabled on the backend service or backend bucket
2448 # serving the route, or cache policy must be configured on the same route.
2449 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
2450 },
2451 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
2452 # Unlike the timeout field where the timeout duration starts
2453 # from the time the request has been fully processed (known as*end-of-stream*),
2454 # the duration in this field is computed from the beginning of the stream
2455 # until the response has been processed, including all retries. A
2456 # stream that does not complete in this duration is closed.
2457 #
2458 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
2459 # with the route.
2460 #
2461 # This field is only allowed if the Url map is used with backend services
2462 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
2463 # as a count of seconds and fractions of seconds at nanosecond
2464 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2465 # or &quot;month&quot;. Range is approximately 10,000 years.
2466 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2467 # Durations less than one second are represented with a 0
2468 # `seconds` field and a positive `nanos` field. Must be from 0
2469 # to 999,999,999 inclusive.
2470 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2471 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2472 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2473 },
2474 &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
2475 # are shadowed to a separate mirrored backend service. The load balancer does
2476 # not wait for responses from the shadow service. Before sending traffic
2477 # to the shadow service, the host / authority header is suffixed with-shadow.
2478 #
2479 # Not supported when the URL map is bound to a target gRPC proxy that
2480 # has the validateForProxyless field set to true.
2481 # are shadowed to a separate mirrored backend service. The load balancer
2482 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
2483 # to the shadow service, the host or authority header is suffixed with-shadow.
2484 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
2485 # mirrored to.
2486 #
2487 # The backend service configured for a mirroring
2488 # policy must reference backends that are of the same type as the original
2489 # backend service matched in the URL map.
2490 #
2491 # Serverless NEG backends are not currently supported as a mirrored
2492 # backend service.
2493 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
2494 },
2495 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
2496 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
2497 # If not specified, defaults to 1.
2498 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
2499 #
2500 # If not specified, will use the timeout set in theHttpRouteAction field.
2501 # If timeout in the HttpRouteAction field is not set, this field
2502 # uses the largest timeout
2503 # among all backend services associated with the route.
2504 #
2505 # Not supported when the URL map is bound to a target gRPC proxy that
2506 # has the validateForProxyless field set to true.
2507 # as a count of seconds and fractions of seconds at nanosecond
2508 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2509 # or &quot;month&quot;. Range is approximately 10,000 years.
2510 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2511 # Durations less than one second are represented with a 0
2512 # `seconds` field and a positive `nanos` field. Must be from 0
2513 # to 999,999,999 inclusive.
2514 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2515 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2516 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2517 },
2518 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
2519 # values are:
2520 #
2521 # - 5xx: retry is attempted if the instance or endpoint
2522 # responds with any 5xx response code, or if the instance or
2523 # endpoint does not respond at all. For example, disconnects, reset, read
2524 # timeout, connection failure, and refused streams.
2525 # - gateway-error: Similar to 5xx, but only
2526 # applies to response codes 502, 503 or504.
2527 # - connect-failure: a retry is attempted on failures
2528 # connecting to the instance or endpoint. For example, connection
2529 # timeouts.
2530 # - retriable-4xx: a retry is attempted if the instance
2531 # or endpoint responds with a 4xx response code.
2532 # The only error that you can retry is error code 409.
2533 # - refused-stream: a retry is attempted if the instance
2534 # or endpoint resets the stream with a REFUSED_STREAM error
2535 # code. This reset type indicates that it is safe to retry.
2536 # - cancelled: a retry is attempted if the gRPC status
2537 # code in the response header is set to cancelled.
2538 # - deadline-exceeded: a retry is attempted if the gRPC
2539 # status code in the response header is set todeadline-exceeded.
2540 # - internal: a retry is attempted if the gRPC
2541 # status code in the response header is set tointernal.
2542 # - resource-exhausted: a retry is attempted if the gRPC
2543 # status code in the response header is set toresource-exhausted.
2544 # - unavailable: a retry is attempted if the gRPC
2545 # status code in the response header is set tounavailable.
2546 #
2547 # Only the following codes are supported when the URL map is bound to
2548 # target gRPC proxy that has validateForProxyless field set to true.
2549 #
2550 # - cancelled
2551 # - deadline-exceeded
2552 # - internal
2553 # - resource-exhausted
2554 # - unavailable
2555 &quot;A String&quot;,
2556 ],
2557 },
2558 &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
2559 # time the request has been fully processed (known as *end-of-stream*)
2560 # up until the response has been processed. Timeout includes
2561 # all retries.
2562 #
2563 # If not specified, this field uses the largest timeout among all backend
2564 # services associated with the route.
2565 #
2566 # Not supported when the URL map is bound to a target gRPC proxy that
2567 # has validateForProxyless field set to true.
2568 # as a count of seconds and fractions of seconds at nanosecond
2569 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2570 # or &quot;month&quot;. Range is approximately 10,000 years.
2571 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2572 # Durations less than one second are represented with a 0
2573 # `seconds` field and a positive `nanos` field. Must be from 0
2574 # to 999,999,999 inclusive.
2575 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2576 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2577 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2578 },
2579 &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
2580 # to the matched service.
2581 #
2582 # urlRewrite is the only action supported in UrlMaps
2583 # for classic Application Load Balancers.
2584 #
2585 # Not supported when the URL map is bound to a target gRPC proxy that
2586 # has the validateForProxyless field set to true.
2587 # backend service.
2588 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
2589 # host header is replaced with contents of hostRewrite.
2590 #
2591 # The value must be from 1 to 255 characters.
2592 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
2593 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
2594 #
2595 # The value must be from 1 to 1024 characters.
2596 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
2597 # header) using the HTTP template syntax.
2598 #
2599 # A corresponding
2600 # path_template_match must be specified. Any template variables must exist in
2601 # the path_template_match field.
2602 #
2603 #
2604 # - -At least one variable must be specified in the path_template_match
2605 # field
2606 # - You can omit variables from the rewritten URL
2607 # - The * and ** operators cannot be matched
2608 # unless they have a corresponding variable name - e.g.
2609 # {format=*} or {var=**}.
2610 #
2611 # For example, a path_template_match of /static/{format=**}
2612 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
2613 # rewrite, so that /{country}/{format}/{suffix=**} can be
2614 # rewritten as /content/{format}/{country}/{suffix}.
2615 #
2616 # At least
2617 # one non-empty routeRules[].matchRules[].path_template_match is
2618 # required.
2619 #
2620 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
2621 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
2622 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
2623 # It uses RE2 syntax with the following constraints:
2624 #
2625 #
2626 # - Any single character operators
2627 # - Groups are allowed to have only submatch operator inside
2628 # - Groups are allowed only without any char repetition, e.g.
2629 # .*
2630 # - Any char repetition, e.g. .*, is
2631 # only allowed to be used in a single regex together with:
2632 #
2633 #
2634 # - Empty string operators
2635 # - Other repetitions
2636 # - Ranges
2637 # - Repetitions of ranges
2638 #
2639 #
2640 # - Ranges are only allowed to have:
2641 #
2642 #
2643 # - Character range
2644 # - Digits range
2645 # - Symbols listed in characters allowed for ranges
2646 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
2647 # the path.
2648 },
2649 },
2650 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
2651 # occurs. The weights determine the fraction of traffic that flows to
2652 # their corresponding backend service. If all traffic needs to
2653 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
2654 #
2655 # After a backend service is identified and before forwarding
2656 # the request to
2657 # the backend service, advanced routing actions such as URL rewrites and
2658 # header transformations are applied depending on additional settings
2659 # specified in this HttpRouteAction.
2660 { # In contrast to a single BackendService in
2661 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
2662 # multiple backend services. The volume of traffic for each
2663 # backend service is proportional to the weight specified
2664 # in each WeightedBackendService
2665 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
2666 # resource. Before
2667 # forwarding the request to backendService, the load balancer
2668 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
2669 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
2670 # effect for the selected backendService.
2671 #
2672 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
2673 #
2674 # headerAction is not supported for load balancers that have
2675 # their loadBalancingScheme set to EXTERNAL.
2676 #
2677 # Not supported when the URL map is bound to a target gRPC proxy that
2678 # has validateForProxyless field set to true.
2679 # the request is passed along to the selected backendService.
2680 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
2681 { # Specification determining how headers are added to requests or responses.
2682 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
2683 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
2684 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
2685 # that already
2686 # exist for the header. If true, headerValue is set for the
2687 # header, discarding any values that were set for that header.
2688 #
2689 # The default value is true,
2690 # unless a variable is present in headerValue,
2691 # in which case the default value is false.
2692 # .
2693 },
2694 ],
2695 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
2696 # request before forwarding the request to the backendService.
2697 &quot;A String&quot;,
2698 ],
2699 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
2700 # client.
2701 { # Specification determining how headers are added to requests or responses.
2702 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
2703 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
2704 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
2705 # that already
2706 # exist for the header. If true, headerValue is set for the
2707 # header, discarding any values that were set for that header.
2708 #
2709 # The default value is true,
2710 # unless a variable is present in headerValue,
2711 # in which case the default value is false.
2712 # .
2713 },
2714 ],
2715 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
2716 # response before sending the response back to the client.
2717 &quot;A String&quot;,
2718 ],
2719 },
2720 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
2721 # computed asweight / (sum of all weightedBackendService weights in routeAction).
2722 #
2723 # The selection of a backend service is determined only for new traffic.
2724 # Once a user&#x27;s request has been directed to a backend service,
2725 # subsequent requests are sent to the same backend service as
2726 # determined by the backend service&#x27;s session affinity policy.
2727 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
2728 # splitting. If you do, the weighted traffic splitting configuration takes
2729 # precedence.
2730 #
2731 # The value must be from 0 to 1000.
2732 },
2733 ],
2734 },
2735 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
2736 # is directed if this rule is matched. If routeAction is
2737 # also specified, advanced routing actions, such as URL rewrites,
2738 # take effect before sending the request to the backend.
2739 #
2740 #
2741 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
2742 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
2743 # specified by urlRedirect.
2744 #
2745 #
2746 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
2747 #
2748 #
2749 # Not supported when the URL map is bound to a target gRPC proxy.
2750 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
2751 # was supplied in the request.
2752 #
2753 # The value must be from 1 to 255
2754 # characters.
2755 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
2756 # set to HTTPS.
2757 # If set to false, the URL scheme of the redirected request
2758 # remains the same as that of the request.
2759 #
2760 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
2761 #
2762 # The default is set to false.
2763 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
2764 # that was supplied in the request.
2765 #
2766 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
2767 # supplied, the path of the original request is used for the redirect.
2768 #
2769 # The value must be from 1 to 1024 characters.
2770 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
2771 # the HttpRouteRuleMatch, retaining the remaining portion
2772 # of the URL before redirecting the request.
2773 #
2774 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
2775 # supplied, the path of the original request is used for the redirect.
2776 #
2777 # The value must be from 1 to 1024 characters.
2778 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
2779 #
2780 # Supported values are:
2781 #
2782 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
2783 # to 301.
2784 # - FOUND, which corresponds to 302.
2785 # - SEE_OTHER which corresponds to 303.
2786 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
2787 # method is retained.
2788 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
2789 # method is retained.
2790 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
2791 # URL is
2792 # removed before redirecting the request. If set to false, the
2793 # query portion of the original URL is retained.
2794 #
2795 # The default is set to false.
2796 },
2797 },
2798 ],
2799 &quot;routeRules&quot;: [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
2800 # desired. routeRules are evaluated in order of priority, from
2801 # the lowest to highest number.
2802 #
2803 # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
2804 { # The HttpRouteRule setting specifies how to match an HTTP request
2805 # and the corresponding routing action that load balancing proxies perform.
2806 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
2807 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
2808 #
2809 # If a policy for an
2810 # error code is not configured for the RouteRule, a policy for
2811 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
2812 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
2813 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
2814 # effect.
2815 #
2816 # For example, consider a UrlMap with the following configuration:
2817 #
2818 #
2819 # - UrlMap.defaultCustomErrorResponsePolicy are configured
2820 # with policies for 5xx and 4xx errors
2821 # - A RouteRule for /coming_soon/ is configured for the
2822 # error code 404.
2823 #
2824 # 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
2825 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
2826 # the policy in RouteRule.customErrorResponsePolicy takes
2827 # effect. If any of the requests in this example encounter a 500
2828 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
2829 #
2830 # When
2831 # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
2832 # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
2833 # a retry, if load balancer is successful in reaching the
2834 # service, the customErrorResponsePolicy is ignored and
2835 # the response from the service is returned to the client.
2836 #
2837 # customErrorResponsePolicy is supported only for
2838 # global external Application Load Balancers.
2839 # backend service or backend bucket responds with an error.
2840 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
2841 #
2842 # In a given policy, if you specify rules for both a range of error codes
2843 # as well as rules for specific error codes then rules with specific error
2844 # codes have a higher priority. For example, assume that you configure a rule
2845 # for 401 (Un-authorized) code, and another for all 4 series
2846 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
2847 # However if the backend service returns a 403, the rule for4xx takes effect.
2848 { # Specifies the mapping between the response code that will be returned along
2849 # with the custom error content and the response code returned by the backend
2850 # service.
2851 &quot;matchResponseCodes&quot;: [ # Valid values include:
2852 #
2853 #
2854 # - A number between 400 and 599: For example
2855 # 401 or 503, in which case the load balancer
2856 # applies the policy if the error code exactly matches this value.
2857 # - 5xx: Load Balancer will apply the policy if the
2858 # backend service responds with any response code in the range of
2859 # 500 to 599.
2860 # - 4xx: Load
2861 # Balancer will apply the policy if the backend service responds with any
2862 # response code in the range of 400 to
2863 # 499.
2864 #
2865 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
2866 &quot;A String&quot;,
2867 ],
2868 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
2869 # error content. If overrideResponseCode is not supplied, the
2870 # same response code returned by the original backend bucket or backend
2871 # service is returned to the client.
2872 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
2873 #
2874 # path must start
2875 # with a leading slash. path cannot have trailing slashes.
2876 #
2877 # If the file is not available in backendBucket or the
2878 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
2879 #
2880 # The value must
2881 # be from 1 to 1024 characters
2882 },
2883 ],
2884 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
2885 # contains the custom error content. Examples are:
2886 #
2887 #
2888 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
2889 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
2890 # - global/backendBuckets/myBackendBucket
2891 #
2892 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
2893 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
2894 #
2895 # If load balancer cannot reach
2896 # the backendBucket, a simple Not Found Error will
2897 # be returned, with the original response code (oroverrideResponseCode if configured).
2898 #
2899 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
2900 },
2901 &quot;description&quot;: &quot;A String&quot;, # The short description conveying the intent of this routeRule.
2902 #
2903 #
2904 # The description can have a maximum length of 1024 characters.
2905 &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
2906 # for the selected backendService.
2907 #
2908 # The headerAction value specified here is applied before the
2909 # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
2910 #
2911 # HeaderAction is not supported for load balancers
2912 # that have
2913 # their loadBalancingScheme set to EXTERNAL.
2914 #
2915 # Not supported when the URL map is bound to a target gRPC proxy that
2916 # has validateForProxyless field set to true.
2917 # the request is passed along to the selected backendService.
2918 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
2919 { # Specification determining how headers are added to requests or responses.
2920 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
2921 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
2922 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
2923 # that already
2924 # exist for the header. If true, headerValue is set for the
2925 # header, discarding any values that were set for that header.
2926 #
2927 # The default value is true,
2928 # unless a variable is present in headerValue,
2929 # in which case the default value is false.
2930 # .
2931 },
2932 ],
2933 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
2934 # request before forwarding the request to the backendService.
2935 &quot;A String&quot;,
2936 ],
2937 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
2938 # client.
2939 { # Specification determining how headers are added to requests or responses.
2940 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
2941 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
2942 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
2943 # that already
2944 # exist for the header. If true, headerValue is set for the
2945 # header, discarding any values that were set for that header.
2946 #
2947 # The default value is true,
2948 # unless a variable is present in headerValue,
2949 # in which case the default value is false.
2950 # .
2951 },
2952 ],
2953 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
2954 # response before sending the response back to the client.
2955 &quot;A String&quot;,
2956 ],
2957 },
2958 &quot;httpFilterConfigs&quot;: [ # Outbound route specific configuration fornetworkservices.HttpFilter resources enabled by Traffic
2959 # Director. httpFilterConfigs only applies for load balancers
2960 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
2961 # more details.
2962 #
2963 # Not supported when the URL map is bound to a target gRPC proxy that
2964 # has validateForProxyless field set to true.
2965 { # HttpFilterConfiguration supplies additional contextual settings
2966 # for networkservices.HttpFilter resources enabled by Traffic
2967 # Director.
2968 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
2969 # YAML formatted and only contain fields defined in the protobuf identified
2970 # in configTypeUrl
2971 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
2972 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
2973 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
2974 # configuration belongs to. This name must be known to the xDS client.
2975 # Example: envoy.wasm
2976 },
2977 ],
2978 &quot;httpFilterMetadata&quot;: [ # Outbound route specific metadata supplied tonetworkservices.HttpFilter resources enabled by Traffic
2979 # Director. httpFilterMetadata only applies for load balancers
2980 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
2981 # more details.
2982 #
2983 # The only configTypeUrl supported istype.googleapis.com/google.protobuf.Struct
2984 #
2985 # Not supported when the URL map is bound to a target gRPC proxy that
2986 # has validateForProxyless field set to true.
2987 { # HttpFilterConfiguration supplies additional contextual settings
2988 # for networkservices.HttpFilter resources enabled by Traffic
2989 # Director.
2990 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
2991 # YAML formatted and only contain fields defined in the protobuf identified
2992 # in configTypeUrl
2993 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
2994 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
2995 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
2996 # configuration belongs to. This name must be known to the xDS client.
2997 # Example: envoy.wasm
2998 },
2999 ],
3000 &quot;matchRules&quot;: [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
3001 # this routeRule when any of thematchRules are satisfied. However predicates within
3002 # a given matchRule have AND semantics. All predicates
3003 # within a matchRule must match for the request to
3004 # match the rule.
3005 { # HttpRouteRuleMatch specifies a set of criteria for matching
3006 # requests to an HttpRouteRule. All specified criteria must
3007 # be satisfied for a match to occur.
3008 &quot;fullPathMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
3009 # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
3010 # that may be part of the original URL.
3011 #
3012 # fullPathMatch must be from 1 to 1024 characters.
3013 #
3014 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
3015 # specified.
3016 &quot;headerMatches&quot;: [ # Specifies a list of header match criteria, all of which must match
3017 # corresponding headers in the request.
3018 { # matchRule criteria for request header matches.
3019 &quot;exactMatch&quot;: &quot;A String&quot;, # The value should exactly match contents of exactMatch.
3020 #
3021 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
3022 &quot;headerName&quot;: &quot;A String&quot;, # The name of the HTTP header to match.
3023 #
3024 # For matching against the HTTP request&#x27;s authority, use a headerMatch
3025 # with the header name &quot;:authority&quot;.
3026 #
3027 # For matching a request&#x27;s method, use the headerName &quot;:method&quot;.
3028 #
3029 # When the URL map is bound to a target gRPC proxy that has
3030 # the validateForProxyless field set to true, only
3031 # non-binary
3032 # user-specified custom metadata and the `content-type` header are supported.
3033 # The following transport-level headers cannot be used in header matching
3034 # rules:
3035 # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
3036 # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
3037 # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
3038 # `grpc-timeout` and `grpc-trace-bin`.
3039 &quot;invertMatch&quot;: True or False, # If set to false, the headerMatch is considered a
3040 # match if the preceding match criteria are met. If set to true,
3041 # the headerMatch is considered a match if the preceding
3042 # match criteria are NOT met.
3043 #
3044 # The default setting is false.
3045 &quot;prefixMatch&quot;: &quot;A String&quot;, # The value of the header must start with the contents ofprefixMatch.
3046 #
3047 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
3048 &quot;presentMatch&quot;: True or False, # A header with the contents of headerName must exist. The
3049 # match takes place whether or not the request&#x27;s header has a value.
3050 #
3051 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
3052 &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
3053 # specified in rangeMatch. If the header does not contain an
3054 # integer, number or is empty, the match fails.
3055 #
3056 # For example for a range [-5, 0]
3057 #
3058 #
3059 # - -3 will match.
3060 # - 0 will not match.
3061 # - 0.25 will not match.
3062 # - -3someString will not match.
3063 #
3064 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
3065 #
3066 # rangeMatch is not supported for load balancers
3067 # that have loadBalancingScheme set to EXTERNAL.
3068 # within the specified integer range.
3069 &quot;rangeEnd&quot;: &quot;A String&quot;, # The end of the range (exclusive) in signed long integer format.
3070 &quot;rangeStart&quot;: &quot;A String&quot;, # The start of the range (inclusive) in signed long integer format.
3071 },
3072 &quot;regexMatch&quot;: &quot;A String&quot;, # The value of the header must match the regular expression specified inregexMatch.
3073 # For more information about regular expression syntax, see Syntax.
3074 #
3075 # For matching against a port specified in the HTTP request, use a
3076 # headerMatch with headerName set to PORT and a regular expression that
3077 # satisfies the RFC2616 Host header&#x27;s port specifier.
3078 #
3079 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
3080 #
3081 # Regular expressions can only be used when the loadBalancingScheme is
3082 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
3083 # (regional scope) or INTERNAL_MANAGED.
3084 &quot;suffixMatch&quot;: &quot;A String&quot;, # The value of the header must end with the contents ofsuffixMatch.
3085 #
3086 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
3087 },
3088 ],
3089 &quot;ignoreCase&quot;: True or False, # Specifies that prefixMatch and fullPathMatch
3090 # matches are case sensitive.
3091 #
3092 # The default value is false.
3093 #
3094 # ignoreCase must not be used with regexMatch.
3095 #
3096 # Not supported when the URL map is bound to a target gRPC proxy.
3097 &quot;metadataFilters&quot;: [ # Opaque filter criteria used by the load balancer to restrict routing
3098 # configuration to a limited set of xDS
3099 # compliant clients. In their xDS requests to the load balancer, xDS clients
3100 # present node
3101 # metadata. When there is a match, the relevant routing configuration
3102 # is made available to those proxies.
3103 #
3104 # 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
3105 # the metadata. If its filterMatchCriteria is set to
3106 # MATCH_ALL, then all of its filterLabels must match with
3107 # corresponding labels provided in the metadata. If multiple
3108 # metadata filters are specified, all of them need to be
3109 # satisfied in order to be considered a match.
3110 #
3111 # metadataFilters specified here is applied after those
3112 # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
3113 #
3114 # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
3115 #
3116 # Not supported when the URL map is bound to a target gRPC proxy that
3117 # has validateForProxyless field set to true.
3118 { # Opaque filter criteria used by load balancers to restrict routing
3119 # configuration to a limited set of load balancing proxies. Proxies and
3120 # sidecars involved in load balancing would typically present metadata to the
3121 # load balancers that need to match criteria specified here. If a match takes
3122 # place, the relevant configuration is made available to those
3123 # proxies.
3124 #
3125 # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
3126 # one of thefilterLabels must match the corresponding label provided in
3127 # the metadata. If its filterMatchCriteria is set to
3128 # MATCH_ALL, then all of its filterLabels must match with
3129 # corresponding labels provided in the metadata.
3130 #
3131 # An example for using metadataFilters would be: if
3132 # load balancing involves
3133 # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in of their XDS requests to loadbalancers.
3134 &quot;filterLabels&quot;: [ # The list of label value pairs that must match labels in the provided
3135 # metadata based on filterMatchCriteria
3136 #
3137 # This list must not be empty and can have at the most 64 entries.
3138 { # MetadataFilter label name value pairs that are expected
3139 # to match corresponding labels presented as metadata to the load balancer.
3140 &quot;name&quot;: &quot;A String&quot;, # Name of metadata label.
3141 #
3142 # The name can have a maximum length of 1024 characters and must be at
3143 # least 1 character long.
3144 &quot;value&quot;: &quot;A String&quot;, # The value of the label must match the specified value.
3145 #
3146 # value can have a maximum length of 1024 characters.
3147 },
3148 ],
3149 &quot;filterMatchCriteria&quot;: &quot;A String&quot;, # Specifies how individual filter label matches
3150 # within the list of filterLabels and contributes toward the
3151 # overall metadataFilter match.
3152 #
3153 # Supported values are:
3154 #
3155 # - MATCH_ANY: at least one of the filterLabels
3156 # must have a matching label in the provided metadata.
3157 # - MATCH_ALL: all filterLabels must have
3158 # matching labels in the provided metadata.
3159 },
3160 ],
3161 &quot;pathTemplateMatch&quot;: &quot;A String&quot;, # If specified, this field defines a path template pattern that must match
3162 # the :path header after the query string is removed.
3163 #
3164 # A path template pattern can include variables and wildcards.
3165 # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
3166 # matches a single path segment, and ** that matches zero or
3167 # more path segments. The pattern must follow these rules:
3168 #
3169 #
3170 # - The value must be between 1 and 1024 characters.
3171 # - The pattern must start with a leading slash (&quot;/&quot;).
3172 # - No more than 5 operators (variables or wildcards) may appear in
3173 # the pattern.
3174 #
3175 # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
3176 # set.
3177 &quot;prefixMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the request&#x27;s
3178 # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
3179 #
3180 # The value must be from 1 to 1024 characters.
3181 #
3182 # The * character inside a prefix match is
3183 # treated as a literal character, not as a wildcard.
3184 #
3185 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
3186 # used within a matchRule.
3187 &quot;queryParameterMatches&quot;: [ # Specifies a list of query parameter match criteria, all of which must
3188 # match corresponding query parameters in the request.
3189 #
3190 # Not supported when the URL map is bound to a target gRPC proxy.
3191 { # HttpRouteRuleMatch criteria for a request&#x27;s query parameter.
3192 &quot;exactMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
3193 # parameter exactly matches the contents of exactMatch.
3194 #
3195 # Only one of presentMatch, exactMatch, orregexMatch must be set.
3196 &quot;name&quot;: &quot;A String&quot;, # The name of the query parameter to match. The query parameter must exist in
3197 # the request, in the absence of which the request match fails.
3198 &quot;presentMatch&quot;: True or False, # Specifies that the queryParameterMatch matches if the
3199 # request contains the query parameter, irrespective of whether the
3200 # parameter has a value or not.
3201 #
3202 # Only one of presentMatch, exactMatch, orregexMatch must be set.
3203 &quot;regexMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
3204 # parameter matches the regular expression specified byregexMatch. For
3205 # more information about regular expression syntax, see Syntax.
3206 #
3207 # Only one of presentMatch, exactMatch, orregexMatch must be set.
3208 #
3209 # Regular expressions can only be used when the loadBalancingScheme is
3210 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
3211 # (regional scope) or INTERNAL_MANAGED.
3212 },
3213 ],
3214 &quot;regexMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
3215 # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
3216 # supplied with the original URL. For
3217 # more information about regular expression syntax, see Syntax.
3218 #
3219 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
3220 # specified.
3221 #
3222 # Regular expressions can only be used when the loadBalancingScheme is
3223 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
3224 # (regional scope) or INTERNAL_MANAGED.
3225 },
3226 ],
3227 &quot;priority&quot;: 42, # For routeRules within a given pathMatcher,
3228 # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
3229 # of priority, from the lowest to highest number. The priority of a
3230 # rule decreases as its number increases (1, 2, 3, N+1). The first rule
3231 # that matches the request is applied.
3232 #
3233 #
3234 # You cannot configure two or more routeRules with the same priority.
3235 # Priority for each rule must be set to a number from 0 to 2147483647
3236 # inclusive.
3237 #
3238 #
3239 # Priority numbers can have gaps, which enable you to add or remove rules
3240 # in the future without affecting the rest of the rules. For example, 1, 2,
3241 # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
3242 # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
3243 # without any impact on existing rules.
3244 &quot;routeAction&quot;: { # In response to a matching matchRule, the load balancer
3245 # performs advanced routing actions, such as URL rewrites and header
3246 # transformations, before forwarding the request to the selected backend.
3247 #
3248 #
3249 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
3250 #
3251 #
3252 # URL maps for classic Application Load Balancers only support
3253 # the urlRewrite action within a route rule&#x27;srouteAction.
3254 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
3255 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
3256 # property must be specified. This policy cannot be specified if any target
3257 # backend has Identity-Aware Proxy enabled.
3258 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
3259 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
3260 # header names can be specified. The cache is bypassed for all `cacheMode`
3261 # values.
3262 &quot;A String&quot;,
3263 ],
3264 &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
3265 # on the backend type: for Backend Services, the complete request URI is
3266 # used; for Backend Buckets, the request URI is used without the protocol or
3267 # host, and only query parameters known to Cloud Storage are included.
3268 # Policy defined on Route Action.
3269 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
3270 # parameters will be included. Either specify `excludedQueryParameters`
3271 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
3272 # encoded and not treated as delimiters.
3273 #
3274 # Note: This field applies to routes that use backend services. Attempting
3275 # to set it on a route that points exclusively to Backend Buckets will
3276 # result in a configuration error. For routes that point to a Backend
3277 # Bucket, use `includedQueryParameters` to define which parameters should
3278 # be part of the cache key.
3279 &quot;A String&quot;,
3280 ],
3281 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
3282 #
3283 # Note: This setting is only applicable to routes that use a Backend
3284 # Service. It does not affect requests served by a Backend Bucket, as the
3285 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
3286 # it on a route that points exclusively to Backend Buckets will result in a
3287 # configuration error.
3288 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
3289 #
3290 # Note: This setting is only applicable to routes that use a Backend
3291 # Service. It does not affect requests served by a Backend Bucket, as the
3292 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
3293 # set on a route that points exclusively to Backend Buckets will result in
3294 # a configuration error.
3295 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
3296 # `includedQueryParameters` and `excludedQueryParameters`. If neither
3297 # is set, the entire query string will be included. If false, the query
3298 # string will be excluded from the cache key entirely.
3299 #
3300 # Note: This field applies to routes that use backend services. Attempting
3301 # to set it on a route that points exclusively to Backend Buckets will
3302 # result in a configuration error. For routes that point to a Backend
3303 # Bucket, use `includedQueryParameters` to define which parameters should
3304 # be part of the cache key.
3305 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
3306 # The name=value pair will be used in the cache key Cloud CDN generates.
3307 #
3308 # Note: This setting is only applicable to routes that use a Backend
3309 # Service. It does not affect requests served by a Backend Bucket.
3310 # Attempting to set it on a route that points exclusively to Backend
3311 # Buckets will result in a configuration error. Up to 5 cookie names can be
3312 # specified.
3313 &quot;A String&quot;,
3314 ],
3315 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
3316 &quot;A String&quot;,
3317 ],
3318 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
3319 # parameters will be excluded. Either specify `includedQueryParameters`
3320 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
3321 # encoded and not treated as delimiters.
3322 &quot;A String&quot;,
3323 ],
3324 },
3325 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
3326 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
3327 &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
3328 # content. This is used to clamp the max-age (or Expires) value sent to the
3329 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
3330 # is used for the response max-age directive, along with a &quot;public&quot;
3331 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
3332 # clamps the max-age from the origin (if specified), or else sets the
3333 # response max-age directive to the lesser of the `clientTtl` and
3334 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
3335 # present. The maximum allowed value is 31,622,400s (1 year). If not
3336 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
3337 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
3338 # `USE_ORIGIN_HEADERS`.
3339 # as a count of seconds and fractions of seconds at nanosecond
3340 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3341 # or &quot;month&quot;. Range is approximately 10,000 years.
3342 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3343 # Durations less than one second are represented with a 0
3344 # `seconds` field and a positive `nanos` field. Must be from 0
3345 # to 999,999,999 inclusive.
3346 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3347 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3348 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3349 },
3350 &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
3351 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
3352 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
3353 # greater than that of `maxTtl`. When the `cacheMode` is set to
3354 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
3355 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
3356 # accessed objects may be evicted from the cache before the defined TTL. If
3357 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
3358 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
3359 # `USE_ORIGIN_HEADERS`.
3360 # as a count of seconds and fractions of seconds at nanosecond
3361 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3362 # or &quot;month&quot;. Range is approximately 10,000 years.
3363 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3364 # Durations less than one second are represented with a 0
3365 # `seconds` field and a positive `nanos` field. Must be from 0
3366 # to 999,999,999 inclusive.
3367 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3368 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3369 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3370 },
3371 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
3372 # attempt to set a max-age or s-maxage higher than this, or an Expires header
3373 # more than `maxTtl` seconds in the future will be capped at the value of
3374 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
3375 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
3376 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
3377 # Infrequently accessed objects may be evicted from the cache before the
3378 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
3379 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
3380 # mode.
3381 # as a count of seconds and fractions of seconds at nanosecond
3382 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3383 # or &quot;month&quot;. Range is approximately 10,000 years.
3384 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3385 # Durations less than one second are represented with a 0
3386 # `seconds` field and a positive `nanos` field. Must be from 0
3387 # to 999,999,999 inclusive.
3388 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3389 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3390 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3391 },
3392 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
3393 # to apply fine-grained caching for common errors or redirects.
3394 # This can reduce the load on your origin and improve end-user
3395 # experience by reducing response latency.
3396 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
3397 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
3398 # the specified response code that lack any Cache-Control, Expires, or
3399 # Pragma: no-cache directives. When the `cacheMode` is set to
3400 # `FORCE_CACHE_ALL`, negative caching applies to all responses
3401 # with the specified response code, and overrides any caching headers. By
3402 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
3403 #
3404 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
3405 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
3406 # * 405 (Method Not Found), 501 (Not Implemented): 60s
3407 #
3408 # These defaults can be overridden in `negativeCachingPolicy`.
3409 # If not specified, Cloud CDN applies negative caching by default.
3410 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
3411 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
3412 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
3413 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
3414 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
3415 # all response codes that you wish to cache. Cloud CDN will not apply any
3416 # default negative caching when a policy exists.
3417 { # Specify CDN TTLs for response error codes.
3418 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
3419 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
3420 # specified as values, and you cannot specify a status code more than
3421 # once.
3422 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
3423 # corresponding status code.
3424 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
3425 # objects may be evicted from the cache before the defined TTL.
3426 # as a count of seconds and fractions of seconds at nanosecond
3427 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3428 # or &quot;month&quot;. Range is approximately 10,000 years.
3429 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3430 # Durations less than one second are represented with a 0
3431 # `seconds` field and a positive `nanos` field. Must be from 0
3432 # to 999,999,999 inclusive.
3433 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3434 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3435 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3436 },
3437 },
3438 ],
3439 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
3440 # requests into a small number of requests to the origin. If not specified,
3441 # Cloud CDN applies request coalescing by default.
3442 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
3443 # content with the origin, or when an error is encountered when refreshing
3444 # the cache.
3445 # This setting defines the default &quot;max-stale&quot; duration for any cached
3446 # responses that do not specify a max-stale directive. Stale responses that
3447 # exceed the TTL configured here will not be served. The default limit
3448 # (max-stale) is 86400s (1 day), which will allow stale content to be
3449 # served up to this limit beyond the max-age (or s-maxage) of a cached
3450 # response.
3451 # The maximum allowed value is 604800 (1 week).
3452 # Set this to zero (0) to disable serve-while-stale.
3453 # as a count of seconds and fractions of seconds at nanosecond
3454 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3455 # or &quot;month&quot;. Range is approximately 10,000 years.
3456 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3457 # Durations less than one second are represented with a 0
3458 # `seconds` field and a positive `nanos` field. Must be from 0
3459 # to 999,999,999 inclusive.
3460 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3461 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3462 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3463 },
3464 },
3465 &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
3466 # information about the W3C recommendation for cross-origin resource sharing
3467 # (CORS), see Fetch API Living
3468 # Standard.
3469 #
3470 # Not supported when the URL map is bound to a target gRPC proxy.
3471 # information about the W3C recommendation for cross-origin resource sharing
3472 # (CORS), see Fetch API Living
3473 # Standard.
3474 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
3475 # indicates that
3476 # the actual request can include user credentials. This field translates to
3477 # the Access-Control-Allow-Credentials header.
3478 #
3479 # Default is false.
3480 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
3481 # header.
3482 &quot;A String&quot;,
3483 ],
3484 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
3485 # header.
3486 &quot;A String&quot;,
3487 ],
3488 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
3489 # more information, see regular expression syntax.
3490 #
3491 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
3492 #
3493 # Regular expressions can only be used when the loadBalancingScheme is
3494 # set to INTERNAL_SELF_MANAGED.
3495 &quot;A String&quot;,
3496 ],
3497 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
3498 #
3499 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
3500 &quot;A String&quot;,
3501 ],
3502 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
3503 # The default value is false, which indicates that the CORS
3504 # policy is in effect.
3505 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
3506 # header.
3507 &quot;A String&quot;,
3508 ],
3509 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
3510 # seconds. This field translates to the Access-Control-Max-Age
3511 # header.
3512 },
3513 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
3514 # the resiliency of clients to backend service failure. As part of fault
3515 # injection, when clients send requests to a backend service, delays can be
3516 # introduced by a load balancer on a percentage of requests before sending
3517 # those requests to the backend service. Similarly requests from clients can
3518 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
3519 # that are configured with a fault_injection_policy if:
3520 # 1. The traffic is generated by fault injection AND
3521 # 2. The fault injection is not a delay fault injection.
3522 # Fault injection is not supported with the classic Application Load Balancer
3523 # . To see which load balancers support fault injection,
3524 # see Load
3525 # balancing: Routing and traffic management features.
3526 # the resiliency of clients to backend service failure. As part of fault
3527 # injection, when clients send requests to a backend service, delays can be
3528 # introduced by the load balancer on a percentage of requests before sending
3529 # those request to the backend service. Similarly requests from clients can be
3530 # aborted by the load balancer for a percentage of requests.
3531 &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
3532 # injection.
3533 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
3534 #
3535 # The value must be from 200 to 599 inclusive.
3536 #
3537 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
3538 # according to this
3539 # mapping table. HTTP status 200 is mapped to gRPC status
3540 # UNKNOWN. Injecting an OK status is currently not supported by
3541 # Traffic Director.
3542 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
3543 # that is aborted as part of fault injection.
3544 #
3545 # The value must be from 0.0 to 100.0 inclusive.
3546 },
3547 &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
3548 # injection, before being sent to a backend service.
3549 # request to the backend service as part of fault injection.
3550 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
3551 # as a count of seconds and fractions of seconds at nanosecond
3552 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3553 # or &quot;month&quot;. Range is approximately 10,000 years.
3554 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3555 # Durations less than one second are represented with a 0
3556 # `seconds` field and a positive `nanos` field. Must be from 0
3557 # to 999,999,999 inclusive.
3558 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3559 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3560 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3561 },
3562 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
3563 # which a delay is introduced as part of fault injection.
3564 #
3565 # The value must be from 0.0 to 100.0 inclusive.
3566 },
3567 },
3568 &quot;imageOptimizationPolicy&quot;: { # The configuration for Cloud CDN&#x27;s image optimization feature. This feature # Image optimization policy for this URL Map&#x27;s route. Available only for
3569 # Global EXTERNAL_MANAGED load balancer schemes.
3570 # Either Cloud CDN must be enabled on the backend service or backend bucket
3571 # serving the route, or cache policy must be configured on the same route
3572 # dynamically processes and delivers images from the network edge.
3573 # Image Optimization is only available for Global External Application Load
3574 # Balancers.
3575 # Either Cloud CDN must be enabled on the backend service or backend bucket
3576 # serving the route, or cache policy must be configured on the same route.
3577 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
3578 },
3579 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
3580 # Unlike the timeout field where the timeout duration starts
3581 # from the time the request has been fully processed (known as*end-of-stream*),
3582 # the duration in this field is computed from the beginning of the stream
3583 # until the response has been processed, including all retries. A
3584 # stream that does not complete in this duration is closed.
3585 #
3586 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
3587 # with the route.
3588 #
3589 # This field is only allowed if the Url map is used with backend services
3590 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
3591 # as a count of seconds and fractions of seconds at nanosecond
3592 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3593 # or &quot;month&quot;. Range is approximately 10,000 years.
3594 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3595 # Durations less than one second are represented with a 0
3596 # `seconds` field and a positive `nanos` field. Must be from 0
3597 # to 999,999,999 inclusive.
3598 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3599 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3600 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3601 },
3602 &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
3603 # are shadowed to a separate mirrored backend service. The load balancer does
3604 # not wait for responses from the shadow service. Before sending traffic
3605 # to the shadow service, the host / authority header is suffixed with-shadow.
3606 #
3607 # Not supported when the URL map is bound to a target gRPC proxy that
3608 # has the validateForProxyless field set to true.
3609 # are shadowed to a separate mirrored backend service. The load balancer
3610 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
3611 # to the shadow service, the host or authority header is suffixed with-shadow.
3612 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
3613 # mirrored to.
3614 #
3615 # The backend service configured for a mirroring
3616 # policy must reference backends that are of the same type as the original
3617 # backend service matched in the URL map.
3618 #
3619 # Serverless NEG backends are not currently supported as a mirrored
3620 # backend service.
3621 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
3622 },
3623 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
3624 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
3625 # If not specified, defaults to 1.
3626 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
3627 #
3628 # If not specified, will use the timeout set in theHttpRouteAction field.
3629 # If timeout in the HttpRouteAction field is not set, this field
3630 # uses the largest timeout
3631 # among all backend services associated with the route.
3632 #
3633 # Not supported when the URL map is bound to a target gRPC proxy that
3634 # has the validateForProxyless field set to true.
3635 # as a count of seconds and fractions of seconds at nanosecond
3636 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3637 # or &quot;month&quot;. Range is approximately 10,000 years.
3638 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3639 # Durations less than one second are represented with a 0
3640 # `seconds` field and a positive `nanos` field. Must be from 0
3641 # to 999,999,999 inclusive.
3642 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3643 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3644 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3645 },
3646 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
3647 # values are:
3648 #
3649 # - 5xx: retry is attempted if the instance or endpoint
3650 # responds with any 5xx response code, or if the instance or
3651 # endpoint does not respond at all. For example, disconnects, reset, read
3652 # timeout, connection failure, and refused streams.
3653 # - gateway-error: Similar to 5xx, but only
3654 # applies to response codes 502, 503 or504.
3655 # - connect-failure: a retry is attempted on failures
3656 # connecting to the instance or endpoint. For example, connection
3657 # timeouts.
3658 # - retriable-4xx: a retry is attempted if the instance
3659 # or endpoint responds with a 4xx response code.
3660 # The only error that you can retry is error code 409.
3661 # - refused-stream: a retry is attempted if the instance
3662 # or endpoint resets the stream with a REFUSED_STREAM error
3663 # code. This reset type indicates that it is safe to retry.
3664 # - cancelled: a retry is attempted if the gRPC status
3665 # code in the response header is set to cancelled.
3666 # - deadline-exceeded: a retry is attempted if the gRPC
3667 # status code in the response header is set todeadline-exceeded.
3668 # - internal: a retry is attempted if the gRPC
3669 # status code in the response header is set tointernal.
3670 # - resource-exhausted: a retry is attempted if the gRPC
3671 # status code in the response header is set toresource-exhausted.
3672 # - unavailable: a retry is attempted if the gRPC
3673 # status code in the response header is set tounavailable.
3674 #
3675 # Only the following codes are supported when the URL map is bound to
3676 # target gRPC proxy that has validateForProxyless field set to true.
3677 #
3678 # - cancelled
3679 # - deadline-exceeded
3680 # - internal
3681 # - resource-exhausted
3682 # - unavailable
3683 &quot;A String&quot;,
3684 ],
3685 },
3686 &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
3687 # time the request has been fully processed (known as *end-of-stream*)
3688 # up until the response has been processed. Timeout includes
3689 # all retries.
3690 #
3691 # If not specified, this field uses the largest timeout among all backend
3692 # services associated with the route.
3693 #
3694 # Not supported when the URL map is bound to a target gRPC proxy that
3695 # has validateForProxyless field set to true.
3696 # as a count of seconds and fractions of seconds at nanosecond
3697 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3698 # or &quot;month&quot;. Range is approximately 10,000 years.
3699 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3700 # Durations less than one second are represented with a 0
3701 # `seconds` field and a positive `nanos` field. Must be from 0
3702 # to 999,999,999 inclusive.
3703 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3704 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3705 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3706 },
3707 &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
3708 # to the matched service.
3709 #
3710 # urlRewrite is the only action supported in UrlMaps
3711 # for classic Application Load Balancers.
3712 #
3713 # Not supported when the URL map is bound to a target gRPC proxy that
3714 # has the validateForProxyless field set to true.
3715 # backend service.
3716 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
3717 # host header is replaced with contents of hostRewrite.
3718 #
3719 # The value must be from 1 to 255 characters.
3720 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
3721 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
3722 #
3723 # The value must be from 1 to 1024 characters.
3724 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
3725 # header) using the HTTP template syntax.
3726 #
3727 # A corresponding
3728 # path_template_match must be specified. Any template variables must exist in
3729 # the path_template_match field.
3730 #
3731 #
3732 # - -At least one variable must be specified in the path_template_match
3733 # field
3734 # - You can omit variables from the rewritten URL
3735 # - The * and ** operators cannot be matched
3736 # unless they have a corresponding variable name - e.g.
3737 # {format=*} or {var=**}.
3738 #
3739 # For example, a path_template_match of /static/{format=**}
3740 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
3741 # rewrite, so that /{country}/{format}/{suffix=**} can be
3742 # rewritten as /content/{format}/{country}/{suffix}.
3743 #
3744 # At least
3745 # one non-empty routeRules[].matchRules[].path_template_match is
3746 # required.
3747 #
3748 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
3749 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
3750 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
3751 # It uses RE2 syntax with the following constraints:
3752 #
3753 #
3754 # - Any single character operators
3755 # - Groups are allowed to have only submatch operator inside
3756 # - Groups are allowed only without any char repetition, e.g.
3757 # .*
3758 # - Any char repetition, e.g. .*, is
3759 # only allowed to be used in a single regex together with:
3760 #
3761 #
3762 # - Empty string operators
3763 # - Other repetitions
3764 # - Ranges
3765 # - Repetitions of ranges
3766 #
3767 #
3768 # - Ranges are only allowed to have:
3769 #
3770 #
3771 # - Character range
3772 # - Digits range
3773 # - Symbols listed in characters allowed for ranges
3774 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
3775 # the path.
3776 },
3777 },
3778 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
3779 # occurs. The weights determine the fraction of traffic that flows to
3780 # their corresponding backend service. If all traffic needs to
3781 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
3782 #
3783 # After a backend service is identified and before forwarding
3784 # the request to
3785 # the backend service, advanced routing actions such as URL rewrites and
3786 # header transformations are applied depending on additional settings
3787 # specified in this HttpRouteAction.
3788 { # In contrast to a single BackendService in
3789 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
3790 # multiple backend services. The volume of traffic for each
3791 # backend service is proportional to the weight specified
3792 # in each WeightedBackendService
3793 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
3794 # resource. Before
3795 # forwarding the request to backendService, the load balancer
3796 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
3797 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
3798 # effect for the selected backendService.
3799 #
3800 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
3801 #
3802 # headerAction is not supported for load balancers that have
3803 # their loadBalancingScheme set to EXTERNAL.
3804 #
3805 # Not supported when the URL map is bound to a target gRPC proxy that
3806 # has validateForProxyless field set to true.
3807 # the request is passed along to the selected backendService.
3808 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
3809 { # Specification determining how headers are added to requests or responses.
3810 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
3811 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
3812 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
3813 # that already
3814 # exist for the header. If true, headerValue is set for the
3815 # header, discarding any values that were set for that header.
3816 #
3817 # The default value is true,
3818 # unless a variable is present in headerValue,
3819 # in which case the default value is false.
3820 # .
3821 },
3822 ],
3823 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
3824 # request before forwarding the request to the backendService.
3825 &quot;A String&quot;,
3826 ],
3827 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
3828 # client.
3829 { # Specification determining how headers are added to requests or responses.
3830 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
3831 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
3832 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
3833 # that already
3834 # exist for the header. If true, headerValue is set for the
3835 # header, discarding any values that were set for that header.
3836 #
3837 # The default value is true,
3838 # unless a variable is present in headerValue,
3839 # in which case the default value is false.
3840 # .
3841 },
3842 ],
3843 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
3844 # response before sending the response back to the client.
3845 &quot;A String&quot;,
3846 ],
3847 },
3848 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
3849 # computed asweight / (sum of all weightedBackendService weights in routeAction).
3850 #
3851 # The selection of a backend service is determined only for new traffic.
3852 # Once a user&#x27;s request has been directed to a backend service,
3853 # subsequent requests are sent to the same backend service as
3854 # determined by the backend service&#x27;s session affinity policy.
3855 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
3856 # splitting. If you do, the weighted traffic splitting configuration takes
3857 # precedence.
3858 #
3859 # The value must be from 0 to 1000.
3860 },
3861 ],
3862 },
3863 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
3864 # is directed if this rule is matched. If routeAction is
3865 # also specified, advanced routing actions, such as URL rewrites,
3866 # take effect before sending the request to the backend.
3867 #
3868 #
3869 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
3870 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
3871 # specified by urlRedirect.
3872 #
3873 #
3874 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
3875 #
3876 #
3877 # Not supported when the URL map is bound to a target gRPC proxy.
3878 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
3879 # was supplied in the request.
3880 #
3881 # The value must be from 1 to 255
3882 # characters.
3883 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
3884 # set to HTTPS.
3885 # If set to false, the URL scheme of the redirected request
3886 # remains the same as that of the request.
3887 #
3888 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
3889 #
3890 # The default is set to false.
3891 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
3892 # that was supplied in the request.
3893 #
3894 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
3895 # supplied, the path of the original request is used for the redirect.
3896 #
3897 # The value must be from 1 to 1024 characters.
3898 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
3899 # the HttpRouteRuleMatch, retaining the remaining portion
3900 # of the URL before redirecting the request.
3901 #
3902 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
3903 # supplied, the path of the original request is used for the redirect.
3904 #
3905 # The value must be from 1 to 1024 characters.
3906 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
3907 #
3908 # Supported values are:
3909 #
3910 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
3911 # to 301.
3912 # - FOUND, which corresponds to 302.
3913 # - SEE_OTHER which corresponds to 303.
3914 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
3915 # method is retained.
3916 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
3917 # method is retained.
3918 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
3919 # URL is
3920 # removed before redirecting the request. If set to false, the
3921 # query portion of the original URL is retained.
3922 #
3923 # The default is set to false.
3924 },
3925 },
3926 ],
3927 },
3928 ],
3929 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the regional URL map resides.
3930 # This field is not applicable to global URL maps.
3931 # You must specify this field as part of the HTTP request URL. It is
3932 # not settable as a field in the request body.
3933 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
3934 &quot;status&quot;: { # [Output Only] The status of the URL map. # Output only. [Output Only] The status of the URL map.
3935 &quot;quotaUsage&quot;: { # Message representing the quota usage for a UrlMap. # Output only. Summary of quota usage for given UrlMap.
3936 &quot;forwardingRules&quot;: 42, # Output only. The number of forwarding rules that uses this UrlMap.
3937 &quot;units&quot;: &quot;A String&quot;, # Output only. The number of quota units calculated for this UrlMap.
3938 },
3939 },
3940 &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
3941 # maximum of 100 tests per UrlMap.
3942 #
3943 # Not supported when the URL map is bound to a target gRPC proxy that
3944 # has validateForProxyless field set to true.
3945 { # Message for the expected URL mappings.
3946 &quot;backendServiceWeight&quot;: 42, # The weight to use for the supplied host and path when using advanced
3947 # routing rules that involve traffic splitting.
3948 &quot;description&quot;: &quot;A String&quot;, # Description of this test case.
3949 &quot;expectedOutputUrl&quot;: &quot;A String&quot;, # The expected output URL evaluated by the load balancer
3950 # containing the scheme, host, path and query parameters.
3951 #
3952 # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
3953 # the load balancer to backends. For rules with urlRewrite,
3954 # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
3955 #
3956 # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer&#x27;s
3957 # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
3958 # If urlRedirect specifies strip_query, the test
3959 # passes only if expectedOutputUrl does not contain any query
3960 # parameters.
3961 #
3962 # expectedOutputUrl is optional whenservice is specified.
3963 &quot;expectedRedirectResponseCode&quot;: 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
3964 # load balancer&#x27;s redirect response.
3965 #
3966 # expectedRedirectResponseCode cannot be set whenservice is set.
3967 &quot;expectedUrlRedirect&quot;: &quot;A String&quot;, # The expected URL that should be redirected to for the host and path
3968 # being tested.
3969 # [Deprecated] This field is deprecated.
3970 # Use expected_output_url instead.
3971 &quot;headers&quot;: [ # HTTP headers for this request. If headers contains
3972 # a host header, then host must also match the header value.
3973 { # HTTP headers used in UrlMapTests.
3974 &quot;name&quot;: &quot;A String&quot;, # Header name.
3975 &quot;value&quot;: &quot;A String&quot;, # Header value.
3976 },
3977 ],
3978 &quot;host&quot;: &quot;A String&quot;, # Host portion of the URL. If headers contains a host header,
3979 # then host must also match the header value.
3980 &quot;path&quot;: &quot;A String&quot;, # Path portion of the URL.
3981 &quot;service&quot;: &quot;A String&quot;, # Expected BackendService or BackendBucket resource
3982 # the given URL should be mapped to.
3983 #
3984 # The service field cannot
3985 # be set if expectedRedirectResponseCode is set.
3986 },
3987 ],
3988 },
3989 ],
3990 &quot;warning&quot;: { # Informational warning which replaces the list of
3991 # backend services when the list is empty.
3992 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
3993 # Engine returns NO_RESULTS_ON_PAGE if there
3994 # are no results in the response.
3995 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
3996 # value format. For example:
3997 #
3998 # &quot;data&quot;: [
3999 # {
4000 # &quot;key&quot;: &quot;scope&quot;,
4001 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
4002 # }
4003 {
4004 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
4005 # returned. For example, for warnings where there are no results in a list
4006 # request for a particular zone, this key might be scope and
4007 # the key value might be the zone name. Other examples might be a key
4008 # indicating a deprecated resource and a suggested replacement, or a
4009 # warning about invalid network settings (for example, if an instance
4010 # attempts to perform IP forwarding but is not enabled for IP forwarding).
4011 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
4012 },
4013 ],
4014 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
4015 },
4016 },
4017 },
4018 &quot;kind&quot;: &quot;compute#urlMapsAggregatedList&quot;, # Output only. Type of resource.
4019 &quot;nextPageToken&quot;: &quot;A String&quot;, # [Output Only] This token allows you to get the next page of results for
4020 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
4021 # the query parameter pageToken in the next list request.
4022 # Subsequent list requests will have their own nextPageToken to
4023 # continue paging through the results.
4024 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource.
4025 &quot;unreachables&quot;: [ # Output only. [Output Only] Unreachable resources.
4026 &quot;A String&quot;,
4027 ],
4028 &quot;warning&quot;: { # [Output Only] Informational warning message.
4029 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
4030 # Engine returns NO_RESULTS_ON_PAGE if there
4031 # are no results in the response.
4032 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
4033 # value format. For example:
4034 #
4035 # &quot;data&quot;: [
4036 # {
4037 # &quot;key&quot;: &quot;scope&quot;,
4038 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
4039 # }
4040 {
4041 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
4042 # returned. For example, for warnings where there are no results in a list
4043 # request for a particular zone, this key might be scope and
4044 # the key value might be the zone name. Other examples might be a key
4045 # indicating a deprecated resource and a suggested replacement, or a
4046 # warning about invalid network settings (for example, if an instance
4047 # attempts to perform IP forwarding but is not enabled for IP forwarding).
4048 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
4049 },
4050 ],
4051 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
4052 },
4053 }</pre>
4054 </div>
4055
4056 <div class="method">
4057 <code class="details" id="aggregatedList_next">aggregatedList_next()</code>
4058 <pre>Retrieves the next page of results.
4059
4060 Args:
4061 previous_request: The request for the previous page. (required)
4062 previous_response: The response from the request for the previous page. (required)
4063
4064 Returns:
4065 A request object that you can call &#x27;execute()&#x27; on to request the next
4066 page. Returns None if there are no more items in the collection.
4067 </pre>
4068 </div>
4069
4070 <div class="method">
4071 <code class="details" id="close">close()</code>
4072 <pre>Close httplib2 connections.</pre>
4073 </div>
4074
4075 <div class="method">
4076 <code class="details" id="delete">delete(project, urlMap, requestId=None, x__xgafv=None)</code>
4077 <pre>Deletes the specified UrlMap resource.
4078
4079 Args:
4080 project: string, Project ID for this request. (required)
4081 urlMap: string, Name of the UrlMap resource to delete. (required)
4082 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
4083 that if you must retry your request, the server will know to ignore the
4084 request if it has already been completed.
4085
4086 For example, consider a situation where you make an initial request and
4087 the request times out. If you make the request again with the same
4088 request ID, the server can check if original operation with the same
4089 request ID was received, and if so, will ignore the second request. This
4090 prevents clients from accidentally creating duplicate commitments.
4091
4092 The request ID must be
4093 a valid UUID with the exception that zero UUID is not supported
4094 (00000000-0000-0000-0000-000000000000).
4095 x__xgafv: string, V1 error format.
4096 Allowed values
4097 1 - v1 error format
4098 2 - v2 error format
4099
4100 Returns:
4101 An object of the form:
4102
4103 { # Represents an Operation resource.
4104 #
4105 # Google Compute Engine has three Operation resources:
4106 #
4107 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
4108 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
4109 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
4110 #
4111 # You can use an operation resource to manage asynchronous API requests.
4112 # For more information, readHandling
4113 # API responses.
4114 #
4115 # Operations can be global, regional or zonal.
4116 #
4117 # - For global operations, use the `globalOperations`
4118 # resource.
4119 # - For regional operations, use the
4120 # `regionOperations` resource.
4121 # - For zonal operations, use
4122 # the `zoneOperations` resource.
4123 #
4124 #
4125 #
4126 # For more information, read
4127 # Global, Regional, and Zonal Resources.
4128 #
4129 # Note that completed Operation resources have a limited
4130 # retention period.
4131 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
4132 # Not present otherwise.
4133 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
4134 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
4135 # set when the operation is created.
4136 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
4137 # text format.
4138 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
4139 # this field will be populated.
4140 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
4141 # operation.
4142 {
4143 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
4144 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
4145 # details. There is a set of defined message types to use for providing
4146 # details.The syntax depends on the error code. For example,
4147 # QuotaExceededInfo will have details when the error code is
4148 # QUOTA_EXCEEDED.
4149 {
4150 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
4151 #
4152 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
4153 # is not enabled:
4154 #
4155 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
4156 # &quot;domain&quot;: &quot;googleapis.com&quot;
4157 # &quot;metadata&quot;: {
4158 # &quot;resource&quot;: &quot;projects/123&quot;,
4159 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
4160 # }
4161 # }
4162 #
4163 # This response indicates that the pubsub.googleapis.com API is not enabled.
4164 #
4165 # Example of an error that is returned when attempting to create a Spanner
4166 # instance in a region that is out of stock:
4167 #
4168 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
4169 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
4170 # &quot;metadata&quot;: {
4171 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
4172 # }
4173 # }
4174 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
4175 # is typically the registered service name of the tool or product that
4176 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
4177 # generated by some common infrastructure, the error domain must be a
4178 # globally unique value that identifies the infrastructure. For Google API
4179 # infrastructure, the error domain is &quot;googleapis.com&quot;.
4180 &quot;metadatas&quot;: { # Additional structured details about this error.
4181 #
4182 # Keys must match a regular expression of `a-z+` but should
4183 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
4184 # length. When identifying the current value of an exceeded limit, the units
4185 # should be contained in the key, not the value. For example, rather than
4186 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
4187 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
4188 # instances that can be created in a single (batch) request.
4189 &quot;a_key&quot;: &quot;A String&quot;,
4190 },
4191 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
4192 # proximate cause of the error. Error reasons are unique within a particular
4193 # domain of errors. This should be at most 63 characters and match a
4194 # regular expression of `A-Z+[A-Z0-9]`, which represents
4195 # UPPER_SNAKE_CASE.
4196 },
4197 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
4198 #
4199 # For example, if a quota check failed with an error indicating the calling
4200 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
4201 # directly to the right place in the developer console to flip the bit.
4202 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
4203 { # Describes a URL link.
4204 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
4205 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
4206 },
4207 ],
4208 },
4209 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
4210 # which can be attached to an RPC error.
4211 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
4212 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
4213 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
4214 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
4215 },
4216 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
4217 &quot;dimensions&quot;: { # The map holding related quota dimensions.
4218 &quot;a_key&quot;: &quot;A String&quot;,
4219 },
4220 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
4221 # type or metric.
4222 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
4223 # or metric.
4224 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
4225 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
4226 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
4227 },
4228 },
4229 ],
4230 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
4231 # This property is optional.
4232 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
4233 },
4234 ],
4235 },
4236 &quot;getVersionOperationMetadata&quot;: {
4237 &quot;inlineSbomInfo&quot;: {
4238 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
4239 # appropriate identifiers.
4240 &quot;a_key&quot;: &quot;A String&quot;,
4241 },
4242 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
4243 # identifiers.
4244 &quot;a_key&quot;: &quot;A String&quot;,
4245 },
4246 },
4247 },
4248 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
4249 # message that was returned, such as `NOT FOUND`.
4250 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
4251 # status code that was returned. For example, a `404` means the
4252 # resource was not found.
4253 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
4254 # defined by the server.
4255 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
4256 # This value is inRFC3339
4257 # text format.
4258 &quot;instancesBulkInsertOperationMetadata&quot;: {
4259 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
4260 # Example key: zones/us-central1-a
4261 &quot;a_key&quot;: {
4262 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
4263 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
4264 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
4265 # error.
4266 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
4267 # if the flow is rolling forward or rolling back.
4268 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
4269 },
4270 },
4271 },
4272 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
4273 # Operation resources.
4274 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
4275 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
4276 # group of operations results from a `bulkInsert` API request.
4277 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
4278 # `update`, or `delete`, and so on.
4279 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
4280 # There is no requirement that this be linear or support any granularity of
4281 # operations. This should not be used to guess when the operation will be
4282 # complete. This number should monotonically increase as the operation
4283 # progresses.
4284 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
4285 # applicable when performing regional operations.
4286 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
4287 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
4288 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
4289 # this field will contain information on all underlying zonal actions and
4290 # their state.
4291 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
4292 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
4293 # Example key: zones/us-central1-a
4294 &quot;a_key&quot;: {
4295 &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
4296 # populated.
4297 # different programming environments, including REST APIs and RPC APIs. It is
4298 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
4299 # three pieces of data: error code, error message, and error details.
4300 #
4301 # You can find out more about this error model and how to work with it in the
4302 # [API Design Guide](https://cloud.google.com/apis/design/errors).
4303 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
4304 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
4305 # message types for APIs to use.
4306 {
4307 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
4308 },
4309 ],
4310 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
4311 # user-facing error message should be localized and sent in the
4312 # google.rpc.Status.details field, or localized by the client.
4313 },
4314 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
4315 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
4316 },
4317 },
4318 },
4319 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
4320 # This value is inRFC3339
4321 # text format.
4322 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
4323 # following:
4324 # `PENDING`, `RUNNING`, or `DONE`.
4325 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
4326 # operation.
4327 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
4328 # of the target resource.
4329 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
4330 # operations related to creating a snapshot, this points to the disk
4331 # that the snapshot was created from.
4332 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
4333 # `[email protected]` or
4334 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
4335 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
4336 # operation, this field will be populated.
4337 {
4338 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
4339 # Engine returns NO_RESULTS_ON_PAGE if there
4340 # are no results in the response.
4341 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
4342 # value format. For example:
4343 #
4344 # &quot;data&quot;: [
4345 # {
4346 # &quot;key&quot;: &quot;scope&quot;,
4347 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
4348 # }
4349 {
4350 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
4351 # returned. For example, for warnings where there are no results in a list
4352 # request for a particular zone, this key might be scope and
4353 # the key value might be the zone name. Other examples might be a key
4354 # indicating a deprecated resource and a suggested replacement, or a
4355 # warning about invalid network settings (for example, if an instance
4356 # attempts to perform IP forwarding but is not enabled for IP forwarding).
4357 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
4358 },
4359 ],
4360 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
4361 },
4362 ],
4363 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
4364 # applicable when performing per-zone operations.
4365 }</pre>
4366 </div>
4367
4368 <div class="method">
4369 <code class="details" id="get">get(project, urlMap, x__xgafv=None)</code>
4370 <pre>Returns the specified UrlMap resource.
4371
4372 Args:
4373 project: string, Project ID for this request. (required)
4374 urlMap: string, Name of the UrlMap resource to return. (required)
4375 x__xgafv: string, V1 error format.
4376 Allowed values
4377 1 - v1 error format
4378 2 - v2 error format
4379
4380 Returns:
4381 An object of the form:
4382
4383 { # Represents a URL Map resource.
4384 #
4385 # Compute Engine has two URL Map resources:
4386 #
4387 # * [Global](/compute/docs/reference/rest/alpha/urlMaps)
4388 # * [Regional](/compute/docs/reference/rest/alpha/regionUrlMaps)
4389 #
4390 # A URL map resource is a component of certain types of cloud load balancers
4391 # and Traffic Director:
4392 #
4393 # * urlMaps are used by global external Application Load
4394 # Balancers, classic Application Load Balancers, and cross-region internal
4395 # Application Load Balancers.
4396 # * regionUrlMaps are used by internal Application Load Balancers,
4397 # regional external Application Load Balancers and regional internal
4398 # Application Load Balancers.
4399 #
4400 # For a list of supported URL map features by the load balancer type, see the
4401 # Load balancing features: Routing and traffic management table.
4402 #
4403 # For a list of supported URL map features for Traffic Director, see the
4404 # Traffic Director features: Routing and traffic management table.
4405 #
4406 # This resource defines mappings from hostnames and URL paths to either a
4407 # backend service or a backend bucket.
4408 #
4409 # To use the global urlMaps resource, the backend service must
4410 # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
4411 # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
4412 # information, read URL
4413 # Map Concepts.
4414 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
4415 # text format.
4416 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
4417 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
4418 #
4419 # This policy takes
4420 # effect at the load balancer level and applies only when no policy has been
4421 # defined for the error code at lower levels like PathMatcher, RouteRule and
4422 # PathRule within this UrlMap.
4423 #
4424 # For example, consider a UrlMap with the
4425 # following configuration:
4426 #
4427 #
4428 # - defaultCustomErrorResponsePolicy containing policies for
4429 # responding to 5xx and 4xx errors
4430 # - A PathMatcher configured for *.example.com has
4431 # defaultCustomErrorResponsePolicy for 4xx.
4432 #
4433 # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
4434 # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
4435 # a request that does not match any host in *.example.com such
4436 # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
4437 # takes effect.
4438 #
4439 # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
4440 # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
4441 # a retry, if load balancer is successful in reaching the
4442 # service, the defaultCustomErrorResponsePolicy is ignored and
4443 # the response from the service is returned to the client.
4444 #
4445 # defaultCustomErrorResponsePolicy is supported only for
4446 # global external Application Load Balancers.
4447 # backend service or backend bucket responds with an error.
4448 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
4449 #
4450 # In a given policy, if you specify rules for both a range of error codes
4451 # as well as rules for specific error codes then rules with specific error
4452 # codes have a higher priority. For example, assume that you configure a rule
4453 # for 401 (Un-authorized) code, and another for all 4 series
4454 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
4455 # However if the backend service returns a 403, the rule for4xx takes effect.
4456 { # Specifies the mapping between the response code that will be returned along
4457 # with the custom error content and the response code returned by the backend
4458 # service.
4459 &quot;matchResponseCodes&quot;: [ # Valid values include:
4460 #
4461 #
4462 # - A number between 400 and 599: For example
4463 # 401 or 503, in which case the load balancer
4464 # applies the policy if the error code exactly matches this value.
4465 # - 5xx: Load Balancer will apply the policy if the
4466 # backend service responds with any response code in the range of
4467 # 500 to 599.
4468 # - 4xx: Load
4469 # Balancer will apply the policy if the backend service responds with any
4470 # response code in the range of 400 to
4471 # 499.
4472 #
4473 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
4474 &quot;A String&quot;,
4475 ],
4476 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
4477 # error content. If overrideResponseCode is not supplied, the
4478 # same response code returned by the original backend bucket or backend
4479 # service is returned to the client.
4480 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
4481 #
4482 # path must start
4483 # with a leading slash. path cannot have trailing slashes.
4484 #
4485 # If the file is not available in backendBucket or the
4486 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
4487 #
4488 # The value must
4489 # be from 1 to 1024 characters
4490 },
4491 ],
4492 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
4493 # contains the custom error content. Examples are:
4494 #
4495 #
4496 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
4497 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
4498 # - global/backendBuckets/myBackendBucket
4499 #
4500 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
4501 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
4502 #
4503 # If load balancer cannot reach
4504 # the backendBucket, a simple Not Found Error will
4505 # be returned, with the original response code (oroverrideResponseCode if configured).
4506 #
4507 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
4508 },
4509 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
4510 # hostRules match. The load balancer performs advanced routing
4511 # actions, such as URL rewrites and header transformations, before forwarding
4512 # the request to the selected backend.
4513 #
4514 #
4515 # Only one of defaultUrlRedirect, defaultService
4516 # or defaultRouteAction.weightedBackendService can be set.
4517 #
4518 #
4519 # URL maps for classic Application Load Balancers only support
4520 # the urlRewrite action within defaultRouteAction.
4521 #
4522 #
4523 # defaultRouteAction has no effect when the URL map is bound
4524 # to a target gRPC proxy that has the validateForProxyless field
4525 # set to true.
4526 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
4527 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
4528 # property must be specified. This policy cannot be specified if any target
4529 # backend has Identity-Aware Proxy enabled.
4530 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
4531 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
4532 # header names can be specified. The cache is bypassed for all `cacheMode`
4533 # values.
4534 &quot;A String&quot;,
4535 ],
4536 &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
4537 # on the backend type: for Backend Services, the complete request URI is
4538 # used; for Backend Buckets, the request URI is used without the protocol or
4539 # host, and only query parameters known to Cloud Storage are included.
4540 # Policy defined on Route Action.
4541 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
4542 # parameters will be included. Either specify `excludedQueryParameters`
4543 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
4544 # encoded and not treated as delimiters.
4545 #
4546 # Note: This field applies to routes that use backend services. Attempting
4547 # to set it on a route that points exclusively to Backend Buckets will
4548 # result in a configuration error. For routes that point to a Backend
4549 # Bucket, use `includedQueryParameters` to define which parameters should
4550 # be part of the cache key.
4551 &quot;A String&quot;,
4552 ],
4553 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
4554 #
4555 # Note: This setting is only applicable to routes that use a Backend
4556 # Service. It does not affect requests served by a Backend Bucket, as the
4557 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
4558 # it on a route that points exclusively to Backend Buckets will result in a
4559 # configuration error.
4560 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
4561 #
4562 # Note: This setting is only applicable to routes that use a Backend
4563 # Service. It does not affect requests served by a Backend Bucket, as the
4564 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
4565 # set on a route that points exclusively to Backend Buckets will result in
4566 # a configuration error.
4567 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
4568 # `includedQueryParameters` and `excludedQueryParameters`. If neither
4569 # is set, the entire query string will be included. If false, the query
4570 # string will be excluded from the cache key entirely.
4571 #
4572 # Note: This field applies to routes that use backend services. Attempting
4573 # to set it on a route that points exclusively to Backend Buckets will
4574 # result in a configuration error. For routes that point to a Backend
4575 # Bucket, use `includedQueryParameters` to define which parameters should
4576 # be part of the cache key.
4577 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
4578 # The name=value pair will be used in the cache key Cloud CDN generates.
4579 #
4580 # Note: This setting is only applicable to routes that use a Backend
4581 # Service. It does not affect requests served by a Backend Bucket.
4582 # Attempting to set it on a route that points exclusively to Backend
4583 # Buckets will result in a configuration error. Up to 5 cookie names can be
4584 # specified.
4585 &quot;A String&quot;,
4586 ],
4587 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
4588 &quot;A String&quot;,
4589 ],
4590 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
4591 # parameters will be excluded. Either specify `includedQueryParameters`
4592 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
4593 # encoded and not treated as delimiters.
4594 &quot;A String&quot;,
4595 ],
4596 },
4597 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
4598 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
4599 &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
4600 # content. This is used to clamp the max-age (or Expires) value sent to the
4601 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
4602 # is used for the response max-age directive, along with a &quot;public&quot;
4603 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
4604 # clamps the max-age from the origin (if specified), or else sets the
4605 # response max-age directive to the lesser of the `clientTtl` and
4606 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
4607 # present. The maximum allowed value is 31,622,400s (1 year). If not
4608 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
4609 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
4610 # `USE_ORIGIN_HEADERS`.
4611 # as a count of seconds and fractions of seconds at nanosecond
4612 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4613 # or &quot;month&quot;. Range is approximately 10,000 years.
4614 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4615 # Durations less than one second are represented with a 0
4616 # `seconds` field and a positive `nanos` field. Must be from 0
4617 # to 999,999,999 inclusive.
4618 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4619 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4620 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4621 },
4622 &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
4623 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
4624 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
4625 # greater than that of `maxTtl`. When the `cacheMode` is set to
4626 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
4627 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
4628 # accessed objects may be evicted from the cache before the defined TTL. If
4629 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
4630 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
4631 # `USE_ORIGIN_HEADERS`.
4632 # as a count of seconds and fractions of seconds at nanosecond
4633 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4634 # or &quot;month&quot;. Range is approximately 10,000 years.
4635 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4636 # Durations less than one second are represented with a 0
4637 # `seconds` field and a positive `nanos` field. Must be from 0
4638 # to 999,999,999 inclusive.
4639 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4640 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4641 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4642 },
4643 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
4644 # attempt to set a max-age or s-maxage higher than this, or an Expires header
4645 # more than `maxTtl` seconds in the future will be capped at the value of
4646 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
4647 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
4648 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
4649 # Infrequently accessed objects may be evicted from the cache before the
4650 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
4651 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
4652 # mode.
4653 # as a count of seconds and fractions of seconds at nanosecond
4654 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4655 # or &quot;month&quot;. Range is approximately 10,000 years.
4656 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4657 # Durations less than one second are represented with a 0
4658 # `seconds` field and a positive `nanos` field. Must be from 0
4659 # to 999,999,999 inclusive.
4660 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4661 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4662 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4663 },
4664 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
4665 # to apply fine-grained caching for common errors or redirects.
4666 # This can reduce the load on your origin and improve end-user
4667 # experience by reducing response latency.
4668 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
4669 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
4670 # the specified response code that lack any Cache-Control, Expires, or
4671 # Pragma: no-cache directives. When the `cacheMode` is set to
4672 # `FORCE_CACHE_ALL`, negative caching applies to all responses
4673 # with the specified response code, and overrides any caching headers. By
4674 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
4675 #
4676 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
4677 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
4678 # * 405 (Method Not Found), 501 (Not Implemented): 60s
4679 #
4680 # These defaults can be overridden in `negativeCachingPolicy`.
4681 # If not specified, Cloud CDN applies negative caching by default.
4682 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
4683 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
4684 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
4685 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
4686 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
4687 # all response codes that you wish to cache. Cloud CDN will not apply any
4688 # default negative caching when a policy exists.
4689 { # Specify CDN TTLs for response error codes.
4690 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
4691 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
4692 # specified as values, and you cannot specify a status code more than
4693 # once.
4694 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
4695 # corresponding status code.
4696 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
4697 # objects may be evicted from the cache before the defined TTL.
4698 # as a count of seconds and fractions of seconds at nanosecond
4699 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4700 # or &quot;month&quot;. Range is approximately 10,000 years.
4701 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4702 # Durations less than one second are represented with a 0
4703 # `seconds` field and a positive `nanos` field. Must be from 0
4704 # to 999,999,999 inclusive.
4705 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4706 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4707 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4708 },
4709 },
4710 ],
4711 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
4712 # requests into a small number of requests to the origin. If not specified,
4713 # Cloud CDN applies request coalescing by default.
4714 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
4715 # content with the origin, or when an error is encountered when refreshing
4716 # the cache.
4717 # This setting defines the default &quot;max-stale&quot; duration for any cached
4718 # responses that do not specify a max-stale directive. Stale responses that
4719 # exceed the TTL configured here will not be served. The default limit
4720 # (max-stale) is 86400s (1 day), which will allow stale content to be
4721 # served up to this limit beyond the max-age (or s-maxage) of a cached
4722 # response.
4723 # The maximum allowed value is 604800 (1 week).
4724 # Set this to zero (0) to disable serve-while-stale.
4725 # as a count of seconds and fractions of seconds at nanosecond
4726 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4727 # or &quot;month&quot;. Range is approximately 10,000 years.
4728 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4729 # Durations less than one second are represented with a 0
4730 # `seconds` field and a positive `nanos` field. Must be from 0
4731 # to 999,999,999 inclusive.
4732 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4733 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4734 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4735 },
4736 },
4737 &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
4738 # information about the W3C recommendation for cross-origin resource sharing
4739 # (CORS), see Fetch API Living
4740 # Standard.
4741 #
4742 # Not supported when the URL map is bound to a target gRPC proxy.
4743 # information about the W3C recommendation for cross-origin resource sharing
4744 # (CORS), see Fetch API Living
4745 # Standard.
4746 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
4747 # indicates that
4748 # the actual request can include user credentials. This field translates to
4749 # the Access-Control-Allow-Credentials header.
4750 #
4751 # Default is false.
4752 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
4753 # header.
4754 &quot;A String&quot;,
4755 ],
4756 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
4757 # header.
4758 &quot;A String&quot;,
4759 ],
4760 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
4761 # more information, see regular expression syntax.
4762 #
4763 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
4764 #
4765 # Regular expressions can only be used when the loadBalancingScheme is
4766 # set to INTERNAL_SELF_MANAGED.
4767 &quot;A String&quot;,
4768 ],
4769 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
4770 #
4771 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
4772 &quot;A String&quot;,
4773 ],
4774 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
4775 # The default value is false, which indicates that the CORS
4776 # policy is in effect.
4777 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
4778 # header.
4779 &quot;A String&quot;,
4780 ],
4781 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
4782 # seconds. This field translates to the Access-Control-Max-Age
4783 # header.
4784 },
4785 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
4786 # the resiliency of clients to backend service failure. As part of fault
4787 # injection, when clients send requests to a backend service, delays can be
4788 # introduced by a load balancer on a percentage of requests before sending
4789 # those requests to the backend service. Similarly requests from clients can
4790 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
4791 # that are configured with a fault_injection_policy if:
4792 # 1. The traffic is generated by fault injection AND
4793 # 2. The fault injection is not a delay fault injection.
4794 # Fault injection is not supported with the classic Application Load Balancer
4795 # . To see which load balancers support fault injection,
4796 # see Load
4797 # balancing: Routing and traffic management features.
4798 # the resiliency of clients to backend service failure. As part of fault
4799 # injection, when clients send requests to a backend service, delays can be
4800 # introduced by the load balancer on a percentage of requests before sending
4801 # those request to the backend service. Similarly requests from clients can be
4802 # aborted by the load balancer for a percentage of requests.
4803 &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
4804 # injection.
4805 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
4806 #
4807 # The value must be from 200 to 599 inclusive.
4808 #
4809 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
4810 # according to this
4811 # mapping table. HTTP status 200 is mapped to gRPC status
4812 # UNKNOWN. Injecting an OK status is currently not supported by
4813 # Traffic Director.
4814 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
4815 # that is aborted as part of fault injection.
4816 #
4817 # The value must be from 0.0 to 100.0 inclusive.
4818 },
4819 &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
4820 # injection, before being sent to a backend service.
4821 # request to the backend service as part of fault injection.
4822 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
4823 # as a count of seconds and fractions of seconds at nanosecond
4824 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4825 # or &quot;month&quot;. Range is approximately 10,000 years.
4826 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4827 # Durations less than one second are represented with a 0
4828 # `seconds` field and a positive `nanos` field. Must be from 0
4829 # to 999,999,999 inclusive.
4830 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4831 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4832 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4833 },
4834 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
4835 # which a delay is introduced as part of fault injection.
4836 #
4837 # The value must be from 0.0 to 100.0 inclusive.
4838 },
4839 },
4840 &quot;imageOptimizationPolicy&quot;: { # The configuration for Cloud CDN&#x27;s image optimization feature. This feature # Image optimization policy for this URL Map&#x27;s route. Available only for
4841 # Global EXTERNAL_MANAGED load balancer schemes.
4842 # Either Cloud CDN must be enabled on the backend service or backend bucket
4843 # serving the route, or cache policy must be configured on the same route
4844 # dynamically processes and delivers images from the network edge.
4845 # Image Optimization is only available for Global External Application Load
4846 # Balancers.
4847 # Either Cloud CDN must be enabled on the backend service or backend bucket
4848 # serving the route, or cache policy must be configured on the same route.
4849 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
4850 },
4851 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
4852 # Unlike the timeout field where the timeout duration starts
4853 # from the time the request has been fully processed (known as*end-of-stream*),
4854 # the duration in this field is computed from the beginning of the stream
4855 # until the response has been processed, including all retries. A
4856 # stream that does not complete in this duration is closed.
4857 #
4858 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
4859 # with the route.
4860 #
4861 # This field is only allowed if the Url map is used with backend services
4862 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
4863 # as a count of seconds and fractions of seconds at nanosecond
4864 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4865 # or &quot;month&quot;. Range is approximately 10,000 years.
4866 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4867 # Durations less than one second are represented with a 0
4868 # `seconds` field and a positive `nanos` field. Must be from 0
4869 # to 999,999,999 inclusive.
4870 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4871 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4872 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4873 },
4874 &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
4875 # are shadowed to a separate mirrored backend service. The load balancer does
4876 # not wait for responses from the shadow service. Before sending traffic
4877 # to the shadow service, the host / authority header is suffixed with-shadow.
4878 #
4879 # Not supported when the URL map is bound to a target gRPC proxy that
4880 # has the validateForProxyless field set to true.
4881 # are shadowed to a separate mirrored backend service. The load balancer
4882 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
4883 # to the shadow service, the host or authority header is suffixed with-shadow.
4884 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
4885 # mirrored to.
4886 #
4887 # The backend service configured for a mirroring
4888 # policy must reference backends that are of the same type as the original
4889 # backend service matched in the URL map.
4890 #
4891 # Serverless NEG backends are not currently supported as a mirrored
4892 # backend service.
4893 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
4894 },
4895 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
4896 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
4897 # If not specified, defaults to 1.
4898 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
4899 #
4900 # If not specified, will use the timeout set in theHttpRouteAction field.
4901 # If timeout in the HttpRouteAction field is not set, this field
4902 # uses the largest timeout
4903 # among all backend services associated with the route.
4904 #
4905 # Not supported when the URL map is bound to a target gRPC proxy that
4906 # has the validateForProxyless field set to true.
4907 # as a count of seconds and fractions of seconds at nanosecond
4908 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4909 # or &quot;month&quot;. Range is approximately 10,000 years.
4910 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4911 # Durations less than one second are represented with a 0
4912 # `seconds` field and a positive `nanos` field. Must be from 0
4913 # to 999,999,999 inclusive.
4914 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4915 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4916 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4917 },
4918 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
4919 # values are:
4920 #
4921 # - 5xx: retry is attempted if the instance or endpoint
4922 # responds with any 5xx response code, or if the instance or
4923 # endpoint does not respond at all. For example, disconnects, reset, read
4924 # timeout, connection failure, and refused streams.
4925 # - gateway-error: Similar to 5xx, but only
4926 # applies to response codes 502, 503 or504.
4927 # - connect-failure: a retry is attempted on failures
4928 # connecting to the instance or endpoint. For example, connection
4929 # timeouts.
4930 # - retriable-4xx: a retry is attempted if the instance
4931 # or endpoint responds with a 4xx response code.
4932 # The only error that you can retry is error code 409.
4933 # - refused-stream: a retry is attempted if the instance
4934 # or endpoint resets the stream with a REFUSED_STREAM error
4935 # code. This reset type indicates that it is safe to retry.
4936 # - cancelled: a retry is attempted if the gRPC status
4937 # code in the response header is set to cancelled.
4938 # - deadline-exceeded: a retry is attempted if the gRPC
4939 # status code in the response header is set todeadline-exceeded.
4940 # - internal: a retry is attempted if the gRPC
4941 # status code in the response header is set tointernal.
4942 # - resource-exhausted: a retry is attempted if the gRPC
4943 # status code in the response header is set toresource-exhausted.
4944 # - unavailable: a retry is attempted if the gRPC
4945 # status code in the response header is set tounavailable.
4946 #
4947 # Only the following codes are supported when the URL map is bound to
4948 # target gRPC proxy that has validateForProxyless field set to true.
4949 #
4950 # - cancelled
4951 # - deadline-exceeded
4952 # - internal
4953 # - resource-exhausted
4954 # - unavailable
4955 &quot;A String&quot;,
4956 ],
4957 },
4958 &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
4959 # time the request has been fully processed (known as *end-of-stream*)
4960 # up until the response has been processed. Timeout includes
4961 # all retries.
4962 #
4963 # If not specified, this field uses the largest timeout among all backend
4964 # services associated with the route.
4965 #
4966 # Not supported when the URL map is bound to a target gRPC proxy that
4967 # has validateForProxyless field set to true.
4968 # as a count of seconds and fractions of seconds at nanosecond
4969 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4970 # or &quot;month&quot;. Range is approximately 10,000 years.
4971 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4972 # Durations less than one second are represented with a 0
4973 # `seconds` field and a positive `nanos` field. Must be from 0
4974 # to 999,999,999 inclusive.
4975 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4976 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4977 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4978 },
4979 &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
4980 # to the matched service.
4981 #
4982 # urlRewrite is the only action supported in UrlMaps
4983 # for classic Application Load Balancers.
4984 #
4985 # Not supported when the URL map is bound to a target gRPC proxy that
4986 # has the validateForProxyless field set to true.
4987 # backend service.
4988 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
4989 # host header is replaced with contents of hostRewrite.
4990 #
4991 # The value must be from 1 to 255 characters.
4992 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
4993 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
4994 #
4995 # The value must be from 1 to 1024 characters.
4996 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
4997 # header) using the HTTP template syntax.
4998 #
4999 # A corresponding
5000 # path_template_match must be specified. Any template variables must exist in
5001 # the path_template_match field.
5002 #
5003 #
5004 # - -At least one variable must be specified in the path_template_match
5005 # field
5006 # - You can omit variables from the rewritten URL
5007 # - The * and ** operators cannot be matched
5008 # unless they have a corresponding variable name - e.g.
5009 # {format=*} or {var=**}.
5010 #
5011 # For example, a path_template_match of /static/{format=**}
5012 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
5013 # rewrite, so that /{country}/{format}/{suffix=**} can be
5014 # rewritten as /content/{format}/{country}/{suffix}.
5015 #
5016 # At least
5017 # one non-empty routeRules[].matchRules[].path_template_match is
5018 # required.
5019 #
5020 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
5021 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
5022 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
5023 # It uses RE2 syntax with the following constraints:
5024 #
5025 #
5026 # - Any single character operators
5027 # - Groups are allowed to have only submatch operator inside
5028 # - Groups are allowed only without any char repetition, e.g.
5029 # .*
5030 # - Any char repetition, e.g. .*, is
5031 # only allowed to be used in a single regex together with:
5032 #
5033 #
5034 # - Empty string operators
5035 # - Other repetitions
5036 # - Ranges
5037 # - Repetitions of ranges
5038 #
5039 #
5040 # - Ranges are only allowed to have:
5041 #
5042 #
5043 # - Character range
5044 # - Digits range
5045 # - Symbols listed in characters allowed for ranges
5046 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
5047 # the path.
5048 },
5049 },
5050 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
5051 # occurs. The weights determine the fraction of traffic that flows to
5052 # their corresponding backend service. If all traffic needs to
5053 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
5054 #
5055 # After a backend service is identified and before forwarding
5056 # the request to
5057 # the backend service, advanced routing actions such as URL rewrites and
5058 # header transformations are applied depending on additional settings
5059 # specified in this HttpRouteAction.
5060 { # In contrast to a single BackendService in
5061 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
5062 # multiple backend services. The volume of traffic for each
5063 # backend service is proportional to the weight specified
5064 # in each WeightedBackendService
5065 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
5066 # resource. Before
5067 # forwarding the request to backendService, the load balancer
5068 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
5069 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
5070 # effect for the selected backendService.
5071 #
5072 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
5073 #
5074 # headerAction is not supported for load balancers that have
5075 # their loadBalancingScheme set to EXTERNAL.
5076 #
5077 # Not supported when the URL map is bound to a target gRPC proxy that
5078 # has validateForProxyless field set to true.
5079 # the request is passed along to the selected backendService.
5080 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
5081 { # Specification determining how headers are added to requests or responses.
5082 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
5083 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
5084 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
5085 # that already
5086 # exist for the header. If true, headerValue is set for the
5087 # header, discarding any values that were set for that header.
5088 #
5089 # The default value is true,
5090 # unless a variable is present in headerValue,
5091 # in which case the default value is false.
5092 # .
5093 },
5094 ],
5095 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
5096 # request before forwarding the request to the backendService.
5097 &quot;A String&quot;,
5098 ],
5099 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
5100 # client.
5101 { # Specification determining how headers are added to requests or responses.
5102 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
5103 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
5104 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
5105 # that already
5106 # exist for the header. If true, headerValue is set for the
5107 # header, discarding any values that were set for that header.
5108 #
5109 # The default value is true,
5110 # unless a variable is present in headerValue,
5111 # in which case the default value is false.
5112 # .
5113 },
5114 ],
5115 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
5116 # response before sending the response back to the client.
5117 &quot;A String&quot;,
5118 ],
5119 },
5120 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
5121 # computed asweight / (sum of all weightedBackendService weights in routeAction).
5122 #
5123 # The selection of a backend service is determined only for new traffic.
5124 # Once a user&#x27;s request has been directed to a backend service,
5125 # subsequent requests are sent to the same backend service as
5126 # determined by the backend service&#x27;s session affinity policy.
5127 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
5128 # splitting. If you do, the weighted traffic splitting configuration takes
5129 # precedence.
5130 #
5131 # The value must be from 0 to 1000.
5132 },
5133 ],
5134 },
5135 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL of the defaultService resource to
5136 # which traffic is directed if none of the hostRules match.
5137 # If defaultRouteAction is also specified, advanced
5138 # routing actions, such as URL rewrites, take effect before sending the
5139 # request to the backend.
5140 #
5141 #
5142 # Only one of defaultUrlRedirect, defaultService
5143 # or defaultRouteAction.weightedBackendService can be set.
5144 #
5145 #
5146 # defaultService has no effect when the URL map is bound
5147 # to a target gRPC proxy that has the validateForProxyless field
5148 # set to true.
5149 &quot;defaultUrlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
5150 # is redirected to a URL specified by defaultUrlRedirect.
5151 #
5152 #
5153 # Only one of defaultUrlRedirect, defaultService
5154 # or defaultRouteAction.weightedBackendService can be set.
5155 #
5156 #
5157 # Not supported when the URL map is bound to a target gRPC proxy.
5158 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
5159 # was supplied in the request.
5160 #
5161 # The value must be from 1 to 255
5162 # characters.
5163 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
5164 # set to HTTPS.
5165 # If set to false, the URL scheme of the redirected request
5166 # remains the same as that of the request.
5167 #
5168 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
5169 #
5170 # The default is set to false.
5171 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
5172 # that was supplied in the request.
5173 #
5174 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
5175 # supplied, the path of the original request is used for the redirect.
5176 #
5177 # The value must be from 1 to 1024 characters.
5178 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
5179 # the HttpRouteRuleMatch, retaining the remaining portion
5180 # of the URL before redirecting the request.
5181 #
5182 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
5183 # supplied, the path of the original request is used for the redirect.
5184 #
5185 # The value must be from 1 to 1024 characters.
5186 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
5187 #
5188 # Supported values are:
5189 #
5190 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
5191 # to 301.
5192 # - FOUND, which corresponds to 302.
5193 # - SEE_OTHER which corresponds to 303.
5194 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
5195 # method is retained.
5196 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
5197 # method is retained.
5198 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
5199 # URL is
5200 # removed before redirecting the request. If set to false, the
5201 # query portion of the original URL is retained.
5202 #
5203 # The default is set to false.
5204 },
5205 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
5206 # create the resource.
5207 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. A hash of the contents stored in this object.
5208 # This field is used in optimistic locking. This field is ignored when
5209 # inserting a UrlMap. An up-to-date fingerprint must be provided
5210 # in order to update the UrlMap, otherwise the request will
5211 # fail with error 412 conditionNotMet.
5212 #
5213 # To see the latest fingerprint, make a get() request to
5214 # retrieve a UrlMap.
5215 &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
5216 # for the selected backendService.
5217 #
5218 # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
5219 #
5220 # headerAction is not supported for load balancers
5221 # that have
5222 # their loadBalancingScheme set to EXTERNAL.
5223 #
5224 # Not supported when the URL map is bound to a target gRPC proxy that
5225 # has validateForProxyless field set to true.
5226 # the request is passed along to the selected backendService.
5227 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
5228 { # Specification determining how headers are added to requests or responses.
5229 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
5230 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
5231 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
5232 # that already
5233 # exist for the header. If true, headerValue is set for the
5234 # header, discarding any values that were set for that header.
5235 #
5236 # The default value is true,
5237 # unless a variable is present in headerValue,
5238 # in which case the default value is false.
5239 # .
5240 },
5241 ],
5242 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
5243 # request before forwarding the request to the backendService.
5244 &quot;A String&quot;,
5245 ],
5246 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
5247 # client.
5248 { # Specification determining how headers are added to requests or responses.
5249 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
5250 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
5251 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
5252 # that already
5253 # exist for the header. If true, headerValue is set for the
5254 # header, discarding any values that were set for that header.
5255 #
5256 # The default value is true,
5257 # unless a variable is present in headerValue,
5258 # in which case the default value is false.
5259 # .
5260 },
5261 ],
5262 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
5263 # response before sending the response back to the client.
5264 &quot;A String&quot;,
5265 ],
5266 },
5267 &quot;hostRules&quot;: [ # The list of host rules to use against the URL.
5268 { # UrlMaps
5269 # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
5270 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
5271 # create the resource.
5272 &quot;hosts&quot;: [ # The list of host patterns to match. They must be valid hostnames with
5273 # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
5274 # that case, * must be the first character, and if followed by
5275 # anything, the immediate following character must be either -
5276 # or ..
5277 #
5278 # * based matching is not supported when the URL map is bound
5279 # to a target gRPC proxy that has the validateForProxyless field
5280 # set to true.
5281 &quot;A String&quot;,
5282 ],
5283 &quot;pathMatcher&quot;: &quot;A String&quot;, # The name of the PathMatcher to use to match the path portion
5284 # of the URL if the hostRule matches the URL&#x27;s host portion.
5285 },
5286 ],
5287 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the resource. This identifier is
5288 # defined by the server.
5289 &quot;kind&quot;: &quot;compute#urlMap&quot;, # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
5290 # url maps.
5291 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
5292 # The name must be 1-63 characters long, and comply withRFC1035.
5293 # Specifically, the name must be 1-63 characters long and match the regular
5294 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
5295 # character must be a lowercase letter, and all following characters must
5296 # be a dash, lowercase letter, or digit, except the last character, which
5297 # cannot be a dash.
5298 &quot;pathMatchers&quot;: [ # The list of named PathMatchers to use against the URL.
5299 { # A matcher for the path portion of the URL. The BackendService
5300 # from the longest-matched rule will serve the URL. If no rule was matched, the
5301 # default service is used.
5302 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
5303 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
5304 #
5305 # This policy takes
5306 # effect at the PathMatcher level and applies only when no
5307 # 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
5308 # in defaultCustomErrorResponsePolicy, then a policy defined for
5309 # the error code in UrlMap.defaultCustomErrorResponsePolicy
5310 # takes effect.
5311 #
5312 # For example, consider a UrlMap with the following
5313 # configuration:
5314 #
5315 #
5316 # - UrlMap.defaultCustomErrorResponsePolicy is configured
5317 # with policies for 5xx and 4xx errors
5318 # - A RouteRule for /coming_soon/ is configured for the
5319 # error code 404.
5320 #
5321 # 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
5322 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
5323 # the policy in RouteRule.customErrorResponsePolicy takes
5324 # effect. If any of the requests in this example encounter a 500
5325 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
5326 #
5327 # When
5328 # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
5329 # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
5330 # a retry, if load balancer is successful in reaching the
5331 # service, the defaultCustomErrorResponsePolicy is ignored and
5332 # the response from the service is returned to the client.
5333 #
5334 # defaultCustomErrorResponsePolicy is supported only for
5335 # global external Application Load Balancers.
5336 # backend service or backend bucket responds with an error.
5337 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
5338 #
5339 # In a given policy, if you specify rules for both a range of error codes
5340 # as well as rules for specific error codes then rules with specific error
5341 # codes have a higher priority. For example, assume that you configure a rule
5342 # for 401 (Un-authorized) code, and another for all 4 series
5343 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
5344 # However if the backend service returns a 403, the rule for4xx takes effect.
5345 { # Specifies the mapping between the response code that will be returned along
5346 # with the custom error content and the response code returned by the backend
5347 # service.
5348 &quot;matchResponseCodes&quot;: [ # Valid values include:
5349 #
5350 #
5351 # - A number between 400 and 599: For example
5352 # 401 or 503, in which case the load balancer
5353 # applies the policy if the error code exactly matches this value.
5354 # - 5xx: Load Balancer will apply the policy if the
5355 # backend service responds with any response code in the range of
5356 # 500 to 599.
5357 # - 4xx: Load
5358 # Balancer will apply the policy if the backend service responds with any
5359 # response code in the range of 400 to
5360 # 499.
5361 #
5362 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
5363 &quot;A String&quot;,
5364 ],
5365 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
5366 # error content. If overrideResponseCode is not supplied, the
5367 # same response code returned by the original backend bucket or backend
5368 # service is returned to the client.
5369 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
5370 #
5371 # path must start
5372 # with a leading slash. path cannot have trailing slashes.
5373 #
5374 # If the file is not available in backendBucket or the
5375 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
5376 #
5377 # The value must
5378 # be from 1 to 1024 characters
5379 },
5380 ],
5381 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
5382 # contains the custom error content. Examples are:
5383 #
5384 #
5385 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
5386 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
5387 # - global/backendBuckets/myBackendBucket
5388 #
5389 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
5390 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
5391 #
5392 # If load balancer cannot reach
5393 # the backendBucket, a simple Not Found Error will
5394 # be returned, with the original response code (oroverrideResponseCode if configured).
5395 #
5396 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
5397 },
5398 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
5399 # pathRules or routeRules match. The load balancer
5400 # performs advanced routing actions, such as URL rewrites and
5401 # header transformations, before forwarding the request to the
5402 # selected backend.
5403 #
5404 #
5405 # Only one of defaultUrlRedirect, defaultService
5406 # or defaultRouteAction.weightedBackendService can be set.
5407 #
5408 #
5409 # URL maps for classic Application Load Balancers only support
5410 # the urlRewrite action within a path matcher&#x27;sdefaultRouteAction.
5411 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
5412 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
5413 # property must be specified. This policy cannot be specified if any target
5414 # backend has Identity-Aware Proxy enabled.
5415 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
5416 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
5417 # header names can be specified. The cache is bypassed for all `cacheMode`
5418 # values.
5419 &quot;A String&quot;,
5420 ],
5421 &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
5422 # on the backend type: for Backend Services, the complete request URI is
5423 # used; for Backend Buckets, the request URI is used without the protocol or
5424 # host, and only query parameters known to Cloud Storage are included.
5425 # Policy defined on Route Action.
5426 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
5427 # parameters will be included. Either specify `excludedQueryParameters`
5428 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
5429 # encoded and not treated as delimiters.
5430 #
5431 # Note: This field applies to routes that use backend services. Attempting
5432 # to set it on a route that points exclusively to Backend Buckets will
5433 # result in a configuration error. For routes that point to a Backend
5434 # Bucket, use `includedQueryParameters` to define which parameters should
5435 # be part of the cache key.
5436 &quot;A String&quot;,
5437 ],
5438 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
5439 #
5440 # Note: This setting is only applicable to routes that use a Backend
5441 # Service. It does not affect requests served by a Backend Bucket, as the
5442 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
5443 # it on a route that points exclusively to Backend Buckets will result in a
5444 # configuration error.
5445 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
5446 #
5447 # Note: This setting is only applicable to routes that use a Backend
5448 # Service. It does not affect requests served by a Backend Bucket, as the
5449 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
5450 # set on a route that points exclusively to Backend Buckets will result in
5451 # a configuration error.
5452 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
5453 # `includedQueryParameters` and `excludedQueryParameters`. If neither
5454 # is set, the entire query string will be included. If false, the query
5455 # string will be excluded from the cache key entirely.
5456 #
5457 # Note: This field applies to routes that use backend services. Attempting
5458 # to set it on a route that points exclusively to Backend Buckets will
5459 # result in a configuration error. For routes that point to a Backend
5460 # Bucket, use `includedQueryParameters` to define which parameters should
5461 # be part of the cache key.
5462 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
5463 # The name=value pair will be used in the cache key Cloud CDN generates.
5464 #
5465 # Note: This setting is only applicable to routes that use a Backend
5466 # Service. It does not affect requests served by a Backend Bucket.
5467 # Attempting to set it on a route that points exclusively to Backend
5468 # Buckets will result in a configuration error. Up to 5 cookie names can be
5469 # specified.
5470 &quot;A String&quot;,
5471 ],
5472 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
5473 &quot;A String&quot;,
5474 ],
5475 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
5476 # parameters will be excluded. Either specify `includedQueryParameters`
5477 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
5478 # encoded and not treated as delimiters.
5479 &quot;A String&quot;,
5480 ],
5481 },
5482 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
5483 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
5484 &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
5485 # content. This is used to clamp the max-age (or Expires) value sent to the
5486 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
5487 # is used for the response max-age directive, along with a &quot;public&quot;
5488 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
5489 # clamps the max-age from the origin (if specified), or else sets the
5490 # response max-age directive to the lesser of the `clientTtl` and
5491 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
5492 # present. The maximum allowed value is 31,622,400s (1 year). If not
5493 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
5494 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
5495 # `USE_ORIGIN_HEADERS`.
5496 # as a count of seconds and fractions of seconds at nanosecond
5497 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5498 # or &quot;month&quot;. Range is approximately 10,000 years.
5499 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5500 # Durations less than one second are represented with a 0
5501 # `seconds` field and a positive `nanos` field. Must be from 0
5502 # to 999,999,999 inclusive.
5503 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5504 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5505 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5506 },
5507 &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
5508 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
5509 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
5510 # greater than that of `maxTtl`. When the `cacheMode` is set to
5511 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
5512 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
5513 # accessed objects may be evicted from the cache before the defined TTL. If
5514 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
5515 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
5516 # `USE_ORIGIN_HEADERS`.
5517 # as a count of seconds and fractions of seconds at nanosecond
5518 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5519 # or &quot;month&quot;. Range is approximately 10,000 years.
5520 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5521 # Durations less than one second are represented with a 0
5522 # `seconds` field and a positive `nanos` field. Must be from 0
5523 # to 999,999,999 inclusive.
5524 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5525 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5526 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5527 },
5528 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
5529 # attempt to set a max-age or s-maxage higher than this, or an Expires header
5530 # more than `maxTtl` seconds in the future will be capped at the value of
5531 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
5532 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
5533 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
5534 # Infrequently accessed objects may be evicted from the cache before the
5535 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
5536 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
5537 # mode.
5538 # as a count of seconds and fractions of seconds at nanosecond
5539 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5540 # or &quot;month&quot;. Range is approximately 10,000 years.
5541 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5542 # Durations less than one second are represented with a 0
5543 # `seconds` field and a positive `nanos` field. Must be from 0
5544 # to 999,999,999 inclusive.
5545 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5546 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5547 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5548 },
5549 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
5550 # to apply fine-grained caching for common errors or redirects.
5551 # This can reduce the load on your origin and improve end-user
5552 # experience by reducing response latency.
5553 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
5554 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
5555 # the specified response code that lack any Cache-Control, Expires, or
5556 # Pragma: no-cache directives. When the `cacheMode` is set to
5557 # `FORCE_CACHE_ALL`, negative caching applies to all responses
5558 # with the specified response code, and overrides any caching headers. By
5559 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
5560 #
5561 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
5562 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
5563 # * 405 (Method Not Found), 501 (Not Implemented): 60s
5564 #
5565 # These defaults can be overridden in `negativeCachingPolicy`.
5566 # If not specified, Cloud CDN applies negative caching by default.
5567 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
5568 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
5569 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
5570 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
5571 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
5572 # all response codes that you wish to cache. Cloud CDN will not apply any
5573 # default negative caching when a policy exists.
5574 { # Specify CDN TTLs for response error codes.
5575 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
5576 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
5577 # specified as values, and you cannot specify a status code more than
5578 # once.
5579 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
5580 # corresponding status code.
5581 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
5582 # objects may be evicted from the cache before the defined TTL.
5583 # as a count of seconds and fractions of seconds at nanosecond
5584 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5585 # or &quot;month&quot;. Range is approximately 10,000 years.
5586 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5587 # Durations less than one second are represented with a 0
5588 # `seconds` field and a positive `nanos` field. Must be from 0
5589 # to 999,999,999 inclusive.
5590 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5591 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5592 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5593 },
5594 },
5595 ],
5596 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
5597 # requests into a small number of requests to the origin. If not specified,
5598 # Cloud CDN applies request coalescing by default.
5599 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
5600 # content with the origin, or when an error is encountered when refreshing
5601 # the cache.
5602 # This setting defines the default &quot;max-stale&quot; duration for any cached
5603 # responses that do not specify a max-stale directive. Stale responses that
5604 # exceed the TTL configured here will not be served. The default limit
5605 # (max-stale) is 86400s (1 day), which will allow stale content to be
5606 # served up to this limit beyond the max-age (or s-maxage) of a cached
5607 # response.
5608 # The maximum allowed value is 604800 (1 week).
5609 # Set this to zero (0) to disable serve-while-stale.
5610 # as a count of seconds and fractions of seconds at nanosecond
5611 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5612 # or &quot;month&quot;. Range is approximately 10,000 years.
5613 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5614 # Durations less than one second are represented with a 0
5615 # `seconds` field and a positive `nanos` field. Must be from 0
5616 # to 999,999,999 inclusive.
5617 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5618 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5619 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5620 },
5621 },
5622 &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
5623 # information about the W3C recommendation for cross-origin resource sharing
5624 # (CORS), see Fetch API Living
5625 # Standard.
5626 #
5627 # Not supported when the URL map is bound to a target gRPC proxy.
5628 # information about the W3C recommendation for cross-origin resource sharing
5629 # (CORS), see Fetch API Living
5630 # Standard.
5631 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
5632 # indicates that
5633 # the actual request can include user credentials. This field translates to
5634 # the Access-Control-Allow-Credentials header.
5635 #
5636 # Default is false.
5637 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
5638 # header.
5639 &quot;A String&quot;,
5640 ],
5641 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
5642 # header.
5643 &quot;A String&quot;,
5644 ],
5645 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
5646 # more information, see regular expression syntax.
5647 #
5648 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
5649 #
5650 # Regular expressions can only be used when the loadBalancingScheme is
5651 # set to INTERNAL_SELF_MANAGED.
5652 &quot;A String&quot;,
5653 ],
5654 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
5655 #
5656 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
5657 &quot;A String&quot;,
5658 ],
5659 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
5660 # The default value is false, which indicates that the CORS
5661 # policy is in effect.
5662 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
5663 # header.
5664 &quot;A String&quot;,
5665 ],
5666 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
5667 # seconds. This field translates to the Access-Control-Max-Age
5668 # header.
5669 },
5670 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
5671 # the resiliency of clients to backend service failure. As part of fault
5672 # injection, when clients send requests to a backend service, delays can be
5673 # introduced by a load balancer on a percentage of requests before sending
5674 # those requests to the backend service. Similarly requests from clients can
5675 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
5676 # that are configured with a fault_injection_policy if:
5677 # 1. The traffic is generated by fault injection AND
5678 # 2. The fault injection is not a delay fault injection.
5679 # Fault injection is not supported with the classic Application Load Balancer
5680 # . To see which load balancers support fault injection,
5681 # see Load
5682 # balancing: Routing and traffic management features.
5683 # the resiliency of clients to backend service failure. As part of fault
5684 # injection, when clients send requests to a backend service, delays can be
5685 # introduced by the load balancer on a percentage of requests before sending
5686 # those request to the backend service. Similarly requests from clients can be
5687 # aborted by the load balancer for a percentage of requests.
5688 &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
5689 # injection.
5690 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
5691 #
5692 # The value must be from 200 to 599 inclusive.
5693 #
5694 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
5695 # according to this
5696 # mapping table. HTTP status 200 is mapped to gRPC status
5697 # UNKNOWN. Injecting an OK status is currently not supported by
5698 # Traffic Director.
5699 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
5700 # that is aborted as part of fault injection.
5701 #
5702 # The value must be from 0.0 to 100.0 inclusive.
5703 },
5704 &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
5705 # injection, before being sent to a backend service.
5706 # request to the backend service as part of fault injection.
5707 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
5708 # as a count of seconds and fractions of seconds at nanosecond
5709 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5710 # or &quot;month&quot;. Range is approximately 10,000 years.
5711 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5712 # Durations less than one second are represented with a 0
5713 # `seconds` field and a positive `nanos` field. Must be from 0
5714 # to 999,999,999 inclusive.
5715 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5716 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5717 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5718 },
5719 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
5720 # which a delay is introduced as part of fault injection.
5721 #
5722 # The value must be from 0.0 to 100.0 inclusive.
5723 },
5724 },
5725 &quot;imageOptimizationPolicy&quot;: { # The configuration for Cloud CDN&#x27;s image optimization feature. This feature # Image optimization policy for this URL Map&#x27;s route. Available only for
5726 # Global EXTERNAL_MANAGED load balancer schemes.
5727 # Either Cloud CDN must be enabled on the backend service or backend bucket
5728 # serving the route, or cache policy must be configured on the same route
5729 # dynamically processes and delivers images from the network edge.
5730 # Image Optimization is only available for Global External Application Load
5731 # Balancers.
5732 # Either Cloud CDN must be enabled on the backend service or backend bucket
5733 # serving the route, or cache policy must be configured on the same route.
5734 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
5735 },
5736 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
5737 # Unlike the timeout field where the timeout duration starts
5738 # from the time the request has been fully processed (known as*end-of-stream*),
5739 # the duration in this field is computed from the beginning of the stream
5740 # until the response has been processed, including all retries. A
5741 # stream that does not complete in this duration is closed.
5742 #
5743 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
5744 # with the route.
5745 #
5746 # This field is only allowed if the Url map is used with backend services
5747 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
5748 # as a count of seconds and fractions of seconds at nanosecond
5749 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5750 # or &quot;month&quot;. Range is approximately 10,000 years.
5751 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5752 # Durations less than one second are represented with a 0
5753 # `seconds` field and a positive `nanos` field. Must be from 0
5754 # to 999,999,999 inclusive.
5755 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5756 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5757 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5758 },
5759 &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
5760 # are shadowed to a separate mirrored backend service. The load balancer does
5761 # not wait for responses from the shadow service. Before sending traffic
5762 # to the shadow service, the host / authority header is suffixed with-shadow.
5763 #
5764 # Not supported when the URL map is bound to a target gRPC proxy that
5765 # has the validateForProxyless field set to true.
5766 # are shadowed to a separate mirrored backend service. The load balancer
5767 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
5768 # to the shadow service, the host or authority header is suffixed with-shadow.
5769 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
5770 # mirrored to.
5771 #
5772 # The backend service configured for a mirroring
5773 # policy must reference backends that are of the same type as the original
5774 # backend service matched in the URL map.
5775 #
5776 # Serverless NEG backends are not currently supported as a mirrored
5777 # backend service.
5778 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
5779 },
5780 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
5781 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
5782 # If not specified, defaults to 1.
5783 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
5784 #
5785 # If not specified, will use the timeout set in theHttpRouteAction field.
5786 # If timeout in the HttpRouteAction field is not set, this field
5787 # uses the largest timeout
5788 # among all backend services associated with the route.
5789 #
5790 # Not supported when the URL map is bound to a target gRPC proxy that
5791 # has the validateForProxyless field set to true.
5792 # as a count of seconds and fractions of seconds at nanosecond
5793 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5794 # or &quot;month&quot;. Range is approximately 10,000 years.
5795 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5796 # Durations less than one second are represented with a 0
5797 # `seconds` field and a positive `nanos` field. Must be from 0
5798 # to 999,999,999 inclusive.
5799 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5800 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5801 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5802 },
5803 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
5804 # values are:
5805 #
5806 # - 5xx: retry is attempted if the instance or endpoint
5807 # responds with any 5xx response code, or if the instance or
5808 # endpoint does not respond at all. For example, disconnects, reset, read
5809 # timeout, connection failure, and refused streams.
5810 # - gateway-error: Similar to 5xx, but only
5811 # applies to response codes 502, 503 or504.
5812 # - connect-failure: a retry is attempted on failures
5813 # connecting to the instance or endpoint. For example, connection
5814 # timeouts.
5815 # - retriable-4xx: a retry is attempted if the instance
5816 # or endpoint responds with a 4xx response code.
5817 # The only error that you can retry is error code 409.
5818 # - refused-stream: a retry is attempted if the instance
5819 # or endpoint resets the stream with a REFUSED_STREAM error
5820 # code. This reset type indicates that it is safe to retry.
5821 # - cancelled: a retry is attempted if the gRPC status
5822 # code in the response header is set to cancelled.
5823 # - deadline-exceeded: a retry is attempted if the gRPC
5824 # status code in the response header is set todeadline-exceeded.
5825 # - internal: a retry is attempted if the gRPC
5826 # status code in the response header is set tointernal.
5827 # - resource-exhausted: a retry is attempted if the gRPC
5828 # status code in the response header is set toresource-exhausted.
5829 # - unavailable: a retry is attempted if the gRPC
5830 # status code in the response header is set tounavailable.
5831 #
5832 # Only the following codes are supported when the URL map is bound to
5833 # target gRPC proxy that has validateForProxyless field set to true.
5834 #
5835 # - cancelled
5836 # - deadline-exceeded
5837 # - internal
5838 # - resource-exhausted
5839 # - unavailable
5840 &quot;A String&quot;,
5841 ],
5842 },
5843 &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
5844 # time the request has been fully processed (known as *end-of-stream*)
5845 # up until the response has been processed. Timeout includes
5846 # all retries.
5847 #
5848 # If not specified, this field uses the largest timeout among all backend
5849 # services associated with the route.
5850 #
5851 # Not supported when the URL map is bound to a target gRPC proxy that
5852 # has validateForProxyless field set to true.
5853 # as a count of seconds and fractions of seconds at nanosecond
5854 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5855 # or &quot;month&quot;. Range is approximately 10,000 years.
5856 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5857 # Durations less than one second are represented with a 0
5858 # `seconds` field and a positive `nanos` field. Must be from 0
5859 # to 999,999,999 inclusive.
5860 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5861 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5862 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5863 },
5864 &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
5865 # to the matched service.
5866 #
5867 # urlRewrite is the only action supported in UrlMaps
5868 # for classic Application Load Balancers.
5869 #
5870 # Not supported when the URL map is bound to a target gRPC proxy that
5871 # has the validateForProxyless field set to true.
5872 # backend service.
5873 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
5874 # host header is replaced with contents of hostRewrite.
5875 #
5876 # The value must be from 1 to 255 characters.
5877 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
5878 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
5879 #
5880 # The value must be from 1 to 1024 characters.
5881 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
5882 # header) using the HTTP template syntax.
5883 #
5884 # A corresponding
5885 # path_template_match must be specified. Any template variables must exist in
5886 # the path_template_match field.
5887 #
5888 #
5889 # - -At least one variable must be specified in the path_template_match
5890 # field
5891 # - You can omit variables from the rewritten URL
5892 # - The * and ** operators cannot be matched
5893 # unless they have a corresponding variable name - e.g.
5894 # {format=*} or {var=**}.
5895 #
5896 # For example, a path_template_match of /static/{format=**}
5897 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
5898 # rewrite, so that /{country}/{format}/{suffix=**} can be
5899 # rewritten as /content/{format}/{country}/{suffix}.
5900 #
5901 # At least
5902 # one non-empty routeRules[].matchRules[].path_template_match is
5903 # required.
5904 #
5905 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
5906 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
5907 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
5908 # It uses RE2 syntax with the following constraints:
5909 #
5910 #
5911 # - Any single character operators
5912 # - Groups are allowed to have only submatch operator inside
5913 # - Groups are allowed only without any char repetition, e.g.
5914 # .*
5915 # - Any char repetition, e.g. .*, is
5916 # only allowed to be used in a single regex together with:
5917 #
5918 #
5919 # - Empty string operators
5920 # - Other repetitions
5921 # - Ranges
5922 # - Repetitions of ranges
5923 #
5924 #
5925 # - Ranges are only allowed to have:
5926 #
5927 #
5928 # - Character range
5929 # - Digits range
5930 # - Symbols listed in characters allowed for ranges
5931 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
5932 # the path.
5933 },
5934 },
5935 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
5936 # occurs. The weights determine the fraction of traffic that flows to
5937 # their corresponding backend service. If all traffic needs to
5938 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
5939 #
5940 # After a backend service is identified and before forwarding
5941 # the request to
5942 # the backend service, advanced routing actions such as URL rewrites and
5943 # header transformations are applied depending on additional settings
5944 # specified in this HttpRouteAction.
5945 { # In contrast to a single BackendService in
5946 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
5947 # multiple backend services. The volume of traffic for each
5948 # backend service is proportional to the weight specified
5949 # in each WeightedBackendService
5950 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
5951 # resource. Before
5952 # forwarding the request to backendService, the load balancer
5953 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
5954 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
5955 # effect for the selected backendService.
5956 #
5957 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
5958 #
5959 # headerAction is not supported for load balancers that have
5960 # their loadBalancingScheme set to EXTERNAL.
5961 #
5962 # Not supported when the URL map is bound to a target gRPC proxy that
5963 # has validateForProxyless field set to true.
5964 # the request is passed along to the selected backendService.
5965 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
5966 { # Specification determining how headers are added to requests or responses.
5967 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
5968 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
5969 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
5970 # that already
5971 # exist for the header. If true, headerValue is set for the
5972 # header, discarding any values that were set for that header.
5973 #
5974 # The default value is true,
5975 # unless a variable is present in headerValue,
5976 # in which case the default value is false.
5977 # .
5978 },
5979 ],
5980 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
5981 # request before forwarding the request to the backendService.
5982 &quot;A String&quot;,
5983 ],
5984 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
5985 # client.
5986 { # Specification determining how headers are added to requests or responses.
5987 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
5988 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
5989 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
5990 # that already
5991 # exist for the header. If true, headerValue is set for the
5992 # header, discarding any values that were set for that header.
5993 #
5994 # The default value is true,
5995 # unless a variable is present in headerValue,
5996 # in which case the default value is false.
5997 # .
5998 },
5999 ],
6000 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
6001 # response before sending the response back to the client.
6002 &quot;A String&quot;,
6003 ],
6004 },
6005 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
6006 # computed asweight / (sum of all weightedBackendService weights in routeAction).
6007 #
6008 # The selection of a backend service is determined only for new traffic.
6009 # Once a user&#x27;s request has been directed to a backend service,
6010 # subsequent requests are sent to the same backend service as
6011 # determined by the backend service&#x27;s session affinity policy.
6012 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
6013 # splitting. If you do, the weighted traffic splitting configuration takes
6014 # precedence.
6015 #
6016 # The value must be from 0 to 1000.
6017 },
6018 ],
6019 },
6020 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource. This
6021 # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
6022 # matched. For example, the
6023 # following are all valid URLs to a BackendService resource:
6024 #
6025 #
6026 # - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
6027 # - compute/v1/projects/project/global/backendServices/backendService
6028 # - global/backendServices/backendService
6029 #
6030 #
6031 # If defaultRouteAction is also specified, advanced
6032 # routing actions, such as URL rewrites, take effect before sending the
6033 # request to the backend.
6034 #
6035 #
6036 # Only one of defaultUrlRedirect, defaultService
6037 # or defaultRouteAction.weightedBackendService can be set.
6038 #
6039 #
6040 # Authorization requires one or more of the following Google IAM permissions on the
6041 # specified resource default_service:
6042 #
6043 #
6044 # - compute.backendBuckets.use
6045 # - compute.backendServices.use
6046 &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
6047 # by defaultUrlRedirect.
6048 #
6049 #
6050 # Only one of defaultUrlRedirect, defaultService
6051 # or defaultRouteAction.weightedBackendService can be set.
6052 #
6053 #
6054 # Not supported when the URL map is bound to a target gRPC proxy.
6055 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
6056 # was supplied in the request.
6057 #
6058 # The value must be from 1 to 255
6059 # characters.
6060 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
6061 # set to HTTPS.
6062 # If set to false, the URL scheme of the redirected request
6063 # remains the same as that of the request.
6064 #
6065 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
6066 #
6067 # The default is set to false.
6068 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
6069 # that was supplied in the request.
6070 #
6071 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
6072 # supplied, the path of the original request is used for the redirect.
6073 #
6074 # The value must be from 1 to 1024 characters.
6075 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
6076 # the HttpRouteRuleMatch, retaining the remaining portion
6077 # of the URL before redirecting the request.
6078 #
6079 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
6080 # supplied, the path of the original request is used for the redirect.
6081 #
6082 # The value must be from 1 to 1024 characters.
6083 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
6084 #
6085 # Supported values are:
6086 #
6087 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
6088 # to 301.
6089 # - FOUND, which corresponds to 302.
6090 # - SEE_OTHER which corresponds to 303.
6091 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
6092 # method is retained.
6093 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
6094 # method is retained.
6095 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
6096 # URL is
6097 # removed before redirecting the request. If set to false, the
6098 # query portion of the original URL is retained.
6099 #
6100 # The default is set to false.
6101 },
6102 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
6103 # create the resource.
6104 &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
6105 # for the selected backend service.
6106 #
6107 # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
6108 #
6109 # HeaderAction is not supported for load balancers
6110 # that have
6111 # their loadBalancingScheme set to EXTERNAL.
6112 #
6113 # Not supported when the URL map is bound to a target gRPC proxy that
6114 # has validateForProxyless field set to true.
6115 # the request is passed along to the selected backendService.
6116 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
6117 { # Specification determining how headers are added to requests or responses.
6118 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
6119 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
6120 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
6121 # that already
6122 # exist for the header. If true, headerValue is set for the
6123 # header, discarding any values that were set for that header.
6124 #
6125 # The default value is true,
6126 # unless a variable is present in headerValue,
6127 # in which case the default value is false.
6128 # .
6129 },
6130 ],
6131 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
6132 # request before forwarding the request to the backendService.
6133 &quot;A String&quot;,
6134 ],
6135 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
6136 # client.
6137 { # Specification determining how headers are added to requests or responses.
6138 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
6139 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
6140 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
6141 # that already
6142 # exist for the header. If true, headerValue is set for the
6143 # header, discarding any values that were set for that header.
6144 #
6145 # The default value is true,
6146 # unless a variable is present in headerValue,
6147 # in which case the default value is false.
6148 # .
6149 },
6150 ],
6151 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
6152 # response before sending the response back to the client.
6153 &quot;A String&quot;,
6154 ],
6155 },
6156 &quot;name&quot;: &quot;A String&quot;, # The name to which this PathMatcher is referred by theHostRule.
6157 &quot;pathRules&quot;: [ # The list of path rules. Use this list instead of routeRules
6158 # when routing based on simple path matching is all that&#x27;s required. A path
6159 # rule can only include a wildcard character (*) after a
6160 # forward slash character (&quot;/&quot;).
6161 #
6162 # The order by which path rules are specified does not matter.
6163 # Matches are always done on the longest-path-first basis.
6164 #
6165 # For example: a pathRule with a path /a/b/c/* will match
6166 # before /a/b/* irrespective of the order in which those paths appear in this
6167 # list.
6168 #
6169 # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
6170 { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
6171 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
6172 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
6173 #
6174 # If a policy for an
6175 # error code is not configured for the PathRule, a policy for
6176 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
6177 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
6178 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
6179 # effect.
6180 #
6181 # For example, consider a UrlMap with the following configuration:
6182 #
6183 #
6184 # - UrlMap.defaultCustomErrorResponsePolicy are configured
6185 # with policies for 5xx and 4xx errors
6186 # - A PathRule for /coming_soon/ is configured for the error
6187 # code 404.
6188 #
6189 # 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
6190 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
6191 # the policy in PathRule.customErrorResponsePolicy takes
6192 # effect. If any of the requests in this example encounter a 500
6193 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
6194 #
6195 # customErrorResponsePolicy is supported only for
6196 # global external Application Load Balancers.
6197 # backend service or backend bucket responds with an error.
6198 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
6199 #
6200 # In a given policy, if you specify rules for both a range of error codes
6201 # as well as rules for specific error codes then rules with specific error
6202 # codes have a higher priority. For example, assume that you configure a rule
6203 # for 401 (Un-authorized) code, and another for all 4 series
6204 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
6205 # However if the backend service returns a 403, the rule for4xx takes effect.
6206 { # Specifies the mapping between the response code that will be returned along
6207 # with the custom error content and the response code returned by the backend
6208 # service.
6209 &quot;matchResponseCodes&quot;: [ # Valid values include:
6210 #
6211 #
6212 # - A number between 400 and 599: For example
6213 # 401 or 503, in which case the load balancer
6214 # applies the policy if the error code exactly matches this value.
6215 # - 5xx: Load Balancer will apply the policy if the
6216 # backend service responds with any response code in the range of
6217 # 500 to 599.
6218 # - 4xx: Load
6219 # Balancer will apply the policy if the backend service responds with any
6220 # response code in the range of 400 to
6221 # 499.
6222 #
6223 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
6224 &quot;A String&quot;,
6225 ],
6226 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
6227 # error content. If overrideResponseCode is not supplied, the
6228 # same response code returned by the original backend bucket or backend
6229 # service is returned to the client.
6230 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
6231 #
6232 # path must start
6233 # with a leading slash. path cannot have trailing slashes.
6234 #
6235 # If the file is not available in backendBucket or the
6236 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
6237 #
6238 # The value must
6239 # be from 1 to 1024 characters
6240 },
6241 ],
6242 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
6243 # contains the custom error content. Examples are:
6244 #
6245 #
6246 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
6247 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
6248 # - global/backendBuckets/myBackendBucket
6249 #
6250 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
6251 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
6252 #
6253 # If load balancer cannot reach
6254 # the backendBucket, a simple Not Found Error will
6255 # be returned, with the original response code (oroverrideResponseCode if configured).
6256 #
6257 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
6258 },
6259 &quot;paths&quot;: [ # The list of path patterns to match. Each must start with /
6260 # and the only place a * is allowed is at the end following
6261 # a /. The string fed to the path matcher does not include
6262 # any text after the first ? or #, and
6263 # those chars are not allowed here.
6264 &quot;A String&quot;,
6265 ],
6266 &quot;routeAction&quot;: { # In response to a matching path, the load balancer
6267 # performs advanced routing actions, such as URL rewrites and header
6268 # transformations, before forwarding the request to the selected
6269 # backend.
6270 #
6271 #
6272 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
6273 #
6274 #
6275 # URL maps for classic Application Load Balancers only support
6276 # the urlRewrite action within a path rule&#x27;srouteAction.
6277 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
6278 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
6279 # property must be specified. This policy cannot be specified if any target
6280 # backend has Identity-Aware Proxy enabled.
6281 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
6282 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
6283 # header names can be specified. The cache is bypassed for all `cacheMode`
6284 # values.
6285 &quot;A String&quot;,
6286 ],
6287 &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
6288 # on the backend type: for Backend Services, the complete request URI is
6289 # used; for Backend Buckets, the request URI is used without the protocol or
6290 # host, and only query parameters known to Cloud Storage are included.
6291 # Policy defined on Route Action.
6292 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
6293 # parameters will be included. Either specify `excludedQueryParameters`
6294 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
6295 # encoded and not treated as delimiters.
6296 #
6297 # Note: This field applies to routes that use backend services. Attempting
6298 # to set it on a route that points exclusively to Backend Buckets will
6299 # result in a configuration error. For routes that point to a Backend
6300 # Bucket, use `includedQueryParameters` to define which parameters should
6301 # be part of the cache key.
6302 &quot;A String&quot;,
6303 ],
6304 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
6305 #
6306 # Note: This setting is only applicable to routes that use a Backend
6307 # Service. It does not affect requests served by a Backend Bucket, as the
6308 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
6309 # it on a route that points exclusively to Backend Buckets will result in a
6310 # configuration error.
6311 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
6312 #
6313 # Note: This setting is only applicable to routes that use a Backend
6314 # Service. It does not affect requests served by a Backend Bucket, as the
6315 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
6316 # set on a route that points exclusively to Backend Buckets will result in
6317 # a configuration error.
6318 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
6319 # `includedQueryParameters` and `excludedQueryParameters`. If neither
6320 # is set, the entire query string will be included. If false, the query
6321 # string will be excluded from the cache key entirely.
6322 #
6323 # Note: This field applies to routes that use backend services. Attempting
6324 # to set it on a route that points exclusively to Backend Buckets will
6325 # result in a configuration error. For routes that point to a Backend
6326 # Bucket, use `includedQueryParameters` to define which parameters should
6327 # be part of the cache key.
6328 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
6329 # The name=value pair will be used in the cache key Cloud CDN generates.
6330 #
6331 # Note: This setting is only applicable to routes that use a Backend
6332 # Service. It does not affect requests served by a Backend Bucket.
6333 # Attempting to set it on a route that points exclusively to Backend
6334 # Buckets will result in a configuration error. Up to 5 cookie names can be
6335 # specified.
6336 &quot;A String&quot;,
6337 ],
6338 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
6339 &quot;A String&quot;,
6340 ],
6341 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
6342 # parameters will be excluded. Either specify `includedQueryParameters`
6343 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
6344 # encoded and not treated as delimiters.
6345 &quot;A String&quot;,
6346 ],
6347 },
6348 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
6349 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
6350 &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
6351 # content. This is used to clamp the max-age (or Expires) value sent to the
6352 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
6353 # is used for the response max-age directive, along with a &quot;public&quot;
6354 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
6355 # clamps the max-age from the origin (if specified), or else sets the
6356 # response max-age directive to the lesser of the `clientTtl` and
6357 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
6358 # present. The maximum allowed value is 31,622,400s (1 year). If not
6359 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
6360 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
6361 # `USE_ORIGIN_HEADERS`.
6362 # as a count of seconds and fractions of seconds at nanosecond
6363 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6364 # or &quot;month&quot;. Range is approximately 10,000 years.
6365 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6366 # Durations less than one second are represented with a 0
6367 # `seconds` field and a positive `nanos` field. Must be from 0
6368 # to 999,999,999 inclusive.
6369 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6370 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6371 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6372 },
6373 &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
6374 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
6375 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
6376 # greater than that of `maxTtl`. When the `cacheMode` is set to
6377 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
6378 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
6379 # accessed objects may be evicted from the cache before the defined TTL. If
6380 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
6381 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
6382 # `USE_ORIGIN_HEADERS`.
6383 # as a count of seconds and fractions of seconds at nanosecond
6384 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6385 # or &quot;month&quot;. Range is approximately 10,000 years.
6386 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6387 # Durations less than one second are represented with a 0
6388 # `seconds` field and a positive `nanos` field. Must be from 0
6389 # to 999,999,999 inclusive.
6390 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6391 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6392 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6393 },
6394 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
6395 # attempt to set a max-age or s-maxage higher than this, or an Expires header
6396 # more than `maxTtl` seconds in the future will be capped at the value of
6397 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
6398 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
6399 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
6400 # Infrequently accessed objects may be evicted from the cache before the
6401 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
6402 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
6403 # mode.
6404 # as a count of seconds and fractions of seconds at nanosecond
6405 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6406 # or &quot;month&quot;. Range is approximately 10,000 years.
6407 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6408 # Durations less than one second are represented with a 0
6409 # `seconds` field and a positive `nanos` field. Must be from 0
6410 # to 999,999,999 inclusive.
6411 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6412 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6413 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6414 },
6415 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
6416 # to apply fine-grained caching for common errors or redirects.
6417 # This can reduce the load on your origin and improve end-user
6418 # experience by reducing response latency.
6419 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
6420 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
6421 # the specified response code that lack any Cache-Control, Expires, or
6422 # Pragma: no-cache directives. When the `cacheMode` is set to
6423 # `FORCE_CACHE_ALL`, negative caching applies to all responses
6424 # with the specified response code, and overrides any caching headers. By
6425 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
6426 #
6427 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
6428 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
6429 # * 405 (Method Not Found), 501 (Not Implemented): 60s
6430 #
6431 # These defaults can be overridden in `negativeCachingPolicy`.
6432 # If not specified, Cloud CDN applies negative caching by default.
6433 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
6434 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
6435 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
6436 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
6437 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
6438 # all response codes that you wish to cache. Cloud CDN will not apply any
6439 # default negative caching when a policy exists.
6440 { # Specify CDN TTLs for response error codes.
6441 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
6442 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
6443 # specified as values, and you cannot specify a status code more than
6444 # once.
6445 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
6446 # corresponding status code.
6447 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
6448 # objects may be evicted from the cache before the defined TTL.
6449 # as a count of seconds and fractions of seconds at nanosecond
6450 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6451 # or &quot;month&quot;. Range is approximately 10,000 years.
6452 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6453 # Durations less than one second are represented with a 0
6454 # `seconds` field and a positive `nanos` field. Must be from 0
6455 # to 999,999,999 inclusive.
6456 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6457 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6458 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6459 },
6460 },
6461 ],
6462 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
6463 # requests into a small number of requests to the origin. If not specified,
6464 # Cloud CDN applies request coalescing by default.
6465 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
6466 # content with the origin, or when an error is encountered when refreshing
6467 # the cache.
6468 # This setting defines the default &quot;max-stale&quot; duration for any cached
6469 # responses that do not specify a max-stale directive. Stale responses that
6470 # exceed the TTL configured here will not be served. The default limit
6471 # (max-stale) is 86400s (1 day), which will allow stale content to be
6472 # served up to this limit beyond the max-age (or s-maxage) of a cached
6473 # response.
6474 # The maximum allowed value is 604800 (1 week).
6475 # Set this to zero (0) to disable serve-while-stale.
6476 # as a count of seconds and fractions of seconds at nanosecond
6477 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6478 # or &quot;month&quot;. Range is approximately 10,000 years.
6479 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6480 # Durations less than one second are represented with a 0
6481 # `seconds` field and a positive `nanos` field. Must be from 0
6482 # to 999,999,999 inclusive.
6483 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6484 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6485 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6486 },
6487 },
6488 &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
6489 # information about the W3C recommendation for cross-origin resource sharing
6490 # (CORS), see Fetch API Living
6491 # Standard.
6492 #
6493 # Not supported when the URL map is bound to a target gRPC proxy.
6494 # information about the W3C recommendation for cross-origin resource sharing
6495 # (CORS), see Fetch API Living
6496 # Standard.
6497 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
6498 # indicates that
6499 # the actual request can include user credentials. This field translates to
6500 # the Access-Control-Allow-Credentials header.
6501 #
6502 # Default is false.
6503 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
6504 # header.
6505 &quot;A String&quot;,
6506 ],
6507 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
6508 # header.
6509 &quot;A String&quot;,
6510 ],
6511 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
6512 # more information, see regular expression syntax.
6513 #
6514 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
6515 #
6516 # Regular expressions can only be used when the loadBalancingScheme is
6517 # set to INTERNAL_SELF_MANAGED.
6518 &quot;A String&quot;,
6519 ],
6520 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
6521 #
6522 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
6523 &quot;A String&quot;,
6524 ],
6525 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
6526 # The default value is false, which indicates that the CORS
6527 # policy is in effect.
6528 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
6529 # header.
6530 &quot;A String&quot;,
6531 ],
6532 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
6533 # seconds. This field translates to the Access-Control-Max-Age
6534 # header.
6535 },
6536 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
6537 # the resiliency of clients to backend service failure. As part of fault
6538 # injection, when clients send requests to a backend service, delays can be
6539 # introduced by a load balancer on a percentage of requests before sending
6540 # those requests to the backend service. Similarly requests from clients can
6541 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
6542 # that are configured with a fault_injection_policy if:
6543 # 1. The traffic is generated by fault injection AND
6544 # 2. The fault injection is not a delay fault injection.
6545 # Fault injection is not supported with the classic Application Load Balancer
6546 # . To see which load balancers support fault injection,
6547 # see Load
6548 # balancing: Routing and traffic management features.
6549 # the resiliency of clients to backend service failure. As part of fault
6550 # injection, when clients send requests to a backend service, delays can be
6551 # introduced by the load balancer on a percentage of requests before sending
6552 # those request to the backend service. Similarly requests from clients can be
6553 # aborted by the load balancer for a percentage of requests.
6554 &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
6555 # injection.
6556 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
6557 #
6558 # The value must be from 200 to 599 inclusive.
6559 #
6560 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
6561 # according to this
6562 # mapping table. HTTP status 200 is mapped to gRPC status
6563 # UNKNOWN. Injecting an OK status is currently not supported by
6564 # Traffic Director.
6565 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
6566 # that is aborted as part of fault injection.
6567 #
6568 # The value must be from 0.0 to 100.0 inclusive.
6569 },
6570 &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
6571 # injection, before being sent to a backend service.
6572 # request to the backend service as part of fault injection.
6573 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
6574 # as a count of seconds and fractions of seconds at nanosecond
6575 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6576 # or &quot;month&quot;. Range is approximately 10,000 years.
6577 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6578 # Durations less than one second are represented with a 0
6579 # `seconds` field and a positive `nanos` field. Must be from 0
6580 # to 999,999,999 inclusive.
6581 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6582 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6583 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6584 },
6585 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
6586 # which a delay is introduced as part of fault injection.
6587 #
6588 # The value must be from 0.0 to 100.0 inclusive.
6589 },
6590 },
6591 &quot;imageOptimizationPolicy&quot;: { # The configuration for Cloud CDN&#x27;s image optimization feature. This feature # Image optimization policy for this URL Map&#x27;s route. Available only for
6592 # Global EXTERNAL_MANAGED load balancer schemes.
6593 # Either Cloud CDN must be enabled on the backend service or backend bucket
6594 # serving the route, or cache policy must be configured on the same route
6595 # dynamically processes and delivers images from the network edge.
6596 # Image Optimization is only available for Global External Application Load
6597 # Balancers.
6598 # Either Cloud CDN must be enabled on the backend service or backend bucket
6599 # serving the route, or cache policy must be configured on the same route.
6600 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
6601 },
6602 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
6603 # Unlike the timeout field where the timeout duration starts
6604 # from the time the request has been fully processed (known as*end-of-stream*),
6605 # the duration in this field is computed from the beginning of the stream
6606 # until the response has been processed, including all retries. A
6607 # stream that does not complete in this duration is closed.
6608 #
6609 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
6610 # with the route.
6611 #
6612 # This field is only allowed if the Url map is used with backend services
6613 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
6614 # as a count of seconds and fractions of seconds at nanosecond
6615 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6616 # or &quot;month&quot;. Range is approximately 10,000 years.
6617 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6618 # Durations less than one second are represented with a 0
6619 # `seconds` field and a positive `nanos` field. Must be from 0
6620 # to 999,999,999 inclusive.
6621 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6622 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6623 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6624 },
6625 &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
6626 # are shadowed to a separate mirrored backend service. The load balancer does
6627 # not wait for responses from the shadow service. Before sending traffic
6628 # to the shadow service, the host / authority header is suffixed with-shadow.
6629 #
6630 # Not supported when the URL map is bound to a target gRPC proxy that
6631 # has the validateForProxyless field set to true.
6632 # are shadowed to a separate mirrored backend service. The load balancer
6633 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
6634 # to the shadow service, the host or authority header is suffixed with-shadow.
6635 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
6636 # mirrored to.
6637 #
6638 # The backend service configured for a mirroring
6639 # policy must reference backends that are of the same type as the original
6640 # backend service matched in the URL map.
6641 #
6642 # Serverless NEG backends are not currently supported as a mirrored
6643 # backend service.
6644 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
6645 },
6646 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
6647 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
6648 # If not specified, defaults to 1.
6649 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
6650 #
6651 # If not specified, will use the timeout set in theHttpRouteAction field.
6652 # If timeout in the HttpRouteAction field is not set, this field
6653 # uses the largest timeout
6654 # among all backend services associated with the route.
6655 #
6656 # Not supported when the URL map is bound to a target gRPC proxy that
6657 # has the validateForProxyless field set to true.
6658 # as a count of seconds and fractions of seconds at nanosecond
6659 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6660 # or &quot;month&quot;. Range is approximately 10,000 years.
6661 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6662 # Durations less than one second are represented with a 0
6663 # `seconds` field and a positive `nanos` field. Must be from 0
6664 # to 999,999,999 inclusive.
6665 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6666 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6667 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6668 },
6669 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
6670 # values are:
6671 #
6672 # - 5xx: retry is attempted if the instance or endpoint
6673 # responds with any 5xx response code, or if the instance or
6674 # endpoint does not respond at all. For example, disconnects, reset, read
6675 # timeout, connection failure, and refused streams.
6676 # - gateway-error: Similar to 5xx, but only
6677 # applies to response codes 502, 503 or504.
6678 # - connect-failure: a retry is attempted on failures
6679 # connecting to the instance or endpoint. For example, connection
6680 # timeouts.
6681 # - retriable-4xx: a retry is attempted if the instance
6682 # or endpoint responds with a 4xx response code.
6683 # The only error that you can retry is error code 409.
6684 # - refused-stream: a retry is attempted if the instance
6685 # or endpoint resets the stream with a REFUSED_STREAM error
6686 # code. This reset type indicates that it is safe to retry.
6687 # - cancelled: a retry is attempted if the gRPC status
6688 # code in the response header is set to cancelled.
6689 # - deadline-exceeded: a retry is attempted if the gRPC
6690 # status code in the response header is set todeadline-exceeded.
6691 # - internal: a retry is attempted if the gRPC
6692 # status code in the response header is set tointernal.
6693 # - resource-exhausted: a retry is attempted if the gRPC
6694 # status code in the response header is set toresource-exhausted.
6695 # - unavailable: a retry is attempted if the gRPC
6696 # status code in the response header is set tounavailable.
6697 #
6698 # Only the following codes are supported when the URL map is bound to
6699 # target gRPC proxy that has validateForProxyless field set to true.
6700 #
6701 # - cancelled
6702 # - deadline-exceeded
6703 # - internal
6704 # - resource-exhausted
6705 # - unavailable
6706 &quot;A String&quot;,
6707 ],
6708 },
6709 &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
6710 # time the request has been fully processed (known as *end-of-stream*)
6711 # up until the response has been processed. Timeout includes
6712 # all retries.
6713 #
6714 # If not specified, this field uses the largest timeout among all backend
6715 # services associated with the route.
6716 #
6717 # Not supported when the URL map is bound to a target gRPC proxy that
6718 # has validateForProxyless field set to true.
6719 # as a count of seconds and fractions of seconds at nanosecond
6720 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6721 # or &quot;month&quot;. Range is approximately 10,000 years.
6722 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6723 # Durations less than one second are represented with a 0
6724 # `seconds` field and a positive `nanos` field. Must be from 0
6725 # to 999,999,999 inclusive.
6726 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6727 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6728 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6729 },
6730 &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
6731 # to the matched service.
6732 #
6733 # urlRewrite is the only action supported in UrlMaps
6734 # for classic Application Load Balancers.
6735 #
6736 # Not supported when the URL map is bound to a target gRPC proxy that
6737 # has the validateForProxyless field set to true.
6738 # backend service.
6739 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
6740 # host header is replaced with contents of hostRewrite.
6741 #
6742 # The value must be from 1 to 255 characters.
6743 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
6744 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
6745 #
6746 # The value must be from 1 to 1024 characters.
6747 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
6748 # header) using the HTTP template syntax.
6749 #
6750 # A corresponding
6751 # path_template_match must be specified. Any template variables must exist in
6752 # the path_template_match field.
6753 #
6754 #
6755 # - -At least one variable must be specified in the path_template_match
6756 # field
6757 # - You can omit variables from the rewritten URL
6758 # - The * and ** operators cannot be matched
6759 # unless they have a corresponding variable name - e.g.
6760 # {format=*} or {var=**}.
6761 #
6762 # For example, a path_template_match of /static/{format=**}
6763 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
6764 # rewrite, so that /{country}/{format}/{suffix=**} can be
6765 # rewritten as /content/{format}/{country}/{suffix}.
6766 #
6767 # At least
6768 # one non-empty routeRules[].matchRules[].path_template_match is
6769 # required.
6770 #
6771 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
6772 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
6773 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
6774 # It uses RE2 syntax with the following constraints:
6775 #
6776 #
6777 # - Any single character operators
6778 # - Groups are allowed to have only submatch operator inside
6779 # - Groups are allowed only without any char repetition, e.g.
6780 # .*
6781 # - Any char repetition, e.g. .*, is
6782 # only allowed to be used in a single regex together with:
6783 #
6784 #
6785 # - Empty string operators
6786 # - Other repetitions
6787 # - Ranges
6788 # - Repetitions of ranges
6789 #
6790 #
6791 # - Ranges are only allowed to have:
6792 #
6793 #
6794 # - Character range
6795 # - Digits range
6796 # - Symbols listed in characters allowed for ranges
6797 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
6798 # the path.
6799 },
6800 },
6801 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
6802 # occurs. The weights determine the fraction of traffic that flows to
6803 # their corresponding backend service. If all traffic needs to
6804 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
6805 #
6806 # After a backend service is identified and before forwarding
6807 # the request to
6808 # the backend service, advanced routing actions such as URL rewrites and
6809 # header transformations are applied depending on additional settings
6810 # specified in this HttpRouteAction.
6811 { # In contrast to a single BackendService in
6812 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
6813 # multiple backend services. The volume of traffic for each
6814 # backend service is proportional to the weight specified
6815 # in each WeightedBackendService
6816 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
6817 # resource. Before
6818 # forwarding the request to backendService, the load balancer
6819 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
6820 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
6821 # effect for the selected backendService.
6822 #
6823 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
6824 #
6825 # headerAction is not supported for load balancers that have
6826 # their loadBalancingScheme set to EXTERNAL.
6827 #
6828 # Not supported when the URL map is bound to a target gRPC proxy that
6829 # has validateForProxyless field set to true.
6830 # the request is passed along to the selected backendService.
6831 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
6832 { # Specification determining how headers are added to requests or responses.
6833 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
6834 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
6835 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
6836 # that already
6837 # exist for the header. If true, headerValue is set for the
6838 # header, discarding any values that were set for that header.
6839 #
6840 # The default value is true,
6841 # unless a variable is present in headerValue,
6842 # in which case the default value is false.
6843 # .
6844 },
6845 ],
6846 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
6847 # request before forwarding the request to the backendService.
6848 &quot;A String&quot;,
6849 ],
6850 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
6851 # client.
6852 { # Specification determining how headers are added to requests or responses.
6853 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
6854 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
6855 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
6856 # that already
6857 # exist for the header. If true, headerValue is set for the
6858 # header, discarding any values that were set for that header.
6859 #
6860 # The default value is true,
6861 # unless a variable is present in headerValue,
6862 # in which case the default value is false.
6863 # .
6864 },
6865 ],
6866 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
6867 # response before sending the response back to the client.
6868 &quot;A String&quot;,
6869 ],
6870 },
6871 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
6872 # computed asweight / (sum of all weightedBackendService weights in routeAction).
6873 #
6874 # The selection of a backend service is determined only for new traffic.
6875 # Once a user&#x27;s request has been directed to a backend service,
6876 # subsequent requests are sent to the same backend service as
6877 # determined by the backend service&#x27;s session affinity policy.
6878 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
6879 # splitting. If you do, the weighted traffic splitting configuration takes
6880 # precedence.
6881 #
6882 # The value must be from 0 to 1000.
6883 },
6884 ],
6885 },
6886 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
6887 # is directed if this rule is matched. If routeAction is
6888 # also specified, advanced routing actions, such as URL rewrites,
6889 # take effect before sending the request to the backend.
6890 #
6891 #
6892 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
6893 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
6894 # specified by urlRedirect.
6895 #
6896 #
6897 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
6898 #
6899 #
6900 # Not supported when the URL map is bound to a target gRPC proxy.
6901 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
6902 # was supplied in the request.
6903 #
6904 # The value must be from 1 to 255
6905 # characters.
6906 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
6907 # set to HTTPS.
6908 # If set to false, the URL scheme of the redirected request
6909 # remains the same as that of the request.
6910 #
6911 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
6912 #
6913 # The default is set to false.
6914 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
6915 # that was supplied in the request.
6916 #
6917 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
6918 # supplied, the path of the original request is used for the redirect.
6919 #
6920 # The value must be from 1 to 1024 characters.
6921 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
6922 # the HttpRouteRuleMatch, retaining the remaining portion
6923 # of the URL before redirecting the request.
6924 #
6925 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
6926 # supplied, the path of the original request is used for the redirect.
6927 #
6928 # The value must be from 1 to 1024 characters.
6929 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
6930 #
6931 # Supported values are:
6932 #
6933 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
6934 # to 301.
6935 # - FOUND, which corresponds to 302.
6936 # - SEE_OTHER which corresponds to 303.
6937 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
6938 # method is retained.
6939 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
6940 # method is retained.
6941 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
6942 # URL is
6943 # removed before redirecting the request. If set to false, the
6944 # query portion of the original URL is retained.
6945 #
6946 # The default is set to false.
6947 },
6948 },
6949 ],
6950 &quot;routeRules&quot;: [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
6951 # desired. routeRules are evaluated in order of priority, from
6952 # the lowest to highest number.
6953 #
6954 # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
6955 { # The HttpRouteRule setting specifies how to match an HTTP request
6956 # and the corresponding routing action that load balancing proxies perform.
6957 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
6958 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
6959 #
6960 # If a policy for an
6961 # error code is not configured for the RouteRule, a policy for
6962 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
6963 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
6964 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
6965 # effect.
6966 #
6967 # For example, consider a UrlMap with the following configuration:
6968 #
6969 #
6970 # - UrlMap.defaultCustomErrorResponsePolicy are configured
6971 # with policies for 5xx and 4xx errors
6972 # - A RouteRule for /coming_soon/ is configured for the
6973 # error code 404.
6974 #
6975 # 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
6976 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
6977 # the policy in RouteRule.customErrorResponsePolicy takes
6978 # effect. If any of the requests in this example encounter a 500
6979 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
6980 #
6981 # When
6982 # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
6983 # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
6984 # a retry, if load balancer is successful in reaching the
6985 # service, the customErrorResponsePolicy is ignored and
6986 # the response from the service is returned to the client.
6987 #
6988 # customErrorResponsePolicy is supported only for
6989 # global external Application Load Balancers.
6990 # backend service or backend bucket responds with an error.
6991 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
6992 #
6993 # In a given policy, if you specify rules for both a range of error codes
6994 # as well as rules for specific error codes then rules with specific error
6995 # codes have a higher priority. For example, assume that you configure a rule
6996 # for 401 (Un-authorized) code, and another for all 4 series
6997 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
6998 # However if the backend service returns a 403, the rule for4xx takes effect.
6999 { # Specifies the mapping between the response code that will be returned along
7000 # with the custom error content and the response code returned by the backend
7001 # service.
7002 &quot;matchResponseCodes&quot;: [ # Valid values include:
7003 #
7004 #
7005 # - A number between 400 and 599: For example
7006 # 401 or 503, in which case the load balancer
7007 # applies the policy if the error code exactly matches this value.
7008 # - 5xx: Load Balancer will apply the policy if the
7009 # backend service responds with any response code in the range of
7010 # 500 to 599.
7011 # - 4xx: Load
7012 # Balancer will apply the policy if the backend service responds with any
7013 # response code in the range of 400 to
7014 # 499.
7015 #
7016 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
7017 &quot;A String&quot;,
7018 ],
7019 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
7020 # error content. If overrideResponseCode is not supplied, the
7021 # same response code returned by the original backend bucket or backend
7022 # service is returned to the client.
7023 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
7024 #
7025 # path must start
7026 # with a leading slash. path cannot have trailing slashes.
7027 #
7028 # If the file is not available in backendBucket or the
7029 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
7030 #
7031 # The value must
7032 # be from 1 to 1024 characters
7033 },
7034 ],
7035 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
7036 # contains the custom error content. Examples are:
7037 #
7038 #
7039 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
7040 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
7041 # - global/backendBuckets/myBackendBucket
7042 #
7043 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
7044 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
7045 #
7046 # If load balancer cannot reach
7047 # the backendBucket, a simple Not Found Error will
7048 # be returned, with the original response code (oroverrideResponseCode if configured).
7049 #
7050 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
7051 },
7052 &quot;description&quot;: &quot;A String&quot;, # The short description conveying the intent of this routeRule.
7053 #
7054 #
7055 # The description can have a maximum length of 1024 characters.
7056 &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
7057 # for the selected backendService.
7058 #
7059 # The headerAction value specified here is applied before the
7060 # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
7061 #
7062 # HeaderAction is not supported for load balancers
7063 # that have
7064 # their loadBalancingScheme set to EXTERNAL.
7065 #
7066 # Not supported when the URL map is bound to a target gRPC proxy that
7067 # has validateForProxyless field set to true.
7068 # the request is passed along to the selected backendService.
7069 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
7070 { # Specification determining how headers are added to requests or responses.
7071 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
7072 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
7073 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
7074 # that already
7075 # exist for the header. If true, headerValue is set for the
7076 # header, discarding any values that were set for that header.
7077 #
7078 # The default value is true,
7079 # unless a variable is present in headerValue,
7080 # in which case the default value is false.
7081 # .
7082 },
7083 ],
7084 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
7085 # request before forwarding the request to the backendService.
7086 &quot;A String&quot;,
7087 ],
7088 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
7089 # client.
7090 { # Specification determining how headers are added to requests or responses.
7091 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
7092 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
7093 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
7094 # that already
7095 # exist for the header. If true, headerValue is set for the
7096 # header, discarding any values that were set for that header.
7097 #
7098 # The default value is true,
7099 # unless a variable is present in headerValue,
7100 # in which case the default value is false.
7101 # .
7102 },
7103 ],
7104 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
7105 # response before sending the response back to the client.
7106 &quot;A String&quot;,
7107 ],
7108 },
7109 &quot;httpFilterConfigs&quot;: [ # Outbound route specific configuration fornetworkservices.HttpFilter resources enabled by Traffic
7110 # Director. httpFilterConfigs only applies for load balancers
7111 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
7112 # more details.
7113 #
7114 # Not supported when the URL map is bound to a target gRPC proxy that
7115 # has validateForProxyless field set to true.
7116 { # HttpFilterConfiguration supplies additional contextual settings
7117 # for networkservices.HttpFilter resources enabled by Traffic
7118 # Director.
7119 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
7120 # YAML formatted and only contain fields defined in the protobuf identified
7121 # in configTypeUrl
7122 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
7123 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
7124 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
7125 # configuration belongs to. This name must be known to the xDS client.
7126 # Example: envoy.wasm
7127 },
7128 ],
7129 &quot;httpFilterMetadata&quot;: [ # Outbound route specific metadata supplied tonetworkservices.HttpFilter resources enabled by Traffic
7130 # Director. httpFilterMetadata only applies for load balancers
7131 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
7132 # more details.
7133 #
7134 # The only configTypeUrl supported istype.googleapis.com/google.protobuf.Struct
7135 #
7136 # Not supported when the URL map is bound to a target gRPC proxy that
7137 # has validateForProxyless field set to true.
7138 { # HttpFilterConfiguration supplies additional contextual settings
7139 # for networkservices.HttpFilter resources enabled by Traffic
7140 # Director.
7141 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
7142 # YAML formatted and only contain fields defined in the protobuf identified
7143 # in configTypeUrl
7144 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
7145 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
7146 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
7147 # configuration belongs to. This name must be known to the xDS client.
7148 # Example: envoy.wasm
7149 },
7150 ],
7151 &quot;matchRules&quot;: [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
7152 # this routeRule when any of thematchRules are satisfied. However predicates within
7153 # a given matchRule have AND semantics. All predicates
7154 # within a matchRule must match for the request to
7155 # match the rule.
7156 { # HttpRouteRuleMatch specifies a set of criteria for matching
7157 # requests to an HttpRouteRule. All specified criteria must
7158 # be satisfied for a match to occur.
7159 &quot;fullPathMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
7160 # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
7161 # that may be part of the original URL.
7162 #
7163 # fullPathMatch must be from 1 to 1024 characters.
7164 #
7165 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
7166 # specified.
7167 &quot;headerMatches&quot;: [ # Specifies a list of header match criteria, all of which must match
7168 # corresponding headers in the request.
7169 { # matchRule criteria for request header matches.
7170 &quot;exactMatch&quot;: &quot;A String&quot;, # The value should exactly match contents of exactMatch.
7171 #
7172 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
7173 &quot;headerName&quot;: &quot;A String&quot;, # The name of the HTTP header to match.
7174 #
7175 # For matching against the HTTP request&#x27;s authority, use a headerMatch
7176 # with the header name &quot;:authority&quot;.
7177 #
7178 # For matching a request&#x27;s method, use the headerName &quot;:method&quot;.
7179 #
7180 # When the URL map is bound to a target gRPC proxy that has
7181 # the validateForProxyless field set to true, only
7182 # non-binary
7183 # user-specified custom metadata and the `content-type` header are supported.
7184 # The following transport-level headers cannot be used in header matching
7185 # rules:
7186 # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
7187 # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
7188 # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
7189 # `grpc-timeout` and `grpc-trace-bin`.
7190 &quot;invertMatch&quot;: True or False, # If set to false, the headerMatch is considered a
7191 # match if the preceding match criteria are met. If set to true,
7192 # the headerMatch is considered a match if the preceding
7193 # match criteria are NOT met.
7194 #
7195 # The default setting is false.
7196 &quot;prefixMatch&quot;: &quot;A String&quot;, # The value of the header must start with the contents ofprefixMatch.
7197 #
7198 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
7199 &quot;presentMatch&quot;: True or False, # A header with the contents of headerName must exist. The
7200 # match takes place whether or not the request&#x27;s header has a value.
7201 #
7202 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
7203 &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
7204 # specified in rangeMatch. If the header does not contain an
7205 # integer, number or is empty, the match fails.
7206 #
7207 # For example for a range [-5, 0]
7208 #
7209 #
7210 # - -3 will match.
7211 # - 0 will not match.
7212 # - 0.25 will not match.
7213 # - -3someString will not match.
7214 #
7215 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
7216 #
7217 # rangeMatch is not supported for load balancers
7218 # that have loadBalancingScheme set to EXTERNAL.
7219 # within the specified integer range.
7220 &quot;rangeEnd&quot;: &quot;A String&quot;, # The end of the range (exclusive) in signed long integer format.
7221 &quot;rangeStart&quot;: &quot;A String&quot;, # The start of the range (inclusive) in signed long integer format.
7222 },
7223 &quot;regexMatch&quot;: &quot;A String&quot;, # The value of the header must match the regular expression specified inregexMatch.
7224 # For more information about regular expression syntax, see Syntax.
7225 #
7226 # For matching against a port specified in the HTTP request, use a
7227 # headerMatch with headerName set to PORT and a regular expression that
7228 # satisfies the RFC2616 Host header&#x27;s port specifier.
7229 #
7230 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
7231 #
7232 # Regular expressions can only be used when the loadBalancingScheme is
7233 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
7234 # (regional scope) or INTERNAL_MANAGED.
7235 &quot;suffixMatch&quot;: &quot;A String&quot;, # The value of the header must end with the contents ofsuffixMatch.
7236 #
7237 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
7238 },
7239 ],
7240 &quot;ignoreCase&quot;: True or False, # Specifies that prefixMatch and fullPathMatch
7241 # matches are case sensitive.
7242 #
7243 # The default value is false.
7244 #
7245 # ignoreCase must not be used with regexMatch.
7246 #
7247 # Not supported when the URL map is bound to a target gRPC proxy.
7248 &quot;metadataFilters&quot;: [ # Opaque filter criteria used by the load balancer to restrict routing
7249 # configuration to a limited set of xDS
7250 # compliant clients. In their xDS requests to the load balancer, xDS clients
7251 # present node
7252 # metadata. When there is a match, the relevant routing configuration
7253 # is made available to those proxies.
7254 #
7255 # 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
7256 # the metadata. If its filterMatchCriteria is set to
7257 # MATCH_ALL, then all of its filterLabels must match with
7258 # corresponding labels provided in the metadata. If multiple
7259 # metadata filters are specified, all of them need to be
7260 # satisfied in order to be considered a match.
7261 #
7262 # metadataFilters specified here is applied after those
7263 # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
7264 #
7265 # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
7266 #
7267 # Not supported when the URL map is bound to a target gRPC proxy that
7268 # has validateForProxyless field set to true.
7269 { # Opaque filter criteria used by load balancers to restrict routing
7270 # configuration to a limited set of load balancing proxies. Proxies and
7271 # sidecars involved in load balancing would typically present metadata to the
7272 # load balancers that need to match criteria specified here. If a match takes
7273 # place, the relevant configuration is made available to those
7274 # proxies.
7275 #
7276 # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
7277 # one of thefilterLabels must match the corresponding label provided in
7278 # the metadata. If its filterMatchCriteria is set to
7279 # MATCH_ALL, then all of its filterLabels must match with
7280 # corresponding labels provided in the metadata.
7281 #
7282 # An example for using metadataFilters would be: if
7283 # load balancing involves
7284 # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in of their XDS requests to loadbalancers.
7285 &quot;filterLabels&quot;: [ # The list of label value pairs that must match labels in the provided
7286 # metadata based on filterMatchCriteria
7287 #
7288 # This list must not be empty and can have at the most 64 entries.
7289 { # MetadataFilter label name value pairs that are expected
7290 # to match corresponding labels presented as metadata to the load balancer.
7291 &quot;name&quot;: &quot;A String&quot;, # Name of metadata label.
7292 #
7293 # The name can have a maximum length of 1024 characters and must be at
7294 # least 1 character long.
7295 &quot;value&quot;: &quot;A String&quot;, # The value of the label must match the specified value.
7296 #
7297 # value can have a maximum length of 1024 characters.
7298 },
7299 ],
7300 &quot;filterMatchCriteria&quot;: &quot;A String&quot;, # Specifies how individual filter label matches
7301 # within the list of filterLabels and contributes toward the
7302 # overall metadataFilter match.
7303 #
7304 # Supported values are:
7305 #
7306 # - MATCH_ANY: at least one of the filterLabels
7307 # must have a matching label in the provided metadata.
7308 # - MATCH_ALL: all filterLabels must have
7309 # matching labels in the provided metadata.
7310 },
7311 ],
7312 &quot;pathTemplateMatch&quot;: &quot;A String&quot;, # If specified, this field defines a path template pattern that must match
7313 # the :path header after the query string is removed.
7314 #
7315 # A path template pattern can include variables and wildcards.
7316 # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
7317 # matches a single path segment, and ** that matches zero or
7318 # more path segments. The pattern must follow these rules:
7319 #
7320 #
7321 # - The value must be between 1 and 1024 characters.
7322 # - The pattern must start with a leading slash (&quot;/&quot;).
7323 # - No more than 5 operators (variables or wildcards) may appear in
7324 # the pattern.
7325 #
7326 # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
7327 # set.
7328 &quot;prefixMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the request&#x27;s
7329 # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
7330 #
7331 # The value must be from 1 to 1024 characters.
7332 #
7333 # The * character inside a prefix match is
7334 # treated as a literal character, not as a wildcard.
7335 #
7336 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
7337 # used within a matchRule.
7338 &quot;queryParameterMatches&quot;: [ # Specifies a list of query parameter match criteria, all of which must
7339 # match corresponding query parameters in the request.
7340 #
7341 # Not supported when the URL map is bound to a target gRPC proxy.
7342 { # HttpRouteRuleMatch criteria for a request&#x27;s query parameter.
7343 &quot;exactMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
7344 # parameter exactly matches the contents of exactMatch.
7345 #
7346 # Only one of presentMatch, exactMatch, orregexMatch must be set.
7347 &quot;name&quot;: &quot;A String&quot;, # The name of the query parameter to match. The query parameter must exist in
7348 # the request, in the absence of which the request match fails.
7349 &quot;presentMatch&quot;: True or False, # Specifies that the queryParameterMatch matches if the
7350 # request contains the query parameter, irrespective of whether the
7351 # parameter has a value or not.
7352 #
7353 # Only one of presentMatch, exactMatch, orregexMatch must be set.
7354 &quot;regexMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
7355 # parameter matches the regular expression specified byregexMatch. For
7356 # more information about regular expression syntax, see Syntax.
7357 #
7358 # Only one of presentMatch, exactMatch, orregexMatch must be set.
7359 #
7360 # Regular expressions can only be used when the loadBalancingScheme is
7361 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
7362 # (regional scope) or INTERNAL_MANAGED.
7363 },
7364 ],
7365 &quot;regexMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
7366 # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
7367 # supplied with the original URL. For
7368 # more information about regular expression syntax, see Syntax.
7369 #
7370 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
7371 # specified.
7372 #
7373 # Regular expressions can only be used when the loadBalancingScheme is
7374 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
7375 # (regional scope) or INTERNAL_MANAGED.
7376 },
7377 ],
7378 &quot;priority&quot;: 42, # For routeRules within a given pathMatcher,
7379 # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
7380 # of priority, from the lowest to highest number. The priority of a
7381 # rule decreases as its number increases (1, 2, 3, N+1). The first rule
7382 # that matches the request is applied.
7383 #
7384 #
7385 # You cannot configure two or more routeRules with the same priority.
7386 # Priority for each rule must be set to a number from 0 to 2147483647
7387 # inclusive.
7388 #
7389 #
7390 # Priority numbers can have gaps, which enable you to add or remove rules
7391 # in the future without affecting the rest of the rules. For example, 1, 2,
7392 # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
7393 # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
7394 # without any impact on existing rules.
7395 &quot;routeAction&quot;: { # In response to a matching matchRule, the load balancer
7396 # performs advanced routing actions, such as URL rewrites and header
7397 # transformations, before forwarding the request to the selected backend.
7398 #
7399 #
7400 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
7401 #
7402 #
7403 # URL maps for classic Application Load Balancers only support
7404 # the urlRewrite action within a route rule&#x27;srouteAction.
7405 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
7406 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
7407 # property must be specified. This policy cannot be specified if any target
7408 # backend has Identity-Aware Proxy enabled.
7409 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
7410 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
7411 # header names can be specified. The cache is bypassed for all `cacheMode`
7412 # values.
7413 &quot;A String&quot;,
7414 ],
7415 &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
7416 # on the backend type: for Backend Services, the complete request URI is
7417 # used; for Backend Buckets, the request URI is used without the protocol or
7418 # host, and only query parameters known to Cloud Storage are included.
7419 # Policy defined on Route Action.
7420 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
7421 # parameters will be included. Either specify `excludedQueryParameters`
7422 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
7423 # encoded and not treated as delimiters.
7424 #
7425 # Note: This field applies to routes that use backend services. Attempting
7426 # to set it on a route that points exclusively to Backend Buckets will
7427 # result in a configuration error. For routes that point to a Backend
7428 # Bucket, use `includedQueryParameters` to define which parameters should
7429 # be part of the cache key.
7430 &quot;A String&quot;,
7431 ],
7432 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
7433 #
7434 # Note: This setting is only applicable to routes that use a Backend
7435 # Service. It does not affect requests served by a Backend Bucket, as the
7436 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
7437 # it on a route that points exclusively to Backend Buckets will result in a
7438 # configuration error.
7439 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
7440 #
7441 # Note: This setting is only applicable to routes that use a Backend
7442 # Service. It does not affect requests served by a Backend Bucket, as the
7443 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
7444 # set on a route that points exclusively to Backend Buckets will result in
7445 # a configuration error.
7446 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
7447 # `includedQueryParameters` and `excludedQueryParameters`. If neither
7448 # is set, the entire query string will be included. If false, the query
7449 # string will be excluded from the cache key entirely.
7450 #
7451 # Note: This field applies to routes that use backend services. Attempting
7452 # to set it on a route that points exclusively to Backend Buckets will
7453 # result in a configuration error. For routes that point to a Backend
7454 # Bucket, use `includedQueryParameters` to define which parameters should
7455 # be part of the cache key.
7456 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
7457 # The name=value pair will be used in the cache key Cloud CDN generates.
7458 #
7459 # Note: This setting is only applicable to routes that use a Backend
7460 # Service. It does not affect requests served by a Backend Bucket.
7461 # Attempting to set it on a route that points exclusively to Backend
7462 # Buckets will result in a configuration error. Up to 5 cookie names can be
7463 # specified.
7464 &quot;A String&quot;,
7465 ],
7466 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
7467 &quot;A String&quot;,
7468 ],
7469 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
7470 # parameters will be excluded. Either specify `includedQueryParameters`
7471 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
7472 # encoded and not treated as delimiters.
7473 &quot;A String&quot;,
7474 ],
7475 },
7476 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
7477 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
7478 &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
7479 # content. This is used to clamp the max-age (or Expires) value sent to the
7480 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
7481 # is used for the response max-age directive, along with a &quot;public&quot;
7482 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
7483 # clamps the max-age from the origin (if specified), or else sets the
7484 # response max-age directive to the lesser of the `clientTtl` and
7485 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
7486 # present. The maximum allowed value is 31,622,400s (1 year). If not
7487 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
7488 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
7489 # `USE_ORIGIN_HEADERS`.
7490 # as a count of seconds and fractions of seconds at nanosecond
7491 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7492 # or &quot;month&quot;. Range is approximately 10,000 years.
7493 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7494 # Durations less than one second are represented with a 0
7495 # `seconds` field and a positive `nanos` field. Must be from 0
7496 # to 999,999,999 inclusive.
7497 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7498 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7499 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7500 },
7501 &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
7502 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
7503 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
7504 # greater than that of `maxTtl`. When the `cacheMode` is set to
7505 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
7506 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
7507 # accessed objects may be evicted from the cache before the defined TTL. If
7508 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
7509 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
7510 # `USE_ORIGIN_HEADERS`.
7511 # as a count of seconds and fractions of seconds at nanosecond
7512 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7513 # or &quot;month&quot;. Range is approximately 10,000 years.
7514 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7515 # Durations less than one second are represented with a 0
7516 # `seconds` field and a positive `nanos` field. Must be from 0
7517 # to 999,999,999 inclusive.
7518 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7519 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7520 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7521 },
7522 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
7523 # attempt to set a max-age or s-maxage higher than this, or an Expires header
7524 # more than `maxTtl` seconds in the future will be capped at the value of
7525 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
7526 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
7527 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
7528 # Infrequently accessed objects may be evicted from the cache before the
7529 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
7530 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
7531 # mode.
7532 # as a count of seconds and fractions of seconds at nanosecond
7533 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7534 # or &quot;month&quot;. Range is approximately 10,000 years.
7535 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7536 # Durations less than one second are represented with a 0
7537 # `seconds` field and a positive `nanos` field. Must be from 0
7538 # to 999,999,999 inclusive.
7539 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7540 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7541 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7542 },
7543 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
7544 # to apply fine-grained caching for common errors or redirects.
7545 # This can reduce the load on your origin and improve end-user
7546 # experience by reducing response latency.
7547 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
7548 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
7549 # the specified response code that lack any Cache-Control, Expires, or
7550 # Pragma: no-cache directives. When the `cacheMode` is set to
7551 # `FORCE_CACHE_ALL`, negative caching applies to all responses
7552 # with the specified response code, and overrides any caching headers. By
7553 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
7554 #
7555 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
7556 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
7557 # * 405 (Method Not Found), 501 (Not Implemented): 60s
7558 #
7559 # These defaults can be overridden in `negativeCachingPolicy`.
7560 # If not specified, Cloud CDN applies negative caching by default.
7561 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
7562 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
7563 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
7564 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
7565 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
7566 # all response codes that you wish to cache. Cloud CDN will not apply any
7567 # default negative caching when a policy exists.
7568 { # Specify CDN TTLs for response error codes.
7569 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
7570 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
7571 # specified as values, and you cannot specify a status code more than
7572 # once.
7573 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
7574 # corresponding status code.
7575 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
7576 # objects may be evicted from the cache before the defined TTL.
7577 # as a count of seconds and fractions of seconds at nanosecond
7578 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7579 # or &quot;month&quot;. Range is approximately 10,000 years.
7580 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7581 # Durations less than one second are represented with a 0
7582 # `seconds` field and a positive `nanos` field. Must be from 0
7583 # to 999,999,999 inclusive.
7584 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7585 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7586 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7587 },
7588 },
7589 ],
7590 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
7591 # requests into a small number of requests to the origin. If not specified,
7592 # Cloud CDN applies request coalescing by default.
7593 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
7594 # content with the origin, or when an error is encountered when refreshing
7595 # the cache.
7596 # This setting defines the default &quot;max-stale&quot; duration for any cached
7597 # responses that do not specify a max-stale directive. Stale responses that
7598 # exceed the TTL configured here will not be served. The default limit
7599 # (max-stale) is 86400s (1 day), which will allow stale content to be
7600 # served up to this limit beyond the max-age (or s-maxage) of a cached
7601 # response.
7602 # The maximum allowed value is 604800 (1 week).
7603 # Set this to zero (0) to disable serve-while-stale.
7604 # as a count of seconds and fractions of seconds at nanosecond
7605 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7606 # or &quot;month&quot;. Range is approximately 10,000 years.
7607 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7608 # Durations less than one second are represented with a 0
7609 # `seconds` field and a positive `nanos` field. Must be from 0
7610 # to 999,999,999 inclusive.
7611 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7612 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7613 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7614 },
7615 },
7616 &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
7617 # information about the W3C recommendation for cross-origin resource sharing
7618 # (CORS), see Fetch API Living
7619 # Standard.
7620 #
7621 # Not supported when the URL map is bound to a target gRPC proxy.
7622 # information about the W3C recommendation for cross-origin resource sharing
7623 # (CORS), see Fetch API Living
7624 # Standard.
7625 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
7626 # indicates that
7627 # the actual request can include user credentials. This field translates to
7628 # the Access-Control-Allow-Credentials header.
7629 #
7630 # Default is false.
7631 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
7632 # header.
7633 &quot;A String&quot;,
7634 ],
7635 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
7636 # header.
7637 &quot;A String&quot;,
7638 ],
7639 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
7640 # more information, see regular expression syntax.
7641 #
7642 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
7643 #
7644 # Regular expressions can only be used when the loadBalancingScheme is
7645 # set to INTERNAL_SELF_MANAGED.
7646 &quot;A String&quot;,
7647 ],
7648 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
7649 #
7650 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
7651 &quot;A String&quot;,
7652 ],
7653 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
7654 # The default value is false, which indicates that the CORS
7655 # policy is in effect.
7656 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
7657 # header.
7658 &quot;A String&quot;,
7659 ],
7660 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
7661 # seconds. This field translates to the Access-Control-Max-Age
7662 # header.
7663 },
7664 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
7665 # the resiliency of clients to backend service failure. As part of fault
7666 # injection, when clients send requests to a backend service, delays can be
7667 # introduced by a load balancer on a percentage of requests before sending
7668 # those requests to the backend service. Similarly requests from clients can
7669 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
7670 # that are configured with a fault_injection_policy if:
7671 # 1. The traffic is generated by fault injection AND
7672 # 2. The fault injection is not a delay fault injection.
7673 # Fault injection is not supported with the classic Application Load Balancer
7674 # . To see which load balancers support fault injection,
7675 # see Load
7676 # balancing: Routing and traffic management features.
7677 # the resiliency of clients to backend service failure. As part of fault
7678 # injection, when clients send requests to a backend service, delays can be
7679 # introduced by the load balancer on a percentage of requests before sending
7680 # those request to the backend service. Similarly requests from clients can be
7681 # aborted by the load balancer for a percentage of requests.
7682 &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
7683 # injection.
7684 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
7685 #
7686 # The value must be from 200 to 599 inclusive.
7687 #
7688 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
7689 # according to this
7690 # mapping table. HTTP status 200 is mapped to gRPC status
7691 # UNKNOWN. Injecting an OK status is currently not supported by
7692 # Traffic Director.
7693 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
7694 # that is aborted as part of fault injection.
7695 #
7696 # The value must be from 0.0 to 100.0 inclusive.
7697 },
7698 &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
7699 # injection, before being sent to a backend service.
7700 # request to the backend service as part of fault injection.
7701 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
7702 # as a count of seconds and fractions of seconds at nanosecond
7703 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7704 # or &quot;month&quot;. Range is approximately 10,000 years.
7705 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7706 # Durations less than one second are represented with a 0
7707 # `seconds` field and a positive `nanos` field. Must be from 0
7708 # to 999,999,999 inclusive.
7709 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7710 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7711 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7712 },
7713 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
7714 # which a delay is introduced as part of fault injection.
7715 #
7716 # The value must be from 0.0 to 100.0 inclusive.
7717 },
7718 },
7719 &quot;imageOptimizationPolicy&quot;: { # The configuration for Cloud CDN&#x27;s image optimization feature. This feature # Image optimization policy for this URL Map&#x27;s route. Available only for
7720 # Global EXTERNAL_MANAGED load balancer schemes.
7721 # Either Cloud CDN must be enabled on the backend service or backend bucket
7722 # serving the route, or cache policy must be configured on the same route
7723 # dynamically processes and delivers images from the network edge.
7724 # Image Optimization is only available for Global External Application Load
7725 # Balancers.
7726 # Either Cloud CDN must be enabled on the backend service or backend bucket
7727 # serving the route, or cache policy must be configured on the same route.
7728 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
7729 },
7730 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
7731 # Unlike the timeout field where the timeout duration starts
7732 # from the time the request has been fully processed (known as*end-of-stream*),
7733 # the duration in this field is computed from the beginning of the stream
7734 # until the response has been processed, including all retries. A
7735 # stream that does not complete in this duration is closed.
7736 #
7737 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
7738 # with the route.
7739 #
7740 # This field is only allowed if the Url map is used with backend services
7741 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
7742 # as a count of seconds and fractions of seconds at nanosecond
7743 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7744 # or &quot;month&quot;. Range is approximately 10,000 years.
7745 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7746 # Durations less than one second are represented with a 0
7747 # `seconds` field and a positive `nanos` field. Must be from 0
7748 # to 999,999,999 inclusive.
7749 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7750 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7751 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7752 },
7753 &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
7754 # are shadowed to a separate mirrored backend service. The load balancer does
7755 # not wait for responses from the shadow service. Before sending traffic
7756 # to the shadow service, the host / authority header is suffixed with-shadow.
7757 #
7758 # Not supported when the URL map is bound to a target gRPC proxy that
7759 # has the validateForProxyless field set to true.
7760 # are shadowed to a separate mirrored backend service. The load balancer
7761 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
7762 # to the shadow service, the host or authority header is suffixed with-shadow.
7763 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
7764 # mirrored to.
7765 #
7766 # The backend service configured for a mirroring
7767 # policy must reference backends that are of the same type as the original
7768 # backend service matched in the URL map.
7769 #
7770 # Serverless NEG backends are not currently supported as a mirrored
7771 # backend service.
7772 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
7773 },
7774 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
7775 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
7776 # If not specified, defaults to 1.
7777 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
7778 #
7779 # If not specified, will use the timeout set in theHttpRouteAction field.
7780 # If timeout in the HttpRouteAction field is not set, this field
7781 # uses the largest timeout
7782 # among all backend services associated with the route.
7783 #
7784 # Not supported when the URL map is bound to a target gRPC proxy that
7785 # has the validateForProxyless field set to true.
7786 # as a count of seconds and fractions of seconds at nanosecond
7787 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7788 # or &quot;month&quot;. Range is approximately 10,000 years.
7789 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7790 # Durations less than one second are represented with a 0
7791 # `seconds` field and a positive `nanos` field. Must be from 0
7792 # to 999,999,999 inclusive.
7793 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7794 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7795 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7796 },
7797 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
7798 # values are:
7799 #
7800 # - 5xx: retry is attempted if the instance or endpoint
7801 # responds with any 5xx response code, or if the instance or
7802 # endpoint does not respond at all. For example, disconnects, reset, read
7803 # timeout, connection failure, and refused streams.
7804 # - gateway-error: Similar to 5xx, but only
7805 # applies to response codes 502, 503 or504.
7806 # - connect-failure: a retry is attempted on failures
7807 # connecting to the instance or endpoint. For example, connection
7808 # timeouts.
7809 # - retriable-4xx: a retry is attempted if the instance
7810 # or endpoint responds with a 4xx response code.
7811 # The only error that you can retry is error code 409.
7812 # - refused-stream: a retry is attempted if the instance
7813 # or endpoint resets the stream with a REFUSED_STREAM error
7814 # code. This reset type indicates that it is safe to retry.
7815 # - cancelled: a retry is attempted if the gRPC status
7816 # code in the response header is set to cancelled.
7817 # - deadline-exceeded: a retry is attempted if the gRPC
7818 # status code in the response header is set todeadline-exceeded.
7819 # - internal: a retry is attempted if the gRPC
7820 # status code in the response header is set tointernal.
7821 # - resource-exhausted: a retry is attempted if the gRPC
7822 # status code in the response header is set toresource-exhausted.
7823 # - unavailable: a retry is attempted if the gRPC
7824 # status code in the response header is set tounavailable.
7825 #
7826 # Only the following codes are supported when the URL map is bound to
7827 # target gRPC proxy that has validateForProxyless field set to true.
7828 #
7829 # - cancelled
7830 # - deadline-exceeded
7831 # - internal
7832 # - resource-exhausted
7833 # - unavailable
7834 &quot;A String&quot;,
7835 ],
7836 },
7837 &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
7838 # time the request has been fully processed (known as *end-of-stream*)
7839 # up until the response has been processed. Timeout includes
7840 # all retries.
7841 #
7842 # If not specified, this field uses the largest timeout among all backend
7843 # services associated with the route.
7844 #
7845 # Not supported when the URL map is bound to a target gRPC proxy that
7846 # has validateForProxyless field set to true.
7847 # as a count of seconds and fractions of seconds at nanosecond
7848 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7849 # or &quot;month&quot;. Range is approximately 10,000 years.
7850 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7851 # Durations less than one second are represented with a 0
7852 # `seconds` field and a positive `nanos` field. Must be from 0
7853 # to 999,999,999 inclusive.
7854 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7855 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7856 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7857 },
7858 &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
7859 # to the matched service.
7860 #
7861 # urlRewrite is the only action supported in UrlMaps
7862 # for classic Application Load Balancers.
7863 #
7864 # Not supported when the URL map is bound to a target gRPC proxy that
7865 # has the validateForProxyless field set to true.
7866 # backend service.
7867 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
7868 # host header is replaced with contents of hostRewrite.
7869 #
7870 # The value must be from 1 to 255 characters.
7871 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
7872 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
7873 #
7874 # The value must be from 1 to 1024 characters.
7875 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
7876 # header) using the HTTP template syntax.
7877 #
7878 # A corresponding
7879 # path_template_match must be specified. Any template variables must exist in
7880 # the path_template_match field.
7881 #
7882 #
7883 # - -At least one variable must be specified in the path_template_match
7884 # field
7885 # - You can omit variables from the rewritten URL
7886 # - The * and ** operators cannot be matched
7887 # unless they have a corresponding variable name - e.g.
7888 # {format=*} or {var=**}.
7889 #
7890 # For example, a path_template_match of /static/{format=**}
7891 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
7892 # rewrite, so that /{country}/{format}/{suffix=**} can be
7893 # rewritten as /content/{format}/{country}/{suffix}.
7894 #
7895 # At least
7896 # one non-empty routeRules[].matchRules[].path_template_match is
7897 # required.
7898 #
7899 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
7900 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
7901 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
7902 # It uses RE2 syntax with the following constraints:
7903 #
7904 #
7905 # - Any single character operators
7906 # - Groups are allowed to have only submatch operator inside
7907 # - Groups are allowed only without any char repetition, e.g.
7908 # .*
7909 # - Any char repetition, e.g. .*, is
7910 # only allowed to be used in a single regex together with:
7911 #
7912 #
7913 # - Empty string operators
7914 # - Other repetitions
7915 # - Ranges
7916 # - Repetitions of ranges
7917 #
7918 #
7919 # - Ranges are only allowed to have:
7920 #
7921 #
7922 # - Character range
7923 # - Digits range
7924 # - Symbols listed in characters allowed for ranges
7925 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
7926 # the path.
7927 },
7928 },
7929 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
7930 # occurs. The weights determine the fraction of traffic that flows to
7931 # their corresponding backend service. If all traffic needs to
7932 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
7933 #
7934 # After a backend service is identified and before forwarding
7935 # the request to
7936 # the backend service, advanced routing actions such as URL rewrites and
7937 # header transformations are applied depending on additional settings
7938 # specified in this HttpRouteAction.
7939 { # In contrast to a single BackendService in
7940 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
7941 # multiple backend services. The volume of traffic for each
7942 # backend service is proportional to the weight specified
7943 # in each WeightedBackendService
7944 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
7945 # resource. Before
7946 # forwarding the request to backendService, the load balancer
7947 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
7948 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
7949 # effect for the selected backendService.
7950 #
7951 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
7952 #
7953 # headerAction is not supported for load balancers that have
7954 # their loadBalancingScheme set to EXTERNAL.
7955 #
7956 # Not supported when the URL map is bound to a target gRPC proxy that
7957 # has validateForProxyless field set to true.
7958 # the request is passed along to the selected backendService.
7959 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
7960 { # Specification determining how headers are added to requests or responses.
7961 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
7962 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
7963 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
7964 # that already
7965 # exist for the header. If true, headerValue is set for the
7966 # header, discarding any values that were set for that header.
7967 #
7968 # The default value is true,
7969 # unless a variable is present in headerValue,
7970 # in which case the default value is false.
7971 # .
7972 },
7973 ],
7974 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
7975 # request before forwarding the request to the backendService.
7976 &quot;A String&quot;,
7977 ],
7978 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
7979 # client.
7980 { # Specification determining how headers are added to requests or responses.
7981 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
7982 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
7983 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
7984 # that already
7985 # exist for the header. If true, headerValue is set for the
7986 # header, discarding any values that were set for that header.
7987 #
7988 # The default value is true,
7989 # unless a variable is present in headerValue,
7990 # in which case the default value is false.
7991 # .
7992 },
7993 ],
7994 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
7995 # response before sending the response back to the client.
7996 &quot;A String&quot;,
7997 ],
7998 },
7999 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
8000 # computed asweight / (sum of all weightedBackendService weights in routeAction).
8001 #
8002 # The selection of a backend service is determined only for new traffic.
8003 # Once a user&#x27;s request has been directed to a backend service,
8004 # subsequent requests are sent to the same backend service as
8005 # determined by the backend service&#x27;s session affinity policy.
8006 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
8007 # splitting. If you do, the weighted traffic splitting configuration takes
8008 # precedence.
8009 #
8010 # The value must be from 0 to 1000.
8011 },
8012 ],
8013 },
8014 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
8015 # is directed if this rule is matched. If routeAction is
8016 # also specified, advanced routing actions, such as URL rewrites,
8017 # take effect before sending the request to the backend.
8018 #
8019 #
8020 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
8021 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
8022 # specified by urlRedirect.
8023 #
8024 #
8025 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
8026 #
8027 #
8028 # Not supported when the URL map is bound to a target gRPC proxy.
8029 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
8030 # was supplied in the request.
8031 #
8032 # The value must be from 1 to 255
8033 # characters.
8034 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
8035 # set to HTTPS.
8036 # If set to false, the URL scheme of the redirected request
8037 # remains the same as that of the request.
8038 #
8039 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
8040 #
8041 # The default is set to false.
8042 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
8043 # that was supplied in the request.
8044 #
8045 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
8046 # supplied, the path of the original request is used for the redirect.
8047 #
8048 # The value must be from 1 to 1024 characters.
8049 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
8050 # the HttpRouteRuleMatch, retaining the remaining portion
8051 # of the URL before redirecting the request.
8052 #
8053 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
8054 # supplied, the path of the original request is used for the redirect.
8055 #
8056 # The value must be from 1 to 1024 characters.
8057 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
8058 #
8059 # Supported values are:
8060 #
8061 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
8062 # to 301.
8063 # - FOUND, which corresponds to 302.
8064 # - SEE_OTHER which corresponds to 303.
8065 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
8066 # method is retained.
8067 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
8068 # method is retained.
8069 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
8070 # URL is
8071 # removed before redirecting the request. If set to false, the
8072 # query portion of the original URL is retained.
8073 #
8074 # The default is set to false.
8075 },
8076 },
8077 ],
8078 },
8079 ],
8080 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the regional URL map resides.
8081 # This field is not applicable to global URL maps.
8082 # You must specify this field as part of the HTTP request URL. It is
8083 # not settable as a field in the request body.
8084 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
8085 &quot;status&quot;: { # [Output Only] The status of the URL map. # Output only. [Output Only] The status of the URL map.
8086 &quot;quotaUsage&quot;: { # Message representing the quota usage for a UrlMap. # Output only. Summary of quota usage for given UrlMap.
8087 &quot;forwardingRules&quot;: 42, # Output only. The number of forwarding rules that uses this UrlMap.
8088 &quot;units&quot;: &quot;A String&quot;, # Output only. The number of quota units calculated for this UrlMap.
8089 },
8090 },
8091 &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
8092 # maximum of 100 tests per UrlMap.
8093 #
8094 # Not supported when the URL map is bound to a target gRPC proxy that
8095 # has validateForProxyless field set to true.
8096 { # Message for the expected URL mappings.
8097 &quot;backendServiceWeight&quot;: 42, # The weight to use for the supplied host and path when using advanced
8098 # routing rules that involve traffic splitting.
8099 &quot;description&quot;: &quot;A String&quot;, # Description of this test case.
8100 &quot;expectedOutputUrl&quot;: &quot;A String&quot;, # The expected output URL evaluated by the load balancer
8101 # containing the scheme, host, path and query parameters.
8102 #
8103 # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
8104 # the load balancer to backends. For rules with urlRewrite,
8105 # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
8106 #
8107 # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer&#x27;s
8108 # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
8109 # If urlRedirect specifies strip_query, the test
8110 # passes only if expectedOutputUrl does not contain any query
8111 # parameters.
8112 #
8113 # expectedOutputUrl is optional whenservice is specified.
8114 &quot;expectedRedirectResponseCode&quot;: 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
8115 # load balancer&#x27;s redirect response.
8116 #
8117 # expectedRedirectResponseCode cannot be set whenservice is set.
8118 &quot;expectedUrlRedirect&quot;: &quot;A String&quot;, # The expected URL that should be redirected to for the host and path
8119 # being tested.
8120 # [Deprecated] This field is deprecated.
8121 # Use expected_output_url instead.
8122 &quot;headers&quot;: [ # HTTP headers for this request. If headers contains
8123 # a host header, then host must also match the header value.
8124 { # HTTP headers used in UrlMapTests.
8125 &quot;name&quot;: &quot;A String&quot;, # Header name.
8126 &quot;value&quot;: &quot;A String&quot;, # Header value.
8127 },
8128 ],
8129 &quot;host&quot;: &quot;A String&quot;, # Host portion of the URL. If headers contains a host header,
8130 # then host must also match the header value.
8131 &quot;path&quot;: &quot;A String&quot;, # Path portion of the URL.
8132 &quot;service&quot;: &quot;A String&quot;, # Expected BackendService or BackendBucket resource
8133 # the given URL should be mapped to.
8134 #
8135 # The service field cannot
8136 # be set if expectedRedirectResponseCode is set.
8137 },
8138 ],
8139 }</pre>
8140 </div>
8141
8142 <div class="method">
8143 <code class="details" id="insert">insert(project, body=None, requestId=None, x__xgafv=None)</code>
8144 <pre>Creates a UrlMap resource in the specified project using
8145 the data included in the request.
8146
8147 Args:
8148 project: string, Project ID for this request. (required)
8149 body: object, The request body.
8150 The object takes the form of:
8151
8152 { # Represents a URL Map resource.
8153 #
8154 # Compute Engine has two URL Map resources:
8155 #
8156 # * [Global](/compute/docs/reference/rest/alpha/urlMaps)
8157 # * [Regional](/compute/docs/reference/rest/alpha/regionUrlMaps)
8158 #
8159 # A URL map resource is a component of certain types of cloud load balancers
8160 # and Traffic Director:
8161 #
8162 # * urlMaps are used by global external Application Load
8163 # Balancers, classic Application Load Balancers, and cross-region internal
8164 # Application Load Balancers.
8165 # * regionUrlMaps are used by internal Application Load Balancers,
8166 # regional external Application Load Balancers and regional internal
8167 # Application Load Balancers.
8168 #
8169 # For a list of supported URL map features by the load balancer type, see the
8170 # Load balancing features: Routing and traffic management table.
8171 #
8172 # For a list of supported URL map features for Traffic Director, see the
8173 # Traffic Director features: Routing and traffic management table.
8174 #
8175 # This resource defines mappings from hostnames and URL paths to either a
8176 # backend service or a backend bucket.
8177 #
8178 # To use the global urlMaps resource, the backend service must
8179 # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
8180 # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
8181 # information, read URL
8182 # Map Concepts.
8183 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
8184 # text format.
8185 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
8186 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
8187 #
8188 # This policy takes
8189 # effect at the load balancer level and applies only when no policy has been
8190 # defined for the error code at lower levels like PathMatcher, RouteRule and
8191 # PathRule within this UrlMap.
8192 #
8193 # For example, consider a UrlMap with the
8194 # following configuration:
8195 #
8196 #
8197 # - defaultCustomErrorResponsePolicy containing policies for
8198 # responding to 5xx and 4xx errors
8199 # - A PathMatcher configured for *.example.com has
8200 # defaultCustomErrorResponsePolicy for 4xx.
8201 #
8202 # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
8203 # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
8204 # a request that does not match any host in *.example.com such
8205 # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
8206 # takes effect.
8207 #
8208 # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
8209 # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
8210 # a retry, if load balancer is successful in reaching the
8211 # service, the defaultCustomErrorResponsePolicy is ignored and
8212 # the response from the service is returned to the client.
8213 #
8214 # defaultCustomErrorResponsePolicy is supported only for
8215 # global external Application Load Balancers.
8216 # backend service or backend bucket responds with an error.
8217 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
8218 #
8219 # In a given policy, if you specify rules for both a range of error codes
8220 # as well as rules for specific error codes then rules with specific error
8221 # codes have a higher priority. For example, assume that you configure a rule
8222 # for 401 (Un-authorized) code, and another for all 4 series
8223 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
8224 # However if the backend service returns a 403, the rule for4xx takes effect.
8225 { # Specifies the mapping between the response code that will be returned along
8226 # with the custom error content and the response code returned by the backend
8227 # service.
8228 &quot;matchResponseCodes&quot;: [ # Valid values include:
8229 #
8230 #
8231 # - A number between 400 and 599: For example
8232 # 401 or 503, in which case the load balancer
8233 # applies the policy if the error code exactly matches this value.
8234 # - 5xx: Load Balancer will apply the policy if the
8235 # backend service responds with any response code in the range of
8236 # 500 to 599.
8237 # - 4xx: Load
8238 # Balancer will apply the policy if the backend service responds with any
8239 # response code in the range of 400 to
8240 # 499.
8241 #
8242 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
8243 &quot;A String&quot;,
8244 ],
8245 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
8246 # error content. If overrideResponseCode is not supplied, the
8247 # same response code returned by the original backend bucket or backend
8248 # service is returned to the client.
8249 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
8250 #
8251 # path must start
8252 # with a leading slash. path cannot have trailing slashes.
8253 #
8254 # If the file is not available in backendBucket or the
8255 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
8256 #
8257 # The value must
8258 # be from 1 to 1024 characters
8259 },
8260 ],
8261 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
8262 # contains the custom error content. Examples are:
8263 #
8264 #
8265 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
8266 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
8267 # - global/backendBuckets/myBackendBucket
8268 #
8269 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
8270 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
8271 #
8272 # If load balancer cannot reach
8273 # the backendBucket, a simple Not Found Error will
8274 # be returned, with the original response code (oroverrideResponseCode if configured).
8275 #
8276 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
8277 },
8278 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
8279 # hostRules match. The load balancer performs advanced routing
8280 # actions, such as URL rewrites and header transformations, before forwarding
8281 # the request to the selected backend.
8282 #
8283 #
8284 # Only one of defaultUrlRedirect, defaultService
8285 # or defaultRouteAction.weightedBackendService can be set.
8286 #
8287 #
8288 # URL maps for classic Application Load Balancers only support
8289 # the urlRewrite action within defaultRouteAction.
8290 #
8291 #
8292 # defaultRouteAction has no effect when the URL map is bound
8293 # to a target gRPC proxy that has the validateForProxyless field
8294 # set to true.
8295 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
8296 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
8297 # property must be specified. This policy cannot be specified if any target
8298 # backend has Identity-Aware Proxy enabled.
8299 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
8300 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
8301 # header names can be specified. The cache is bypassed for all `cacheMode`
8302 # values.
8303 &quot;A String&quot;,
8304 ],
8305 &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
8306 # on the backend type: for Backend Services, the complete request URI is
8307 # used; for Backend Buckets, the request URI is used without the protocol or
8308 # host, and only query parameters known to Cloud Storage are included.
8309 # Policy defined on Route Action.
8310 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
8311 # parameters will be included. Either specify `excludedQueryParameters`
8312 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
8313 # encoded and not treated as delimiters.
8314 #
8315 # Note: This field applies to routes that use backend services. Attempting
8316 # to set it on a route that points exclusively to Backend Buckets will
8317 # result in a configuration error. For routes that point to a Backend
8318 # Bucket, use `includedQueryParameters` to define which parameters should
8319 # be part of the cache key.
8320 &quot;A String&quot;,
8321 ],
8322 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
8323 #
8324 # Note: This setting is only applicable to routes that use a Backend
8325 # Service. It does not affect requests served by a Backend Bucket, as the
8326 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
8327 # it on a route that points exclusively to Backend Buckets will result in a
8328 # configuration error.
8329 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
8330 #
8331 # Note: This setting is only applicable to routes that use a Backend
8332 # Service. It does not affect requests served by a Backend Bucket, as the
8333 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
8334 # set on a route that points exclusively to Backend Buckets will result in
8335 # a configuration error.
8336 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
8337 # `includedQueryParameters` and `excludedQueryParameters`. If neither
8338 # is set, the entire query string will be included. If false, the query
8339 # string will be excluded from the cache key entirely.
8340 #
8341 # Note: This field applies to routes that use backend services. Attempting
8342 # to set it on a route that points exclusively to Backend Buckets will
8343 # result in a configuration error. For routes that point to a Backend
8344 # Bucket, use `includedQueryParameters` to define which parameters should
8345 # be part of the cache key.
8346 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
8347 # The name=value pair will be used in the cache key Cloud CDN generates.
8348 #
8349 # Note: This setting is only applicable to routes that use a Backend
8350 # Service. It does not affect requests served by a Backend Bucket.
8351 # Attempting to set it on a route that points exclusively to Backend
8352 # Buckets will result in a configuration error. Up to 5 cookie names can be
8353 # specified.
8354 &quot;A String&quot;,
8355 ],
8356 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
8357 &quot;A String&quot;,
8358 ],
8359 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
8360 # parameters will be excluded. Either specify `includedQueryParameters`
8361 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
8362 # encoded and not treated as delimiters.
8363 &quot;A String&quot;,
8364 ],
8365 },
8366 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
8367 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
8368 &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
8369 # content. This is used to clamp the max-age (or Expires) value sent to the
8370 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
8371 # is used for the response max-age directive, along with a &quot;public&quot;
8372 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
8373 # clamps the max-age from the origin (if specified), or else sets the
8374 # response max-age directive to the lesser of the `clientTtl` and
8375 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
8376 # present. The maximum allowed value is 31,622,400s (1 year). If not
8377 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
8378 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
8379 # `USE_ORIGIN_HEADERS`.
8380 # as a count of seconds and fractions of seconds at nanosecond
8381 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8382 # or &quot;month&quot;. Range is approximately 10,000 years.
8383 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8384 # Durations less than one second are represented with a 0
8385 # `seconds` field and a positive `nanos` field. Must be from 0
8386 # to 999,999,999 inclusive.
8387 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8388 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8389 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8390 },
8391 &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
8392 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
8393 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
8394 # greater than that of `maxTtl`. When the `cacheMode` is set to
8395 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
8396 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
8397 # accessed objects may be evicted from the cache before the defined TTL. If
8398 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
8399 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
8400 # `USE_ORIGIN_HEADERS`.
8401 # as a count of seconds and fractions of seconds at nanosecond
8402 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8403 # or &quot;month&quot;. Range is approximately 10,000 years.
8404 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8405 # Durations less than one second are represented with a 0
8406 # `seconds` field and a positive `nanos` field. Must be from 0
8407 # to 999,999,999 inclusive.
8408 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8409 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8410 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8411 },
8412 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
8413 # attempt to set a max-age or s-maxage higher than this, or an Expires header
8414 # more than `maxTtl` seconds in the future will be capped at the value of
8415 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
8416 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
8417 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
8418 # Infrequently accessed objects may be evicted from the cache before the
8419 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
8420 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
8421 # mode.
8422 # as a count of seconds and fractions of seconds at nanosecond
8423 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8424 # or &quot;month&quot;. Range is approximately 10,000 years.
8425 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8426 # Durations less than one second are represented with a 0
8427 # `seconds` field and a positive `nanos` field. Must be from 0
8428 # to 999,999,999 inclusive.
8429 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8430 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8431 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8432 },
8433 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
8434 # to apply fine-grained caching for common errors or redirects.
8435 # This can reduce the load on your origin and improve end-user
8436 # experience by reducing response latency.
8437 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
8438 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
8439 # the specified response code that lack any Cache-Control, Expires, or
8440 # Pragma: no-cache directives. When the `cacheMode` is set to
8441 # `FORCE_CACHE_ALL`, negative caching applies to all responses
8442 # with the specified response code, and overrides any caching headers. By
8443 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
8444 #
8445 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
8446 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
8447 # * 405 (Method Not Found), 501 (Not Implemented): 60s
8448 #
8449 # These defaults can be overridden in `negativeCachingPolicy`.
8450 # If not specified, Cloud CDN applies negative caching by default.
8451 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
8452 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
8453 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
8454 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
8455 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
8456 # all response codes that you wish to cache. Cloud CDN will not apply any
8457 # default negative caching when a policy exists.
8458 { # Specify CDN TTLs for response error codes.
8459 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
8460 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
8461 # specified as values, and you cannot specify a status code more than
8462 # once.
8463 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
8464 # corresponding status code.
8465 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
8466 # objects may be evicted from the cache before the defined TTL.
8467 # as a count of seconds and fractions of seconds at nanosecond
8468 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8469 # or &quot;month&quot;. Range is approximately 10,000 years.
8470 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8471 # Durations less than one second are represented with a 0
8472 # `seconds` field and a positive `nanos` field. Must be from 0
8473 # to 999,999,999 inclusive.
8474 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8475 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8476 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8477 },
8478 },
8479 ],
8480 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
8481 # requests into a small number of requests to the origin. If not specified,
8482 # Cloud CDN applies request coalescing by default.
8483 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
8484 # content with the origin, or when an error is encountered when refreshing
8485 # the cache.
8486 # This setting defines the default &quot;max-stale&quot; duration for any cached
8487 # responses that do not specify a max-stale directive. Stale responses that
8488 # exceed the TTL configured here will not be served. The default limit
8489 # (max-stale) is 86400s (1 day), which will allow stale content to be
8490 # served up to this limit beyond the max-age (or s-maxage) of a cached
8491 # response.
8492 # The maximum allowed value is 604800 (1 week).
8493 # Set this to zero (0) to disable serve-while-stale.
8494 # as a count of seconds and fractions of seconds at nanosecond
8495 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8496 # or &quot;month&quot;. Range is approximately 10,000 years.
8497 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8498 # Durations less than one second are represented with a 0
8499 # `seconds` field and a positive `nanos` field. Must be from 0
8500 # to 999,999,999 inclusive.
8501 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8502 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8503 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8504 },
8505 },
8506 &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
8507 # information about the W3C recommendation for cross-origin resource sharing
8508 # (CORS), see Fetch API Living
8509 # Standard.
8510 #
8511 # Not supported when the URL map is bound to a target gRPC proxy.
8512 # information about the W3C recommendation for cross-origin resource sharing
8513 # (CORS), see Fetch API Living
8514 # Standard.
8515 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
8516 # indicates that
8517 # the actual request can include user credentials. This field translates to
8518 # the Access-Control-Allow-Credentials header.
8519 #
8520 # Default is false.
8521 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
8522 # header.
8523 &quot;A String&quot;,
8524 ],
8525 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
8526 # header.
8527 &quot;A String&quot;,
8528 ],
8529 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
8530 # more information, see regular expression syntax.
8531 #
8532 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
8533 #
8534 # Regular expressions can only be used when the loadBalancingScheme is
8535 # set to INTERNAL_SELF_MANAGED.
8536 &quot;A String&quot;,
8537 ],
8538 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
8539 #
8540 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
8541 &quot;A String&quot;,
8542 ],
8543 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
8544 # The default value is false, which indicates that the CORS
8545 # policy is in effect.
8546 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
8547 # header.
8548 &quot;A String&quot;,
8549 ],
8550 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
8551 # seconds. This field translates to the Access-Control-Max-Age
8552 # header.
8553 },
8554 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
8555 # the resiliency of clients to backend service failure. As part of fault
8556 # injection, when clients send requests to a backend service, delays can be
8557 # introduced by a load balancer on a percentage of requests before sending
8558 # those requests to the backend service. Similarly requests from clients can
8559 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
8560 # that are configured with a fault_injection_policy if:
8561 # 1. The traffic is generated by fault injection AND
8562 # 2. The fault injection is not a delay fault injection.
8563 # Fault injection is not supported with the classic Application Load Balancer
8564 # . To see which load balancers support fault injection,
8565 # see Load
8566 # balancing: Routing and traffic management features.
8567 # the resiliency of clients to backend service failure. As part of fault
8568 # injection, when clients send requests to a backend service, delays can be
8569 # introduced by the load balancer on a percentage of requests before sending
8570 # those request to the backend service. Similarly requests from clients can be
8571 # aborted by the load balancer for a percentage of requests.
8572 &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
8573 # injection.
8574 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
8575 #
8576 # The value must be from 200 to 599 inclusive.
8577 #
8578 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
8579 # according to this
8580 # mapping table. HTTP status 200 is mapped to gRPC status
8581 # UNKNOWN. Injecting an OK status is currently not supported by
8582 # Traffic Director.
8583 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
8584 # that is aborted as part of fault injection.
8585 #
8586 # The value must be from 0.0 to 100.0 inclusive.
8587 },
8588 &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
8589 # injection, before being sent to a backend service.
8590 # request to the backend service as part of fault injection.
8591 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
8592 # as a count of seconds and fractions of seconds at nanosecond
8593 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8594 # or &quot;month&quot;. Range is approximately 10,000 years.
8595 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8596 # Durations less than one second are represented with a 0
8597 # `seconds` field and a positive `nanos` field. Must be from 0
8598 # to 999,999,999 inclusive.
8599 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8600 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8601 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8602 },
8603 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
8604 # which a delay is introduced as part of fault injection.
8605 #
8606 # The value must be from 0.0 to 100.0 inclusive.
8607 },
8608 },
8609 &quot;imageOptimizationPolicy&quot;: { # The configuration for Cloud CDN&#x27;s image optimization feature. This feature # Image optimization policy for this URL Map&#x27;s route. Available only for
8610 # Global EXTERNAL_MANAGED load balancer schemes.
8611 # Either Cloud CDN must be enabled on the backend service or backend bucket
8612 # serving the route, or cache policy must be configured on the same route
8613 # dynamically processes and delivers images from the network edge.
8614 # Image Optimization is only available for Global External Application Load
8615 # Balancers.
8616 # Either Cloud CDN must be enabled on the backend service or backend bucket
8617 # serving the route, or cache policy must be configured on the same route.
8618 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
8619 },
8620 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
8621 # Unlike the timeout field where the timeout duration starts
8622 # from the time the request has been fully processed (known as*end-of-stream*),
8623 # the duration in this field is computed from the beginning of the stream
8624 # until the response has been processed, including all retries. A
8625 # stream that does not complete in this duration is closed.
8626 #
8627 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
8628 # with the route.
8629 #
8630 # This field is only allowed if the Url map is used with backend services
8631 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
8632 # as a count of seconds and fractions of seconds at nanosecond
8633 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8634 # or &quot;month&quot;. Range is approximately 10,000 years.
8635 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8636 # Durations less than one second are represented with a 0
8637 # `seconds` field and a positive `nanos` field. Must be from 0
8638 # to 999,999,999 inclusive.
8639 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8640 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8641 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8642 },
8643 &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
8644 # are shadowed to a separate mirrored backend service. The load balancer does
8645 # not wait for responses from the shadow service. Before sending traffic
8646 # to the shadow service, the host / authority header is suffixed with-shadow.
8647 #
8648 # Not supported when the URL map is bound to a target gRPC proxy that
8649 # has the validateForProxyless field set to true.
8650 # are shadowed to a separate mirrored backend service. The load balancer
8651 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
8652 # to the shadow service, the host or authority header is suffixed with-shadow.
8653 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
8654 # mirrored to.
8655 #
8656 # The backend service configured for a mirroring
8657 # policy must reference backends that are of the same type as the original
8658 # backend service matched in the URL map.
8659 #
8660 # Serverless NEG backends are not currently supported as a mirrored
8661 # backend service.
8662 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
8663 },
8664 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
8665 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
8666 # If not specified, defaults to 1.
8667 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
8668 #
8669 # If not specified, will use the timeout set in theHttpRouteAction field.
8670 # If timeout in the HttpRouteAction field is not set, this field
8671 # uses the largest timeout
8672 # among all backend services associated with the route.
8673 #
8674 # Not supported when the URL map is bound to a target gRPC proxy that
8675 # has the validateForProxyless field set to true.
8676 # as a count of seconds and fractions of seconds at nanosecond
8677 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8678 # or &quot;month&quot;. Range is approximately 10,000 years.
8679 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8680 # Durations less than one second are represented with a 0
8681 # `seconds` field and a positive `nanos` field. Must be from 0
8682 # to 999,999,999 inclusive.
8683 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8684 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8685 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8686 },
8687 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
8688 # values are:
8689 #
8690 # - 5xx: retry is attempted if the instance or endpoint
8691 # responds with any 5xx response code, or if the instance or
8692 # endpoint does not respond at all. For example, disconnects, reset, read
8693 # timeout, connection failure, and refused streams.
8694 # - gateway-error: Similar to 5xx, but only
8695 # applies to response codes 502, 503 or504.
8696 # - connect-failure: a retry is attempted on failures
8697 # connecting to the instance or endpoint. For example, connection
8698 # timeouts.
8699 # - retriable-4xx: a retry is attempted if the instance
8700 # or endpoint responds with a 4xx response code.
8701 # The only error that you can retry is error code 409.
8702 # - refused-stream: a retry is attempted if the instance
8703 # or endpoint resets the stream with a REFUSED_STREAM error
8704 # code. This reset type indicates that it is safe to retry.
8705 # - cancelled: a retry is attempted if the gRPC status
8706 # code in the response header is set to cancelled.
8707 # - deadline-exceeded: a retry is attempted if the gRPC
8708 # status code in the response header is set todeadline-exceeded.
8709 # - internal: a retry is attempted if the gRPC
8710 # status code in the response header is set tointernal.
8711 # - resource-exhausted: a retry is attempted if the gRPC
8712 # status code in the response header is set toresource-exhausted.
8713 # - unavailable: a retry is attempted if the gRPC
8714 # status code in the response header is set tounavailable.
8715 #
8716 # Only the following codes are supported when the URL map is bound to
8717 # target gRPC proxy that has validateForProxyless field set to true.
8718 #
8719 # - cancelled
8720 # - deadline-exceeded
8721 # - internal
8722 # - resource-exhausted
8723 # - unavailable
8724 &quot;A String&quot;,
8725 ],
8726 },
8727 &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
8728 # time the request has been fully processed (known as *end-of-stream*)
8729 # up until the response has been processed. Timeout includes
8730 # all retries.
8731 #
8732 # If not specified, this field uses the largest timeout among all backend
8733 # services associated with the route.
8734 #
8735 # Not supported when the URL map is bound to a target gRPC proxy that
8736 # has validateForProxyless field set to true.
8737 # as a count of seconds and fractions of seconds at nanosecond
8738 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8739 # or &quot;month&quot;. Range is approximately 10,000 years.
8740 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8741 # Durations less than one second are represented with a 0
8742 # `seconds` field and a positive `nanos` field. Must be from 0
8743 # to 999,999,999 inclusive.
8744 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8745 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8746 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8747 },
8748 &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
8749 # to the matched service.
8750 #
8751 # urlRewrite is the only action supported in UrlMaps
8752 # for classic Application Load Balancers.
8753 #
8754 # Not supported when the URL map is bound to a target gRPC proxy that
8755 # has the validateForProxyless field set to true.
8756 # backend service.
8757 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
8758 # host header is replaced with contents of hostRewrite.
8759 #
8760 # The value must be from 1 to 255 characters.
8761 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
8762 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
8763 #
8764 # The value must be from 1 to 1024 characters.
8765 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
8766 # header) using the HTTP template syntax.
8767 #
8768 # A corresponding
8769 # path_template_match must be specified. Any template variables must exist in
8770 # the path_template_match field.
8771 #
8772 #
8773 # - -At least one variable must be specified in the path_template_match
8774 # field
8775 # - You can omit variables from the rewritten URL
8776 # - The * and ** operators cannot be matched
8777 # unless they have a corresponding variable name - e.g.
8778 # {format=*} or {var=**}.
8779 #
8780 # For example, a path_template_match of /static/{format=**}
8781 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
8782 # rewrite, so that /{country}/{format}/{suffix=**} can be
8783 # rewritten as /content/{format}/{country}/{suffix}.
8784 #
8785 # At least
8786 # one non-empty routeRules[].matchRules[].path_template_match is
8787 # required.
8788 #
8789 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
8790 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
8791 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
8792 # It uses RE2 syntax with the following constraints:
8793 #
8794 #
8795 # - Any single character operators
8796 # - Groups are allowed to have only submatch operator inside
8797 # - Groups are allowed only without any char repetition, e.g.
8798 # .*
8799 # - Any char repetition, e.g. .*, is
8800 # only allowed to be used in a single regex together with:
8801 #
8802 #
8803 # - Empty string operators
8804 # - Other repetitions
8805 # - Ranges
8806 # - Repetitions of ranges
8807 #
8808 #
8809 # - Ranges are only allowed to have:
8810 #
8811 #
8812 # - Character range
8813 # - Digits range
8814 # - Symbols listed in characters allowed for ranges
8815 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
8816 # the path.
8817 },
8818 },
8819 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
8820 # occurs. The weights determine the fraction of traffic that flows to
8821 # their corresponding backend service. If all traffic needs to
8822 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
8823 #
8824 # After a backend service is identified and before forwarding
8825 # the request to
8826 # the backend service, advanced routing actions such as URL rewrites and
8827 # header transformations are applied depending on additional settings
8828 # specified in this HttpRouteAction.
8829 { # In contrast to a single BackendService in
8830 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
8831 # multiple backend services. The volume of traffic for each
8832 # backend service is proportional to the weight specified
8833 # in each WeightedBackendService
8834 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
8835 # resource. Before
8836 # forwarding the request to backendService, the load balancer
8837 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
8838 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
8839 # effect for the selected backendService.
8840 #
8841 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
8842 #
8843 # headerAction is not supported for load balancers that have
8844 # their loadBalancingScheme set to EXTERNAL.
8845 #
8846 # Not supported when the URL map is bound to a target gRPC proxy that
8847 # has validateForProxyless field set to true.
8848 # the request is passed along to the selected backendService.
8849 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
8850 { # Specification determining how headers are added to requests or responses.
8851 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
8852 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
8853 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
8854 # that already
8855 # exist for the header. If true, headerValue is set for the
8856 # header, discarding any values that were set for that header.
8857 #
8858 # The default value is true,
8859 # unless a variable is present in headerValue,
8860 # in which case the default value is false.
8861 # .
8862 },
8863 ],
8864 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
8865 # request before forwarding the request to the backendService.
8866 &quot;A String&quot;,
8867 ],
8868 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
8869 # client.
8870 { # Specification determining how headers are added to requests or responses.
8871 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
8872 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
8873 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
8874 # that already
8875 # exist for the header. If true, headerValue is set for the
8876 # header, discarding any values that were set for that header.
8877 #
8878 # The default value is true,
8879 # unless a variable is present in headerValue,
8880 # in which case the default value is false.
8881 # .
8882 },
8883 ],
8884 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
8885 # response before sending the response back to the client.
8886 &quot;A String&quot;,
8887 ],
8888 },
8889 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
8890 # computed asweight / (sum of all weightedBackendService weights in routeAction).
8891 #
8892 # The selection of a backend service is determined only for new traffic.
8893 # Once a user&#x27;s request has been directed to a backend service,
8894 # subsequent requests are sent to the same backend service as
8895 # determined by the backend service&#x27;s session affinity policy.
8896 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
8897 # splitting. If you do, the weighted traffic splitting configuration takes
8898 # precedence.
8899 #
8900 # The value must be from 0 to 1000.
8901 },
8902 ],
8903 },
8904 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL of the defaultService resource to
8905 # which traffic is directed if none of the hostRules match.
8906 # If defaultRouteAction is also specified, advanced
8907 # routing actions, such as URL rewrites, take effect before sending the
8908 # request to the backend.
8909 #
8910 #
8911 # Only one of defaultUrlRedirect, defaultService
8912 # or defaultRouteAction.weightedBackendService can be set.
8913 #
8914 #
8915 # defaultService has no effect when the URL map is bound
8916 # to a target gRPC proxy that has the validateForProxyless field
8917 # set to true.
8918 &quot;defaultUrlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
8919 # is redirected to a URL specified by defaultUrlRedirect.
8920 #
8921 #
8922 # Only one of defaultUrlRedirect, defaultService
8923 # or defaultRouteAction.weightedBackendService can be set.
8924 #
8925 #
8926 # Not supported when the URL map is bound to a target gRPC proxy.
8927 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
8928 # was supplied in the request.
8929 #
8930 # The value must be from 1 to 255
8931 # characters.
8932 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
8933 # set to HTTPS.
8934 # If set to false, the URL scheme of the redirected request
8935 # remains the same as that of the request.
8936 #
8937 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
8938 #
8939 # The default is set to false.
8940 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
8941 # that was supplied in the request.
8942 #
8943 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
8944 # supplied, the path of the original request is used for the redirect.
8945 #
8946 # The value must be from 1 to 1024 characters.
8947 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
8948 # the HttpRouteRuleMatch, retaining the remaining portion
8949 # of the URL before redirecting the request.
8950 #
8951 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
8952 # supplied, the path of the original request is used for the redirect.
8953 #
8954 # The value must be from 1 to 1024 characters.
8955 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
8956 #
8957 # Supported values are:
8958 #
8959 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
8960 # to 301.
8961 # - FOUND, which corresponds to 302.
8962 # - SEE_OTHER which corresponds to 303.
8963 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
8964 # method is retained.
8965 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
8966 # method is retained.
8967 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
8968 # URL is
8969 # removed before redirecting the request. If set to false, the
8970 # query portion of the original URL is retained.
8971 #
8972 # The default is set to false.
8973 },
8974 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
8975 # create the resource.
8976 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. A hash of the contents stored in this object.
8977 # This field is used in optimistic locking. This field is ignored when
8978 # inserting a UrlMap. An up-to-date fingerprint must be provided
8979 # in order to update the UrlMap, otherwise the request will
8980 # fail with error 412 conditionNotMet.
8981 #
8982 # To see the latest fingerprint, make a get() request to
8983 # retrieve a UrlMap.
8984 &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
8985 # for the selected backendService.
8986 #
8987 # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
8988 #
8989 # headerAction is not supported for load balancers
8990 # that have
8991 # their loadBalancingScheme set to EXTERNAL.
8992 #
8993 # Not supported when the URL map is bound to a target gRPC proxy that
8994 # has validateForProxyless field set to true.
8995 # the request is passed along to the selected backendService.
8996 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
8997 { # Specification determining how headers are added to requests or responses.
8998 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
8999 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
9000 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
9001 # that already
9002 # exist for the header. If true, headerValue is set for the
9003 # header, discarding any values that were set for that header.
9004 #
9005 # The default value is true,
9006 # unless a variable is present in headerValue,
9007 # in which case the default value is false.
9008 # .
9009 },
9010 ],
9011 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
9012 # request before forwarding the request to the backendService.
9013 &quot;A String&quot;,
9014 ],
9015 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
9016 # client.
9017 { # Specification determining how headers are added to requests or responses.
9018 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
9019 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
9020 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
9021 # that already
9022 # exist for the header. If true, headerValue is set for the
9023 # header, discarding any values that were set for that header.
9024 #
9025 # The default value is true,
9026 # unless a variable is present in headerValue,
9027 # in which case the default value is false.
9028 # .
9029 },
9030 ],
9031 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
9032 # response before sending the response back to the client.
9033 &quot;A String&quot;,
9034 ],
9035 },
9036 &quot;hostRules&quot;: [ # The list of host rules to use against the URL.
9037 { # UrlMaps
9038 # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
9039 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
9040 # create the resource.
9041 &quot;hosts&quot;: [ # The list of host patterns to match. They must be valid hostnames with
9042 # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
9043 # that case, * must be the first character, and if followed by
9044 # anything, the immediate following character must be either -
9045 # or ..
9046 #
9047 # * based matching is not supported when the URL map is bound
9048 # to a target gRPC proxy that has the validateForProxyless field
9049 # set to true.
9050 &quot;A String&quot;,
9051 ],
9052 &quot;pathMatcher&quot;: &quot;A String&quot;, # The name of the PathMatcher to use to match the path portion
9053 # of the URL if the hostRule matches the URL&#x27;s host portion.
9054 },
9055 ],
9056 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the resource. This identifier is
9057 # defined by the server.
9058 &quot;kind&quot;: &quot;compute#urlMap&quot;, # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
9059 # url maps.
9060 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
9061 # The name must be 1-63 characters long, and comply withRFC1035.
9062 # Specifically, the name must be 1-63 characters long and match the regular
9063 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
9064 # character must be a lowercase letter, and all following characters must
9065 # be a dash, lowercase letter, or digit, except the last character, which
9066 # cannot be a dash.
9067 &quot;pathMatchers&quot;: [ # The list of named PathMatchers to use against the URL.
9068 { # A matcher for the path portion of the URL. The BackendService
9069 # from the longest-matched rule will serve the URL. If no rule was matched, the
9070 # default service is used.
9071 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
9072 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
9073 #
9074 # This policy takes
9075 # effect at the PathMatcher level and applies only when no
9076 # 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
9077 # in defaultCustomErrorResponsePolicy, then a policy defined for
9078 # the error code in UrlMap.defaultCustomErrorResponsePolicy
9079 # takes effect.
9080 #
9081 # For example, consider a UrlMap with the following
9082 # configuration:
9083 #
9084 #
9085 # - UrlMap.defaultCustomErrorResponsePolicy is configured
9086 # with policies for 5xx and 4xx errors
9087 # - A RouteRule for /coming_soon/ is configured for the
9088 # error code 404.
9089 #
9090 # 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
9091 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
9092 # the policy in RouteRule.customErrorResponsePolicy takes
9093 # effect. If any of the requests in this example encounter a 500
9094 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
9095 #
9096 # When
9097 # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
9098 # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
9099 # a retry, if load balancer is successful in reaching the
9100 # service, the defaultCustomErrorResponsePolicy is ignored and
9101 # the response from the service is returned to the client.
9102 #
9103 # defaultCustomErrorResponsePolicy is supported only for
9104 # global external Application Load Balancers.
9105 # backend service or backend bucket responds with an error.
9106 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
9107 #
9108 # In a given policy, if you specify rules for both a range of error codes
9109 # as well as rules for specific error codes then rules with specific error
9110 # codes have a higher priority. For example, assume that you configure a rule
9111 # for 401 (Un-authorized) code, and another for all 4 series
9112 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
9113 # However if the backend service returns a 403, the rule for4xx takes effect.
9114 { # Specifies the mapping between the response code that will be returned along
9115 # with the custom error content and the response code returned by the backend
9116 # service.
9117 &quot;matchResponseCodes&quot;: [ # Valid values include:
9118 #
9119 #
9120 # - A number between 400 and 599: For example
9121 # 401 or 503, in which case the load balancer
9122 # applies the policy if the error code exactly matches this value.
9123 # - 5xx: Load Balancer will apply the policy if the
9124 # backend service responds with any response code in the range of
9125 # 500 to 599.
9126 # - 4xx: Load
9127 # Balancer will apply the policy if the backend service responds with any
9128 # response code in the range of 400 to
9129 # 499.
9130 #
9131 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
9132 &quot;A String&quot;,
9133 ],
9134 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
9135 # error content. If overrideResponseCode is not supplied, the
9136 # same response code returned by the original backend bucket or backend
9137 # service is returned to the client.
9138 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
9139 #
9140 # path must start
9141 # with a leading slash. path cannot have trailing slashes.
9142 #
9143 # If the file is not available in backendBucket or the
9144 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
9145 #
9146 # The value must
9147 # be from 1 to 1024 characters
9148 },
9149 ],
9150 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
9151 # contains the custom error content. Examples are:
9152 #
9153 #
9154 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
9155 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
9156 # - global/backendBuckets/myBackendBucket
9157 #
9158 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
9159 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
9160 #
9161 # If load balancer cannot reach
9162 # the backendBucket, a simple Not Found Error will
9163 # be returned, with the original response code (oroverrideResponseCode if configured).
9164 #
9165 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
9166 },
9167 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
9168 # pathRules or routeRules match. The load balancer
9169 # performs advanced routing actions, such as URL rewrites and
9170 # header transformations, before forwarding the request to the
9171 # selected backend.
9172 #
9173 #
9174 # Only one of defaultUrlRedirect, defaultService
9175 # or defaultRouteAction.weightedBackendService can be set.
9176 #
9177 #
9178 # URL maps for classic Application Load Balancers only support
9179 # the urlRewrite action within a path matcher&#x27;sdefaultRouteAction.
9180 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
9181 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
9182 # property must be specified. This policy cannot be specified if any target
9183 # backend has Identity-Aware Proxy enabled.
9184 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
9185 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
9186 # header names can be specified. The cache is bypassed for all `cacheMode`
9187 # values.
9188 &quot;A String&quot;,
9189 ],
9190 &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
9191 # on the backend type: for Backend Services, the complete request URI is
9192 # used; for Backend Buckets, the request URI is used without the protocol or
9193 # host, and only query parameters known to Cloud Storage are included.
9194 # Policy defined on Route Action.
9195 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
9196 # parameters will be included. Either specify `excludedQueryParameters`
9197 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
9198 # encoded and not treated as delimiters.
9199 #
9200 # Note: This field applies to routes that use backend services. Attempting
9201 # to set it on a route that points exclusively to Backend Buckets will
9202 # result in a configuration error. For routes that point to a Backend
9203 # Bucket, use `includedQueryParameters` to define which parameters should
9204 # be part of the cache key.
9205 &quot;A String&quot;,
9206 ],
9207 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
9208 #
9209 # Note: This setting is only applicable to routes that use a Backend
9210 # Service. It does not affect requests served by a Backend Bucket, as the
9211 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
9212 # it on a route that points exclusively to Backend Buckets will result in a
9213 # configuration error.
9214 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
9215 #
9216 # Note: This setting is only applicable to routes that use a Backend
9217 # Service. It does not affect requests served by a Backend Bucket, as the
9218 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
9219 # set on a route that points exclusively to Backend Buckets will result in
9220 # a configuration error.
9221 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
9222 # `includedQueryParameters` and `excludedQueryParameters`. If neither
9223 # is set, the entire query string will be included. If false, the query
9224 # string will be excluded from the cache key entirely.
9225 #
9226 # Note: This field applies to routes that use backend services. Attempting
9227 # to set it on a route that points exclusively to Backend Buckets will
9228 # result in a configuration error. For routes that point to a Backend
9229 # Bucket, use `includedQueryParameters` to define which parameters should
9230 # be part of the cache key.
9231 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
9232 # The name=value pair will be used in the cache key Cloud CDN generates.
9233 #
9234 # Note: This setting is only applicable to routes that use a Backend
9235 # Service. It does not affect requests served by a Backend Bucket.
9236 # Attempting to set it on a route that points exclusively to Backend
9237 # Buckets will result in a configuration error. Up to 5 cookie names can be
9238 # specified.
9239 &quot;A String&quot;,
9240 ],
9241 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
9242 &quot;A String&quot;,
9243 ],
9244 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
9245 # parameters will be excluded. Either specify `includedQueryParameters`
9246 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
9247 # encoded and not treated as delimiters.
9248 &quot;A String&quot;,
9249 ],
9250 },
9251 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
9252 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
9253 &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
9254 # content. This is used to clamp the max-age (or Expires) value sent to the
9255 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
9256 # is used for the response max-age directive, along with a &quot;public&quot;
9257 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
9258 # clamps the max-age from the origin (if specified), or else sets the
9259 # response max-age directive to the lesser of the `clientTtl` and
9260 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
9261 # present. The maximum allowed value is 31,622,400s (1 year). If not
9262 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
9263 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
9264 # `USE_ORIGIN_HEADERS`.
9265 # as a count of seconds and fractions of seconds at nanosecond
9266 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9267 # or &quot;month&quot;. Range is approximately 10,000 years.
9268 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9269 # Durations less than one second are represented with a 0
9270 # `seconds` field and a positive `nanos` field. Must be from 0
9271 # to 999,999,999 inclusive.
9272 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9273 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9274 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9275 },
9276 &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
9277 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
9278 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
9279 # greater than that of `maxTtl`. When the `cacheMode` is set to
9280 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
9281 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
9282 # accessed objects may be evicted from the cache before the defined TTL. If
9283 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
9284 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
9285 # `USE_ORIGIN_HEADERS`.
9286 # as a count of seconds and fractions of seconds at nanosecond
9287 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9288 # or &quot;month&quot;. Range is approximately 10,000 years.
9289 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9290 # Durations less than one second are represented with a 0
9291 # `seconds` field and a positive `nanos` field. Must be from 0
9292 # to 999,999,999 inclusive.
9293 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9294 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9295 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9296 },
9297 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
9298 # attempt to set a max-age or s-maxage higher than this, or an Expires header
9299 # more than `maxTtl` seconds in the future will be capped at the value of
9300 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
9301 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
9302 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
9303 # Infrequently accessed objects may be evicted from the cache before the
9304 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
9305 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
9306 # mode.
9307 # as a count of seconds and fractions of seconds at nanosecond
9308 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9309 # or &quot;month&quot;. Range is approximately 10,000 years.
9310 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9311 # Durations less than one second are represented with a 0
9312 # `seconds` field and a positive `nanos` field. Must be from 0
9313 # to 999,999,999 inclusive.
9314 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9315 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9316 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9317 },
9318 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
9319 # to apply fine-grained caching for common errors or redirects.
9320 # This can reduce the load on your origin and improve end-user
9321 # experience by reducing response latency.
9322 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
9323 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
9324 # the specified response code that lack any Cache-Control, Expires, or
9325 # Pragma: no-cache directives. When the `cacheMode` is set to
9326 # `FORCE_CACHE_ALL`, negative caching applies to all responses
9327 # with the specified response code, and overrides any caching headers. By
9328 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
9329 #
9330 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
9331 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
9332 # * 405 (Method Not Found), 501 (Not Implemented): 60s
9333 #
9334 # These defaults can be overridden in `negativeCachingPolicy`.
9335 # If not specified, Cloud CDN applies negative caching by default.
9336 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
9337 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
9338 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
9339 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
9340 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
9341 # all response codes that you wish to cache. Cloud CDN will not apply any
9342 # default negative caching when a policy exists.
9343 { # Specify CDN TTLs for response error codes.
9344 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
9345 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
9346 # specified as values, and you cannot specify a status code more than
9347 # once.
9348 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
9349 # corresponding status code.
9350 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
9351 # objects may be evicted from the cache before the defined TTL.
9352 # as a count of seconds and fractions of seconds at nanosecond
9353 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9354 # or &quot;month&quot;. Range is approximately 10,000 years.
9355 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9356 # Durations less than one second are represented with a 0
9357 # `seconds` field and a positive `nanos` field. Must be from 0
9358 # to 999,999,999 inclusive.
9359 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9360 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9361 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9362 },
9363 },
9364 ],
9365 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
9366 # requests into a small number of requests to the origin. If not specified,
9367 # Cloud CDN applies request coalescing by default.
9368 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
9369 # content with the origin, or when an error is encountered when refreshing
9370 # the cache.
9371 # This setting defines the default &quot;max-stale&quot; duration for any cached
9372 # responses that do not specify a max-stale directive. Stale responses that
9373 # exceed the TTL configured here will not be served. The default limit
9374 # (max-stale) is 86400s (1 day), which will allow stale content to be
9375 # served up to this limit beyond the max-age (or s-maxage) of a cached
9376 # response.
9377 # The maximum allowed value is 604800 (1 week).
9378 # Set this to zero (0) to disable serve-while-stale.
9379 # as a count of seconds and fractions of seconds at nanosecond
9380 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9381 # or &quot;month&quot;. Range is approximately 10,000 years.
9382 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9383 # Durations less than one second are represented with a 0
9384 # `seconds` field and a positive `nanos` field. Must be from 0
9385 # to 999,999,999 inclusive.
9386 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9387 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9388 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9389 },
9390 },
9391 &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
9392 # information about the W3C recommendation for cross-origin resource sharing
9393 # (CORS), see Fetch API Living
9394 # Standard.
9395 #
9396 # Not supported when the URL map is bound to a target gRPC proxy.
9397 # information about the W3C recommendation for cross-origin resource sharing
9398 # (CORS), see Fetch API Living
9399 # Standard.
9400 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
9401 # indicates that
9402 # the actual request can include user credentials. This field translates to
9403 # the Access-Control-Allow-Credentials header.
9404 #
9405 # Default is false.
9406 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
9407 # header.
9408 &quot;A String&quot;,
9409 ],
9410 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
9411 # header.
9412 &quot;A String&quot;,
9413 ],
9414 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
9415 # more information, see regular expression syntax.
9416 #
9417 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
9418 #
9419 # Regular expressions can only be used when the loadBalancingScheme is
9420 # set to INTERNAL_SELF_MANAGED.
9421 &quot;A String&quot;,
9422 ],
9423 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
9424 #
9425 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
9426 &quot;A String&quot;,
9427 ],
9428 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
9429 # The default value is false, which indicates that the CORS
9430 # policy is in effect.
9431 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
9432 # header.
9433 &quot;A String&quot;,
9434 ],
9435 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
9436 # seconds. This field translates to the Access-Control-Max-Age
9437 # header.
9438 },
9439 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
9440 # the resiliency of clients to backend service failure. As part of fault
9441 # injection, when clients send requests to a backend service, delays can be
9442 # introduced by a load balancer on a percentage of requests before sending
9443 # those requests to the backend service. Similarly requests from clients can
9444 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
9445 # that are configured with a fault_injection_policy if:
9446 # 1. The traffic is generated by fault injection AND
9447 # 2. The fault injection is not a delay fault injection.
9448 # Fault injection is not supported with the classic Application Load Balancer
9449 # . To see which load balancers support fault injection,
9450 # see Load
9451 # balancing: Routing and traffic management features.
9452 # the resiliency of clients to backend service failure. As part of fault
9453 # injection, when clients send requests to a backend service, delays can be
9454 # introduced by the load balancer on a percentage of requests before sending
9455 # those request to the backend service. Similarly requests from clients can be
9456 # aborted by the load balancer for a percentage of requests.
9457 &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
9458 # injection.
9459 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
9460 #
9461 # The value must be from 200 to 599 inclusive.
9462 #
9463 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
9464 # according to this
9465 # mapping table. HTTP status 200 is mapped to gRPC status
9466 # UNKNOWN. Injecting an OK status is currently not supported by
9467 # Traffic Director.
9468 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
9469 # that is aborted as part of fault injection.
9470 #
9471 # The value must be from 0.0 to 100.0 inclusive.
9472 },
9473 &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
9474 # injection, before being sent to a backend service.
9475 # request to the backend service as part of fault injection.
9476 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
9477 # as a count of seconds and fractions of seconds at nanosecond
9478 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9479 # or &quot;month&quot;. Range is approximately 10,000 years.
9480 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9481 # Durations less than one second are represented with a 0
9482 # `seconds` field and a positive `nanos` field. Must be from 0
9483 # to 999,999,999 inclusive.
9484 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9485 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9486 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9487 },
9488 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
9489 # which a delay is introduced as part of fault injection.
9490 #
9491 # The value must be from 0.0 to 100.0 inclusive.
9492 },
9493 },
9494 &quot;imageOptimizationPolicy&quot;: { # The configuration for Cloud CDN&#x27;s image optimization feature. This feature # Image optimization policy for this URL Map&#x27;s route. Available only for
9495 # Global EXTERNAL_MANAGED load balancer schemes.
9496 # Either Cloud CDN must be enabled on the backend service or backend bucket
9497 # serving the route, or cache policy must be configured on the same route
9498 # dynamically processes and delivers images from the network edge.
9499 # Image Optimization is only available for Global External Application Load
9500 # Balancers.
9501 # Either Cloud CDN must be enabled on the backend service or backend bucket
9502 # serving the route, or cache policy must be configured on the same route.
9503 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
9504 },
9505 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
9506 # Unlike the timeout field where the timeout duration starts
9507 # from the time the request has been fully processed (known as*end-of-stream*),
9508 # the duration in this field is computed from the beginning of the stream
9509 # until the response has been processed, including all retries. A
9510 # stream that does not complete in this duration is closed.
9511 #
9512 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
9513 # with the route.
9514 #
9515 # This field is only allowed if the Url map is used with backend services
9516 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
9517 # as a count of seconds and fractions of seconds at nanosecond
9518 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9519 # or &quot;month&quot;. Range is approximately 10,000 years.
9520 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9521 # Durations less than one second are represented with a 0
9522 # `seconds` field and a positive `nanos` field. Must be from 0
9523 # to 999,999,999 inclusive.
9524 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9525 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9526 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9527 },
9528 &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
9529 # are shadowed to a separate mirrored backend service. The load balancer does
9530 # not wait for responses from the shadow service. Before sending traffic
9531 # to the shadow service, the host / authority header is suffixed with-shadow.
9532 #
9533 # Not supported when the URL map is bound to a target gRPC proxy that
9534 # has the validateForProxyless field set to true.
9535 # are shadowed to a separate mirrored backend service. The load balancer
9536 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
9537 # to the shadow service, the host or authority header is suffixed with-shadow.
9538 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
9539 # mirrored to.
9540 #
9541 # The backend service configured for a mirroring
9542 # policy must reference backends that are of the same type as the original
9543 # backend service matched in the URL map.
9544 #
9545 # Serverless NEG backends are not currently supported as a mirrored
9546 # backend service.
9547 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
9548 },
9549 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
9550 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
9551 # If not specified, defaults to 1.
9552 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
9553 #
9554 # If not specified, will use the timeout set in theHttpRouteAction field.
9555 # If timeout in the HttpRouteAction field is not set, this field
9556 # uses the largest timeout
9557 # among all backend services associated with the route.
9558 #
9559 # Not supported when the URL map is bound to a target gRPC proxy that
9560 # has the validateForProxyless field set to true.
9561 # as a count of seconds and fractions of seconds at nanosecond
9562 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9563 # or &quot;month&quot;. Range is approximately 10,000 years.
9564 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9565 # Durations less than one second are represented with a 0
9566 # `seconds` field and a positive `nanos` field. Must be from 0
9567 # to 999,999,999 inclusive.
9568 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9569 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9570 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9571 },
9572 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
9573 # values are:
9574 #
9575 # - 5xx: retry is attempted if the instance or endpoint
9576 # responds with any 5xx response code, or if the instance or
9577 # endpoint does not respond at all. For example, disconnects, reset, read
9578 # timeout, connection failure, and refused streams.
9579 # - gateway-error: Similar to 5xx, but only
9580 # applies to response codes 502, 503 or504.
9581 # - connect-failure: a retry is attempted on failures
9582 # connecting to the instance or endpoint. For example, connection
9583 # timeouts.
9584 # - retriable-4xx: a retry is attempted if the instance
9585 # or endpoint responds with a 4xx response code.
9586 # The only error that you can retry is error code 409.
9587 # - refused-stream: a retry is attempted if the instance
9588 # or endpoint resets the stream with a REFUSED_STREAM error
9589 # code. This reset type indicates that it is safe to retry.
9590 # - cancelled: a retry is attempted if the gRPC status
9591 # code in the response header is set to cancelled.
9592 # - deadline-exceeded: a retry is attempted if the gRPC
9593 # status code in the response header is set todeadline-exceeded.
9594 # - internal: a retry is attempted if the gRPC
9595 # status code in the response header is set tointernal.
9596 # - resource-exhausted: a retry is attempted if the gRPC
9597 # status code in the response header is set toresource-exhausted.
9598 # - unavailable: a retry is attempted if the gRPC
9599 # status code in the response header is set tounavailable.
9600 #
9601 # Only the following codes are supported when the URL map is bound to
9602 # target gRPC proxy that has validateForProxyless field set to true.
9603 #
9604 # - cancelled
9605 # - deadline-exceeded
9606 # - internal
9607 # - resource-exhausted
9608 # - unavailable
9609 &quot;A String&quot;,
9610 ],
9611 },
9612 &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
9613 # time the request has been fully processed (known as *end-of-stream*)
9614 # up until the response has been processed. Timeout includes
9615 # all retries.
9616 #
9617 # If not specified, this field uses the largest timeout among all backend
9618 # services associated with the route.
9619 #
9620 # Not supported when the URL map is bound to a target gRPC proxy that
9621 # has validateForProxyless field set to true.
9622 # as a count of seconds and fractions of seconds at nanosecond
9623 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9624 # or &quot;month&quot;. Range is approximately 10,000 years.
9625 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9626 # Durations less than one second are represented with a 0
9627 # `seconds` field and a positive `nanos` field. Must be from 0
9628 # to 999,999,999 inclusive.
9629 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9630 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9631 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9632 },
9633 &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
9634 # to the matched service.
9635 #
9636 # urlRewrite is the only action supported in UrlMaps
9637 # for classic Application Load Balancers.
9638 #
9639 # Not supported when the URL map is bound to a target gRPC proxy that
9640 # has the validateForProxyless field set to true.
9641 # backend service.
9642 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
9643 # host header is replaced with contents of hostRewrite.
9644 #
9645 # The value must be from 1 to 255 characters.
9646 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
9647 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
9648 #
9649 # The value must be from 1 to 1024 characters.
9650 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
9651 # header) using the HTTP template syntax.
9652 #
9653 # A corresponding
9654 # path_template_match must be specified. Any template variables must exist in
9655 # the path_template_match field.
9656 #
9657 #
9658 # - -At least one variable must be specified in the path_template_match
9659 # field
9660 # - You can omit variables from the rewritten URL
9661 # - The * and ** operators cannot be matched
9662 # unless they have a corresponding variable name - e.g.
9663 # {format=*} or {var=**}.
9664 #
9665 # For example, a path_template_match of /static/{format=**}
9666 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
9667 # rewrite, so that /{country}/{format}/{suffix=**} can be
9668 # rewritten as /content/{format}/{country}/{suffix}.
9669 #
9670 # At least
9671 # one non-empty routeRules[].matchRules[].path_template_match is
9672 # required.
9673 #
9674 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
9675 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
9676 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
9677 # It uses RE2 syntax with the following constraints:
9678 #
9679 #
9680 # - Any single character operators
9681 # - Groups are allowed to have only submatch operator inside
9682 # - Groups are allowed only without any char repetition, e.g.
9683 # .*
9684 # - Any char repetition, e.g. .*, is
9685 # only allowed to be used in a single regex together with:
9686 #
9687 #
9688 # - Empty string operators
9689 # - Other repetitions
9690 # - Ranges
9691 # - Repetitions of ranges
9692 #
9693 #
9694 # - Ranges are only allowed to have:
9695 #
9696 #
9697 # - Character range
9698 # - Digits range
9699 # - Symbols listed in characters allowed for ranges
9700 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
9701 # the path.
9702 },
9703 },
9704 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
9705 # occurs. The weights determine the fraction of traffic that flows to
9706 # their corresponding backend service. If all traffic needs to
9707 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
9708 #
9709 # After a backend service is identified and before forwarding
9710 # the request to
9711 # the backend service, advanced routing actions such as URL rewrites and
9712 # header transformations are applied depending on additional settings
9713 # specified in this HttpRouteAction.
9714 { # In contrast to a single BackendService in
9715 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
9716 # multiple backend services. The volume of traffic for each
9717 # backend service is proportional to the weight specified
9718 # in each WeightedBackendService
9719 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
9720 # resource. Before
9721 # forwarding the request to backendService, the load balancer
9722 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
9723 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
9724 # effect for the selected backendService.
9725 #
9726 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
9727 #
9728 # headerAction is not supported for load balancers that have
9729 # their loadBalancingScheme set to EXTERNAL.
9730 #
9731 # Not supported when the URL map is bound to a target gRPC proxy that
9732 # has validateForProxyless field set to true.
9733 # the request is passed along to the selected backendService.
9734 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
9735 { # Specification determining how headers are added to requests or responses.
9736 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
9737 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
9738 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
9739 # that already
9740 # exist for the header. If true, headerValue is set for the
9741 # header, discarding any values that were set for that header.
9742 #
9743 # The default value is true,
9744 # unless a variable is present in headerValue,
9745 # in which case the default value is false.
9746 # .
9747 },
9748 ],
9749 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
9750 # request before forwarding the request to the backendService.
9751 &quot;A String&quot;,
9752 ],
9753 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
9754 # client.
9755 { # Specification determining how headers are added to requests or responses.
9756 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
9757 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
9758 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
9759 # that already
9760 # exist for the header. If true, headerValue is set for the
9761 # header, discarding any values that were set for that header.
9762 #
9763 # The default value is true,
9764 # unless a variable is present in headerValue,
9765 # in which case the default value is false.
9766 # .
9767 },
9768 ],
9769 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
9770 # response before sending the response back to the client.
9771 &quot;A String&quot;,
9772 ],
9773 },
9774 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
9775 # computed asweight / (sum of all weightedBackendService weights in routeAction).
9776 #
9777 # The selection of a backend service is determined only for new traffic.
9778 # Once a user&#x27;s request has been directed to a backend service,
9779 # subsequent requests are sent to the same backend service as
9780 # determined by the backend service&#x27;s session affinity policy.
9781 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
9782 # splitting. If you do, the weighted traffic splitting configuration takes
9783 # precedence.
9784 #
9785 # The value must be from 0 to 1000.
9786 },
9787 ],
9788 },
9789 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource. This
9790 # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
9791 # matched. For example, the
9792 # following are all valid URLs to a BackendService resource:
9793 #
9794 #
9795 # - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
9796 # - compute/v1/projects/project/global/backendServices/backendService
9797 # - global/backendServices/backendService
9798 #
9799 #
9800 # If defaultRouteAction is also specified, advanced
9801 # routing actions, such as URL rewrites, take effect before sending the
9802 # request to the backend.
9803 #
9804 #
9805 # Only one of defaultUrlRedirect, defaultService
9806 # or defaultRouteAction.weightedBackendService can be set.
9807 #
9808 #
9809 # Authorization requires one or more of the following Google IAM permissions on the
9810 # specified resource default_service:
9811 #
9812 #
9813 # - compute.backendBuckets.use
9814 # - compute.backendServices.use
9815 &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
9816 # by defaultUrlRedirect.
9817 #
9818 #
9819 # Only one of defaultUrlRedirect, defaultService
9820 # or defaultRouteAction.weightedBackendService can be set.
9821 #
9822 #
9823 # Not supported when the URL map is bound to a target gRPC proxy.
9824 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
9825 # was supplied in the request.
9826 #
9827 # The value must be from 1 to 255
9828 # characters.
9829 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
9830 # set to HTTPS.
9831 # If set to false, the URL scheme of the redirected request
9832 # remains the same as that of the request.
9833 #
9834 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
9835 #
9836 # The default is set to false.
9837 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
9838 # that was supplied in the request.
9839 #
9840 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
9841 # supplied, the path of the original request is used for the redirect.
9842 #
9843 # The value must be from 1 to 1024 characters.
9844 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
9845 # the HttpRouteRuleMatch, retaining the remaining portion
9846 # of the URL before redirecting the request.
9847 #
9848 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
9849 # supplied, the path of the original request is used for the redirect.
9850 #
9851 # The value must be from 1 to 1024 characters.
9852 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
9853 #
9854 # Supported values are:
9855 #
9856 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
9857 # to 301.
9858 # - FOUND, which corresponds to 302.
9859 # - SEE_OTHER which corresponds to 303.
9860 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
9861 # method is retained.
9862 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
9863 # method is retained.
9864 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
9865 # URL is
9866 # removed before redirecting the request. If set to false, the
9867 # query portion of the original URL is retained.
9868 #
9869 # The default is set to false.
9870 },
9871 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
9872 # create the resource.
9873 &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
9874 # for the selected backend service.
9875 #
9876 # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
9877 #
9878 # HeaderAction is not supported for load balancers
9879 # that have
9880 # their loadBalancingScheme set to EXTERNAL.
9881 #
9882 # Not supported when the URL map is bound to a target gRPC proxy that
9883 # has validateForProxyless field set to true.
9884 # the request is passed along to the selected backendService.
9885 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
9886 { # Specification determining how headers are added to requests or responses.
9887 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
9888 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
9889 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
9890 # that already
9891 # exist for the header. If true, headerValue is set for the
9892 # header, discarding any values that were set for that header.
9893 #
9894 # The default value is true,
9895 # unless a variable is present in headerValue,
9896 # in which case the default value is false.
9897 # .
9898 },
9899 ],
9900 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
9901 # request before forwarding the request to the backendService.
9902 &quot;A String&quot;,
9903 ],
9904 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
9905 # client.
9906 { # Specification determining how headers are added to requests or responses.
9907 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
9908 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
9909 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
9910 # that already
9911 # exist for the header. If true, headerValue is set for the
9912 # header, discarding any values that were set for that header.
9913 #
9914 # The default value is true,
9915 # unless a variable is present in headerValue,
9916 # in which case the default value is false.
9917 # .
9918 },
9919 ],
9920 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
9921 # response before sending the response back to the client.
9922 &quot;A String&quot;,
9923 ],
9924 },
9925 &quot;name&quot;: &quot;A String&quot;, # The name to which this PathMatcher is referred by theHostRule.
9926 &quot;pathRules&quot;: [ # The list of path rules. Use this list instead of routeRules
9927 # when routing based on simple path matching is all that&#x27;s required. A path
9928 # rule can only include a wildcard character (*) after a
9929 # forward slash character (&quot;/&quot;).
9930 #
9931 # The order by which path rules are specified does not matter.
9932 # Matches are always done on the longest-path-first basis.
9933 #
9934 # For example: a pathRule with a path /a/b/c/* will match
9935 # before /a/b/* irrespective of the order in which those paths appear in this
9936 # list.
9937 #
9938 # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
9939 { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
9940 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
9941 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
9942 #
9943 # If a policy for an
9944 # error code is not configured for the PathRule, a policy for
9945 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
9946 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
9947 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
9948 # effect.
9949 #
9950 # For example, consider a UrlMap with the following configuration:
9951 #
9952 #
9953 # - UrlMap.defaultCustomErrorResponsePolicy are configured
9954 # with policies for 5xx and 4xx errors
9955 # - A PathRule for /coming_soon/ is configured for the error
9956 # code 404.
9957 #
9958 # 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
9959 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
9960 # the policy in PathRule.customErrorResponsePolicy takes
9961 # effect. If any of the requests in this example encounter a 500
9962 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
9963 #
9964 # customErrorResponsePolicy is supported only for
9965 # global external Application Load Balancers.
9966 # backend service or backend bucket responds with an error.
9967 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
9968 #
9969 # In a given policy, if you specify rules for both a range of error codes
9970 # as well as rules for specific error codes then rules with specific error
9971 # codes have a higher priority. For example, assume that you configure a rule
9972 # for 401 (Un-authorized) code, and another for all 4 series
9973 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
9974 # However if the backend service returns a 403, the rule for4xx takes effect.
9975 { # Specifies the mapping between the response code that will be returned along
9976 # with the custom error content and the response code returned by the backend
9977 # service.
9978 &quot;matchResponseCodes&quot;: [ # Valid values include:
9979 #
9980 #
9981 # - A number between 400 and 599: For example
9982 # 401 or 503, in which case the load balancer
9983 # applies the policy if the error code exactly matches this value.
9984 # - 5xx: Load Balancer will apply the policy if the
9985 # backend service responds with any response code in the range of
9986 # 500 to 599.
9987 # - 4xx: Load
9988 # Balancer will apply the policy if the backend service responds with any
9989 # response code in the range of 400 to
9990 # 499.
9991 #
9992 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
9993 &quot;A String&quot;,
9994 ],
9995 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
9996 # error content. If overrideResponseCode is not supplied, the
9997 # same response code returned by the original backend bucket or backend
9998 # service is returned to the client.
9999 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
10000 #
10001 # path must start
10002 # with a leading slash. path cannot have trailing slashes.
10003 #
10004 # If the file is not available in backendBucket or the
10005 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
10006 #
10007 # The value must
10008 # be from 1 to 1024 characters
10009 },
10010 ],
10011 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
10012 # contains the custom error content. Examples are:
10013 #
10014 #
10015 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
10016 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
10017 # - global/backendBuckets/myBackendBucket
10018 #
10019 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
10020 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
10021 #
10022 # If load balancer cannot reach
10023 # the backendBucket, a simple Not Found Error will
10024 # be returned, with the original response code (oroverrideResponseCode if configured).
10025 #
10026 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
10027 },
10028 &quot;paths&quot;: [ # The list of path patterns to match. Each must start with /
10029 # and the only place a * is allowed is at the end following
10030 # a /. The string fed to the path matcher does not include
10031 # any text after the first ? or #, and
10032 # those chars are not allowed here.
10033 &quot;A String&quot;,
10034 ],
10035 &quot;routeAction&quot;: { # In response to a matching path, the load balancer
10036 # performs advanced routing actions, such as URL rewrites and header
10037 # transformations, before forwarding the request to the selected
10038 # backend.
10039 #
10040 #
10041 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
10042 #
10043 #
10044 # URL maps for classic Application Load Balancers only support
10045 # the urlRewrite action within a path rule&#x27;srouteAction.
10046 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
10047 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
10048 # property must be specified. This policy cannot be specified if any target
10049 # backend has Identity-Aware Proxy enabled.
10050 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
10051 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
10052 # header names can be specified. The cache is bypassed for all `cacheMode`
10053 # values.
10054 &quot;A String&quot;,
10055 ],
10056 &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
10057 # on the backend type: for Backend Services, the complete request URI is
10058 # used; for Backend Buckets, the request URI is used without the protocol or
10059 # host, and only query parameters known to Cloud Storage are included.
10060 # Policy defined on Route Action.
10061 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
10062 # parameters will be included. Either specify `excludedQueryParameters`
10063 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
10064 # encoded and not treated as delimiters.
10065 #
10066 # Note: This field applies to routes that use backend services. Attempting
10067 # to set it on a route that points exclusively to Backend Buckets will
10068 # result in a configuration error. For routes that point to a Backend
10069 # Bucket, use `includedQueryParameters` to define which parameters should
10070 # be part of the cache key.
10071 &quot;A String&quot;,
10072 ],
10073 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
10074 #
10075 # Note: This setting is only applicable to routes that use a Backend
10076 # Service. It does not affect requests served by a Backend Bucket, as the
10077 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
10078 # it on a route that points exclusively to Backend Buckets will result in a
10079 # configuration error.
10080 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
10081 #
10082 # Note: This setting is only applicable to routes that use a Backend
10083 # Service. It does not affect requests served by a Backend Bucket, as the
10084 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
10085 # set on a route that points exclusively to Backend Buckets will result in
10086 # a configuration error.
10087 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
10088 # `includedQueryParameters` and `excludedQueryParameters`. If neither
10089 # is set, the entire query string will be included. If false, the query
10090 # string will be excluded from the cache key entirely.
10091 #
10092 # Note: This field applies to routes that use backend services. Attempting
10093 # to set it on a route that points exclusively to Backend Buckets will
10094 # result in a configuration error. For routes that point to a Backend
10095 # Bucket, use `includedQueryParameters` to define which parameters should
10096 # be part of the cache key.
10097 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
10098 # The name=value pair will be used in the cache key Cloud CDN generates.
10099 #
10100 # Note: This setting is only applicable to routes that use a Backend
10101 # Service. It does not affect requests served by a Backend Bucket.
10102 # Attempting to set it on a route that points exclusively to Backend
10103 # Buckets will result in a configuration error. Up to 5 cookie names can be
10104 # specified.
10105 &quot;A String&quot;,
10106 ],
10107 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
10108 &quot;A String&quot;,
10109 ],
10110 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
10111 # parameters will be excluded. Either specify `includedQueryParameters`
10112 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
10113 # encoded and not treated as delimiters.
10114 &quot;A String&quot;,
10115 ],
10116 },
10117 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
10118 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
10119 &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
10120 # content. This is used to clamp the max-age (or Expires) value sent to the
10121 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
10122 # is used for the response max-age directive, along with a &quot;public&quot;
10123 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
10124 # clamps the max-age from the origin (if specified), or else sets the
10125 # response max-age directive to the lesser of the `clientTtl` and
10126 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
10127 # present. The maximum allowed value is 31,622,400s (1 year). If not
10128 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
10129 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
10130 # `USE_ORIGIN_HEADERS`.
10131 # as a count of seconds and fractions of seconds at nanosecond
10132 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10133 # or &quot;month&quot;. Range is approximately 10,000 years.
10134 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10135 # Durations less than one second are represented with a 0
10136 # `seconds` field and a positive `nanos` field. Must be from 0
10137 # to 999,999,999 inclusive.
10138 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10139 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10140 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10141 },
10142 &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
10143 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
10144 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
10145 # greater than that of `maxTtl`. When the `cacheMode` is set to
10146 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
10147 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
10148 # accessed objects may be evicted from the cache before the defined TTL. If
10149 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
10150 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
10151 # `USE_ORIGIN_HEADERS`.
10152 # as a count of seconds and fractions of seconds at nanosecond
10153 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10154 # or &quot;month&quot;. Range is approximately 10,000 years.
10155 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10156 # Durations less than one second are represented with a 0
10157 # `seconds` field and a positive `nanos` field. Must be from 0
10158 # to 999,999,999 inclusive.
10159 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10160 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10161 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10162 },
10163 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
10164 # attempt to set a max-age or s-maxage higher than this, or an Expires header
10165 # more than `maxTtl` seconds in the future will be capped at the value of
10166 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
10167 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
10168 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
10169 # Infrequently accessed objects may be evicted from the cache before the
10170 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
10171 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
10172 # mode.
10173 # as a count of seconds and fractions of seconds at nanosecond
10174 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10175 # or &quot;month&quot;. Range is approximately 10,000 years.
10176 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10177 # Durations less than one second are represented with a 0
10178 # `seconds` field and a positive `nanos` field. Must be from 0
10179 # to 999,999,999 inclusive.
10180 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10181 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10182 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10183 },
10184 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
10185 # to apply fine-grained caching for common errors or redirects.
10186 # This can reduce the load on your origin and improve end-user
10187 # experience by reducing response latency.
10188 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
10189 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
10190 # the specified response code that lack any Cache-Control, Expires, or
10191 # Pragma: no-cache directives. When the `cacheMode` is set to
10192 # `FORCE_CACHE_ALL`, negative caching applies to all responses
10193 # with the specified response code, and overrides any caching headers. By
10194 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
10195 #
10196 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
10197 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
10198 # * 405 (Method Not Found), 501 (Not Implemented): 60s
10199 #
10200 # These defaults can be overridden in `negativeCachingPolicy`.
10201 # If not specified, Cloud CDN applies negative caching by default.
10202 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
10203 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
10204 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
10205 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
10206 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
10207 # all response codes that you wish to cache. Cloud CDN will not apply any
10208 # default negative caching when a policy exists.
10209 { # Specify CDN TTLs for response error codes.
10210 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
10211 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
10212 # specified as values, and you cannot specify a status code more than
10213 # once.
10214 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
10215 # corresponding status code.
10216 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
10217 # objects may be evicted from the cache before the defined TTL.
10218 # as a count of seconds and fractions of seconds at nanosecond
10219 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10220 # or &quot;month&quot;. Range is approximately 10,000 years.
10221 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10222 # Durations less than one second are represented with a 0
10223 # `seconds` field and a positive `nanos` field. Must be from 0
10224 # to 999,999,999 inclusive.
10225 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10226 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10227 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10228 },
10229 },
10230 ],
10231 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
10232 # requests into a small number of requests to the origin. If not specified,
10233 # Cloud CDN applies request coalescing by default.
10234 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
10235 # content with the origin, or when an error is encountered when refreshing
10236 # the cache.
10237 # This setting defines the default &quot;max-stale&quot; duration for any cached
10238 # responses that do not specify a max-stale directive. Stale responses that
10239 # exceed the TTL configured here will not be served. The default limit
10240 # (max-stale) is 86400s (1 day), which will allow stale content to be
10241 # served up to this limit beyond the max-age (or s-maxage) of a cached
10242 # response.
10243 # The maximum allowed value is 604800 (1 week).
10244 # Set this to zero (0) to disable serve-while-stale.
10245 # as a count of seconds and fractions of seconds at nanosecond
10246 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10247 # or &quot;month&quot;. Range is approximately 10,000 years.
10248 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10249 # Durations less than one second are represented with a 0
10250 # `seconds` field and a positive `nanos` field. Must be from 0
10251 # to 999,999,999 inclusive.
10252 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10253 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10254 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10255 },
10256 },
10257 &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
10258 # information about the W3C recommendation for cross-origin resource sharing
10259 # (CORS), see Fetch API Living
10260 # Standard.
10261 #
10262 # Not supported when the URL map is bound to a target gRPC proxy.
10263 # information about the W3C recommendation for cross-origin resource sharing
10264 # (CORS), see Fetch API Living
10265 # Standard.
10266 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
10267 # indicates that
10268 # the actual request can include user credentials. This field translates to
10269 # the Access-Control-Allow-Credentials header.
10270 #
10271 # Default is false.
10272 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
10273 # header.
10274 &quot;A String&quot;,
10275 ],
10276 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
10277 # header.
10278 &quot;A String&quot;,
10279 ],
10280 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
10281 # more information, see regular expression syntax.
10282 #
10283 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
10284 #
10285 # Regular expressions can only be used when the loadBalancingScheme is
10286 # set to INTERNAL_SELF_MANAGED.
10287 &quot;A String&quot;,
10288 ],
10289 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
10290 #
10291 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
10292 &quot;A String&quot;,
10293 ],
10294 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
10295 # The default value is false, which indicates that the CORS
10296 # policy is in effect.
10297 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
10298 # header.
10299 &quot;A String&quot;,
10300 ],
10301 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
10302 # seconds. This field translates to the Access-Control-Max-Age
10303 # header.
10304 },
10305 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
10306 # the resiliency of clients to backend service failure. As part of fault
10307 # injection, when clients send requests to a backend service, delays can be
10308 # introduced by a load balancer on a percentage of requests before sending
10309 # those requests to the backend service. Similarly requests from clients can
10310 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
10311 # that are configured with a fault_injection_policy if:
10312 # 1. The traffic is generated by fault injection AND
10313 # 2. The fault injection is not a delay fault injection.
10314 # Fault injection is not supported with the classic Application Load Balancer
10315 # . To see which load balancers support fault injection,
10316 # see Load
10317 # balancing: Routing and traffic management features.
10318 # the resiliency of clients to backend service failure. As part of fault
10319 # injection, when clients send requests to a backend service, delays can be
10320 # introduced by the load balancer on a percentage of requests before sending
10321 # those request to the backend service. Similarly requests from clients can be
10322 # aborted by the load balancer for a percentage of requests.
10323 &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
10324 # injection.
10325 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
10326 #
10327 # The value must be from 200 to 599 inclusive.
10328 #
10329 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
10330 # according to this
10331 # mapping table. HTTP status 200 is mapped to gRPC status
10332 # UNKNOWN. Injecting an OK status is currently not supported by
10333 # Traffic Director.
10334 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
10335 # that is aborted as part of fault injection.
10336 #
10337 # The value must be from 0.0 to 100.0 inclusive.
10338 },
10339 &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
10340 # injection, before being sent to a backend service.
10341 # request to the backend service as part of fault injection.
10342 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
10343 # as a count of seconds and fractions of seconds at nanosecond
10344 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10345 # or &quot;month&quot;. Range is approximately 10,000 years.
10346 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10347 # Durations less than one second are represented with a 0
10348 # `seconds` field and a positive `nanos` field. Must be from 0
10349 # to 999,999,999 inclusive.
10350 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10351 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10352 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10353 },
10354 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
10355 # which a delay is introduced as part of fault injection.
10356 #
10357 # The value must be from 0.0 to 100.0 inclusive.
10358 },
10359 },
10360 &quot;imageOptimizationPolicy&quot;: { # The configuration for Cloud CDN&#x27;s image optimization feature. This feature # Image optimization policy for this URL Map&#x27;s route. Available only for
10361 # Global EXTERNAL_MANAGED load balancer schemes.
10362 # Either Cloud CDN must be enabled on the backend service or backend bucket
10363 # serving the route, or cache policy must be configured on the same route
10364 # dynamically processes and delivers images from the network edge.
10365 # Image Optimization is only available for Global External Application Load
10366 # Balancers.
10367 # Either Cloud CDN must be enabled on the backend service or backend bucket
10368 # serving the route, or cache policy must be configured on the same route.
10369 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
10370 },
10371 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
10372 # Unlike the timeout field where the timeout duration starts
10373 # from the time the request has been fully processed (known as*end-of-stream*),
10374 # the duration in this field is computed from the beginning of the stream
10375 # until the response has been processed, including all retries. A
10376 # stream that does not complete in this duration is closed.
10377 #
10378 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
10379 # with the route.
10380 #
10381 # This field is only allowed if the Url map is used with backend services
10382 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
10383 # as a count of seconds and fractions of seconds at nanosecond
10384 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10385 # or &quot;month&quot;. Range is approximately 10,000 years.
10386 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10387 # Durations less than one second are represented with a 0
10388 # `seconds` field and a positive `nanos` field. Must be from 0
10389 # to 999,999,999 inclusive.
10390 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10391 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10392 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10393 },
10394 &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
10395 # are shadowed to a separate mirrored backend service. The load balancer does
10396 # not wait for responses from the shadow service. Before sending traffic
10397 # to the shadow service, the host / authority header is suffixed with-shadow.
10398 #
10399 # Not supported when the URL map is bound to a target gRPC proxy that
10400 # has the validateForProxyless field set to true.
10401 # are shadowed to a separate mirrored backend service. The load balancer
10402 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
10403 # to the shadow service, the host or authority header is suffixed with-shadow.
10404 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
10405 # mirrored to.
10406 #
10407 # The backend service configured for a mirroring
10408 # policy must reference backends that are of the same type as the original
10409 # backend service matched in the URL map.
10410 #
10411 # Serverless NEG backends are not currently supported as a mirrored
10412 # backend service.
10413 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
10414 },
10415 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
10416 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
10417 # If not specified, defaults to 1.
10418 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
10419 #
10420 # If not specified, will use the timeout set in theHttpRouteAction field.
10421 # If timeout in the HttpRouteAction field is not set, this field
10422 # uses the largest timeout
10423 # among all backend services associated with the route.
10424 #
10425 # Not supported when the URL map is bound to a target gRPC proxy that
10426 # has the validateForProxyless field set to true.
10427 # as a count of seconds and fractions of seconds at nanosecond
10428 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10429 # or &quot;month&quot;. Range is approximately 10,000 years.
10430 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10431 # Durations less than one second are represented with a 0
10432 # `seconds` field and a positive `nanos` field. Must be from 0
10433 # to 999,999,999 inclusive.
10434 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10435 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10436 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10437 },
10438 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
10439 # values are:
10440 #
10441 # - 5xx: retry is attempted if the instance or endpoint
10442 # responds with any 5xx response code, or if the instance or
10443 # endpoint does not respond at all. For example, disconnects, reset, read
10444 # timeout, connection failure, and refused streams.
10445 # - gateway-error: Similar to 5xx, but only
10446 # applies to response codes 502, 503 or504.
10447 # - connect-failure: a retry is attempted on failures
10448 # connecting to the instance or endpoint. For example, connection
10449 # timeouts.
10450 # - retriable-4xx: a retry is attempted if the instance
10451 # or endpoint responds with a 4xx response code.
10452 # The only error that you can retry is error code 409.
10453 # - refused-stream: a retry is attempted if the instance
10454 # or endpoint resets the stream with a REFUSED_STREAM error
10455 # code. This reset type indicates that it is safe to retry.
10456 # - cancelled: a retry is attempted if the gRPC status
10457 # code in the response header is set to cancelled.
10458 # - deadline-exceeded: a retry is attempted if the gRPC
10459 # status code in the response header is set todeadline-exceeded.
10460 # - internal: a retry is attempted if the gRPC
10461 # status code in the response header is set tointernal.
10462 # - resource-exhausted: a retry is attempted if the gRPC
10463 # status code in the response header is set toresource-exhausted.
10464 # - unavailable: a retry is attempted if the gRPC
10465 # status code in the response header is set tounavailable.
10466 #
10467 # Only the following codes are supported when the URL map is bound to
10468 # target gRPC proxy that has validateForProxyless field set to true.
10469 #
10470 # - cancelled
10471 # - deadline-exceeded
10472 # - internal
10473 # - resource-exhausted
10474 # - unavailable
10475 &quot;A String&quot;,
10476 ],
10477 },
10478 &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
10479 # time the request has been fully processed (known as *end-of-stream*)
10480 # up until the response has been processed. Timeout includes
10481 # all retries.
10482 #
10483 # If not specified, this field uses the largest timeout among all backend
10484 # services associated with the route.
10485 #
10486 # Not supported when the URL map is bound to a target gRPC proxy that
10487 # has validateForProxyless field set to true.
10488 # as a count of seconds and fractions of seconds at nanosecond
10489 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10490 # or &quot;month&quot;. Range is approximately 10,000 years.
10491 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10492 # Durations less than one second are represented with a 0
10493 # `seconds` field and a positive `nanos` field. Must be from 0
10494 # to 999,999,999 inclusive.
10495 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10496 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10497 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10498 },
10499 &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
10500 # to the matched service.
10501 #
10502 # urlRewrite is the only action supported in UrlMaps
10503 # for classic Application Load Balancers.
10504 #
10505 # Not supported when the URL map is bound to a target gRPC proxy that
10506 # has the validateForProxyless field set to true.
10507 # backend service.
10508 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
10509 # host header is replaced with contents of hostRewrite.
10510 #
10511 # The value must be from 1 to 255 characters.
10512 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
10513 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
10514 #
10515 # The value must be from 1 to 1024 characters.
10516 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
10517 # header) using the HTTP template syntax.
10518 #
10519 # A corresponding
10520 # path_template_match must be specified. Any template variables must exist in
10521 # the path_template_match field.
10522 #
10523 #
10524 # - -At least one variable must be specified in the path_template_match
10525 # field
10526 # - You can omit variables from the rewritten URL
10527 # - The * and ** operators cannot be matched
10528 # unless they have a corresponding variable name - e.g.
10529 # {format=*} or {var=**}.
10530 #
10531 # For example, a path_template_match of /static/{format=**}
10532 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
10533 # rewrite, so that /{country}/{format}/{suffix=**} can be
10534 # rewritten as /content/{format}/{country}/{suffix}.
10535 #
10536 # At least
10537 # one non-empty routeRules[].matchRules[].path_template_match is
10538 # required.
10539 #
10540 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
10541 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
10542 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
10543 # It uses RE2 syntax with the following constraints:
10544 #
10545 #
10546 # - Any single character operators
10547 # - Groups are allowed to have only submatch operator inside
10548 # - Groups are allowed only without any char repetition, e.g.
10549 # .*
10550 # - Any char repetition, e.g. .*, is
10551 # only allowed to be used in a single regex together with:
10552 #
10553 #
10554 # - Empty string operators
10555 # - Other repetitions
10556 # - Ranges
10557 # - Repetitions of ranges
10558 #
10559 #
10560 # - Ranges are only allowed to have:
10561 #
10562 #
10563 # - Character range
10564 # - Digits range
10565 # - Symbols listed in characters allowed for ranges
10566 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
10567 # the path.
10568 },
10569 },
10570 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
10571 # occurs. The weights determine the fraction of traffic that flows to
10572 # their corresponding backend service. If all traffic needs to
10573 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
10574 #
10575 # After a backend service is identified and before forwarding
10576 # the request to
10577 # the backend service, advanced routing actions such as URL rewrites and
10578 # header transformations are applied depending on additional settings
10579 # specified in this HttpRouteAction.
10580 { # In contrast to a single BackendService in
10581 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
10582 # multiple backend services. The volume of traffic for each
10583 # backend service is proportional to the weight specified
10584 # in each WeightedBackendService
10585 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
10586 # resource. Before
10587 # forwarding the request to backendService, the load balancer
10588 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
10589 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
10590 # effect for the selected backendService.
10591 #
10592 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
10593 #
10594 # headerAction is not supported for load balancers that have
10595 # their loadBalancingScheme set to EXTERNAL.
10596 #
10597 # Not supported when the URL map is bound to a target gRPC proxy that
10598 # has validateForProxyless field set to true.
10599 # the request is passed along to the selected backendService.
10600 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
10601 { # Specification determining how headers are added to requests or responses.
10602 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
10603 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
10604 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
10605 # that already
10606 # exist for the header. If true, headerValue is set for the
10607 # header, discarding any values that were set for that header.
10608 #
10609 # The default value is true,
10610 # unless a variable is present in headerValue,
10611 # in which case the default value is false.
10612 # .
10613 },
10614 ],
10615 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
10616 # request before forwarding the request to the backendService.
10617 &quot;A String&quot;,
10618 ],
10619 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
10620 # client.
10621 { # Specification determining how headers are added to requests or responses.
10622 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
10623 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
10624 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
10625 # that already
10626 # exist for the header. If true, headerValue is set for the
10627 # header, discarding any values that were set for that header.
10628 #
10629 # The default value is true,
10630 # unless a variable is present in headerValue,
10631 # in which case the default value is false.
10632 # .
10633 },
10634 ],
10635 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
10636 # response before sending the response back to the client.
10637 &quot;A String&quot;,
10638 ],
10639 },
10640 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
10641 # computed asweight / (sum of all weightedBackendService weights in routeAction).
10642 #
10643 # The selection of a backend service is determined only for new traffic.
10644 # Once a user&#x27;s request has been directed to a backend service,
10645 # subsequent requests are sent to the same backend service as
10646 # determined by the backend service&#x27;s session affinity policy.
10647 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
10648 # splitting. If you do, the weighted traffic splitting configuration takes
10649 # precedence.
10650 #
10651 # The value must be from 0 to 1000.
10652 },
10653 ],
10654 },
10655 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
10656 # is directed if this rule is matched. If routeAction is
10657 # also specified, advanced routing actions, such as URL rewrites,
10658 # take effect before sending the request to the backend.
10659 #
10660 #
10661 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
10662 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
10663 # specified by urlRedirect.
10664 #
10665 #
10666 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
10667 #
10668 #
10669 # Not supported when the URL map is bound to a target gRPC proxy.
10670 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
10671 # was supplied in the request.
10672 #
10673 # The value must be from 1 to 255
10674 # characters.
10675 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
10676 # set to HTTPS.
10677 # If set to false, the URL scheme of the redirected request
10678 # remains the same as that of the request.
10679 #
10680 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
10681 #
10682 # The default is set to false.
10683 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
10684 # that was supplied in the request.
10685 #
10686 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
10687 # supplied, the path of the original request is used for the redirect.
10688 #
10689 # The value must be from 1 to 1024 characters.
10690 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
10691 # the HttpRouteRuleMatch, retaining the remaining portion
10692 # of the URL before redirecting the request.
10693 #
10694 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
10695 # supplied, the path of the original request is used for the redirect.
10696 #
10697 # The value must be from 1 to 1024 characters.
10698 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
10699 #
10700 # Supported values are:
10701 #
10702 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
10703 # to 301.
10704 # - FOUND, which corresponds to 302.
10705 # - SEE_OTHER which corresponds to 303.
10706 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
10707 # method is retained.
10708 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
10709 # method is retained.
10710 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
10711 # URL is
10712 # removed before redirecting the request. If set to false, the
10713 # query portion of the original URL is retained.
10714 #
10715 # The default is set to false.
10716 },
10717 },
10718 ],
10719 &quot;routeRules&quot;: [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
10720 # desired. routeRules are evaluated in order of priority, from
10721 # the lowest to highest number.
10722 #
10723 # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
10724 { # The HttpRouteRule setting specifies how to match an HTTP request
10725 # and the corresponding routing action that load balancing proxies perform.
10726 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
10727 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
10728 #
10729 # If a policy for an
10730 # error code is not configured for the RouteRule, a policy for
10731 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
10732 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
10733 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
10734 # effect.
10735 #
10736 # For example, consider a UrlMap with the following configuration:
10737 #
10738 #
10739 # - UrlMap.defaultCustomErrorResponsePolicy are configured
10740 # with policies for 5xx and 4xx errors
10741 # - A RouteRule for /coming_soon/ is configured for the
10742 # error code 404.
10743 #
10744 # 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
10745 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
10746 # the policy in RouteRule.customErrorResponsePolicy takes
10747 # effect. If any of the requests in this example encounter a 500
10748 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
10749 #
10750 # When
10751 # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
10752 # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
10753 # a retry, if load balancer is successful in reaching the
10754 # service, the customErrorResponsePolicy is ignored and
10755 # the response from the service is returned to the client.
10756 #
10757 # customErrorResponsePolicy is supported only for
10758 # global external Application Load Balancers.
10759 # backend service or backend bucket responds with an error.
10760 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
10761 #
10762 # In a given policy, if you specify rules for both a range of error codes
10763 # as well as rules for specific error codes then rules with specific error
10764 # codes have a higher priority. For example, assume that you configure a rule
10765 # for 401 (Un-authorized) code, and another for all 4 series
10766 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
10767 # However if the backend service returns a 403, the rule for4xx takes effect.
10768 { # Specifies the mapping between the response code that will be returned along
10769 # with the custom error content and the response code returned by the backend
10770 # service.
10771 &quot;matchResponseCodes&quot;: [ # Valid values include:
10772 #
10773 #
10774 # - A number between 400 and 599: For example
10775 # 401 or 503, in which case the load balancer
10776 # applies the policy if the error code exactly matches this value.
10777 # - 5xx: Load Balancer will apply the policy if the
10778 # backend service responds with any response code in the range of
10779 # 500 to 599.
10780 # - 4xx: Load
10781 # Balancer will apply the policy if the backend service responds with any
10782 # response code in the range of 400 to
10783 # 499.
10784 #
10785 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
10786 &quot;A String&quot;,
10787 ],
10788 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
10789 # error content. If overrideResponseCode is not supplied, the
10790 # same response code returned by the original backend bucket or backend
10791 # service is returned to the client.
10792 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
10793 #
10794 # path must start
10795 # with a leading slash. path cannot have trailing slashes.
10796 #
10797 # If the file is not available in backendBucket or the
10798 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
10799 #
10800 # The value must
10801 # be from 1 to 1024 characters
10802 },
10803 ],
10804 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
10805 # contains the custom error content. Examples are:
10806 #
10807 #
10808 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
10809 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
10810 # - global/backendBuckets/myBackendBucket
10811 #
10812 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
10813 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
10814 #
10815 # If load balancer cannot reach
10816 # the backendBucket, a simple Not Found Error will
10817 # be returned, with the original response code (oroverrideResponseCode if configured).
10818 #
10819 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
10820 },
10821 &quot;description&quot;: &quot;A String&quot;, # The short description conveying the intent of this routeRule.
10822 #
10823 #
10824 # The description can have a maximum length of 1024 characters.
10825 &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
10826 # for the selected backendService.
10827 #
10828 # The headerAction value specified here is applied before the
10829 # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
10830 #
10831 # HeaderAction is not supported for load balancers
10832 # that have
10833 # their loadBalancingScheme set to EXTERNAL.
10834 #
10835 # Not supported when the URL map is bound to a target gRPC proxy that
10836 # has validateForProxyless field set to true.
10837 # the request is passed along to the selected backendService.
10838 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
10839 { # Specification determining how headers are added to requests or responses.
10840 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
10841 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
10842 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
10843 # that already
10844 # exist for the header. If true, headerValue is set for the
10845 # header, discarding any values that were set for that header.
10846 #
10847 # The default value is true,
10848 # unless a variable is present in headerValue,
10849 # in which case the default value is false.
10850 # .
10851 },
10852 ],
10853 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
10854 # request before forwarding the request to the backendService.
10855 &quot;A String&quot;,
10856 ],
10857 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
10858 # client.
10859 { # Specification determining how headers are added to requests or responses.
10860 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
10861 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
10862 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
10863 # that already
10864 # exist for the header. If true, headerValue is set for the
10865 # header, discarding any values that were set for that header.
10866 #
10867 # The default value is true,
10868 # unless a variable is present in headerValue,
10869 # in which case the default value is false.
10870 # .
10871 },
10872 ],
10873 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
10874 # response before sending the response back to the client.
10875 &quot;A String&quot;,
10876 ],
10877 },
10878 &quot;httpFilterConfigs&quot;: [ # Outbound route specific configuration fornetworkservices.HttpFilter resources enabled by Traffic
10879 # Director. httpFilterConfigs only applies for load balancers
10880 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
10881 # more details.
10882 #
10883 # Not supported when the URL map is bound to a target gRPC proxy that
10884 # has validateForProxyless field set to true.
10885 { # HttpFilterConfiguration supplies additional contextual settings
10886 # for networkservices.HttpFilter resources enabled by Traffic
10887 # Director.
10888 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
10889 # YAML formatted and only contain fields defined in the protobuf identified
10890 # in configTypeUrl
10891 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
10892 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
10893 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
10894 # configuration belongs to. This name must be known to the xDS client.
10895 # Example: envoy.wasm
10896 },
10897 ],
10898 &quot;httpFilterMetadata&quot;: [ # Outbound route specific metadata supplied tonetworkservices.HttpFilter resources enabled by Traffic
10899 # Director. httpFilterMetadata only applies for load balancers
10900 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
10901 # more details.
10902 #
10903 # The only configTypeUrl supported istype.googleapis.com/google.protobuf.Struct
10904 #
10905 # Not supported when the URL map is bound to a target gRPC proxy that
10906 # has validateForProxyless field set to true.
10907 { # HttpFilterConfiguration supplies additional contextual settings
10908 # for networkservices.HttpFilter resources enabled by Traffic
10909 # Director.
10910 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
10911 # YAML formatted and only contain fields defined in the protobuf identified
10912 # in configTypeUrl
10913 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
10914 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
10915 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
10916 # configuration belongs to. This name must be known to the xDS client.
10917 # Example: envoy.wasm
10918 },
10919 ],
10920 &quot;matchRules&quot;: [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
10921 # this routeRule when any of thematchRules are satisfied. However predicates within
10922 # a given matchRule have AND semantics. All predicates
10923 # within a matchRule must match for the request to
10924 # match the rule.
10925 { # HttpRouteRuleMatch specifies a set of criteria for matching
10926 # requests to an HttpRouteRule. All specified criteria must
10927 # be satisfied for a match to occur.
10928 &quot;fullPathMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
10929 # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
10930 # that may be part of the original URL.
10931 #
10932 # fullPathMatch must be from 1 to 1024 characters.
10933 #
10934 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
10935 # specified.
10936 &quot;headerMatches&quot;: [ # Specifies a list of header match criteria, all of which must match
10937 # corresponding headers in the request.
10938 { # matchRule criteria for request header matches.
10939 &quot;exactMatch&quot;: &quot;A String&quot;, # The value should exactly match contents of exactMatch.
10940 #
10941 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
10942 &quot;headerName&quot;: &quot;A String&quot;, # The name of the HTTP header to match.
10943 #
10944 # For matching against the HTTP request&#x27;s authority, use a headerMatch
10945 # with the header name &quot;:authority&quot;.
10946 #
10947 # For matching a request&#x27;s method, use the headerName &quot;:method&quot;.
10948 #
10949 # When the URL map is bound to a target gRPC proxy that has
10950 # the validateForProxyless field set to true, only
10951 # non-binary
10952 # user-specified custom metadata and the `content-type` header are supported.
10953 # The following transport-level headers cannot be used in header matching
10954 # rules:
10955 # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
10956 # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
10957 # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
10958 # `grpc-timeout` and `grpc-trace-bin`.
10959 &quot;invertMatch&quot;: True or False, # If set to false, the headerMatch is considered a
10960 # match if the preceding match criteria are met. If set to true,
10961 # the headerMatch is considered a match if the preceding
10962 # match criteria are NOT met.
10963 #
10964 # The default setting is false.
10965 &quot;prefixMatch&quot;: &quot;A String&quot;, # The value of the header must start with the contents ofprefixMatch.
10966 #
10967 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
10968 &quot;presentMatch&quot;: True or False, # A header with the contents of headerName must exist. The
10969 # match takes place whether or not the request&#x27;s header has a value.
10970 #
10971 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
10972 &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
10973 # specified in rangeMatch. If the header does not contain an
10974 # integer, number or is empty, the match fails.
10975 #
10976 # For example for a range [-5, 0]
10977 #
10978 #
10979 # - -3 will match.
10980 # - 0 will not match.
10981 # - 0.25 will not match.
10982 # - -3someString will not match.
10983 #
10984 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
10985 #
10986 # rangeMatch is not supported for load balancers
10987 # that have loadBalancingScheme set to EXTERNAL.
10988 # within the specified integer range.
10989 &quot;rangeEnd&quot;: &quot;A String&quot;, # The end of the range (exclusive) in signed long integer format.
10990 &quot;rangeStart&quot;: &quot;A String&quot;, # The start of the range (inclusive) in signed long integer format.
10991 },
10992 &quot;regexMatch&quot;: &quot;A String&quot;, # The value of the header must match the regular expression specified inregexMatch.
10993 # For more information about regular expression syntax, see Syntax.
10994 #
10995 # For matching against a port specified in the HTTP request, use a
10996 # headerMatch with headerName set to PORT and a regular expression that
10997 # satisfies the RFC2616 Host header&#x27;s port specifier.
10998 #
10999 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
11000 #
11001 # Regular expressions can only be used when the loadBalancingScheme is
11002 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
11003 # (regional scope) or INTERNAL_MANAGED.
11004 &quot;suffixMatch&quot;: &quot;A String&quot;, # The value of the header must end with the contents ofsuffixMatch.
11005 #
11006 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
11007 },
11008 ],
11009 &quot;ignoreCase&quot;: True or False, # Specifies that prefixMatch and fullPathMatch
11010 # matches are case sensitive.
11011 #
11012 # The default value is false.
11013 #
11014 # ignoreCase must not be used with regexMatch.
11015 #
11016 # Not supported when the URL map is bound to a target gRPC proxy.
11017 &quot;metadataFilters&quot;: [ # Opaque filter criteria used by the load balancer to restrict routing
11018 # configuration to a limited set of xDS
11019 # compliant clients. In their xDS requests to the load balancer, xDS clients
11020 # present node
11021 # metadata. When there is a match, the relevant routing configuration
11022 # is made available to those proxies.
11023 #
11024 # 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
11025 # the metadata. If its filterMatchCriteria is set to
11026 # MATCH_ALL, then all of its filterLabels must match with
11027 # corresponding labels provided in the metadata. If multiple
11028 # metadata filters are specified, all of them need to be
11029 # satisfied in order to be considered a match.
11030 #
11031 # metadataFilters specified here is applied after those
11032 # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
11033 #
11034 # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
11035 #
11036 # Not supported when the URL map is bound to a target gRPC proxy that
11037 # has validateForProxyless field set to true.
11038 { # Opaque filter criteria used by load balancers to restrict routing
11039 # configuration to a limited set of load balancing proxies. Proxies and
11040 # sidecars involved in load balancing would typically present metadata to the
11041 # load balancers that need to match criteria specified here. If a match takes
11042 # place, the relevant configuration is made available to those
11043 # proxies.
11044 #
11045 # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
11046 # one of thefilterLabels must match the corresponding label provided in
11047 # the metadata. If its filterMatchCriteria is set to
11048 # MATCH_ALL, then all of its filterLabels must match with
11049 # corresponding labels provided in the metadata.
11050 #
11051 # An example for using metadataFilters would be: if
11052 # load balancing involves
11053 # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in of their XDS requests to loadbalancers.
11054 &quot;filterLabels&quot;: [ # The list of label value pairs that must match labels in the provided
11055 # metadata based on filterMatchCriteria
11056 #
11057 # This list must not be empty and can have at the most 64 entries.
11058 { # MetadataFilter label name value pairs that are expected
11059 # to match corresponding labels presented as metadata to the load balancer.
11060 &quot;name&quot;: &quot;A String&quot;, # Name of metadata label.
11061 #
11062 # The name can have a maximum length of 1024 characters and must be at
11063 # least 1 character long.
11064 &quot;value&quot;: &quot;A String&quot;, # The value of the label must match the specified value.
11065 #
11066 # value can have a maximum length of 1024 characters.
11067 },
11068 ],
11069 &quot;filterMatchCriteria&quot;: &quot;A String&quot;, # Specifies how individual filter label matches
11070 # within the list of filterLabels and contributes toward the
11071 # overall metadataFilter match.
11072 #
11073 # Supported values are:
11074 #
11075 # - MATCH_ANY: at least one of the filterLabels
11076 # must have a matching label in the provided metadata.
11077 # - MATCH_ALL: all filterLabels must have
11078 # matching labels in the provided metadata.
11079 },
11080 ],
11081 &quot;pathTemplateMatch&quot;: &quot;A String&quot;, # If specified, this field defines a path template pattern that must match
11082 # the :path header after the query string is removed.
11083 #
11084 # A path template pattern can include variables and wildcards.
11085 # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
11086 # matches a single path segment, and ** that matches zero or
11087 # more path segments. The pattern must follow these rules:
11088 #
11089 #
11090 # - The value must be between 1 and 1024 characters.
11091 # - The pattern must start with a leading slash (&quot;/&quot;).
11092 # - No more than 5 operators (variables or wildcards) may appear in
11093 # the pattern.
11094 #
11095 # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
11096 # set.
11097 &quot;prefixMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the request&#x27;s
11098 # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
11099 #
11100 # The value must be from 1 to 1024 characters.
11101 #
11102 # The * character inside a prefix match is
11103 # treated as a literal character, not as a wildcard.
11104 #
11105 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
11106 # used within a matchRule.
11107 &quot;queryParameterMatches&quot;: [ # Specifies a list of query parameter match criteria, all of which must
11108 # match corresponding query parameters in the request.
11109 #
11110 # Not supported when the URL map is bound to a target gRPC proxy.
11111 { # HttpRouteRuleMatch criteria for a request&#x27;s query parameter.
11112 &quot;exactMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
11113 # parameter exactly matches the contents of exactMatch.
11114 #
11115 # Only one of presentMatch, exactMatch, orregexMatch must be set.
11116 &quot;name&quot;: &quot;A String&quot;, # The name of the query parameter to match. The query parameter must exist in
11117 # the request, in the absence of which the request match fails.
11118 &quot;presentMatch&quot;: True or False, # Specifies that the queryParameterMatch matches if the
11119 # request contains the query parameter, irrespective of whether the
11120 # parameter has a value or not.
11121 #
11122 # Only one of presentMatch, exactMatch, orregexMatch must be set.
11123 &quot;regexMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
11124 # parameter matches the regular expression specified byregexMatch. For
11125 # more information about regular expression syntax, see Syntax.
11126 #
11127 # Only one of presentMatch, exactMatch, orregexMatch must be set.
11128 #
11129 # Regular expressions can only be used when the loadBalancingScheme is
11130 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
11131 # (regional scope) or INTERNAL_MANAGED.
11132 },
11133 ],
11134 &quot;regexMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
11135 # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
11136 # supplied with the original URL. For
11137 # more information about regular expression syntax, see Syntax.
11138 #
11139 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
11140 # specified.
11141 #
11142 # Regular expressions can only be used when the loadBalancingScheme is
11143 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
11144 # (regional scope) or INTERNAL_MANAGED.
11145 },
11146 ],
11147 &quot;priority&quot;: 42, # For routeRules within a given pathMatcher,
11148 # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
11149 # of priority, from the lowest to highest number. The priority of a
11150 # rule decreases as its number increases (1, 2, 3, N+1). The first rule
11151 # that matches the request is applied.
11152 #
11153 #
11154 # You cannot configure two or more routeRules with the same priority.
11155 # Priority for each rule must be set to a number from 0 to 2147483647
11156 # inclusive.
11157 #
11158 #
11159 # Priority numbers can have gaps, which enable you to add or remove rules
11160 # in the future without affecting the rest of the rules. For example, 1, 2,
11161 # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
11162 # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
11163 # without any impact on existing rules.
11164 &quot;routeAction&quot;: { # In response to a matching matchRule, the load balancer
11165 # performs advanced routing actions, such as URL rewrites and header
11166 # transformations, before forwarding the request to the selected backend.
11167 #
11168 #
11169 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
11170 #
11171 #
11172 # URL maps for classic Application Load Balancers only support
11173 # the urlRewrite action within a route rule&#x27;srouteAction.
11174 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
11175 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
11176 # property must be specified. This policy cannot be specified if any target
11177 # backend has Identity-Aware Proxy enabled.
11178 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
11179 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
11180 # header names can be specified. The cache is bypassed for all `cacheMode`
11181 # values.
11182 &quot;A String&quot;,
11183 ],
11184 &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
11185 # on the backend type: for Backend Services, the complete request URI is
11186 # used; for Backend Buckets, the request URI is used without the protocol or
11187 # host, and only query parameters known to Cloud Storage are included.
11188 # Policy defined on Route Action.
11189 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
11190 # parameters will be included. Either specify `excludedQueryParameters`
11191 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
11192 # encoded and not treated as delimiters.
11193 #
11194 # Note: This field applies to routes that use backend services. Attempting
11195 # to set it on a route that points exclusively to Backend Buckets will
11196 # result in a configuration error. For routes that point to a Backend
11197 # Bucket, use `includedQueryParameters` to define which parameters should
11198 # be part of the cache key.
11199 &quot;A String&quot;,
11200 ],
11201 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
11202 #
11203 # Note: This setting is only applicable to routes that use a Backend
11204 # Service. It does not affect requests served by a Backend Bucket, as the
11205 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
11206 # it on a route that points exclusively to Backend Buckets will result in a
11207 # configuration error.
11208 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
11209 #
11210 # Note: This setting is only applicable to routes that use a Backend
11211 # Service. It does not affect requests served by a Backend Bucket, as the
11212 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
11213 # set on a route that points exclusively to Backend Buckets will result in
11214 # a configuration error.
11215 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
11216 # `includedQueryParameters` and `excludedQueryParameters`. If neither
11217 # is set, the entire query string will be included. If false, the query
11218 # string will be excluded from the cache key entirely.
11219 #
11220 # Note: This field applies to routes that use backend services. Attempting
11221 # to set it on a route that points exclusively to Backend Buckets will
11222 # result in a configuration error. For routes that point to a Backend
11223 # Bucket, use `includedQueryParameters` to define which parameters should
11224 # be part of the cache key.
11225 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
11226 # The name=value pair will be used in the cache key Cloud CDN generates.
11227 #
11228 # Note: This setting is only applicable to routes that use a Backend
11229 # Service. It does not affect requests served by a Backend Bucket.
11230 # Attempting to set it on a route that points exclusively to Backend
11231 # Buckets will result in a configuration error. Up to 5 cookie names can be
11232 # specified.
11233 &quot;A String&quot;,
11234 ],
11235 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
11236 &quot;A String&quot;,
11237 ],
11238 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
11239 # parameters will be excluded. Either specify `includedQueryParameters`
11240 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
11241 # encoded and not treated as delimiters.
11242 &quot;A String&quot;,
11243 ],
11244 },
11245 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
11246 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
11247 &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
11248 # content. This is used to clamp the max-age (or Expires) value sent to the
11249 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
11250 # is used for the response max-age directive, along with a &quot;public&quot;
11251 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
11252 # clamps the max-age from the origin (if specified), or else sets the
11253 # response max-age directive to the lesser of the `clientTtl` and
11254 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
11255 # present. The maximum allowed value is 31,622,400s (1 year). If not
11256 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
11257 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
11258 # `USE_ORIGIN_HEADERS`.
11259 # as a count of seconds and fractions of seconds at nanosecond
11260 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
11261 # or &quot;month&quot;. Range is approximately 10,000 years.
11262 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
11263 # Durations less than one second are represented with a 0
11264 # `seconds` field and a positive `nanos` field. Must be from 0
11265 # to 999,999,999 inclusive.
11266 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
11267 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
11268 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
11269 },
11270 &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
11271 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
11272 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
11273 # greater than that of `maxTtl`. When the `cacheMode` is set to
11274 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
11275 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
11276 # accessed objects may be evicted from the cache before the defined TTL. If
11277 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
11278 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
11279 # `USE_ORIGIN_HEADERS`.
11280 # as a count of seconds and fractions of seconds at nanosecond
11281 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
11282 # or &quot;month&quot;. Range is approximately 10,000 years.
11283 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
11284 # Durations less than one second are represented with a 0
11285 # `seconds` field and a positive `nanos` field. Must be from 0
11286 # to 999,999,999 inclusive.
11287 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
11288 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
11289 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
11290 },
11291 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
11292 # attempt to set a max-age or s-maxage higher than this, or an Expires header
11293 # more than `maxTtl` seconds in the future will be capped at the value of
11294 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
11295 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
11296 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
11297 # Infrequently accessed objects may be evicted from the cache before the
11298 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
11299 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
11300 # mode.
11301 # as a count of seconds and fractions of seconds at nanosecond
11302 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
11303 # or &quot;month&quot;. Range is approximately 10,000 years.
11304 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
11305 # Durations less than one second are represented with a 0
11306 # `seconds` field and a positive `nanos` field. Must be from 0
11307 # to 999,999,999 inclusive.
11308 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
11309 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
11310 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
11311 },
11312 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
11313 # to apply fine-grained caching for common errors or redirects.
11314 # This can reduce the load on your origin and improve end-user
11315 # experience by reducing response latency.
11316 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
11317 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
11318 # the specified response code that lack any Cache-Control, Expires, or
11319 # Pragma: no-cache directives. When the `cacheMode` is set to
11320 # `FORCE_CACHE_ALL`, negative caching applies to all responses
11321 # with the specified response code, and overrides any caching headers. By
11322 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
11323 #
11324 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
11325 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
11326 # * 405 (Method Not Found), 501 (Not Implemented): 60s
11327 #
11328 # These defaults can be overridden in `negativeCachingPolicy`.
11329 # If not specified, Cloud CDN applies negative caching by default.
11330 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
11331 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
11332 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
11333 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
11334 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
11335 # all response codes that you wish to cache. Cloud CDN will not apply any
11336 # default negative caching when a policy exists.
11337 { # Specify CDN TTLs for response error codes.
11338 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
11339 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
11340 # specified as values, and you cannot specify a status code more than
11341 # once.
11342 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
11343 # corresponding status code.
11344 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
11345 # objects may be evicted from the cache before the defined TTL.
11346 # as a count of seconds and fractions of seconds at nanosecond
11347 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
11348 # or &quot;month&quot;. Range is approximately 10,000 years.
11349 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
11350 # Durations less than one second are represented with a 0
11351 # `seconds` field and a positive `nanos` field. Must be from 0
11352 # to 999,999,999 inclusive.
11353 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
11354 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
11355 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
11356 },
11357 },
11358 ],
11359 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
11360 # requests into a small number of requests to the origin. If not specified,
11361 # Cloud CDN applies request coalescing by default.
11362 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
11363 # content with the origin, or when an error is encountered when refreshing
11364 # the cache.
11365 # This setting defines the default &quot;max-stale&quot; duration for any cached
11366 # responses that do not specify a max-stale directive. Stale responses that
11367 # exceed the TTL configured here will not be served. The default limit
11368 # (max-stale) is 86400s (1 day), which will allow stale content to be
11369 # served up to this limit beyond the max-age (or s-maxage) of a cached
11370 # response.
11371 # The maximum allowed value is 604800 (1 week).
11372 # Set this to zero (0) to disable serve-while-stale.
11373 # as a count of seconds and fractions of seconds at nanosecond
11374 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
11375 # or &quot;month&quot;. Range is approximately 10,000 years.
11376 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
11377 # Durations less than one second are represented with a 0
11378 # `seconds` field and a positive `nanos` field. Must be from 0
11379 # to 999,999,999 inclusive.
11380 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
11381 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
11382 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
11383 },
11384 },
11385 &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
11386 # information about the W3C recommendation for cross-origin resource sharing
11387 # (CORS), see Fetch API Living
11388 # Standard.
11389 #
11390 # Not supported when the URL map is bound to a target gRPC proxy.
11391 # information about the W3C recommendation for cross-origin resource sharing
11392 # (CORS), see Fetch API Living
11393 # Standard.
11394 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
11395 # indicates that
11396 # the actual request can include user credentials. This field translates to
11397 # the Access-Control-Allow-Credentials header.
11398 #
11399 # Default is false.
11400 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
11401 # header.
11402 &quot;A String&quot;,
11403 ],
11404 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
11405 # header.
11406 &quot;A String&quot;,
11407 ],
11408 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
11409 # more information, see regular expression syntax.
11410 #
11411 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
11412 #
11413 # Regular expressions can only be used when the loadBalancingScheme is
11414 # set to INTERNAL_SELF_MANAGED.
11415 &quot;A String&quot;,
11416 ],
11417 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
11418 #
11419 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
11420 &quot;A String&quot;,
11421 ],
11422 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
11423 # The default value is false, which indicates that the CORS
11424 # policy is in effect.
11425 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
11426 # header.
11427 &quot;A String&quot;,
11428 ],
11429 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
11430 # seconds. This field translates to the Access-Control-Max-Age
11431 # header.
11432 },
11433 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
11434 # the resiliency of clients to backend service failure. As part of fault
11435 # injection, when clients send requests to a backend service, delays can be
11436 # introduced by a load balancer on a percentage of requests before sending
11437 # those requests to the backend service. Similarly requests from clients can
11438 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
11439 # that are configured with a fault_injection_policy if:
11440 # 1. The traffic is generated by fault injection AND
11441 # 2. The fault injection is not a delay fault injection.
11442 # Fault injection is not supported with the classic Application Load Balancer
11443 # . To see which load balancers support fault injection,
11444 # see Load
11445 # balancing: Routing and traffic management features.
11446 # the resiliency of clients to backend service failure. As part of fault
11447 # injection, when clients send requests to a backend service, delays can be
11448 # introduced by the load balancer on a percentage of requests before sending
11449 # those request to the backend service. Similarly requests from clients can be
11450 # aborted by the load balancer for a percentage of requests.
11451 &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
11452 # injection.
11453 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
11454 #
11455 # The value must be from 200 to 599 inclusive.
11456 #
11457 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
11458 # according to this
11459 # mapping table. HTTP status 200 is mapped to gRPC status
11460 # UNKNOWN. Injecting an OK status is currently not supported by
11461 # Traffic Director.
11462 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
11463 # that is aborted as part of fault injection.
11464 #
11465 # The value must be from 0.0 to 100.0 inclusive.
11466 },
11467 &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
11468 # injection, before being sent to a backend service.
11469 # request to the backend service as part of fault injection.
11470 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
11471 # as a count of seconds and fractions of seconds at nanosecond
11472 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
11473 # or &quot;month&quot;. Range is approximately 10,000 years.
11474 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
11475 # Durations less than one second are represented with a 0
11476 # `seconds` field and a positive `nanos` field. Must be from 0
11477 # to 999,999,999 inclusive.
11478 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
11479 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
11480 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
11481 },
11482 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
11483 # which a delay is introduced as part of fault injection.
11484 #
11485 # The value must be from 0.0 to 100.0 inclusive.
11486 },
11487 },
11488 &quot;imageOptimizationPolicy&quot;: { # The configuration for Cloud CDN&#x27;s image optimization feature. This feature # Image optimization policy for this URL Map&#x27;s route. Available only for
11489 # Global EXTERNAL_MANAGED load balancer schemes.
11490 # Either Cloud CDN must be enabled on the backend service or backend bucket
11491 # serving the route, or cache policy must be configured on the same route
11492 # dynamically processes and delivers images from the network edge.
11493 # Image Optimization is only available for Global External Application Load
11494 # Balancers.
11495 # Either Cloud CDN must be enabled on the backend service or backend bucket
11496 # serving the route, or cache policy must be configured on the same route.
11497 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
11498 },
11499 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
11500 # Unlike the timeout field where the timeout duration starts
11501 # from the time the request has been fully processed (known as*end-of-stream*),
11502 # the duration in this field is computed from the beginning of the stream
11503 # until the response has been processed, including all retries. A
11504 # stream that does not complete in this duration is closed.
11505 #
11506 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
11507 # with the route.
11508 #
11509 # This field is only allowed if the Url map is used with backend services
11510 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
11511 # as a count of seconds and fractions of seconds at nanosecond
11512 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
11513 # or &quot;month&quot;. Range is approximately 10,000 years.
11514 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
11515 # Durations less than one second are represented with a 0
11516 # `seconds` field and a positive `nanos` field. Must be from 0
11517 # to 999,999,999 inclusive.
11518 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
11519 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
11520 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
11521 },
11522 &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
11523 # are shadowed to a separate mirrored backend service. The load balancer does
11524 # not wait for responses from the shadow service. Before sending traffic
11525 # to the shadow service, the host / authority header is suffixed with-shadow.
11526 #
11527 # Not supported when the URL map is bound to a target gRPC proxy that
11528 # has the validateForProxyless field set to true.
11529 # are shadowed to a separate mirrored backend service. The load balancer
11530 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
11531 # to the shadow service, the host or authority header is suffixed with-shadow.
11532 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
11533 # mirrored to.
11534 #
11535 # The backend service configured for a mirroring
11536 # policy must reference backends that are of the same type as the original
11537 # backend service matched in the URL map.
11538 #
11539 # Serverless NEG backends are not currently supported as a mirrored
11540 # backend service.
11541 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
11542 },
11543 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
11544 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
11545 # If not specified, defaults to 1.
11546 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
11547 #
11548 # If not specified, will use the timeout set in theHttpRouteAction field.
11549 # If timeout in the HttpRouteAction field is not set, this field
11550 # uses the largest timeout
11551 # among all backend services associated with the route.
11552 #
11553 # Not supported when the URL map is bound to a target gRPC proxy that
11554 # has the validateForProxyless field set to true.
11555 # as a count of seconds and fractions of seconds at nanosecond
11556 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
11557 # or &quot;month&quot;. Range is approximately 10,000 years.
11558 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
11559 # Durations less than one second are represented with a 0
11560 # `seconds` field and a positive `nanos` field. Must be from 0
11561 # to 999,999,999 inclusive.
11562 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
11563 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
11564 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
11565 },
11566 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
11567 # values are:
11568 #
11569 # - 5xx: retry is attempted if the instance or endpoint
11570 # responds with any 5xx response code, or if the instance or
11571 # endpoint does not respond at all. For example, disconnects, reset, read
11572 # timeout, connection failure, and refused streams.
11573 # - gateway-error: Similar to 5xx, but only
11574 # applies to response codes 502, 503 or504.
11575 # - connect-failure: a retry is attempted on failures
11576 # connecting to the instance or endpoint. For example, connection
11577 # timeouts.
11578 # - retriable-4xx: a retry is attempted if the instance
11579 # or endpoint responds with a 4xx response code.
11580 # The only error that you can retry is error code 409.
11581 # - refused-stream: a retry is attempted if the instance
11582 # or endpoint resets the stream with a REFUSED_STREAM error
11583 # code. This reset type indicates that it is safe to retry.
11584 # - cancelled: a retry is attempted if the gRPC status
11585 # code in the response header is set to cancelled.
11586 # - deadline-exceeded: a retry is attempted if the gRPC
11587 # status code in the response header is set todeadline-exceeded.
11588 # - internal: a retry is attempted if the gRPC
11589 # status code in the response header is set tointernal.
11590 # - resource-exhausted: a retry is attempted if the gRPC
11591 # status code in the response header is set toresource-exhausted.
11592 # - unavailable: a retry is attempted if the gRPC
11593 # status code in the response header is set tounavailable.
11594 #
11595 # Only the following codes are supported when the URL map is bound to
11596 # target gRPC proxy that has validateForProxyless field set to true.
11597 #
11598 # - cancelled
11599 # - deadline-exceeded
11600 # - internal
11601 # - resource-exhausted
11602 # - unavailable
11603 &quot;A String&quot;,
11604 ],
11605 },
11606 &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
11607 # time the request has been fully processed (known as *end-of-stream*)
11608 # up until the response has been processed. Timeout includes
11609 # all retries.
11610 #
11611 # If not specified, this field uses the largest timeout among all backend
11612 # services associated with the route.
11613 #
11614 # Not supported when the URL map is bound to a target gRPC proxy that
11615 # has validateForProxyless field set to true.
11616 # as a count of seconds and fractions of seconds at nanosecond
11617 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
11618 # or &quot;month&quot;. Range is approximately 10,000 years.
11619 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
11620 # Durations less than one second are represented with a 0
11621 # `seconds` field and a positive `nanos` field. Must be from 0
11622 # to 999,999,999 inclusive.
11623 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
11624 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
11625 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
11626 },
11627 &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
11628 # to the matched service.
11629 #
11630 # urlRewrite is the only action supported in UrlMaps
11631 # for classic Application Load Balancers.
11632 #
11633 # Not supported when the URL map is bound to a target gRPC proxy that
11634 # has the validateForProxyless field set to true.
11635 # backend service.
11636 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
11637 # host header is replaced with contents of hostRewrite.
11638 #
11639 # The value must be from 1 to 255 characters.
11640 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
11641 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
11642 #
11643 # The value must be from 1 to 1024 characters.
11644 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
11645 # header) using the HTTP template syntax.
11646 #
11647 # A corresponding
11648 # path_template_match must be specified. Any template variables must exist in
11649 # the path_template_match field.
11650 #
11651 #
11652 # - -At least one variable must be specified in the path_template_match
11653 # field
11654 # - You can omit variables from the rewritten URL
11655 # - The * and ** operators cannot be matched
11656 # unless they have a corresponding variable name - e.g.
11657 # {format=*} or {var=**}.
11658 #
11659 # For example, a path_template_match of /static/{format=**}
11660 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
11661 # rewrite, so that /{country}/{format}/{suffix=**} can be
11662 # rewritten as /content/{format}/{country}/{suffix}.
11663 #
11664 # At least
11665 # one non-empty routeRules[].matchRules[].path_template_match is
11666 # required.
11667 #
11668 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
11669 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
11670 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
11671 # It uses RE2 syntax with the following constraints:
11672 #
11673 #
11674 # - Any single character operators
11675 # - Groups are allowed to have only submatch operator inside
11676 # - Groups are allowed only without any char repetition, e.g.
11677 # .*
11678 # - Any char repetition, e.g. .*, is
11679 # only allowed to be used in a single regex together with:
11680 #
11681 #
11682 # - Empty string operators
11683 # - Other repetitions
11684 # - Ranges
11685 # - Repetitions of ranges
11686 #
11687 #
11688 # - Ranges are only allowed to have:
11689 #
11690 #
11691 # - Character range
11692 # - Digits range
11693 # - Symbols listed in characters allowed for ranges
11694 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
11695 # the path.
11696 },
11697 },
11698 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
11699 # occurs. The weights determine the fraction of traffic that flows to
11700 # their corresponding backend service. If all traffic needs to
11701 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
11702 #
11703 # After a backend service is identified and before forwarding
11704 # the request to
11705 # the backend service, advanced routing actions such as URL rewrites and
11706 # header transformations are applied depending on additional settings
11707 # specified in this HttpRouteAction.
11708 { # In contrast to a single BackendService in
11709 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
11710 # multiple backend services. The volume of traffic for each
11711 # backend service is proportional to the weight specified
11712 # in each WeightedBackendService
11713 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
11714 # resource. Before
11715 # forwarding the request to backendService, the load balancer
11716 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
11717 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
11718 # effect for the selected backendService.
11719 #
11720 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
11721 #
11722 # headerAction is not supported for load balancers that have
11723 # their loadBalancingScheme set to EXTERNAL.
11724 #
11725 # Not supported when the URL map is bound to a target gRPC proxy that
11726 # has validateForProxyless field set to true.
11727 # the request is passed along to the selected backendService.
11728 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
11729 { # Specification determining how headers are added to requests or responses.
11730 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
11731 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
11732 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
11733 # that already
11734 # exist for the header. If true, headerValue is set for the
11735 # header, discarding any values that were set for that header.
11736 #
11737 # The default value is true,
11738 # unless a variable is present in headerValue,
11739 # in which case the default value is false.
11740 # .
11741 },
11742 ],
11743 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
11744 # request before forwarding the request to the backendService.
11745 &quot;A String&quot;,
11746 ],
11747 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
11748 # client.
11749 { # Specification determining how headers are added to requests or responses.
11750 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
11751 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
11752 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
11753 # that already
11754 # exist for the header. If true, headerValue is set for the
11755 # header, discarding any values that were set for that header.
11756 #
11757 # The default value is true,
11758 # unless a variable is present in headerValue,
11759 # in which case the default value is false.
11760 # .
11761 },
11762 ],
11763 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
11764 # response before sending the response back to the client.
11765 &quot;A String&quot;,
11766 ],
11767 },
11768 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
11769 # computed asweight / (sum of all weightedBackendService weights in routeAction).
11770 #
11771 # The selection of a backend service is determined only for new traffic.
11772 # Once a user&#x27;s request has been directed to a backend service,
11773 # subsequent requests are sent to the same backend service as
11774 # determined by the backend service&#x27;s session affinity policy.
11775 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
11776 # splitting. If you do, the weighted traffic splitting configuration takes
11777 # precedence.
11778 #
11779 # The value must be from 0 to 1000.
11780 },
11781 ],
11782 },
11783 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
11784 # is directed if this rule is matched. If routeAction is
11785 # also specified, advanced routing actions, such as URL rewrites,
11786 # take effect before sending the request to the backend.
11787 #
11788 #
11789 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
11790 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
11791 # specified by urlRedirect.
11792 #
11793 #
11794 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
11795 #
11796 #
11797 # Not supported when the URL map is bound to a target gRPC proxy.
11798 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
11799 # was supplied in the request.
11800 #
11801 # The value must be from 1 to 255
11802 # characters.
11803 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
11804 # set to HTTPS.
11805 # If set to false, the URL scheme of the redirected request
11806 # remains the same as that of the request.
11807 #
11808 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
11809 #
11810 # The default is set to false.
11811 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
11812 # that was supplied in the request.
11813 #
11814 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
11815 # supplied, the path of the original request is used for the redirect.
11816 #
11817 # The value must be from 1 to 1024 characters.
11818 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
11819 # the HttpRouteRuleMatch, retaining the remaining portion
11820 # of the URL before redirecting the request.
11821 #
11822 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
11823 # supplied, the path of the original request is used for the redirect.
11824 #
11825 # The value must be from 1 to 1024 characters.
11826 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
11827 #
11828 # Supported values are:
11829 #
11830 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
11831 # to 301.
11832 # - FOUND, which corresponds to 302.
11833 # - SEE_OTHER which corresponds to 303.
11834 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
11835 # method is retained.
11836 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
11837 # method is retained.
11838 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
11839 # URL is
11840 # removed before redirecting the request. If set to false, the
11841 # query portion of the original URL is retained.
11842 #
11843 # The default is set to false.
11844 },
11845 },
11846 ],
11847 },
11848 ],
11849 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the regional URL map resides.
11850 # This field is not applicable to global URL maps.
11851 # You must specify this field as part of the HTTP request URL. It is
11852 # not settable as a field in the request body.
11853 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
11854 &quot;status&quot;: { # [Output Only] The status of the URL map. # Output only. [Output Only] The status of the URL map.
11855 &quot;quotaUsage&quot;: { # Message representing the quota usage for a UrlMap. # Output only. Summary of quota usage for given UrlMap.
11856 &quot;forwardingRules&quot;: 42, # Output only. The number of forwarding rules that uses this UrlMap.
11857 &quot;units&quot;: &quot;A String&quot;, # Output only. The number of quota units calculated for this UrlMap.
11858 },
11859 },
11860 &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
11861 # maximum of 100 tests per UrlMap.
11862 #
11863 # Not supported when the URL map is bound to a target gRPC proxy that
11864 # has validateForProxyless field set to true.
11865 { # Message for the expected URL mappings.
11866 &quot;backendServiceWeight&quot;: 42, # The weight to use for the supplied host and path when using advanced
11867 # routing rules that involve traffic splitting.
11868 &quot;description&quot;: &quot;A String&quot;, # Description of this test case.
11869 &quot;expectedOutputUrl&quot;: &quot;A String&quot;, # The expected output URL evaluated by the load balancer
11870 # containing the scheme, host, path and query parameters.
11871 #
11872 # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
11873 # the load balancer to backends. For rules with urlRewrite,
11874 # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
11875 #
11876 # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer&#x27;s
11877 # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
11878 # If urlRedirect specifies strip_query, the test
11879 # passes only if expectedOutputUrl does not contain any query
11880 # parameters.
11881 #
11882 # expectedOutputUrl is optional whenservice is specified.
11883 &quot;expectedRedirectResponseCode&quot;: 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
11884 # load balancer&#x27;s redirect response.
11885 #
11886 # expectedRedirectResponseCode cannot be set whenservice is set.
11887 &quot;expectedUrlRedirect&quot;: &quot;A String&quot;, # The expected URL that should be redirected to for the host and path
11888 # being tested.
11889 # [Deprecated] This field is deprecated.
11890 # Use expected_output_url instead.
11891 &quot;headers&quot;: [ # HTTP headers for this request. If headers contains
11892 # a host header, then host must also match the header value.
11893 { # HTTP headers used in UrlMapTests.
11894 &quot;name&quot;: &quot;A String&quot;, # Header name.
11895 &quot;value&quot;: &quot;A String&quot;, # Header value.
11896 },
11897 ],
11898 &quot;host&quot;: &quot;A String&quot;, # Host portion of the URL. If headers contains a host header,
11899 # then host must also match the header value.
11900 &quot;path&quot;: &quot;A String&quot;, # Path portion of the URL.
11901 &quot;service&quot;: &quot;A String&quot;, # Expected BackendService or BackendBucket resource
11902 # the given URL should be mapped to.
11903 #
11904 # The service field cannot
11905 # be set if expectedRedirectResponseCode is set.
11906 },
11907 ],
11908 }
11909
11910 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
11911 that if you must retry your request, the server will know to ignore the
11912 request if it has already been completed.
11913
11914 For example, consider a situation where you make an initial request and
11915 the request times out. If you make the request again with the same
11916 request ID, the server can check if original operation with the same
11917 request ID was received, and if so, will ignore the second request. This
11918 prevents clients from accidentally creating duplicate commitments.
11919
11920 The request ID must be
11921 a valid UUID with the exception that zero UUID is not supported
11922 (00000000-0000-0000-0000-000000000000).
11923 x__xgafv: string, V1 error format.
11924 Allowed values
11925 1 - v1 error format
11926 2 - v2 error format
11927
11928 Returns:
11929 An object of the form:
11930
11931 { # Represents an Operation resource.
11932 #
11933 # Google Compute Engine has three Operation resources:
11934 #
11935 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
11936 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
11937 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
11938 #
11939 # You can use an operation resource to manage asynchronous API requests.
11940 # For more information, readHandling
11941 # API responses.
11942 #
11943 # Operations can be global, regional or zonal.
11944 #
11945 # - For global operations, use the `globalOperations`
11946 # resource.
11947 # - For regional operations, use the
11948 # `regionOperations` resource.
11949 # - For zonal operations, use
11950 # the `zoneOperations` resource.
11951 #
11952 #
11953 #
11954 # For more information, read
11955 # Global, Regional, and Zonal Resources.
11956 #
11957 # Note that completed Operation resources have a limited
11958 # retention period.
11959 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
11960 # Not present otherwise.
11961 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
11962 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
11963 # set when the operation is created.
11964 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
11965 # text format.
11966 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
11967 # this field will be populated.
11968 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
11969 # operation.
11970 {
11971 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
11972 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
11973 # details. There is a set of defined message types to use for providing
11974 # details.The syntax depends on the error code. For example,
11975 # QuotaExceededInfo will have details when the error code is
11976 # QUOTA_EXCEEDED.
11977 {
11978 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
11979 #
11980 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
11981 # is not enabled:
11982 #
11983 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
11984 # &quot;domain&quot;: &quot;googleapis.com&quot;
11985 # &quot;metadata&quot;: {
11986 # &quot;resource&quot;: &quot;projects/123&quot;,
11987 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
11988 # }
11989 # }
11990 #
11991 # This response indicates that the pubsub.googleapis.com API is not enabled.
11992 #
11993 # Example of an error that is returned when attempting to create a Spanner
11994 # instance in a region that is out of stock:
11995 #
11996 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
11997 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
11998 # &quot;metadata&quot;: {
11999 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
12000 # }
12001 # }
12002 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
12003 # is typically the registered service name of the tool or product that
12004 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
12005 # generated by some common infrastructure, the error domain must be a
12006 # globally unique value that identifies the infrastructure. For Google API
12007 # infrastructure, the error domain is &quot;googleapis.com&quot;.
12008 &quot;metadatas&quot;: { # Additional structured details about this error.
12009 #
12010 # Keys must match a regular expression of `a-z+` but should
12011 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
12012 # length. When identifying the current value of an exceeded limit, the units
12013 # should be contained in the key, not the value. For example, rather than
12014 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
12015 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
12016 # instances that can be created in a single (batch) request.
12017 &quot;a_key&quot;: &quot;A String&quot;,
12018 },
12019 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
12020 # proximate cause of the error. Error reasons are unique within a particular
12021 # domain of errors. This should be at most 63 characters and match a
12022 # regular expression of `A-Z+[A-Z0-9]`, which represents
12023 # UPPER_SNAKE_CASE.
12024 },
12025 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
12026 #
12027 # For example, if a quota check failed with an error indicating the calling
12028 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
12029 # directly to the right place in the developer console to flip the bit.
12030 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
12031 { # Describes a URL link.
12032 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
12033 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
12034 },
12035 ],
12036 },
12037 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
12038 # which can be attached to an RPC error.
12039 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
12040 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
12041 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
12042 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
12043 },
12044 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
12045 &quot;dimensions&quot;: { # The map holding related quota dimensions.
12046 &quot;a_key&quot;: &quot;A String&quot;,
12047 },
12048 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
12049 # type or metric.
12050 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
12051 # or metric.
12052 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
12053 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
12054 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
12055 },
12056 },
12057 ],
12058 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
12059 # This property is optional.
12060 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
12061 },
12062 ],
12063 },
12064 &quot;getVersionOperationMetadata&quot;: {
12065 &quot;inlineSbomInfo&quot;: {
12066 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
12067 # appropriate identifiers.
12068 &quot;a_key&quot;: &quot;A String&quot;,
12069 },
12070 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
12071 # identifiers.
12072 &quot;a_key&quot;: &quot;A String&quot;,
12073 },
12074 },
12075 },
12076 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
12077 # message that was returned, such as `NOT FOUND`.
12078 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
12079 # status code that was returned. For example, a `404` means the
12080 # resource was not found.
12081 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
12082 # defined by the server.
12083 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
12084 # This value is inRFC3339
12085 # text format.
12086 &quot;instancesBulkInsertOperationMetadata&quot;: {
12087 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
12088 # Example key: zones/us-central1-a
12089 &quot;a_key&quot;: {
12090 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
12091 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
12092 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
12093 # error.
12094 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
12095 # if the flow is rolling forward or rolling back.
12096 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
12097 },
12098 },
12099 },
12100 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
12101 # Operation resources.
12102 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
12103 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
12104 # group of operations results from a `bulkInsert` API request.
12105 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
12106 # `update`, or `delete`, and so on.
12107 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
12108 # There is no requirement that this be linear or support any granularity of
12109 # operations. This should not be used to guess when the operation will be
12110 # complete. This number should monotonically increase as the operation
12111 # progresses.
12112 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
12113 # applicable when performing regional operations.
12114 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
12115 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
12116 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
12117 # this field will contain information on all underlying zonal actions and
12118 # their state.
12119 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
12120 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
12121 # Example key: zones/us-central1-a
12122 &quot;a_key&quot;: {
12123 &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
12124 # populated.
12125 # different programming environments, including REST APIs and RPC APIs. It is
12126 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
12127 # three pieces of data: error code, error message, and error details.
12128 #
12129 # You can find out more about this error model and how to work with it in the
12130 # [API Design Guide](https://cloud.google.com/apis/design/errors).
12131 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
12132 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
12133 # message types for APIs to use.
12134 {
12135 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
12136 },
12137 ],
12138 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
12139 # user-facing error message should be localized and sent in the
12140 # google.rpc.Status.details field, or localized by the client.
12141 },
12142 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
12143 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
12144 },
12145 },
12146 },
12147 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
12148 # This value is inRFC3339
12149 # text format.
12150 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
12151 # following:
12152 # `PENDING`, `RUNNING`, or `DONE`.
12153 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
12154 # operation.
12155 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
12156 # of the target resource.
12157 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
12158 # operations related to creating a snapshot, this points to the disk
12159 # that the snapshot was created from.
12160 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
12161 # `[email protected]` or
12162 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
12163 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
12164 # operation, this field will be populated.
12165 {
12166 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
12167 # Engine returns NO_RESULTS_ON_PAGE if there
12168 # are no results in the response.
12169 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
12170 # value format. For example:
12171 #
12172 # &quot;data&quot;: [
12173 # {
12174 # &quot;key&quot;: &quot;scope&quot;,
12175 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
12176 # }
12177 {
12178 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
12179 # returned. For example, for warnings where there are no results in a list
12180 # request for a particular zone, this key might be scope and
12181 # the key value might be the zone name. Other examples might be a key
12182 # indicating a deprecated resource and a suggested replacement, or a
12183 # warning about invalid network settings (for example, if an instance
12184 # attempts to perform IP forwarding but is not enabled for IP forwarding).
12185 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
12186 },
12187 ],
12188 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
12189 },
12190 ],
12191 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
12192 # applicable when performing per-zone operations.
12193 }</pre>
12194 </div>
12195
12196 <div class="method">
12197 <code class="details" id="invalidateCache">invalidateCache(project, urlMap, body=None, requestId=None, x__xgafv=None)</code>
12198 <pre>Initiates a cache invalidation operation, invalidating the specified path,
12199 scoped to the specified UrlMap.
12200
12201 For more information, see [Invalidating cached
12202 content](/cdn/docs/invalidating-cached-content).
12203
12204 Args:
12205 project: string, Project ID for this request. (required)
12206 urlMap: string, Name of the UrlMap scoping this request. (required)
12207 body: object, The request body.
12208 The object takes the form of:
12209
12210 {
12211 &quot;backendService&quot;: &quot;A String&quot;, # If set, this invalidation rule will only apply to requests routed to the
12212 # given backend service or backend bucket.
12213 # For example, for a backend bucket `bb1` in the same scope as the URL map,
12214 # the path would be `projects/my-project/global/backendBuckets/bb1`; and
12215 # for a backend service `bs1` in the same scope as the URL map, the path
12216 # would be `projects/my-project/global/backendServices/bs1`.
12217 &quot;cacheTags&quot;: [ # A list of cache tags used to identify cached objects.
12218 #
12219 #
12220 # - Cache tags are specified when the response is first cached, by setting
12221 # the `Cache-Tag` response header at the origin.
12222 # - Multiple cache tags in the same invalidation request are treated as
12223 # Boolean `OR` - for example, `tag1 OR tag2 OR tag3`.
12224 # - If other fields are also specified, these are treated as Boolean `AND`
12225 # with any tags.
12226 #
12227 #
12228 # Up to 10 tags can be specified in a single invalidation request.
12229 &quot;A String&quot;,
12230 ],
12231 &quot;contentType&quot;: &quot;A String&quot;, # If set, this invalidation rule will only apply to responses with the given
12232 # content-type. Parameters are not allowed and are ignored from the response
12233 # when matching. Wildcards are not allowed.
12234 &quot;host&quot;: &quot;A String&quot;, # If set, this invalidation rule will only apply to requests with a Host
12235 # header matching host.
12236 &quot;httpStatus&quot;: 42, # If set, this invalidation rule will only apply to responses with the
12237 # given HTTP status. Valid range is 200-599.
12238 &quot;path&quot;: &quot;A String&quot;,
12239 }
12240
12241 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
12242 that if you must retry your request, the server will know to ignore the
12243 request if it has already been completed.
12244
12245 For example, consider a situation where you make an initial request and
12246 the request times out. If you make the request again with the same
12247 request ID, the server can check if original operation with the same
12248 request ID was received, and if so, will ignore the second request. This
12249 prevents clients from accidentally creating duplicate commitments.
12250
12251 The request ID must be
12252 a valid UUID with the exception that zero UUID is not supported
12253 (00000000-0000-0000-0000-000000000000).
12254 x__xgafv: string, V1 error format.
12255 Allowed values
12256 1 - v1 error format
12257 2 - v2 error format
12258
12259 Returns:
12260 An object of the form:
12261
12262 { # Represents an Operation resource.
12263 #
12264 # Google Compute Engine has three Operation resources:
12265 #
12266 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
12267 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
12268 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
12269 #
12270 # You can use an operation resource to manage asynchronous API requests.
12271 # For more information, readHandling
12272 # API responses.
12273 #
12274 # Operations can be global, regional or zonal.
12275 #
12276 # - For global operations, use the `globalOperations`
12277 # resource.
12278 # - For regional operations, use the
12279 # `regionOperations` resource.
12280 # - For zonal operations, use
12281 # the `zoneOperations` resource.
12282 #
12283 #
12284 #
12285 # For more information, read
12286 # Global, Regional, and Zonal Resources.
12287 #
12288 # Note that completed Operation resources have a limited
12289 # retention period.
12290 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
12291 # Not present otherwise.
12292 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
12293 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
12294 # set when the operation is created.
12295 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
12296 # text format.
12297 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
12298 # this field will be populated.
12299 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
12300 # operation.
12301 {
12302 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
12303 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
12304 # details. There is a set of defined message types to use for providing
12305 # details.The syntax depends on the error code. For example,
12306 # QuotaExceededInfo will have details when the error code is
12307 # QUOTA_EXCEEDED.
12308 {
12309 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
12310 #
12311 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
12312 # is not enabled:
12313 #
12314 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
12315 # &quot;domain&quot;: &quot;googleapis.com&quot;
12316 # &quot;metadata&quot;: {
12317 # &quot;resource&quot;: &quot;projects/123&quot;,
12318 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
12319 # }
12320 # }
12321 #
12322 # This response indicates that the pubsub.googleapis.com API is not enabled.
12323 #
12324 # Example of an error that is returned when attempting to create a Spanner
12325 # instance in a region that is out of stock:
12326 #
12327 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
12328 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
12329 # &quot;metadata&quot;: {
12330 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
12331 # }
12332 # }
12333 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
12334 # is typically the registered service name of the tool or product that
12335 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
12336 # generated by some common infrastructure, the error domain must be a
12337 # globally unique value that identifies the infrastructure. For Google API
12338 # infrastructure, the error domain is &quot;googleapis.com&quot;.
12339 &quot;metadatas&quot;: { # Additional structured details about this error.
12340 #
12341 # Keys must match a regular expression of `a-z+` but should
12342 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
12343 # length. When identifying the current value of an exceeded limit, the units
12344 # should be contained in the key, not the value. For example, rather than
12345 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
12346 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
12347 # instances that can be created in a single (batch) request.
12348 &quot;a_key&quot;: &quot;A String&quot;,
12349 },
12350 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
12351 # proximate cause of the error. Error reasons are unique within a particular
12352 # domain of errors. This should be at most 63 characters and match a
12353 # regular expression of `A-Z+[A-Z0-9]`, which represents
12354 # UPPER_SNAKE_CASE.
12355 },
12356 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
12357 #
12358 # For example, if a quota check failed with an error indicating the calling
12359 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
12360 # directly to the right place in the developer console to flip the bit.
12361 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
12362 { # Describes a URL link.
12363 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
12364 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
12365 },
12366 ],
12367 },
12368 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
12369 # which can be attached to an RPC error.
12370 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
12371 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
12372 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
12373 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
12374 },
12375 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
12376 &quot;dimensions&quot;: { # The map holding related quota dimensions.
12377 &quot;a_key&quot;: &quot;A String&quot;,
12378 },
12379 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
12380 # type or metric.
12381 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
12382 # or metric.
12383 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
12384 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
12385 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
12386 },
12387 },
12388 ],
12389 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
12390 # This property is optional.
12391 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
12392 },
12393 ],
12394 },
12395 &quot;getVersionOperationMetadata&quot;: {
12396 &quot;inlineSbomInfo&quot;: {
12397 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
12398 # appropriate identifiers.
12399 &quot;a_key&quot;: &quot;A String&quot;,
12400 },
12401 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
12402 # identifiers.
12403 &quot;a_key&quot;: &quot;A String&quot;,
12404 },
12405 },
12406 },
12407 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
12408 # message that was returned, such as `NOT FOUND`.
12409 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
12410 # status code that was returned. For example, a `404` means the
12411 # resource was not found.
12412 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
12413 # defined by the server.
12414 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
12415 # This value is inRFC3339
12416 # text format.
12417 &quot;instancesBulkInsertOperationMetadata&quot;: {
12418 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
12419 # Example key: zones/us-central1-a
12420 &quot;a_key&quot;: {
12421 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
12422 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
12423 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
12424 # error.
12425 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
12426 # if the flow is rolling forward or rolling back.
12427 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
12428 },
12429 },
12430 },
12431 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
12432 # Operation resources.
12433 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
12434 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
12435 # group of operations results from a `bulkInsert` API request.
12436 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
12437 # `update`, or `delete`, and so on.
12438 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
12439 # There is no requirement that this be linear or support any granularity of
12440 # operations. This should not be used to guess when the operation will be
12441 # complete. This number should monotonically increase as the operation
12442 # progresses.
12443 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
12444 # applicable when performing regional operations.
12445 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
12446 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
12447 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
12448 # this field will contain information on all underlying zonal actions and
12449 # their state.
12450 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
12451 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
12452 # Example key: zones/us-central1-a
12453 &quot;a_key&quot;: {
12454 &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
12455 # populated.
12456 # different programming environments, including REST APIs and RPC APIs. It is
12457 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
12458 # three pieces of data: error code, error message, and error details.
12459 #
12460 # You can find out more about this error model and how to work with it in the
12461 # [API Design Guide](https://cloud.google.com/apis/design/errors).
12462 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
12463 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
12464 # message types for APIs to use.
12465 {
12466 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
12467 },
12468 ],
12469 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
12470 # user-facing error message should be localized and sent in the
12471 # google.rpc.Status.details field, or localized by the client.
12472 },
12473 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
12474 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
12475 },
12476 },
12477 },
12478 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
12479 # This value is inRFC3339
12480 # text format.
12481 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
12482 # following:
12483 # `PENDING`, `RUNNING`, or `DONE`.
12484 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
12485 # operation.
12486 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
12487 # of the target resource.
12488 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
12489 # operations related to creating a snapshot, this points to the disk
12490 # that the snapshot was created from.
12491 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
12492 # `[email protected]` or
12493 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
12494 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
12495 # operation, this field will be populated.
12496 {
12497 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
12498 # Engine returns NO_RESULTS_ON_PAGE if there
12499 # are no results in the response.
12500 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
12501 # value format. For example:
12502 #
12503 # &quot;data&quot;: [
12504 # {
12505 # &quot;key&quot;: &quot;scope&quot;,
12506 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
12507 # }
12508 {
12509 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
12510 # returned. For example, for warnings where there are no results in a list
12511 # request for a particular zone, this key might be scope and
12512 # the key value might be the zone name. Other examples might be a key
12513 # indicating a deprecated resource and a suggested replacement, or a
12514 # warning about invalid network settings (for example, if an instance
12515 # attempts to perform IP forwarding but is not enabled for IP forwarding).
12516 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
12517 },
12518 ],
12519 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
12520 },
12521 ],
12522 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
12523 # applicable when performing per-zone operations.
12524 }</pre>
12525 </div>
12526
12527 <div class="method">
12528 <code class="details" id="list">list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</code>
12529 <pre>Retrieves the list of UrlMap resources available to the specified
12530 project.
12531
12532 Args:
12533 project: string, Project ID for this request. (required)
12534 filter: string, A filter expression that filters resources listed in the response. Most
12535 Compute resources support two types of filter expressions:
12536 expressions that support regular expressions and expressions that follow
12537 API improvement proposal AIP-160.
12538 These two types of filter expressions cannot be mixed in one request.
12539
12540 If you want to use AIP-160, your expression must specify the field name, an
12541 operator, and the value that you want to use for filtering. The value
12542 must be a string, a number, or a boolean. The operator
12543 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
12544
12545 For example, if you are filtering Compute Engine instances, you can
12546 exclude instances named `example-instance` by specifying
12547 `name != example-instance`.
12548
12549 The `:*` comparison can be used to test whether a key has been defined.
12550 For example, to find all objects with `owner` label use:
12551 ```
12552 labels.owner:*
12553 ```
12554
12555 You can also filter nested fields. For example, you could specify
12556 `scheduling.automaticRestart = false` to include instances only
12557 if they are not scheduled for automatic restarts. You can use filtering
12558 on nested fields to filter based onresource labels.
12559
12560 To filter on multiple expressions, provide each separate expression within
12561 parentheses. For example:
12562 ```
12563 (scheduling.automaticRestart = true)
12564 (cpuPlatform = &quot;Intel Skylake&quot;)
12565 ```
12566 By default, each expression is an `AND` expression. However, you
12567 can include `AND` and `OR` expressions explicitly.
12568 For example:
12569 ```
12570 (cpuPlatform = &quot;Intel Skylake&quot;) OR
12571 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
12572 (scheduling.automaticRestart = true)
12573 ```
12574
12575 If you want to use a regular expression, use the `eq` (equal) or `ne`
12576 (not equal) operator against a single un-parenthesized expression with or
12577 without quotes or against multiple parenthesized expressions. Examples:
12578
12579 `fieldname eq unquoted literal`
12580 `fieldname eq &#x27;single quoted literal&#x27;`
12581 `fieldname eq &quot;double quoted literal&quot;`
12582 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
12583
12584 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
12585 The literal value must match the entire field.
12586
12587 For example, to filter for instances that do not end with name &quot;instance&quot;,
12588 you would use `name ne .*instance`.
12589
12590 You cannot combine constraints on multiple fields using regular
12591 expressions.
12592 maxResults: integer, The maximum number of results per page that should be returned.
12593 If the number of available results is larger than `maxResults`,
12594 Compute Engine returns a `nextPageToken` that can be used to get
12595 the next page of results in subsequent list requests. Acceptable values are
12596 `0` to `500`, inclusive. (Default: `500`)
12597 orderBy: string, Sorts list results by a certain order. By default, results
12598 are returned in alphanumerical order based on the resource name.
12599
12600 You can also sort results in descending order based on the creation
12601 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
12602 results based on the `creationTimestamp` field in
12603 reverse chronological order (newest result first). Use this to sort
12604 resources like operations so that the newest operation is returned first.
12605
12606 Currently, only sorting by `name` or
12607 `creationTimestamp desc` is supported.
12608 pageToken: string, Specifies a page token to use. Set `pageToken` to the
12609 `nextPageToken` returned by a previous list request to get
12610 the next page of results.
12611 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
12612 of failure. The default value is false.
12613
12614 For example, when partial success behavior is enabled, aggregatedList for a
12615 single zone scope either returns all resources in the zone or no resources,
12616 with an error code.
12617 x__xgafv: string, V1 error format.
12618 Allowed values
12619 1 - v1 error format
12620 2 - v2 error format
12621
12622 Returns:
12623 An object of the form:
12624
12625 { # Contains a list of UrlMap resources.
12626 &quot;id&quot;: &quot;A String&quot;, # [Output Only] Unique identifier for the resource; defined by the server.
12627 &quot;items&quot;: [ # A list of UrlMap resources.
12628 { # Represents a URL Map resource.
12629 #
12630 # Compute Engine has two URL Map resources:
12631 #
12632 # * [Global](/compute/docs/reference/rest/alpha/urlMaps)
12633 # * [Regional](/compute/docs/reference/rest/alpha/regionUrlMaps)
12634 #
12635 # A URL map resource is a component of certain types of cloud load balancers
12636 # and Traffic Director:
12637 #
12638 # * urlMaps are used by global external Application Load
12639 # Balancers, classic Application Load Balancers, and cross-region internal
12640 # Application Load Balancers.
12641 # * regionUrlMaps are used by internal Application Load Balancers,
12642 # regional external Application Load Balancers and regional internal
12643 # Application Load Balancers.
12644 #
12645 # For a list of supported URL map features by the load balancer type, see the
12646 # Load balancing features: Routing and traffic management table.
12647 #
12648 # For a list of supported URL map features for Traffic Director, see the
12649 # Traffic Director features: Routing and traffic management table.
12650 #
12651 # This resource defines mappings from hostnames and URL paths to either a
12652 # backend service or a backend bucket.
12653 #
12654 # To use the global urlMaps resource, the backend service must
12655 # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
12656 # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
12657 # information, read URL
12658 # Map Concepts.
12659 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
12660 # text format.
12661 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
12662 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
12663 #
12664 # This policy takes
12665 # effect at the load balancer level and applies only when no policy has been
12666 # defined for the error code at lower levels like PathMatcher, RouteRule and
12667 # PathRule within this UrlMap.
12668 #
12669 # For example, consider a UrlMap with the
12670 # following configuration:
12671 #
12672 #
12673 # - defaultCustomErrorResponsePolicy containing policies for
12674 # responding to 5xx and 4xx errors
12675 # - A PathMatcher configured for *.example.com has
12676 # defaultCustomErrorResponsePolicy for 4xx.
12677 #
12678 # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
12679 # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
12680 # a request that does not match any host in *.example.com such
12681 # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
12682 # takes effect.
12683 #
12684 # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
12685 # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
12686 # a retry, if load balancer is successful in reaching the
12687 # service, the defaultCustomErrorResponsePolicy is ignored and
12688 # the response from the service is returned to the client.
12689 #
12690 # defaultCustomErrorResponsePolicy is supported only for
12691 # global external Application Load Balancers.
12692 # backend service or backend bucket responds with an error.
12693 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
12694 #
12695 # In a given policy, if you specify rules for both a range of error codes
12696 # as well as rules for specific error codes then rules with specific error
12697 # codes have a higher priority. For example, assume that you configure a rule
12698 # for 401 (Un-authorized) code, and another for all 4 series
12699 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
12700 # However if the backend service returns a 403, the rule for4xx takes effect.
12701 { # Specifies the mapping between the response code that will be returned along
12702 # with the custom error content and the response code returned by the backend
12703 # service.
12704 &quot;matchResponseCodes&quot;: [ # Valid values include:
12705 #
12706 #
12707 # - A number between 400 and 599: For example
12708 # 401 or 503, in which case the load balancer
12709 # applies the policy if the error code exactly matches this value.
12710 # - 5xx: Load Balancer will apply the policy if the
12711 # backend service responds with any response code in the range of
12712 # 500 to 599.
12713 # - 4xx: Load
12714 # Balancer will apply the policy if the backend service responds with any
12715 # response code in the range of 400 to
12716 # 499.
12717 #
12718 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
12719 &quot;A String&quot;,
12720 ],
12721 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
12722 # error content. If overrideResponseCode is not supplied, the
12723 # same response code returned by the original backend bucket or backend
12724 # service is returned to the client.
12725 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
12726 #
12727 # path must start
12728 # with a leading slash. path cannot have trailing slashes.
12729 #
12730 # If the file is not available in backendBucket or the
12731 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
12732 #
12733 # The value must
12734 # be from 1 to 1024 characters
12735 },
12736 ],
12737 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
12738 # contains the custom error content. Examples are:
12739 #
12740 #
12741 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
12742 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
12743 # - global/backendBuckets/myBackendBucket
12744 #
12745 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
12746 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
12747 #
12748 # If load balancer cannot reach
12749 # the backendBucket, a simple Not Found Error will
12750 # be returned, with the original response code (oroverrideResponseCode if configured).
12751 #
12752 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
12753 },
12754 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
12755 # hostRules match. The load balancer performs advanced routing
12756 # actions, such as URL rewrites and header transformations, before forwarding
12757 # the request to the selected backend.
12758 #
12759 #
12760 # Only one of defaultUrlRedirect, defaultService
12761 # or defaultRouteAction.weightedBackendService can be set.
12762 #
12763 #
12764 # URL maps for classic Application Load Balancers only support
12765 # the urlRewrite action within defaultRouteAction.
12766 #
12767 #
12768 # defaultRouteAction has no effect when the URL map is bound
12769 # to a target gRPC proxy that has the validateForProxyless field
12770 # set to true.
12771 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
12772 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
12773 # property must be specified. This policy cannot be specified if any target
12774 # backend has Identity-Aware Proxy enabled.
12775 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
12776 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
12777 # header names can be specified. The cache is bypassed for all `cacheMode`
12778 # values.
12779 &quot;A String&quot;,
12780 ],
12781 &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
12782 # on the backend type: for Backend Services, the complete request URI is
12783 # used; for Backend Buckets, the request URI is used without the protocol or
12784 # host, and only query parameters known to Cloud Storage are included.
12785 # Policy defined on Route Action.
12786 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
12787 # parameters will be included. Either specify `excludedQueryParameters`
12788 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
12789 # encoded and not treated as delimiters.
12790 #
12791 # Note: This field applies to routes that use backend services. Attempting
12792 # to set it on a route that points exclusively to Backend Buckets will
12793 # result in a configuration error. For routes that point to a Backend
12794 # Bucket, use `includedQueryParameters` to define which parameters should
12795 # be part of the cache key.
12796 &quot;A String&quot;,
12797 ],
12798 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
12799 #
12800 # Note: This setting is only applicable to routes that use a Backend
12801 # Service. It does not affect requests served by a Backend Bucket, as the
12802 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
12803 # it on a route that points exclusively to Backend Buckets will result in a
12804 # configuration error.
12805 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
12806 #
12807 # Note: This setting is only applicable to routes that use a Backend
12808 # Service. It does not affect requests served by a Backend Bucket, as the
12809 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
12810 # set on a route that points exclusively to Backend Buckets will result in
12811 # a configuration error.
12812 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
12813 # `includedQueryParameters` and `excludedQueryParameters`. If neither
12814 # is set, the entire query string will be included. If false, the query
12815 # string will be excluded from the cache key entirely.
12816 #
12817 # Note: This field applies to routes that use backend services. Attempting
12818 # to set it on a route that points exclusively to Backend Buckets will
12819 # result in a configuration error. For routes that point to a Backend
12820 # Bucket, use `includedQueryParameters` to define which parameters should
12821 # be part of the cache key.
12822 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
12823 # The name=value pair will be used in the cache key Cloud CDN generates.
12824 #
12825 # Note: This setting is only applicable to routes that use a Backend
12826 # Service. It does not affect requests served by a Backend Bucket.
12827 # Attempting to set it on a route that points exclusively to Backend
12828 # Buckets will result in a configuration error. Up to 5 cookie names can be
12829 # specified.
12830 &quot;A String&quot;,
12831 ],
12832 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
12833 &quot;A String&quot;,
12834 ],
12835 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
12836 # parameters will be excluded. Either specify `includedQueryParameters`
12837 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
12838 # encoded and not treated as delimiters.
12839 &quot;A String&quot;,
12840 ],
12841 },
12842 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
12843 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
12844 &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
12845 # content. This is used to clamp the max-age (or Expires) value sent to the
12846 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
12847 # is used for the response max-age directive, along with a &quot;public&quot;
12848 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
12849 # clamps the max-age from the origin (if specified), or else sets the
12850 # response max-age directive to the lesser of the `clientTtl` and
12851 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
12852 # present. The maximum allowed value is 31,622,400s (1 year). If not
12853 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
12854 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
12855 # `USE_ORIGIN_HEADERS`.
12856 # as a count of seconds and fractions of seconds at nanosecond
12857 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12858 # or &quot;month&quot;. Range is approximately 10,000 years.
12859 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12860 # Durations less than one second are represented with a 0
12861 # `seconds` field and a positive `nanos` field. Must be from 0
12862 # to 999,999,999 inclusive.
12863 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12864 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12865 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12866 },
12867 &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
12868 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
12869 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
12870 # greater than that of `maxTtl`. When the `cacheMode` is set to
12871 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
12872 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
12873 # accessed objects may be evicted from the cache before the defined TTL. If
12874 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
12875 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
12876 # `USE_ORIGIN_HEADERS`.
12877 # as a count of seconds and fractions of seconds at nanosecond
12878 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12879 # or &quot;month&quot;. Range is approximately 10,000 years.
12880 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12881 # Durations less than one second are represented with a 0
12882 # `seconds` field and a positive `nanos` field. Must be from 0
12883 # to 999,999,999 inclusive.
12884 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12885 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12886 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12887 },
12888 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
12889 # attempt to set a max-age or s-maxage higher than this, or an Expires header
12890 # more than `maxTtl` seconds in the future will be capped at the value of
12891 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
12892 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
12893 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
12894 # Infrequently accessed objects may be evicted from the cache before the
12895 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
12896 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
12897 # mode.
12898 # as a count of seconds and fractions of seconds at nanosecond
12899 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12900 # or &quot;month&quot;. Range is approximately 10,000 years.
12901 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12902 # Durations less than one second are represented with a 0
12903 # `seconds` field and a positive `nanos` field. Must be from 0
12904 # to 999,999,999 inclusive.
12905 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12906 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12907 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12908 },
12909 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
12910 # to apply fine-grained caching for common errors or redirects.
12911 # This can reduce the load on your origin and improve end-user
12912 # experience by reducing response latency.
12913 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
12914 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
12915 # the specified response code that lack any Cache-Control, Expires, or
12916 # Pragma: no-cache directives. When the `cacheMode` is set to
12917 # `FORCE_CACHE_ALL`, negative caching applies to all responses
12918 # with the specified response code, and overrides any caching headers. By
12919 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
12920 #
12921 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
12922 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
12923 # * 405 (Method Not Found), 501 (Not Implemented): 60s
12924 #
12925 # These defaults can be overridden in `negativeCachingPolicy`.
12926 # If not specified, Cloud CDN applies negative caching by default.
12927 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
12928 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
12929 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
12930 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
12931 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
12932 # all response codes that you wish to cache. Cloud CDN will not apply any
12933 # default negative caching when a policy exists.
12934 { # Specify CDN TTLs for response error codes.
12935 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
12936 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
12937 # specified as values, and you cannot specify a status code more than
12938 # once.
12939 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
12940 # corresponding status code.
12941 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
12942 # objects may be evicted from the cache before the defined TTL.
12943 # as a count of seconds and fractions of seconds at nanosecond
12944 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12945 # or &quot;month&quot;. Range is approximately 10,000 years.
12946 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12947 # Durations less than one second are represented with a 0
12948 # `seconds` field and a positive `nanos` field. Must be from 0
12949 # to 999,999,999 inclusive.
12950 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12951 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12952 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12953 },
12954 },
12955 ],
12956 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
12957 # requests into a small number of requests to the origin. If not specified,
12958 # Cloud CDN applies request coalescing by default.
12959 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
12960 # content with the origin, or when an error is encountered when refreshing
12961 # the cache.
12962 # This setting defines the default &quot;max-stale&quot; duration for any cached
12963 # responses that do not specify a max-stale directive. Stale responses that
12964 # exceed the TTL configured here will not be served. The default limit
12965 # (max-stale) is 86400s (1 day), which will allow stale content to be
12966 # served up to this limit beyond the max-age (or s-maxage) of a cached
12967 # response.
12968 # The maximum allowed value is 604800 (1 week).
12969 # Set this to zero (0) to disable serve-while-stale.
12970 # as a count of seconds and fractions of seconds at nanosecond
12971 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12972 # or &quot;month&quot;. Range is approximately 10,000 years.
12973 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12974 # Durations less than one second are represented with a 0
12975 # `seconds` field and a positive `nanos` field. Must be from 0
12976 # to 999,999,999 inclusive.
12977 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12978 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12979 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12980 },
12981 },
12982 &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
12983 # information about the W3C recommendation for cross-origin resource sharing
12984 # (CORS), see Fetch API Living
12985 # Standard.
12986 #
12987 # Not supported when the URL map is bound to a target gRPC proxy.
12988 # information about the W3C recommendation for cross-origin resource sharing
12989 # (CORS), see Fetch API Living
12990 # Standard.
12991 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
12992 # indicates that
12993 # the actual request can include user credentials. This field translates to
12994 # the Access-Control-Allow-Credentials header.
12995 #
12996 # Default is false.
12997 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
12998 # header.
12999 &quot;A String&quot;,
13000 ],
13001 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
13002 # header.
13003 &quot;A String&quot;,
13004 ],
13005 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
13006 # more information, see regular expression syntax.
13007 #
13008 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
13009 #
13010 # Regular expressions can only be used when the loadBalancingScheme is
13011 # set to INTERNAL_SELF_MANAGED.
13012 &quot;A String&quot;,
13013 ],
13014 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
13015 #
13016 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
13017 &quot;A String&quot;,
13018 ],
13019 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
13020 # The default value is false, which indicates that the CORS
13021 # policy is in effect.
13022 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
13023 # header.
13024 &quot;A String&quot;,
13025 ],
13026 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
13027 # seconds. This field translates to the Access-Control-Max-Age
13028 # header.
13029 },
13030 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
13031 # the resiliency of clients to backend service failure. As part of fault
13032 # injection, when clients send requests to a backend service, delays can be
13033 # introduced by a load balancer on a percentage of requests before sending
13034 # those requests to the backend service. Similarly requests from clients can
13035 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
13036 # that are configured with a fault_injection_policy if:
13037 # 1. The traffic is generated by fault injection AND
13038 # 2. The fault injection is not a delay fault injection.
13039 # Fault injection is not supported with the classic Application Load Balancer
13040 # . To see which load balancers support fault injection,
13041 # see Load
13042 # balancing: Routing and traffic management features.
13043 # the resiliency of clients to backend service failure. As part of fault
13044 # injection, when clients send requests to a backend service, delays can be
13045 # introduced by the load balancer on a percentage of requests before sending
13046 # those request to the backend service. Similarly requests from clients can be
13047 # aborted by the load balancer for a percentage of requests.
13048 &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
13049 # injection.
13050 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
13051 #
13052 # The value must be from 200 to 599 inclusive.
13053 #
13054 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
13055 # according to this
13056 # mapping table. HTTP status 200 is mapped to gRPC status
13057 # UNKNOWN. Injecting an OK status is currently not supported by
13058 # Traffic Director.
13059 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
13060 # that is aborted as part of fault injection.
13061 #
13062 # The value must be from 0.0 to 100.0 inclusive.
13063 },
13064 &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
13065 # injection, before being sent to a backend service.
13066 # request to the backend service as part of fault injection.
13067 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
13068 # as a count of seconds and fractions of seconds at nanosecond
13069 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13070 # or &quot;month&quot;. Range is approximately 10,000 years.
13071 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13072 # Durations less than one second are represented with a 0
13073 # `seconds` field and a positive `nanos` field. Must be from 0
13074 # to 999,999,999 inclusive.
13075 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13076 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13077 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13078 },
13079 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
13080 # which a delay is introduced as part of fault injection.
13081 #
13082 # The value must be from 0.0 to 100.0 inclusive.
13083 },
13084 },
13085 &quot;imageOptimizationPolicy&quot;: { # The configuration for Cloud CDN&#x27;s image optimization feature. This feature # Image optimization policy for this URL Map&#x27;s route. Available only for
13086 # Global EXTERNAL_MANAGED load balancer schemes.
13087 # Either Cloud CDN must be enabled on the backend service or backend bucket
13088 # serving the route, or cache policy must be configured on the same route
13089 # dynamically processes and delivers images from the network edge.
13090 # Image Optimization is only available for Global External Application Load
13091 # Balancers.
13092 # Either Cloud CDN must be enabled on the backend service or backend bucket
13093 # serving the route, or cache policy must be configured on the same route.
13094 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
13095 },
13096 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
13097 # Unlike the timeout field where the timeout duration starts
13098 # from the time the request has been fully processed (known as*end-of-stream*),
13099 # the duration in this field is computed from the beginning of the stream
13100 # until the response has been processed, including all retries. A
13101 # stream that does not complete in this duration is closed.
13102 #
13103 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
13104 # with the route.
13105 #
13106 # This field is only allowed if the Url map is used with backend services
13107 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
13108 # as a count of seconds and fractions of seconds at nanosecond
13109 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13110 # or &quot;month&quot;. Range is approximately 10,000 years.
13111 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13112 # Durations less than one second are represented with a 0
13113 # `seconds` field and a positive `nanos` field. Must be from 0
13114 # to 999,999,999 inclusive.
13115 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13116 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13117 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13118 },
13119 &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
13120 # are shadowed to a separate mirrored backend service. The load balancer does
13121 # not wait for responses from the shadow service. Before sending traffic
13122 # to the shadow service, the host / authority header is suffixed with-shadow.
13123 #
13124 # Not supported when the URL map is bound to a target gRPC proxy that
13125 # has the validateForProxyless field set to true.
13126 # are shadowed to a separate mirrored backend service. The load balancer
13127 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
13128 # to the shadow service, the host or authority header is suffixed with-shadow.
13129 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
13130 # mirrored to.
13131 #
13132 # The backend service configured for a mirroring
13133 # policy must reference backends that are of the same type as the original
13134 # backend service matched in the URL map.
13135 #
13136 # Serverless NEG backends are not currently supported as a mirrored
13137 # backend service.
13138 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
13139 },
13140 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
13141 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
13142 # If not specified, defaults to 1.
13143 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
13144 #
13145 # If not specified, will use the timeout set in theHttpRouteAction field.
13146 # If timeout in the HttpRouteAction field is not set, this field
13147 # uses the largest timeout
13148 # among all backend services associated with the route.
13149 #
13150 # Not supported when the URL map is bound to a target gRPC proxy that
13151 # has the validateForProxyless field set to true.
13152 # as a count of seconds and fractions of seconds at nanosecond
13153 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13154 # or &quot;month&quot;. Range is approximately 10,000 years.
13155 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13156 # Durations less than one second are represented with a 0
13157 # `seconds` field and a positive `nanos` field. Must be from 0
13158 # to 999,999,999 inclusive.
13159 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13160 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13161 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13162 },
13163 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
13164 # values are:
13165 #
13166 # - 5xx: retry is attempted if the instance or endpoint
13167 # responds with any 5xx response code, or if the instance or
13168 # endpoint does not respond at all. For example, disconnects, reset, read
13169 # timeout, connection failure, and refused streams.
13170 # - gateway-error: Similar to 5xx, but only
13171 # applies to response codes 502, 503 or504.
13172 # - connect-failure: a retry is attempted on failures
13173 # connecting to the instance or endpoint. For example, connection
13174 # timeouts.
13175 # - retriable-4xx: a retry is attempted if the instance
13176 # or endpoint responds with a 4xx response code.
13177 # The only error that you can retry is error code 409.
13178 # - refused-stream: a retry is attempted if the instance
13179 # or endpoint resets the stream with a REFUSED_STREAM error
13180 # code. This reset type indicates that it is safe to retry.
13181 # - cancelled: a retry is attempted if the gRPC status
13182 # code in the response header is set to cancelled.
13183 # - deadline-exceeded: a retry is attempted if the gRPC
13184 # status code in the response header is set todeadline-exceeded.
13185 # - internal: a retry is attempted if the gRPC
13186 # status code in the response header is set tointernal.
13187 # - resource-exhausted: a retry is attempted if the gRPC
13188 # status code in the response header is set toresource-exhausted.
13189 # - unavailable: a retry is attempted if the gRPC
13190 # status code in the response header is set tounavailable.
13191 #
13192 # Only the following codes are supported when the URL map is bound to
13193 # target gRPC proxy that has validateForProxyless field set to true.
13194 #
13195 # - cancelled
13196 # - deadline-exceeded
13197 # - internal
13198 # - resource-exhausted
13199 # - unavailable
13200 &quot;A String&quot;,
13201 ],
13202 },
13203 &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
13204 # time the request has been fully processed (known as *end-of-stream*)
13205 # up until the response has been processed. Timeout includes
13206 # all retries.
13207 #
13208 # If not specified, this field uses the largest timeout among all backend
13209 # services associated with the route.
13210 #
13211 # Not supported when the URL map is bound to a target gRPC proxy that
13212 # has validateForProxyless field set to true.
13213 # as a count of seconds and fractions of seconds at nanosecond
13214 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13215 # or &quot;month&quot;. Range is approximately 10,000 years.
13216 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13217 # Durations less than one second are represented with a 0
13218 # `seconds` field and a positive `nanos` field. Must be from 0
13219 # to 999,999,999 inclusive.
13220 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13221 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13222 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13223 },
13224 &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
13225 # to the matched service.
13226 #
13227 # urlRewrite is the only action supported in UrlMaps
13228 # for classic Application Load Balancers.
13229 #
13230 # Not supported when the URL map is bound to a target gRPC proxy that
13231 # has the validateForProxyless field set to true.
13232 # backend service.
13233 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
13234 # host header is replaced with contents of hostRewrite.
13235 #
13236 # The value must be from 1 to 255 characters.
13237 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
13238 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
13239 #
13240 # The value must be from 1 to 1024 characters.
13241 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
13242 # header) using the HTTP template syntax.
13243 #
13244 # A corresponding
13245 # path_template_match must be specified. Any template variables must exist in
13246 # the path_template_match field.
13247 #
13248 #
13249 # - -At least one variable must be specified in the path_template_match
13250 # field
13251 # - You can omit variables from the rewritten URL
13252 # - The * and ** operators cannot be matched
13253 # unless they have a corresponding variable name - e.g.
13254 # {format=*} or {var=**}.
13255 #
13256 # For example, a path_template_match of /static/{format=**}
13257 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
13258 # rewrite, so that /{country}/{format}/{suffix=**} can be
13259 # rewritten as /content/{format}/{country}/{suffix}.
13260 #
13261 # At least
13262 # one non-empty routeRules[].matchRules[].path_template_match is
13263 # required.
13264 #
13265 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
13266 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
13267 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
13268 # It uses RE2 syntax with the following constraints:
13269 #
13270 #
13271 # - Any single character operators
13272 # - Groups are allowed to have only submatch operator inside
13273 # - Groups are allowed only without any char repetition, e.g.
13274 # .*
13275 # - Any char repetition, e.g. .*, is
13276 # only allowed to be used in a single regex together with:
13277 #
13278 #
13279 # - Empty string operators
13280 # - Other repetitions
13281 # - Ranges
13282 # - Repetitions of ranges
13283 #
13284 #
13285 # - Ranges are only allowed to have:
13286 #
13287 #
13288 # - Character range
13289 # - Digits range
13290 # - Symbols listed in characters allowed for ranges
13291 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
13292 # the path.
13293 },
13294 },
13295 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
13296 # occurs. The weights determine the fraction of traffic that flows to
13297 # their corresponding backend service. If all traffic needs to
13298 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
13299 #
13300 # After a backend service is identified and before forwarding
13301 # the request to
13302 # the backend service, advanced routing actions such as URL rewrites and
13303 # header transformations are applied depending on additional settings
13304 # specified in this HttpRouteAction.
13305 { # In contrast to a single BackendService in
13306 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
13307 # multiple backend services. The volume of traffic for each
13308 # backend service is proportional to the weight specified
13309 # in each WeightedBackendService
13310 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
13311 # resource. Before
13312 # forwarding the request to backendService, the load balancer
13313 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
13314 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
13315 # effect for the selected backendService.
13316 #
13317 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
13318 #
13319 # headerAction is not supported for load balancers that have
13320 # their loadBalancingScheme set to EXTERNAL.
13321 #
13322 # Not supported when the URL map is bound to a target gRPC proxy that
13323 # has validateForProxyless field set to true.
13324 # the request is passed along to the selected backendService.
13325 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
13326 { # Specification determining how headers are added to requests or responses.
13327 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
13328 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
13329 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
13330 # that already
13331 # exist for the header. If true, headerValue is set for the
13332 # header, discarding any values that were set for that header.
13333 #
13334 # The default value is true,
13335 # unless a variable is present in headerValue,
13336 # in which case the default value is false.
13337 # .
13338 },
13339 ],
13340 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
13341 # request before forwarding the request to the backendService.
13342 &quot;A String&quot;,
13343 ],
13344 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
13345 # client.
13346 { # Specification determining how headers are added to requests or responses.
13347 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
13348 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
13349 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
13350 # that already
13351 # exist for the header. If true, headerValue is set for the
13352 # header, discarding any values that were set for that header.
13353 #
13354 # The default value is true,
13355 # unless a variable is present in headerValue,
13356 # in which case the default value is false.
13357 # .
13358 },
13359 ],
13360 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
13361 # response before sending the response back to the client.
13362 &quot;A String&quot;,
13363 ],
13364 },
13365 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
13366 # computed asweight / (sum of all weightedBackendService weights in routeAction).
13367 #
13368 # The selection of a backend service is determined only for new traffic.
13369 # Once a user&#x27;s request has been directed to a backend service,
13370 # subsequent requests are sent to the same backend service as
13371 # determined by the backend service&#x27;s session affinity policy.
13372 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
13373 # splitting. If you do, the weighted traffic splitting configuration takes
13374 # precedence.
13375 #
13376 # The value must be from 0 to 1000.
13377 },
13378 ],
13379 },
13380 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL of the defaultService resource to
13381 # which traffic is directed if none of the hostRules match.
13382 # If defaultRouteAction is also specified, advanced
13383 # routing actions, such as URL rewrites, take effect before sending the
13384 # request to the backend.
13385 #
13386 #
13387 # Only one of defaultUrlRedirect, defaultService
13388 # or defaultRouteAction.weightedBackendService can be set.
13389 #
13390 #
13391 # defaultService has no effect when the URL map is bound
13392 # to a target gRPC proxy that has the validateForProxyless field
13393 # set to true.
13394 &quot;defaultUrlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
13395 # is redirected to a URL specified by defaultUrlRedirect.
13396 #
13397 #
13398 # Only one of defaultUrlRedirect, defaultService
13399 # or defaultRouteAction.weightedBackendService can be set.
13400 #
13401 #
13402 # Not supported when the URL map is bound to a target gRPC proxy.
13403 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
13404 # was supplied in the request.
13405 #
13406 # The value must be from 1 to 255
13407 # characters.
13408 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
13409 # set to HTTPS.
13410 # If set to false, the URL scheme of the redirected request
13411 # remains the same as that of the request.
13412 #
13413 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
13414 #
13415 # The default is set to false.
13416 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
13417 # that was supplied in the request.
13418 #
13419 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
13420 # supplied, the path of the original request is used for the redirect.
13421 #
13422 # The value must be from 1 to 1024 characters.
13423 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
13424 # the HttpRouteRuleMatch, retaining the remaining portion
13425 # of the URL before redirecting the request.
13426 #
13427 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
13428 # supplied, the path of the original request is used for the redirect.
13429 #
13430 # The value must be from 1 to 1024 characters.
13431 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
13432 #
13433 # Supported values are:
13434 #
13435 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
13436 # to 301.
13437 # - FOUND, which corresponds to 302.
13438 # - SEE_OTHER which corresponds to 303.
13439 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
13440 # method is retained.
13441 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
13442 # method is retained.
13443 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
13444 # URL is
13445 # removed before redirecting the request. If set to false, the
13446 # query portion of the original URL is retained.
13447 #
13448 # The default is set to false.
13449 },
13450 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
13451 # create the resource.
13452 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. A hash of the contents stored in this object.
13453 # This field is used in optimistic locking. This field is ignored when
13454 # inserting a UrlMap. An up-to-date fingerprint must be provided
13455 # in order to update the UrlMap, otherwise the request will
13456 # fail with error 412 conditionNotMet.
13457 #
13458 # To see the latest fingerprint, make a get() request to
13459 # retrieve a UrlMap.
13460 &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
13461 # for the selected backendService.
13462 #
13463 # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
13464 #
13465 # headerAction is not supported for load balancers
13466 # that have
13467 # their loadBalancingScheme set to EXTERNAL.
13468 #
13469 # Not supported when the URL map is bound to a target gRPC proxy that
13470 # has validateForProxyless field set to true.
13471 # the request is passed along to the selected backendService.
13472 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
13473 { # Specification determining how headers are added to requests or responses.
13474 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
13475 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
13476 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
13477 # that already
13478 # exist for the header. If true, headerValue is set for the
13479 # header, discarding any values that were set for that header.
13480 #
13481 # The default value is true,
13482 # unless a variable is present in headerValue,
13483 # in which case the default value is false.
13484 # .
13485 },
13486 ],
13487 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
13488 # request before forwarding the request to the backendService.
13489 &quot;A String&quot;,
13490 ],
13491 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
13492 # client.
13493 { # Specification determining how headers are added to requests or responses.
13494 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
13495 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
13496 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
13497 # that already
13498 # exist for the header. If true, headerValue is set for the
13499 # header, discarding any values that were set for that header.
13500 #
13501 # The default value is true,
13502 # unless a variable is present in headerValue,
13503 # in which case the default value is false.
13504 # .
13505 },
13506 ],
13507 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
13508 # response before sending the response back to the client.
13509 &quot;A String&quot;,
13510 ],
13511 },
13512 &quot;hostRules&quot;: [ # The list of host rules to use against the URL.
13513 { # UrlMaps
13514 # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
13515 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
13516 # create the resource.
13517 &quot;hosts&quot;: [ # The list of host patterns to match. They must be valid hostnames with
13518 # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
13519 # that case, * must be the first character, and if followed by
13520 # anything, the immediate following character must be either -
13521 # or ..
13522 #
13523 # * based matching is not supported when the URL map is bound
13524 # to a target gRPC proxy that has the validateForProxyless field
13525 # set to true.
13526 &quot;A String&quot;,
13527 ],
13528 &quot;pathMatcher&quot;: &quot;A String&quot;, # The name of the PathMatcher to use to match the path portion
13529 # of the URL if the hostRule matches the URL&#x27;s host portion.
13530 },
13531 ],
13532 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the resource. This identifier is
13533 # defined by the server.
13534 &quot;kind&quot;: &quot;compute#urlMap&quot;, # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
13535 # url maps.
13536 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
13537 # The name must be 1-63 characters long, and comply withRFC1035.
13538 # Specifically, the name must be 1-63 characters long and match the regular
13539 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
13540 # character must be a lowercase letter, and all following characters must
13541 # be a dash, lowercase letter, or digit, except the last character, which
13542 # cannot be a dash.
13543 &quot;pathMatchers&quot;: [ # The list of named PathMatchers to use against the URL.
13544 { # A matcher for the path portion of the URL. The BackendService
13545 # from the longest-matched rule will serve the URL. If no rule was matched, the
13546 # default service is used.
13547 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
13548 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
13549 #
13550 # This policy takes
13551 # effect at the PathMatcher level and applies only when no
13552 # 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
13553 # in defaultCustomErrorResponsePolicy, then a policy defined for
13554 # the error code in UrlMap.defaultCustomErrorResponsePolicy
13555 # takes effect.
13556 #
13557 # For example, consider a UrlMap with the following
13558 # configuration:
13559 #
13560 #
13561 # - UrlMap.defaultCustomErrorResponsePolicy is configured
13562 # with policies for 5xx and 4xx errors
13563 # - A RouteRule for /coming_soon/ is configured for the
13564 # error code 404.
13565 #
13566 # 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
13567 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
13568 # the policy in RouteRule.customErrorResponsePolicy takes
13569 # effect. If any of the requests in this example encounter a 500
13570 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
13571 #
13572 # When
13573 # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
13574 # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
13575 # a retry, if load balancer is successful in reaching the
13576 # service, the defaultCustomErrorResponsePolicy is ignored and
13577 # the response from the service is returned to the client.
13578 #
13579 # defaultCustomErrorResponsePolicy is supported only for
13580 # global external Application Load Balancers.
13581 # backend service or backend bucket responds with an error.
13582 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
13583 #
13584 # In a given policy, if you specify rules for both a range of error codes
13585 # as well as rules for specific error codes then rules with specific error
13586 # codes have a higher priority. For example, assume that you configure a rule
13587 # for 401 (Un-authorized) code, and another for all 4 series
13588 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
13589 # However if the backend service returns a 403, the rule for4xx takes effect.
13590 { # Specifies the mapping between the response code that will be returned along
13591 # with the custom error content and the response code returned by the backend
13592 # service.
13593 &quot;matchResponseCodes&quot;: [ # Valid values include:
13594 #
13595 #
13596 # - A number between 400 and 599: For example
13597 # 401 or 503, in which case the load balancer
13598 # applies the policy if the error code exactly matches this value.
13599 # - 5xx: Load Balancer will apply the policy if the
13600 # backend service responds with any response code in the range of
13601 # 500 to 599.
13602 # - 4xx: Load
13603 # Balancer will apply the policy if the backend service responds with any
13604 # response code in the range of 400 to
13605 # 499.
13606 #
13607 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
13608 &quot;A String&quot;,
13609 ],
13610 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
13611 # error content. If overrideResponseCode is not supplied, the
13612 # same response code returned by the original backend bucket or backend
13613 # service is returned to the client.
13614 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
13615 #
13616 # path must start
13617 # with a leading slash. path cannot have trailing slashes.
13618 #
13619 # If the file is not available in backendBucket or the
13620 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
13621 #
13622 # The value must
13623 # be from 1 to 1024 characters
13624 },
13625 ],
13626 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
13627 # contains the custom error content. Examples are:
13628 #
13629 #
13630 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
13631 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
13632 # - global/backendBuckets/myBackendBucket
13633 #
13634 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
13635 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
13636 #
13637 # If load balancer cannot reach
13638 # the backendBucket, a simple Not Found Error will
13639 # be returned, with the original response code (oroverrideResponseCode if configured).
13640 #
13641 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
13642 },
13643 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
13644 # pathRules or routeRules match. The load balancer
13645 # performs advanced routing actions, such as URL rewrites and
13646 # header transformations, before forwarding the request to the
13647 # selected backend.
13648 #
13649 #
13650 # Only one of defaultUrlRedirect, defaultService
13651 # or defaultRouteAction.weightedBackendService can be set.
13652 #
13653 #
13654 # URL maps for classic Application Load Balancers only support
13655 # the urlRewrite action within a path matcher&#x27;sdefaultRouteAction.
13656 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
13657 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
13658 # property must be specified. This policy cannot be specified if any target
13659 # backend has Identity-Aware Proxy enabled.
13660 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
13661 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
13662 # header names can be specified. The cache is bypassed for all `cacheMode`
13663 # values.
13664 &quot;A String&quot;,
13665 ],
13666 &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
13667 # on the backend type: for Backend Services, the complete request URI is
13668 # used; for Backend Buckets, the request URI is used without the protocol or
13669 # host, and only query parameters known to Cloud Storage are included.
13670 # Policy defined on Route Action.
13671 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
13672 # parameters will be included. Either specify `excludedQueryParameters`
13673 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
13674 # encoded and not treated as delimiters.
13675 #
13676 # Note: This field applies to routes that use backend services. Attempting
13677 # to set it on a route that points exclusively to Backend Buckets will
13678 # result in a configuration error. For routes that point to a Backend
13679 # Bucket, use `includedQueryParameters` to define which parameters should
13680 # be part of the cache key.
13681 &quot;A String&quot;,
13682 ],
13683 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
13684 #
13685 # Note: This setting is only applicable to routes that use a Backend
13686 # Service. It does not affect requests served by a Backend Bucket, as the
13687 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
13688 # it on a route that points exclusively to Backend Buckets will result in a
13689 # configuration error.
13690 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
13691 #
13692 # Note: This setting is only applicable to routes that use a Backend
13693 # Service. It does not affect requests served by a Backend Bucket, as the
13694 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
13695 # set on a route that points exclusively to Backend Buckets will result in
13696 # a configuration error.
13697 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
13698 # `includedQueryParameters` and `excludedQueryParameters`. If neither
13699 # is set, the entire query string will be included. If false, the query
13700 # string will be excluded from the cache key entirely.
13701 #
13702 # Note: This field applies to routes that use backend services. Attempting
13703 # to set it on a route that points exclusively to Backend Buckets will
13704 # result in a configuration error. For routes that point to a Backend
13705 # Bucket, use `includedQueryParameters` to define which parameters should
13706 # be part of the cache key.
13707 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
13708 # The name=value pair will be used in the cache key Cloud CDN generates.
13709 #
13710 # Note: This setting is only applicable to routes that use a Backend
13711 # Service. It does not affect requests served by a Backend Bucket.
13712 # Attempting to set it on a route that points exclusively to Backend
13713 # Buckets will result in a configuration error. Up to 5 cookie names can be
13714 # specified.
13715 &quot;A String&quot;,
13716 ],
13717 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
13718 &quot;A String&quot;,
13719 ],
13720 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
13721 # parameters will be excluded. Either specify `includedQueryParameters`
13722 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
13723 # encoded and not treated as delimiters.
13724 &quot;A String&quot;,
13725 ],
13726 },
13727 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
13728 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
13729 &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
13730 # content. This is used to clamp the max-age (or Expires) value sent to the
13731 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
13732 # is used for the response max-age directive, along with a &quot;public&quot;
13733 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
13734 # clamps the max-age from the origin (if specified), or else sets the
13735 # response max-age directive to the lesser of the `clientTtl` and
13736 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
13737 # present. The maximum allowed value is 31,622,400s (1 year). If not
13738 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
13739 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
13740 # `USE_ORIGIN_HEADERS`.
13741 # as a count of seconds and fractions of seconds at nanosecond
13742 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13743 # or &quot;month&quot;. Range is approximately 10,000 years.
13744 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13745 # Durations less than one second are represented with a 0
13746 # `seconds` field and a positive `nanos` field. Must be from 0
13747 # to 999,999,999 inclusive.
13748 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13749 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13750 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13751 },
13752 &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
13753 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
13754 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
13755 # greater than that of `maxTtl`. When the `cacheMode` is set to
13756 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
13757 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
13758 # accessed objects may be evicted from the cache before the defined TTL. If
13759 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
13760 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
13761 # `USE_ORIGIN_HEADERS`.
13762 # as a count of seconds and fractions of seconds at nanosecond
13763 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13764 # or &quot;month&quot;. Range is approximately 10,000 years.
13765 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13766 # Durations less than one second are represented with a 0
13767 # `seconds` field and a positive `nanos` field. Must be from 0
13768 # to 999,999,999 inclusive.
13769 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13770 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13771 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13772 },
13773 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
13774 # attempt to set a max-age or s-maxage higher than this, or an Expires header
13775 # more than `maxTtl` seconds in the future will be capped at the value of
13776 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
13777 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
13778 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
13779 # Infrequently accessed objects may be evicted from the cache before the
13780 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
13781 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
13782 # mode.
13783 # as a count of seconds and fractions of seconds at nanosecond
13784 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13785 # or &quot;month&quot;. Range is approximately 10,000 years.
13786 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13787 # Durations less than one second are represented with a 0
13788 # `seconds` field and a positive `nanos` field. Must be from 0
13789 # to 999,999,999 inclusive.
13790 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13791 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13792 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13793 },
13794 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
13795 # to apply fine-grained caching for common errors or redirects.
13796 # This can reduce the load on your origin and improve end-user
13797 # experience by reducing response latency.
13798 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
13799 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
13800 # the specified response code that lack any Cache-Control, Expires, or
13801 # Pragma: no-cache directives. When the `cacheMode` is set to
13802 # `FORCE_CACHE_ALL`, negative caching applies to all responses
13803 # with the specified response code, and overrides any caching headers. By
13804 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
13805 #
13806 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
13807 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
13808 # * 405 (Method Not Found), 501 (Not Implemented): 60s
13809 #
13810 # These defaults can be overridden in `negativeCachingPolicy`.
13811 # If not specified, Cloud CDN applies negative caching by default.
13812 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
13813 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
13814 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
13815 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
13816 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
13817 # all response codes that you wish to cache. Cloud CDN will not apply any
13818 # default negative caching when a policy exists.
13819 { # Specify CDN TTLs for response error codes.
13820 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
13821 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
13822 # specified as values, and you cannot specify a status code more than
13823 # once.
13824 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
13825 # corresponding status code.
13826 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
13827 # objects may be evicted from the cache before the defined TTL.
13828 # as a count of seconds and fractions of seconds at nanosecond
13829 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13830 # or &quot;month&quot;. Range is approximately 10,000 years.
13831 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13832 # Durations less than one second are represented with a 0
13833 # `seconds` field and a positive `nanos` field. Must be from 0
13834 # to 999,999,999 inclusive.
13835 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13836 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13837 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13838 },
13839 },
13840 ],
13841 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
13842 # requests into a small number of requests to the origin. If not specified,
13843 # Cloud CDN applies request coalescing by default.
13844 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
13845 # content with the origin, or when an error is encountered when refreshing
13846 # the cache.
13847 # This setting defines the default &quot;max-stale&quot; duration for any cached
13848 # responses that do not specify a max-stale directive. Stale responses that
13849 # exceed the TTL configured here will not be served. The default limit
13850 # (max-stale) is 86400s (1 day), which will allow stale content to be
13851 # served up to this limit beyond the max-age (or s-maxage) of a cached
13852 # response.
13853 # The maximum allowed value is 604800 (1 week).
13854 # Set this to zero (0) to disable serve-while-stale.
13855 # as a count of seconds and fractions of seconds at nanosecond
13856 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13857 # or &quot;month&quot;. Range is approximately 10,000 years.
13858 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13859 # Durations less than one second are represented with a 0
13860 # `seconds` field and a positive `nanos` field. Must be from 0
13861 # to 999,999,999 inclusive.
13862 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13863 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13864 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13865 },
13866 },
13867 &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
13868 # information about the W3C recommendation for cross-origin resource sharing
13869 # (CORS), see Fetch API Living
13870 # Standard.
13871 #
13872 # Not supported when the URL map is bound to a target gRPC proxy.
13873 # information about the W3C recommendation for cross-origin resource sharing
13874 # (CORS), see Fetch API Living
13875 # Standard.
13876 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
13877 # indicates that
13878 # the actual request can include user credentials. This field translates to
13879 # the Access-Control-Allow-Credentials header.
13880 #
13881 # Default is false.
13882 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
13883 # header.
13884 &quot;A String&quot;,
13885 ],
13886 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
13887 # header.
13888 &quot;A String&quot;,
13889 ],
13890 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
13891 # more information, see regular expression syntax.
13892 #
13893 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
13894 #
13895 # Regular expressions can only be used when the loadBalancingScheme is
13896 # set to INTERNAL_SELF_MANAGED.
13897 &quot;A String&quot;,
13898 ],
13899 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
13900 #
13901 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
13902 &quot;A String&quot;,
13903 ],
13904 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
13905 # The default value is false, which indicates that the CORS
13906 # policy is in effect.
13907 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
13908 # header.
13909 &quot;A String&quot;,
13910 ],
13911 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
13912 # seconds. This field translates to the Access-Control-Max-Age
13913 # header.
13914 },
13915 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
13916 # the resiliency of clients to backend service failure. As part of fault
13917 # injection, when clients send requests to a backend service, delays can be
13918 # introduced by a load balancer on a percentage of requests before sending
13919 # those requests to the backend service. Similarly requests from clients can
13920 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
13921 # that are configured with a fault_injection_policy if:
13922 # 1. The traffic is generated by fault injection AND
13923 # 2. The fault injection is not a delay fault injection.
13924 # Fault injection is not supported with the classic Application Load Balancer
13925 # . To see which load balancers support fault injection,
13926 # see Load
13927 # balancing: Routing and traffic management features.
13928 # the resiliency of clients to backend service failure. As part of fault
13929 # injection, when clients send requests to a backend service, delays can be
13930 # introduced by the load balancer on a percentage of requests before sending
13931 # those request to the backend service. Similarly requests from clients can be
13932 # aborted by the load balancer for a percentage of requests.
13933 &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
13934 # injection.
13935 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
13936 #
13937 # The value must be from 200 to 599 inclusive.
13938 #
13939 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
13940 # according to this
13941 # mapping table. HTTP status 200 is mapped to gRPC status
13942 # UNKNOWN. Injecting an OK status is currently not supported by
13943 # Traffic Director.
13944 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
13945 # that is aborted as part of fault injection.
13946 #
13947 # The value must be from 0.0 to 100.0 inclusive.
13948 },
13949 &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
13950 # injection, before being sent to a backend service.
13951 # request to the backend service as part of fault injection.
13952 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
13953 # as a count of seconds and fractions of seconds at nanosecond
13954 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13955 # or &quot;month&quot;. Range is approximately 10,000 years.
13956 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13957 # Durations less than one second are represented with a 0
13958 # `seconds` field and a positive `nanos` field. Must be from 0
13959 # to 999,999,999 inclusive.
13960 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13961 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13962 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13963 },
13964 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
13965 # which a delay is introduced as part of fault injection.
13966 #
13967 # The value must be from 0.0 to 100.0 inclusive.
13968 },
13969 },
13970 &quot;imageOptimizationPolicy&quot;: { # The configuration for Cloud CDN&#x27;s image optimization feature. This feature # Image optimization policy for this URL Map&#x27;s route. Available only for
13971 # Global EXTERNAL_MANAGED load balancer schemes.
13972 # Either Cloud CDN must be enabled on the backend service or backend bucket
13973 # serving the route, or cache policy must be configured on the same route
13974 # dynamically processes and delivers images from the network edge.
13975 # Image Optimization is only available for Global External Application Load
13976 # Balancers.
13977 # Either Cloud CDN must be enabled on the backend service or backend bucket
13978 # serving the route, or cache policy must be configured on the same route.
13979 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
13980 },
13981 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
13982 # Unlike the timeout field where the timeout duration starts
13983 # from the time the request has been fully processed (known as*end-of-stream*),
13984 # the duration in this field is computed from the beginning of the stream
13985 # until the response has been processed, including all retries. A
13986 # stream that does not complete in this duration is closed.
13987 #
13988 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
13989 # with the route.
13990 #
13991 # This field is only allowed if the Url map is used with backend services
13992 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
13993 # as a count of seconds and fractions of seconds at nanosecond
13994 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13995 # or &quot;month&quot;. Range is approximately 10,000 years.
13996 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13997 # Durations less than one second are represented with a 0
13998 # `seconds` field and a positive `nanos` field. Must be from 0
13999 # to 999,999,999 inclusive.
14000 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14001 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14002 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14003 },
14004 &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
14005 # are shadowed to a separate mirrored backend service. The load balancer does
14006 # not wait for responses from the shadow service. Before sending traffic
14007 # to the shadow service, the host / authority header is suffixed with-shadow.
14008 #
14009 # Not supported when the URL map is bound to a target gRPC proxy that
14010 # has the validateForProxyless field set to true.
14011 # are shadowed to a separate mirrored backend service. The load balancer
14012 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
14013 # to the shadow service, the host or authority header is suffixed with-shadow.
14014 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
14015 # mirrored to.
14016 #
14017 # The backend service configured for a mirroring
14018 # policy must reference backends that are of the same type as the original
14019 # backend service matched in the URL map.
14020 #
14021 # Serverless NEG backends are not currently supported as a mirrored
14022 # backend service.
14023 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
14024 },
14025 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
14026 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
14027 # If not specified, defaults to 1.
14028 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
14029 #
14030 # If not specified, will use the timeout set in theHttpRouteAction field.
14031 # If timeout in the HttpRouteAction field is not set, this field
14032 # uses the largest timeout
14033 # among all backend services associated with the route.
14034 #
14035 # Not supported when the URL map is bound to a target gRPC proxy that
14036 # has the validateForProxyless field set to true.
14037 # as a count of seconds and fractions of seconds at nanosecond
14038 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14039 # or &quot;month&quot;. Range is approximately 10,000 years.
14040 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14041 # Durations less than one second are represented with a 0
14042 # `seconds` field and a positive `nanos` field. Must be from 0
14043 # to 999,999,999 inclusive.
14044 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14045 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14046 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14047 },
14048 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
14049 # values are:
14050 #
14051 # - 5xx: retry is attempted if the instance or endpoint
14052 # responds with any 5xx response code, or if the instance or
14053 # endpoint does not respond at all. For example, disconnects, reset, read
14054 # timeout, connection failure, and refused streams.
14055 # - gateway-error: Similar to 5xx, but only
14056 # applies to response codes 502, 503 or504.
14057 # - connect-failure: a retry is attempted on failures
14058 # connecting to the instance or endpoint. For example, connection
14059 # timeouts.
14060 # - retriable-4xx: a retry is attempted if the instance
14061 # or endpoint responds with a 4xx response code.
14062 # The only error that you can retry is error code 409.
14063 # - refused-stream: a retry is attempted if the instance
14064 # or endpoint resets the stream with a REFUSED_STREAM error
14065 # code. This reset type indicates that it is safe to retry.
14066 # - cancelled: a retry is attempted if the gRPC status
14067 # code in the response header is set to cancelled.
14068 # - deadline-exceeded: a retry is attempted if the gRPC
14069 # status code in the response header is set todeadline-exceeded.
14070 # - internal: a retry is attempted if the gRPC
14071 # status code in the response header is set tointernal.
14072 # - resource-exhausted: a retry is attempted if the gRPC
14073 # status code in the response header is set toresource-exhausted.
14074 # - unavailable: a retry is attempted if the gRPC
14075 # status code in the response header is set tounavailable.
14076 #
14077 # Only the following codes are supported when the URL map is bound to
14078 # target gRPC proxy that has validateForProxyless field set to true.
14079 #
14080 # - cancelled
14081 # - deadline-exceeded
14082 # - internal
14083 # - resource-exhausted
14084 # - unavailable
14085 &quot;A String&quot;,
14086 ],
14087 },
14088 &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
14089 # time the request has been fully processed (known as *end-of-stream*)
14090 # up until the response has been processed. Timeout includes
14091 # all retries.
14092 #
14093 # If not specified, this field uses the largest timeout among all backend
14094 # services associated with the route.
14095 #
14096 # Not supported when the URL map is bound to a target gRPC proxy that
14097 # has validateForProxyless field set to true.
14098 # as a count of seconds and fractions of seconds at nanosecond
14099 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14100 # or &quot;month&quot;. Range is approximately 10,000 years.
14101 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14102 # Durations less than one second are represented with a 0
14103 # `seconds` field and a positive `nanos` field. Must be from 0
14104 # to 999,999,999 inclusive.
14105 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14106 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14107 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14108 },
14109 &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
14110 # to the matched service.
14111 #
14112 # urlRewrite is the only action supported in UrlMaps
14113 # for classic Application Load Balancers.
14114 #
14115 # Not supported when the URL map is bound to a target gRPC proxy that
14116 # has the validateForProxyless field set to true.
14117 # backend service.
14118 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
14119 # host header is replaced with contents of hostRewrite.
14120 #
14121 # The value must be from 1 to 255 characters.
14122 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
14123 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
14124 #
14125 # The value must be from 1 to 1024 characters.
14126 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
14127 # header) using the HTTP template syntax.
14128 #
14129 # A corresponding
14130 # path_template_match must be specified. Any template variables must exist in
14131 # the path_template_match field.
14132 #
14133 #
14134 # - -At least one variable must be specified in the path_template_match
14135 # field
14136 # - You can omit variables from the rewritten URL
14137 # - The * and ** operators cannot be matched
14138 # unless they have a corresponding variable name - e.g.
14139 # {format=*} or {var=**}.
14140 #
14141 # For example, a path_template_match of /static/{format=**}
14142 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
14143 # rewrite, so that /{country}/{format}/{suffix=**} can be
14144 # rewritten as /content/{format}/{country}/{suffix}.
14145 #
14146 # At least
14147 # one non-empty routeRules[].matchRules[].path_template_match is
14148 # required.
14149 #
14150 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
14151 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
14152 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
14153 # It uses RE2 syntax with the following constraints:
14154 #
14155 #
14156 # - Any single character operators
14157 # - Groups are allowed to have only submatch operator inside
14158 # - Groups are allowed only without any char repetition, e.g.
14159 # .*
14160 # - Any char repetition, e.g. .*, is
14161 # only allowed to be used in a single regex together with:
14162 #
14163 #
14164 # - Empty string operators
14165 # - Other repetitions
14166 # - Ranges
14167 # - Repetitions of ranges
14168 #
14169 #
14170 # - Ranges are only allowed to have:
14171 #
14172 #
14173 # - Character range
14174 # - Digits range
14175 # - Symbols listed in characters allowed for ranges
14176 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
14177 # the path.
14178 },
14179 },
14180 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
14181 # occurs. The weights determine the fraction of traffic that flows to
14182 # their corresponding backend service. If all traffic needs to
14183 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
14184 #
14185 # After a backend service is identified and before forwarding
14186 # the request to
14187 # the backend service, advanced routing actions such as URL rewrites and
14188 # header transformations are applied depending on additional settings
14189 # specified in this HttpRouteAction.
14190 { # In contrast to a single BackendService in
14191 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
14192 # multiple backend services. The volume of traffic for each
14193 # backend service is proportional to the weight specified
14194 # in each WeightedBackendService
14195 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
14196 # resource. Before
14197 # forwarding the request to backendService, the load balancer
14198 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
14199 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
14200 # effect for the selected backendService.
14201 #
14202 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
14203 #
14204 # headerAction is not supported for load balancers that have
14205 # their loadBalancingScheme set to EXTERNAL.
14206 #
14207 # Not supported when the URL map is bound to a target gRPC proxy that
14208 # has validateForProxyless field set to true.
14209 # the request is passed along to the selected backendService.
14210 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
14211 { # Specification determining how headers are added to requests or responses.
14212 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
14213 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
14214 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
14215 # that already
14216 # exist for the header. If true, headerValue is set for the
14217 # header, discarding any values that were set for that header.
14218 #
14219 # The default value is true,
14220 # unless a variable is present in headerValue,
14221 # in which case the default value is false.
14222 # .
14223 },
14224 ],
14225 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
14226 # request before forwarding the request to the backendService.
14227 &quot;A String&quot;,
14228 ],
14229 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
14230 # client.
14231 { # Specification determining how headers are added to requests or responses.
14232 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
14233 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
14234 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
14235 # that already
14236 # exist for the header. If true, headerValue is set for the
14237 # header, discarding any values that were set for that header.
14238 #
14239 # The default value is true,
14240 # unless a variable is present in headerValue,
14241 # in which case the default value is false.
14242 # .
14243 },
14244 ],
14245 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
14246 # response before sending the response back to the client.
14247 &quot;A String&quot;,
14248 ],
14249 },
14250 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
14251 # computed asweight / (sum of all weightedBackendService weights in routeAction).
14252 #
14253 # The selection of a backend service is determined only for new traffic.
14254 # Once a user&#x27;s request has been directed to a backend service,
14255 # subsequent requests are sent to the same backend service as
14256 # determined by the backend service&#x27;s session affinity policy.
14257 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
14258 # splitting. If you do, the weighted traffic splitting configuration takes
14259 # precedence.
14260 #
14261 # The value must be from 0 to 1000.
14262 },
14263 ],
14264 },
14265 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource. This
14266 # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
14267 # matched. For example, the
14268 # following are all valid URLs to a BackendService resource:
14269 #
14270 #
14271 # - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
14272 # - compute/v1/projects/project/global/backendServices/backendService
14273 # - global/backendServices/backendService
14274 #
14275 #
14276 # If defaultRouteAction is also specified, advanced
14277 # routing actions, such as URL rewrites, take effect before sending the
14278 # request to the backend.
14279 #
14280 #
14281 # Only one of defaultUrlRedirect, defaultService
14282 # or defaultRouteAction.weightedBackendService can be set.
14283 #
14284 #
14285 # Authorization requires one or more of the following Google IAM permissions on the
14286 # specified resource default_service:
14287 #
14288 #
14289 # - compute.backendBuckets.use
14290 # - compute.backendServices.use
14291 &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
14292 # by defaultUrlRedirect.
14293 #
14294 #
14295 # Only one of defaultUrlRedirect, defaultService
14296 # or defaultRouteAction.weightedBackendService can be set.
14297 #
14298 #
14299 # Not supported when the URL map is bound to a target gRPC proxy.
14300 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
14301 # was supplied in the request.
14302 #
14303 # The value must be from 1 to 255
14304 # characters.
14305 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
14306 # set to HTTPS.
14307 # If set to false, the URL scheme of the redirected request
14308 # remains the same as that of the request.
14309 #
14310 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
14311 #
14312 # The default is set to false.
14313 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
14314 # that was supplied in the request.
14315 #
14316 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
14317 # supplied, the path of the original request is used for the redirect.
14318 #
14319 # The value must be from 1 to 1024 characters.
14320 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
14321 # the HttpRouteRuleMatch, retaining the remaining portion
14322 # of the URL before redirecting the request.
14323 #
14324 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
14325 # supplied, the path of the original request is used for the redirect.
14326 #
14327 # The value must be from 1 to 1024 characters.
14328 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
14329 #
14330 # Supported values are:
14331 #
14332 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
14333 # to 301.
14334 # - FOUND, which corresponds to 302.
14335 # - SEE_OTHER which corresponds to 303.
14336 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
14337 # method is retained.
14338 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
14339 # method is retained.
14340 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
14341 # URL is
14342 # removed before redirecting the request. If set to false, the
14343 # query portion of the original URL is retained.
14344 #
14345 # The default is set to false.
14346 },
14347 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
14348 # create the resource.
14349 &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
14350 # for the selected backend service.
14351 #
14352 # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
14353 #
14354 # HeaderAction is not supported for load balancers
14355 # that have
14356 # their loadBalancingScheme set to EXTERNAL.
14357 #
14358 # Not supported when the URL map is bound to a target gRPC proxy that
14359 # has validateForProxyless field set to true.
14360 # the request is passed along to the selected backendService.
14361 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
14362 { # Specification determining how headers are added to requests or responses.
14363 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
14364 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
14365 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
14366 # that already
14367 # exist for the header. If true, headerValue is set for the
14368 # header, discarding any values that were set for that header.
14369 #
14370 # The default value is true,
14371 # unless a variable is present in headerValue,
14372 # in which case the default value is false.
14373 # .
14374 },
14375 ],
14376 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
14377 # request before forwarding the request to the backendService.
14378 &quot;A String&quot;,
14379 ],
14380 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
14381 # client.
14382 { # Specification determining how headers are added to requests or responses.
14383 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
14384 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
14385 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
14386 # that already
14387 # exist for the header. If true, headerValue is set for the
14388 # header, discarding any values that were set for that header.
14389 #
14390 # The default value is true,
14391 # unless a variable is present in headerValue,
14392 # in which case the default value is false.
14393 # .
14394 },
14395 ],
14396 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
14397 # response before sending the response back to the client.
14398 &quot;A String&quot;,
14399 ],
14400 },
14401 &quot;name&quot;: &quot;A String&quot;, # The name to which this PathMatcher is referred by theHostRule.
14402 &quot;pathRules&quot;: [ # The list of path rules. Use this list instead of routeRules
14403 # when routing based on simple path matching is all that&#x27;s required. A path
14404 # rule can only include a wildcard character (*) after a
14405 # forward slash character (&quot;/&quot;).
14406 #
14407 # The order by which path rules are specified does not matter.
14408 # Matches are always done on the longest-path-first basis.
14409 #
14410 # For example: a pathRule with a path /a/b/c/* will match
14411 # before /a/b/* irrespective of the order in which those paths appear in this
14412 # list.
14413 #
14414 # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
14415 { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
14416 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
14417 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
14418 #
14419 # If a policy for an
14420 # error code is not configured for the PathRule, a policy for
14421 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
14422 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
14423 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
14424 # effect.
14425 #
14426 # For example, consider a UrlMap with the following configuration:
14427 #
14428 #
14429 # - UrlMap.defaultCustomErrorResponsePolicy are configured
14430 # with policies for 5xx and 4xx errors
14431 # - A PathRule for /coming_soon/ is configured for the error
14432 # code 404.
14433 #
14434 # 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
14435 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
14436 # the policy in PathRule.customErrorResponsePolicy takes
14437 # effect. If any of the requests in this example encounter a 500
14438 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
14439 #
14440 # customErrorResponsePolicy is supported only for
14441 # global external Application Load Balancers.
14442 # backend service or backend bucket responds with an error.
14443 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
14444 #
14445 # In a given policy, if you specify rules for both a range of error codes
14446 # as well as rules for specific error codes then rules with specific error
14447 # codes have a higher priority. For example, assume that you configure a rule
14448 # for 401 (Un-authorized) code, and another for all 4 series
14449 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
14450 # However if the backend service returns a 403, the rule for4xx takes effect.
14451 { # Specifies the mapping between the response code that will be returned along
14452 # with the custom error content and the response code returned by the backend
14453 # service.
14454 &quot;matchResponseCodes&quot;: [ # Valid values include:
14455 #
14456 #
14457 # - A number between 400 and 599: For example
14458 # 401 or 503, in which case the load balancer
14459 # applies the policy if the error code exactly matches this value.
14460 # - 5xx: Load Balancer will apply the policy if the
14461 # backend service responds with any response code in the range of
14462 # 500 to 599.
14463 # - 4xx: Load
14464 # Balancer will apply the policy if the backend service responds with any
14465 # response code in the range of 400 to
14466 # 499.
14467 #
14468 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
14469 &quot;A String&quot;,
14470 ],
14471 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
14472 # error content. If overrideResponseCode is not supplied, the
14473 # same response code returned by the original backend bucket or backend
14474 # service is returned to the client.
14475 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
14476 #
14477 # path must start
14478 # with a leading slash. path cannot have trailing slashes.
14479 #
14480 # If the file is not available in backendBucket or the
14481 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
14482 #
14483 # The value must
14484 # be from 1 to 1024 characters
14485 },
14486 ],
14487 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
14488 # contains the custom error content. Examples are:
14489 #
14490 #
14491 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
14492 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
14493 # - global/backendBuckets/myBackendBucket
14494 #
14495 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
14496 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
14497 #
14498 # If load balancer cannot reach
14499 # the backendBucket, a simple Not Found Error will
14500 # be returned, with the original response code (oroverrideResponseCode if configured).
14501 #
14502 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
14503 },
14504 &quot;paths&quot;: [ # The list of path patterns to match. Each must start with /
14505 # and the only place a * is allowed is at the end following
14506 # a /. The string fed to the path matcher does not include
14507 # any text after the first ? or #, and
14508 # those chars are not allowed here.
14509 &quot;A String&quot;,
14510 ],
14511 &quot;routeAction&quot;: { # In response to a matching path, the load balancer
14512 # performs advanced routing actions, such as URL rewrites and header
14513 # transformations, before forwarding the request to the selected
14514 # backend.
14515 #
14516 #
14517 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
14518 #
14519 #
14520 # URL maps for classic Application Load Balancers only support
14521 # the urlRewrite action within a path rule&#x27;srouteAction.
14522 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
14523 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
14524 # property must be specified. This policy cannot be specified if any target
14525 # backend has Identity-Aware Proxy enabled.
14526 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
14527 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
14528 # header names can be specified. The cache is bypassed for all `cacheMode`
14529 # values.
14530 &quot;A String&quot;,
14531 ],
14532 &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
14533 # on the backend type: for Backend Services, the complete request URI is
14534 # used; for Backend Buckets, the request URI is used without the protocol or
14535 # host, and only query parameters known to Cloud Storage are included.
14536 # Policy defined on Route Action.
14537 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
14538 # parameters will be included. Either specify `excludedQueryParameters`
14539 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
14540 # encoded and not treated as delimiters.
14541 #
14542 # Note: This field applies to routes that use backend services. Attempting
14543 # to set it on a route that points exclusively to Backend Buckets will
14544 # result in a configuration error. For routes that point to a Backend
14545 # Bucket, use `includedQueryParameters` to define which parameters should
14546 # be part of the cache key.
14547 &quot;A String&quot;,
14548 ],
14549 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
14550 #
14551 # Note: This setting is only applicable to routes that use a Backend
14552 # Service. It does not affect requests served by a Backend Bucket, as the
14553 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
14554 # it on a route that points exclusively to Backend Buckets will result in a
14555 # configuration error.
14556 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
14557 #
14558 # Note: This setting is only applicable to routes that use a Backend
14559 # Service. It does not affect requests served by a Backend Bucket, as the
14560 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
14561 # set on a route that points exclusively to Backend Buckets will result in
14562 # a configuration error.
14563 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
14564 # `includedQueryParameters` and `excludedQueryParameters`. If neither
14565 # is set, the entire query string will be included. If false, the query
14566 # string will be excluded from the cache key entirely.
14567 #
14568 # Note: This field applies to routes that use backend services. Attempting
14569 # to set it on a route that points exclusively to Backend Buckets will
14570 # result in a configuration error. For routes that point to a Backend
14571 # Bucket, use `includedQueryParameters` to define which parameters should
14572 # be part of the cache key.
14573 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
14574 # The name=value pair will be used in the cache key Cloud CDN generates.
14575 #
14576 # Note: This setting is only applicable to routes that use a Backend
14577 # Service. It does not affect requests served by a Backend Bucket.
14578 # Attempting to set it on a route that points exclusively to Backend
14579 # Buckets will result in a configuration error. Up to 5 cookie names can be
14580 # specified.
14581 &quot;A String&quot;,
14582 ],
14583 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
14584 &quot;A String&quot;,
14585 ],
14586 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
14587 # parameters will be excluded. Either specify `includedQueryParameters`
14588 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
14589 # encoded and not treated as delimiters.
14590 &quot;A String&quot;,
14591 ],
14592 },
14593 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
14594 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
14595 &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
14596 # content. This is used to clamp the max-age (or Expires) value sent to the
14597 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
14598 # is used for the response max-age directive, along with a &quot;public&quot;
14599 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
14600 # clamps the max-age from the origin (if specified), or else sets the
14601 # response max-age directive to the lesser of the `clientTtl` and
14602 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
14603 # present. The maximum allowed value is 31,622,400s (1 year). If not
14604 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
14605 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
14606 # `USE_ORIGIN_HEADERS`.
14607 # as a count of seconds and fractions of seconds at nanosecond
14608 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14609 # or &quot;month&quot;. Range is approximately 10,000 years.
14610 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14611 # Durations less than one second are represented with a 0
14612 # `seconds` field and a positive `nanos` field. Must be from 0
14613 # to 999,999,999 inclusive.
14614 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14615 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14616 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14617 },
14618 &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
14619 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
14620 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
14621 # greater than that of `maxTtl`. When the `cacheMode` is set to
14622 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
14623 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
14624 # accessed objects may be evicted from the cache before the defined TTL. If
14625 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
14626 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
14627 # `USE_ORIGIN_HEADERS`.
14628 # as a count of seconds and fractions of seconds at nanosecond
14629 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14630 # or &quot;month&quot;. Range is approximately 10,000 years.
14631 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14632 # Durations less than one second are represented with a 0
14633 # `seconds` field and a positive `nanos` field. Must be from 0
14634 # to 999,999,999 inclusive.
14635 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14636 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14637 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14638 },
14639 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
14640 # attempt to set a max-age or s-maxage higher than this, or an Expires header
14641 # more than `maxTtl` seconds in the future will be capped at the value of
14642 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
14643 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
14644 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
14645 # Infrequently accessed objects may be evicted from the cache before the
14646 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
14647 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
14648 # mode.
14649 # as a count of seconds and fractions of seconds at nanosecond
14650 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14651 # or &quot;month&quot;. Range is approximately 10,000 years.
14652 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14653 # Durations less than one second are represented with a 0
14654 # `seconds` field and a positive `nanos` field. Must be from 0
14655 # to 999,999,999 inclusive.
14656 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14657 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14658 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14659 },
14660 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
14661 # to apply fine-grained caching for common errors or redirects.
14662 # This can reduce the load on your origin and improve end-user
14663 # experience by reducing response latency.
14664 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
14665 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
14666 # the specified response code that lack any Cache-Control, Expires, or
14667 # Pragma: no-cache directives. When the `cacheMode` is set to
14668 # `FORCE_CACHE_ALL`, negative caching applies to all responses
14669 # with the specified response code, and overrides any caching headers. By
14670 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
14671 #
14672 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
14673 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
14674 # * 405 (Method Not Found), 501 (Not Implemented): 60s
14675 #
14676 # These defaults can be overridden in `negativeCachingPolicy`.
14677 # If not specified, Cloud CDN applies negative caching by default.
14678 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
14679 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
14680 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
14681 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
14682 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
14683 # all response codes that you wish to cache. Cloud CDN will not apply any
14684 # default negative caching when a policy exists.
14685 { # Specify CDN TTLs for response error codes.
14686 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
14687 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
14688 # specified as values, and you cannot specify a status code more than
14689 # once.
14690 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
14691 # corresponding status code.
14692 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
14693 # objects may be evicted from the cache before the defined TTL.
14694 # as a count of seconds and fractions of seconds at nanosecond
14695 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14696 # or &quot;month&quot;. Range is approximately 10,000 years.
14697 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14698 # Durations less than one second are represented with a 0
14699 # `seconds` field and a positive `nanos` field. Must be from 0
14700 # to 999,999,999 inclusive.
14701 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14702 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14703 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14704 },
14705 },
14706 ],
14707 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
14708 # requests into a small number of requests to the origin. If not specified,
14709 # Cloud CDN applies request coalescing by default.
14710 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
14711 # content with the origin, or when an error is encountered when refreshing
14712 # the cache.
14713 # This setting defines the default &quot;max-stale&quot; duration for any cached
14714 # responses that do not specify a max-stale directive. Stale responses that
14715 # exceed the TTL configured here will not be served. The default limit
14716 # (max-stale) is 86400s (1 day), which will allow stale content to be
14717 # served up to this limit beyond the max-age (or s-maxage) of a cached
14718 # response.
14719 # The maximum allowed value is 604800 (1 week).
14720 # Set this to zero (0) to disable serve-while-stale.
14721 # as a count of seconds and fractions of seconds at nanosecond
14722 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14723 # or &quot;month&quot;. Range is approximately 10,000 years.
14724 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14725 # Durations less than one second are represented with a 0
14726 # `seconds` field and a positive `nanos` field. Must be from 0
14727 # to 999,999,999 inclusive.
14728 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14729 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14730 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14731 },
14732 },
14733 &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
14734 # information about the W3C recommendation for cross-origin resource sharing
14735 # (CORS), see Fetch API Living
14736 # Standard.
14737 #
14738 # Not supported when the URL map is bound to a target gRPC proxy.
14739 # information about the W3C recommendation for cross-origin resource sharing
14740 # (CORS), see Fetch API Living
14741 # Standard.
14742 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
14743 # indicates that
14744 # the actual request can include user credentials. This field translates to
14745 # the Access-Control-Allow-Credentials header.
14746 #
14747 # Default is false.
14748 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
14749 # header.
14750 &quot;A String&quot;,
14751 ],
14752 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
14753 # header.
14754 &quot;A String&quot;,
14755 ],
14756 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
14757 # more information, see regular expression syntax.
14758 #
14759 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
14760 #
14761 # Regular expressions can only be used when the loadBalancingScheme is
14762 # set to INTERNAL_SELF_MANAGED.
14763 &quot;A String&quot;,
14764 ],
14765 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
14766 #
14767 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
14768 &quot;A String&quot;,
14769 ],
14770 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
14771 # The default value is false, which indicates that the CORS
14772 # policy is in effect.
14773 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
14774 # header.
14775 &quot;A String&quot;,
14776 ],
14777 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
14778 # seconds. This field translates to the Access-Control-Max-Age
14779 # header.
14780 },
14781 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
14782 # the resiliency of clients to backend service failure. As part of fault
14783 # injection, when clients send requests to a backend service, delays can be
14784 # introduced by a load balancer on a percentage of requests before sending
14785 # those requests to the backend service. Similarly requests from clients can
14786 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
14787 # that are configured with a fault_injection_policy if:
14788 # 1. The traffic is generated by fault injection AND
14789 # 2. The fault injection is not a delay fault injection.
14790 # Fault injection is not supported with the classic Application Load Balancer
14791 # . To see which load balancers support fault injection,
14792 # see Load
14793 # balancing: Routing and traffic management features.
14794 # the resiliency of clients to backend service failure. As part of fault
14795 # injection, when clients send requests to a backend service, delays can be
14796 # introduced by the load balancer on a percentage of requests before sending
14797 # those request to the backend service. Similarly requests from clients can be
14798 # aborted by the load balancer for a percentage of requests.
14799 &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
14800 # injection.
14801 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
14802 #
14803 # The value must be from 200 to 599 inclusive.
14804 #
14805 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
14806 # according to this
14807 # mapping table. HTTP status 200 is mapped to gRPC status
14808 # UNKNOWN. Injecting an OK status is currently not supported by
14809 # Traffic Director.
14810 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
14811 # that is aborted as part of fault injection.
14812 #
14813 # The value must be from 0.0 to 100.0 inclusive.
14814 },
14815 &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
14816 # injection, before being sent to a backend service.
14817 # request to the backend service as part of fault injection.
14818 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
14819 # as a count of seconds and fractions of seconds at nanosecond
14820 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14821 # or &quot;month&quot;. Range is approximately 10,000 years.
14822 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14823 # Durations less than one second are represented with a 0
14824 # `seconds` field and a positive `nanos` field. Must be from 0
14825 # to 999,999,999 inclusive.
14826 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14827 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14828 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14829 },
14830 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
14831 # which a delay is introduced as part of fault injection.
14832 #
14833 # The value must be from 0.0 to 100.0 inclusive.
14834 },
14835 },
14836 &quot;imageOptimizationPolicy&quot;: { # The configuration for Cloud CDN&#x27;s image optimization feature. This feature # Image optimization policy for this URL Map&#x27;s route. Available only for
14837 # Global EXTERNAL_MANAGED load balancer schemes.
14838 # Either Cloud CDN must be enabled on the backend service or backend bucket
14839 # serving the route, or cache policy must be configured on the same route
14840 # dynamically processes and delivers images from the network edge.
14841 # Image Optimization is only available for Global External Application Load
14842 # Balancers.
14843 # Either Cloud CDN must be enabled on the backend service or backend bucket
14844 # serving the route, or cache policy must be configured on the same route.
14845 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
14846 },
14847 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
14848 # Unlike the timeout field where the timeout duration starts
14849 # from the time the request has been fully processed (known as*end-of-stream*),
14850 # the duration in this field is computed from the beginning of the stream
14851 # until the response has been processed, including all retries. A
14852 # stream that does not complete in this duration is closed.
14853 #
14854 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
14855 # with the route.
14856 #
14857 # This field is only allowed if the Url map is used with backend services
14858 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
14859 # as a count of seconds and fractions of seconds at nanosecond
14860 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14861 # or &quot;month&quot;. Range is approximately 10,000 years.
14862 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14863 # Durations less than one second are represented with a 0
14864 # `seconds` field and a positive `nanos` field. Must be from 0
14865 # to 999,999,999 inclusive.
14866 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14867 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14868 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14869 },
14870 &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
14871 # are shadowed to a separate mirrored backend service. The load balancer does
14872 # not wait for responses from the shadow service. Before sending traffic
14873 # to the shadow service, the host / authority header is suffixed with-shadow.
14874 #
14875 # Not supported when the URL map is bound to a target gRPC proxy that
14876 # has the validateForProxyless field set to true.
14877 # are shadowed to a separate mirrored backend service. The load balancer
14878 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
14879 # to the shadow service, the host or authority header is suffixed with-shadow.
14880 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
14881 # mirrored to.
14882 #
14883 # The backend service configured for a mirroring
14884 # policy must reference backends that are of the same type as the original
14885 # backend service matched in the URL map.
14886 #
14887 # Serverless NEG backends are not currently supported as a mirrored
14888 # backend service.
14889 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
14890 },
14891 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
14892 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
14893 # If not specified, defaults to 1.
14894 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
14895 #
14896 # If not specified, will use the timeout set in theHttpRouteAction field.
14897 # If timeout in the HttpRouteAction field is not set, this field
14898 # uses the largest timeout
14899 # among all backend services associated with the route.
14900 #
14901 # Not supported when the URL map is bound to a target gRPC proxy that
14902 # has the validateForProxyless field set to true.
14903 # as a count of seconds and fractions of seconds at nanosecond
14904 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14905 # or &quot;month&quot;. Range is approximately 10,000 years.
14906 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14907 # Durations less than one second are represented with a 0
14908 # `seconds` field and a positive `nanos` field. Must be from 0
14909 # to 999,999,999 inclusive.
14910 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14911 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14912 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14913 },
14914 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
14915 # values are:
14916 #
14917 # - 5xx: retry is attempted if the instance or endpoint
14918 # responds with any 5xx response code, or if the instance or
14919 # endpoint does not respond at all. For example, disconnects, reset, read
14920 # timeout, connection failure, and refused streams.
14921 # - gateway-error: Similar to 5xx, but only
14922 # applies to response codes 502, 503 or504.
14923 # - connect-failure: a retry is attempted on failures
14924 # connecting to the instance or endpoint. For example, connection
14925 # timeouts.
14926 # - retriable-4xx: a retry is attempted if the instance
14927 # or endpoint responds with a 4xx response code.
14928 # The only error that you can retry is error code 409.
14929 # - refused-stream: a retry is attempted if the instance
14930 # or endpoint resets the stream with a REFUSED_STREAM error
14931 # code. This reset type indicates that it is safe to retry.
14932 # - cancelled: a retry is attempted if the gRPC status
14933 # code in the response header is set to cancelled.
14934 # - deadline-exceeded: a retry is attempted if the gRPC
14935 # status code in the response header is set todeadline-exceeded.
14936 # - internal: a retry is attempted if the gRPC
14937 # status code in the response header is set tointernal.
14938 # - resource-exhausted: a retry is attempted if the gRPC
14939 # status code in the response header is set toresource-exhausted.
14940 # - unavailable: a retry is attempted if the gRPC
14941 # status code in the response header is set tounavailable.
14942 #
14943 # Only the following codes are supported when the URL map is bound to
14944 # target gRPC proxy that has validateForProxyless field set to true.
14945 #
14946 # - cancelled
14947 # - deadline-exceeded
14948 # - internal
14949 # - resource-exhausted
14950 # - unavailable
14951 &quot;A String&quot;,
14952 ],
14953 },
14954 &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
14955 # time the request has been fully processed (known as *end-of-stream*)
14956 # up until the response has been processed. Timeout includes
14957 # all retries.
14958 #
14959 # If not specified, this field uses the largest timeout among all backend
14960 # services associated with the route.
14961 #
14962 # Not supported when the URL map is bound to a target gRPC proxy that
14963 # has validateForProxyless field set to true.
14964 # as a count of seconds and fractions of seconds at nanosecond
14965 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14966 # or &quot;month&quot;. Range is approximately 10,000 years.
14967 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14968 # Durations less than one second are represented with a 0
14969 # `seconds` field and a positive `nanos` field. Must be from 0
14970 # to 999,999,999 inclusive.
14971 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14972 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14973 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14974 },
14975 &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
14976 # to the matched service.
14977 #
14978 # urlRewrite is the only action supported in UrlMaps
14979 # for classic Application Load Balancers.
14980 #
14981 # Not supported when the URL map is bound to a target gRPC proxy that
14982 # has the validateForProxyless field set to true.
14983 # backend service.
14984 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
14985 # host header is replaced with contents of hostRewrite.
14986 #
14987 # The value must be from 1 to 255 characters.
14988 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
14989 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
14990 #
14991 # The value must be from 1 to 1024 characters.
14992 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
14993 # header) using the HTTP template syntax.
14994 #
14995 # A corresponding
14996 # path_template_match must be specified. Any template variables must exist in
14997 # the path_template_match field.
14998 #
14999 #
15000 # - -At least one variable must be specified in the path_template_match
15001 # field
15002 # - You can omit variables from the rewritten URL
15003 # - The * and ** operators cannot be matched
15004 # unless they have a corresponding variable name - e.g.
15005 # {format=*} or {var=**}.
15006 #
15007 # For example, a path_template_match of /static/{format=**}
15008 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
15009 # rewrite, so that /{country}/{format}/{suffix=**} can be
15010 # rewritten as /content/{format}/{country}/{suffix}.
15011 #
15012 # At least
15013 # one non-empty routeRules[].matchRules[].path_template_match is
15014 # required.
15015 #
15016 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
15017 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
15018 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
15019 # It uses RE2 syntax with the following constraints:
15020 #
15021 #
15022 # - Any single character operators
15023 # - Groups are allowed to have only submatch operator inside
15024 # - Groups are allowed only without any char repetition, e.g.
15025 # .*
15026 # - Any char repetition, e.g. .*, is
15027 # only allowed to be used in a single regex together with:
15028 #
15029 #
15030 # - Empty string operators
15031 # - Other repetitions
15032 # - Ranges
15033 # - Repetitions of ranges
15034 #
15035 #
15036 # - Ranges are only allowed to have:
15037 #
15038 #
15039 # - Character range
15040 # - Digits range
15041 # - Symbols listed in characters allowed for ranges
15042 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
15043 # the path.
15044 },
15045 },
15046 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
15047 # occurs. The weights determine the fraction of traffic that flows to
15048 # their corresponding backend service. If all traffic needs to
15049 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
15050 #
15051 # After a backend service is identified and before forwarding
15052 # the request to
15053 # the backend service, advanced routing actions such as URL rewrites and
15054 # header transformations are applied depending on additional settings
15055 # specified in this HttpRouteAction.
15056 { # In contrast to a single BackendService in
15057 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
15058 # multiple backend services. The volume of traffic for each
15059 # backend service is proportional to the weight specified
15060 # in each WeightedBackendService
15061 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
15062 # resource. Before
15063 # forwarding the request to backendService, the load balancer
15064 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
15065 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
15066 # effect for the selected backendService.
15067 #
15068 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
15069 #
15070 # headerAction is not supported for load balancers that have
15071 # their loadBalancingScheme set to EXTERNAL.
15072 #
15073 # Not supported when the URL map is bound to a target gRPC proxy that
15074 # has validateForProxyless field set to true.
15075 # the request is passed along to the selected backendService.
15076 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
15077 { # Specification determining how headers are added to requests or responses.
15078 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
15079 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
15080 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
15081 # that already
15082 # exist for the header. If true, headerValue is set for the
15083 # header, discarding any values that were set for that header.
15084 #
15085 # The default value is true,
15086 # unless a variable is present in headerValue,
15087 # in which case the default value is false.
15088 # .
15089 },
15090 ],
15091 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
15092 # request before forwarding the request to the backendService.
15093 &quot;A String&quot;,
15094 ],
15095 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
15096 # client.
15097 { # Specification determining how headers are added to requests or responses.
15098 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
15099 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
15100 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
15101 # that already
15102 # exist for the header. If true, headerValue is set for the
15103 # header, discarding any values that were set for that header.
15104 #
15105 # The default value is true,
15106 # unless a variable is present in headerValue,
15107 # in which case the default value is false.
15108 # .
15109 },
15110 ],
15111 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
15112 # response before sending the response back to the client.
15113 &quot;A String&quot;,
15114 ],
15115 },
15116 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
15117 # computed asweight / (sum of all weightedBackendService weights in routeAction).
15118 #
15119 # The selection of a backend service is determined only for new traffic.
15120 # Once a user&#x27;s request has been directed to a backend service,
15121 # subsequent requests are sent to the same backend service as
15122 # determined by the backend service&#x27;s session affinity policy.
15123 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
15124 # splitting. If you do, the weighted traffic splitting configuration takes
15125 # precedence.
15126 #
15127 # The value must be from 0 to 1000.
15128 },
15129 ],
15130 },
15131 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
15132 # is directed if this rule is matched. If routeAction is
15133 # also specified, advanced routing actions, such as URL rewrites,
15134 # take effect before sending the request to the backend.
15135 #
15136 #
15137 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
15138 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
15139 # specified by urlRedirect.
15140 #
15141 #
15142 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
15143 #
15144 #
15145 # Not supported when the URL map is bound to a target gRPC proxy.
15146 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
15147 # was supplied in the request.
15148 #
15149 # The value must be from 1 to 255
15150 # characters.
15151 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
15152 # set to HTTPS.
15153 # If set to false, the URL scheme of the redirected request
15154 # remains the same as that of the request.
15155 #
15156 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
15157 #
15158 # The default is set to false.
15159 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
15160 # that was supplied in the request.
15161 #
15162 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
15163 # supplied, the path of the original request is used for the redirect.
15164 #
15165 # The value must be from 1 to 1024 characters.
15166 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
15167 # the HttpRouteRuleMatch, retaining the remaining portion
15168 # of the URL before redirecting the request.
15169 #
15170 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
15171 # supplied, the path of the original request is used for the redirect.
15172 #
15173 # The value must be from 1 to 1024 characters.
15174 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
15175 #
15176 # Supported values are:
15177 #
15178 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
15179 # to 301.
15180 # - FOUND, which corresponds to 302.
15181 # - SEE_OTHER which corresponds to 303.
15182 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
15183 # method is retained.
15184 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
15185 # method is retained.
15186 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
15187 # URL is
15188 # removed before redirecting the request. If set to false, the
15189 # query portion of the original URL is retained.
15190 #
15191 # The default is set to false.
15192 },
15193 },
15194 ],
15195 &quot;routeRules&quot;: [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
15196 # desired. routeRules are evaluated in order of priority, from
15197 # the lowest to highest number.
15198 #
15199 # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
15200 { # The HttpRouteRule setting specifies how to match an HTTP request
15201 # and the corresponding routing action that load balancing proxies perform.
15202 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
15203 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
15204 #
15205 # If a policy for an
15206 # error code is not configured for the RouteRule, a policy for
15207 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
15208 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
15209 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
15210 # effect.
15211 #
15212 # For example, consider a UrlMap with the following configuration:
15213 #
15214 #
15215 # - UrlMap.defaultCustomErrorResponsePolicy are configured
15216 # with policies for 5xx and 4xx errors
15217 # - A RouteRule for /coming_soon/ is configured for the
15218 # error code 404.
15219 #
15220 # 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
15221 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
15222 # the policy in RouteRule.customErrorResponsePolicy takes
15223 # effect. If any of the requests in this example encounter a 500
15224 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
15225 #
15226 # When
15227 # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
15228 # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
15229 # a retry, if load balancer is successful in reaching the
15230 # service, the customErrorResponsePolicy is ignored and
15231 # the response from the service is returned to the client.
15232 #
15233 # customErrorResponsePolicy is supported only for
15234 # global external Application Load Balancers.
15235 # backend service or backend bucket responds with an error.
15236 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
15237 #
15238 # In a given policy, if you specify rules for both a range of error codes
15239 # as well as rules for specific error codes then rules with specific error
15240 # codes have a higher priority. For example, assume that you configure a rule
15241 # for 401 (Un-authorized) code, and another for all 4 series
15242 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
15243 # However if the backend service returns a 403, the rule for4xx takes effect.
15244 { # Specifies the mapping between the response code that will be returned along
15245 # with the custom error content and the response code returned by the backend
15246 # service.
15247 &quot;matchResponseCodes&quot;: [ # Valid values include:
15248 #
15249 #
15250 # - A number between 400 and 599: For example
15251 # 401 or 503, in which case the load balancer
15252 # applies the policy if the error code exactly matches this value.
15253 # - 5xx: Load Balancer will apply the policy if the
15254 # backend service responds with any response code in the range of
15255 # 500 to 599.
15256 # - 4xx: Load
15257 # Balancer will apply the policy if the backend service responds with any
15258 # response code in the range of 400 to
15259 # 499.
15260 #
15261 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
15262 &quot;A String&quot;,
15263 ],
15264 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
15265 # error content. If overrideResponseCode is not supplied, the
15266 # same response code returned by the original backend bucket or backend
15267 # service is returned to the client.
15268 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
15269 #
15270 # path must start
15271 # with a leading slash. path cannot have trailing slashes.
15272 #
15273 # If the file is not available in backendBucket or the
15274 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
15275 #
15276 # The value must
15277 # be from 1 to 1024 characters
15278 },
15279 ],
15280 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
15281 # contains the custom error content. Examples are:
15282 #
15283 #
15284 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
15285 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
15286 # - global/backendBuckets/myBackendBucket
15287 #
15288 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
15289 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
15290 #
15291 # If load balancer cannot reach
15292 # the backendBucket, a simple Not Found Error will
15293 # be returned, with the original response code (oroverrideResponseCode if configured).
15294 #
15295 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
15296 },
15297 &quot;description&quot;: &quot;A String&quot;, # The short description conveying the intent of this routeRule.
15298 #
15299 #
15300 # The description can have a maximum length of 1024 characters.
15301 &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
15302 # for the selected backendService.
15303 #
15304 # The headerAction value specified here is applied before the
15305 # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
15306 #
15307 # HeaderAction is not supported for load balancers
15308 # that have
15309 # their loadBalancingScheme set to EXTERNAL.
15310 #
15311 # Not supported when the URL map is bound to a target gRPC proxy that
15312 # has validateForProxyless field set to true.
15313 # the request is passed along to the selected backendService.
15314 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
15315 { # Specification determining how headers are added to requests or responses.
15316 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
15317 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
15318 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
15319 # that already
15320 # exist for the header. If true, headerValue is set for the
15321 # header, discarding any values that were set for that header.
15322 #
15323 # The default value is true,
15324 # unless a variable is present in headerValue,
15325 # in which case the default value is false.
15326 # .
15327 },
15328 ],
15329 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
15330 # request before forwarding the request to the backendService.
15331 &quot;A String&quot;,
15332 ],
15333 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
15334 # client.
15335 { # Specification determining how headers are added to requests or responses.
15336 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
15337 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
15338 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
15339 # that already
15340 # exist for the header. If true, headerValue is set for the
15341 # header, discarding any values that were set for that header.
15342 #
15343 # The default value is true,
15344 # unless a variable is present in headerValue,
15345 # in which case the default value is false.
15346 # .
15347 },
15348 ],
15349 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
15350 # response before sending the response back to the client.
15351 &quot;A String&quot;,
15352 ],
15353 },
15354 &quot;httpFilterConfigs&quot;: [ # Outbound route specific configuration fornetworkservices.HttpFilter resources enabled by Traffic
15355 # Director. httpFilterConfigs only applies for load balancers
15356 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
15357 # more details.
15358 #
15359 # Not supported when the URL map is bound to a target gRPC proxy that
15360 # has validateForProxyless field set to true.
15361 { # HttpFilterConfiguration supplies additional contextual settings
15362 # for networkservices.HttpFilter resources enabled by Traffic
15363 # Director.
15364 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
15365 # YAML formatted and only contain fields defined in the protobuf identified
15366 # in configTypeUrl
15367 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
15368 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
15369 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
15370 # configuration belongs to. This name must be known to the xDS client.
15371 # Example: envoy.wasm
15372 },
15373 ],
15374 &quot;httpFilterMetadata&quot;: [ # Outbound route specific metadata supplied tonetworkservices.HttpFilter resources enabled by Traffic
15375 # Director. httpFilterMetadata only applies for load balancers
15376 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
15377 # more details.
15378 #
15379 # The only configTypeUrl supported istype.googleapis.com/google.protobuf.Struct
15380 #
15381 # Not supported when the URL map is bound to a target gRPC proxy that
15382 # has validateForProxyless field set to true.
15383 { # HttpFilterConfiguration supplies additional contextual settings
15384 # for networkservices.HttpFilter resources enabled by Traffic
15385 # Director.
15386 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
15387 # YAML formatted and only contain fields defined in the protobuf identified
15388 # in configTypeUrl
15389 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
15390 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
15391 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
15392 # configuration belongs to. This name must be known to the xDS client.
15393 # Example: envoy.wasm
15394 },
15395 ],
15396 &quot;matchRules&quot;: [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
15397 # this routeRule when any of thematchRules are satisfied. However predicates within
15398 # a given matchRule have AND semantics. All predicates
15399 # within a matchRule must match for the request to
15400 # match the rule.
15401 { # HttpRouteRuleMatch specifies a set of criteria for matching
15402 # requests to an HttpRouteRule. All specified criteria must
15403 # be satisfied for a match to occur.
15404 &quot;fullPathMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
15405 # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
15406 # that may be part of the original URL.
15407 #
15408 # fullPathMatch must be from 1 to 1024 characters.
15409 #
15410 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
15411 # specified.
15412 &quot;headerMatches&quot;: [ # Specifies a list of header match criteria, all of which must match
15413 # corresponding headers in the request.
15414 { # matchRule criteria for request header matches.
15415 &quot;exactMatch&quot;: &quot;A String&quot;, # The value should exactly match contents of exactMatch.
15416 #
15417 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
15418 &quot;headerName&quot;: &quot;A String&quot;, # The name of the HTTP header to match.
15419 #
15420 # For matching against the HTTP request&#x27;s authority, use a headerMatch
15421 # with the header name &quot;:authority&quot;.
15422 #
15423 # For matching a request&#x27;s method, use the headerName &quot;:method&quot;.
15424 #
15425 # When the URL map is bound to a target gRPC proxy that has
15426 # the validateForProxyless field set to true, only
15427 # non-binary
15428 # user-specified custom metadata and the `content-type` header are supported.
15429 # The following transport-level headers cannot be used in header matching
15430 # rules:
15431 # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
15432 # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
15433 # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
15434 # `grpc-timeout` and `grpc-trace-bin`.
15435 &quot;invertMatch&quot;: True or False, # If set to false, the headerMatch is considered a
15436 # match if the preceding match criteria are met. If set to true,
15437 # the headerMatch is considered a match if the preceding
15438 # match criteria are NOT met.
15439 #
15440 # The default setting is false.
15441 &quot;prefixMatch&quot;: &quot;A String&quot;, # The value of the header must start with the contents ofprefixMatch.
15442 #
15443 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
15444 &quot;presentMatch&quot;: True or False, # A header with the contents of headerName must exist. The
15445 # match takes place whether or not the request&#x27;s header has a value.
15446 #
15447 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
15448 &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
15449 # specified in rangeMatch. If the header does not contain an
15450 # integer, number or is empty, the match fails.
15451 #
15452 # For example for a range [-5, 0]
15453 #
15454 #
15455 # - -3 will match.
15456 # - 0 will not match.
15457 # - 0.25 will not match.
15458 # - -3someString will not match.
15459 #
15460 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
15461 #
15462 # rangeMatch is not supported for load balancers
15463 # that have loadBalancingScheme set to EXTERNAL.
15464 # within the specified integer range.
15465 &quot;rangeEnd&quot;: &quot;A String&quot;, # The end of the range (exclusive) in signed long integer format.
15466 &quot;rangeStart&quot;: &quot;A String&quot;, # The start of the range (inclusive) in signed long integer format.
15467 },
15468 &quot;regexMatch&quot;: &quot;A String&quot;, # The value of the header must match the regular expression specified inregexMatch.
15469 # For more information about regular expression syntax, see Syntax.
15470 #
15471 # For matching against a port specified in the HTTP request, use a
15472 # headerMatch with headerName set to PORT and a regular expression that
15473 # satisfies the RFC2616 Host header&#x27;s port specifier.
15474 #
15475 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
15476 #
15477 # Regular expressions can only be used when the loadBalancingScheme is
15478 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
15479 # (regional scope) or INTERNAL_MANAGED.
15480 &quot;suffixMatch&quot;: &quot;A String&quot;, # The value of the header must end with the contents ofsuffixMatch.
15481 #
15482 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
15483 },
15484 ],
15485 &quot;ignoreCase&quot;: True or False, # Specifies that prefixMatch and fullPathMatch
15486 # matches are case sensitive.
15487 #
15488 # The default value is false.
15489 #
15490 # ignoreCase must not be used with regexMatch.
15491 #
15492 # Not supported when the URL map is bound to a target gRPC proxy.
15493 &quot;metadataFilters&quot;: [ # Opaque filter criteria used by the load balancer to restrict routing
15494 # configuration to a limited set of xDS
15495 # compliant clients. In their xDS requests to the load balancer, xDS clients
15496 # present node
15497 # metadata. When there is a match, the relevant routing configuration
15498 # is made available to those proxies.
15499 #
15500 # 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
15501 # the metadata. If its filterMatchCriteria is set to
15502 # MATCH_ALL, then all of its filterLabels must match with
15503 # corresponding labels provided in the metadata. If multiple
15504 # metadata filters are specified, all of them need to be
15505 # satisfied in order to be considered a match.
15506 #
15507 # metadataFilters specified here is applied after those
15508 # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
15509 #
15510 # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
15511 #
15512 # Not supported when the URL map is bound to a target gRPC proxy that
15513 # has validateForProxyless field set to true.
15514 { # Opaque filter criteria used by load balancers to restrict routing
15515 # configuration to a limited set of load balancing proxies. Proxies and
15516 # sidecars involved in load balancing would typically present metadata to the
15517 # load balancers that need to match criteria specified here. If a match takes
15518 # place, the relevant configuration is made available to those
15519 # proxies.
15520 #
15521 # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
15522 # one of thefilterLabels must match the corresponding label provided in
15523 # the metadata. If its filterMatchCriteria is set to
15524 # MATCH_ALL, then all of its filterLabels must match with
15525 # corresponding labels provided in the metadata.
15526 #
15527 # An example for using metadataFilters would be: if
15528 # load balancing involves
15529 # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in of their XDS requests to loadbalancers.
15530 &quot;filterLabels&quot;: [ # The list of label value pairs that must match labels in the provided
15531 # metadata based on filterMatchCriteria
15532 #
15533 # This list must not be empty and can have at the most 64 entries.
15534 { # MetadataFilter label name value pairs that are expected
15535 # to match corresponding labels presented as metadata to the load balancer.
15536 &quot;name&quot;: &quot;A String&quot;, # Name of metadata label.
15537 #
15538 # The name can have a maximum length of 1024 characters and must be at
15539 # least 1 character long.
15540 &quot;value&quot;: &quot;A String&quot;, # The value of the label must match the specified value.
15541 #
15542 # value can have a maximum length of 1024 characters.
15543 },
15544 ],
15545 &quot;filterMatchCriteria&quot;: &quot;A String&quot;, # Specifies how individual filter label matches
15546 # within the list of filterLabels and contributes toward the
15547 # overall metadataFilter match.
15548 #
15549 # Supported values are:
15550 #
15551 # - MATCH_ANY: at least one of the filterLabels
15552 # must have a matching label in the provided metadata.
15553 # - MATCH_ALL: all filterLabels must have
15554 # matching labels in the provided metadata.
15555 },
15556 ],
15557 &quot;pathTemplateMatch&quot;: &quot;A String&quot;, # If specified, this field defines a path template pattern that must match
15558 # the :path header after the query string is removed.
15559 #
15560 # A path template pattern can include variables and wildcards.
15561 # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
15562 # matches a single path segment, and ** that matches zero or
15563 # more path segments. The pattern must follow these rules:
15564 #
15565 #
15566 # - The value must be between 1 and 1024 characters.
15567 # - The pattern must start with a leading slash (&quot;/&quot;).
15568 # - No more than 5 operators (variables or wildcards) may appear in
15569 # the pattern.
15570 #
15571 # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
15572 # set.
15573 &quot;prefixMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the request&#x27;s
15574 # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
15575 #
15576 # The value must be from 1 to 1024 characters.
15577 #
15578 # The * character inside a prefix match is
15579 # treated as a literal character, not as a wildcard.
15580 #
15581 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
15582 # used within a matchRule.
15583 &quot;queryParameterMatches&quot;: [ # Specifies a list of query parameter match criteria, all of which must
15584 # match corresponding query parameters in the request.
15585 #
15586 # Not supported when the URL map is bound to a target gRPC proxy.
15587 { # HttpRouteRuleMatch criteria for a request&#x27;s query parameter.
15588 &quot;exactMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
15589 # parameter exactly matches the contents of exactMatch.
15590 #
15591 # Only one of presentMatch, exactMatch, orregexMatch must be set.
15592 &quot;name&quot;: &quot;A String&quot;, # The name of the query parameter to match. The query parameter must exist in
15593 # the request, in the absence of which the request match fails.
15594 &quot;presentMatch&quot;: True or False, # Specifies that the queryParameterMatch matches if the
15595 # request contains the query parameter, irrespective of whether the
15596 # parameter has a value or not.
15597 #
15598 # Only one of presentMatch, exactMatch, orregexMatch must be set.
15599 &quot;regexMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
15600 # parameter matches the regular expression specified byregexMatch. For
15601 # more information about regular expression syntax, see Syntax.
15602 #
15603 # Only one of presentMatch, exactMatch, orregexMatch must be set.
15604 #
15605 # Regular expressions can only be used when the loadBalancingScheme is
15606 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
15607 # (regional scope) or INTERNAL_MANAGED.
15608 },
15609 ],
15610 &quot;regexMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
15611 # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
15612 # supplied with the original URL. For
15613 # more information about regular expression syntax, see Syntax.
15614 #
15615 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
15616 # specified.
15617 #
15618 # Regular expressions can only be used when the loadBalancingScheme is
15619 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
15620 # (regional scope) or INTERNAL_MANAGED.
15621 },
15622 ],
15623 &quot;priority&quot;: 42, # For routeRules within a given pathMatcher,
15624 # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
15625 # of priority, from the lowest to highest number. The priority of a
15626 # rule decreases as its number increases (1, 2, 3, N+1). The first rule
15627 # that matches the request is applied.
15628 #
15629 #
15630 # You cannot configure two or more routeRules with the same priority.
15631 # Priority for each rule must be set to a number from 0 to 2147483647
15632 # inclusive.
15633 #
15634 #
15635 # Priority numbers can have gaps, which enable you to add or remove rules
15636 # in the future without affecting the rest of the rules. For example, 1, 2,
15637 # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
15638 # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
15639 # without any impact on existing rules.
15640 &quot;routeAction&quot;: { # In response to a matching matchRule, the load balancer
15641 # performs advanced routing actions, such as URL rewrites and header
15642 # transformations, before forwarding the request to the selected backend.
15643 #
15644 #
15645 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
15646 #
15647 #
15648 # URL maps for classic Application Load Balancers only support
15649 # the urlRewrite action within a route rule&#x27;srouteAction.
15650 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
15651 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
15652 # property must be specified. This policy cannot be specified if any target
15653 # backend has Identity-Aware Proxy enabled.
15654 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
15655 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
15656 # header names can be specified. The cache is bypassed for all `cacheMode`
15657 # values.
15658 &quot;A String&quot;,
15659 ],
15660 &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
15661 # on the backend type: for Backend Services, the complete request URI is
15662 # used; for Backend Buckets, the request URI is used without the protocol or
15663 # host, and only query parameters known to Cloud Storage are included.
15664 # Policy defined on Route Action.
15665 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
15666 # parameters will be included. Either specify `excludedQueryParameters`
15667 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
15668 # encoded and not treated as delimiters.
15669 #
15670 # Note: This field applies to routes that use backend services. Attempting
15671 # to set it on a route that points exclusively to Backend Buckets will
15672 # result in a configuration error. For routes that point to a Backend
15673 # Bucket, use `includedQueryParameters` to define which parameters should
15674 # be part of the cache key.
15675 &quot;A String&quot;,
15676 ],
15677 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
15678 #
15679 # Note: This setting is only applicable to routes that use a Backend
15680 # Service. It does not affect requests served by a Backend Bucket, as the
15681 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
15682 # it on a route that points exclusively to Backend Buckets will result in a
15683 # configuration error.
15684 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
15685 #
15686 # Note: This setting is only applicable to routes that use a Backend
15687 # Service. It does not affect requests served by a Backend Bucket, as the
15688 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
15689 # set on a route that points exclusively to Backend Buckets will result in
15690 # a configuration error.
15691 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
15692 # `includedQueryParameters` and `excludedQueryParameters`. If neither
15693 # is set, the entire query string will be included. If false, the query
15694 # string will be excluded from the cache key entirely.
15695 #
15696 # Note: This field applies to routes that use backend services. Attempting
15697 # to set it on a route that points exclusively to Backend Buckets will
15698 # result in a configuration error. For routes that point to a Backend
15699 # Bucket, use `includedQueryParameters` to define which parameters should
15700 # be part of the cache key.
15701 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
15702 # The name=value pair will be used in the cache key Cloud CDN generates.
15703 #
15704 # Note: This setting is only applicable to routes that use a Backend
15705 # Service. It does not affect requests served by a Backend Bucket.
15706 # Attempting to set it on a route that points exclusively to Backend
15707 # Buckets will result in a configuration error. Up to 5 cookie names can be
15708 # specified.
15709 &quot;A String&quot;,
15710 ],
15711 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
15712 &quot;A String&quot;,
15713 ],
15714 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
15715 # parameters will be excluded. Either specify `includedQueryParameters`
15716 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
15717 # encoded and not treated as delimiters.
15718 &quot;A String&quot;,
15719 ],
15720 },
15721 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
15722 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
15723 &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
15724 # content. This is used to clamp the max-age (or Expires) value sent to the
15725 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
15726 # is used for the response max-age directive, along with a &quot;public&quot;
15727 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
15728 # clamps the max-age from the origin (if specified), or else sets the
15729 # response max-age directive to the lesser of the `clientTtl` and
15730 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
15731 # present. The maximum allowed value is 31,622,400s (1 year). If not
15732 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
15733 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
15734 # `USE_ORIGIN_HEADERS`.
15735 # as a count of seconds and fractions of seconds at nanosecond
15736 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15737 # or &quot;month&quot;. Range is approximately 10,000 years.
15738 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15739 # Durations less than one second are represented with a 0
15740 # `seconds` field and a positive `nanos` field. Must be from 0
15741 # to 999,999,999 inclusive.
15742 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15743 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15744 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15745 },
15746 &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
15747 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
15748 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
15749 # greater than that of `maxTtl`. When the `cacheMode` is set to
15750 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
15751 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
15752 # accessed objects may be evicted from the cache before the defined TTL. If
15753 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
15754 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
15755 # `USE_ORIGIN_HEADERS`.
15756 # as a count of seconds and fractions of seconds at nanosecond
15757 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15758 # or &quot;month&quot;. Range is approximately 10,000 years.
15759 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15760 # Durations less than one second are represented with a 0
15761 # `seconds` field and a positive `nanos` field. Must be from 0
15762 # to 999,999,999 inclusive.
15763 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15764 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15765 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15766 },
15767 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
15768 # attempt to set a max-age or s-maxage higher than this, or an Expires header
15769 # more than `maxTtl` seconds in the future will be capped at the value of
15770 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
15771 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
15772 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
15773 # Infrequently accessed objects may be evicted from the cache before the
15774 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
15775 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
15776 # mode.
15777 # as a count of seconds and fractions of seconds at nanosecond
15778 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15779 # or &quot;month&quot;. Range is approximately 10,000 years.
15780 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15781 # Durations less than one second are represented with a 0
15782 # `seconds` field and a positive `nanos` field. Must be from 0
15783 # to 999,999,999 inclusive.
15784 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15785 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15786 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15787 },
15788 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
15789 # to apply fine-grained caching for common errors or redirects.
15790 # This can reduce the load on your origin and improve end-user
15791 # experience by reducing response latency.
15792 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
15793 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
15794 # the specified response code that lack any Cache-Control, Expires, or
15795 # Pragma: no-cache directives. When the `cacheMode` is set to
15796 # `FORCE_CACHE_ALL`, negative caching applies to all responses
15797 # with the specified response code, and overrides any caching headers. By
15798 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
15799 #
15800 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
15801 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
15802 # * 405 (Method Not Found), 501 (Not Implemented): 60s
15803 #
15804 # These defaults can be overridden in `negativeCachingPolicy`.
15805 # If not specified, Cloud CDN applies negative caching by default.
15806 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
15807 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
15808 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
15809 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
15810 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
15811 # all response codes that you wish to cache. Cloud CDN will not apply any
15812 # default negative caching when a policy exists.
15813 { # Specify CDN TTLs for response error codes.
15814 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
15815 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
15816 # specified as values, and you cannot specify a status code more than
15817 # once.
15818 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
15819 # corresponding status code.
15820 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
15821 # objects may be evicted from the cache before the defined TTL.
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 },
15834 ],
15835 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
15836 # requests into a small number of requests to the origin. If not specified,
15837 # Cloud CDN applies request coalescing by default.
15838 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
15839 # content with the origin, or when an error is encountered when refreshing
15840 # the cache.
15841 # This setting defines the default &quot;max-stale&quot; duration for any cached
15842 # responses that do not specify a max-stale directive. Stale responses that
15843 # exceed the TTL configured here will not be served. The default limit
15844 # (max-stale) is 86400s (1 day), which will allow stale content to be
15845 # served up to this limit beyond the max-age (or s-maxage) of a cached
15846 # response.
15847 # The maximum allowed value is 604800 (1 week).
15848 # Set this to zero (0) to disable serve-while-stale.
15849 # as a count of seconds and fractions of seconds at nanosecond
15850 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15851 # or &quot;month&quot;. Range is approximately 10,000 years.
15852 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15853 # Durations less than one second are represented with a 0
15854 # `seconds` field and a positive `nanos` field. Must be from 0
15855 # to 999,999,999 inclusive.
15856 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15857 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15858 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15859 },
15860 },
15861 &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
15862 # information about the W3C recommendation for cross-origin resource sharing
15863 # (CORS), see Fetch API Living
15864 # Standard.
15865 #
15866 # Not supported when the URL map is bound to a target gRPC proxy.
15867 # information about the W3C recommendation for cross-origin resource sharing
15868 # (CORS), see Fetch API Living
15869 # Standard.
15870 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
15871 # indicates that
15872 # the actual request can include user credentials. This field translates to
15873 # the Access-Control-Allow-Credentials header.
15874 #
15875 # Default is false.
15876 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
15877 # header.
15878 &quot;A String&quot;,
15879 ],
15880 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
15881 # header.
15882 &quot;A String&quot;,
15883 ],
15884 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
15885 # more information, see regular expression syntax.
15886 #
15887 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
15888 #
15889 # Regular expressions can only be used when the loadBalancingScheme is
15890 # set to INTERNAL_SELF_MANAGED.
15891 &quot;A String&quot;,
15892 ],
15893 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
15894 #
15895 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
15896 &quot;A String&quot;,
15897 ],
15898 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
15899 # The default value is false, which indicates that the CORS
15900 # policy is in effect.
15901 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
15902 # header.
15903 &quot;A String&quot;,
15904 ],
15905 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
15906 # seconds. This field translates to the Access-Control-Max-Age
15907 # header.
15908 },
15909 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
15910 # the resiliency of clients to backend service failure. As part of fault
15911 # injection, when clients send requests to a backend service, delays can be
15912 # introduced by a load balancer on a percentage of requests before sending
15913 # those requests to the backend service. Similarly requests from clients can
15914 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
15915 # that are configured with a fault_injection_policy if:
15916 # 1. The traffic is generated by fault injection AND
15917 # 2. The fault injection is not a delay fault injection.
15918 # Fault injection is not supported with the classic Application Load Balancer
15919 # . To see which load balancers support fault injection,
15920 # see Load
15921 # balancing: Routing and traffic management features.
15922 # the resiliency of clients to backend service failure. As part of fault
15923 # injection, when clients send requests to a backend service, delays can be
15924 # introduced by the load balancer on a percentage of requests before sending
15925 # those request to the backend service. Similarly requests from clients can be
15926 # aborted by the load balancer for a percentage of requests.
15927 &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
15928 # injection.
15929 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
15930 #
15931 # The value must be from 200 to 599 inclusive.
15932 #
15933 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
15934 # according to this
15935 # mapping table. HTTP status 200 is mapped to gRPC status
15936 # UNKNOWN. Injecting an OK status is currently not supported by
15937 # Traffic Director.
15938 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
15939 # that is aborted as part of fault injection.
15940 #
15941 # The value must be from 0.0 to 100.0 inclusive.
15942 },
15943 &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
15944 # injection, before being sent to a backend service.
15945 # request to the backend service as part of fault injection.
15946 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
15947 # as a count of seconds and fractions of seconds at nanosecond
15948 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15949 # or &quot;month&quot;. Range is approximately 10,000 years.
15950 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15951 # Durations less than one second are represented with a 0
15952 # `seconds` field and a positive `nanos` field. Must be from 0
15953 # to 999,999,999 inclusive.
15954 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15955 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15956 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15957 },
15958 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
15959 # which a delay is introduced as part of fault injection.
15960 #
15961 # The value must be from 0.0 to 100.0 inclusive.
15962 },
15963 },
15964 &quot;imageOptimizationPolicy&quot;: { # The configuration for Cloud CDN&#x27;s image optimization feature. This feature # Image optimization policy for this URL Map&#x27;s route. Available only for
15965 # Global EXTERNAL_MANAGED load balancer schemes.
15966 # Either Cloud CDN must be enabled on the backend service or backend bucket
15967 # serving the route, or cache policy must be configured on the same route
15968 # dynamically processes and delivers images from the network edge.
15969 # Image Optimization is only available for Global External Application Load
15970 # Balancers.
15971 # Either Cloud CDN must be enabled on the backend service or backend bucket
15972 # serving the route, or cache policy must be configured on the same route.
15973 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
15974 },
15975 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
15976 # Unlike the timeout field where the timeout duration starts
15977 # from the time the request has been fully processed (known as*end-of-stream*),
15978 # the duration in this field is computed from the beginning of the stream
15979 # until the response has been processed, including all retries. A
15980 # stream that does not complete in this duration is closed.
15981 #
15982 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
15983 # with the route.
15984 #
15985 # This field is only allowed if the Url map is used with backend services
15986 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
15987 # as a count of seconds and fractions of seconds at nanosecond
15988 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15989 # or &quot;month&quot;. Range is approximately 10,000 years.
15990 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15991 # Durations less than one second are represented with a 0
15992 # `seconds` field and a positive `nanos` field. Must be from 0
15993 # to 999,999,999 inclusive.
15994 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15995 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15996 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15997 },
15998 &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
15999 # are shadowed to a separate mirrored backend service. The load balancer does
16000 # not wait for responses from the shadow service. Before sending traffic
16001 # to the shadow service, the host / authority header is suffixed with-shadow.
16002 #
16003 # Not supported when the URL map is bound to a target gRPC proxy that
16004 # has the validateForProxyless field set to true.
16005 # are shadowed to a separate mirrored backend service. The load balancer
16006 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
16007 # to the shadow service, the host or authority header is suffixed with-shadow.
16008 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
16009 # mirrored to.
16010 #
16011 # The backend service configured for a mirroring
16012 # policy must reference backends that are of the same type as the original
16013 # backend service matched in the URL map.
16014 #
16015 # Serverless NEG backends are not currently supported as a mirrored
16016 # backend service.
16017 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
16018 },
16019 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
16020 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
16021 # If not specified, defaults to 1.
16022 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
16023 #
16024 # If not specified, will use the timeout set in theHttpRouteAction field.
16025 # If timeout in the HttpRouteAction field is not set, this field
16026 # uses the largest timeout
16027 # among all backend services associated with the route.
16028 #
16029 # Not supported when the URL map is bound to a target gRPC proxy that
16030 # has the validateForProxyless field set to true.
16031 # as a count of seconds and fractions of seconds at nanosecond
16032 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16033 # or &quot;month&quot;. Range is approximately 10,000 years.
16034 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16035 # Durations less than one second are represented with a 0
16036 # `seconds` field and a positive `nanos` field. Must be from 0
16037 # to 999,999,999 inclusive.
16038 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16039 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16040 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16041 },
16042 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
16043 # values are:
16044 #
16045 # - 5xx: retry is attempted if the instance or endpoint
16046 # responds with any 5xx response code, or if the instance or
16047 # endpoint does not respond at all. For example, disconnects, reset, read
16048 # timeout, connection failure, and refused streams.
16049 # - gateway-error: Similar to 5xx, but only
16050 # applies to response codes 502, 503 or504.
16051 # - connect-failure: a retry is attempted on failures
16052 # connecting to the instance or endpoint. For example, connection
16053 # timeouts.
16054 # - retriable-4xx: a retry is attempted if the instance
16055 # or endpoint responds with a 4xx response code.
16056 # The only error that you can retry is error code 409.
16057 # - refused-stream: a retry is attempted if the instance
16058 # or endpoint resets the stream with a REFUSED_STREAM error
16059 # code. This reset type indicates that it is safe to retry.
16060 # - cancelled: a retry is attempted if the gRPC status
16061 # code in the response header is set to cancelled.
16062 # - deadline-exceeded: a retry is attempted if the gRPC
16063 # status code in the response header is set todeadline-exceeded.
16064 # - internal: a retry is attempted if the gRPC
16065 # status code in the response header is set tointernal.
16066 # - resource-exhausted: a retry is attempted if the gRPC
16067 # status code in the response header is set toresource-exhausted.
16068 # - unavailable: a retry is attempted if the gRPC
16069 # status code in the response header is set tounavailable.
16070 #
16071 # Only the following codes are supported when the URL map is bound to
16072 # target gRPC proxy that has validateForProxyless field set to true.
16073 #
16074 # - cancelled
16075 # - deadline-exceeded
16076 # - internal
16077 # - resource-exhausted
16078 # - unavailable
16079 &quot;A String&quot;,
16080 ],
16081 },
16082 &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
16083 # time the request has been fully processed (known as *end-of-stream*)
16084 # up until the response has been processed. Timeout includes
16085 # all retries.
16086 #
16087 # If not specified, this field uses the largest timeout among all backend
16088 # services associated with the route.
16089 #
16090 # Not supported when the URL map is bound to a target gRPC proxy that
16091 # has validateForProxyless field set to true.
16092 # as a count of seconds and fractions of seconds at nanosecond
16093 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16094 # or &quot;month&quot;. Range is approximately 10,000 years.
16095 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16096 # Durations less than one second are represented with a 0
16097 # `seconds` field and a positive `nanos` field. Must be from 0
16098 # to 999,999,999 inclusive.
16099 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16100 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16101 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16102 },
16103 &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
16104 # to the matched service.
16105 #
16106 # urlRewrite is the only action supported in UrlMaps
16107 # for classic Application Load Balancers.
16108 #
16109 # Not supported when the URL map is bound to a target gRPC proxy that
16110 # has the validateForProxyless field set to true.
16111 # backend service.
16112 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
16113 # host header is replaced with contents of hostRewrite.
16114 #
16115 # The value must be from 1 to 255 characters.
16116 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
16117 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
16118 #
16119 # The value must be from 1 to 1024 characters.
16120 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
16121 # header) using the HTTP template syntax.
16122 #
16123 # A corresponding
16124 # path_template_match must be specified. Any template variables must exist in
16125 # the path_template_match field.
16126 #
16127 #
16128 # - -At least one variable must be specified in the path_template_match
16129 # field
16130 # - You can omit variables from the rewritten URL
16131 # - The * and ** operators cannot be matched
16132 # unless they have a corresponding variable name - e.g.
16133 # {format=*} or {var=**}.
16134 #
16135 # For example, a path_template_match of /static/{format=**}
16136 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
16137 # rewrite, so that /{country}/{format}/{suffix=**} can be
16138 # rewritten as /content/{format}/{country}/{suffix}.
16139 #
16140 # At least
16141 # one non-empty routeRules[].matchRules[].path_template_match is
16142 # required.
16143 #
16144 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
16145 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
16146 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
16147 # It uses RE2 syntax with the following constraints:
16148 #
16149 #
16150 # - Any single character operators
16151 # - Groups are allowed to have only submatch operator inside
16152 # - Groups are allowed only without any char repetition, e.g.
16153 # .*
16154 # - Any char repetition, e.g. .*, is
16155 # only allowed to be used in a single regex together with:
16156 #
16157 #
16158 # - Empty string operators
16159 # - Other repetitions
16160 # - Ranges
16161 # - Repetitions of ranges
16162 #
16163 #
16164 # - Ranges are only allowed to have:
16165 #
16166 #
16167 # - Character range
16168 # - Digits range
16169 # - Symbols listed in characters allowed for ranges
16170 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
16171 # the path.
16172 },
16173 },
16174 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
16175 # occurs. The weights determine the fraction of traffic that flows to
16176 # their corresponding backend service. If all traffic needs to
16177 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
16178 #
16179 # After a backend service is identified and before forwarding
16180 # the request to
16181 # the backend service, advanced routing actions such as URL rewrites and
16182 # header transformations are applied depending on additional settings
16183 # specified in this HttpRouteAction.
16184 { # In contrast to a single BackendService in
16185 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
16186 # multiple backend services. The volume of traffic for each
16187 # backend service is proportional to the weight specified
16188 # in each WeightedBackendService
16189 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
16190 # resource. Before
16191 # forwarding the request to backendService, the load balancer
16192 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
16193 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
16194 # effect for the selected backendService.
16195 #
16196 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
16197 #
16198 # headerAction is not supported for load balancers that have
16199 # their loadBalancingScheme set to EXTERNAL.
16200 #
16201 # Not supported when the URL map is bound to a target gRPC proxy that
16202 # has validateForProxyless field set to true.
16203 # the request is passed along to the selected backendService.
16204 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
16205 { # Specification determining how headers are added to requests or responses.
16206 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
16207 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
16208 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
16209 # that already
16210 # exist for the header. If true, headerValue is set for the
16211 # header, discarding any values that were set for that header.
16212 #
16213 # The default value is true,
16214 # unless a variable is present in headerValue,
16215 # in which case the default value is false.
16216 # .
16217 },
16218 ],
16219 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
16220 # request before forwarding the request to the backendService.
16221 &quot;A String&quot;,
16222 ],
16223 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
16224 # client.
16225 { # Specification determining how headers are added to requests or responses.
16226 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
16227 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
16228 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
16229 # that already
16230 # exist for the header. If true, headerValue is set for the
16231 # header, discarding any values that were set for that header.
16232 #
16233 # The default value is true,
16234 # unless a variable is present in headerValue,
16235 # in which case the default value is false.
16236 # .
16237 },
16238 ],
16239 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
16240 # response before sending the response back to the client.
16241 &quot;A String&quot;,
16242 ],
16243 },
16244 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
16245 # computed asweight / (sum of all weightedBackendService weights in routeAction).
16246 #
16247 # The selection of a backend service is determined only for new traffic.
16248 # Once a user&#x27;s request has been directed to a backend service,
16249 # subsequent requests are sent to the same backend service as
16250 # determined by the backend service&#x27;s session affinity policy.
16251 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
16252 # splitting. If you do, the weighted traffic splitting configuration takes
16253 # precedence.
16254 #
16255 # The value must be from 0 to 1000.
16256 },
16257 ],
16258 },
16259 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
16260 # is directed if this rule is matched. If routeAction is
16261 # also specified, advanced routing actions, such as URL rewrites,
16262 # take effect before sending the request to the backend.
16263 #
16264 #
16265 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
16266 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
16267 # specified by urlRedirect.
16268 #
16269 #
16270 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
16271 #
16272 #
16273 # Not supported when the URL map is bound to a target gRPC proxy.
16274 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
16275 # was supplied in the request.
16276 #
16277 # The value must be from 1 to 255
16278 # characters.
16279 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
16280 # set to HTTPS.
16281 # If set to false, the URL scheme of the redirected request
16282 # remains the same as that of the request.
16283 #
16284 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
16285 #
16286 # The default is set to false.
16287 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
16288 # that was supplied in the request.
16289 #
16290 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
16291 # supplied, the path of the original request is used for the redirect.
16292 #
16293 # The value must be from 1 to 1024 characters.
16294 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
16295 # the HttpRouteRuleMatch, retaining the remaining portion
16296 # of the URL before redirecting the request.
16297 #
16298 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
16299 # supplied, the path of the original request is used for the redirect.
16300 #
16301 # The value must be from 1 to 1024 characters.
16302 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
16303 #
16304 # Supported values are:
16305 #
16306 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
16307 # to 301.
16308 # - FOUND, which corresponds to 302.
16309 # - SEE_OTHER which corresponds to 303.
16310 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
16311 # method is retained.
16312 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
16313 # method is retained.
16314 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
16315 # URL is
16316 # removed before redirecting the request. If set to false, the
16317 # query portion of the original URL is retained.
16318 #
16319 # The default is set to false.
16320 },
16321 },
16322 ],
16323 },
16324 ],
16325 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the regional URL map resides.
16326 # This field is not applicable to global URL maps.
16327 # You must specify this field as part of the HTTP request URL. It is
16328 # not settable as a field in the request body.
16329 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
16330 &quot;status&quot;: { # [Output Only] The status of the URL map. # Output only. [Output Only] The status of the URL map.
16331 &quot;quotaUsage&quot;: { # Message representing the quota usage for a UrlMap. # Output only. Summary of quota usage for given UrlMap.
16332 &quot;forwardingRules&quot;: 42, # Output only. The number of forwarding rules that uses this UrlMap.
16333 &quot;units&quot;: &quot;A String&quot;, # Output only. The number of quota units calculated for this UrlMap.
16334 },
16335 },
16336 &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
16337 # maximum of 100 tests per UrlMap.
16338 #
16339 # Not supported when the URL map is bound to a target gRPC proxy that
16340 # has validateForProxyless field set to true.
16341 { # Message for the expected URL mappings.
16342 &quot;backendServiceWeight&quot;: 42, # The weight to use for the supplied host and path when using advanced
16343 # routing rules that involve traffic splitting.
16344 &quot;description&quot;: &quot;A String&quot;, # Description of this test case.
16345 &quot;expectedOutputUrl&quot;: &quot;A String&quot;, # The expected output URL evaluated by the load balancer
16346 # containing the scheme, host, path and query parameters.
16347 #
16348 # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
16349 # the load balancer to backends. For rules with urlRewrite,
16350 # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
16351 #
16352 # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer&#x27;s
16353 # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
16354 # If urlRedirect specifies strip_query, the test
16355 # passes only if expectedOutputUrl does not contain any query
16356 # parameters.
16357 #
16358 # expectedOutputUrl is optional whenservice is specified.
16359 &quot;expectedRedirectResponseCode&quot;: 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
16360 # load balancer&#x27;s redirect response.
16361 #
16362 # expectedRedirectResponseCode cannot be set whenservice is set.
16363 &quot;expectedUrlRedirect&quot;: &quot;A String&quot;, # The expected URL that should be redirected to for the host and path
16364 # being tested.
16365 # [Deprecated] This field is deprecated.
16366 # Use expected_output_url instead.
16367 &quot;headers&quot;: [ # HTTP headers for this request. If headers contains
16368 # a host header, then host must also match the header value.
16369 { # HTTP headers used in UrlMapTests.
16370 &quot;name&quot;: &quot;A String&quot;, # Header name.
16371 &quot;value&quot;: &quot;A String&quot;, # Header value.
16372 },
16373 ],
16374 &quot;host&quot;: &quot;A String&quot;, # Host portion of the URL. If headers contains a host header,
16375 # then host must also match the header value.
16376 &quot;path&quot;: &quot;A String&quot;, # Path portion of the URL.
16377 &quot;service&quot;: &quot;A String&quot;, # Expected BackendService or BackendBucket resource
16378 # the given URL should be mapped to.
16379 #
16380 # The service field cannot
16381 # be set if expectedRedirectResponseCode is set.
16382 },
16383 ],
16384 },
16385 ],
16386 &quot;kind&quot;: &quot;compute#urlMapList&quot;, # Output only. Type of resource.
16387 &quot;nextPageToken&quot;: &quot;A String&quot;, # [Output Only] This token allows you to get the next page of results for
16388 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
16389 # the query parameter pageToken in the next list request.
16390 # Subsequent list requests will have their own nextPageToken to
16391 # continue paging through the results.
16392 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource.
16393 &quot;warning&quot;: { # [Output Only] Informational warning message.
16394 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
16395 # Engine returns NO_RESULTS_ON_PAGE if there
16396 # are no results in the response.
16397 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
16398 # value format. For example:
16399 #
16400 # &quot;data&quot;: [
16401 # {
16402 # &quot;key&quot;: &quot;scope&quot;,
16403 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
16404 # }
16405 {
16406 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
16407 # returned. For example, for warnings where there are no results in a list
16408 # request for a particular zone, this key might be scope and
16409 # the key value might be the zone name. Other examples might be a key
16410 # indicating a deprecated resource and a suggested replacement, or a
16411 # warning about invalid network settings (for example, if an instance
16412 # attempts to perform IP forwarding but is not enabled for IP forwarding).
16413 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
16414 },
16415 ],
16416 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
16417 },
16418 }</pre>
16419 </div>
16420
16421 <div class="method">
16422 <code class="details" id="list_next">list_next()</code>
16423 <pre>Retrieves the next page of results.
16424
16425 Args:
16426 previous_request: The request for the previous page. (required)
16427 previous_response: The response from the request for the previous page. (required)
16428
16429 Returns:
16430 A request object that you can call &#x27;execute()&#x27; on to request the next
16431 page. Returns None if there are no more items in the collection.
16432 </pre>
16433 </div>
16434
16435 <div class="method">
16436 <code class="details" id="patch">patch(project, urlMap, body=None, requestId=None, x__xgafv=None)</code>
16437 <pre>Patches the specified UrlMap resource with the data included in the
16438 request. This method supportsPATCH
16439 semantics and uses theJSON merge
16440 patch format and processing rules.
16441
16442 Args:
16443 project: string, Project ID for this request. (required)
16444 urlMap: string, Name of the UrlMap resource to patch. (required)
16445 body: object, The request body.
16446 The object takes the form of:
16447
16448 { # Represents a URL Map resource.
16449 #
16450 # Compute Engine has two URL Map resources:
16451 #
16452 # * [Global](/compute/docs/reference/rest/alpha/urlMaps)
16453 # * [Regional](/compute/docs/reference/rest/alpha/regionUrlMaps)
16454 #
16455 # A URL map resource is a component of certain types of cloud load balancers
16456 # and Traffic Director:
16457 #
16458 # * urlMaps are used by global external Application Load
16459 # Balancers, classic Application Load Balancers, and cross-region internal
16460 # Application Load Balancers.
16461 # * regionUrlMaps are used by internal Application Load Balancers,
16462 # regional external Application Load Balancers and regional internal
16463 # Application Load Balancers.
16464 #
16465 # For a list of supported URL map features by the load balancer type, see the
16466 # Load balancing features: Routing and traffic management table.
16467 #
16468 # For a list of supported URL map features for Traffic Director, see the
16469 # Traffic Director features: Routing and traffic management table.
16470 #
16471 # This resource defines mappings from hostnames and URL paths to either a
16472 # backend service or a backend bucket.
16473 #
16474 # To use the global urlMaps resource, the backend service must
16475 # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
16476 # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
16477 # information, read URL
16478 # Map Concepts.
16479 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
16480 # text format.
16481 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
16482 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
16483 #
16484 # This policy takes
16485 # effect at the load balancer level and applies only when no policy has been
16486 # defined for the error code at lower levels like PathMatcher, RouteRule and
16487 # PathRule within this UrlMap.
16488 #
16489 # For example, consider a UrlMap with the
16490 # following configuration:
16491 #
16492 #
16493 # - defaultCustomErrorResponsePolicy containing policies for
16494 # responding to 5xx and 4xx errors
16495 # - A PathMatcher configured for *.example.com has
16496 # defaultCustomErrorResponsePolicy for 4xx.
16497 #
16498 # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
16499 # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
16500 # a request that does not match any host in *.example.com such
16501 # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
16502 # takes effect.
16503 #
16504 # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
16505 # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
16506 # a retry, if load balancer is successful in reaching the
16507 # service, the defaultCustomErrorResponsePolicy is ignored and
16508 # the response from the service is returned to the client.
16509 #
16510 # defaultCustomErrorResponsePolicy is supported only for
16511 # global external Application Load Balancers.
16512 # backend service or backend bucket responds with an error.
16513 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
16514 #
16515 # In a given policy, if you specify rules for both a range of error codes
16516 # as well as rules for specific error codes then rules with specific error
16517 # codes have a higher priority. For example, assume that you configure a rule
16518 # for 401 (Un-authorized) code, and another for all 4 series
16519 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
16520 # However if the backend service returns a 403, the rule for4xx takes effect.
16521 { # Specifies the mapping between the response code that will be returned along
16522 # with the custom error content and the response code returned by the backend
16523 # service.
16524 &quot;matchResponseCodes&quot;: [ # Valid values include:
16525 #
16526 #
16527 # - A number between 400 and 599: For example
16528 # 401 or 503, in which case the load balancer
16529 # applies the policy if the error code exactly matches this value.
16530 # - 5xx: Load Balancer will apply the policy if the
16531 # backend service responds with any response code in the range of
16532 # 500 to 599.
16533 # - 4xx: Load
16534 # Balancer will apply the policy if the backend service responds with any
16535 # response code in the range of 400 to
16536 # 499.
16537 #
16538 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
16539 &quot;A String&quot;,
16540 ],
16541 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
16542 # error content. If overrideResponseCode is not supplied, the
16543 # same response code returned by the original backend bucket or backend
16544 # service is returned to the client.
16545 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
16546 #
16547 # path must start
16548 # with a leading slash. path cannot have trailing slashes.
16549 #
16550 # If the file is not available in backendBucket or the
16551 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
16552 #
16553 # The value must
16554 # be from 1 to 1024 characters
16555 },
16556 ],
16557 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
16558 # contains the custom error content. Examples are:
16559 #
16560 #
16561 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
16562 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
16563 # - global/backendBuckets/myBackendBucket
16564 #
16565 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
16566 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
16567 #
16568 # If load balancer cannot reach
16569 # the backendBucket, a simple Not Found Error will
16570 # be returned, with the original response code (oroverrideResponseCode if configured).
16571 #
16572 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
16573 },
16574 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
16575 # hostRules match. The load balancer performs advanced routing
16576 # actions, such as URL rewrites and header transformations, before forwarding
16577 # the request to the selected backend.
16578 #
16579 #
16580 # Only one of defaultUrlRedirect, defaultService
16581 # or defaultRouteAction.weightedBackendService can be set.
16582 #
16583 #
16584 # URL maps for classic Application Load Balancers only support
16585 # the urlRewrite action within defaultRouteAction.
16586 #
16587 #
16588 # defaultRouteAction has no effect when the URL map is bound
16589 # to a target gRPC proxy that has the validateForProxyless field
16590 # set to true.
16591 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
16592 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
16593 # property must be specified. This policy cannot be specified if any target
16594 # backend has Identity-Aware Proxy enabled.
16595 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
16596 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
16597 # header names can be specified. The cache is bypassed for all `cacheMode`
16598 # values.
16599 &quot;A String&quot;,
16600 ],
16601 &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
16602 # on the backend type: for Backend Services, the complete request URI is
16603 # used; for Backend Buckets, the request URI is used without the protocol or
16604 # host, and only query parameters known to Cloud Storage are included.
16605 # Policy defined on Route Action.
16606 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
16607 # parameters will be included. Either specify `excludedQueryParameters`
16608 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
16609 # encoded and not treated as delimiters.
16610 #
16611 # Note: This field applies to routes that use backend services. Attempting
16612 # to set it on a route that points exclusively to Backend Buckets will
16613 # result in a configuration error. For routes that point to a Backend
16614 # Bucket, use `includedQueryParameters` to define which parameters should
16615 # be part of the cache key.
16616 &quot;A String&quot;,
16617 ],
16618 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
16619 #
16620 # Note: This setting is only applicable to routes that use a Backend
16621 # Service. It does not affect requests served by a Backend Bucket, as the
16622 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
16623 # it on a route that points exclusively to Backend Buckets will result in a
16624 # configuration error.
16625 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
16626 #
16627 # Note: This setting is only applicable to routes that use a Backend
16628 # Service. It does not affect requests served by a Backend Bucket, as the
16629 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
16630 # set on a route that points exclusively to Backend Buckets will result in
16631 # a configuration error.
16632 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
16633 # `includedQueryParameters` and `excludedQueryParameters`. If neither
16634 # is set, the entire query string will be included. If false, the query
16635 # string will be excluded from the cache key entirely.
16636 #
16637 # Note: This field applies to routes that use backend services. Attempting
16638 # to set it on a route that points exclusively to Backend Buckets will
16639 # result in a configuration error. For routes that point to a Backend
16640 # Bucket, use `includedQueryParameters` to define which parameters should
16641 # be part of the cache key.
16642 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
16643 # The name=value pair will be used in the cache key Cloud CDN generates.
16644 #
16645 # Note: This setting is only applicable to routes that use a Backend
16646 # Service. It does not affect requests served by a Backend Bucket.
16647 # Attempting to set it on a route that points exclusively to Backend
16648 # Buckets will result in a configuration error. Up to 5 cookie names can be
16649 # specified.
16650 &quot;A String&quot;,
16651 ],
16652 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
16653 &quot;A String&quot;,
16654 ],
16655 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
16656 # parameters will be excluded. Either specify `includedQueryParameters`
16657 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
16658 # encoded and not treated as delimiters.
16659 &quot;A String&quot;,
16660 ],
16661 },
16662 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
16663 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
16664 &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
16665 # content. This is used to clamp the max-age (or Expires) value sent to the
16666 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
16667 # is used for the response max-age directive, along with a &quot;public&quot;
16668 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
16669 # clamps the max-age from the origin (if specified), or else sets the
16670 # response max-age directive to the lesser of the `clientTtl` and
16671 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
16672 # present. The maximum allowed value is 31,622,400s (1 year). If not
16673 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
16674 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
16675 # `USE_ORIGIN_HEADERS`.
16676 # as a count of seconds and fractions of seconds at nanosecond
16677 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16678 # or &quot;month&quot;. Range is approximately 10,000 years.
16679 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16680 # Durations less than one second are represented with a 0
16681 # `seconds` field and a positive `nanos` field. Must be from 0
16682 # to 999,999,999 inclusive.
16683 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16684 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16685 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16686 },
16687 &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
16688 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
16689 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
16690 # greater than that of `maxTtl`. When the `cacheMode` is set to
16691 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
16692 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
16693 # accessed objects may be evicted from the cache before the defined TTL. If
16694 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
16695 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
16696 # `USE_ORIGIN_HEADERS`.
16697 # as a count of seconds and fractions of seconds at nanosecond
16698 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16699 # or &quot;month&quot;. Range is approximately 10,000 years.
16700 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16701 # Durations less than one second are represented with a 0
16702 # `seconds` field and a positive `nanos` field. Must be from 0
16703 # to 999,999,999 inclusive.
16704 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16705 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16706 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16707 },
16708 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
16709 # attempt to set a max-age or s-maxage higher than this, or an Expires header
16710 # more than `maxTtl` seconds in the future will be capped at the value of
16711 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
16712 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
16713 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
16714 # Infrequently accessed objects may be evicted from the cache before the
16715 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
16716 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
16717 # mode.
16718 # as a count of seconds and fractions of seconds at nanosecond
16719 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16720 # or &quot;month&quot;. Range is approximately 10,000 years.
16721 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16722 # Durations less than one second are represented with a 0
16723 # `seconds` field and a positive `nanos` field. Must be from 0
16724 # to 999,999,999 inclusive.
16725 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16726 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16727 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16728 },
16729 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
16730 # to apply fine-grained caching for common errors or redirects.
16731 # This can reduce the load on your origin and improve end-user
16732 # experience by reducing response latency.
16733 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
16734 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
16735 # the specified response code that lack any Cache-Control, Expires, or
16736 # Pragma: no-cache directives. When the `cacheMode` is set to
16737 # `FORCE_CACHE_ALL`, negative caching applies to all responses
16738 # with the specified response code, and overrides any caching headers. By
16739 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
16740 #
16741 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
16742 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
16743 # * 405 (Method Not Found), 501 (Not Implemented): 60s
16744 #
16745 # These defaults can be overridden in `negativeCachingPolicy`.
16746 # If not specified, Cloud CDN applies negative caching by default.
16747 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
16748 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
16749 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
16750 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
16751 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
16752 # all response codes that you wish to cache. Cloud CDN will not apply any
16753 # default negative caching when a policy exists.
16754 { # Specify CDN TTLs for response error codes.
16755 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
16756 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
16757 # specified as values, and you cannot specify a status code more than
16758 # once.
16759 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
16760 # corresponding status code.
16761 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
16762 # objects may be evicted from the cache before the defined TTL.
16763 # as a count of seconds and fractions of seconds at nanosecond
16764 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16765 # or &quot;month&quot;. Range is approximately 10,000 years.
16766 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16767 # Durations less than one second are represented with a 0
16768 # `seconds` field and a positive `nanos` field. Must be from 0
16769 # to 999,999,999 inclusive.
16770 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16771 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16772 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16773 },
16774 },
16775 ],
16776 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
16777 # requests into a small number of requests to the origin. If not specified,
16778 # Cloud CDN applies request coalescing by default.
16779 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
16780 # content with the origin, or when an error is encountered when refreshing
16781 # the cache.
16782 # This setting defines the default &quot;max-stale&quot; duration for any cached
16783 # responses that do not specify a max-stale directive. Stale responses that
16784 # exceed the TTL configured here will not be served. The default limit
16785 # (max-stale) is 86400s (1 day), which will allow stale content to be
16786 # served up to this limit beyond the max-age (or s-maxage) of a cached
16787 # response.
16788 # The maximum allowed value is 604800 (1 week).
16789 # Set this to zero (0) to disable serve-while-stale.
16790 # as a count of seconds and fractions of seconds at nanosecond
16791 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16792 # or &quot;month&quot;. Range is approximately 10,000 years.
16793 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16794 # Durations less than one second are represented with a 0
16795 # `seconds` field and a positive `nanos` field. Must be from 0
16796 # to 999,999,999 inclusive.
16797 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16798 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16799 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16800 },
16801 },
16802 &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
16803 # information about the W3C recommendation for cross-origin resource sharing
16804 # (CORS), see Fetch API Living
16805 # Standard.
16806 #
16807 # Not supported when the URL map is bound to a target gRPC proxy.
16808 # information about the W3C recommendation for cross-origin resource sharing
16809 # (CORS), see Fetch API Living
16810 # Standard.
16811 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
16812 # indicates that
16813 # the actual request can include user credentials. This field translates to
16814 # the Access-Control-Allow-Credentials header.
16815 #
16816 # Default is false.
16817 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
16818 # header.
16819 &quot;A String&quot;,
16820 ],
16821 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
16822 # header.
16823 &quot;A String&quot;,
16824 ],
16825 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
16826 # more information, see regular expression syntax.
16827 #
16828 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
16829 #
16830 # Regular expressions can only be used when the loadBalancingScheme is
16831 # set to INTERNAL_SELF_MANAGED.
16832 &quot;A String&quot;,
16833 ],
16834 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
16835 #
16836 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
16837 &quot;A String&quot;,
16838 ],
16839 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
16840 # The default value is false, which indicates that the CORS
16841 # policy is in effect.
16842 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
16843 # header.
16844 &quot;A String&quot;,
16845 ],
16846 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
16847 # seconds. This field translates to the Access-Control-Max-Age
16848 # header.
16849 },
16850 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
16851 # the resiliency of clients to backend service failure. As part of fault
16852 # injection, when clients send requests to a backend service, delays can be
16853 # introduced by a load balancer on a percentage of requests before sending
16854 # those requests to the backend service. Similarly requests from clients can
16855 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
16856 # that are configured with a fault_injection_policy if:
16857 # 1. The traffic is generated by fault injection AND
16858 # 2. The fault injection is not a delay fault injection.
16859 # Fault injection is not supported with the classic Application Load Balancer
16860 # . To see which load balancers support fault injection,
16861 # see Load
16862 # balancing: Routing and traffic management features.
16863 # the resiliency of clients to backend service failure. As part of fault
16864 # injection, when clients send requests to a backend service, delays can be
16865 # introduced by the load balancer on a percentage of requests before sending
16866 # those request to the backend service. Similarly requests from clients can be
16867 # aborted by the load balancer for a percentage of requests.
16868 &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
16869 # injection.
16870 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
16871 #
16872 # The value must be from 200 to 599 inclusive.
16873 #
16874 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
16875 # according to this
16876 # mapping table. HTTP status 200 is mapped to gRPC status
16877 # UNKNOWN. Injecting an OK status is currently not supported by
16878 # Traffic Director.
16879 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
16880 # that is aborted as part of fault injection.
16881 #
16882 # The value must be from 0.0 to 100.0 inclusive.
16883 },
16884 &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
16885 # injection, before being sent to a backend service.
16886 # request to the backend service as part of fault injection.
16887 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
16888 # as a count of seconds and fractions of seconds at nanosecond
16889 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16890 # or &quot;month&quot;. Range is approximately 10,000 years.
16891 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16892 # Durations less than one second are represented with a 0
16893 # `seconds` field and a positive `nanos` field. Must be from 0
16894 # to 999,999,999 inclusive.
16895 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16896 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16897 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16898 },
16899 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
16900 # which a delay is introduced as part of fault injection.
16901 #
16902 # The value must be from 0.0 to 100.0 inclusive.
16903 },
16904 },
16905 &quot;imageOptimizationPolicy&quot;: { # The configuration for Cloud CDN&#x27;s image optimization feature. This feature # Image optimization policy for this URL Map&#x27;s route. Available only for
16906 # Global EXTERNAL_MANAGED load balancer schemes.
16907 # Either Cloud CDN must be enabled on the backend service or backend bucket
16908 # serving the route, or cache policy must be configured on the same route
16909 # dynamically processes and delivers images from the network edge.
16910 # Image Optimization is only available for Global External Application Load
16911 # Balancers.
16912 # Either Cloud CDN must be enabled on the backend service or backend bucket
16913 # serving the route, or cache policy must be configured on the same route.
16914 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
16915 },
16916 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
16917 # Unlike the timeout field where the timeout duration starts
16918 # from the time the request has been fully processed (known as*end-of-stream*),
16919 # the duration in this field is computed from the beginning of the stream
16920 # until the response has been processed, including all retries. A
16921 # stream that does not complete in this duration is closed.
16922 #
16923 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
16924 # with the route.
16925 #
16926 # This field is only allowed if the Url map is used with backend services
16927 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
16928 # as a count of seconds and fractions of seconds at nanosecond
16929 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16930 # or &quot;month&quot;. Range is approximately 10,000 years.
16931 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16932 # Durations less than one second are represented with a 0
16933 # `seconds` field and a positive `nanos` field. Must be from 0
16934 # to 999,999,999 inclusive.
16935 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16936 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16937 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16938 },
16939 &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
16940 # are shadowed to a separate mirrored backend service. The load balancer does
16941 # not wait for responses from the shadow service. Before sending traffic
16942 # to the shadow service, the host / authority header is suffixed with-shadow.
16943 #
16944 # Not supported when the URL map is bound to a target gRPC proxy that
16945 # has the validateForProxyless field set to true.
16946 # are shadowed to a separate mirrored backend service. The load balancer
16947 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
16948 # to the shadow service, the host or authority header is suffixed with-shadow.
16949 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
16950 # mirrored to.
16951 #
16952 # The backend service configured for a mirroring
16953 # policy must reference backends that are of the same type as the original
16954 # backend service matched in the URL map.
16955 #
16956 # Serverless NEG backends are not currently supported as a mirrored
16957 # backend service.
16958 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
16959 },
16960 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
16961 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
16962 # If not specified, defaults to 1.
16963 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
16964 #
16965 # If not specified, will use the timeout set in theHttpRouteAction field.
16966 # If timeout in the HttpRouteAction field is not set, this field
16967 # uses the largest timeout
16968 # among all backend services associated with the route.
16969 #
16970 # Not supported when the URL map is bound to a target gRPC proxy that
16971 # has the validateForProxyless field set to true.
16972 # as a count of seconds and fractions of seconds at nanosecond
16973 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16974 # or &quot;month&quot;. Range is approximately 10,000 years.
16975 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16976 # Durations less than one second are represented with a 0
16977 # `seconds` field and a positive `nanos` field. Must be from 0
16978 # to 999,999,999 inclusive.
16979 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16980 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16981 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16982 },
16983 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
16984 # values are:
16985 #
16986 # - 5xx: retry is attempted if the instance or endpoint
16987 # responds with any 5xx response code, or if the instance or
16988 # endpoint does not respond at all. For example, disconnects, reset, read
16989 # timeout, connection failure, and refused streams.
16990 # - gateway-error: Similar to 5xx, but only
16991 # applies to response codes 502, 503 or504.
16992 # - connect-failure: a retry is attempted on failures
16993 # connecting to the instance or endpoint. For example, connection
16994 # timeouts.
16995 # - retriable-4xx: a retry is attempted if the instance
16996 # or endpoint responds with a 4xx response code.
16997 # The only error that you can retry is error code 409.
16998 # - refused-stream: a retry is attempted if the instance
16999 # or endpoint resets the stream with a REFUSED_STREAM error
17000 # code. This reset type indicates that it is safe to retry.
17001 # - cancelled: a retry is attempted if the gRPC status
17002 # code in the response header is set to cancelled.
17003 # - deadline-exceeded: a retry is attempted if the gRPC
17004 # status code in the response header is set todeadline-exceeded.
17005 # - internal: a retry is attempted if the gRPC
17006 # status code in the response header is set tointernal.
17007 # - resource-exhausted: a retry is attempted if the gRPC
17008 # status code in the response header is set toresource-exhausted.
17009 # - unavailable: a retry is attempted if the gRPC
17010 # status code in the response header is set tounavailable.
17011 #
17012 # Only the following codes are supported when the URL map is bound to
17013 # target gRPC proxy that has validateForProxyless field set to true.
17014 #
17015 # - cancelled
17016 # - deadline-exceeded
17017 # - internal
17018 # - resource-exhausted
17019 # - unavailable
17020 &quot;A String&quot;,
17021 ],
17022 },
17023 &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
17024 # time the request has been fully processed (known as *end-of-stream*)
17025 # up until the response has been processed. Timeout includes
17026 # all retries.
17027 #
17028 # If not specified, this field uses the largest timeout among all backend
17029 # services associated with the route.
17030 #
17031 # Not supported when the URL map is bound to a target gRPC proxy that
17032 # has validateForProxyless field set to true.
17033 # as a count of seconds and fractions of seconds at nanosecond
17034 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17035 # or &quot;month&quot;. Range is approximately 10,000 years.
17036 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17037 # Durations less than one second are represented with a 0
17038 # `seconds` field and a positive `nanos` field. Must be from 0
17039 # to 999,999,999 inclusive.
17040 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17041 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17042 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17043 },
17044 &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
17045 # to the matched service.
17046 #
17047 # urlRewrite is the only action supported in UrlMaps
17048 # for classic Application Load Balancers.
17049 #
17050 # Not supported when the URL map is bound to a target gRPC proxy that
17051 # has the validateForProxyless field set to true.
17052 # backend service.
17053 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
17054 # host header is replaced with contents of hostRewrite.
17055 #
17056 # The value must be from 1 to 255 characters.
17057 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
17058 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
17059 #
17060 # The value must be from 1 to 1024 characters.
17061 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
17062 # header) using the HTTP template syntax.
17063 #
17064 # A corresponding
17065 # path_template_match must be specified. Any template variables must exist in
17066 # the path_template_match field.
17067 #
17068 #
17069 # - -At least one variable must be specified in the path_template_match
17070 # field
17071 # - You can omit variables from the rewritten URL
17072 # - The * and ** operators cannot be matched
17073 # unless they have a corresponding variable name - e.g.
17074 # {format=*} or {var=**}.
17075 #
17076 # For example, a path_template_match of /static/{format=**}
17077 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
17078 # rewrite, so that /{country}/{format}/{suffix=**} can be
17079 # rewritten as /content/{format}/{country}/{suffix}.
17080 #
17081 # At least
17082 # one non-empty routeRules[].matchRules[].path_template_match is
17083 # required.
17084 #
17085 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
17086 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
17087 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
17088 # It uses RE2 syntax with the following constraints:
17089 #
17090 #
17091 # - Any single character operators
17092 # - Groups are allowed to have only submatch operator inside
17093 # - Groups are allowed only without any char repetition, e.g.
17094 # .*
17095 # - Any char repetition, e.g. .*, is
17096 # only allowed to be used in a single regex together with:
17097 #
17098 #
17099 # - Empty string operators
17100 # - Other repetitions
17101 # - Ranges
17102 # - Repetitions of ranges
17103 #
17104 #
17105 # - Ranges are only allowed to have:
17106 #
17107 #
17108 # - Character range
17109 # - Digits range
17110 # - Symbols listed in characters allowed for ranges
17111 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
17112 # the path.
17113 },
17114 },
17115 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
17116 # occurs. The weights determine the fraction of traffic that flows to
17117 # their corresponding backend service. If all traffic needs to
17118 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
17119 #
17120 # After a backend service is identified and before forwarding
17121 # the request to
17122 # the backend service, advanced routing actions such as URL rewrites and
17123 # header transformations are applied depending on additional settings
17124 # specified in this HttpRouteAction.
17125 { # In contrast to a single BackendService in
17126 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
17127 # multiple backend services. The volume of traffic for each
17128 # backend service is proportional to the weight specified
17129 # in each WeightedBackendService
17130 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
17131 # resource. Before
17132 # forwarding the request to backendService, the load balancer
17133 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
17134 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
17135 # effect for the selected backendService.
17136 #
17137 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
17138 #
17139 # headerAction is not supported for load balancers that have
17140 # their loadBalancingScheme set to EXTERNAL.
17141 #
17142 # Not supported when the URL map is bound to a target gRPC proxy that
17143 # has validateForProxyless field set to true.
17144 # the request is passed along to the selected backendService.
17145 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
17146 { # Specification determining how headers are added to requests or responses.
17147 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
17148 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
17149 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
17150 # that already
17151 # exist for the header. If true, headerValue is set for the
17152 # header, discarding any values that were set for that header.
17153 #
17154 # The default value is true,
17155 # unless a variable is present in headerValue,
17156 # in which case the default value is false.
17157 # .
17158 },
17159 ],
17160 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
17161 # request before forwarding the request to the backendService.
17162 &quot;A String&quot;,
17163 ],
17164 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
17165 # client.
17166 { # Specification determining how headers are added to requests or responses.
17167 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
17168 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
17169 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
17170 # that already
17171 # exist for the header. If true, headerValue is set for the
17172 # header, discarding any values that were set for that header.
17173 #
17174 # The default value is true,
17175 # unless a variable is present in headerValue,
17176 # in which case the default value is false.
17177 # .
17178 },
17179 ],
17180 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
17181 # response before sending the response back to the client.
17182 &quot;A String&quot;,
17183 ],
17184 },
17185 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
17186 # computed asweight / (sum of all weightedBackendService weights in routeAction).
17187 #
17188 # The selection of a backend service is determined only for new traffic.
17189 # Once a user&#x27;s request has been directed to a backend service,
17190 # subsequent requests are sent to the same backend service as
17191 # determined by the backend service&#x27;s session affinity policy.
17192 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
17193 # splitting. If you do, the weighted traffic splitting configuration takes
17194 # precedence.
17195 #
17196 # The value must be from 0 to 1000.
17197 },
17198 ],
17199 },
17200 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL of the defaultService resource to
17201 # which traffic is directed if none of the hostRules match.
17202 # If defaultRouteAction is also specified, advanced
17203 # routing actions, such as URL rewrites, take effect before sending the
17204 # request to the backend.
17205 #
17206 #
17207 # Only one of defaultUrlRedirect, defaultService
17208 # or defaultRouteAction.weightedBackendService can be set.
17209 #
17210 #
17211 # defaultService has no effect when the URL map is bound
17212 # to a target gRPC proxy that has the validateForProxyless field
17213 # set to true.
17214 &quot;defaultUrlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
17215 # is redirected to a URL specified by defaultUrlRedirect.
17216 #
17217 #
17218 # Only one of defaultUrlRedirect, defaultService
17219 # or defaultRouteAction.weightedBackendService can be set.
17220 #
17221 #
17222 # Not supported when the URL map is bound to a target gRPC proxy.
17223 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
17224 # was supplied in the request.
17225 #
17226 # The value must be from 1 to 255
17227 # characters.
17228 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
17229 # set to HTTPS.
17230 # If set to false, the URL scheme of the redirected request
17231 # remains the same as that of the request.
17232 #
17233 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
17234 #
17235 # The default is set to false.
17236 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
17237 # that was supplied in the request.
17238 #
17239 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
17240 # supplied, the path of the original request is used for the redirect.
17241 #
17242 # The value must be from 1 to 1024 characters.
17243 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
17244 # the HttpRouteRuleMatch, retaining the remaining portion
17245 # of the URL before redirecting the request.
17246 #
17247 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
17248 # supplied, the path of the original request is used for the redirect.
17249 #
17250 # The value must be from 1 to 1024 characters.
17251 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
17252 #
17253 # Supported values are:
17254 #
17255 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
17256 # to 301.
17257 # - FOUND, which corresponds to 302.
17258 # - SEE_OTHER which corresponds to 303.
17259 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
17260 # method is retained.
17261 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
17262 # method is retained.
17263 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
17264 # URL is
17265 # removed before redirecting the request. If set to false, the
17266 # query portion of the original URL is retained.
17267 #
17268 # The default is set to false.
17269 },
17270 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
17271 # create the resource.
17272 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. A hash of the contents stored in this object.
17273 # This field is used in optimistic locking. This field is ignored when
17274 # inserting a UrlMap. An up-to-date fingerprint must be provided
17275 # in order to update the UrlMap, otherwise the request will
17276 # fail with error 412 conditionNotMet.
17277 #
17278 # To see the latest fingerprint, make a get() request to
17279 # retrieve a UrlMap.
17280 &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
17281 # for the selected backendService.
17282 #
17283 # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
17284 #
17285 # headerAction is not supported for load balancers
17286 # that have
17287 # their loadBalancingScheme set to EXTERNAL.
17288 #
17289 # Not supported when the URL map is bound to a target gRPC proxy that
17290 # has validateForProxyless field set to true.
17291 # the request is passed along to the selected backendService.
17292 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
17293 { # Specification determining how headers are added to requests or responses.
17294 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
17295 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
17296 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
17297 # that already
17298 # exist for the header. If true, headerValue is set for the
17299 # header, discarding any values that were set for that header.
17300 #
17301 # The default value is true,
17302 # unless a variable is present in headerValue,
17303 # in which case the default value is false.
17304 # .
17305 },
17306 ],
17307 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
17308 # request before forwarding the request to the backendService.
17309 &quot;A String&quot;,
17310 ],
17311 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
17312 # client.
17313 { # Specification determining how headers are added to requests or responses.
17314 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
17315 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
17316 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
17317 # that already
17318 # exist for the header. If true, headerValue is set for the
17319 # header, discarding any values that were set for that header.
17320 #
17321 # The default value is true,
17322 # unless a variable is present in headerValue,
17323 # in which case the default value is false.
17324 # .
17325 },
17326 ],
17327 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
17328 # response before sending the response back to the client.
17329 &quot;A String&quot;,
17330 ],
17331 },
17332 &quot;hostRules&quot;: [ # The list of host rules to use against the URL.
17333 { # UrlMaps
17334 # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
17335 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
17336 # create the resource.
17337 &quot;hosts&quot;: [ # The list of host patterns to match. They must be valid hostnames with
17338 # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
17339 # that case, * must be the first character, and if followed by
17340 # anything, the immediate following character must be either -
17341 # or ..
17342 #
17343 # * based matching is not supported when the URL map is bound
17344 # to a target gRPC proxy that has the validateForProxyless field
17345 # set to true.
17346 &quot;A String&quot;,
17347 ],
17348 &quot;pathMatcher&quot;: &quot;A String&quot;, # The name of the PathMatcher to use to match the path portion
17349 # of the URL if the hostRule matches the URL&#x27;s host portion.
17350 },
17351 ],
17352 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the resource. This identifier is
17353 # defined by the server.
17354 &quot;kind&quot;: &quot;compute#urlMap&quot;, # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
17355 # url maps.
17356 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
17357 # The name must be 1-63 characters long, and comply withRFC1035.
17358 # Specifically, the name must be 1-63 characters long and match the regular
17359 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
17360 # character must be a lowercase letter, and all following characters must
17361 # be a dash, lowercase letter, or digit, except the last character, which
17362 # cannot be a dash.
17363 &quot;pathMatchers&quot;: [ # The list of named PathMatchers to use against the URL.
17364 { # A matcher for the path portion of the URL. The BackendService
17365 # from the longest-matched rule will serve the URL. If no rule was matched, the
17366 # default service is used.
17367 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
17368 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
17369 #
17370 # This policy takes
17371 # effect at the PathMatcher level and applies only when no
17372 # 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
17373 # in defaultCustomErrorResponsePolicy, then a policy defined for
17374 # the error code in UrlMap.defaultCustomErrorResponsePolicy
17375 # takes effect.
17376 #
17377 # For example, consider a UrlMap with the following
17378 # configuration:
17379 #
17380 #
17381 # - UrlMap.defaultCustomErrorResponsePolicy is configured
17382 # with policies for 5xx and 4xx errors
17383 # - A RouteRule for /coming_soon/ is configured for the
17384 # error code 404.
17385 #
17386 # 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
17387 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
17388 # the policy in RouteRule.customErrorResponsePolicy takes
17389 # effect. If any of the requests in this example encounter a 500
17390 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
17391 #
17392 # When
17393 # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
17394 # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
17395 # a retry, if load balancer is successful in reaching the
17396 # service, the defaultCustomErrorResponsePolicy is ignored and
17397 # the response from the service is returned to the client.
17398 #
17399 # defaultCustomErrorResponsePolicy is supported only for
17400 # global external Application Load Balancers.
17401 # backend service or backend bucket responds with an error.
17402 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
17403 #
17404 # In a given policy, if you specify rules for both a range of error codes
17405 # as well as rules for specific error codes then rules with specific error
17406 # codes have a higher priority. For example, assume that you configure a rule
17407 # for 401 (Un-authorized) code, and another for all 4 series
17408 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
17409 # However if the backend service returns a 403, the rule for4xx takes effect.
17410 { # Specifies the mapping between the response code that will be returned along
17411 # with the custom error content and the response code returned by the backend
17412 # service.
17413 &quot;matchResponseCodes&quot;: [ # Valid values include:
17414 #
17415 #
17416 # - A number between 400 and 599: For example
17417 # 401 or 503, in which case the load balancer
17418 # applies the policy if the error code exactly matches this value.
17419 # - 5xx: Load Balancer will apply the policy if the
17420 # backend service responds with any response code in the range of
17421 # 500 to 599.
17422 # - 4xx: Load
17423 # Balancer will apply the policy if the backend service responds with any
17424 # response code in the range of 400 to
17425 # 499.
17426 #
17427 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
17428 &quot;A String&quot;,
17429 ],
17430 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
17431 # error content. If overrideResponseCode is not supplied, the
17432 # same response code returned by the original backend bucket or backend
17433 # service is returned to the client.
17434 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
17435 #
17436 # path must start
17437 # with a leading slash. path cannot have trailing slashes.
17438 #
17439 # If the file is not available in backendBucket or the
17440 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
17441 #
17442 # The value must
17443 # be from 1 to 1024 characters
17444 },
17445 ],
17446 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
17447 # contains the custom error content. Examples are:
17448 #
17449 #
17450 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
17451 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
17452 # - global/backendBuckets/myBackendBucket
17453 #
17454 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
17455 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
17456 #
17457 # If load balancer cannot reach
17458 # the backendBucket, a simple Not Found Error will
17459 # be returned, with the original response code (oroverrideResponseCode if configured).
17460 #
17461 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
17462 },
17463 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
17464 # pathRules or routeRules match. The load balancer
17465 # performs advanced routing actions, such as URL rewrites and
17466 # header transformations, before forwarding the request to the
17467 # selected backend.
17468 #
17469 #
17470 # Only one of defaultUrlRedirect, defaultService
17471 # or defaultRouteAction.weightedBackendService can be set.
17472 #
17473 #
17474 # URL maps for classic Application Load Balancers only support
17475 # the urlRewrite action within a path matcher&#x27;sdefaultRouteAction.
17476 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
17477 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
17478 # property must be specified. This policy cannot be specified if any target
17479 # backend has Identity-Aware Proxy enabled.
17480 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
17481 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
17482 # header names can be specified. The cache is bypassed for all `cacheMode`
17483 # values.
17484 &quot;A String&quot;,
17485 ],
17486 &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
17487 # on the backend type: for Backend Services, the complete request URI is
17488 # used; for Backend Buckets, the request URI is used without the protocol or
17489 # host, and only query parameters known to Cloud Storage are included.
17490 # Policy defined on Route Action.
17491 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
17492 # parameters will be included. Either specify `excludedQueryParameters`
17493 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
17494 # encoded and not treated as delimiters.
17495 #
17496 # Note: This field applies to routes that use backend services. Attempting
17497 # to set it on a route that points exclusively to Backend Buckets will
17498 # result in a configuration error. For routes that point to a Backend
17499 # Bucket, use `includedQueryParameters` to define which parameters should
17500 # be part of the cache key.
17501 &quot;A String&quot;,
17502 ],
17503 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
17504 #
17505 # Note: This setting is only applicable to routes that use a Backend
17506 # Service. It does not affect requests served by a Backend Bucket, as the
17507 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
17508 # it on a route that points exclusively to Backend Buckets will result in a
17509 # configuration error.
17510 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
17511 #
17512 # Note: This setting is only applicable to routes that use a Backend
17513 # Service. It does not affect requests served by a Backend Bucket, as the
17514 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
17515 # set on a route that points exclusively to Backend Buckets will result in
17516 # a configuration error.
17517 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
17518 # `includedQueryParameters` and `excludedQueryParameters`. If neither
17519 # is set, the entire query string will be included. If false, the query
17520 # string will be excluded from the cache key entirely.
17521 #
17522 # Note: This field applies to routes that use backend services. Attempting
17523 # to set it on a route that points exclusively to Backend Buckets will
17524 # result in a configuration error. For routes that point to a Backend
17525 # Bucket, use `includedQueryParameters` to define which parameters should
17526 # be part of the cache key.
17527 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
17528 # The name=value pair will be used in the cache key Cloud CDN generates.
17529 #
17530 # Note: This setting is only applicable to routes that use a Backend
17531 # Service. It does not affect requests served by a Backend Bucket.
17532 # Attempting to set it on a route that points exclusively to Backend
17533 # Buckets will result in a configuration error. Up to 5 cookie names can be
17534 # specified.
17535 &quot;A String&quot;,
17536 ],
17537 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
17538 &quot;A String&quot;,
17539 ],
17540 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
17541 # parameters will be excluded. Either specify `includedQueryParameters`
17542 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
17543 # encoded and not treated as delimiters.
17544 &quot;A String&quot;,
17545 ],
17546 },
17547 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
17548 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
17549 &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
17550 # content. This is used to clamp the max-age (or Expires) value sent to the
17551 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
17552 # is used for the response max-age directive, along with a &quot;public&quot;
17553 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
17554 # clamps the max-age from the origin (if specified), or else sets the
17555 # response max-age directive to the lesser of the `clientTtl` and
17556 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
17557 # present. The maximum allowed value is 31,622,400s (1 year). If not
17558 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
17559 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
17560 # `USE_ORIGIN_HEADERS`.
17561 # as a count of seconds and fractions of seconds at nanosecond
17562 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17563 # or &quot;month&quot;. Range is approximately 10,000 years.
17564 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17565 # Durations less than one second are represented with a 0
17566 # `seconds` field and a positive `nanos` field. Must be from 0
17567 # to 999,999,999 inclusive.
17568 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17569 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17570 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17571 },
17572 &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
17573 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
17574 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
17575 # greater than that of `maxTtl`. When the `cacheMode` is set to
17576 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
17577 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
17578 # accessed objects may be evicted from the cache before the defined TTL. If
17579 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
17580 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
17581 # `USE_ORIGIN_HEADERS`.
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 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
17594 # attempt to set a max-age or s-maxage higher than this, or an Expires header
17595 # more than `maxTtl` seconds in the future will be capped at the value of
17596 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
17597 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
17598 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
17599 # Infrequently accessed objects may be evicted from the cache before the
17600 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
17601 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
17602 # mode.
17603 # as a count of seconds and fractions of seconds at nanosecond
17604 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17605 # or &quot;month&quot;. Range is approximately 10,000 years.
17606 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17607 # Durations less than one second are represented with a 0
17608 # `seconds` field and a positive `nanos` field. Must be from 0
17609 # to 999,999,999 inclusive.
17610 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17611 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17612 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17613 },
17614 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
17615 # to apply fine-grained caching for common errors or redirects.
17616 # This can reduce the load on your origin and improve end-user
17617 # experience by reducing response latency.
17618 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
17619 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
17620 # the specified response code that lack any Cache-Control, Expires, or
17621 # Pragma: no-cache directives. When the `cacheMode` is set to
17622 # `FORCE_CACHE_ALL`, negative caching applies to all responses
17623 # with the specified response code, and overrides any caching headers. By
17624 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
17625 #
17626 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
17627 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
17628 # * 405 (Method Not Found), 501 (Not Implemented): 60s
17629 #
17630 # These defaults can be overridden in `negativeCachingPolicy`.
17631 # If not specified, Cloud CDN applies negative caching by default.
17632 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
17633 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
17634 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
17635 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
17636 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
17637 # all response codes that you wish to cache. Cloud CDN will not apply any
17638 # default negative caching when a policy exists.
17639 { # Specify CDN TTLs for response error codes.
17640 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
17641 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
17642 # specified as values, and you cannot specify a status code more than
17643 # once.
17644 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
17645 # corresponding status code.
17646 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
17647 # objects may be evicted from the cache before the defined TTL.
17648 # as a count of seconds and fractions of seconds at nanosecond
17649 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17650 # or &quot;month&quot;. Range is approximately 10,000 years.
17651 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17652 # Durations less than one second are represented with a 0
17653 # `seconds` field and a positive `nanos` field. Must be from 0
17654 # to 999,999,999 inclusive.
17655 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17656 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17657 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17658 },
17659 },
17660 ],
17661 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
17662 # requests into a small number of requests to the origin. If not specified,
17663 # Cloud CDN applies request coalescing by default.
17664 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
17665 # content with the origin, or when an error is encountered when refreshing
17666 # the cache.
17667 # This setting defines the default &quot;max-stale&quot; duration for any cached
17668 # responses that do not specify a max-stale directive. Stale responses that
17669 # exceed the TTL configured here will not be served. The default limit
17670 # (max-stale) is 86400s (1 day), which will allow stale content to be
17671 # served up to this limit beyond the max-age (or s-maxage) of a cached
17672 # response.
17673 # The maximum allowed value is 604800 (1 week).
17674 # Set this to zero (0) to disable serve-while-stale.
17675 # as a count of seconds and fractions of seconds at nanosecond
17676 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17677 # or &quot;month&quot;. Range is approximately 10,000 years.
17678 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17679 # Durations less than one second are represented with a 0
17680 # `seconds` field and a positive `nanos` field. Must be from 0
17681 # to 999,999,999 inclusive.
17682 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17683 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17684 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17685 },
17686 },
17687 &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
17688 # information about the W3C recommendation for cross-origin resource sharing
17689 # (CORS), see Fetch API Living
17690 # Standard.
17691 #
17692 # Not supported when the URL map is bound to a target gRPC proxy.
17693 # information about the W3C recommendation for cross-origin resource sharing
17694 # (CORS), see Fetch API Living
17695 # Standard.
17696 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
17697 # indicates that
17698 # the actual request can include user credentials. This field translates to
17699 # the Access-Control-Allow-Credentials header.
17700 #
17701 # Default is false.
17702 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
17703 # header.
17704 &quot;A String&quot;,
17705 ],
17706 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
17707 # header.
17708 &quot;A String&quot;,
17709 ],
17710 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
17711 # more information, see regular expression syntax.
17712 #
17713 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
17714 #
17715 # Regular expressions can only be used when the loadBalancingScheme is
17716 # set to INTERNAL_SELF_MANAGED.
17717 &quot;A String&quot;,
17718 ],
17719 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
17720 #
17721 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
17722 &quot;A String&quot;,
17723 ],
17724 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
17725 # The default value is false, which indicates that the CORS
17726 # policy is in effect.
17727 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
17728 # header.
17729 &quot;A String&quot;,
17730 ],
17731 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
17732 # seconds. This field translates to the Access-Control-Max-Age
17733 # header.
17734 },
17735 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
17736 # the resiliency of clients to backend service failure. As part of fault
17737 # injection, when clients send requests to a backend service, delays can be
17738 # introduced by a load balancer on a percentage of requests before sending
17739 # those requests to the backend service. Similarly requests from clients can
17740 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
17741 # that are configured with a fault_injection_policy if:
17742 # 1. The traffic is generated by fault injection AND
17743 # 2. The fault injection is not a delay fault injection.
17744 # Fault injection is not supported with the classic Application Load Balancer
17745 # . To see which load balancers support fault injection,
17746 # see Load
17747 # balancing: Routing and traffic management features.
17748 # the resiliency of clients to backend service failure. As part of fault
17749 # injection, when clients send requests to a backend service, delays can be
17750 # introduced by the load balancer on a percentage of requests before sending
17751 # those request to the backend service. Similarly requests from clients can be
17752 # aborted by the load balancer for a percentage of requests.
17753 &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
17754 # injection.
17755 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
17756 #
17757 # The value must be from 200 to 599 inclusive.
17758 #
17759 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
17760 # according to this
17761 # mapping table. HTTP status 200 is mapped to gRPC status
17762 # UNKNOWN. Injecting an OK status is currently not supported by
17763 # Traffic Director.
17764 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
17765 # that is aborted as part of fault injection.
17766 #
17767 # The value must be from 0.0 to 100.0 inclusive.
17768 },
17769 &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
17770 # injection, before being sent to a backend service.
17771 # request to the backend service as part of fault injection.
17772 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
17773 # as a count of seconds and fractions of seconds at nanosecond
17774 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17775 # or &quot;month&quot;. Range is approximately 10,000 years.
17776 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17777 # Durations less than one second are represented with a 0
17778 # `seconds` field and a positive `nanos` field. Must be from 0
17779 # to 999,999,999 inclusive.
17780 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17781 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17782 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17783 },
17784 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
17785 # which a delay is introduced as part of fault injection.
17786 #
17787 # The value must be from 0.0 to 100.0 inclusive.
17788 },
17789 },
17790 &quot;imageOptimizationPolicy&quot;: { # The configuration for Cloud CDN&#x27;s image optimization feature. This feature # Image optimization policy for this URL Map&#x27;s route. Available only for
17791 # Global EXTERNAL_MANAGED load balancer schemes.
17792 # Either Cloud CDN must be enabled on the backend service or backend bucket
17793 # serving the route, or cache policy must be configured on the same route
17794 # dynamically processes and delivers images from the network edge.
17795 # Image Optimization is only available for Global External Application Load
17796 # Balancers.
17797 # Either Cloud CDN must be enabled on the backend service or backend bucket
17798 # serving the route, or cache policy must be configured on the same route.
17799 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
17800 },
17801 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
17802 # Unlike the timeout field where the timeout duration starts
17803 # from the time the request has been fully processed (known as*end-of-stream*),
17804 # the duration in this field is computed from the beginning of the stream
17805 # until the response has been processed, including all retries. A
17806 # stream that does not complete in this duration is closed.
17807 #
17808 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
17809 # with the route.
17810 #
17811 # This field is only allowed if the Url map is used with backend services
17812 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
17813 # as a count of seconds and fractions of seconds at nanosecond
17814 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17815 # or &quot;month&quot;. Range is approximately 10,000 years.
17816 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17817 # Durations less than one second are represented with a 0
17818 # `seconds` field and a positive `nanos` field. Must be from 0
17819 # to 999,999,999 inclusive.
17820 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17821 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17822 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17823 },
17824 &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
17825 # are shadowed to a separate mirrored backend service. The load balancer does
17826 # not wait for responses from the shadow service. Before sending traffic
17827 # to the shadow service, the host / authority header is suffixed with-shadow.
17828 #
17829 # Not supported when the URL map is bound to a target gRPC proxy that
17830 # has the validateForProxyless field set to true.
17831 # are shadowed to a separate mirrored backend service. The load balancer
17832 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
17833 # to the shadow service, the host or authority header is suffixed with-shadow.
17834 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
17835 # mirrored to.
17836 #
17837 # The backend service configured for a mirroring
17838 # policy must reference backends that are of the same type as the original
17839 # backend service matched in the URL map.
17840 #
17841 # Serverless NEG backends are not currently supported as a mirrored
17842 # backend service.
17843 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
17844 },
17845 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
17846 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
17847 # If not specified, defaults to 1.
17848 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
17849 #
17850 # If not specified, will use the timeout set in theHttpRouteAction field.
17851 # If timeout in the HttpRouteAction field is not set, this field
17852 # uses the largest timeout
17853 # among all backend services associated with the route.
17854 #
17855 # Not supported when the URL map is bound to a target gRPC proxy that
17856 # has the validateForProxyless field set to true.
17857 # as a count of seconds and fractions of seconds at nanosecond
17858 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17859 # or &quot;month&quot;. Range is approximately 10,000 years.
17860 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17861 # Durations less than one second are represented with a 0
17862 # `seconds` field and a positive `nanos` field. Must be from 0
17863 # to 999,999,999 inclusive.
17864 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17865 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17866 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17867 },
17868 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
17869 # values are:
17870 #
17871 # - 5xx: retry is attempted if the instance or endpoint
17872 # responds with any 5xx response code, or if the instance or
17873 # endpoint does not respond at all. For example, disconnects, reset, read
17874 # timeout, connection failure, and refused streams.
17875 # - gateway-error: Similar to 5xx, but only
17876 # applies to response codes 502, 503 or504.
17877 # - connect-failure: a retry is attempted on failures
17878 # connecting to the instance or endpoint. For example, connection
17879 # timeouts.
17880 # - retriable-4xx: a retry is attempted if the instance
17881 # or endpoint responds with a 4xx response code.
17882 # The only error that you can retry is error code 409.
17883 # - refused-stream: a retry is attempted if the instance
17884 # or endpoint resets the stream with a REFUSED_STREAM error
17885 # code. This reset type indicates that it is safe to retry.
17886 # - cancelled: a retry is attempted if the gRPC status
17887 # code in the response header is set to cancelled.
17888 # - deadline-exceeded: a retry is attempted if the gRPC
17889 # status code in the response header is set todeadline-exceeded.
17890 # - internal: a retry is attempted if the gRPC
17891 # status code in the response header is set tointernal.
17892 # - resource-exhausted: a retry is attempted if the gRPC
17893 # status code in the response header is set toresource-exhausted.
17894 # - unavailable: a retry is attempted if the gRPC
17895 # status code in the response header is set tounavailable.
17896 #
17897 # Only the following codes are supported when the URL map is bound to
17898 # target gRPC proxy that has validateForProxyless field set to true.
17899 #
17900 # - cancelled
17901 # - deadline-exceeded
17902 # - internal
17903 # - resource-exhausted
17904 # - unavailable
17905 &quot;A String&quot;,
17906 ],
17907 },
17908 &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
17909 # time the request has been fully processed (known as *end-of-stream*)
17910 # up until the response has been processed. Timeout includes
17911 # all retries.
17912 #
17913 # If not specified, this field uses the largest timeout among all backend
17914 # services associated with the route.
17915 #
17916 # Not supported when the URL map is bound to a target gRPC proxy that
17917 # has validateForProxyless field set to true.
17918 # as a count of seconds and fractions of seconds at nanosecond
17919 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17920 # or &quot;month&quot;. Range is approximately 10,000 years.
17921 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17922 # Durations less than one second are represented with a 0
17923 # `seconds` field and a positive `nanos` field. Must be from 0
17924 # to 999,999,999 inclusive.
17925 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17926 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17927 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17928 },
17929 &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
17930 # to the matched service.
17931 #
17932 # urlRewrite is the only action supported in UrlMaps
17933 # for classic Application Load Balancers.
17934 #
17935 # Not supported when the URL map is bound to a target gRPC proxy that
17936 # has the validateForProxyless field set to true.
17937 # backend service.
17938 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
17939 # host header is replaced with contents of hostRewrite.
17940 #
17941 # The value must be from 1 to 255 characters.
17942 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
17943 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
17944 #
17945 # The value must be from 1 to 1024 characters.
17946 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
17947 # header) using the HTTP template syntax.
17948 #
17949 # A corresponding
17950 # path_template_match must be specified. Any template variables must exist in
17951 # the path_template_match field.
17952 #
17953 #
17954 # - -At least one variable must be specified in the path_template_match
17955 # field
17956 # - You can omit variables from the rewritten URL
17957 # - The * and ** operators cannot be matched
17958 # unless they have a corresponding variable name - e.g.
17959 # {format=*} or {var=**}.
17960 #
17961 # For example, a path_template_match of /static/{format=**}
17962 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
17963 # rewrite, so that /{country}/{format}/{suffix=**} can be
17964 # rewritten as /content/{format}/{country}/{suffix}.
17965 #
17966 # At least
17967 # one non-empty routeRules[].matchRules[].path_template_match is
17968 # required.
17969 #
17970 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
17971 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
17972 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
17973 # It uses RE2 syntax with the following constraints:
17974 #
17975 #
17976 # - Any single character operators
17977 # - Groups are allowed to have only submatch operator inside
17978 # - Groups are allowed only without any char repetition, e.g.
17979 # .*
17980 # - Any char repetition, e.g. .*, is
17981 # only allowed to be used in a single regex together with:
17982 #
17983 #
17984 # - Empty string operators
17985 # - Other repetitions
17986 # - Ranges
17987 # - Repetitions of ranges
17988 #
17989 #
17990 # - Ranges are only allowed to have:
17991 #
17992 #
17993 # - Character range
17994 # - Digits range
17995 # - Symbols listed in characters allowed for ranges
17996 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
17997 # the path.
17998 },
17999 },
18000 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
18001 # occurs. The weights determine the fraction of traffic that flows to
18002 # their corresponding backend service. If all traffic needs to
18003 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
18004 #
18005 # After a backend service is identified and before forwarding
18006 # the request to
18007 # the backend service, advanced routing actions such as URL rewrites and
18008 # header transformations are applied depending on additional settings
18009 # specified in this HttpRouteAction.
18010 { # In contrast to a single BackendService in
18011 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
18012 # multiple backend services. The volume of traffic for each
18013 # backend service is proportional to the weight specified
18014 # in each WeightedBackendService
18015 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
18016 # resource. Before
18017 # forwarding the request to backendService, the load balancer
18018 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
18019 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
18020 # effect for the selected backendService.
18021 #
18022 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
18023 #
18024 # headerAction is not supported for load balancers that have
18025 # their loadBalancingScheme set to EXTERNAL.
18026 #
18027 # Not supported when the URL map is bound to a target gRPC proxy that
18028 # has validateForProxyless field set to true.
18029 # the request is passed along to the selected backendService.
18030 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
18031 { # Specification determining how headers are added to requests or responses.
18032 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
18033 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
18034 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
18035 # that already
18036 # exist for the header. If true, headerValue is set for the
18037 # header, discarding any values that were set for that header.
18038 #
18039 # The default value is true,
18040 # unless a variable is present in headerValue,
18041 # in which case the default value is false.
18042 # .
18043 },
18044 ],
18045 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
18046 # request before forwarding the request to the backendService.
18047 &quot;A String&quot;,
18048 ],
18049 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
18050 # client.
18051 { # Specification determining how headers are added to requests or responses.
18052 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
18053 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
18054 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
18055 # that already
18056 # exist for the header. If true, headerValue is set for the
18057 # header, discarding any values that were set for that header.
18058 #
18059 # The default value is true,
18060 # unless a variable is present in headerValue,
18061 # in which case the default value is false.
18062 # .
18063 },
18064 ],
18065 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
18066 # response before sending the response back to the client.
18067 &quot;A String&quot;,
18068 ],
18069 },
18070 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
18071 # computed asweight / (sum of all weightedBackendService weights in routeAction).
18072 #
18073 # The selection of a backend service is determined only for new traffic.
18074 # Once a user&#x27;s request has been directed to a backend service,
18075 # subsequent requests are sent to the same backend service as
18076 # determined by the backend service&#x27;s session affinity policy.
18077 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
18078 # splitting. If you do, the weighted traffic splitting configuration takes
18079 # precedence.
18080 #
18081 # The value must be from 0 to 1000.
18082 },
18083 ],
18084 },
18085 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource. This
18086 # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
18087 # matched. For example, the
18088 # following are all valid URLs to a BackendService resource:
18089 #
18090 #
18091 # - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
18092 # - compute/v1/projects/project/global/backendServices/backendService
18093 # - global/backendServices/backendService
18094 #
18095 #
18096 # If defaultRouteAction is also specified, advanced
18097 # routing actions, such as URL rewrites, take effect before sending the
18098 # request to the backend.
18099 #
18100 #
18101 # Only one of defaultUrlRedirect, defaultService
18102 # or defaultRouteAction.weightedBackendService can be set.
18103 #
18104 #
18105 # Authorization requires one or more of the following Google IAM permissions on the
18106 # specified resource default_service:
18107 #
18108 #
18109 # - compute.backendBuckets.use
18110 # - compute.backendServices.use
18111 &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
18112 # by defaultUrlRedirect.
18113 #
18114 #
18115 # Only one of defaultUrlRedirect, defaultService
18116 # or defaultRouteAction.weightedBackendService can be set.
18117 #
18118 #
18119 # Not supported when the URL map is bound to a target gRPC proxy.
18120 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
18121 # was supplied in the request.
18122 #
18123 # The value must be from 1 to 255
18124 # characters.
18125 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
18126 # set to HTTPS.
18127 # If set to false, the URL scheme of the redirected request
18128 # remains the same as that of the request.
18129 #
18130 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
18131 #
18132 # The default is set to false.
18133 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
18134 # that was supplied in the request.
18135 #
18136 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
18137 # supplied, the path of the original request is used for the redirect.
18138 #
18139 # The value must be from 1 to 1024 characters.
18140 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
18141 # the HttpRouteRuleMatch, retaining the remaining portion
18142 # of the URL before redirecting the request.
18143 #
18144 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
18145 # supplied, the path of the original request is used for the redirect.
18146 #
18147 # The value must be from 1 to 1024 characters.
18148 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
18149 #
18150 # Supported values are:
18151 #
18152 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
18153 # to 301.
18154 # - FOUND, which corresponds to 302.
18155 # - SEE_OTHER which corresponds to 303.
18156 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
18157 # method is retained.
18158 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
18159 # method is retained.
18160 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
18161 # URL is
18162 # removed before redirecting the request. If set to false, the
18163 # query portion of the original URL is retained.
18164 #
18165 # The default is set to false.
18166 },
18167 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
18168 # create the resource.
18169 &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
18170 # for the selected backend service.
18171 #
18172 # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
18173 #
18174 # HeaderAction is not supported for load balancers
18175 # that have
18176 # their loadBalancingScheme set to EXTERNAL.
18177 #
18178 # Not supported when the URL map is bound to a target gRPC proxy that
18179 # has validateForProxyless field set to true.
18180 # the request is passed along to the selected backendService.
18181 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
18182 { # Specification determining how headers are added to requests or responses.
18183 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
18184 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
18185 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
18186 # that already
18187 # exist for the header. If true, headerValue is set for the
18188 # header, discarding any values that were set for that header.
18189 #
18190 # The default value is true,
18191 # unless a variable is present in headerValue,
18192 # in which case the default value is false.
18193 # .
18194 },
18195 ],
18196 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
18197 # request before forwarding the request to the backendService.
18198 &quot;A String&quot;,
18199 ],
18200 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
18201 # client.
18202 { # Specification determining how headers are added to requests or responses.
18203 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
18204 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
18205 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
18206 # that already
18207 # exist for the header. If true, headerValue is set for the
18208 # header, discarding any values that were set for that header.
18209 #
18210 # The default value is true,
18211 # unless a variable is present in headerValue,
18212 # in which case the default value is false.
18213 # .
18214 },
18215 ],
18216 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
18217 # response before sending the response back to the client.
18218 &quot;A String&quot;,
18219 ],
18220 },
18221 &quot;name&quot;: &quot;A String&quot;, # The name to which this PathMatcher is referred by theHostRule.
18222 &quot;pathRules&quot;: [ # The list of path rules. Use this list instead of routeRules
18223 # when routing based on simple path matching is all that&#x27;s required. A path
18224 # rule can only include a wildcard character (*) after a
18225 # forward slash character (&quot;/&quot;).
18226 #
18227 # The order by which path rules are specified does not matter.
18228 # Matches are always done on the longest-path-first basis.
18229 #
18230 # For example: a pathRule with a path /a/b/c/* will match
18231 # before /a/b/* irrespective of the order in which those paths appear in this
18232 # list.
18233 #
18234 # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
18235 { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
18236 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
18237 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
18238 #
18239 # If a policy for an
18240 # error code is not configured for the PathRule, a policy for
18241 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
18242 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
18243 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
18244 # effect.
18245 #
18246 # For example, consider a UrlMap with the following configuration:
18247 #
18248 #
18249 # - UrlMap.defaultCustomErrorResponsePolicy are configured
18250 # with policies for 5xx and 4xx errors
18251 # - A PathRule for /coming_soon/ is configured for the error
18252 # code 404.
18253 #
18254 # 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
18255 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
18256 # the policy in PathRule.customErrorResponsePolicy takes
18257 # effect. If any of the requests in this example encounter a 500
18258 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
18259 #
18260 # customErrorResponsePolicy is supported only for
18261 # global external Application Load Balancers.
18262 # backend service or backend bucket responds with an error.
18263 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
18264 #
18265 # In a given policy, if you specify rules for both a range of error codes
18266 # as well as rules for specific error codes then rules with specific error
18267 # codes have a higher priority. For example, assume that you configure a rule
18268 # for 401 (Un-authorized) code, and another for all 4 series
18269 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
18270 # However if the backend service returns a 403, the rule for4xx takes effect.
18271 { # Specifies the mapping between the response code that will be returned along
18272 # with the custom error content and the response code returned by the backend
18273 # service.
18274 &quot;matchResponseCodes&quot;: [ # Valid values include:
18275 #
18276 #
18277 # - A number between 400 and 599: For example
18278 # 401 or 503, in which case the load balancer
18279 # applies the policy if the error code exactly matches this value.
18280 # - 5xx: Load Balancer will apply the policy if the
18281 # backend service responds with any response code in the range of
18282 # 500 to 599.
18283 # - 4xx: Load
18284 # Balancer will apply the policy if the backend service responds with any
18285 # response code in the range of 400 to
18286 # 499.
18287 #
18288 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
18289 &quot;A String&quot;,
18290 ],
18291 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
18292 # error content. If overrideResponseCode is not supplied, the
18293 # same response code returned by the original backend bucket or backend
18294 # service is returned to the client.
18295 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
18296 #
18297 # path must start
18298 # with a leading slash. path cannot have trailing slashes.
18299 #
18300 # If the file is not available in backendBucket or the
18301 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
18302 #
18303 # The value must
18304 # be from 1 to 1024 characters
18305 },
18306 ],
18307 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
18308 # contains the custom error content. Examples are:
18309 #
18310 #
18311 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
18312 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
18313 # - global/backendBuckets/myBackendBucket
18314 #
18315 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
18316 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
18317 #
18318 # If load balancer cannot reach
18319 # the backendBucket, a simple Not Found Error will
18320 # be returned, with the original response code (oroverrideResponseCode if configured).
18321 #
18322 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
18323 },
18324 &quot;paths&quot;: [ # The list of path patterns to match. Each must start with /
18325 # and the only place a * is allowed is at the end following
18326 # a /. The string fed to the path matcher does not include
18327 # any text after the first ? or #, and
18328 # those chars are not allowed here.
18329 &quot;A String&quot;,
18330 ],
18331 &quot;routeAction&quot;: { # In response to a matching path, the load balancer
18332 # performs advanced routing actions, such as URL rewrites and header
18333 # transformations, before forwarding the request to the selected
18334 # backend.
18335 #
18336 #
18337 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
18338 #
18339 #
18340 # URL maps for classic Application Load Balancers only support
18341 # the urlRewrite action within a path rule&#x27;srouteAction.
18342 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
18343 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
18344 # property must be specified. This policy cannot be specified if any target
18345 # backend has Identity-Aware Proxy enabled.
18346 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
18347 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
18348 # header names can be specified. The cache is bypassed for all `cacheMode`
18349 # values.
18350 &quot;A String&quot;,
18351 ],
18352 &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
18353 # on the backend type: for Backend Services, the complete request URI is
18354 # used; for Backend Buckets, the request URI is used without the protocol or
18355 # host, and only query parameters known to Cloud Storage are included.
18356 # Policy defined on Route Action.
18357 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
18358 # parameters will be included. Either specify `excludedQueryParameters`
18359 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
18360 # encoded and not treated as delimiters.
18361 #
18362 # Note: This field applies to routes that use backend services. Attempting
18363 # to set it on a route that points exclusively to Backend Buckets will
18364 # result in a configuration error. For routes that point to a Backend
18365 # Bucket, use `includedQueryParameters` to define which parameters should
18366 # be part of the cache key.
18367 &quot;A String&quot;,
18368 ],
18369 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
18370 #
18371 # Note: This setting is only applicable to routes that use a Backend
18372 # Service. It does not affect requests served by a Backend Bucket, as the
18373 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
18374 # it on a route that points exclusively to Backend Buckets will result in a
18375 # configuration error.
18376 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
18377 #
18378 # Note: This setting is only applicable to routes that use a Backend
18379 # Service. It does not affect requests served by a Backend Bucket, as the
18380 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
18381 # set on a route that points exclusively to Backend Buckets will result in
18382 # a configuration error.
18383 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
18384 # `includedQueryParameters` and `excludedQueryParameters`. If neither
18385 # is set, the entire query string will be included. If false, the query
18386 # string will be excluded from the cache key entirely.
18387 #
18388 # Note: This field applies to routes that use backend services. Attempting
18389 # to set it on a route that points exclusively to Backend Buckets will
18390 # result in a configuration error. For routes that point to a Backend
18391 # Bucket, use `includedQueryParameters` to define which parameters should
18392 # be part of the cache key.
18393 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
18394 # The name=value pair will be used in the cache key Cloud CDN generates.
18395 #
18396 # Note: This setting is only applicable to routes that use a Backend
18397 # Service. It does not affect requests served by a Backend Bucket.
18398 # Attempting to set it on a route that points exclusively to Backend
18399 # Buckets will result in a configuration error. Up to 5 cookie names can be
18400 # specified.
18401 &quot;A String&quot;,
18402 ],
18403 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
18404 &quot;A String&quot;,
18405 ],
18406 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
18407 # parameters will be excluded. Either specify `includedQueryParameters`
18408 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
18409 # encoded and not treated as delimiters.
18410 &quot;A String&quot;,
18411 ],
18412 },
18413 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
18414 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
18415 &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
18416 # content. This is used to clamp the max-age (or Expires) value sent to the
18417 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
18418 # is used for the response max-age directive, along with a &quot;public&quot;
18419 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
18420 # clamps the max-age from the origin (if specified), or else sets the
18421 # response max-age directive to the lesser of the `clientTtl` and
18422 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
18423 # present. The maximum allowed value is 31,622,400s (1 year). If not
18424 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
18425 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
18426 # `USE_ORIGIN_HEADERS`.
18427 # as a count of seconds and fractions of seconds at nanosecond
18428 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18429 # or &quot;month&quot;. Range is approximately 10,000 years.
18430 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18431 # Durations less than one second are represented with a 0
18432 # `seconds` field and a positive `nanos` field. Must be from 0
18433 # to 999,999,999 inclusive.
18434 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18435 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18436 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18437 },
18438 &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
18439 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
18440 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
18441 # greater than that of `maxTtl`. When the `cacheMode` is set to
18442 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
18443 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
18444 # accessed objects may be evicted from the cache before the defined TTL. If
18445 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
18446 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
18447 # `USE_ORIGIN_HEADERS`.
18448 # as a count of seconds and fractions of seconds at nanosecond
18449 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18450 # or &quot;month&quot;. Range is approximately 10,000 years.
18451 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18452 # Durations less than one second are represented with a 0
18453 # `seconds` field and a positive `nanos` field. Must be from 0
18454 # to 999,999,999 inclusive.
18455 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18456 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18457 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18458 },
18459 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
18460 # attempt to set a max-age or s-maxage higher than this, or an Expires header
18461 # more than `maxTtl` seconds in the future will be capped at the value of
18462 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
18463 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
18464 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
18465 # Infrequently accessed objects may be evicted from the cache before the
18466 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
18467 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
18468 # mode.
18469 # as a count of seconds and fractions of seconds at nanosecond
18470 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18471 # or &quot;month&quot;. Range is approximately 10,000 years.
18472 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18473 # Durations less than one second are represented with a 0
18474 # `seconds` field and a positive `nanos` field. Must be from 0
18475 # to 999,999,999 inclusive.
18476 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18477 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18478 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18479 },
18480 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
18481 # to apply fine-grained caching for common errors or redirects.
18482 # This can reduce the load on your origin and improve end-user
18483 # experience by reducing response latency.
18484 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
18485 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
18486 # the specified response code that lack any Cache-Control, Expires, or
18487 # Pragma: no-cache directives. When the `cacheMode` is set to
18488 # `FORCE_CACHE_ALL`, negative caching applies to all responses
18489 # with the specified response code, and overrides any caching headers. By
18490 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
18491 #
18492 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
18493 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
18494 # * 405 (Method Not Found), 501 (Not Implemented): 60s
18495 #
18496 # These defaults can be overridden in `negativeCachingPolicy`.
18497 # If not specified, Cloud CDN applies negative caching by default.
18498 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
18499 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
18500 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
18501 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
18502 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
18503 # all response codes that you wish to cache. Cloud CDN will not apply any
18504 # default negative caching when a policy exists.
18505 { # Specify CDN TTLs for response error codes.
18506 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
18507 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
18508 # specified as values, and you cannot specify a status code more than
18509 # once.
18510 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
18511 # corresponding status code.
18512 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
18513 # objects may be evicted from the cache before the defined TTL.
18514 # as a count of seconds and fractions of seconds at nanosecond
18515 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18516 # or &quot;month&quot;. Range is approximately 10,000 years.
18517 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18518 # Durations less than one second are represented with a 0
18519 # `seconds` field and a positive `nanos` field. Must be from 0
18520 # to 999,999,999 inclusive.
18521 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18522 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18523 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18524 },
18525 },
18526 ],
18527 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
18528 # requests into a small number of requests to the origin. If not specified,
18529 # Cloud CDN applies request coalescing by default.
18530 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
18531 # content with the origin, or when an error is encountered when refreshing
18532 # the cache.
18533 # This setting defines the default &quot;max-stale&quot; duration for any cached
18534 # responses that do not specify a max-stale directive. Stale responses that
18535 # exceed the TTL configured here will not be served. The default limit
18536 # (max-stale) is 86400s (1 day), which will allow stale content to be
18537 # served up to this limit beyond the max-age (or s-maxage) of a cached
18538 # response.
18539 # The maximum allowed value is 604800 (1 week).
18540 # Set this to zero (0) to disable serve-while-stale.
18541 # as a count of seconds and fractions of seconds at nanosecond
18542 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18543 # or &quot;month&quot;. Range is approximately 10,000 years.
18544 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18545 # Durations less than one second are represented with a 0
18546 # `seconds` field and a positive `nanos` field. Must be from 0
18547 # to 999,999,999 inclusive.
18548 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18549 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18550 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18551 },
18552 },
18553 &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
18554 # information about the W3C recommendation for cross-origin resource sharing
18555 # (CORS), see Fetch API Living
18556 # Standard.
18557 #
18558 # Not supported when the URL map is bound to a target gRPC proxy.
18559 # information about the W3C recommendation for cross-origin resource sharing
18560 # (CORS), see Fetch API Living
18561 # Standard.
18562 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
18563 # indicates that
18564 # the actual request can include user credentials. This field translates to
18565 # the Access-Control-Allow-Credentials header.
18566 #
18567 # Default is false.
18568 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
18569 # header.
18570 &quot;A String&quot;,
18571 ],
18572 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
18573 # header.
18574 &quot;A String&quot;,
18575 ],
18576 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
18577 # more information, see regular expression syntax.
18578 #
18579 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
18580 #
18581 # Regular expressions can only be used when the loadBalancingScheme is
18582 # set to INTERNAL_SELF_MANAGED.
18583 &quot;A String&quot;,
18584 ],
18585 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
18586 #
18587 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
18588 &quot;A String&quot;,
18589 ],
18590 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
18591 # The default value is false, which indicates that the CORS
18592 # policy is in effect.
18593 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
18594 # header.
18595 &quot;A String&quot;,
18596 ],
18597 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
18598 # seconds. This field translates to the Access-Control-Max-Age
18599 # header.
18600 },
18601 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
18602 # the resiliency of clients to backend service failure. As part of fault
18603 # injection, when clients send requests to a backend service, delays can be
18604 # introduced by a load balancer on a percentage of requests before sending
18605 # those requests to the backend service. Similarly requests from clients can
18606 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
18607 # that are configured with a fault_injection_policy if:
18608 # 1. The traffic is generated by fault injection AND
18609 # 2. The fault injection is not a delay fault injection.
18610 # Fault injection is not supported with the classic Application Load Balancer
18611 # . To see which load balancers support fault injection,
18612 # see Load
18613 # balancing: Routing and traffic management features.
18614 # the resiliency of clients to backend service failure. As part of fault
18615 # injection, when clients send requests to a backend service, delays can be
18616 # introduced by the load balancer on a percentage of requests before sending
18617 # those request to the backend service. Similarly requests from clients can be
18618 # aborted by the load balancer for a percentage of requests.
18619 &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
18620 # injection.
18621 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
18622 #
18623 # The value must be from 200 to 599 inclusive.
18624 #
18625 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
18626 # according to this
18627 # mapping table. HTTP status 200 is mapped to gRPC status
18628 # UNKNOWN. Injecting an OK status is currently not supported by
18629 # Traffic Director.
18630 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
18631 # that is aborted as part of fault injection.
18632 #
18633 # The value must be from 0.0 to 100.0 inclusive.
18634 },
18635 &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
18636 # injection, before being sent to a backend service.
18637 # request to the backend service as part of fault injection.
18638 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
18639 # as a count of seconds and fractions of seconds at nanosecond
18640 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18641 # or &quot;month&quot;. Range is approximately 10,000 years.
18642 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18643 # Durations less than one second are represented with a 0
18644 # `seconds` field and a positive `nanos` field. Must be from 0
18645 # to 999,999,999 inclusive.
18646 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18647 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18648 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18649 },
18650 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
18651 # which a delay is introduced as part of fault injection.
18652 #
18653 # The value must be from 0.0 to 100.0 inclusive.
18654 },
18655 },
18656 &quot;imageOptimizationPolicy&quot;: { # The configuration for Cloud CDN&#x27;s image optimization feature. This feature # Image optimization policy for this URL Map&#x27;s route. Available only for
18657 # Global EXTERNAL_MANAGED load balancer schemes.
18658 # Either Cloud CDN must be enabled on the backend service or backend bucket
18659 # serving the route, or cache policy must be configured on the same route
18660 # dynamically processes and delivers images from the network edge.
18661 # Image Optimization is only available for Global External Application Load
18662 # Balancers.
18663 # Either Cloud CDN must be enabled on the backend service or backend bucket
18664 # serving the route, or cache policy must be configured on the same route.
18665 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
18666 },
18667 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
18668 # Unlike the timeout field where the timeout duration starts
18669 # from the time the request has been fully processed (known as*end-of-stream*),
18670 # the duration in this field is computed from the beginning of the stream
18671 # until the response has been processed, including all retries. A
18672 # stream that does not complete in this duration is closed.
18673 #
18674 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
18675 # with the route.
18676 #
18677 # This field is only allowed if the Url map is used with backend services
18678 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
18679 # as a count of seconds and fractions of seconds at nanosecond
18680 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18681 # or &quot;month&quot;. Range is approximately 10,000 years.
18682 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18683 # Durations less than one second are represented with a 0
18684 # `seconds` field and a positive `nanos` field. Must be from 0
18685 # to 999,999,999 inclusive.
18686 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18687 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18688 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18689 },
18690 &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
18691 # are shadowed to a separate mirrored backend service. The load balancer does
18692 # not wait for responses from the shadow service. Before sending traffic
18693 # to the shadow service, the host / authority header is suffixed with-shadow.
18694 #
18695 # Not supported when the URL map is bound to a target gRPC proxy that
18696 # has the validateForProxyless field set to true.
18697 # are shadowed to a separate mirrored backend service. The load balancer
18698 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
18699 # to the shadow service, the host or authority header is suffixed with-shadow.
18700 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
18701 # mirrored to.
18702 #
18703 # The backend service configured for a mirroring
18704 # policy must reference backends that are of the same type as the original
18705 # backend service matched in the URL map.
18706 #
18707 # Serverless NEG backends are not currently supported as a mirrored
18708 # backend service.
18709 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
18710 },
18711 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
18712 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
18713 # If not specified, defaults to 1.
18714 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
18715 #
18716 # If not specified, will use the timeout set in theHttpRouteAction field.
18717 # If timeout in the HttpRouteAction field is not set, this field
18718 # uses the largest timeout
18719 # among all backend services associated with the route.
18720 #
18721 # Not supported when the URL map is bound to a target gRPC proxy that
18722 # has the validateForProxyless field set to true.
18723 # as a count of seconds and fractions of seconds at nanosecond
18724 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18725 # or &quot;month&quot;. Range is approximately 10,000 years.
18726 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18727 # Durations less than one second are represented with a 0
18728 # `seconds` field and a positive `nanos` field. Must be from 0
18729 # to 999,999,999 inclusive.
18730 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18731 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18732 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18733 },
18734 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
18735 # values are:
18736 #
18737 # - 5xx: retry is attempted if the instance or endpoint
18738 # responds with any 5xx response code, or if the instance or
18739 # endpoint does not respond at all. For example, disconnects, reset, read
18740 # timeout, connection failure, and refused streams.
18741 # - gateway-error: Similar to 5xx, but only
18742 # applies to response codes 502, 503 or504.
18743 # - connect-failure: a retry is attempted on failures
18744 # connecting to the instance or endpoint. For example, connection
18745 # timeouts.
18746 # - retriable-4xx: a retry is attempted if the instance
18747 # or endpoint responds with a 4xx response code.
18748 # The only error that you can retry is error code 409.
18749 # - refused-stream: a retry is attempted if the instance
18750 # or endpoint resets the stream with a REFUSED_STREAM error
18751 # code. This reset type indicates that it is safe to retry.
18752 # - cancelled: a retry is attempted if the gRPC status
18753 # code in the response header is set to cancelled.
18754 # - deadline-exceeded: a retry is attempted if the gRPC
18755 # status code in the response header is set todeadline-exceeded.
18756 # - internal: a retry is attempted if the gRPC
18757 # status code in the response header is set tointernal.
18758 # - resource-exhausted: a retry is attempted if the gRPC
18759 # status code in the response header is set toresource-exhausted.
18760 # - unavailable: a retry is attempted if the gRPC
18761 # status code in the response header is set tounavailable.
18762 #
18763 # Only the following codes are supported when the URL map is bound to
18764 # target gRPC proxy that has validateForProxyless field set to true.
18765 #
18766 # - cancelled
18767 # - deadline-exceeded
18768 # - internal
18769 # - resource-exhausted
18770 # - unavailable
18771 &quot;A String&quot;,
18772 ],
18773 },
18774 &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
18775 # time the request has been fully processed (known as *end-of-stream*)
18776 # up until the response has been processed. Timeout includes
18777 # all retries.
18778 #
18779 # If not specified, this field uses the largest timeout among all backend
18780 # services associated with the route.
18781 #
18782 # Not supported when the URL map is bound to a target gRPC proxy that
18783 # has validateForProxyless field set to true.
18784 # as a count of seconds and fractions of seconds at nanosecond
18785 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18786 # or &quot;month&quot;. Range is approximately 10,000 years.
18787 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18788 # Durations less than one second are represented with a 0
18789 # `seconds` field and a positive `nanos` field. Must be from 0
18790 # to 999,999,999 inclusive.
18791 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18792 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18793 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18794 },
18795 &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
18796 # to the matched service.
18797 #
18798 # urlRewrite is the only action supported in UrlMaps
18799 # for classic Application Load Balancers.
18800 #
18801 # Not supported when the URL map is bound to a target gRPC proxy that
18802 # has the validateForProxyless field set to true.
18803 # backend service.
18804 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
18805 # host header is replaced with contents of hostRewrite.
18806 #
18807 # The value must be from 1 to 255 characters.
18808 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
18809 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
18810 #
18811 # The value must be from 1 to 1024 characters.
18812 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
18813 # header) using the HTTP template syntax.
18814 #
18815 # A corresponding
18816 # path_template_match must be specified. Any template variables must exist in
18817 # the path_template_match field.
18818 #
18819 #
18820 # - -At least one variable must be specified in the path_template_match
18821 # field
18822 # - You can omit variables from the rewritten URL
18823 # - The * and ** operators cannot be matched
18824 # unless they have a corresponding variable name - e.g.
18825 # {format=*} or {var=**}.
18826 #
18827 # For example, a path_template_match of /static/{format=**}
18828 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
18829 # rewrite, so that /{country}/{format}/{suffix=**} can be
18830 # rewritten as /content/{format}/{country}/{suffix}.
18831 #
18832 # At least
18833 # one non-empty routeRules[].matchRules[].path_template_match is
18834 # required.
18835 #
18836 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
18837 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
18838 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
18839 # It uses RE2 syntax with the following constraints:
18840 #
18841 #
18842 # - Any single character operators
18843 # - Groups are allowed to have only submatch operator inside
18844 # - Groups are allowed only without any char repetition, e.g.
18845 # .*
18846 # - Any char repetition, e.g. .*, is
18847 # only allowed to be used in a single regex together with:
18848 #
18849 #
18850 # - Empty string operators
18851 # - Other repetitions
18852 # - Ranges
18853 # - Repetitions of ranges
18854 #
18855 #
18856 # - Ranges are only allowed to have:
18857 #
18858 #
18859 # - Character range
18860 # - Digits range
18861 # - Symbols listed in characters allowed for ranges
18862 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
18863 # the path.
18864 },
18865 },
18866 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
18867 # occurs. The weights determine the fraction of traffic that flows to
18868 # their corresponding backend service. If all traffic needs to
18869 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
18870 #
18871 # After a backend service is identified and before forwarding
18872 # the request to
18873 # the backend service, advanced routing actions such as URL rewrites and
18874 # header transformations are applied depending on additional settings
18875 # specified in this HttpRouteAction.
18876 { # In contrast to a single BackendService in
18877 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
18878 # multiple backend services. The volume of traffic for each
18879 # backend service is proportional to the weight specified
18880 # in each WeightedBackendService
18881 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
18882 # resource. Before
18883 # forwarding the request to backendService, the load balancer
18884 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
18885 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
18886 # effect for the selected backendService.
18887 #
18888 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
18889 #
18890 # headerAction is not supported for load balancers that have
18891 # their loadBalancingScheme set to EXTERNAL.
18892 #
18893 # Not supported when the URL map is bound to a target gRPC proxy that
18894 # has validateForProxyless field set to true.
18895 # the request is passed along to the selected backendService.
18896 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
18897 { # Specification determining how headers are added to requests or responses.
18898 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
18899 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
18900 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
18901 # that already
18902 # exist for the header. If true, headerValue is set for the
18903 # header, discarding any values that were set for that header.
18904 #
18905 # The default value is true,
18906 # unless a variable is present in headerValue,
18907 # in which case the default value is false.
18908 # .
18909 },
18910 ],
18911 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
18912 # request before forwarding the request to the backendService.
18913 &quot;A String&quot;,
18914 ],
18915 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
18916 # client.
18917 { # Specification determining how headers are added to requests or responses.
18918 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
18919 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
18920 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
18921 # that already
18922 # exist for the header. If true, headerValue is set for the
18923 # header, discarding any values that were set for that header.
18924 #
18925 # The default value is true,
18926 # unless a variable is present in headerValue,
18927 # in which case the default value is false.
18928 # .
18929 },
18930 ],
18931 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
18932 # response before sending the response back to the client.
18933 &quot;A String&quot;,
18934 ],
18935 },
18936 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
18937 # computed asweight / (sum of all weightedBackendService weights in routeAction).
18938 #
18939 # The selection of a backend service is determined only for new traffic.
18940 # Once a user&#x27;s request has been directed to a backend service,
18941 # subsequent requests are sent to the same backend service as
18942 # determined by the backend service&#x27;s session affinity policy.
18943 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
18944 # splitting. If you do, the weighted traffic splitting configuration takes
18945 # precedence.
18946 #
18947 # The value must be from 0 to 1000.
18948 },
18949 ],
18950 },
18951 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
18952 # is directed if this rule is matched. If routeAction is
18953 # also specified, advanced routing actions, such as URL rewrites,
18954 # take effect before sending the request to the backend.
18955 #
18956 #
18957 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
18958 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
18959 # specified by urlRedirect.
18960 #
18961 #
18962 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
18963 #
18964 #
18965 # Not supported when the URL map is bound to a target gRPC proxy.
18966 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
18967 # was supplied in the request.
18968 #
18969 # The value must be from 1 to 255
18970 # characters.
18971 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
18972 # set to HTTPS.
18973 # If set to false, the URL scheme of the redirected request
18974 # remains the same as that of the request.
18975 #
18976 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
18977 #
18978 # The default is set to false.
18979 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
18980 # that was supplied in the request.
18981 #
18982 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
18983 # supplied, the path of the original request is used for the redirect.
18984 #
18985 # The value must be from 1 to 1024 characters.
18986 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
18987 # the HttpRouteRuleMatch, retaining the remaining portion
18988 # of the URL before redirecting the request.
18989 #
18990 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
18991 # supplied, the path of the original request is used for the redirect.
18992 #
18993 # The value must be from 1 to 1024 characters.
18994 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
18995 #
18996 # Supported values are:
18997 #
18998 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
18999 # to 301.
19000 # - FOUND, which corresponds to 302.
19001 # - SEE_OTHER which corresponds to 303.
19002 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
19003 # method is retained.
19004 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
19005 # method is retained.
19006 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
19007 # URL is
19008 # removed before redirecting the request. If set to false, the
19009 # query portion of the original URL is retained.
19010 #
19011 # The default is set to false.
19012 },
19013 },
19014 ],
19015 &quot;routeRules&quot;: [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
19016 # desired. routeRules are evaluated in order of priority, from
19017 # the lowest to highest number.
19018 #
19019 # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
19020 { # The HttpRouteRule setting specifies how to match an HTTP request
19021 # and the corresponding routing action that load balancing proxies perform.
19022 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
19023 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
19024 #
19025 # If a policy for an
19026 # error code is not configured for the RouteRule, a policy for
19027 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
19028 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
19029 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
19030 # effect.
19031 #
19032 # For example, consider a UrlMap with the following configuration:
19033 #
19034 #
19035 # - UrlMap.defaultCustomErrorResponsePolicy are configured
19036 # with policies for 5xx and 4xx errors
19037 # - A RouteRule for /coming_soon/ is configured for the
19038 # error code 404.
19039 #
19040 # 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
19041 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
19042 # the policy in RouteRule.customErrorResponsePolicy takes
19043 # effect. If any of the requests in this example encounter a 500
19044 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
19045 #
19046 # When
19047 # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
19048 # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
19049 # a retry, if load balancer is successful in reaching the
19050 # service, the customErrorResponsePolicy is ignored and
19051 # the response from the service is returned to the client.
19052 #
19053 # customErrorResponsePolicy is supported only for
19054 # global external Application Load Balancers.
19055 # backend service or backend bucket responds with an error.
19056 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
19057 #
19058 # In a given policy, if you specify rules for both a range of error codes
19059 # as well as rules for specific error codes then rules with specific error
19060 # codes have a higher priority. For example, assume that you configure a rule
19061 # for 401 (Un-authorized) code, and another for all 4 series
19062 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
19063 # However if the backend service returns a 403, the rule for4xx takes effect.
19064 { # Specifies the mapping between the response code that will be returned along
19065 # with the custom error content and the response code returned by the backend
19066 # service.
19067 &quot;matchResponseCodes&quot;: [ # Valid values include:
19068 #
19069 #
19070 # - A number between 400 and 599: For example
19071 # 401 or 503, in which case the load balancer
19072 # applies the policy if the error code exactly matches this value.
19073 # - 5xx: Load Balancer will apply the policy if the
19074 # backend service responds with any response code in the range of
19075 # 500 to 599.
19076 # - 4xx: Load
19077 # Balancer will apply the policy if the backend service responds with any
19078 # response code in the range of 400 to
19079 # 499.
19080 #
19081 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
19082 &quot;A String&quot;,
19083 ],
19084 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
19085 # error content. If overrideResponseCode is not supplied, the
19086 # same response code returned by the original backend bucket or backend
19087 # service is returned to the client.
19088 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
19089 #
19090 # path must start
19091 # with a leading slash. path cannot have trailing slashes.
19092 #
19093 # If the file is not available in backendBucket or the
19094 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
19095 #
19096 # The value must
19097 # be from 1 to 1024 characters
19098 },
19099 ],
19100 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
19101 # contains the custom error content. Examples are:
19102 #
19103 #
19104 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
19105 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
19106 # - global/backendBuckets/myBackendBucket
19107 #
19108 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
19109 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
19110 #
19111 # If load balancer cannot reach
19112 # the backendBucket, a simple Not Found Error will
19113 # be returned, with the original response code (oroverrideResponseCode if configured).
19114 #
19115 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
19116 },
19117 &quot;description&quot;: &quot;A String&quot;, # The short description conveying the intent of this routeRule.
19118 #
19119 #
19120 # The description can have a maximum length of 1024 characters.
19121 &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
19122 # for the selected backendService.
19123 #
19124 # The headerAction value specified here is applied before the
19125 # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
19126 #
19127 # HeaderAction is not supported for load balancers
19128 # that have
19129 # their loadBalancingScheme set to EXTERNAL.
19130 #
19131 # Not supported when the URL map is bound to a target gRPC proxy that
19132 # has validateForProxyless field set to true.
19133 # the request is passed along to the selected backendService.
19134 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
19135 { # Specification determining how headers are added to requests or responses.
19136 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
19137 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
19138 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
19139 # that already
19140 # exist for the header. If true, headerValue is set for the
19141 # header, discarding any values that were set for that header.
19142 #
19143 # The default value is true,
19144 # unless a variable is present in headerValue,
19145 # in which case the default value is false.
19146 # .
19147 },
19148 ],
19149 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
19150 # request before forwarding the request to the backendService.
19151 &quot;A String&quot;,
19152 ],
19153 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
19154 # client.
19155 { # Specification determining how headers are added to requests or responses.
19156 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
19157 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
19158 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
19159 # that already
19160 # exist for the header. If true, headerValue is set for the
19161 # header, discarding any values that were set for that header.
19162 #
19163 # The default value is true,
19164 # unless a variable is present in headerValue,
19165 # in which case the default value is false.
19166 # .
19167 },
19168 ],
19169 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
19170 # response before sending the response back to the client.
19171 &quot;A String&quot;,
19172 ],
19173 },
19174 &quot;httpFilterConfigs&quot;: [ # Outbound route specific configuration fornetworkservices.HttpFilter resources enabled by Traffic
19175 # Director. httpFilterConfigs only applies for load balancers
19176 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
19177 # more details.
19178 #
19179 # Not supported when the URL map is bound to a target gRPC proxy that
19180 # has validateForProxyless field set to true.
19181 { # HttpFilterConfiguration supplies additional contextual settings
19182 # for networkservices.HttpFilter resources enabled by Traffic
19183 # Director.
19184 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
19185 # YAML formatted and only contain fields defined in the protobuf identified
19186 # in configTypeUrl
19187 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
19188 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
19189 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
19190 # configuration belongs to. This name must be known to the xDS client.
19191 # Example: envoy.wasm
19192 },
19193 ],
19194 &quot;httpFilterMetadata&quot;: [ # Outbound route specific metadata supplied tonetworkservices.HttpFilter resources enabled by Traffic
19195 # Director. httpFilterMetadata only applies for load balancers
19196 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
19197 # more details.
19198 #
19199 # The only configTypeUrl supported istype.googleapis.com/google.protobuf.Struct
19200 #
19201 # Not supported when the URL map is bound to a target gRPC proxy that
19202 # has validateForProxyless field set to true.
19203 { # HttpFilterConfiguration supplies additional contextual settings
19204 # for networkservices.HttpFilter resources enabled by Traffic
19205 # Director.
19206 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
19207 # YAML formatted and only contain fields defined in the protobuf identified
19208 # in configTypeUrl
19209 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
19210 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
19211 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
19212 # configuration belongs to. This name must be known to the xDS client.
19213 # Example: envoy.wasm
19214 },
19215 ],
19216 &quot;matchRules&quot;: [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
19217 # this routeRule when any of thematchRules are satisfied. However predicates within
19218 # a given matchRule have AND semantics. All predicates
19219 # within a matchRule must match for the request to
19220 # match the rule.
19221 { # HttpRouteRuleMatch specifies a set of criteria for matching
19222 # requests to an HttpRouteRule. All specified criteria must
19223 # be satisfied for a match to occur.
19224 &quot;fullPathMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
19225 # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
19226 # that may be part of the original URL.
19227 #
19228 # fullPathMatch must be from 1 to 1024 characters.
19229 #
19230 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
19231 # specified.
19232 &quot;headerMatches&quot;: [ # Specifies a list of header match criteria, all of which must match
19233 # corresponding headers in the request.
19234 { # matchRule criteria for request header matches.
19235 &quot;exactMatch&quot;: &quot;A String&quot;, # The value should exactly match contents of exactMatch.
19236 #
19237 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
19238 &quot;headerName&quot;: &quot;A String&quot;, # The name of the HTTP header to match.
19239 #
19240 # For matching against the HTTP request&#x27;s authority, use a headerMatch
19241 # with the header name &quot;:authority&quot;.
19242 #
19243 # For matching a request&#x27;s method, use the headerName &quot;:method&quot;.
19244 #
19245 # When the URL map is bound to a target gRPC proxy that has
19246 # the validateForProxyless field set to true, only
19247 # non-binary
19248 # user-specified custom metadata and the `content-type` header are supported.
19249 # The following transport-level headers cannot be used in header matching
19250 # rules:
19251 # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
19252 # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
19253 # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
19254 # `grpc-timeout` and `grpc-trace-bin`.
19255 &quot;invertMatch&quot;: True or False, # If set to false, the headerMatch is considered a
19256 # match if the preceding match criteria are met. If set to true,
19257 # the headerMatch is considered a match if the preceding
19258 # match criteria are NOT met.
19259 #
19260 # The default setting is false.
19261 &quot;prefixMatch&quot;: &quot;A String&quot;, # The value of the header must start with the contents ofprefixMatch.
19262 #
19263 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
19264 &quot;presentMatch&quot;: True or False, # A header with the contents of headerName must exist. The
19265 # match takes place whether or not the request&#x27;s header has a value.
19266 #
19267 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
19268 &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
19269 # specified in rangeMatch. If the header does not contain an
19270 # integer, number or is empty, the match fails.
19271 #
19272 # For example for a range [-5, 0]
19273 #
19274 #
19275 # - -3 will match.
19276 # - 0 will not match.
19277 # - 0.25 will not match.
19278 # - -3someString will not match.
19279 #
19280 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
19281 #
19282 # rangeMatch is not supported for load balancers
19283 # that have loadBalancingScheme set to EXTERNAL.
19284 # within the specified integer range.
19285 &quot;rangeEnd&quot;: &quot;A String&quot;, # The end of the range (exclusive) in signed long integer format.
19286 &quot;rangeStart&quot;: &quot;A String&quot;, # The start of the range (inclusive) in signed long integer format.
19287 },
19288 &quot;regexMatch&quot;: &quot;A String&quot;, # The value of the header must match the regular expression specified inregexMatch.
19289 # For more information about regular expression syntax, see Syntax.
19290 #
19291 # For matching against a port specified in the HTTP request, use a
19292 # headerMatch with headerName set to PORT and a regular expression that
19293 # satisfies the RFC2616 Host header&#x27;s port specifier.
19294 #
19295 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
19296 #
19297 # Regular expressions can only be used when the loadBalancingScheme is
19298 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
19299 # (regional scope) or INTERNAL_MANAGED.
19300 &quot;suffixMatch&quot;: &quot;A String&quot;, # The value of the header must end with the contents ofsuffixMatch.
19301 #
19302 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
19303 },
19304 ],
19305 &quot;ignoreCase&quot;: True or False, # Specifies that prefixMatch and fullPathMatch
19306 # matches are case sensitive.
19307 #
19308 # The default value is false.
19309 #
19310 # ignoreCase must not be used with regexMatch.
19311 #
19312 # Not supported when the URL map is bound to a target gRPC proxy.
19313 &quot;metadataFilters&quot;: [ # Opaque filter criteria used by the load balancer to restrict routing
19314 # configuration to a limited set of xDS
19315 # compliant clients. In their xDS requests to the load balancer, xDS clients
19316 # present node
19317 # metadata. When there is a match, the relevant routing configuration
19318 # is made available to those proxies.
19319 #
19320 # 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
19321 # the metadata. If its filterMatchCriteria is set to
19322 # MATCH_ALL, then all of its filterLabels must match with
19323 # corresponding labels provided in the metadata. If multiple
19324 # metadata filters are specified, all of them need to be
19325 # satisfied in order to be considered a match.
19326 #
19327 # metadataFilters specified here is applied after those
19328 # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
19329 #
19330 # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
19331 #
19332 # Not supported when the URL map is bound to a target gRPC proxy that
19333 # has validateForProxyless field set to true.
19334 { # Opaque filter criteria used by load balancers to restrict routing
19335 # configuration to a limited set of load balancing proxies. Proxies and
19336 # sidecars involved in load balancing would typically present metadata to the
19337 # load balancers that need to match criteria specified here. If a match takes
19338 # place, the relevant configuration is made available to those
19339 # proxies.
19340 #
19341 # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
19342 # one of thefilterLabels must match the corresponding label provided in
19343 # the metadata. If its filterMatchCriteria is set to
19344 # MATCH_ALL, then all of its filterLabels must match with
19345 # corresponding labels provided in the metadata.
19346 #
19347 # An example for using metadataFilters would be: if
19348 # load balancing involves
19349 # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in of their XDS requests to loadbalancers.
19350 &quot;filterLabels&quot;: [ # The list of label value pairs that must match labels in the provided
19351 # metadata based on filterMatchCriteria
19352 #
19353 # This list must not be empty and can have at the most 64 entries.
19354 { # MetadataFilter label name value pairs that are expected
19355 # to match corresponding labels presented as metadata to the load balancer.
19356 &quot;name&quot;: &quot;A String&quot;, # Name of metadata label.
19357 #
19358 # The name can have a maximum length of 1024 characters and must be at
19359 # least 1 character long.
19360 &quot;value&quot;: &quot;A String&quot;, # The value of the label must match the specified value.
19361 #
19362 # value can have a maximum length of 1024 characters.
19363 },
19364 ],
19365 &quot;filterMatchCriteria&quot;: &quot;A String&quot;, # Specifies how individual filter label matches
19366 # within the list of filterLabels and contributes toward the
19367 # overall metadataFilter match.
19368 #
19369 # Supported values are:
19370 #
19371 # - MATCH_ANY: at least one of the filterLabels
19372 # must have a matching label in the provided metadata.
19373 # - MATCH_ALL: all filterLabels must have
19374 # matching labels in the provided metadata.
19375 },
19376 ],
19377 &quot;pathTemplateMatch&quot;: &quot;A String&quot;, # If specified, this field defines a path template pattern that must match
19378 # the :path header after the query string is removed.
19379 #
19380 # A path template pattern can include variables and wildcards.
19381 # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
19382 # matches a single path segment, and ** that matches zero or
19383 # more path segments. The pattern must follow these rules:
19384 #
19385 #
19386 # - The value must be between 1 and 1024 characters.
19387 # - The pattern must start with a leading slash (&quot;/&quot;).
19388 # - No more than 5 operators (variables or wildcards) may appear in
19389 # the pattern.
19390 #
19391 # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
19392 # set.
19393 &quot;prefixMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the request&#x27;s
19394 # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
19395 #
19396 # The value must be from 1 to 1024 characters.
19397 #
19398 # The * character inside a prefix match is
19399 # treated as a literal character, not as a wildcard.
19400 #
19401 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
19402 # used within a matchRule.
19403 &quot;queryParameterMatches&quot;: [ # Specifies a list of query parameter match criteria, all of which must
19404 # match corresponding query parameters in the request.
19405 #
19406 # Not supported when the URL map is bound to a target gRPC proxy.
19407 { # HttpRouteRuleMatch criteria for a request&#x27;s query parameter.
19408 &quot;exactMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
19409 # parameter exactly matches the contents of exactMatch.
19410 #
19411 # Only one of presentMatch, exactMatch, orregexMatch must be set.
19412 &quot;name&quot;: &quot;A String&quot;, # The name of the query parameter to match. The query parameter must exist in
19413 # the request, in the absence of which the request match fails.
19414 &quot;presentMatch&quot;: True or False, # Specifies that the queryParameterMatch matches if the
19415 # request contains the query parameter, irrespective of whether the
19416 # parameter has a value or not.
19417 #
19418 # Only one of presentMatch, exactMatch, orregexMatch must be set.
19419 &quot;regexMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
19420 # parameter matches the regular expression specified byregexMatch. For
19421 # more information about regular expression syntax, see Syntax.
19422 #
19423 # Only one of presentMatch, exactMatch, orregexMatch must be set.
19424 #
19425 # Regular expressions can only be used when the loadBalancingScheme is
19426 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
19427 # (regional scope) or INTERNAL_MANAGED.
19428 },
19429 ],
19430 &quot;regexMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
19431 # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
19432 # supplied with the original URL. For
19433 # more information about regular expression syntax, see Syntax.
19434 #
19435 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
19436 # specified.
19437 #
19438 # Regular expressions can only be used when the loadBalancingScheme is
19439 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
19440 # (regional scope) or INTERNAL_MANAGED.
19441 },
19442 ],
19443 &quot;priority&quot;: 42, # For routeRules within a given pathMatcher,
19444 # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
19445 # of priority, from the lowest to highest number. The priority of a
19446 # rule decreases as its number increases (1, 2, 3, N+1). The first rule
19447 # that matches the request is applied.
19448 #
19449 #
19450 # You cannot configure two or more routeRules with the same priority.
19451 # Priority for each rule must be set to a number from 0 to 2147483647
19452 # inclusive.
19453 #
19454 #
19455 # Priority numbers can have gaps, which enable you to add or remove rules
19456 # in the future without affecting the rest of the rules. For example, 1, 2,
19457 # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
19458 # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
19459 # without any impact on existing rules.
19460 &quot;routeAction&quot;: { # In response to a matching matchRule, the load balancer
19461 # performs advanced routing actions, such as URL rewrites and header
19462 # transformations, before forwarding the request to the selected backend.
19463 #
19464 #
19465 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
19466 #
19467 #
19468 # URL maps for classic Application Load Balancers only support
19469 # the urlRewrite action within a route rule&#x27;srouteAction.
19470 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
19471 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
19472 # property must be specified. This policy cannot be specified if any target
19473 # backend has Identity-Aware Proxy enabled.
19474 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
19475 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
19476 # header names can be specified. The cache is bypassed for all `cacheMode`
19477 # values.
19478 &quot;A String&quot;,
19479 ],
19480 &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
19481 # on the backend type: for Backend Services, the complete request URI is
19482 # used; for Backend Buckets, the request URI is used without the protocol or
19483 # host, and only query parameters known to Cloud Storage are included.
19484 # Policy defined on Route Action.
19485 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
19486 # parameters will be included. Either specify `excludedQueryParameters`
19487 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
19488 # encoded and not treated as delimiters.
19489 #
19490 # Note: This field applies to routes that use backend services. Attempting
19491 # to set it on a route that points exclusively to Backend Buckets will
19492 # result in a configuration error. For routes that point to a Backend
19493 # Bucket, use `includedQueryParameters` to define which parameters should
19494 # be part of the cache key.
19495 &quot;A String&quot;,
19496 ],
19497 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
19498 #
19499 # Note: This setting is only applicable to routes that use a Backend
19500 # Service. It does not affect requests served by a Backend Bucket, as the
19501 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
19502 # it on a route that points exclusively to Backend Buckets will result in a
19503 # configuration error.
19504 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
19505 #
19506 # Note: This setting is only applicable to routes that use a Backend
19507 # Service. It does not affect requests served by a Backend Bucket, as the
19508 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
19509 # set on a route that points exclusively to Backend Buckets will result in
19510 # a configuration error.
19511 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
19512 # `includedQueryParameters` and `excludedQueryParameters`. If neither
19513 # is set, the entire query string will be included. If false, the query
19514 # string will be excluded from the cache key entirely.
19515 #
19516 # Note: This field applies to routes that use backend services. Attempting
19517 # to set it on a route that points exclusively to Backend Buckets will
19518 # result in a configuration error. For routes that point to a Backend
19519 # Bucket, use `includedQueryParameters` to define which parameters should
19520 # be part of the cache key.
19521 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
19522 # The name=value pair will be used in the cache key Cloud CDN generates.
19523 #
19524 # Note: This setting is only applicable to routes that use a Backend
19525 # Service. It does not affect requests served by a Backend Bucket.
19526 # Attempting to set it on a route that points exclusively to Backend
19527 # Buckets will result in a configuration error. Up to 5 cookie names can be
19528 # specified.
19529 &quot;A String&quot;,
19530 ],
19531 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
19532 &quot;A String&quot;,
19533 ],
19534 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
19535 # parameters will be excluded. Either specify `includedQueryParameters`
19536 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
19537 # encoded and not treated as delimiters.
19538 &quot;A String&quot;,
19539 ],
19540 },
19541 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
19542 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
19543 &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
19544 # content. This is used to clamp the max-age (or Expires) value sent to the
19545 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
19546 # is used for the response max-age directive, along with a &quot;public&quot;
19547 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
19548 # clamps the max-age from the origin (if specified), or else sets the
19549 # response max-age directive to the lesser of the `clientTtl` and
19550 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
19551 # present. The maximum allowed value is 31,622,400s (1 year). If not
19552 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
19553 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
19554 # `USE_ORIGIN_HEADERS`.
19555 # as a count of seconds and fractions of seconds at nanosecond
19556 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19557 # or &quot;month&quot;. Range is approximately 10,000 years.
19558 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19559 # Durations less than one second are represented with a 0
19560 # `seconds` field and a positive `nanos` field. Must be from 0
19561 # to 999,999,999 inclusive.
19562 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19563 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19564 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19565 },
19566 &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
19567 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
19568 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
19569 # greater than that of `maxTtl`. When the `cacheMode` is set to
19570 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
19571 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
19572 # accessed objects may be evicted from the cache before the defined TTL. If
19573 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
19574 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
19575 # `USE_ORIGIN_HEADERS`.
19576 # as a count of seconds and fractions of seconds at nanosecond
19577 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19578 # or &quot;month&quot;. Range is approximately 10,000 years.
19579 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19580 # Durations less than one second are represented with a 0
19581 # `seconds` field and a positive `nanos` field. Must be from 0
19582 # to 999,999,999 inclusive.
19583 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19584 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19585 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19586 },
19587 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
19588 # attempt to set a max-age or s-maxage higher than this, or an Expires header
19589 # more than `maxTtl` seconds in the future will be capped at the value of
19590 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
19591 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
19592 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
19593 # Infrequently accessed objects may be evicted from the cache before the
19594 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
19595 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
19596 # mode.
19597 # as a count of seconds and fractions of seconds at nanosecond
19598 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19599 # or &quot;month&quot;. Range is approximately 10,000 years.
19600 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19601 # Durations less than one second are represented with a 0
19602 # `seconds` field and a positive `nanos` field. Must be from 0
19603 # to 999,999,999 inclusive.
19604 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19605 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19606 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19607 },
19608 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
19609 # to apply fine-grained caching for common errors or redirects.
19610 # This can reduce the load on your origin and improve end-user
19611 # experience by reducing response latency.
19612 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
19613 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
19614 # the specified response code that lack any Cache-Control, Expires, or
19615 # Pragma: no-cache directives. When the `cacheMode` is set to
19616 # `FORCE_CACHE_ALL`, negative caching applies to all responses
19617 # with the specified response code, and overrides any caching headers. By
19618 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
19619 #
19620 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
19621 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
19622 # * 405 (Method Not Found), 501 (Not Implemented): 60s
19623 #
19624 # These defaults can be overridden in `negativeCachingPolicy`.
19625 # If not specified, Cloud CDN applies negative caching by default.
19626 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
19627 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
19628 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
19629 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
19630 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
19631 # all response codes that you wish to cache. Cloud CDN will not apply any
19632 # default negative caching when a policy exists.
19633 { # Specify CDN TTLs for response error codes.
19634 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
19635 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
19636 # specified as values, and you cannot specify a status code more than
19637 # once.
19638 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
19639 # corresponding status code.
19640 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
19641 # objects may be evicted from the cache before the defined TTL.
19642 # as a count of seconds and fractions of seconds at nanosecond
19643 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19644 # or &quot;month&quot;. Range is approximately 10,000 years.
19645 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19646 # Durations less than one second are represented with a 0
19647 # `seconds` field and a positive `nanos` field. Must be from 0
19648 # to 999,999,999 inclusive.
19649 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19650 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19651 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19652 },
19653 },
19654 ],
19655 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
19656 # requests into a small number of requests to the origin. If not specified,
19657 # Cloud CDN applies request coalescing by default.
19658 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
19659 # content with the origin, or when an error is encountered when refreshing
19660 # the cache.
19661 # This setting defines the default &quot;max-stale&quot; duration for any cached
19662 # responses that do not specify a max-stale directive. Stale responses that
19663 # exceed the TTL configured here will not be served. The default limit
19664 # (max-stale) is 86400s (1 day), which will allow stale content to be
19665 # served up to this limit beyond the max-age (or s-maxage) of a cached
19666 # response.
19667 # The maximum allowed value is 604800 (1 week).
19668 # Set this to zero (0) to disable serve-while-stale.
19669 # as a count of seconds and fractions of seconds at nanosecond
19670 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19671 # or &quot;month&quot;. Range is approximately 10,000 years.
19672 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19673 # Durations less than one second are represented with a 0
19674 # `seconds` field and a positive `nanos` field. Must be from 0
19675 # to 999,999,999 inclusive.
19676 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19677 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19678 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19679 },
19680 },
19681 &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
19682 # information about the W3C recommendation for cross-origin resource sharing
19683 # (CORS), see Fetch API Living
19684 # Standard.
19685 #
19686 # Not supported when the URL map is bound to a target gRPC proxy.
19687 # information about the W3C recommendation for cross-origin resource sharing
19688 # (CORS), see Fetch API Living
19689 # Standard.
19690 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
19691 # indicates that
19692 # the actual request can include user credentials. This field translates to
19693 # the Access-Control-Allow-Credentials header.
19694 #
19695 # Default is false.
19696 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
19697 # header.
19698 &quot;A String&quot;,
19699 ],
19700 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
19701 # header.
19702 &quot;A String&quot;,
19703 ],
19704 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
19705 # more information, see regular expression syntax.
19706 #
19707 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
19708 #
19709 # Regular expressions can only be used when the loadBalancingScheme is
19710 # set to INTERNAL_SELF_MANAGED.
19711 &quot;A String&quot;,
19712 ],
19713 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
19714 #
19715 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
19716 &quot;A String&quot;,
19717 ],
19718 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
19719 # The default value is false, which indicates that the CORS
19720 # policy is in effect.
19721 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
19722 # header.
19723 &quot;A String&quot;,
19724 ],
19725 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
19726 # seconds. This field translates to the Access-Control-Max-Age
19727 # header.
19728 },
19729 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
19730 # the resiliency of clients to backend service failure. As part of fault
19731 # injection, when clients send requests to a backend service, delays can be
19732 # introduced by a load balancer on a percentage of requests before sending
19733 # those requests to the backend service. Similarly requests from clients can
19734 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
19735 # that are configured with a fault_injection_policy if:
19736 # 1. The traffic is generated by fault injection AND
19737 # 2. The fault injection is not a delay fault injection.
19738 # Fault injection is not supported with the classic Application Load Balancer
19739 # . To see which load balancers support fault injection,
19740 # see Load
19741 # balancing: Routing and traffic management features.
19742 # the resiliency of clients to backend service failure. As part of fault
19743 # injection, when clients send requests to a backend service, delays can be
19744 # introduced by the load balancer on a percentage of requests before sending
19745 # those request to the backend service. Similarly requests from clients can be
19746 # aborted by the load balancer for a percentage of requests.
19747 &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
19748 # injection.
19749 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
19750 #
19751 # The value must be from 200 to 599 inclusive.
19752 #
19753 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
19754 # according to this
19755 # mapping table. HTTP status 200 is mapped to gRPC status
19756 # UNKNOWN. Injecting an OK status is currently not supported by
19757 # Traffic Director.
19758 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
19759 # that is aborted as part of fault injection.
19760 #
19761 # The value must be from 0.0 to 100.0 inclusive.
19762 },
19763 &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
19764 # injection, before being sent to a backend service.
19765 # request to the backend service as part of fault injection.
19766 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
19767 # as a count of seconds and fractions of seconds at nanosecond
19768 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19769 # or &quot;month&quot;. Range is approximately 10,000 years.
19770 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19771 # Durations less than one second are represented with a 0
19772 # `seconds` field and a positive `nanos` field. Must be from 0
19773 # to 999,999,999 inclusive.
19774 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19775 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19776 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19777 },
19778 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
19779 # which a delay is introduced as part of fault injection.
19780 #
19781 # The value must be from 0.0 to 100.0 inclusive.
19782 },
19783 },
19784 &quot;imageOptimizationPolicy&quot;: { # The configuration for Cloud CDN&#x27;s image optimization feature. This feature # Image optimization policy for this URL Map&#x27;s route. Available only for
19785 # Global EXTERNAL_MANAGED load balancer schemes.
19786 # Either Cloud CDN must be enabled on the backend service or backend bucket
19787 # serving the route, or cache policy must be configured on the same route
19788 # dynamically processes and delivers images from the network edge.
19789 # Image Optimization is only available for Global External Application Load
19790 # Balancers.
19791 # Either Cloud CDN must be enabled on the backend service or backend bucket
19792 # serving the route, or cache policy must be configured on the same route.
19793 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
19794 },
19795 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
19796 # Unlike the timeout field where the timeout duration starts
19797 # from the time the request has been fully processed (known as*end-of-stream*),
19798 # the duration in this field is computed from the beginning of the stream
19799 # until the response has been processed, including all retries. A
19800 # stream that does not complete in this duration is closed.
19801 #
19802 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
19803 # with the route.
19804 #
19805 # This field is only allowed if the Url map is used with backend services
19806 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
19807 # as a count of seconds and fractions of seconds at nanosecond
19808 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19809 # or &quot;month&quot;. Range is approximately 10,000 years.
19810 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19811 # Durations less than one second are represented with a 0
19812 # `seconds` field and a positive `nanos` field. Must be from 0
19813 # to 999,999,999 inclusive.
19814 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19815 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19816 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19817 },
19818 &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
19819 # are shadowed to a separate mirrored backend service. The load balancer does
19820 # not wait for responses from the shadow service. Before sending traffic
19821 # to the shadow service, the host / authority header is suffixed with-shadow.
19822 #
19823 # Not supported when the URL map is bound to a target gRPC proxy that
19824 # has the validateForProxyless field set to true.
19825 # are shadowed to a separate mirrored backend service. The load balancer
19826 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
19827 # to the shadow service, the host or authority header is suffixed with-shadow.
19828 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
19829 # mirrored to.
19830 #
19831 # The backend service configured for a mirroring
19832 # policy must reference backends that are of the same type as the original
19833 # backend service matched in the URL map.
19834 #
19835 # Serverless NEG backends are not currently supported as a mirrored
19836 # backend service.
19837 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
19838 },
19839 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
19840 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
19841 # If not specified, defaults to 1.
19842 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
19843 #
19844 # If not specified, will use the timeout set in theHttpRouteAction field.
19845 # If timeout in the HttpRouteAction field is not set, this field
19846 # uses the largest timeout
19847 # among all backend services associated with the route.
19848 #
19849 # Not supported when the URL map is bound to a target gRPC proxy that
19850 # has the validateForProxyless field set to true.
19851 # as a count of seconds and fractions of seconds at nanosecond
19852 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19853 # or &quot;month&quot;. Range is approximately 10,000 years.
19854 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19855 # Durations less than one second are represented with a 0
19856 # `seconds` field and a positive `nanos` field. Must be from 0
19857 # to 999,999,999 inclusive.
19858 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19859 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19860 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19861 },
19862 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
19863 # values are:
19864 #
19865 # - 5xx: retry is attempted if the instance or endpoint
19866 # responds with any 5xx response code, or if the instance or
19867 # endpoint does not respond at all. For example, disconnects, reset, read
19868 # timeout, connection failure, and refused streams.
19869 # - gateway-error: Similar to 5xx, but only
19870 # applies to response codes 502, 503 or504.
19871 # - connect-failure: a retry is attempted on failures
19872 # connecting to the instance or endpoint. For example, connection
19873 # timeouts.
19874 # - retriable-4xx: a retry is attempted if the instance
19875 # or endpoint responds with a 4xx response code.
19876 # The only error that you can retry is error code 409.
19877 # - refused-stream: a retry is attempted if the instance
19878 # or endpoint resets the stream with a REFUSED_STREAM error
19879 # code. This reset type indicates that it is safe to retry.
19880 # - cancelled: a retry is attempted if the gRPC status
19881 # code in the response header is set to cancelled.
19882 # - deadline-exceeded: a retry is attempted if the gRPC
19883 # status code in the response header is set todeadline-exceeded.
19884 # - internal: a retry is attempted if the gRPC
19885 # status code in the response header is set tointernal.
19886 # - resource-exhausted: a retry is attempted if the gRPC
19887 # status code in the response header is set toresource-exhausted.
19888 # - unavailable: a retry is attempted if the gRPC
19889 # status code in the response header is set tounavailable.
19890 #
19891 # Only the following codes are supported when the URL map is bound to
19892 # target gRPC proxy that has validateForProxyless field set to true.
19893 #
19894 # - cancelled
19895 # - deadline-exceeded
19896 # - internal
19897 # - resource-exhausted
19898 # - unavailable
19899 &quot;A String&quot;,
19900 ],
19901 },
19902 &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
19903 # time the request has been fully processed (known as *end-of-stream*)
19904 # up until the response has been processed. Timeout includes
19905 # all retries.
19906 #
19907 # If not specified, this field uses the largest timeout among all backend
19908 # services associated with the route.
19909 #
19910 # Not supported when the URL map is bound to a target gRPC proxy that
19911 # has validateForProxyless field set to true.
19912 # as a count of seconds and fractions of seconds at nanosecond
19913 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19914 # or &quot;month&quot;. Range is approximately 10,000 years.
19915 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19916 # Durations less than one second are represented with a 0
19917 # `seconds` field and a positive `nanos` field. Must be from 0
19918 # to 999,999,999 inclusive.
19919 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19920 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19921 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19922 },
19923 &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
19924 # to the matched service.
19925 #
19926 # urlRewrite is the only action supported in UrlMaps
19927 # for classic Application Load Balancers.
19928 #
19929 # Not supported when the URL map is bound to a target gRPC proxy that
19930 # has the validateForProxyless field set to true.
19931 # backend service.
19932 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
19933 # host header is replaced with contents of hostRewrite.
19934 #
19935 # The value must be from 1 to 255 characters.
19936 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
19937 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
19938 #
19939 # The value must be from 1 to 1024 characters.
19940 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
19941 # header) using the HTTP template syntax.
19942 #
19943 # A corresponding
19944 # path_template_match must be specified. Any template variables must exist in
19945 # the path_template_match field.
19946 #
19947 #
19948 # - -At least one variable must be specified in the path_template_match
19949 # field
19950 # - You can omit variables from the rewritten URL
19951 # - The * and ** operators cannot be matched
19952 # unless they have a corresponding variable name - e.g.
19953 # {format=*} or {var=**}.
19954 #
19955 # For example, a path_template_match of /static/{format=**}
19956 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
19957 # rewrite, so that /{country}/{format}/{suffix=**} can be
19958 # rewritten as /content/{format}/{country}/{suffix}.
19959 #
19960 # At least
19961 # one non-empty routeRules[].matchRules[].path_template_match is
19962 # required.
19963 #
19964 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
19965 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
19966 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
19967 # It uses RE2 syntax with the following constraints:
19968 #
19969 #
19970 # - Any single character operators
19971 # - Groups are allowed to have only submatch operator inside
19972 # - Groups are allowed only without any char repetition, e.g.
19973 # .*
19974 # - Any char repetition, e.g. .*, is
19975 # only allowed to be used in a single regex together with:
19976 #
19977 #
19978 # - Empty string operators
19979 # - Other repetitions
19980 # - Ranges
19981 # - Repetitions of ranges
19982 #
19983 #
19984 # - Ranges are only allowed to have:
19985 #
19986 #
19987 # - Character range
19988 # - Digits range
19989 # - Symbols listed in characters allowed for ranges
19990 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
19991 # the path.
19992 },
19993 },
19994 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
19995 # occurs. The weights determine the fraction of traffic that flows to
19996 # their corresponding backend service. If all traffic needs to
19997 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
19998 #
19999 # After a backend service is identified and before forwarding
20000 # the request to
20001 # the backend service, advanced routing actions such as URL rewrites and
20002 # header transformations are applied depending on additional settings
20003 # specified in this HttpRouteAction.
20004 { # In contrast to a single BackendService in
20005 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
20006 # multiple backend services. The volume of traffic for each
20007 # backend service is proportional to the weight specified
20008 # in each WeightedBackendService
20009 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
20010 # resource. Before
20011 # forwarding the request to backendService, the load balancer
20012 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
20013 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
20014 # effect for the selected backendService.
20015 #
20016 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
20017 #
20018 # headerAction is not supported for load balancers that have
20019 # their loadBalancingScheme set to EXTERNAL.
20020 #
20021 # Not supported when the URL map is bound to a target gRPC proxy that
20022 # has validateForProxyless field set to true.
20023 # the request is passed along to the selected backendService.
20024 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
20025 { # Specification determining how headers are added to requests or responses.
20026 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
20027 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
20028 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
20029 # that already
20030 # exist for the header. If true, headerValue is set for the
20031 # header, discarding any values that were set for that header.
20032 #
20033 # The default value is true,
20034 # unless a variable is present in headerValue,
20035 # in which case the default value is false.
20036 # .
20037 },
20038 ],
20039 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
20040 # request before forwarding the request to the backendService.
20041 &quot;A String&quot;,
20042 ],
20043 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
20044 # client.
20045 { # Specification determining how headers are added to requests or responses.
20046 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
20047 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
20048 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
20049 # that already
20050 # exist for the header. If true, headerValue is set for the
20051 # header, discarding any values that were set for that header.
20052 #
20053 # The default value is true,
20054 # unless a variable is present in headerValue,
20055 # in which case the default value is false.
20056 # .
20057 },
20058 ],
20059 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
20060 # response before sending the response back to the client.
20061 &quot;A String&quot;,
20062 ],
20063 },
20064 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
20065 # computed asweight / (sum of all weightedBackendService weights in routeAction).
20066 #
20067 # The selection of a backend service is determined only for new traffic.
20068 # Once a user&#x27;s request has been directed to a backend service,
20069 # subsequent requests are sent to the same backend service as
20070 # determined by the backend service&#x27;s session affinity policy.
20071 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
20072 # splitting. If you do, the weighted traffic splitting configuration takes
20073 # precedence.
20074 #
20075 # The value must be from 0 to 1000.
20076 },
20077 ],
20078 },
20079 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
20080 # is directed if this rule is matched. If routeAction is
20081 # also specified, advanced routing actions, such as URL rewrites,
20082 # take effect before sending the request to the backend.
20083 #
20084 #
20085 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
20086 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
20087 # specified by urlRedirect.
20088 #
20089 #
20090 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
20091 #
20092 #
20093 # Not supported when the URL map is bound to a target gRPC proxy.
20094 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
20095 # was supplied in the request.
20096 #
20097 # The value must be from 1 to 255
20098 # characters.
20099 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
20100 # set to HTTPS.
20101 # If set to false, the URL scheme of the redirected request
20102 # remains the same as that of the request.
20103 #
20104 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
20105 #
20106 # The default is set to false.
20107 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
20108 # that was supplied in the request.
20109 #
20110 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
20111 # supplied, the path of the original request is used for the redirect.
20112 #
20113 # The value must be from 1 to 1024 characters.
20114 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
20115 # the HttpRouteRuleMatch, retaining the remaining portion
20116 # of the URL before redirecting the request.
20117 #
20118 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
20119 # supplied, the path of the original request is used for the redirect.
20120 #
20121 # The value must be from 1 to 1024 characters.
20122 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
20123 #
20124 # Supported values are:
20125 #
20126 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
20127 # to 301.
20128 # - FOUND, which corresponds to 302.
20129 # - SEE_OTHER which corresponds to 303.
20130 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
20131 # method is retained.
20132 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
20133 # method is retained.
20134 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
20135 # URL is
20136 # removed before redirecting the request. If set to false, the
20137 # query portion of the original URL is retained.
20138 #
20139 # The default is set to false.
20140 },
20141 },
20142 ],
20143 },
20144 ],
20145 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the regional URL map resides.
20146 # This field is not applicable to global URL maps.
20147 # You must specify this field as part of the HTTP request URL. It is
20148 # not settable as a field in the request body.
20149 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
20150 &quot;status&quot;: { # [Output Only] The status of the URL map. # Output only. [Output Only] The status of the URL map.
20151 &quot;quotaUsage&quot;: { # Message representing the quota usage for a UrlMap. # Output only. Summary of quota usage for given UrlMap.
20152 &quot;forwardingRules&quot;: 42, # Output only. The number of forwarding rules that uses this UrlMap.
20153 &quot;units&quot;: &quot;A String&quot;, # Output only. The number of quota units calculated for this UrlMap.
20154 },
20155 },
20156 &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
20157 # maximum of 100 tests per UrlMap.
20158 #
20159 # Not supported when the URL map is bound to a target gRPC proxy that
20160 # has validateForProxyless field set to true.
20161 { # Message for the expected URL mappings.
20162 &quot;backendServiceWeight&quot;: 42, # The weight to use for the supplied host and path when using advanced
20163 # routing rules that involve traffic splitting.
20164 &quot;description&quot;: &quot;A String&quot;, # Description of this test case.
20165 &quot;expectedOutputUrl&quot;: &quot;A String&quot;, # The expected output URL evaluated by the load balancer
20166 # containing the scheme, host, path and query parameters.
20167 #
20168 # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
20169 # the load balancer to backends. For rules with urlRewrite,
20170 # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
20171 #
20172 # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer&#x27;s
20173 # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
20174 # If urlRedirect specifies strip_query, the test
20175 # passes only if expectedOutputUrl does not contain any query
20176 # parameters.
20177 #
20178 # expectedOutputUrl is optional whenservice is specified.
20179 &quot;expectedRedirectResponseCode&quot;: 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
20180 # load balancer&#x27;s redirect response.
20181 #
20182 # expectedRedirectResponseCode cannot be set whenservice is set.
20183 &quot;expectedUrlRedirect&quot;: &quot;A String&quot;, # The expected URL that should be redirected to for the host and path
20184 # being tested.
20185 # [Deprecated] This field is deprecated.
20186 # Use expected_output_url instead.
20187 &quot;headers&quot;: [ # HTTP headers for this request. If headers contains
20188 # a host header, then host must also match the header value.
20189 { # HTTP headers used in UrlMapTests.
20190 &quot;name&quot;: &quot;A String&quot;, # Header name.
20191 &quot;value&quot;: &quot;A String&quot;, # Header value.
20192 },
20193 ],
20194 &quot;host&quot;: &quot;A String&quot;, # Host portion of the URL. If headers contains a host header,
20195 # then host must also match the header value.
20196 &quot;path&quot;: &quot;A String&quot;, # Path portion of the URL.
20197 &quot;service&quot;: &quot;A String&quot;, # Expected BackendService or BackendBucket resource
20198 # the given URL should be mapped to.
20199 #
20200 # The service field cannot
20201 # be set if expectedRedirectResponseCode is set.
20202 },
20203 ],
20204 }
20205
20206 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
20207 that if you must retry your request, the server will know to ignore the
20208 request if it has already been completed.
20209
20210 For example, consider a situation where you make an initial request and
20211 the request times out. If you make the request again with the same
20212 request ID, the server can check if original operation with the same
20213 request ID was received, and if so, will ignore the second request. This
20214 prevents clients from accidentally creating duplicate commitments.
20215
20216 The request ID must be
20217 a valid UUID with the exception that zero UUID is not supported
20218 (00000000-0000-0000-0000-000000000000).
20219 x__xgafv: string, V1 error format.
20220 Allowed values
20221 1 - v1 error format
20222 2 - v2 error format
20223
20224 Returns:
20225 An object of the form:
20226
20227 { # Represents an Operation resource.
20228 #
20229 # Google Compute Engine has three Operation resources:
20230 #
20231 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
20232 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
20233 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
20234 #
20235 # You can use an operation resource to manage asynchronous API requests.
20236 # For more information, readHandling
20237 # API responses.
20238 #
20239 # Operations can be global, regional or zonal.
20240 #
20241 # - For global operations, use the `globalOperations`
20242 # resource.
20243 # - For regional operations, use the
20244 # `regionOperations` resource.
20245 # - For zonal operations, use
20246 # the `zoneOperations` resource.
20247 #
20248 #
20249 #
20250 # For more information, read
20251 # Global, Regional, and Zonal Resources.
20252 #
20253 # Note that completed Operation resources have a limited
20254 # retention period.
20255 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
20256 # Not present otherwise.
20257 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
20258 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
20259 # set when the operation is created.
20260 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
20261 # text format.
20262 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
20263 # this field will be populated.
20264 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
20265 # operation.
20266 {
20267 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
20268 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
20269 # details. There is a set of defined message types to use for providing
20270 # details.The syntax depends on the error code. For example,
20271 # QuotaExceededInfo will have details when the error code is
20272 # QUOTA_EXCEEDED.
20273 {
20274 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
20275 #
20276 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
20277 # is not enabled:
20278 #
20279 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
20280 # &quot;domain&quot;: &quot;googleapis.com&quot;
20281 # &quot;metadata&quot;: {
20282 # &quot;resource&quot;: &quot;projects/123&quot;,
20283 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
20284 # }
20285 # }
20286 #
20287 # This response indicates that the pubsub.googleapis.com API is not enabled.
20288 #
20289 # Example of an error that is returned when attempting to create a Spanner
20290 # instance in a region that is out of stock:
20291 #
20292 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
20293 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
20294 # &quot;metadata&quot;: {
20295 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
20296 # }
20297 # }
20298 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
20299 # is typically the registered service name of the tool or product that
20300 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
20301 # generated by some common infrastructure, the error domain must be a
20302 # globally unique value that identifies the infrastructure. For Google API
20303 # infrastructure, the error domain is &quot;googleapis.com&quot;.
20304 &quot;metadatas&quot;: { # Additional structured details about this error.
20305 #
20306 # Keys must match a regular expression of `a-z+` but should
20307 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
20308 # length. When identifying the current value of an exceeded limit, the units
20309 # should be contained in the key, not the value. For example, rather than
20310 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
20311 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
20312 # instances that can be created in a single (batch) request.
20313 &quot;a_key&quot;: &quot;A String&quot;,
20314 },
20315 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
20316 # proximate cause of the error. Error reasons are unique within a particular
20317 # domain of errors. This should be at most 63 characters and match a
20318 # regular expression of `A-Z+[A-Z0-9]`, which represents
20319 # UPPER_SNAKE_CASE.
20320 },
20321 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
20322 #
20323 # For example, if a quota check failed with an error indicating the calling
20324 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
20325 # directly to the right place in the developer console to flip the bit.
20326 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
20327 { # Describes a URL link.
20328 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
20329 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
20330 },
20331 ],
20332 },
20333 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
20334 # which can be attached to an RPC error.
20335 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
20336 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
20337 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
20338 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
20339 },
20340 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
20341 &quot;dimensions&quot;: { # The map holding related quota dimensions.
20342 &quot;a_key&quot;: &quot;A String&quot;,
20343 },
20344 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
20345 # type or metric.
20346 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
20347 # or metric.
20348 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
20349 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
20350 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
20351 },
20352 },
20353 ],
20354 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
20355 # This property is optional.
20356 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
20357 },
20358 ],
20359 },
20360 &quot;getVersionOperationMetadata&quot;: {
20361 &quot;inlineSbomInfo&quot;: {
20362 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
20363 # appropriate identifiers.
20364 &quot;a_key&quot;: &quot;A String&quot;,
20365 },
20366 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
20367 # identifiers.
20368 &quot;a_key&quot;: &quot;A String&quot;,
20369 },
20370 },
20371 },
20372 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
20373 # message that was returned, such as `NOT FOUND`.
20374 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
20375 # status code that was returned. For example, a `404` means the
20376 # resource was not found.
20377 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
20378 # defined by the server.
20379 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
20380 # This value is inRFC3339
20381 # text format.
20382 &quot;instancesBulkInsertOperationMetadata&quot;: {
20383 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
20384 # Example key: zones/us-central1-a
20385 &quot;a_key&quot;: {
20386 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
20387 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
20388 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
20389 # error.
20390 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
20391 # if the flow is rolling forward or rolling back.
20392 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
20393 },
20394 },
20395 },
20396 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
20397 # Operation resources.
20398 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
20399 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
20400 # group of operations results from a `bulkInsert` API request.
20401 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
20402 # `update`, or `delete`, and so on.
20403 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
20404 # There is no requirement that this be linear or support any granularity of
20405 # operations. This should not be used to guess when the operation will be
20406 # complete. This number should monotonically increase as the operation
20407 # progresses.
20408 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
20409 # applicable when performing regional operations.
20410 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
20411 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
20412 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
20413 # this field will contain information on all underlying zonal actions and
20414 # their state.
20415 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
20416 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
20417 # Example key: zones/us-central1-a
20418 &quot;a_key&quot;: {
20419 &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
20420 # populated.
20421 # different programming environments, including REST APIs and RPC APIs. It is
20422 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
20423 # three pieces of data: error code, error message, and error details.
20424 #
20425 # You can find out more about this error model and how to work with it in the
20426 # [API Design Guide](https://cloud.google.com/apis/design/errors).
20427 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
20428 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
20429 # message types for APIs to use.
20430 {
20431 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
20432 },
20433 ],
20434 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
20435 # user-facing error message should be localized and sent in the
20436 # google.rpc.Status.details field, or localized by the client.
20437 },
20438 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
20439 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
20440 },
20441 },
20442 },
20443 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
20444 # This value is inRFC3339
20445 # text format.
20446 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
20447 # following:
20448 # `PENDING`, `RUNNING`, or `DONE`.
20449 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
20450 # operation.
20451 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
20452 # of the target resource.
20453 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
20454 # operations related to creating a snapshot, this points to the disk
20455 # that the snapshot was created from.
20456 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
20457 # `[email protected]` or
20458 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
20459 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
20460 # operation, this field will be populated.
20461 {
20462 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
20463 # Engine returns NO_RESULTS_ON_PAGE if there
20464 # are no results in the response.
20465 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
20466 # value format. For example:
20467 #
20468 # &quot;data&quot;: [
20469 # {
20470 # &quot;key&quot;: &quot;scope&quot;,
20471 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
20472 # }
20473 {
20474 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
20475 # returned. For example, for warnings where there are no results in a list
20476 # request for a particular zone, this key might be scope and
20477 # the key value might be the zone name. Other examples might be a key
20478 # indicating a deprecated resource and a suggested replacement, or a
20479 # warning about invalid network settings (for example, if an instance
20480 # attempts to perform IP forwarding but is not enabled for IP forwarding).
20481 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
20482 },
20483 ],
20484 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
20485 },
20486 ],
20487 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
20488 # applicable when performing per-zone operations.
20489 }</pre>
20490 </div>
20491
20492 <div class="method">
20493 <code class="details" id="testIamPermissions">testIamPermissions(project, resource, body=None, x__xgafv=None)</code>
20494 <pre>Returns permissions that a caller has on the specified resource.
20495
20496 Args:
20497 project: string, Project ID for this request. (required)
20498 resource: string, Name or id of the resource for this request. (required)
20499 body: object, The request body.
20500 The object takes the form of:
20501
20502 {
20503 &quot;permissions&quot;: [ # The set of permissions to check for the &#x27;resource&#x27;. Permissions with
20504 # wildcards (such as &#x27;*&#x27; or &#x27;storage.*&#x27;) are not allowed.
20505 &quot;A String&quot;,
20506 ],
20507 }
20508
20509 x__xgafv: string, V1 error format.
20510 Allowed values
20511 1 - v1 error format
20512 2 - v2 error format
20513
20514 Returns:
20515 An object of the form:
20516
20517 {
20518 &quot;permissions&quot;: [ # A subset of `TestPermissionsRequest.permissions` that the caller is
20519 # allowed.
20520 &quot;A String&quot;,
20521 ],
20522 }</pre>
20523 </div>
20524
20525 <div class="method">
20526 <code class="details" id="update">update(project, urlMap, body=None, requestId=None, x__xgafv=None)</code>
20527 <pre>Updates the specified UrlMap resource with the data included in the
20528 request.
20529
20530 Args:
20531 project: string, Project ID for this request. (required)
20532 urlMap: string, Name of the UrlMap resource to update. (required)
20533 body: object, The request body.
20534 The object takes the form of:
20535
20536 { # Represents a URL Map resource.
20537 #
20538 # Compute Engine has two URL Map resources:
20539 #
20540 # * [Global](/compute/docs/reference/rest/alpha/urlMaps)
20541 # * [Regional](/compute/docs/reference/rest/alpha/regionUrlMaps)
20542 #
20543 # A URL map resource is a component of certain types of cloud load balancers
20544 # and Traffic Director:
20545 #
20546 # * urlMaps are used by global external Application Load
20547 # Balancers, classic Application Load Balancers, and cross-region internal
20548 # Application Load Balancers.
20549 # * regionUrlMaps are used by internal Application Load Balancers,
20550 # regional external Application Load Balancers and regional internal
20551 # Application Load Balancers.
20552 #
20553 # For a list of supported URL map features by the load balancer type, see the
20554 # Load balancing features: Routing and traffic management table.
20555 #
20556 # For a list of supported URL map features for Traffic Director, see the
20557 # Traffic Director features: Routing and traffic management table.
20558 #
20559 # This resource defines mappings from hostnames and URL paths to either a
20560 # backend service or a backend bucket.
20561 #
20562 # To use the global urlMaps resource, the backend service must
20563 # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
20564 # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
20565 # information, read URL
20566 # Map Concepts.
20567 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
20568 # text format.
20569 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
20570 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
20571 #
20572 # This policy takes
20573 # effect at the load balancer level and applies only when no policy has been
20574 # defined for the error code at lower levels like PathMatcher, RouteRule and
20575 # PathRule within this UrlMap.
20576 #
20577 # For example, consider a UrlMap with the
20578 # following configuration:
20579 #
20580 #
20581 # - defaultCustomErrorResponsePolicy containing policies for
20582 # responding to 5xx and 4xx errors
20583 # - A PathMatcher configured for *.example.com has
20584 # defaultCustomErrorResponsePolicy for 4xx.
20585 #
20586 # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
20587 # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
20588 # a request that does not match any host in *.example.com such
20589 # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
20590 # takes effect.
20591 #
20592 # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
20593 # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
20594 # a retry, if load balancer is successful in reaching the
20595 # service, the defaultCustomErrorResponsePolicy is ignored and
20596 # the response from the service is returned to the client.
20597 #
20598 # defaultCustomErrorResponsePolicy is supported only for
20599 # global external Application Load Balancers.
20600 # backend service or backend bucket responds with an error.
20601 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
20602 #
20603 # In a given policy, if you specify rules for both a range of error codes
20604 # as well as rules for specific error codes then rules with specific error
20605 # codes have a higher priority. For example, assume that you configure a rule
20606 # for 401 (Un-authorized) code, and another for all 4 series
20607 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
20608 # However if the backend service returns a 403, the rule for4xx takes effect.
20609 { # Specifies the mapping between the response code that will be returned along
20610 # with the custom error content and the response code returned by the backend
20611 # service.
20612 &quot;matchResponseCodes&quot;: [ # Valid values include:
20613 #
20614 #
20615 # - A number between 400 and 599: For example
20616 # 401 or 503, in which case the load balancer
20617 # applies the policy if the error code exactly matches this value.
20618 # - 5xx: Load Balancer will apply the policy if the
20619 # backend service responds with any response code in the range of
20620 # 500 to 599.
20621 # - 4xx: Load
20622 # Balancer will apply the policy if the backend service responds with any
20623 # response code in the range of 400 to
20624 # 499.
20625 #
20626 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
20627 &quot;A String&quot;,
20628 ],
20629 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
20630 # error content. If overrideResponseCode is not supplied, the
20631 # same response code returned by the original backend bucket or backend
20632 # service is returned to the client.
20633 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
20634 #
20635 # path must start
20636 # with a leading slash. path cannot have trailing slashes.
20637 #
20638 # If the file is not available in backendBucket or the
20639 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
20640 #
20641 # The value must
20642 # be from 1 to 1024 characters
20643 },
20644 ],
20645 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
20646 # contains the custom error content. Examples are:
20647 #
20648 #
20649 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
20650 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
20651 # - global/backendBuckets/myBackendBucket
20652 #
20653 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
20654 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
20655 #
20656 # If load balancer cannot reach
20657 # the backendBucket, a simple Not Found Error will
20658 # be returned, with the original response code (oroverrideResponseCode if configured).
20659 #
20660 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
20661 },
20662 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
20663 # hostRules match. The load balancer performs advanced routing
20664 # actions, such as URL rewrites and header transformations, before forwarding
20665 # the request to the selected backend.
20666 #
20667 #
20668 # Only one of defaultUrlRedirect, defaultService
20669 # or defaultRouteAction.weightedBackendService can be set.
20670 #
20671 #
20672 # URL maps for classic Application Load Balancers only support
20673 # the urlRewrite action within defaultRouteAction.
20674 #
20675 #
20676 # defaultRouteAction has no effect when the URL map is bound
20677 # to a target gRPC proxy that has the validateForProxyless field
20678 # set to true.
20679 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
20680 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
20681 # property must be specified. This policy cannot be specified if any target
20682 # backend has Identity-Aware Proxy enabled.
20683 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
20684 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
20685 # header names can be specified. The cache is bypassed for all `cacheMode`
20686 # values.
20687 &quot;A String&quot;,
20688 ],
20689 &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
20690 # on the backend type: for Backend Services, the complete request URI is
20691 # used; for Backend Buckets, the request URI is used without the protocol or
20692 # host, and only query parameters known to Cloud Storage are included.
20693 # Policy defined on Route Action.
20694 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
20695 # parameters will be included. Either specify `excludedQueryParameters`
20696 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
20697 # encoded and not treated as delimiters.
20698 #
20699 # Note: This field applies to routes that use backend services. Attempting
20700 # to set it on a route that points exclusively to Backend Buckets will
20701 # result in a configuration error. For routes that point to a Backend
20702 # Bucket, use `includedQueryParameters` to define which parameters should
20703 # be part of the cache key.
20704 &quot;A String&quot;,
20705 ],
20706 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
20707 #
20708 # Note: This setting is only applicable to routes that use a Backend
20709 # Service. It does not affect requests served by a Backend Bucket, as the
20710 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
20711 # it on a route that points exclusively to Backend Buckets will result in a
20712 # configuration error.
20713 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
20714 #
20715 # Note: This setting is only applicable to routes that use a Backend
20716 # Service. It does not affect requests served by a Backend Bucket, as the
20717 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
20718 # set on a route that points exclusively to Backend Buckets will result in
20719 # a configuration error.
20720 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
20721 # `includedQueryParameters` and `excludedQueryParameters`. If neither
20722 # is set, the entire query string will be included. If false, the query
20723 # string will be excluded from the cache key entirely.
20724 #
20725 # Note: This field applies to routes that use backend services. Attempting
20726 # to set it on a route that points exclusively to Backend Buckets will
20727 # result in a configuration error. For routes that point to a Backend
20728 # Bucket, use `includedQueryParameters` to define which parameters should
20729 # be part of the cache key.
20730 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
20731 # The name=value pair will be used in the cache key Cloud CDN generates.
20732 #
20733 # Note: This setting is only applicable to routes that use a Backend
20734 # Service. It does not affect requests served by a Backend Bucket.
20735 # Attempting to set it on a route that points exclusively to Backend
20736 # Buckets will result in a configuration error. Up to 5 cookie names can be
20737 # specified.
20738 &quot;A String&quot;,
20739 ],
20740 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
20741 &quot;A String&quot;,
20742 ],
20743 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
20744 # parameters will be excluded. Either specify `includedQueryParameters`
20745 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
20746 # encoded and not treated as delimiters.
20747 &quot;A String&quot;,
20748 ],
20749 },
20750 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
20751 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
20752 &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
20753 # content. This is used to clamp the max-age (or Expires) value sent to the
20754 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
20755 # is used for the response max-age directive, along with a &quot;public&quot;
20756 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
20757 # clamps the max-age from the origin (if specified), or else sets the
20758 # response max-age directive to the lesser of the `clientTtl` and
20759 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
20760 # present. The maximum allowed value is 31,622,400s (1 year). If not
20761 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
20762 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
20763 # `USE_ORIGIN_HEADERS`.
20764 # as a count of seconds and fractions of seconds at nanosecond
20765 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
20766 # or &quot;month&quot;. Range is approximately 10,000 years.
20767 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
20768 # Durations less than one second are represented with a 0
20769 # `seconds` field and a positive `nanos` field. Must be from 0
20770 # to 999,999,999 inclusive.
20771 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
20772 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
20773 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
20774 },
20775 &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
20776 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
20777 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
20778 # greater than that of `maxTtl`. When the `cacheMode` is set to
20779 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
20780 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
20781 # accessed objects may be evicted from the cache before the defined TTL. If
20782 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
20783 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
20784 # `USE_ORIGIN_HEADERS`.
20785 # as a count of seconds and fractions of seconds at nanosecond
20786 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
20787 # or &quot;month&quot;. Range is approximately 10,000 years.
20788 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
20789 # Durations less than one second are represented with a 0
20790 # `seconds` field and a positive `nanos` field. Must be from 0
20791 # to 999,999,999 inclusive.
20792 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
20793 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
20794 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
20795 },
20796 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
20797 # attempt to set a max-age or s-maxage higher than this, or an Expires header
20798 # more than `maxTtl` seconds in the future will be capped at the value of
20799 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
20800 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
20801 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
20802 # Infrequently accessed objects may be evicted from the cache before the
20803 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
20804 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
20805 # mode.
20806 # as a count of seconds and fractions of seconds at nanosecond
20807 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
20808 # or &quot;month&quot;. Range is approximately 10,000 years.
20809 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
20810 # Durations less than one second are represented with a 0
20811 # `seconds` field and a positive `nanos` field. Must be from 0
20812 # to 999,999,999 inclusive.
20813 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
20814 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
20815 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
20816 },
20817 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
20818 # to apply fine-grained caching for common errors or redirects.
20819 # This can reduce the load on your origin and improve end-user
20820 # experience by reducing response latency.
20821 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
20822 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
20823 # the specified response code that lack any Cache-Control, Expires, or
20824 # Pragma: no-cache directives. When the `cacheMode` is set to
20825 # `FORCE_CACHE_ALL`, negative caching applies to all responses
20826 # with the specified response code, and overrides any caching headers. By
20827 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
20828 #
20829 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
20830 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
20831 # * 405 (Method Not Found), 501 (Not Implemented): 60s
20832 #
20833 # These defaults can be overridden in `negativeCachingPolicy`.
20834 # If not specified, Cloud CDN applies negative caching by default.
20835 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
20836 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
20837 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
20838 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
20839 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
20840 # all response codes that you wish to cache. Cloud CDN will not apply any
20841 # default negative caching when a policy exists.
20842 { # Specify CDN TTLs for response error codes.
20843 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
20844 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
20845 # specified as values, and you cannot specify a status code more than
20846 # once.
20847 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
20848 # corresponding status code.
20849 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
20850 # objects may be evicted from the cache before the defined TTL.
20851 # as a count of seconds and fractions of seconds at nanosecond
20852 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
20853 # or &quot;month&quot;. Range is approximately 10,000 years.
20854 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
20855 # Durations less than one second are represented with a 0
20856 # `seconds` field and a positive `nanos` field. Must be from 0
20857 # to 999,999,999 inclusive.
20858 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
20859 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
20860 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
20861 },
20862 },
20863 ],
20864 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
20865 # requests into a small number of requests to the origin. If not specified,
20866 # Cloud CDN applies request coalescing by default.
20867 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
20868 # content with the origin, or when an error is encountered when refreshing
20869 # the cache.
20870 # This setting defines the default &quot;max-stale&quot; duration for any cached
20871 # responses that do not specify a max-stale directive. Stale responses that
20872 # exceed the TTL configured here will not be served. The default limit
20873 # (max-stale) is 86400s (1 day), which will allow stale content to be
20874 # served up to this limit beyond the max-age (or s-maxage) of a cached
20875 # response.
20876 # The maximum allowed value is 604800 (1 week).
20877 # Set this to zero (0) to disable serve-while-stale.
20878 # as a count of seconds and fractions of seconds at nanosecond
20879 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
20880 # or &quot;month&quot;. Range is approximately 10,000 years.
20881 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
20882 # Durations less than one second are represented with a 0
20883 # `seconds` field and a positive `nanos` field. Must be from 0
20884 # to 999,999,999 inclusive.
20885 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
20886 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
20887 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
20888 },
20889 },
20890 &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
20891 # information about the W3C recommendation for cross-origin resource sharing
20892 # (CORS), see Fetch API Living
20893 # Standard.
20894 #
20895 # Not supported when the URL map is bound to a target gRPC proxy.
20896 # information about the W3C recommendation for cross-origin resource sharing
20897 # (CORS), see Fetch API Living
20898 # Standard.
20899 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
20900 # indicates that
20901 # the actual request can include user credentials. This field translates to
20902 # the Access-Control-Allow-Credentials header.
20903 #
20904 # Default is false.
20905 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
20906 # header.
20907 &quot;A String&quot;,
20908 ],
20909 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
20910 # header.
20911 &quot;A String&quot;,
20912 ],
20913 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
20914 # more information, see regular expression syntax.
20915 #
20916 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
20917 #
20918 # Regular expressions can only be used when the loadBalancingScheme is
20919 # set to INTERNAL_SELF_MANAGED.
20920 &quot;A String&quot;,
20921 ],
20922 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
20923 #
20924 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
20925 &quot;A String&quot;,
20926 ],
20927 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
20928 # The default value is false, which indicates that the CORS
20929 # policy is in effect.
20930 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
20931 # header.
20932 &quot;A String&quot;,
20933 ],
20934 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
20935 # seconds. This field translates to the Access-Control-Max-Age
20936 # header.
20937 },
20938 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
20939 # the resiliency of clients to backend service failure. As part of fault
20940 # injection, when clients send requests to a backend service, delays can be
20941 # introduced by a load balancer on a percentage of requests before sending
20942 # those requests to the backend service. Similarly requests from clients can
20943 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
20944 # that are configured with a fault_injection_policy if:
20945 # 1. The traffic is generated by fault injection AND
20946 # 2. The fault injection is not a delay fault injection.
20947 # Fault injection is not supported with the classic Application Load Balancer
20948 # . To see which load balancers support fault injection,
20949 # see Load
20950 # balancing: Routing and traffic management features.
20951 # the resiliency of clients to backend service failure. As part of fault
20952 # injection, when clients send requests to a backend service, delays can be
20953 # introduced by the load balancer on a percentage of requests before sending
20954 # those request to the backend service. Similarly requests from clients can be
20955 # aborted by the load balancer for a percentage of requests.
20956 &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
20957 # injection.
20958 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
20959 #
20960 # The value must be from 200 to 599 inclusive.
20961 #
20962 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
20963 # according to this
20964 # mapping table. HTTP status 200 is mapped to gRPC status
20965 # UNKNOWN. Injecting an OK status is currently not supported by
20966 # Traffic Director.
20967 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
20968 # that is aborted as part of fault injection.
20969 #
20970 # The value must be from 0.0 to 100.0 inclusive.
20971 },
20972 &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
20973 # injection, before being sent to a backend service.
20974 # request to the backend service as part of fault injection.
20975 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
20976 # as a count of seconds and fractions of seconds at nanosecond
20977 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
20978 # or &quot;month&quot;. Range is approximately 10,000 years.
20979 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
20980 # Durations less than one second are represented with a 0
20981 # `seconds` field and a positive `nanos` field. Must be from 0
20982 # to 999,999,999 inclusive.
20983 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
20984 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
20985 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
20986 },
20987 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
20988 # which a delay is introduced as part of fault injection.
20989 #
20990 # The value must be from 0.0 to 100.0 inclusive.
20991 },
20992 },
20993 &quot;imageOptimizationPolicy&quot;: { # The configuration for Cloud CDN&#x27;s image optimization feature. This feature # Image optimization policy for this URL Map&#x27;s route. Available only for
20994 # Global EXTERNAL_MANAGED load balancer schemes.
20995 # Either Cloud CDN must be enabled on the backend service or backend bucket
20996 # serving the route, or cache policy must be configured on the same route
20997 # dynamically processes and delivers images from the network edge.
20998 # Image Optimization is only available for Global External Application Load
20999 # Balancers.
21000 # Either Cloud CDN must be enabled on the backend service or backend bucket
21001 # serving the route, or cache policy must be configured on the same route.
21002 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
21003 },
21004 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
21005 # Unlike the timeout field where the timeout duration starts
21006 # from the time the request has been fully processed (known as*end-of-stream*),
21007 # the duration in this field is computed from the beginning of the stream
21008 # until the response has been processed, including all retries. A
21009 # stream that does not complete in this duration is closed.
21010 #
21011 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
21012 # with the route.
21013 #
21014 # This field is only allowed if the Url map is used with backend services
21015 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
21016 # as a count of seconds and fractions of seconds at nanosecond
21017 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21018 # or &quot;month&quot;. Range is approximately 10,000 years.
21019 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21020 # Durations less than one second are represented with a 0
21021 # `seconds` field and a positive `nanos` field. Must be from 0
21022 # to 999,999,999 inclusive.
21023 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21024 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21025 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21026 },
21027 &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
21028 # are shadowed to a separate mirrored backend service. The load balancer does
21029 # not wait for responses from the shadow service. Before sending traffic
21030 # to the shadow service, the host / authority header is suffixed with-shadow.
21031 #
21032 # Not supported when the URL map is bound to a target gRPC proxy that
21033 # has the validateForProxyless field set to true.
21034 # are shadowed to a separate mirrored backend service. The load balancer
21035 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
21036 # to the shadow service, the host or authority header is suffixed with-shadow.
21037 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
21038 # mirrored to.
21039 #
21040 # The backend service configured for a mirroring
21041 # policy must reference backends that are of the same type as the original
21042 # backend service matched in the URL map.
21043 #
21044 # Serverless NEG backends are not currently supported as a mirrored
21045 # backend service.
21046 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
21047 },
21048 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
21049 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
21050 # If not specified, defaults to 1.
21051 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
21052 #
21053 # If not specified, will use the timeout set in theHttpRouteAction field.
21054 # If timeout in the HttpRouteAction field is not set, this field
21055 # uses the largest timeout
21056 # among all backend services associated with the route.
21057 #
21058 # Not supported when the URL map is bound to a target gRPC proxy that
21059 # has the validateForProxyless field set to true.
21060 # as a count of seconds and fractions of seconds at nanosecond
21061 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21062 # or &quot;month&quot;. Range is approximately 10,000 years.
21063 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21064 # Durations less than one second are represented with a 0
21065 # `seconds` field and a positive `nanos` field. Must be from 0
21066 # to 999,999,999 inclusive.
21067 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21068 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21069 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21070 },
21071 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
21072 # values are:
21073 #
21074 # - 5xx: retry is attempted if the instance or endpoint
21075 # responds with any 5xx response code, or if the instance or
21076 # endpoint does not respond at all. For example, disconnects, reset, read
21077 # timeout, connection failure, and refused streams.
21078 # - gateway-error: Similar to 5xx, but only
21079 # applies to response codes 502, 503 or504.
21080 # - connect-failure: a retry is attempted on failures
21081 # connecting to the instance or endpoint. For example, connection
21082 # timeouts.
21083 # - retriable-4xx: a retry is attempted if the instance
21084 # or endpoint responds with a 4xx response code.
21085 # The only error that you can retry is error code 409.
21086 # - refused-stream: a retry is attempted if the instance
21087 # or endpoint resets the stream with a REFUSED_STREAM error
21088 # code. This reset type indicates that it is safe to retry.
21089 # - cancelled: a retry is attempted if the gRPC status
21090 # code in the response header is set to cancelled.
21091 # - deadline-exceeded: a retry is attempted if the gRPC
21092 # status code in the response header is set todeadline-exceeded.
21093 # - internal: a retry is attempted if the gRPC
21094 # status code in the response header is set tointernal.
21095 # - resource-exhausted: a retry is attempted if the gRPC
21096 # status code in the response header is set toresource-exhausted.
21097 # - unavailable: a retry is attempted if the gRPC
21098 # status code in the response header is set tounavailable.
21099 #
21100 # Only the following codes are supported when the URL map is bound to
21101 # target gRPC proxy that has validateForProxyless field set to true.
21102 #
21103 # - cancelled
21104 # - deadline-exceeded
21105 # - internal
21106 # - resource-exhausted
21107 # - unavailable
21108 &quot;A String&quot;,
21109 ],
21110 },
21111 &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
21112 # time the request has been fully processed (known as *end-of-stream*)
21113 # up until the response has been processed. Timeout includes
21114 # all retries.
21115 #
21116 # If not specified, this field uses the largest timeout among all backend
21117 # services associated with the route.
21118 #
21119 # Not supported when the URL map is bound to a target gRPC proxy that
21120 # has validateForProxyless field set to true.
21121 # as a count of seconds and fractions of seconds at nanosecond
21122 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21123 # or &quot;month&quot;. Range is approximately 10,000 years.
21124 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21125 # Durations less than one second are represented with a 0
21126 # `seconds` field and a positive `nanos` field. Must be from 0
21127 # to 999,999,999 inclusive.
21128 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21129 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21130 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21131 },
21132 &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
21133 # to the matched service.
21134 #
21135 # urlRewrite is the only action supported in UrlMaps
21136 # for classic Application Load Balancers.
21137 #
21138 # Not supported when the URL map is bound to a target gRPC proxy that
21139 # has the validateForProxyless field set to true.
21140 # backend service.
21141 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
21142 # host header is replaced with contents of hostRewrite.
21143 #
21144 # The value must be from 1 to 255 characters.
21145 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
21146 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
21147 #
21148 # The value must be from 1 to 1024 characters.
21149 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
21150 # header) using the HTTP template syntax.
21151 #
21152 # A corresponding
21153 # path_template_match must be specified. Any template variables must exist in
21154 # the path_template_match field.
21155 #
21156 #
21157 # - -At least one variable must be specified in the path_template_match
21158 # field
21159 # - You can omit variables from the rewritten URL
21160 # - The * and ** operators cannot be matched
21161 # unless they have a corresponding variable name - e.g.
21162 # {format=*} or {var=**}.
21163 #
21164 # For example, a path_template_match of /static/{format=**}
21165 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
21166 # rewrite, so that /{country}/{format}/{suffix=**} can be
21167 # rewritten as /content/{format}/{country}/{suffix}.
21168 #
21169 # At least
21170 # one non-empty routeRules[].matchRules[].path_template_match is
21171 # required.
21172 #
21173 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
21174 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
21175 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
21176 # It uses RE2 syntax with the following constraints:
21177 #
21178 #
21179 # - Any single character operators
21180 # - Groups are allowed to have only submatch operator inside
21181 # - Groups are allowed only without any char repetition, e.g.
21182 # .*
21183 # - Any char repetition, e.g. .*, is
21184 # only allowed to be used in a single regex together with:
21185 #
21186 #
21187 # - Empty string operators
21188 # - Other repetitions
21189 # - Ranges
21190 # - Repetitions of ranges
21191 #
21192 #
21193 # - Ranges are only allowed to have:
21194 #
21195 #
21196 # - Character range
21197 # - Digits range
21198 # - Symbols listed in characters allowed for ranges
21199 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
21200 # the path.
21201 },
21202 },
21203 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
21204 # occurs. The weights determine the fraction of traffic that flows to
21205 # their corresponding backend service. If all traffic needs to
21206 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
21207 #
21208 # After a backend service is identified and before forwarding
21209 # the request to
21210 # the backend service, advanced routing actions such as URL rewrites and
21211 # header transformations are applied depending on additional settings
21212 # specified in this HttpRouteAction.
21213 { # In contrast to a single BackendService in
21214 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
21215 # multiple backend services. The volume of traffic for each
21216 # backend service is proportional to the weight specified
21217 # in each WeightedBackendService
21218 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
21219 # resource. Before
21220 # forwarding the request to backendService, the load balancer
21221 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
21222 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
21223 # effect for the selected backendService.
21224 #
21225 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
21226 #
21227 # headerAction is not supported for load balancers that have
21228 # their loadBalancingScheme set to EXTERNAL.
21229 #
21230 # Not supported when the URL map is bound to a target gRPC proxy that
21231 # has validateForProxyless field set to true.
21232 # the request is passed along to the selected backendService.
21233 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
21234 { # Specification determining how headers are added to requests or responses.
21235 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
21236 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
21237 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
21238 # that already
21239 # exist for the header. If true, headerValue is set for the
21240 # header, discarding any values that were set for that header.
21241 #
21242 # The default value is true,
21243 # unless a variable is present in headerValue,
21244 # in which case the default value is false.
21245 # .
21246 },
21247 ],
21248 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
21249 # request before forwarding the request to the backendService.
21250 &quot;A String&quot;,
21251 ],
21252 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
21253 # client.
21254 { # Specification determining how headers are added to requests or responses.
21255 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
21256 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
21257 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
21258 # that already
21259 # exist for the header. If true, headerValue is set for the
21260 # header, discarding any values that were set for that header.
21261 #
21262 # The default value is true,
21263 # unless a variable is present in headerValue,
21264 # in which case the default value is false.
21265 # .
21266 },
21267 ],
21268 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
21269 # response before sending the response back to the client.
21270 &quot;A String&quot;,
21271 ],
21272 },
21273 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
21274 # computed asweight / (sum of all weightedBackendService weights in routeAction).
21275 #
21276 # The selection of a backend service is determined only for new traffic.
21277 # Once a user&#x27;s request has been directed to a backend service,
21278 # subsequent requests are sent to the same backend service as
21279 # determined by the backend service&#x27;s session affinity policy.
21280 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
21281 # splitting. If you do, the weighted traffic splitting configuration takes
21282 # precedence.
21283 #
21284 # The value must be from 0 to 1000.
21285 },
21286 ],
21287 },
21288 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL of the defaultService resource to
21289 # which traffic is directed if none of the hostRules match.
21290 # If defaultRouteAction is also specified, advanced
21291 # routing actions, such as URL rewrites, take effect before sending the
21292 # request to the backend.
21293 #
21294 #
21295 # Only one of defaultUrlRedirect, defaultService
21296 # or defaultRouteAction.weightedBackendService can be set.
21297 #
21298 #
21299 # defaultService has no effect when the URL map is bound
21300 # to a target gRPC proxy that has the validateForProxyless field
21301 # set to true.
21302 &quot;defaultUrlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
21303 # is redirected to a URL specified by defaultUrlRedirect.
21304 #
21305 #
21306 # Only one of defaultUrlRedirect, defaultService
21307 # or defaultRouteAction.weightedBackendService can be set.
21308 #
21309 #
21310 # Not supported when the URL map is bound to a target gRPC proxy.
21311 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
21312 # was supplied in the request.
21313 #
21314 # The value must be from 1 to 255
21315 # characters.
21316 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
21317 # set to HTTPS.
21318 # If set to false, the URL scheme of the redirected request
21319 # remains the same as that of the request.
21320 #
21321 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
21322 #
21323 # The default is set to false.
21324 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
21325 # that was supplied in the request.
21326 #
21327 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
21328 # supplied, the path of the original request is used for the redirect.
21329 #
21330 # The value must be from 1 to 1024 characters.
21331 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
21332 # the HttpRouteRuleMatch, retaining the remaining portion
21333 # of the URL before redirecting the request.
21334 #
21335 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
21336 # supplied, the path of the original request is used for the redirect.
21337 #
21338 # The value must be from 1 to 1024 characters.
21339 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
21340 #
21341 # Supported values are:
21342 #
21343 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
21344 # to 301.
21345 # - FOUND, which corresponds to 302.
21346 # - SEE_OTHER which corresponds to 303.
21347 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
21348 # method is retained.
21349 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
21350 # method is retained.
21351 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
21352 # URL is
21353 # removed before redirecting the request. If set to false, the
21354 # query portion of the original URL is retained.
21355 #
21356 # The default is set to false.
21357 },
21358 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
21359 # create the resource.
21360 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. A hash of the contents stored in this object.
21361 # This field is used in optimistic locking. This field is ignored when
21362 # inserting a UrlMap. An up-to-date fingerprint must be provided
21363 # in order to update the UrlMap, otherwise the request will
21364 # fail with error 412 conditionNotMet.
21365 #
21366 # To see the latest fingerprint, make a get() request to
21367 # retrieve a UrlMap.
21368 &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
21369 # for the selected backendService.
21370 #
21371 # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
21372 #
21373 # headerAction is not supported for load balancers
21374 # that have
21375 # their loadBalancingScheme set to EXTERNAL.
21376 #
21377 # Not supported when the URL map is bound to a target gRPC proxy that
21378 # has validateForProxyless field set to true.
21379 # the request is passed along to the selected backendService.
21380 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
21381 { # Specification determining how headers are added to requests or responses.
21382 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
21383 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
21384 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
21385 # that already
21386 # exist for the header. If true, headerValue is set for the
21387 # header, discarding any values that were set for that header.
21388 #
21389 # The default value is true,
21390 # unless a variable is present in headerValue,
21391 # in which case the default value is false.
21392 # .
21393 },
21394 ],
21395 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
21396 # request before forwarding the request to the backendService.
21397 &quot;A String&quot;,
21398 ],
21399 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
21400 # client.
21401 { # Specification determining how headers are added to requests or responses.
21402 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
21403 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
21404 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
21405 # that already
21406 # exist for the header. If true, headerValue is set for the
21407 # header, discarding any values that were set for that header.
21408 #
21409 # The default value is true,
21410 # unless a variable is present in headerValue,
21411 # in which case the default value is false.
21412 # .
21413 },
21414 ],
21415 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
21416 # response before sending the response back to the client.
21417 &quot;A String&quot;,
21418 ],
21419 },
21420 &quot;hostRules&quot;: [ # The list of host rules to use against the URL.
21421 { # UrlMaps
21422 # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
21423 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
21424 # create the resource.
21425 &quot;hosts&quot;: [ # The list of host patterns to match. They must be valid hostnames with
21426 # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
21427 # that case, * must be the first character, and if followed by
21428 # anything, the immediate following character must be either -
21429 # or ..
21430 #
21431 # * based matching is not supported when the URL map is bound
21432 # to a target gRPC proxy that has the validateForProxyless field
21433 # set to true.
21434 &quot;A String&quot;,
21435 ],
21436 &quot;pathMatcher&quot;: &quot;A String&quot;, # The name of the PathMatcher to use to match the path portion
21437 # of the URL if the hostRule matches the URL&#x27;s host portion.
21438 },
21439 ],
21440 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the resource. This identifier is
21441 # defined by the server.
21442 &quot;kind&quot;: &quot;compute#urlMap&quot;, # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
21443 # url maps.
21444 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
21445 # The name must be 1-63 characters long, and comply withRFC1035.
21446 # Specifically, the name must be 1-63 characters long and match the regular
21447 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
21448 # character must be a lowercase letter, and all following characters must
21449 # be a dash, lowercase letter, or digit, except the last character, which
21450 # cannot be a dash.
21451 &quot;pathMatchers&quot;: [ # The list of named PathMatchers to use against the URL.
21452 { # A matcher for the path portion of the URL. The BackendService
21453 # from the longest-matched rule will serve the URL. If no rule was matched, the
21454 # default service is used.
21455 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
21456 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
21457 #
21458 # This policy takes
21459 # effect at the PathMatcher level and applies only when no
21460 # 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
21461 # in defaultCustomErrorResponsePolicy, then a policy defined for
21462 # the error code in UrlMap.defaultCustomErrorResponsePolicy
21463 # takes effect.
21464 #
21465 # For example, consider a UrlMap with the following
21466 # configuration:
21467 #
21468 #
21469 # - UrlMap.defaultCustomErrorResponsePolicy is configured
21470 # with policies for 5xx and 4xx errors
21471 # - A RouteRule for /coming_soon/ is configured for the
21472 # error code 404.
21473 #
21474 # 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
21475 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
21476 # the policy in RouteRule.customErrorResponsePolicy takes
21477 # effect. If any of the requests in this example encounter a 500
21478 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
21479 #
21480 # When
21481 # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
21482 # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
21483 # a retry, if load balancer is successful in reaching the
21484 # service, the defaultCustomErrorResponsePolicy is ignored and
21485 # the response from the service is returned to the client.
21486 #
21487 # defaultCustomErrorResponsePolicy is supported only for
21488 # global external Application Load Balancers.
21489 # backend service or backend bucket responds with an error.
21490 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
21491 #
21492 # In a given policy, if you specify rules for both a range of error codes
21493 # as well as rules for specific error codes then rules with specific error
21494 # codes have a higher priority. For example, assume that you configure a rule
21495 # for 401 (Un-authorized) code, and another for all 4 series
21496 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
21497 # However if the backend service returns a 403, the rule for4xx takes effect.
21498 { # Specifies the mapping between the response code that will be returned along
21499 # with the custom error content and the response code returned by the backend
21500 # service.
21501 &quot;matchResponseCodes&quot;: [ # Valid values include:
21502 #
21503 #
21504 # - A number between 400 and 599: For example
21505 # 401 or 503, in which case the load balancer
21506 # applies the policy if the error code exactly matches this value.
21507 # - 5xx: Load Balancer will apply the policy if the
21508 # backend service responds with any response code in the range of
21509 # 500 to 599.
21510 # - 4xx: Load
21511 # Balancer will apply the policy if the backend service responds with any
21512 # response code in the range of 400 to
21513 # 499.
21514 #
21515 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
21516 &quot;A String&quot;,
21517 ],
21518 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
21519 # error content. If overrideResponseCode is not supplied, the
21520 # same response code returned by the original backend bucket or backend
21521 # service is returned to the client.
21522 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
21523 #
21524 # path must start
21525 # with a leading slash. path cannot have trailing slashes.
21526 #
21527 # If the file is not available in backendBucket or the
21528 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
21529 #
21530 # The value must
21531 # be from 1 to 1024 characters
21532 },
21533 ],
21534 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
21535 # contains the custom error content. Examples are:
21536 #
21537 #
21538 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
21539 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
21540 # - global/backendBuckets/myBackendBucket
21541 #
21542 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
21543 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
21544 #
21545 # If load balancer cannot reach
21546 # the backendBucket, a simple Not Found Error will
21547 # be returned, with the original response code (oroverrideResponseCode if configured).
21548 #
21549 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
21550 },
21551 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
21552 # pathRules or routeRules match. The load balancer
21553 # performs advanced routing actions, such as URL rewrites and
21554 # header transformations, before forwarding the request to the
21555 # selected backend.
21556 #
21557 #
21558 # Only one of defaultUrlRedirect, defaultService
21559 # or defaultRouteAction.weightedBackendService can be set.
21560 #
21561 #
21562 # URL maps for classic Application Load Balancers only support
21563 # the urlRewrite action within a path matcher&#x27;sdefaultRouteAction.
21564 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
21565 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
21566 # property must be specified. This policy cannot be specified if any target
21567 # backend has Identity-Aware Proxy enabled.
21568 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
21569 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
21570 # header names can be specified. The cache is bypassed for all `cacheMode`
21571 # values.
21572 &quot;A String&quot;,
21573 ],
21574 &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
21575 # on the backend type: for Backend Services, the complete request URI is
21576 # used; for Backend Buckets, the request URI is used without the protocol or
21577 # host, and only query parameters known to Cloud Storage are included.
21578 # Policy defined on Route Action.
21579 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
21580 # parameters will be included. Either specify `excludedQueryParameters`
21581 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
21582 # encoded and not treated as delimiters.
21583 #
21584 # Note: This field applies to routes that use backend services. Attempting
21585 # to set it on a route that points exclusively to Backend Buckets will
21586 # result in a configuration error. For routes that point to a Backend
21587 # Bucket, use `includedQueryParameters` to define which parameters should
21588 # be part of the cache key.
21589 &quot;A String&quot;,
21590 ],
21591 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
21592 #
21593 # Note: This setting is only applicable to routes that use a Backend
21594 # Service. It does not affect requests served by a Backend Bucket, as the
21595 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
21596 # it on a route that points exclusively to Backend Buckets will result in a
21597 # configuration error.
21598 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
21599 #
21600 # Note: This setting is only applicable to routes that use a Backend
21601 # Service. It does not affect requests served by a Backend Bucket, as the
21602 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
21603 # set on a route that points exclusively to Backend Buckets will result in
21604 # a configuration error.
21605 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
21606 # `includedQueryParameters` and `excludedQueryParameters`. If neither
21607 # is set, the entire query string will be included. If false, the query
21608 # string will be excluded from the cache key entirely.
21609 #
21610 # Note: This field applies to routes that use backend services. Attempting
21611 # to set it on a route that points exclusively to Backend Buckets will
21612 # result in a configuration error. For routes that point to a Backend
21613 # Bucket, use `includedQueryParameters` to define which parameters should
21614 # be part of the cache key.
21615 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
21616 # The name=value pair will be used in the cache key Cloud CDN generates.
21617 #
21618 # Note: This setting is only applicable to routes that use a Backend
21619 # Service. It does not affect requests served by a Backend Bucket.
21620 # Attempting to set it on a route that points exclusively to Backend
21621 # Buckets will result in a configuration error. Up to 5 cookie names can be
21622 # specified.
21623 &quot;A String&quot;,
21624 ],
21625 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
21626 &quot;A String&quot;,
21627 ],
21628 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
21629 # parameters will be excluded. Either specify `includedQueryParameters`
21630 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
21631 # encoded and not treated as delimiters.
21632 &quot;A String&quot;,
21633 ],
21634 },
21635 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
21636 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
21637 &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
21638 # content. This is used to clamp the max-age (or Expires) value sent to the
21639 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
21640 # is used for the response max-age directive, along with a &quot;public&quot;
21641 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
21642 # clamps the max-age from the origin (if specified), or else sets the
21643 # response max-age directive to the lesser of the `clientTtl` and
21644 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
21645 # present. The maximum allowed value is 31,622,400s (1 year). If not
21646 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
21647 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
21648 # `USE_ORIGIN_HEADERS`.
21649 # as a count of seconds and fractions of seconds at nanosecond
21650 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21651 # or &quot;month&quot;. Range is approximately 10,000 years.
21652 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21653 # Durations less than one second are represented with a 0
21654 # `seconds` field and a positive `nanos` field. Must be from 0
21655 # to 999,999,999 inclusive.
21656 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21657 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21658 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21659 },
21660 &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
21661 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
21662 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
21663 # greater than that of `maxTtl`. When the `cacheMode` is set to
21664 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
21665 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
21666 # accessed objects may be evicted from the cache before the defined TTL. If
21667 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
21668 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
21669 # `USE_ORIGIN_HEADERS`.
21670 # as a count of seconds and fractions of seconds at nanosecond
21671 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21672 # or &quot;month&quot;. Range is approximately 10,000 years.
21673 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21674 # Durations less than one second are represented with a 0
21675 # `seconds` field and a positive `nanos` field. Must be from 0
21676 # to 999,999,999 inclusive.
21677 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21678 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21679 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21680 },
21681 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
21682 # attempt to set a max-age or s-maxage higher than this, or an Expires header
21683 # more than `maxTtl` seconds in the future will be capped at the value of
21684 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
21685 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
21686 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
21687 # Infrequently accessed objects may be evicted from the cache before the
21688 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
21689 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
21690 # mode.
21691 # as a count of seconds and fractions of seconds at nanosecond
21692 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21693 # or &quot;month&quot;. Range is approximately 10,000 years.
21694 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21695 # Durations less than one second are represented with a 0
21696 # `seconds` field and a positive `nanos` field. Must be from 0
21697 # to 999,999,999 inclusive.
21698 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21699 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21700 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21701 },
21702 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
21703 # to apply fine-grained caching for common errors or redirects.
21704 # This can reduce the load on your origin and improve end-user
21705 # experience by reducing response latency.
21706 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
21707 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
21708 # the specified response code that lack any Cache-Control, Expires, or
21709 # Pragma: no-cache directives. When the `cacheMode` is set to
21710 # `FORCE_CACHE_ALL`, negative caching applies to all responses
21711 # with the specified response code, and overrides any caching headers. By
21712 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
21713 #
21714 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
21715 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
21716 # * 405 (Method Not Found), 501 (Not Implemented): 60s
21717 #
21718 # These defaults can be overridden in `negativeCachingPolicy`.
21719 # If not specified, Cloud CDN applies negative caching by default.
21720 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
21721 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
21722 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
21723 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
21724 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
21725 # all response codes that you wish to cache. Cloud CDN will not apply any
21726 # default negative caching when a policy exists.
21727 { # Specify CDN TTLs for response error codes.
21728 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
21729 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
21730 # specified as values, and you cannot specify a status code more than
21731 # once.
21732 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
21733 # corresponding status code.
21734 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
21735 # objects may be evicted from the cache before the defined TTL.
21736 # as a count of seconds and fractions of seconds at nanosecond
21737 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21738 # or &quot;month&quot;. Range is approximately 10,000 years.
21739 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21740 # Durations less than one second are represented with a 0
21741 # `seconds` field and a positive `nanos` field. Must be from 0
21742 # to 999,999,999 inclusive.
21743 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21744 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21745 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21746 },
21747 },
21748 ],
21749 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
21750 # requests into a small number of requests to the origin. If not specified,
21751 # Cloud CDN applies request coalescing by default.
21752 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
21753 # content with the origin, or when an error is encountered when refreshing
21754 # the cache.
21755 # This setting defines the default &quot;max-stale&quot; duration for any cached
21756 # responses that do not specify a max-stale directive. Stale responses that
21757 # exceed the TTL configured here will not be served. The default limit
21758 # (max-stale) is 86400s (1 day), which will allow stale content to be
21759 # served up to this limit beyond the max-age (or s-maxage) of a cached
21760 # response.
21761 # The maximum allowed value is 604800 (1 week).
21762 # Set this to zero (0) to disable serve-while-stale.
21763 # as a count of seconds and fractions of seconds at nanosecond
21764 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21765 # or &quot;month&quot;. Range is approximately 10,000 years.
21766 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21767 # Durations less than one second are represented with a 0
21768 # `seconds` field and a positive `nanos` field. Must be from 0
21769 # to 999,999,999 inclusive.
21770 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21771 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21772 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21773 },
21774 },
21775 &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
21776 # information about the W3C recommendation for cross-origin resource sharing
21777 # (CORS), see Fetch API Living
21778 # Standard.
21779 #
21780 # Not supported when the URL map is bound to a target gRPC proxy.
21781 # information about the W3C recommendation for cross-origin resource sharing
21782 # (CORS), see Fetch API Living
21783 # Standard.
21784 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
21785 # indicates that
21786 # the actual request can include user credentials. This field translates to
21787 # the Access-Control-Allow-Credentials header.
21788 #
21789 # Default is false.
21790 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
21791 # header.
21792 &quot;A String&quot;,
21793 ],
21794 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
21795 # header.
21796 &quot;A String&quot;,
21797 ],
21798 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
21799 # more information, see regular expression syntax.
21800 #
21801 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
21802 #
21803 # Regular expressions can only be used when the loadBalancingScheme is
21804 # set to INTERNAL_SELF_MANAGED.
21805 &quot;A String&quot;,
21806 ],
21807 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
21808 #
21809 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
21810 &quot;A String&quot;,
21811 ],
21812 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
21813 # The default value is false, which indicates that the CORS
21814 # policy is in effect.
21815 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
21816 # header.
21817 &quot;A String&quot;,
21818 ],
21819 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
21820 # seconds. This field translates to the Access-Control-Max-Age
21821 # header.
21822 },
21823 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
21824 # the resiliency of clients to backend service failure. As part of fault
21825 # injection, when clients send requests to a backend service, delays can be
21826 # introduced by a load balancer on a percentage of requests before sending
21827 # those requests to the backend service. Similarly requests from clients can
21828 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
21829 # that are configured with a fault_injection_policy if:
21830 # 1. The traffic is generated by fault injection AND
21831 # 2. The fault injection is not a delay fault injection.
21832 # Fault injection is not supported with the classic Application Load Balancer
21833 # . To see which load balancers support fault injection,
21834 # see Load
21835 # balancing: Routing and traffic management features.
21836 # the resiliency of clients to backend service failure. As part of fault
21837 # injection, when clients send requests to a backend service, delays can be
21838 # introduced by the load balancer on a percentage of requests before sending
21839 # those request to the backend service. Similarly requests from clients can be
21840 # aborted by the load balancer for a percentage of requests.
21841 &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
21842 # injection.
21843 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
21844 #
21845 # The value must be from 200 to 599 inclusive.
21846 #
21847 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
21848 # according to this
21849 # mapping table. HTTP status 200 is mapped to gRPC status
21850 # UNKNOWN. Injecting an OK status is currently not supported by
21851 # Traffic Director.
21852 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
21853 # that is aborted as part of fault injection.
21854 #
21855 # The value must be from 0.0 to 100.0 inclusive.
21856 },
21857 &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
21858 # injection, before being sent to a backend service.
21859 # request to the backend service as part of fault injection.
21860 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
21861 # as a count of seconds and fractions of seconds at nanosecond
21862 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21863 # or &quot;month&quot;. Range is approximately 10,000 years.
21864 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21865 # Durations less than one second are represented with a 0
21866 # `seconds` field and a positive `nanos` field. Must be from 0
21867 # to 999,999,999 inclusive.
21868 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21869 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21870 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21871 },
21872 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
21873 # which a delay is introduced as part of fault injection.
21874 #
21875 # The value must be from 0.0 to 100.0 inclusive.
21876 },
21877 },
21878 &quot;imageOptimizationPolicy&quot;: { # The configuration for Cloud CDN&#x27;s image optimization feature. This feature # Image optimization policy for this URL Map&#x27;s route. Available only for
21879 # Global EXTERNAL_MANAGED load balancer schemes.
21880 # Either Cloud CDN must be enabled on the backend service or backend bucket
21881 # serving the route, or cache policy must be configured on the same route
21882 # dynamically processes and delivers images from the network edge.
21883 # Image Optimization is only available for Global External Application Load
21884 # Balancers.
21885 # Either Cloud CDN must be enabled on the backend service or backend bucket
21886 # serving the route, or cache policy must be configured on the same route.
21887 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
21888 },
21889 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
21890 # Unlike the timeout field where the timeout duration starts
21891 # from the time the request has been fully processed (known as*end-of-stream*),
21892 # the duration in this field is computed from the beginning of the stream
21893 # until the response has been processed, including all retries. A
21894 # stream that does not complete in this duration is closed.
21895 #
21896 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
21897 # with the route.
21898 #
21899 # This field is only allowed if the Url map is used with backend services
21900 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
21901 # as a count of seconds and fractions of seconds at nanosecond
21902 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21903 # or &quot;month&quot;. Range is approximately 10,000 years.
21904 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21905 # Durations less than one second are represented with a 0
21906 # `seconds` field and a positive `nanos` field. Must be from 0
21907 # to 999,999,999 inclusive.
21908 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21909 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21910 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21911 },
21912 &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
21913 # are shadowed to a separate mirrored backend service. The load balancer does
21914 # not wait for responses from the shadow service. Before sending traffic
21915 # to the shadow service, the host / authority header is suffixed with-shadow.
21916 #
21917 # Not supported when the URL map is bound to a target gRPC proxy that
21918 # has the validateForProxyless field set to true.
21919 # are shadowed to a separate mirrored backend service. The load balancer
21920 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
21921 # to the shadow service, the host or authority header is suffixed with-shadow.
21922 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
21923 # mirrored to.
21924 #
21925 # The backend service configured for a mirroring
21926 # policy must reference backends that are of the same type as the original
21927 # backend service matched in the URL map.
21928 #
21929 # Serverless NEG backends are not currently supported as a mirrored
21930 # backend service.
21931 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
21932 },
21933 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
21934 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
21935 # If not specified, defaults to 1.
21936 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
21937 #
21938 # If not specified, will use the timeout set in theHttpRouteAction field.
21939 # If timeout in the HttpRouteAction field is not set, this field
21940 # uses the largest timeout
21941 # among all backend services associated with the route.
21942 #
21943 # Not supported when the URL map is bound to a target gRPC proxy that
21944 # has the validateForProxyless field set to true.
21945 # as a count of seconds and fractions of seconds at nanosecond
21946 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21947 # or &quot;month&quot;. Range is approximately 10,000 years.
21948 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21949 # Durations less than one second are represented with a 0
21950 # `seconds` field and a positive `nanos` field. Must be from 0
21951 # to 999,999,999 inclusive.
21952 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21953 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21954 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21955 },
21956 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
21957 # values are:
21958 #
21959 # - 5xx: retry is attempted if the instance or endpoint
21960 # responds with any 5xx response code, or if the instance or
21961 # endpoint does not respond at all. For example, disconnects, reset, read
21962 # timeout, connection failure, and refused streams.
21963 # - gateway-error: Similar to 5xx, but only
21964 # applies to response codes 502, 503 or504.
21965 # - connect-failure: a retry is attempted on failures
21966 # connecting to the instance or endpoint. For example, connection
21967 # timeouts.
21968 # - retriable-4xx: a retry is attempted if the instance
21969 # or endpoint responds with a 4xx response code.
21970 # The only error that you can retry is error code 409.
21971 # - refused-stream: a retry is attempted if the instance
21972 # or endpoint resets the stream with a REFUSED_STREAM error
21973 # code. This reset type indicates that it is safe to retry.
21974 # - cancelled: a retry is attempted if the gRPC status
21975 # code in the response header is set to cancelled.
21976 # - deadline-exceeded: a retry is attempted if the gRPC
21977 # status code in the response header is set todeadline-exceeded.
21978 # - internal: a retry is attempted if the gRPC
21979 # status code in the response header is set tointernal.
21980 # - resource-exhausted: a retry is attempted if the gRPC
21981 # status code in the response header is set toresource-exhausted.
21982 # - unavailable: a retry is attempted if the gRPC
21983 # status code in the response header is set tounavailable.
21984 #
21985 # Only the following codes are supported when the URL map is bound to
21986 # target gRPC proxy that has validateForProxyless field set to true.
21987 #
21988 # - cancelled
21989 # - deadline-exceeded
21990 # - internal
21991 # - resource-exhausted
21992 # - unavailable
21993 &quot;A String&quot;,
21994 ],
21995 },
21996 &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
21997 # time the request has been fully processed (known as *end-of-stream*)
21998 # up until the response has been processed. Timeout includes
21999 # all retries.
22000 #
22001 # If not specified, this field uses the largest timeout among all backend
22002 # services associated with the route.
22003 #
22004 # Not supported when the URL map is bound to a target gRPC proxy that
22005 # has validateForProxyless field set to true.
22006 # as a count of seconds and fractions of seconds at nanosecond
22007 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
22008 # or &quot;month&quot;. Range is approximately 10,000 years.
22009 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
22010 # Durations less than one second are represented with a 0
22011 # `seconds` field and a positive `nanos` field. Must be from 0
22012 # to 999,999,999 inclusive.
22013 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22014 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22015 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22016 },
22017 &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
22018 # to the matched service.
22019 #
22020 # urlRewrite is the only action supported in UrlMaps
22021 # for classic Application Load Balancers.
22022 #
22023 # Not supported when the URL map is bound to a target gRPC proxy that
22024 # has the validateForProxyless field set to true.
22025 # backend service.
22026 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
22027 # host header is replaced with contents of hostRewrite.
22028 #
22029 # The value must be from 1 to 255 characters.
22030 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
22031 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
22032 #
22033 # The value must be from 1 to 1024 characters.
22034 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
22035 # header) using the HTTP template syntax.
22036 #
22037 # A corresponding
22038 # path_template_match must be specified. Any template variables must exist in
22039 # the path_template_match field.
22040 #
22041 #
22042 # - -At least one variable must be specified in the path_template_match
22043 # field
22044 # - You can omit variables from the rewritten URL
22045 # - The * and ** operators cannot be matched
22046 # unless they have a corresponding variable name - e.g.
22047 # {format=*} or {var=**}.
22048 #
22049 # For example, a path_template_match of /static/{format=**}
22050 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
22051 # rewrite, so that /{country}/{format}/{suffix=**} can be
22052 # rewritten as /content/{format}/{country}/{suffix}.
22053 #
22054 # At least
22055 # one non-empty routeRules[].matchRules[].path_template_match is
22056 # required.
22057 #
22058 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
22059 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
22060 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
22061 # It uses RE2 syntax with the following constraints:
22062 #
22063 #
22064 # - Any single character operators
22065 # - Groups are allowed to have only submatch operator inside
22066 # - Groups are allowed only without any char repetition, e.g.
22067 # .*
22068 # - Any char repetition, e.g. .*, is
22069 # only allowed to be used in a single regex together with:
22070 #
22071 #
22072 # - Empty string operators
22073 # - Other repetitions
22074 # - Ranges
22075 # - Repetitions of ranges
22076 #
22077 #
22078 # - Ranges are only allowed to have:
22079 #
22080 #
22081 # - Character range
22082 # - Digits range
22083 # - Symbols listed in characters allowed for ranges
22084 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
22085 # the path.
22086 },
22087 },
22088 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
22089 # occurs. The weights determine the fraction of traffic that flows to
22090 # their corresponding backend service. If all traffic needs to
22091 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
22092 #
22093 # After a backend service is identified and before forwarding
22094 # the request to
22095 # the backend service, advanced routing actions such as URL rewrites and
22096 # header transformations are applied depending on additional settings
22097 # specified in this HttpRouteAction.
22098 { # In contrast to a single BackendService in
22099 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
22100 # multiple backend services. The volume of traffic for each
22101 # backend service is proportional to the weight specified
22102 # in each WeightedBackendService
22103 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
22104 # resource. Before
22105 # forwarding the request to backendService, the load balancer
22106 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
22107 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
22108 # effect for the selected backendService.
22109 #
22110 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
22111 #
22112 # headerAction is not supported for load balancers that have
22113 # their loadBalancingScheme set to EXTERNAL.
22114 #
22115 # Not supported when the URL map is bound to a target gRPC proxy that
22116 # has validateForProxyless field set to true.
22117 # the request is passed along to the selected backendService.
22118 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
22119 { # Specification determining how headers are added to requests or responses.
22120 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
22121 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
22122 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
22123 # that already
22124 # exist for the header. If true, headerValue is set for the
22125 # header, discarding any values that were set for that header.
22126 #
22127 # The default value is true,
22128 # unless a variable is present in headerValue,
22129 # in which case the default value is false.
22130 # .
22131 },
22132 ],
22133 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
22134 # request before forwarding the request to the backendService.
22135 &quot;A String&quot;,
22136 ],
22137 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
22138 # client.
22139 { # Specification determining how headers are added to requests or responses.
22140 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
22141 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
22142 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
22143 # that already
22144 # exist for the header. If true, headerValue is set for the
22145 # header, discarding any values that were set for that header.
22146 #
22147 # The default value is true,
22148 # unless a variable is present in headerValue,
22149 # in which case the default value is false.
22150 # .
22151 },
22152 ],
22153 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
22154 # response before sending the response back to the client.
22155 &quot;A String&quot;,
22156 ],
22157 },
22158 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
22159 # computed asweight / (sum of all weightedBackendService weights in routeAction).
22160 #
22161 # The selection of a backend service is determined only for new traffic.
22162 # Once a user&#x27;s request has been directed to a backend service,
22163 # subsequent requests are sent to the same backend service as
22164 # determined by the backend service&#x27;s session affinity policy.
22165 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
22166 # splitting. If you do, the weighted traffic splitting configuration takes
22167 # precedence.
22168 #
22169 # The value must be from 0 to 1000.
22170 },
22171 ],
22172 },
22173 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource. This
22174 # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
22175 # matched. For example, the
22176 # following are all valid URLs to a BackendService resource:
22177 #
22178 #
22179 # - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
22180 # - compute/v1/projects/project/global/backendServices/backendService
22181 # - global/backendServices/backendService
22182 #
22183 #
22184 # If defaultRouteAction is also specified, advanced
22185 # routing actions, such as URL rewrites, take effect before sending the
22186 # request to the backend.
22187 #
22188 #
22189 # Only one of defaultUrlRedirect, defaultService
22190 # or defaultRouteAction.weightedBackendService can be set.
22191 #
22192 #
22193 # Authorization requires one or more of the following Google IAM permissions on the
22194 # specified resource default_service:
22195 #
22196 #
22197 # - compute.backendBuckets.use
22198 # - compute.backendServices.use
22199 &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
22200 # by defaultUrlRedirect.
22201 #
22202 #
22203 # Only one of defaultUrlRedirect, defaultService
22204 # or defaultRouteAction.weightedBackendService can be set.
22205 #
22206 #
22207 # Not supported when the URL map is bound to a target gRPC proxy.
22208 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
22209 # was supplied in the request.
22210 #
22211 # The value must be from 1 to 255
22212 # characters.
22213 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
22214 # set to HTTPS.
22215 # If set to false, the URL scheme of the redirected request
22216 # remains the same as that of the request.
22217 #
22218 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
22219 #
22220 # The default is set to false.
22221 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
22222 # that was supplied in the request.
22223 #
22224 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
22225 # supplied, the path of the original request is used for the redirect.
22226 #
22227 # The value must be from 1 to 1024 characters.
22228 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
22229 # the HttpRouteRuleMatch, retaining the remaining portion
22230 # of the URL before redirecting the request.
22231 #
22232 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
22233 # supplied, the path of the original request is used for the redirect.
22234 #
22235 # The value must be from 1 to 1024 characters.
22236 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
22237 #
22238 # Supported values are:
22239 #
22240 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
22241 # to 301.
22242 # - FOUND, which corresponds to 302.
22243 # - SEE_OTHER which corresponds to 303.
22244 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
22245 # method is retained.
22246 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
22247 # method is retained.
22248 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
22249 # URL is
22250 # removed before redirecting the request. If set to false, the
22251 # query portion of the original URL is retained.
22252 #
22253 # The default is set to false.
22254 },
22255 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
22256 # create the resource.
22257 &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
22258 # for the selected backend service.
22259 #
22260 # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
22261 #
22262 # HeaderAction is not supported for load balancers
22263 # that have
22264 # their loadBalancingScheme set to EXTERNAL.
22265 #
22266 # Not supported when the URL map is bound to a target gRPC proxy that
22267 # has validateForProxyless field set to true.
22268 # the request is passed along to the selected backendService.
22269 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
22270 { # Specification determining how headers are added to requests or responses.
22271 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
22272 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
22273 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
22274 # that already
22275 # exist for the header. If true, headerValue is set for the
22276 # header, discarding any values that were set for that header.
22277 #
22278 # The default value is true,
22279 # unless a variable is present in headerValue,
22280 # in which case the default value is false.
22281 # .
22282 },
22283 ],
22284 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
22285 # request before forwarding the request to the backendService.
22286 &quot;A String&quot;,
22287 ],
22288 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
22289 # client.
22290 { # Specification determining how headers are added to requests or responses.
22291 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
22292 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
22293 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
22294 # that already
22295 # exist for the header. If true, headerValue is set for the
22296 # header, discarding any values that were set for that header.
22297 #
22298 # The default value is true,
22299 # unless a variable is present in headerValue,
22300 # in which case the default value is false.
22301 # .
22302 },
22303 ],
22304 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
22305 # response before sending the response back to the client.
22306 &quot;A String&quot;,
22307 ],
22308 },
22309 &quot;name&quot;: &quot;A String&quot;, # The name to which this PathMatcher is referred by theHostRule.
22310 &quot;pathRules&quot;: [ # The list of path rules. Use this list instead of routeRules
22311 # when routing based on simple path matching is all that&#x27;s required. A path
22312 # rule can only include a wildcard character (*) after a
22313 # forward slash character (&quot;/&quot;).
22314 #
22315 # The order by which path rules are specified does not matter.
22316 # Matches are always done on the longest-path-first basis.
22317 #
22318 # For example: a pathRule with a path /a/b/c/* will match
22319 # before /a/b/* irrespective of the order in which those paths appear in this
22320 # list.
22321 #
22322 # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
22323 { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
22324 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
22325 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
22326 #
22327 # If a policy for an
22328 # error code is not configured for the PathRule, a policy for
22329 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
22330 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
22331 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
22332 # effect.
22333 #
22334 # For example, consider a UrlMap with the following configuration:
22335 #
22336 #
22337 # - UrlMap.defaultCustomErrorResponsePolicy are configured
22338 # with policies for 5xx and 4xx errors
22339 # - A PathRule for /coming_soon/ is configured for the error
22340 # code 404.
22341 #
22342 # 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
22343 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
22344 # the policy in PathRule.customErrorResponsePolicy takes
22345 # effect. If any of the requests in this example encounter a 500
22346 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
22347 #
22348 # customErrorResponsePolicy is supported only for
22349 # global external Application Load Balancers.
22350 # backend service or backend bucket responds with an error.
22351 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
22352 #
22353 # In a given policy, if you specify rules for both a range of error codes
22354 # as well as rules for specific error codes then rules with specific error
22355 # codes have a higher priority. For example, assume that you configure a rule
22356 # for 401 (Un-authorized) code, and another for all 4 series
22357 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
22358 # However if the backend service returns a 403, the rule for4xx takes effect.
22359 { # Specifies the mapping between the response code that will be returned along
22360 # with the custom error content and the response code returned by the backend
22361 # service.
22362 &quot;matchResponseCodes&quot;: [ # Valid values include:
22363 #
22364 #
22365 # - A number between 400 and 599: For example
22366 # 401 or 503, in which case the load balancer
22367 # applies the policy if the error code exactly matches this value.
22368 # - 5xx: Load Balancer will apply the policy if the
22369 # backend service responds with any response code in the range of
22370 # 500 to 599.
22371 # - 4xx: Load
22372 # Balancer will apply the policy if the backend service responds with any
22373 # response code in the range of 400 to
22374 # 499.
22375 #
22376 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
22377 &quot;A String&quot;,
22378 ],
22379 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
22380 # error content. If overrideResponseCode is not supplied, the
22381 # same response code returned by the original backend bucket or backend
22382 # service is returned to the client.
22383 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
22384 #
22385 # path must start
22386 # with a leading slash. path cannot have trailing slashes.
22387 #
22388 # If the file is not available in backendBucket or the
22389 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
22390 #
22391 # The value must
22392 # be from 1 to 1024 characters
22393 },
22394 ],
22395 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
22396 # contains the custom error content. Examples are:
22397 #
22398 #
22399 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
22400 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
22401 # - global/backendBuckets/myBackendBucket
22402 #
22403 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
22404 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
22405 #
22406 # If load balancer cannot reach
22407 # the backendBucket, a simple Not Found Error will
22408 # be returned, with the original response code (oroverrideResponseCode if configured).
22409 #
22410 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
22411 },
22412 &quot;paths&quot;: [ # The list of path patterns to match. Each must start with /
22413 # and the only place a * is allowed is at the end following
22414 # a /. The string fed to the path matcher does not include
22415 # any text after the first ? or #, and
22416 # those chars are not allowed here.
22417 &quot;A String&quot;,
22418 ],
22419 &quot;routeAction&quot;: { # In response to a matching path, the load balancer
22420 # performs advanced routing actions, such as URL rewrites and header
22421 # transformations, before forwarding the request to the selected
22422 # backend.
22423 #
22424 #
22425 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
22426 #
22427 #
22428 # URL maps for classic Application Load Balancers only support
22429 # the urlRewrite action within a path rule&#x27;srouteAction.
22430 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
22431 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
22432 # property must be specified. This policy cannot be specified if any target
22433 # backend has Identity-Aware Proxy enabled.
22434 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
22435 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
22436 # header names can be specified. The cache is bypassed for all `cacheMode`
22437 # values.
22438 &quot;A String&quot;,
22439 ],
22440 &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
22441 # on the backend type: for Backend Services, the complete request URI is
22442 # used; for Backend Buckets, the request URI is used without the protocol or
22443 # host, and only query parameters known to Cloud Storage are included.
22444 # Policy defined on Route Action.
22445 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
22446 # parameters will be included. Either specify `excludedQueryParameters`
22447 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
22448 # encoded and not treated as delimiters.
22449 #
22450 # Note: This field applies to routes that use backend services. Attempting
22451 # to set it on a route that points exclusively to Backend Buckets will
22452 # result in a configuration error. For routes that point to a Backend
22453 # Bucket, use `includedQueryParameters` to define which parameters should
22454 # be part of the cache key.
22455 &quot;A String&quot;,
22456 ],
22457 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
22458 #
22459 # Note: This setting is only applicable to routes that use a Backend
22460 # Service. It does not affect requests served by a Backend Bucket, as the
22461 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
22462 # it on a route that points exclusively to Backend Buckets will result in a
22463 # configuration error.
22464 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
22465 #
22466 # Note: This setting is only applicable to routes that use a Backend
22467 # Service. It does not affect requests served by a Backend Bucket, as the
22468 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
22469 # set on a route that points exclusively to Backend Buckets will result in
22470 # a configuration error.
22471 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
22472 # `includedQueryParameters` and `excludedQueryParameters`. If neither
22473 # is set, the entire query string will be included. If false, the query
22474 # string will be excluded from the cache key entirely.
22475 #
22476 # Note: This field applies to routes that use backend services. Attempting
22477 # to set it on a route that points exclusively to Backend Buckets will
22478 # result in a configuration error. For routes that point to a Backend
22479 # Bucket, use `includedQueryParameters` to define which parameters should
22480 # be part of the cache key.
22481 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
22482 # The name=value pair will be used in the cache key Cloud CDN generates.
22483 #
22484 # Note: This setting is only applicable to routes that use a Backend
22485 # Service. It does not affect requests served by a Backend Bucket.
22486 # Attempting to set it on a route that points exclusively to Backend
22487 # Buckets will result in a configuration error. Up to 5 cookie names can be
22488 # specified.
22489 &quot;A String&quot;,
22490 ],
22491 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
22492 &quot;A String&quot;,
22493 ],
22494 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
22495 # parameters will be excluded. Either specify `includedQueryParameters`
22496 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
22497 # encoded and not treated as delimiters.
22498 &quot;A String&quot;,
22499 ],
22500 },
22501 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
22502 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
22503 &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
22504 # content. This is used to clamp the max-age (or Expires) value sent to the
22505 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
22506 # is used for the response max-age directive, along with a &quot;public&quot;
22507 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
22508 # clamps the max-age from the origin (if specified), or else sets the
22509 # response max-age directive to the lesser of the `clientTtl` and
22510 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
22511 # present. The maximum allowed value is 31,622,400s (1 year). If not
22512 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
22513 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
22514 # `USE_ORIGIN_HEADERS`.
22515 # as a count of seconds and fractions of seconds at nanosecond
22516 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
22517 # or &quot;month&quot;. Range is approximately 10,000 years.
22518 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
22519 # Durations less than one second are represented with a 0
22520 # `seconds` field and a positive `nanos` field. Must be from 0
22521 # to 999,999,999 inclusive.
22522 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22523 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22524 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22525 },
22526 &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
22527 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
22528 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
22529 # greater than that of `maxTtl`. When the `cacheMode` is set to
22530 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
22531 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
22532 # accessed objects may be evicted from the cache before the defined TTL. If
22533 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
22534 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
22535 # `USE_ORIGIN_HEADERS`.
22536 # as a count of seconds and fractions of seconds at nanosecond
22537 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
22538 # or &quot;month&quot;. Range is approximately 10,000 years.
22539 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
22540 # Durations less than one second are represented with a 0
22541 # `seconds` field and a positive `nanos` field. Must be from 0
22542 # to 999,999,999 inclusive.
22543 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22544 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22545 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22546 },
22547 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
22548 # attempt to set a max-age or s-maxage higher than this, or an Expires header
22549 # more than `maxTtl` seconds in the future will be capped at the value of
22550 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
22551 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
22552 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
22553 # Infrequently accessed objects may be evicted from the cache before the
22554 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
22555 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
22556 # mode.
22557 # as a count of seconds and fractions of seconds at nanosecond
22558 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
22559 # or &quot;month&quot;. Range is approximately 10,000 years.
22560 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
22561 # Durations less than one second are represented with a 0
22562 # `seconds` field and a positive `nanos` field. Must be from 0
22563 # to 999,999,999 inclusive.
22564 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22565 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22566 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22567 },
22568 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
22569 # to apply fine-grained caching for common errors or redirects.
22570 # This can reduce the load on your origin and improve end-user
22571 # experience by reducing response latency.
22572 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
22573 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
22574 # the specified response code that lack any Cache-Control, Expires, or
22575 # Pragma: no-cache directives. When the `cacheMode` is set to
22576 # `FORCE_CACHE_ALL`, negative caching applies to all responses
22577 # with the specified response code, and overrides any caching headers. By
22578 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
22579 #
22580 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
22581 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
22582 # * 405 (Method Not Found), 501 (Not Implemented): 60s
22583 #
22584 # These defaults can be overridden in `negativeCachingPolicy`.
22585 # If not specified, Cloud CDN applies negative caching by default.
22586 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
22587 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
22588 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
22589 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
22590 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
22591 # all response codes that you wish to cache. Cloud CDN will not apply any
22592 # default negative caching when a policy exists.
22593 { # Specify CDN TTLs for response error codes.
22594 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
22595 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
22596 # specified as values, and you cannot specify a status code more than
22597 # once.
22598 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
22599 # corresponding status code.
22600 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
22601 # objects may be evicted from the cache before the defined TTL.
22602 # as a count of seconds and fractions of seconds at nanosecond
22603 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
22604 # or &quot;month&quot;. Range is approximately 10,000 years.
22605 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
22606 # Durations less than one second are represented with a 0
22607 # `seconds` field and a positive `nanos` field. Must be from 0
22608 # to 999,999,999 inclusive.
22609 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22610 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22611 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22612 },
22613 },
22614 ],
22615 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
22616 # requests into a small number of requests to the origin. If not specified,
22617 # Cloud CDN applies request coalescing by default.
22618 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
22619 # content with the origin, or when an error is encountered when refreshing
22620 # the cache.
22621 # This setting defines the default &quot;max-stale&quot; duration for any cached
22622 # responses that do not specify a max-stale directive. Stale responses that
22623 # exceed the TTL configured here will not be served. The default limit
22624 # (max-stale) is 86400s (1 day), which will allow stale content to be
22625 # served up to this limit beyond the max-age (or s-maxage) of a cached
22626 # response.
22627 # The maximum allowed value is 604800 (1 week).
22628 # Set this to zero (0) to disable serve-while-stale.
22629 # as a count of seconds and fractions of seconds at nanosecond
22630 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
22631 # or &quot;month&quot;. Range is approximately 10,000 years.
22632 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
22633 # Durations less than one second are represented with a 0
22634 # `seconds` field and a positive `nanos` field. Must be from 0
22635 # to 999,999,999 inclusive.
22636 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22637 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22638 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22639 },
22640 },
22641 &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
22642 # information about the W3C recommendation for cross-origin resource sharing
22643 # (CORS), see Fetch API Living
22644 # Standard.
22645 #
22646 # Not supported when the URL map is bound to a target gRPC proxy.
22647 # information about the W3C recommendation for cross-origin resource sharing
22648 # (CORS), see Fetch API Living
22649 # Standard.
22650 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
22651 # indicates that
22652 # the actual request can include user credentials. This field translates to
22653 # the Access-Control-Allow-Credentials header.
22654 #
22655 # Default is false.
22656 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
22657 # header.
22658 &quot;A String&quot;,
22659 ],
22660 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
22661 # header.
22662 &quot;A String&quot;,
22663 ],
22664 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
22665 # more information, see regular expression syntax.
22666 #
22667 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
22668 #
22669 # Regular expressions can only be used when the loadBalancingScheme is
22670 # set to INTERNAL_SELF_MANAGED.
22671 &quot;A String&quot;,
22672 ],
22673 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
22674 #
22675 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
22676 &quot;A String&quot;,
22677 ],
22678 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
22679 # The default value is false, which indicates that the CORS
22680 # policy is in effect.
22681 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
22682 # header.
22683 &quot;A String&quot;,
22684 ],
22685 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
22686 # seconds. This field translates to the Access-Control-Max-Age
22687 # header.
22688 },
22689 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
22690 # the resiliency of clients to backend service failure. As part of fault
22691 # injection, when clients send requests to a backend service, delays can be
22692 # introduced by a load balancer on a percentage of requests before sending
22693 # those requests to the backend service. Similarly requests from clients can
22694 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
22695 # that are configured with a fault_injection_policy if:
22696 # 1. The traffic is generated by fault injection AND
22697 # 2. The fault injection is not a delay fault injection.
22698 # Fault injection is not supported with the classic Application Load Balancer
22699 # . To see which load balancers support fault injection,
22700 # see Load
22701 # balancing: Routing and traffic management features.
22702 # the resiliency of clients to backend service failure. As part of fault
22703 # injection, when clients send requests to a backend service, delays can be
22704 # introduced by the load balancer on a percentage of requests before sending
22705 # those request to the backend service. Similarly requests from clients can be
22706 # aborted by the load balancer for a percentage of requests.
22707 &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
22708 # injection.
22709 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
22710 #
22711 # The value must be from 200 to 599 inclusive.
22712 #
22713 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
22714 # according to this
22715 # mapping table. HTTP status 200 is mapped to gRPC status
22716 # UNKNOWN. Injecting an OK status is currently not supported by
22717 # Traffic Director.
22718 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
22719 # that is aborted as part of fault injection.
22720 #
22721 # The value must be from 0.0 to 100.0 inclusive.
22722 },
22723 &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
22724 # injection, before being sent to a backend service.
22725 # request to the backend service as part of fault injection.
22726 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
22727 # as a count of seconds and fractions of seconds at nanosecond
22728 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
22729 # or &quot;month&quot;. Range is approximately 10,000 years.
22730 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
22731 # Durations less than one second are represented with a 0
22732 # `seconds` field and a positive `nanos` field. Must be from 0
22733 # to 999,999,999 inclusive.
22734 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22735 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22736 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22737 },
22738 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
22739 # which a delay is introduced as part of fault injection.
22740 #
22741 # The value must be from 0.0 to 100.0 inclusive.
22742 },
22743 },
22744 &quot;imageOptimizationPolicy&quot;: { # The configuration for Cloud CDN&#x27;s image optimization feature. This feature # Image optimization policy for this URL Map&#x27;s route. Available only for
22745 # Global EXTERNAL_MANAGED load balancer schemes.
22746 # Either Cloud CDN must be enabled on the backend service or backend bucket
22747 # serving the route, or cache policy must be configured on the same route
22748 # dynamically processes and delivers images from the network edge.
22749 # Image Optimization is only available for Global External Application Load
22750 # Balancers.
22751 # Either Cloud CDN must be enabled on the backend service or backend bucket
22752 # serving the route, or cache policy must be configured on the same route.
22753 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
22754 },
22755 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
22756 # Unlike the timeout field where the timeout duration starts
22757 # from the time the request has been fully processed (known as*end-of-stream*),
22758 # the duration in this field is computed from the beginning of the stream
22759 # until the response has been processed, including all retries. A
22760 # stream that does not complete in this duration is closed.
22761 #
22762 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
22763 # with the route.
22764 #
22765 # This field is only allowed if the Url map is used with backend services
22766 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
22767 # as a count of seconds and fractions of seconds at nanosecond
22768 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
22769 # or &quot;month&quot;. Range is approximately 10,000 years.
22770 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
22771 # Durations less than one second are represented with a 0
22772 # `seconds` field and a positive `nanos` field. Must be from 0
22773 # to 999,999,999 inclusive.
22774 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22775 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22776 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22777 },
22778 &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
22779 # are shadowed to a separate mirrored backend service. The load balancer does
22780 # not wait for responses from the shadow service. Before sending traffic
22781 # to the shadow service, the host / authority header is suffixed with-shadow.
22782 #
22783 # Not supported when the URL map is bound to a target gRPC proxy that
22784 # has the validateForProxyless field set to true.
22785 # are shadowed to a separate mirrored backend service. The load balancer
22786 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
22787 # to the shadow service, the host or authority header is suffixed with-shadow.
22788 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
22789 # mirrored to.
22790 #
22791 # The backend service configured for a mirroring
22792 # policy must reference backends that are of the same type as the original
22793 # backend service matched in the URL map.
22794 #
22795 # Serverless NEG backends are not currently supported as a mirrored
22796 # backend service.
22797 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
22798 },
22799 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
22800 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
22801 # If not specified, defaults to 1.
22802 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
22803 #
22804 # If not specified, will use the timeout set in theHttpRouteAction field.
22805 # If timeout in the HttpRouteAction field is not set, this field
22806 # uses the largest timeout
22807 # among all backend services associated with the route.
22808 #
22809 # Not supported when the URL map is bound to a target gRPC proxy that
22810 # has the validateForProxyless field set to true.
22811 # as a count of seconds and fractions of seconds at nanosecond
22812 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
22813 # or &quot;month&quot;. Range is approximately 10,000 years.
22814 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
22815 # Durations less than one second are represented with a 0
22816 # `seconds` field and a positive `nanos` field. Must be from 0
22817 # to 999,999,999 inclusive.
22818 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22819 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22820 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22821 },
22822 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
22823 # values are:
22824 #
22825 # - 5xx: retry is attempted if the instance or endpoint
22826 # responds with any 5xx response code, or if the instance or
22827 # endpoint does not respond at all. For example, disconnects, reset, read
22828 # timeout, connection failure, and refused streams.
22829 # - gateway-error: Similar to 5xx, but only
22830 # applies to response codes 502, 503 or504.
22831 # - connect-failure: a retry is attempted on failures
22832 # connecting to the instance or endpoint. For example, connection
22833 # timeouts.
22834 # - retriable-4xx: a retry is attempted if the instance
22835 # or endpoint responds with a 4xx response code.
22836 # The only error that you can retry is error code 409.
22837 # - refused-stream: a retry is attempted if the instance
22838 # or endpoint resets the stream with a REFUSED_STREAM error
22839 # code. This reset type indicates that it is safe to retry.
22840 # - cancelled: a retry is attempted if the gRPC status
22841 # code in the response header is set to cancelled.
22842 # - deadline-exceeded: a retry is attempted if the gRPC
22843 # status code in the response header is set todeadline-exceeded.
22844 # - internal: a retry is attempted if the gRPC
22845 # status code in the response header is set tointernal.
22846 # - resource-exhausted: a retry is attempted if the gRPC
22847 # status code in the response header is set toresource-exhausted.
22848 # - unavailable: a retry is attempted if the gRPC
22849 # status code in the response header is set tounavailable.
22850 #
22851 # Only the following codes are supported when the URL map is bound to
22852 # target gRPC proxy that has validateForProxyless field set to true.
22853 #
22854 # - cancelled
22855 # - deadline-exceeded
22856 # - internal
22857 # - resource-exhausted
22858 # - unavailable
22859 &quot;A String&quot;,
22860 ],
22861 },
22862 &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
22863 # time the request has been fully processed (known as *end-of-stream*)
22864 # up until the response has been processed. Timeout includes
22865 # all retries.
22866 #
22867 # If not specified, this field uses the largest timeout among all backend
22868 # services associated with the route.
22869 #
22870 # Not supported when the URL map is bound to a target gRPC proxy that
22871 # has validateForProxyless field set to true.
22872 # as a count of seconds and fractions of seconds at nanosecond
22873 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
22874 # or &quot;month&quot;. Range is approximately 10,000 years.
22875 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
22876 # Durations less than one second are represented with a 0
22877 # `seconds` field and a positive `nanos` field. Must be from 0
22878 # to 999,999,999 inclusive.
22879 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22880 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22881 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22882 },
22883 &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
22884 # to the matched service.
22885 #
22886 # urlRewrite is the only action supported in UrlMaps
22887 # for classic Application Load Balancers.
22888 #
22889 # Not supported when the URL map is bound to a target gRPC proxy that
22890 # has the validateForProxyless field set to true.
22891 # backend service.
22892 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
22893 # host header is replaced with contents of hostRewrite.
22894 #
22895 # The value must be from 1 to 255 characters.
22896 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
22897 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
22898 #
22899 # The value must be from 1 to 1024 characters.
22900 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
22901 # header) using the HTTP template syntax.
22902 #
22903 # A corresponding
22904 # path_template_match must be specified. Any template variables must exist in
22905 # the path_template_match field.
22906 #
22907 #
22908 # - -At least one variable must be specified in the path_template_match
22909 # field
22910 # - You can omit variables from the rewritten URL
22911 # - The * and ** operators cannot be matched
22912 # unless they have a corresponding variable name - e.g.
22913 # {format=*} or {var=**}.
22914 #
22915 # For example, a path_template_match of /static/{format=**}
22916 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
22917 # rewrite, so that /{country}/{format}/{suffix=**} can be
22918 # rewritten as /content/{format}/{country}/{suffix}.
22919 #
22920 # At least
22921 # one non-empty routeRules[].matchRules[].path_template_match is
22922 # required.
22923 #
22924 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
22925 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
22926 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
22927 # It uses RE2 syntax with the following constraints:
22928 #
22929 #
22930 # - Any single character operators
22931 # - Groups are allowed to have only submatch operator inside
22932 # - Groups are allowed only without any char repetition, e.g.
22933 # .*
22934 # - Any char repetition, e.g. .*, is
22935 # only allowed to be used in a single regex together with:
22936 #
22937 #
22938 # - Empty string operators
22939 # - Other repetitions
22940 # - Ranges
22941 # - Repetitions of ranges
22942 #
22943 #
22944 # - Ranges are only allowed to have:
22945 #
22946 #
22947 # - Character range
22948 # - Digits range
22949 # - Symbols listed in characters allowed for ranges
22950 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
22951 # the path.
22952 },
22953 },
22954 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
22955 # occurs. The weights determine the fraction of traffic that flows to
22956 # their corresponding backend service. If all traffic needs to
22957 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
22958 #
22959 # After a backend service is identified and before forwarding
22960 # the request to
22961 # the backend service, advanced routing actions such as URL rewrites and
22962 # header transformations are applied depending on additional settings
22963 # specified in this HttpRouteAction.
22964 { # In contrast to a single BackendService in
22965 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
22966 # multiple backend services. The volume of traffic for each
22967 # backend service is proportional to the weight specified
22968 # in each WeightedBackendService
22969 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
22970 # resource. Before
22971 # forwarding the request to backendService, the load balancer
22972 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
22973 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
22974 # effect for the selected backendService.
22975 #
22976 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
22977 #
22978 # headerAction is not supported for load balancers that have
22979 # their loadBalancingScheme set to EXTERNAL.
22980 #
22981 # Not supported when the URL map is bound to a target gRPC proxy that
22982 # has validateForProxyless field set to true.
22983 # the request is passed along to the selected backendService.
22984 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
22985 { # Specification determining how headers are added to requests or responses.
22986 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
22987 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
22988 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
22989 # that already
22990 # exist for the header. If true, headerValue is set for the
22991 # header, discarding any values that were set for that header.
22992 #
22993 # The default value is true,
22994 # unless a variable is present in headerValue,
22995 # in which case the default value is false.
22996 # .
22997 },
22998 ],
22999 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
23000 # request before forwarding the request to the backendService.
23001 &quot;A String&quot;,
23002 ],
23003 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
23004 # client.
23005 { # Specification determining how headers are added to requests or responses.
23006 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
23007 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
23008 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
23009 # that already
23010 # exist for the header. If true, headerValue is set for the
23011 # header, discarding any values that were set for that header.
23012 #
23013 # The default value is true,
23014 # unless a variable is present in headerValue,
23015 # in which case the default value is false.
23016 # .
23017 },
23018 ],
23019 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
23020 # response before sending the response back to the client.
23021 &quot;A String&quot;,
23022 ],
23023 },
23024 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
23025 # computed asweight / (sum of all weightedBackendService weights in routeAction).
23026 #
23027 # The selection of a backend service is determined only for new traffic.
23028 # Once a user&#x27;s request has been directed to a backend service,
23029 # subsequent requests are sent to the same backend service as
23030 # determined by the backend service&#x27;s session affinity policy.
23031 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
23032 # splitting. If you do, the weighted traffic splitting configuration takes
23033 # precedence.
23034 #
23035 # The value must be from 0 to 1000.
23036 },
23037 ],
23038 },
23039 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
23040 # is directed if this rule is matched. If routeAction is
23041 # also specified, advanced routing actions, such as URL rewrites,
23042 # take effect before sending the request to the backend.
23043 #
23044 #
23045 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
23046 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
23047 # specified by urlRedirect.
23048 #
23049 #
23050 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
23051 #
23052 #
23053 # Not supported when the URL map is bound to a target gRPC proxy.
23054 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
23055 # was supplied in the request.
23056 #
23057 # The value must be from 1 to 255
23058 # characters.
23059 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
23060 # set to HTTPS.
23061 # If set to false, the URL scheme of the redirected request
23062 # remains the same as that of the request.
23063 #
23064 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
23065 #
23066 # The default is set to false.
23067 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
23068 # that was supplied in the request.
23069 #
23070 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
23071 # supplied, the path of the original request is used for the redirect.
23072 #
23073 # The value must be from 1 to 1024 characters.
23074 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
23075 # the HttpRouteRuleMatch, retaining the remaining portion
23076 # of the URL before redirecting the request.
23077 #
23078 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
23079 # supplied, the path of the original request is used for the redirect.
23080 #
23081 # The value must be from 1 to 1024 characters.
23082 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
23083 #
23084 # Supported values are:
23085 #
23086 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
23087 # to 301.
23088 # - FOUND, which corresponds to 302.
23089 # - SEE_OTHER which corresponds to 303.
23090 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
23091 # method is retained.
23092 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
23093 # method is retained.
23094 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
23095 # URL is
23096 # removed before redirecting the request. If set to false, the
23097 # query portion of the original URL is retained.
23098 #
23099 # The default is set to false.
23100 },
23101 },
23102 ],
23103 &quot;routeRules&quot;: [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
23104 # desired. routeRules are evaluated in order of priority, from
23105 # the lowest to highest number.
23106 #
23107 # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
23108 { # The HttpRouteRule setting specifies how to match an HTTP request
23109 # and the corresponding routing action that load balancing proxies perform.
23110 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
23111 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
23112 #
23113 # If a policy for an
23114 # error code is not configured for the RouteRule, a policy for
23115 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
23116 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
23117 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
23118 # effect.
23119 #
23120 # For example, consider a UrlMap with the following configuration:
23121 #
23122 #
23123 # - UrlMap.defaultCustomErrorResponsePolicy are configured
23124 # with policies for 5xx and 4xx errors
23125 # - A RouteRule for /coming_soon/ is configured for the
23126 # error code 404.
23127 #
23128 # 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
23129 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
23130 # the policy in RouteRule.customErrorResponsePolicy takes
23131 # effect. If any of the requests in this example encounter a 500
23132 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
23133 #
23134 # When
23135 # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
23136 # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
23137 # a retry, if load balancer is successful in reaching the
23138 # service, the customErrorResponsePolicy is ignored and
23139 # the response from the service is returned to the client.
23140 #
23141 # customErrorResponsePolicy is supported only for
23142 # global external Application Load Balancers.
23143 # backend service or backend bucket responds with an error.
23144 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
23145 #
23146 # In a given policy, if you specify rules for both a range of error codes
23147 # as well as rules for specific error codes then rules with specific error
23148 # codes have a higher priority. For example, assume that you configure a rule
23149 # for 401 (Un-authorized) code, and another for all 4 series
23150 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
23151 # However if the backend service returns a 403, the rule for4xx takes effect.
23152 { # Specifies the mapping between the response code that will be returned along
23153 # with the custom error content and the response code returned by the backend
23154 # service.
23155 &quot;matchResponseCodes&quot;: [ # Valid values include:
23156 #
23157 #
23158 # - A number between 400 and 599: For example
23159 # 401 or 503, in which case the load balancer
23160 # applies the policy if the error code exactly matches this value.
23161 # - 5xx: Load Balancer will apply the policy if the
23162 # backend service responds with any response code in the range of
23163 # 500 to 599.
23164 # - 4xx: Load
23165 # Balancer will apply the policy if the backend service responds with any
23166 # response code in the range of 400 to
23167 # 499.
23168 #
23169 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
23170 &quot;A String&quot;,
23171 ],
23172 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
23173 # error content. If overrideResponseCode is not supplied, the
23174 # same response code returned by the original backend bucket or backend
23175 # service is returned to the client.
23176 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
23177 #
23178 # path must start
23179 # with a leading slash. path cannot have trailing slashes.
23180 #
23181 # If the file is not available in backendBucket or the
23182 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
23183 #
23184 # The value must
23185 # be from 1 to 1024 characters
23186 },
23187 ],
23188 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
23189 # contains the custom error content. Examples are:
23190 #
23191 #
23192 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
23193 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
23194 # - global/backendBuckets/myBackendBucket
23195 #
23196 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
23197 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
23198 #
23199 # If load balancer cannot reach
23200 # the backendBucket, a simple Not Found Error will
23201 # be returned, with the original response code (oroverrideResponseCode if configured).
23202 #
23203 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
23204 },
23205 &quot;description&quot;: &quot;A String&quot;, # The short description conveying the intent of this routeRule.
23206 #
23207 #
23208 # The description can have a maximum length of 1024 characters.
23209 &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
23210 # for the selected backendService.
23211 #
23212 # The headerAction value specified here is applied before the
23213 # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
23214 #
23215 # HeaderAction is not supported for load balancers
23216 # that have
23217 # their loadBalancingScheme set to EXTERNAL.
23218 #
23219 # Not supported when the URL map is bound to a target gRPC proxy that
23220 # has validateForProxyless field set to true.
23221 # the request is passed along to the selected backendService.
23222 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
23223 { # Specification determining how headers are added to requests or responses.
23224 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
23225 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
23226 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
23227 # that already
23228 # exist for the header. If true, headerValue is set for the
23229 # header, discarding any values that were set for that header.
23230 #
23231 # The default value is true,
23232 # unless a variable is present in headerValue,
23233 # in which case the default value is false.
23234 # .
23235 },
23236 ],
23237 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
23238 # request before forwarding the request to the backendService.
23239 &quot;A String&quot;,
23240 ],
23241 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
23242 # client.
23243 { # Specification determining how headers are added to requests or responses.
23244 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
23245 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
23246 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
23247 # that already
23248 # exist for the header. If true, headerValue is set for the
23249 # header, discarding any values that were set for that header.
23250 #
23251 # The default value is true,
23252 # unless a variable is present in headerValue,
23253 # in which case the default value is false.
23254 # .
23255 },
23256 ],
23257 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
23258 # response before sending the response back to the client.
23259 &quot;A String&quot;,
23260 ],
23261 },
23262 &quot;httpFilterConfigs&quot;: [ # Outbound route specific configuration fornetworkservices.HttpFilter resources enabled by Traffic
23263 # Director. httpFilterConfigs only applies for load balancers
23264 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
23265 # more details.
23266 #
23267 # Not supported when the URL map is bound to a target gRPC proxy that
23268 # has validateForProxyless field set to true.
23269 { # HttpFilterConfiguration supplies additional contextual settings
23270 # for networkservices.HttpFilter resources enabled by Traffic
23271 # Director.
23272 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
23273 # YAML formatted and only contain fields defined in the protobuf identified
23274 # in configTypeUrl
23275 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
23276 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
23277 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
23278 # configuration belongs to. This name must be known to the xDS client.
23279 # Example: envoy.wasm
23280 },
23281 ],
23282 &quot;httpFilterMetadata&quot;: [ # Outbound route specific metadata supplied tonetworkservices.HttpFilter resources enabled by Traffic
23283 # Director. httpFilterMetadata only applies for load balancers
23284 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
23285 # more details.
23286 #
23287 # The only configTypeUrl supported istype.googleapis.com/google.protobuf.Struct
23288 #
23289 # Not supported when the URL map is bound to a target gRPC proxy that
23290 # has validateForProxyless field set to true.
23291 { # HttpFilterConfiguration supplies additional contextual settings
23292 # for networkservices.HttpFilter resources enabled by Traffic
23293 # Director.
23294 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
23295 # YAML formatted and only contain fields defined in the protobuf identified
23296 # in configTypeUrl
23297 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
23298 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
23299 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
23300 # configuration belongs to. This name must be known to the xDS client.
23301 # Example: envoy.wasm
23302 },
23303 ],
23304 &quot;matchRules&quot;: [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
23305 # this routeRule when any of thematchRules are satisfied. However predicates within
23306 # a given matchRule have AND semantics. All predicates
23307 # within a matchRule must match for the request to
23308 # match the rule.
23309 { # HttpRouteRuleMatch specifies a set of criteria for matching
23310 # requests to an HttpRouteRule. All specified criteria must
23311 # be satisfied for a match to occur.
23312 &quot;fullPathMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
23313 # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
23314 # that may be part of the original URL.
23315 #
23316 # fullPathMatch must be from 1 to 1024 characters.
23317 #
23318 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
23319 # specified.
23320 &quot;headerMatches&quot;: [ # Specifies a list of header match criteria, all of which must match
23321 # corresponding headers in the request.
23322 { # matchRule criteria for request header matches.
23323 &quot;exactMatch&quot;: &quot;A String&quot;, # The value should exactly match contents of exactMatch.
23324 #
23325 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
23326 &quot;headerName&quot;: &quot;A String&quot;, # The name of the HTTP header to match.
23327 #
23328 # For matching against the HTTP request&#x27;s authority, use a headerMatch
23329 # with the header name &quot;:authority&quot;.
23330 #
23331 # For matching a request&#x27;s method, use the headerName &quot;:method&quot;.
23332 #
23333 # When the URL map is bound to a target gRPC proxy that has
23334 # the validateForProxyless field set to true, only
23335 # non-binary
23336 # user-specified custom metadata and the `content-type` header are supported.
23337 # The following transport-level headers cannot be used in header matching
23338 # rules:
23339 # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
23340 # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
23341 # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
23342 # `grpc-timeout` and `grpc-trace-bin`.
23343 &quot;invertMatch&quot;: True or False, # If set to false, the headerMatch is considered a
23344 # match if the preceding match criteria are met. If set to true,
23345 # the headerMatch is considered a match if the preceding
23346 # match criteria are NOT met.
23347 #
23348 # The default setting is false.
23349 &quot;prefixMatch&quot;: &quot;A String&quot;, # The value of the header must start with the contents ofprefixMatch.
23350 #
23351 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
23352 &quot;presentMatch&quot;: True or False, # A header with the contents of headerName must exist. The
23353 # match takes place whether or not the request&#x27;s header has a value.
23354 #
23355 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
23356 &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
23357 # specified in rangeMatch. If the header does not contain an
23358 # integer, number or is empty, the match fails.
23359 #
23360 # For example for a range [-5, 0]
23361 #
23362 #
23363 # - -3 will match.
23364 # - 0 will not match.
23365 # - 0.25 will not match.
23366 # - -3someString will not match.
23367 #
23368 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
23369 #
23370 # rangeMatch is not supported for load balancers
23371 # that have loadBalancingScheme set to EXTERNAL.
23372 # within the specified integer range.
23373 &quot;rangeEnd&quot;: &quot;A String&quot;, # The end of the range (exclusive) in signed long integer format.
23374 &quot;rangeStart&quot;: &quot;A String&quot;, # The start of the range (inclusive) in signed long integer format.
23375 },
23376 &quot;regexMatch&quot;: &quot;A String&quot;, # The value of the header must match the regular expression specified inregexMatch.
23377 # For more information about regular expression syntax, see Syntax.
23378 #
23379 # For matching against a port specified in the HTTP request, use a
23380 # headerMatch with headerName set to PORT and a regular expression that
23381 # satisfies the RFC2616 Host header&#x27;s port specifier.
23382 #
23383 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
23384 #
23385 # Regular expressions can only be used when the loadBalancingScheme is
23386 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
23387 # (regional scope) or INTERNAL_MANAGED.
23388 &quot;suffixMatch&quot;: &quot;A String&quot;, # The value of the header must end with the contents ofsuffixMatch.
23389 #
23390 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
23391 },
23392 ],
23393 &quot;ignoreCase&quot;: True or False, # Specifies that prefixMatch and fullPathMatch
23394 # matches are case sensitive.
23395 #
23396 # The default value is false.
23397 #
23398 # ignoreCase must not be used with regexMatch.
23399 #
23400 # Not supported when the URL map is bound to a target gRPC proxy.
23401 &quot;metadataFilters&quot;: [ # Opaque filter criteria used by the load balancer to restrict routing
23402 # configuration to a limited set of xDS
23403 # compliant clients. In their xDS requests to the load balancer, xDS clients
23404 # present node
23405 # metadata. When there is a match, the relevant routing configuration
23406 # is made available to those proxies.
23407 #
23408 # 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
23409 # the metadata. If its filterMatchCriteria is set to
23410 # MATCH_ALL, then all of its filterLabels must match with
23411 # corresponding labels provided in the metadata. If multiple
23412 # metadata filters are specified, all of them need to be
23413 # satisfied in order to be considered a match.
23414 #
23415 # metadataFilters specified here is applied after those
23416 # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
23417 #
23418 # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
23419 #
23420 # Not supported when the URL map is bound to a target gRPC proxy that
23421 # has validateForProxyless field set to true.
23422 { # Opaque filter criteria used by load balancers to restrict routing
23423 # configuration to a limited set of load balancing proxies. Proxies and
23424 # sidecars involved in load balancing would typically present metadata to the
23425 # load balancers that need to match criteria specified here. If a match takes
23426 # place, the relevant configuration is made available to those
23427 # proxies.
23428 #
23429 # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
23430 # one of thefilterLabels must match the corresponding label provided in
23431 # the metadata. If its filterMatchCriteria is set to
23432 # MATCH_ALL, then all of its filterLabels must match with
23433 # corresponding labels provided in the metadata.
23434 #
23435 # An example for using metadataFilters would be: if
23436 # load balancing involves
23437 # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in of their XDS requests to loadbalancers.
23438 &quot;filterLabels&quot;: [ # The list of label value pairs that must match labels in the provided
23439 # metadata based on filterMatchCriteria
23440 #
23441 # This list must not be empty and can have at the most 64 entries.
23442 { # MetadataFilter label name value pairs that are expected
23443 # to match corresponding labels presented as metadata to the load balancer.
23444 &quot;name&quot;: &quot;A String&quot;, # Name of metadata label.
23445 #
23446 # The name can have a maximum length of 1024 characters and must be at
23447 # least 1 character long.
23448 &quot;value&quot;: &quot;A String&quot;, # The value of the label must match the specified value.
23449 #
23450 # value can have a maximum length of 1024 characters.
23451 },
23452 ],
23453 &quot;filterMatchCriteria&quot;: &quot;A String&quot;, # Specifies how individual filter label matches
23454 # within the list of filterLabels and contributes toward the
23455 # overall metadataFilter match.
23456 #
23457 # Supported values are:
23458 #
23459 # - MATCH_ANY: at least one of the filterLabels
23460 # must have a matching label in the provided metadata.
23461 # - MATCH_ALL: all filterLabels must have
23462 # matching labels in the provided metadata.
23463 },
23464 ],
23465 &quot;pathTemplateMatch&quot;: &quot;A String&quot;, # If specified, this field defines a path template pattern that must match
23466 # the :path header after the query string is removed.
23467 #
23468 # A path template pattern can include variables and wildcards.
23469 # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
23470 # matches a single path segment, and ** that matches zero or
23471 # more path segments. The pattern must follow these rules:
23472 #
23473 #
23474 # - The value must be between 1 and 1024 characters.
23475 # - The pattern must start with a leading slash (&quot;/&quot;).
23476 # - No more than 5 operators (variables or wildcards) may appear in
23477 # the pattern.
23478 #
23479 # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
23480 # set.
23481 &quot;prefixMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the request&#x27;s
23482 # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
23483 #
23484 # The value must be from 1 to 1024 characters.
23485 #
23486 # The * character inside a prefix match is
23487 # treated as a literal character, not as a wildcard.
23488 #
23489 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
23490 # used within a matchRule.
23491 &quot;queryParameterMatches&quot;: [ # Specifies a list of query parameter match criteria, all of which must
23492 # match corresponding query parameters in the request.
23493 #
23494 # Not supported when the URL map is bound to a target gRPC proxy.
23495 { # HttpRouteRuleMatch criteria for a request&#x27;s query parameter.
23496 &quot;exactMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
23497 # parameter exactly matches the contents of exactMatch.
23498 #
23499 # Only one of presentMatch, exactMatch, orregexMatch must be set.
23500 &quot;name&quot;: &quot;A String&quot;, # The name of the query parameter to match. The query parameter must exist in
23501 # the request, in the absence of which the request match fails.
23502 &quot;presentMatch&quot;: True or False, # Specifies that the queryParameterMatch matches if the
23503 # request contains the query parameter, irrespective of whether the
23504 # parameter has a value or not.
23505 #
23506 # Only one of presentMatch, exactMatch, orregexMatch must be set.
23507 &quot;regexMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
23508 # parameter matches the regular expression specified byregexMatch. For
23509 # more information about regular expression syntax, see Syntax.
23510 #
23511 # Only one of presentMatch, exactMatch, orregexMatch must be set.
23512 #
23513 # Regular expressions can only be used when the loadBalancingScheme is
23514 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
23515 # (regional scope) or INTERNAL_MANAGED.
23516 },
23517 ],
23518 &quot;regexMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
23519 # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
23520 # supplied with the original URL. For
23521 # more information about regular expression syntax, see Syntax.
23522 #
23523 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
23524 # specified.
23525 #
23526 # Regular expressions can only be used when the loadBalancingScheme is
23527 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
23528 # (regional scope) or INTERNAL_MANAGED.
23529 },
23530 ],
23531 &quot;priority&quot;: 42, # For routeRules within a given pathMatcher,
23532 # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
23533 # of priority, from the lowest to highest number. The priority of a
23534 # rule decreases as its number increases (1, 2, 3, N+1). The first rule
23535 # that matches the request is applied.
23536 #
23537 #
23538 # You cannot configure two or more routeRules with the same priority.
23539 # Priority for each rule must be set to a number from 0 to 2147483647
23540 # inclusive.
23541 #
23542 #
23543 # Priority numbers can have gaps, which enable you to add or remove rules
23544 # in the future without affecting the rest of the rules. For example, 1, 2,
23545 # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
23546 # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
23547 # without any impact on existing rules.
23548 &quot;routeAction&quot;: { # In response to a matching matchRule, the load balancer
23549 # performs advanced routing actions, such as URL rewrites and header
23550 # transformations, before forwarding the request to the selected backend.
23551 #
23552 #
23553 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
23554 #
23555 #
23556 # URL maps for classic Application Load Balancers only support
23557 # the urlRewrite action within a route rule&#x27;srouteAction.
23558 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
23559 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
23560 # property must be specified. This policy cannot be specified if any target
23561 # backend has Identity-Aware Proxy enabled.
23562 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
23563 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
23564 # header names can be specified. The cache is bypassed for all `cacheMode`
23565 # values.
23566 &quot;A String&quot;,
23567 ],
23568 &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
23569 # on the backend type: for Backend Services, the complete request URI is
23570 # used; for Backend Buckets, the request URI is used without the protocol or
23571 # host, and only query parameters known to Cloud Storage are included.
23572 # Policy defined on Route Action.
23573 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
23574 # parameters will be included. Either specify `excludedQueryParameters`
23575 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
23576 # encoded and not treated as delimiters.
23577 #
23578 # Note: This field applies to routes that use backend services. Attempting
23579 # to set it on a route that points exclusively to Backend Buckets will
23580 # result in a configuration error. For routes that point to a Backend
23581 # Bucket, use `includedQueryParameters` to define which parameters should
23582 # be part of the cache key.
23583 &quot;A String&quot;,
23584 ],
23585 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
23586 #
23587 # Note: This setting is only applicable to routes that use a Backend
23588 # Service. It does not affect requests served by a Backend Bucket, as the
23589 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
23590 # it on a route that points exclusively to Backend Buckets will result in a
23591 # configuration error.
23592 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
23593 #
23594 # Note: This setting is only applicable to routes that use a Backend
23595 # Service. It does not affect requests served by a Backend Bucket, as the
23596 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
23597 # set on a route that points exclusively to Backend Buckets will result in
23598 # a configuration error.
23599 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
23600 # `includedQueryParameters` and `excludedQueryParameters`. If neither
23601 # is set, the entire query string will be included. If false, the query
23602 # string will be excluded from the cache key entirely.
23603 #
23604 # Note: This field applies to routes that use backend services. Attempting
23605 # to set it on a route that points exclusively to Backend Buckets will
23606 # result in a configuration error. For routes that point to a Backend
23607 # Bucket, use `includedQueryParameters` to define which parameters should
23608 # be part of the cache key.
23609 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
23610 # The name=value pair will be used in the cache key Cloud CDN generates.
23611 #
23612 # Note: This setting is only applicable to routes that use a Backend
23613 # Service. It does not affect requests served by a Backend Bucket.
23614 # Attempting to set it on a route that points exclusively to Backend
23615 # Buckets will result in a configuration error. Up to 5 cookie names can be
23616 # specified.
23617 &quot;A String&quot;,
23618 ],
23619 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
23620 &quot;A String&quot;,
23621 ],
23622 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
23623 # parameters will be excluded. Either specify `includedQueryParameters`
23624 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
23625 # encoded and not treated as delimiters.
23626 &quot;A String&quot;,
23627 ],
23628 },
23629 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
23630 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
23631 &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
23632 # content. This is used to clamp the max-age (or Expires) value sent to the
23633 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
23634 # is used for the response max-age directive, along with a &quot;public&quot;
23635 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
23636 # clamps the max-age from the origin (if specified), or else sets the
23637 # response max-age directive to the lesser of the `clientTtl` and
23638 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
23639 # present. The maximum allowed value is 31,622,400s (1 year). If not
23640 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
23641 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
23642 # `USE_ORIGIN_HEADERS`.
23643 # as a count of seconds and fractions of seconds at nanosecond
23644 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
23645 # or &quot;month&quot;. Range is approximately 10,000 years.
23646 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
23647 # Durations less than one second are represented with a 0
23648 # `seconds` field and a positive `nanos` field. Must be from 0
23649 # to 999,999,999 inclusive.
23650 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
23651 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
23652 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
23653 },
23654 &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
23655 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
23656 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
23657 # greater than that of `maxTtl`. When the `cacheMode` is set to
23658 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
23659 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
23660 # accessed objects may be evicted from the cache before the defined TTL. If
23661 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
23662 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
23663 # `USE_ORIGIN_HEADERS`.
23664 # as a count of seconds and fractions of seconds at nanosecond
23665 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
23666 # or &quot;month&quot;. Range is approximately 10,000 years.
23667 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
23668 # Durations less than one second are represented with a 0
23669 # `seconds` field and a positive `nanos` field. Must be from 0
23670 # to 999,999,999 inclusive.
23671 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
23672 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
23673 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
23674 },
23675 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
23676 # attempt to set a max-age or s-maxage higher than this, or an Expires header
23677 # more than `maxTtl` seconds in the future will be capped at the value of
23678 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
23679 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
23680 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
23681 # Infrequently accessed objects may be evicted from the cache before the
23682 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
23683 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
23684 # mode.
23685 # as a count of seconds and fractions of seconds at nanosecond
23686 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
23687 # or &quot;month&quot;. Range is approximately 10,000 years.
23688 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
23689 # Durations less than one second are represented with a 0
23690 # `seconds` field and a positive `nanos` field. Must be from 0
23691 # to 999,999,999 inclusive.
23692 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
23693 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
23694 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
23695 },
23696 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
23697 # to apply fine-grained caching for common errors or redirects.
23698 # This can reduce the load on your origin and improve end-user
23699 # experience by reducing response latency.
23700 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
23701 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
23702 # the specified response code that lack any Cache-Control, Expires, or
23703 # Pragma: no-cache directives. When the `cacheMode` is set to
23704 # `FORCE_CACHE_ALL`, negative caching applies to all responses
23705 # with the specified response code, and overrides any caching headers. By
23706 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
23707 #
23708 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
23709 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
23710 # * 405 (Method Not Found), 501 (Not Implemented): 60s
23711 #
23712 # These defaults can be overridden in `negativeCachingPolicy`.
23713 # If not specified, Cloud CDN applies negative caching by default.
23714 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
23715 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
23716 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
23717 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
23718 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
23719 # all response codes that you wish to cache. Cloud CDN will not apply any
23720 # default negative caching when a policy exists.
23721 { # Specify CDN TTLs for response error codes.
23722 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
23723 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
23724 # specified as values, and you cannot specify a status code more than
23725 # once.
23726 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
23727 # corresponding status code.
23728 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
23729 # objects may be evicted from the cache before the defined TTL.
23730 # as a count of seconds and fractions of seconds at nanosecond
23731 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
23732 # or &quot;month&quot;. Range is approximately 10,000 years.
23733 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
23734 # Durations less than one second are represented with a 0
23735 # `seconds` field and a positive `nanos` field. Must be from 0
23736 # to 999,999,999 inclusive.
23737 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
23738 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
23739 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
23740 },
23741 },
23742 ],
23743 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
23744 # requests into a small number of requests to the origin. If not specified,
23745 # Cloud CDN applies request coalescing by default.
23746 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
23747 # content with the origin, or when an error is encountered when refreshing
23748 # the cache.
23749 # This setting defines the default &quot;max-stale&quot; duration for any cached
23750 # responses that do not specify a max-stale directive. Stale responses that
23751 # exceed the TTL configured here will not be served. The default limit
23752 # (max-stale) is 86400s (1 day), which will allow stale content to be
23753 # served up to this limit beyond the max-age (or s-maxage) of a cached
23754 # response.
23755 # The maximum allowed value is 604800 (1 week).
23756 # Set this to zero (0) to disable serve-while-stale.
23757 # as a count of seconds and fractions of seconds at nanosecond
23758 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
23759 # or &quot;month&quot;. Range is approximately 10,000 years.
23760 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
23761 # Durations less than one second are represented with a 0
23762 # `seconds` field and a positive `nanos` field. Must be from 0
23763 # to 999,999,999 inclusive.
23764 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
23765 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
23766 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
23767 },
23768 },
23769 &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
23770 # information about the W3C recommendation for cross-origin resource sharing
23771 # (CORS), see Fetch API Living
23772 # Standard.
23773 #
23774 # Not supported when the URL map is bound to a target gRPC proxy.
23775 # information about the W3C recommendation for cross-origin resource sharing
23776 # (CORS), see Fetch API Living
23777 # Standard.
23778 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
23779 # indicates that
23780 # the actual request can include user credentials. This field translates to
23781 # the Access-Control-Allow-Credentials header.
23782 #
23783 # Default is false.
23784 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
23785 # header.
23786 &quot;A String&quot;,
23787 ],
23788 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
23789 # header.
23790 &quot;A String&quot;,
23791 ],
23792 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
23793 # more information, see regular expression syntax.
23794 #
23795 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
23796 #
23797 # Regular expressions can only be used when the loadBalancingScheme is
23798 # set to INTERNAL_SELF_MANAGED.
23799 &quot;A String&quot;,
23800 ],
23801 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
23802 #
23803 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
23804 &quot;A String&quot;,
23805 ],
23806 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
23807 # The default value is false, which indicates that the CORS
23808 # policy is in effect.
23809 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
23810 # header.
23811 &quot;A String&quot;,
23812 ],
23813 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
23814 # seconds. This field translates to the Access-Control-Max-Age
23815 # header.
23816 },
23817 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
23818 # the resiliency of clients to backend service failure. As part of fault
23819 # injection, when clients send requests to a backend service, delays can be
23820 # introduced by a load balancer on a percentage of requests before sending
23821 # those requests to the backend service. Similarly requests from clients can
23822 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
23823 # that are configured with a fault_injection_policy if:
23824 # 1. The traffic is generated by fault injection AND
23825 # 2. The fault injection is not a delay fault injection.
23826 # Fault injection is not supported with the classic Application Load Balancer
23827 # . To see which load balancers support fault injection,
23828 # see Load
23829 # balancing: Routing and traffic management features.
23830 # the resiliency of clients to backend service failure. As part of fault
23831 # injection, when clients send requests to a backend service, delays can be
23832 # introduced by the load balancer on a percentage of requests before sending
23833 # those request to the backend service. Similarly requests from clients can be
23834 # aborted by the load balancer for a percentage of requests.
23835 &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
23836 # injection.
23837 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
23838 #
23839 # The value must be from 200 to 599 inclusive.
23840 #
23841 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
23842 # according to this
23843 # mapping table. HTTP status 200 is mapped to gRPC status
23844 # UNKNOWN. Injecting an OK status is currently not supported by
23845 # Traffic Director.
23846 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
23847 # that is aborted as part of fault injection.
23848 #
23849 # The value must be from 0.0 to 100.0 inclusive.
23850 },
23851 &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
23852 # injection, before being sent to a backend service.
23853 # request to the backend service as part of fault injection.
23854 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
23855 # as a count of seconds and fractions of seconds at nanosecond
23856 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
23857 # or &quot;month&quot;. Range is approximately 10,000 years.
23858 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
23859 # Durations less than one second are represented with a 0
23860 # `seconds` field and a positive `nanos` field. Must be from 0
23861 # to 999,999,999 inclusive.
23862 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
23863 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
23864 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
23865 },
23866 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
23867 # which a delay is introduced as part of fault injection.
23868 #
23869 # The value must be from 0.0 to 100.0 inclusive.
23870 },
23871 },
23872 &quot;imageOptimizationPolicy&quot;: { # The configuration for Cloud CDN&#x27;s image optimization feature. This feature # Image optimization policy for this URL Map&#x27;s route. Available only for
23873 # Global EXTERNAL_MANAGED load balancer schemes.
23874 # Either Cloud CDN must be enabled on the backend service or backend bucket
23875 # serving the route, or cache policy must be configured on the same route
23876 # dynamically processes and delivers images from the network edge.
23877 # Image Optimization is only available for Global External Application Load
23878 # Balancers.
23879 # Either Cloud CDN must be enabled on the backend service or backend bucket
23880 # serving the route, or cache policy must be configured on the same route.
23881 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
23882 },
23883 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
23884 # Unlike the timeout field where the timeout duration starts
23885 # from the time the request has been fully processed (known as*end-of-stream*),
23886 # the duration in this field is computed from the beginning of the stream
23887 # until the response has been processed, including all retries. A
23888 # stream that does not complete in this duration is closed.
23889 #
23890 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
23891 # with the route.
23892 #
23893 # This field is only allowed if the Url map is used with backend services
23894 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
23895 # as a count of seconds and fractions of seconds at nanosecond
23896 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
23897 # or &quot;month&quot;. Range is approximately 10,000 years.
23898 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
23899 # Durations less than one second are represented with a 0
23900 # `seconds` field and a positive `nanos` field. Must be from 0
23901 # to 999,999,999 inclusive.
23902 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
23903 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
23904 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
23905 },
23906 &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
23907 # are shadowed to a separate mirrored backend service. The load balancer does
23908 # not wait for responses from the shadow service. Before sending traffic
23909 # to the shadow service, the host / authority header is suffixed with-shadow.
23910 #
23911 # Not supported when the URL map is bound to a target gRPC proxy that
23912 # has the validateForProxyless field set to true.
23913 # are shadowed to a separate mirrored backend service. The load balancer
23914 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
23915 # to the shadow service, the host or authority header is suffixed with-shadow.
23916 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
23917 # mirrored to.
23918 #
23919 # The backend service configured for a mirroring
23920 # policy must reference backends that are of the same type as the original
23921 # backend service matched in the URL map.
23922 #
23923 # Serverless NEG backends are not currently supported as a mirrored
23924 # backend service.
23925 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
23926 },
23927 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
23928 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
23929 # If not specified, defaults to 1.
23930 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
23931 #
23932 # If not specified, will use the timeout set in theHttpRouteAction field.
23933 # If timeout in the HttpRouteAction field is not set, this field
23934 # uses the largest timeout
23935 # among all backend services associated with the route.
23936 #
23937 # Not supported when the URL map is bound to a target gRPC proxy that
23938 # has the validateForProxyless field set to true.
23939 # as a count of seconds and fractions of seconds at nanosecond
23940 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
23941 # or &quot;month&quot;. Range is approximately 10,000 years.
23942 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
23943 # Durations less than one second are represented with a 0
23944 # `seconds` field and a positive `nanos` field. Must be from 0
23945 # to 999,999,999 inclusive.
23946 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
23947 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
23948 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
23949 },
23950 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
23951 # values are:
23952 #
23953 # - 5xx: retry is attempted if the instance or endpoint
23954 # responds with any 5xx response code, or if the instance or
23955 # endpoint does not respond at all. For example, disconnects, reset, read
23956 # timeout, connection failure, and refused streams.
23957 # - gateway-error: Similar to 5xx, but only
23958 # applies to response codes 502, 503 or504.
23959 # - connect-failure: a retry is attempted on failures
23960 # connecting to the instance or endpoint. For example, connection
23961 # timeouts.
23962 # - retriable-4xx: a retry is attempted if the instance
23963 # or endpoint responds with a 4xx response code.
23964 # The only error that you can retry is error code 409.
23965 # - refused-stream: a retry is attempted if the instance
23966 # or endpoint resets the stream with a REFUSED_STREAM error
23967 # code. This reset type indicates that it is safe to retry.
23968 # - cancelled: a retry is attempted if the gRPC status
23969 # code in the response header is set to cancelled.
23970 # - deadline-exceeded: a retry is attempted if the gRPC
23971 # status code in the response header is set todeadline-exceeded.
23972 # - internal: a retry is attempted if the gRPC
23973 # status code in the response header is set tointernal.
23974 # - resource-exhausted: a retry is attempted if the gRPC
23975 # status code in the response header is set toresource-exhausted.
23976 # - unavailable: a retry is attempted if the gRPC
23977 # status code in the response header is set tounavailable.
23978 #
23979 # Only the following codes are supported when the URL map is bound to
23980 # target gRPC proxy that has validateForProxyless field set to true.
23981 #
23982 # - cancelled
23983 # - deadline-exceeded
23984 # - internal
23985 # - resource-exhausted
23986 # - unavailable
23987 &quot;A String&quot;,
23988 ],
23989 },
23990 &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
23991 # time the request has been fully processed (known as *end-of-stream*)
23992 # up until the response has been processed. Timeout includes
23993 # all retries.
23994 #
23995 # If not specified, this field uses the largest timeout among all backend
23996 # services associated with the route.
23997 #
23998 # Not supported when the URL map is bound to a target gRPC proxy that
23999 # has validateForProxyless field set to true.
24000 # as a count of seconds and fractions of seconds at nanosecond
24001 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
24002 # or &quot;month&quot;. Range is approximately 10,000 years.
24003 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
24004 # Durations less than one second are represented with a 0
24005 # `seconds` field and a positive `nanos` field. Must be from 0
24006 # to 999,999,999 inclusive.
24007 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
24008 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
24009 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
24010 },
24011 &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
24012 # to the matched service.
24013 #
24014 # urlRewrite is the only action supported in UrlMaps
24015 # for classic Application Load Balancers.
24016 #
24017 # Not supported when the URL map is bound to a target gRPC proxy that
24018 # has the validateForProxyless field set to true.
24019 # backend service.
24020 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
24021 # host header is replaced with contents of hostRewrite.
24022 #
24023 # The value must be from 1 to 255 characters.
24024 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
24025 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
24026 #
24027 # The value must be from 1 to 1024 characters.
24028 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
24029 # header) using the HTTP template syntax.
24030 #
24031 # A corresponding
24032 # path_template_match must be specified. Any template variables must exist in
24033 # the path_template_match field.
24034 #
24035 #
24036 # - -At least one variable must be specified in the path_template_match
24037 # field
24038 # - You can omit variables from the rewritten URL
24039 # - The * and ** operators cannot be matched
24040 # unless they have a corresponding variable name - e.g.
24041 # {format=*} or {var=**}.
24042 #
24043 # For example, a path_template_match of /static/{format=**}
24044 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
24045 # rewrite, so that /{country}/{format}/{suffix=**} can be
24046 # rewritten as /content/{format}/{country}/{suffix}.
24047 #
24048 # At least
24049 # one non-empty routeRules[].matchRules[].path_template_match is
24050 # required.
24051 #
24052 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
24053 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
24054 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
24055 # It uses RE2 syntax with the following constraints:
24056 #
24057 #
24058 # - Any single character operators
24059 # - Groups are allowed to have only submatch operator inside
24060 # - Groups are allowed only without any char repetition, e.g.
24061 # .*
24062 # - Any char repetition, e.g. .*, is
24063 # only allowed to be used in a single regex together with:
24064 #
24065 #
24066 # - Empty string operators
24067 # - Other repetitions
24068 # - Ranges
24069 # - Repetitions of ranges
24070 #
24071 #
24072 # - Ranges are only allowed to have:
24073 #
24074 #
24075 # - Character range
24076 # - Digits range
24077 # - Symbols listed in characters allowed for ranges
24078 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
24079 # the path.
24080 },
24081 },
24082 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
24083 # occurs. The weights determine the fraction of traffic that flows to
24084 # their corresponding backend service. If all traffic needs to
24085 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
24086 #
24087 # After a backend service is identified and before forwarding
24088 # the request to
24089 # the backend service, advanced routing actions such as URL rewrites and
24090 # header transformations are applied depending on additional settings
24091 # specified in this HttpRouteAction.
24092 { # In contrast to a single BackendService in
24093 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
24094 # multiple backend services. The volume of traffic for each
24095 # backend service is proportional to the weight specified
24096 # in each WeightedBackendService
24097 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
24098 # resource. Before
24099 # forwarding the request to backendService, the load balancer
24100 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
24101 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
24102 # effect for the selected backendService.
24103 #
24104 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
24105 #
24106 # headerAction is not supported for load balancers that have
24107 # their loadBalancingScheme set to EXTERNAL.
24108 #
24109 # Not supported when the URL map is bound to a target gRPC proxy that
24110 # has validateForProxyless field set to true.
24111 # the request is passed along to the selected backendService.
24112 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
24113 { # Specification determining how headers are added to requests or responses.
24114 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
24115 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
24116 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
24117 # that already
24118 # exist for the header. If true, headerValue is set for the
24119 # header, discarding any values that were set for that header.
24120 #
24121 # The default value is true,
24122 # unless a variable is present in headerValue,
24123 # in which case the default value is false.
24124 # .
24125 },
24126 ],
24127 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
24128 # request before forwarding the request to the backendService.
24129 &quot;A String&quot;,
24130 ],
24131 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
24132 # client.
24133 { # Specification determining how headers are added to requests or responses.
24134 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
24135 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
24136 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
24137 # that already
24138 # exist for the header. If true, headerValue is set for the
24139 # header, discarding any values that were set for that header.
24140 #
24141 # The default value is true,
24142 # unless a variable is present in headerValue,
24143 # in which case the default value is false.
24144 # .
24145 },
24146 ],
24147 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
24148 # response before sending the response back to the client.
24149 &quot;A String&quot;,
24150 ],
24151 },
24152 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
24153 # computed asweight / (sum of all weightedBackendService weights in routeAction).
24154 #
24155 # The selection of a backend service is determined only for new traffic.
24156 # Once a user&#x27;s request has been directed to a backend service,
24157 # subsequent requests are sent to the same backend service as
24158 # determined by the backend service&#x27;s session affinity policy.
24159 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
24160 # splitting. If you do, the weighted traffic splitting configuration takes
24161 # precedence.
24162 #
24163 # The value must be from 0 to 1000.
24164 },
24165 ],
24166 },
24167 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
24168 # is directed if this rule is matched. If routeAction is
24169 # also specified, advanced routing actions, such as URL rewrites,
24170 # take effect before sending the request to the backend.
24171 #
24172 #
24173 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
24174 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
24175 # specified by urlRedirect.
24176 #
24177 #
24178 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
24179 #
24180 #
24181 # Not supported when the URL map is bound to a target gRPC proxy.
24182 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
24183 # was supplied in the request.
24184 #
24185 # The value must be from 1 to 255
24186 # characters.
24187 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
24188 # set to HTTPS.
24189 # If set to false, the URL scheme of the redirected request
24190 # remains the same as that of the request.
24191 #
24192 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
24193 #
24194 # The default is set to false.
24195 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
24196 # that was supplied in the request.
24197 #
24198 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
24199 # supplied, the path of the original request is used for the redirect.
24200 #
24201 # The value must be from 1 to 1024 characters.
24202 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
24203 # the HttpRouteRuleMatch, retaining the remaining portion
24204 # of the URL before redirecting the request.
24205 #
24206 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
24207 # supplied, the path of the original request is used for the redirect.
24208 #
24209 # The value must be from 1 to 1024 characters.
24210 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
24211 #
24212 # Supported values are:
24213 #
24214 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
24215 # to 301.
24216 # - FOUND, which corresponds to 302.
24217 # - SEE_OTHER which corresponds to 303.
24218 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
24219 # method is retained.
24220 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
24221 # method is retained.
24222 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
24223 # URL is
24224 # removed before redirecting the request. If set to false, the
24225 # query portion of the original URL is retained.
24226 #
24227 # The default is set to false.
24228 },
24229 },
24230 ],
24231 },
24232 ],
24233 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the regional URL map resides.
24234 # This field is not applicable to global URL maps.
24235 # You must specify this field as part of the HTTP request URL. It is
24236 # not settable as a field in the request body.
24237 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
24238 &quot;status&quot;: { # [Output Only] The status of the URL map. # Output only. [Output Only] The status of the URL map.
24239 &quot;quotaUsage&quot;: { # Message representing the quota usage for a UrlMap. # Output only. Summary of quota usage for given UrlMap.
24240 &quot;forwardingRules&quot;: 42, # Output only. The number of forwarding rules that uses this UrlMap.
24241 &quot;units&quot;: &quot;A String&quot;, # Output only. The number of quota units calculated for this UrlMap.
24242 },
24243 },
24244 &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
24245 # maximum of 100 tests per UrlMap.
24246 #
24247 # Not supported when the URL map is bound to a target gRPC proxy that
24248 # has validateForProxyless field set to true.
24249 { # Message for the expected URL mappings.
24250 &quot;backendServiceWeight&quot;: 42, # The weight to use for the supplied host and path when using advanced
24251 # routing rules that involve traffic splitting.
24252 &quot;description&quot;: &quot;A String&quot;, # Description of this test case.
24253 &quot;expectedOutputUrl&quot;: &quot;A String&quot;, # The expected output URL evaluated by the load balancer
24254 # containing the scheme, host, path and query parameters.
24255 #
24256 # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
24257 # the load balancer to backends. For rules with urlRewrite,
24258 # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
24259 #
24260 # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer&#x27;s
24261 # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
24262 # If urlRedirect specifies strip_query, the test
24263 # passes only if expectedOutputUrl does not contain any query
24264 # parameters.
24265 #
24266 # expectedOutputUrl is optional whenservice is specified.
24267 &quot;expectedRedirectResponseCode&quot;: 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
24268 # load balancer&#x27;s redirect response.
24269 #
24270 # expectedRedirectResponseCode cannot be set whenservice is set.
24271 &quot;expectedUrlRedirect&quot;: &quot;A String&quot;, # The expected URL that should be redirected to for the host and path
24272 # being tested.
24273 # [Deprecated] This field is deprecated.
24274 # Use expected_output_url instead.
24275 &quot;headers&quot;: [ # HTTP headers for this request. If headers contains
24276 # a host header, then host must also match the header value.
24277 { # HTTP headers used in UrlMapTests.
24278 &quot;name&quot;: &quot;A String&quot;, # Header name.
24279 &quot;value&quot;: &quot;A String&quot;, # Header value.
24280 },
24281 ],
24282 &quot;host&quot;: &quot;A String&quot;, # Host portion of the URL. If headers contains a host header,
24283 # then host must also match the header value.
24284 &quot;path&quot;: &quot;A String&quot;, # Path portion of the URL.
24285 &quot;service&quot;: &quot;A String&quot;, # Expected BackendService or BackendBucket resource
24286 # the given URL should be mapped to.
24287 #
24288 # The service field cannot
24289 # be set if expectedRedirectResponseCode is set.
24290 },
24291 ],
24292 }
24293
24294 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
24295 that if you must retry your request, the server will know to ignore the
24296 request if it has already been completed.
24297
24298 For example, consider a situation where you make an initial request and
24299 the request times out. If you make the request again with the same
24300 request ID, the server can check if original operation with the same
24301 request ID was received, and if so, will ignore the second request. This
24302 prevents clients from accidentally creating duplicate commitments.
24303
24304 The request ID must be
24305 a valid UUID with the exception that zero UUID is not supported
24306 (00000000-0000-0000-0000-000000000000).
24307 x__xgafv: string, V1 error format.
24308 Allowed values
24309 1 - v1 error format
24310 2 - v2 error format
24311
24312 Returns:
24313 An object of the form:
24314
24315 { # Represents an Operation resource.
24316 #
24317 # Google Compute Engine has three Operation resources:
24318 #
24319 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
24320 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
24321 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
24322 #
24323 # You can use an operation resource to manage asynchronous API requests.
24324 # For more information, readHandling
24325 # API responses.
24326 #
24327 # Operations can be global, regional or zonal.
24328 #
24329 # - For global operations, use the `globalOperations`
24330 # resource.
24331 # - For regional operations, use the
24332 # `regionOperations` resource.
24333 # - For zonal operations, use
24334 # the `zoneOperations` resource.
24335 #
24336 #
24337 #
24338 # For more information, read
24339 # Global, Regional, and Zonal Resources.
24340 #
24341 # Note that completed Operation resources have a limited
24342 # retention period.
24343 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
24344 # Not present otherwise.
24345 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
24346 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
24347 # set when the operation is created.
24348 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
24349 # text format.
24350 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
24351 # this field will be populated.
24352 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
24353 # operation.
24354 {
24355 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
24356 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
24357 # details. There is a set of defined message types to use for providing
24358 # details.The syntax depends on the error code. For example,
24359 # QuotaExceededInfo will have details when the error code is
24360 # QUOTA_EXCEEDED.
24361 {
24362 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
24363 #
24364 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
24365 # is not enabled:
24366 #
24367 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
24368 # &quot;domain&quot;: &quot;googleapis.com&quot;
24369 # &quot;metadata&quot;: {
24370 # &quot;resource&quot;: &quot;projects/123&quot;,
24371 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
24372 # }
24373 # }
24374 #
24375 # This response indicates that the pubsub.googleapis.com API is not enabled.
24376 #
24377 # Example of an error that is returned when attempting to create a Spanner
24378 # instance in a region that is out of stock:
24379 #
24380 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
24381 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
24382 # &quot;metadata&quot;: {
24383 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
24384 # }
24385 # }
24386 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
24387 # is typically the registered service name of the tool or product that
24388 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
24389 # generated by some common infrastructure, the error domain must be a
24390 # globally unique value that identifies the infrastructure. For Google API
24391 # infrastructure, the error domain is &quot;googleapis.com&quot;.
24392 &quot;metadatas&quot;: { # Additional structured details about this error.
24393 #
24394 # Keys must match a regular expression of `a-z+` but should
24395 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
24396 # length. When identifying the current value of an exceeded limit, the units
24397 # should be contained in the key, not the value. For example, rather than
24398 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
24399 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
24400 # instances that can be created in a single (batch) request.
24401 &quot;a_key&quot;: &quot;A String&quot;,
24402 },
24403 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
24404 # proximate cause of the error. Error reasons are unique within a particular
24405 # domain of errors. This should be at most 63 characters and match a
24406 # regular expression of `A-Z+[A-Z0-9]`, which represents
24407 # UPPER_SNAKE_CASE.
24408 },
24409 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
24410 #
24411 # For example, if a quota check failed with an error indicating the calling
24412 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
24413 # directly to the right place in the developer console to flip the bit.
24414 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
24415 { # Describes a URL link.
24416 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
24417 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
24418 },
24419 ],
24420 },
24421 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
24422 # which can be attached to an RPC error.
24423 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
24424 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
24425 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
24426 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
24427 },
24428 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
24429 &quot;dimensions&quot;: { # The map holding related quota dimensions.
24430 &quot;a_key&quot;: &quot;A String&quot;,
24431 },
24432 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
24433 # type or metric.
24434 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
24435 # or metric.
24436 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
24437 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
24438 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
24439 },
24440 },
24441 ],
24442 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
24443 # This property is optional.
24444 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
24445 },
24446 ],
24447 },
24448 &quot;getVersionOperationMetadata&quot;: {
24449 &quot;inlineSbomInfo&quot;: {
24450 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
24451 # appropriate identifiers.
24452 &quot;a_key&quot;: &quot;A String&quot;,
24453 },
24454 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
24455 # identifiers.
24456 &quot;a_key&quot;: &quot;A String&quot;,
24457 },
24458 },
24459 },
24460 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
24461 # message that was returned, such as `NOT FOUND`.
24462 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
24463 # status code that was returned. For example, a `404` means the
24464 # resource was not found.
24465 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
24466 # defined by the server.
24467 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
24468 # This value is inRFC3339
24469 # text format.
24470 &quot;instancesBulkInsertOperationMetadata&quot;: {
24471 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
24472 # Example key: zones/us-central1-a
24473 &quot;a_key&quot;: {
24474 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
24475 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
24476 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
24477 # error.
24478 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
24479 # if the flow is rolling forward or rolling back.
24480 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
24481 },
24482 },
24483 },
24484 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
24485 # Operation resources.
24486 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
24487 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
24488 # group of operations results from a `bulkInsert` API request.
24489 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
24490 # `update`, or `delete`, and so on.
24491 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
24492 # There is no requirement that this be linear or support any granularity of
24493 # operations. This should not be used to guess when the operation will be
24494 # complete. This number should monotonically increase as the operation
24495 # progresses.
24496 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
24497 # applicable when performing regional operations.
24498 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
24499 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
24500 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
24501 # this field will contain information on all underlying zonal actions and
24502 # their state.
24503 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
24504 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
24505 # Example key: zones/us-central1-a
24506 &quot;a_key&quot;: {
24507 &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
24508 # populated.
24509 # different programming environments, including REST APIs and RPC APIs. It is
24510 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
24511 # three pieces of data: error code, error message, and error details.
24512 #
24513 # You can find out more about this error model and how to work with it in the
24514 # [API Design Guide](https://cloud.google.com/apis/design/errors).
24515 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
24516 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
24517 # message types for APIs to use.
24518 {
24519 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
24520 },
24521 ],
24522 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
24523 # user-facing error message should be localized and sent in the
24524 # google.rpc.Status.details field, or localized by the client.
24525 },
24526 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
24527 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
24528 },
24529 },
24530 },
24531 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
24532 # This value is inRFC3339
24533 # text format.
24534 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
24535 # following:
24536 # `PENDING`, `RUNNING`, or `DONE`.
24537 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
24538 # operation.
24539 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
24540 # of the target resource.
24541 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
24542 # operations related to creating a snapshot, this points to the disk
24543 # that the snapshot was created from.
24544 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
24545 # `[email protected]` or
24546 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
24547 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
24548 # operation, this field will be populated.
24549 {
24550 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
24551 # Engine returns NO_RESULTS_ON_PAGE if there
24552 # are no results in the response.
24553 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
24554 # value format. For example:
24555 #
24556 # &quot;data&quot;: [
24557 # {
24558 # &quot;key&quot;: &quot;scope&quot;,
24559 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
24560 # }
24561 {
24562 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
24563 # returned. For example, for warnings where there are no results in a list
24564 # request for a particular zone, this key might be scope and
24565 # the key value might be the zone name. Other examples might be a key
24566 # indicating a deprecated resource and a suggested replacement, or a
24567 # warning about invalid network settings (for example, if an instance
24568 # attempts to perform IP forwarding but is not enabled for IP forwarding).
24569 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
24570 },
24571 ],
24572 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
24573 },
24574 ],
24575 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
24576 # applicable when performing per-zone operations.
24577 }</pre>
24578 </div>
24579
24580 <div class="method">
24581 <code class="details" id="validate">validate(project, urlMap, body=None, x__xgafv=None)</code>
24582 <pre>Runs static validation for the UrlMap. In particular, the tests of the
24583 provided UrlMap will be run. Calling this method does NOT create the
24584 UrlMap.
24585
24586 Args:
24587 project: string, Project ID for this request. (required)
24588 urlMap: string, Name of the UrlMap resource to be validated as. (required)
24589 body: object, The request body.
24590 The object takes the form of:
24591
24592 {
24593 &quot;loadBalancingSchemes&quot;: [ # Specifies the load balancer type(s) this validation request is for. UseEXTERNAL_MANAGED for global external Application Load
24594 # Balancers and regional external Application Load Balancers.
24595 # Use EXTERNAL for classic Application Load Balancers.
24596 #
24597 # Use INTERNAL_MANAGED for internal Application Load Balancers. For more
24598 # information, refer to Choosing
24599 # a load balancer.
24600 #
24601 # If unspecified, the load balancing scheme will be inferred from the backend
24602 # service resources this URL map references. If that can not be inferred (for
24603 # example, this URL map only references backend buckets, or this Url map is
24604 # for rewrites and redirects only and doesn&#x27;t reference any backends),EXTERNAL will be used as the default type.
24605 #
24606 # If specified, the scheme(s) must not conflict with the load balancing
24607 # scheme of the backend service resources this Url map references.
24608 &quot;A String&quot;,
24609 ],
24610 &quot;resource&quot;: { # Represents a URL Map resource. # Content of the UrlMap to be validated.
24611 #
24612 # Compute Engine has two URL Map resources:
24613 #
24614 # * [Global](/compute/docs/reference/rest/alpha/urlMaps)
24615 # * [Regional](/compute/docs/reference/rest/alpha/regionUrlMaps)
24616 #
24617 # A URL map resource is a component of certain types of cloud load balancers
24618 # and Traffic Director:
24619 #
24620 # * urlMaps are used by global external Application Load
24621 # Balancers, classic Application Load Balancers, and cross-region internal
24622 # Application Load Balancers.
24623 # * regionUrlMaps are used by internal Application Load Balancers,
24624 # regional external Application Load Balancers and regional internal
24625 # Application Load Balancers.
24626 #
24627 # For a list of supported URL map features by the load balancer type, see the
24628 # Load balancing features: Routing and traffic management table.
24629 #
24630 # For a list of supported URL map features for Traffic Director, see the
24631 # Traffic Director features: Routing and traffic management table.
24632 #
24633 # This resource defines mappings from hostnames and URL paths to either a
24634 # backend service or a backend bucket.
24635 #
24636 # To use the global urlMaps resource, the backend service must
24637 # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
24638 # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
24639 # information, read URL
24640 # Map Concepts.
24641 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
24642 # text format.
24643 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
24644 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
24645 #
24646 # This policy takes
24647 # effect at the load balancer level and applies only when no policy has been
24648 # defined for the error code at lower levels like PathMatcher, RouteRule and
24649 # PathRule within this UrlMap.
24650 #
24651 # For example, consider a UrlMap with the
24652 # following configuration:
24653 #
24654 #
24655 # - defaultCustomErrorResponsePolicy containing policies for
24656 # responding to 5xx and 4xx errors
24657 # - A PathMatcher configured for *.example.com has
24658 # defaultCustomErrorResponsePolicy for 4xx.
24659 #
24660 # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
24661 # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
24662 # a request that does not match any host in *.example.com such
24663 # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
24664 # takes effect.
24665 #
24666 # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
24667 # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
24668 # a retry, if load balancer is successful in reaching the
24669 # service, the defaultCustomErrorResponsePolicy is ignored and
24670 # the response from the service is returned to the client.
24671 #
24672 # defaultCustomErrorResponsePolicy is supported only for
24673 # global external Application Load Balancers.
24674 # backend service or backend bucket responds with an error.
24675 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
24676 #
24677 # In a given policy, if you specify rules for both a range of error codes
24678 # as well as rules for specific error codes then rules with specific error
24679 # codes have a higher priority. For example, assume that you configure a rule
24680 # for 401 (Un-authorized) code, and another for all 4 series
24681 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
24682 # However if the backend service returns a 403, the rule for4xx takes effect.
24683 { # Specifies the mapping between the response code that will be returned along
24684 # with the custom error content and the response code returned by the backend
24685 # service.
24686 &quot;matchResponseCodes&quot;: [ # Valid values include:
24687 #
24688 #
24689 # - A number between 400 and 599: For example
24690 # 401 or 503, in which case the load balancer
24691 # applies the policy if the error code exactly matches this value.
24692 # - 5xx: Load Balancer will apply the policy if the
24693 # backend service responds with any response code in the range of
24694 # 500 to 599.
24695 # - 4xx: Load
24696 # Balancer will apply the policy if the backend service responds with any
24697 # response code in the range of 400 to
24698 # 499.
24699 #
24700 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
24701 &quot;A String&quot;,
24702 ],
24703 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
24704 # error content. If overrideResponseCode is not supplied, the
24705 # same response code returned by the original backend bucket or backend
24706 # service is returned to the client.
24707 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
24708 #
24709 # path must start
24710 # with a leading slash. path cannot have trailing slashes.
24711 #
24712 # If the file is not available in backendBucket or the
24713 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
24714 #
24715 # The value must
24716 # be from 1 to 1024 characters
24717 },
24718 ],
24719 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
24720 # contains the custom error content. Examples are:
24721 #
24722 #
24723 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
24724 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
24725 # - global/backendBuckets/myBackendBucket
24726 #
24727 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
24728 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
24729 #
24730 # If load balancer cannot reach
24731 # the backendBucket, a simple Not Found Error will
24732 # be returned, with the original response code (oroverrideResponseCode if configured).
24733 #
24734 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
24735 },
24736 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
24737 # hostRules match. The load balancer performs advanced routing
24738 # actions, such as URL rewrites and header transformations, before forwarding
24739 # the request to the selected backend.
24740 #
24741 #
24742 # Only one of defaultUrlRedirect, defaultService
24743 # or defaultRouteAction.weightedBackendService can be set.
24744 #
24745 #
24746 # URL maps for classic Application Load Balancers only support
24747 # the urlRewrite action within defaultRouteAction.
24748 #
24749 #
24750 # defaultRouteAction has no effect when the URL map is bound
24751 # to a target gRPC proxy that has the validateForProxyless field
24752 # set to true.
24753 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
24754 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
24755 # property must be specified. This policy cannot be specified if any target
24756 # backend has Identity-Aware Proxy enabled.
24757 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
24758 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
24759 # header names can be specified. The cache is bypassed for all `cacheMode`
24760 # values.
24761 &quot;A String&quot;,
24762 ],
24763 &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
24764 # on the backend type: for Backend Services, the complete request URI is
24765 # used; for Backend Buckets, the request URI is used without the protocol or
24766 # host, and only query parameters known to Cloud Storage are included.
24767 # Policy defined on Route Action.
24768 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
24769 # parameters will be included. Either specify `excludedQueryParameters`
24770 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
24771 # encoded and not treated as delimiters.
24772 #
24773 # Note: This field applies to routes that use backend services. Attempting
24774 # to set it on a route that points exclusively to Backend Buckets will
24775 # result in a configuration error. For routes that point to a Backend
24776 # Bucket, use `includedQueryParameters` to define which parameters should
24777 # be part of the cache key.
24778 &quot;A String&quot;,
24779 ],
24780 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
24781 #
24782 # Note: This setting is only applicable to routes that use a Backend
24783 # Service. It does not affect requests served by a Backend Bucket, as the
24784 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
24785 # it on a route that points exclusively to Backend Buckets will result in a
24786 # configuration error.
24787 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
24788 #
24789 # Note: This setting is only applicable to routes that use a Backend
24790 # Service. It does not affect requests served by a Backend Bucket, as the
24791 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
24792 # set on a route that points exclusively to Backend Buckets will result in
24793 # a configuration error.
24794 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
24795 # `includedQueryParameters` and `excludedQueryParameters`. If neither
24796 # is set, the entire query string will be included. If false, the query
24797 # string will be excluded from the cache key entirely.
24798 #
24799 # Note: This field applies to routes that use backend services. Attempting
24800 # to set it on a route that points exclusively to Backend Buckets will
24801 # result in a configuration error. For routes that point to a Backend
24802 # Bucket, use `includedQueryParameters` to define which parameters should
24803 # be part of the cache key.
24804 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
24805 # The name=value pair will be used in the cache key Cloud CDN generates.
24806 #
24807 # Note: This setting is only applicable to routes that use a Backend
24808 # Service. It does not affect requests served by a Backend Bucket.
24809 # Attempting to set it on a route that points exclusively to Backend
24810 # Buckets will result in a configuration error. Up to 5 cookie names can be
24811 # specified.
24812 &quot;A String&quot;,
24813 ],
24814 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
24815 &quot;A String&quot;,
24816 ],
24817 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
24818 # parameters will be excluded. Either specify `includedQueryParameters`
24819 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
24820 # encoded and not treated as delimiters.
24821 &quot;A String&quot;,
24822 ],
24823 },
24824 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
24825 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
24826 &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
24827 # content. This is used to clamp the max-age (or Expires) value sent to the
24828 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
24829 # is used for the response max-age directive, along with a &quot;public&quot;
24830 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
24831 # clamps the max-age from the origin (if specified), or else sets the
24832 # response max-age directive to the lesser of the `clientTtl` and
24833 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
24834 # present. The maximum allowed value is 31,622,400s (1 year). If not
24835 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
24836 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
24837 # `USE_ORIGIN_HEADERS`.
24838 # as a count of seconds and fractions of seconds at nanosecond
24839 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
24840 # or &quot;month&quot;. Range is approximately 10,000 years.
24841 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
24842 # Durations less than one second are represented with a 0
24843 # `seconds` field and a positive `nanos` field. Must be from 0
24844 # to 999,999,999 inclusive.
24845 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
24846 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
24847 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
24848 },
24849 &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
24850 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
24851 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
24852 # greater than that of `maxTtl`. When the `cacheMode` is set to
24853 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
24854 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
24855 # accessed objects may be evicted from the cache before the defined TTL. If
24856 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
24857 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
24858 # `USE_ORIGIN_HEADERS`.
24859 # as a count of seconds and fractions of seconds at nanosecond
24860 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
24861 # or &quot;month&quot;. Range is approximately 10,000 years.
24862 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
24863 # Durations less than one second are represented with a 0
24864 # `seconds` field and a positive `nanos` field. Must be from 0
24865 # to 999,999,999 inclusive.
24866 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
24867 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
24868 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
24869 },
24870 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
24871 # attempt to set a max-age or s-maxage higher than this, or an Expires header
24872 # more than `maxTtl` seconds in the future will be capped at the value of
24873 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
24874 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
24875 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
24876 # Infrequently accessed objects may be evicted from the cache before the
24877 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
24878 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
24879 # mode.
24880 # as a count of seconds and fractions of seconds at nanosecond
24881 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
24882 # or &quot;month&quot;. Range is approximately 10,000 years.
24883 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
24884 # Durations less than one second are represented with a 0
24885 # `seconds` field and a positive `nanos` field. Must be from 0
24886 # to 999,999,999 inclusive.
24887 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
24888 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
24889 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
24890 },
24891 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
24892 # to apply fine-grained caching for common errors or redirects.
24893 # This can reduce the load on your origin and improve end-user
24894 # experience by reducing response latency.
24895 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
24896 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
24897 # the specified response code that lack any Cache-Control, Expires, or
24898 # Pragma: no-cache directives. When the `cacheMode` is set to
24899 # `FORCE_CACHE_ALL`, negative caching applies to all responses
24900 # with the specified response code, and overrides any caching headers. By
24901 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
24902 #
24903 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
24904 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
24905 # * 405 (Method Not Found), 501 (Not Implemented): 60s
24906 #
24907 # These defaults can be overridden in `negativeCachingPolicy`.
24908 # If not specified, Cloud CDN applies negative caching by default.
24909 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
24910 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
24911 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
24912 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
24913 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
24914 # all response codes that you wish to cache. Cloud CDN will not apply any
24915 # default negative caching when a policy exists.
24916 { # Specify CDN TTLs for response error codes.
24917 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
24918 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
24919 # specified as values, and you cannot specify a status code more than
24920 # once.
24921 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
24922 # corresponding status code.
24923 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
24924 # objects may be evicted from the cache before the defined TTL.
24925 # as a count of seconds and fractions of seconds at nanosecond
24926 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
24927 # or &quot;month&quot;. Range is approximately 10,000 years.
24928 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
24929 # Durations less than one second are represented with a 0
24930 # `seconds` field and a positive `nanos` field. Must be from 0
24931 # to 999,999,999 inclusive.
24932 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
24933 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
24934 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
24935 },
24936 },
24937 ],
24938 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
24939 # requests into a small number of requests to the origin. If not specified,
24940 # Cloud CDN applies request coalescing by default.
24941 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
24942 # content with the origin, or when an error is encountered when refreshing
24943 # the cache.
24944 # This setting defines the default &quot;max-stale&quot; duration for any cached
24945 # responses that do not specify a max-stale directive. Stale responses that
24946 # exceed the TTL configured here will not be served. The default limit
24947 # (max-stale) is 86400s (1 day), which will allow stale content to be
24948 # served up to this limit beyond the max-age (or s-maxage) of a cached
24949 # response.
24950 # The maximum allowed value is 604800 (1 week).
24951 # Set this to zero (0) to disable serve-while-stale.
24952 # as a count of seconds and fractions of seconds at nanosecond
24953 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
24954 # or &quot;month&quot;. Range is approximately 10,000 years.
24955 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
24956 # Durations less than one second are represented with a 0
24957 # `seconds` field and a positive `nanos` field. Must be from 0
24958 # to 999,999,999 inclusive.
24959 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
24960 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
24961 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
24962 },
24963 },
24964 &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
24965 # information about the W3C recommendation for cross-origin resource sharing
24966 # (CORS), see Fetch API Living
24967 # Standard.
24968 #
24969 # Not supported when the URL map is bound to a target gRPC proxy.
24970 # information about the W3C recommendation for cross-origin resource sharing
24971 # (CORS), see Fetch API Living
24972 # Standard.
24973 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
24974 # indicates that
24975 # the actual request can include user credentials. This field translates to
24976 # the Access-Control-Allow-Credentials header.
24977 #
24978 # Default is false.
24979 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
24980 # header.
24981 &quot;A String&quot;,
24982 ],
24983 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
24984 # header.
24985 &quot;A String&quot;,
24986 ],
24987 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
24988 # more information, see regular expression syntax.
24989 #
24990 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
24991 #
24992 # Regular expressions can only be used when the loadBalancingScheme is
24993 # set to INTERNAL_SELF_MANAGED.
24994 &quot;A String&quot;,
24995 ],
24996 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
24997 #
24998 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
24999 &quot;A String&quot;,
25000 ],
25001 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
25002 # The default value is false, which indicates that the CORS
25003 # policy is in effect.
25004 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
25005 # header.
25006 &quot;A String&quot;,
25007 ],
25008 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
25009 # seconds. This field translates to the Access-Control-Max-Age
25010 # header.
25011 },
25012 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
25013 # the resiliency of clients to backend service failure. As part of fault
25014 # injection, when clients send requests to a backend service, delays can be
25015 # introduced by a load balancer on a percentage of requests before sending
25016 # those requests to the backend service. Similarly requests from clients can
25017 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
25018 # that are configured with a fault_injection_policy if:
25019 # 1. The traffic is generated by fault injection AND
25020 # 2. The fault injection is not a delay fault injection.
25021 # Fault injection is not supported with the classic Application Load Balancer
25022 # . To see which load balancers support fault injection,
25023 # see Load
25024 # balancing: Routing and traffic management features.
25025 # the resiliency of clients to backend service failure. As part of fault
25026 # injection, when clients send requests to a backend service, delays can be
25027 # introduced by the load balancer on a percentage of requests before sending
25028 # those request to the backend service. Similarly requests from clients can be
25029 # aborted by the load balancer for a percentage of requests.
25030 &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
25031 # injection.
25032 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
25033 #
25034 # The value must be from 200 to 599 inclusive.
25035 #
25036 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
25037 # according to this
25038 # mapping table. HTTP status 200 is mapped to gRPC status
25039 # UNKNOWN. Injecting an OK status is currently not supported by
25040 # Traffic Director.
25041 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
25042 # that is aborted as part of fault injection.
25043 #
25044 # The value must be from 0.0 to 100.0 inclusive.
25045 },
25046 &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
25047 # injection, before being sent to a backend service.
25048 # request to the backend service as part of fault injection.
25049 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
25050 # as a count of seconds and fractions of seconds at nanosecond
25051 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
25052 # or &quot;month&quot;. Range is approximately 10,000 years.
25053 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
25054 # Durations less than one second are represented with a 0
25055 # `seconds` field and a positive `nanos` field. Must be from 0
25056 # to 999,999,999 inclusive.
25057 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
25058 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
25059 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
25060 },
25061 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
25062 # which a delay is introduced as part of fault injection.
25063 #
25064 # The value must be from 0.0 to 100.0 inclusive.
25065 },
25066 },
25067 &quot;imageOptimizationPolicy&quot;: { # The configuration for Cloud CDN&#x27;s image optimization feature. This feature # Image optimization policy for this URL Map&#x27;s route. Available only for
25068 # Global EXTERNAL_MANAGED load balancer schemes.
25069 # Either Cloud CDN must be enabled on the backend service or backend bucket
25070 # serving the route, or cache policy must be configured on the same route
25071 # dynamically processes and delivers images from the network edge.
25072 # Image Optimization is only available for Global External Application Load
25073 # Balancers.
25074 # Either Cloud CDN must be enabled on the backend service or backend bucket
25075 # serving the route, or cache policy must be configured on the same route.
25076 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
25077 },
25078 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
25079 # Unlike the timeout field where the timeout duration starts
25080 # from the time the request has been fully processed (known as*end-of-stream*),
25081 # the duration in this field is computed from the beginning of the stream
25082 # until the response has been processed, including all retries. A
25083 # stream that does not complete in this duration is closed.
25084 #
25085 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
25086 # with the route.
25087 #
25088 # This field is only allowed if the Url map is used with backend services
25089 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
25090 # as a count of seconds and fractions of seconds at nanosecond
25091 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
25092 # or &quot;month&quot;. Range is approximately 10,000 years.
25093 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
25094 # Durations less than one second are represented with a 0
25095 # `seconds` field and a positive `nanos` field. Must be from 0
25096 # to 999,999,999 inclusive.
25097 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
25098 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
25099 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
25100 },
25101 &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
25102 # are shadowed to a separate mirrored backend service. The load balancer does
25103 # not wait for responses from the shadow service. Before sending traffic
25104 # to the shadow service, the host / authority header is suffixed with-shadow.
25105 #
25106 # Not supported when the URL map is bound to a target gRPC proxy that
25107 # has the validateForProxyless field set to true.
25108 # are shadowed to a separate mirrored backend service. The load balancer
25109 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
25110 # to the shadow service, the host or authority header is suffixed with-shadow.
25111 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
25112 # mirrored to.
25113 #
25114 # The backend service configured for a mirroring
25115 # policy must reference backends that are of the same type as the original
25116 # backend service matched in the URL map.
25117 #
25118 # Serverless NEG backends are not currently supported as a mirrored
25119 # backend service.
25120 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
25121 },
25122 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
25123 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
25124 # If not specified, defaults to 1.
25125 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
25126 #
25127 # If not specified, will use the timeout set in theHttpRouteAction field.
25128 # If timeout in the HttpRouteAction field is not set, this field
25129 # uses the largest timeout
25130 # among all backend services associated with the route.
25131 #
25132 # Not supported when the URL map is bound to a target gRPC proxy that
25133 # has the validateForProxyless field set to true.
25134 # as a count of seconds and fractions of seconds at nanosecond
25135 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
25136 # or &quot;month&quot;. Range is approximately 10,000 years.
25137 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
25138 # Durations less than one second are represented with a 0
25139 # `seconds` field and a positive `nanos` field. Must be from 0
25140 # to 999,999,999 inclusive.
25141 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
25142 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
25143 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
25144 },
25145 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
25146 # values are:
25147 #
25148 # - 5xx: retry is attempted if the instance or endpoint
25149 # responds with any 5xx response code, or if the instance or
25150 # endpoint does not respond at all. For example, disconnects, reset, read
25151 # timeout, connection failure, and refused streams.
25152 # - gateway-error: Similar to 5xx, but only
25153 # applies to response codes 502, 503 or504.
25154 # - connect-failure: a retry is attempted on failures
25155 # connecting to the instance or endpoint. For example, connection
25156 # timeouts.
25157 # - retriable-4xx: a retry is attempted if the instance
25158 # or endpoint responds with a 4xx response code.
25159 # The only error that you can retry is error code 409.
25160 # - refused-stream: a retry is attempted if the instance
25161 # or endpoint resets the stream with a REFUSED_STREAM error
25162 # code. This reset type indicates that it is safe to retry.
25163 # - cancelled: a retry is attempted if the gRPC status
25164 # code in the response header is set to cancelled.
25165 # - deadline-exceeded: a retry is attempted if the gRPC
25166 # status code in the response header is set todeadline-exceeded.
25167 # - internal: a retry is attempted if the gRPC
25168 # status code in the response header is set tointernal.
25169 # - resource-exhausted: a retry is attempted if the gRPC
25170 # status code in the response header is set toresource-exhausted.
25171 # - unavailable: a retry is attempted if the gRPC
25172 # status code in the response header is set tounavailable.
25173 #
25174 # Only the following codes are supported when the URL map is bound to
25175 # target gRPC proxy that has validateForProxyless field set to true.
25176 #
25177 # - cancelled
25178 # - deadline-exceeded
25179 # - internal
25180 # - resource-exhausted
25181 # - unavailable
25182 &quot;A String&quot;,
25183 ],
25184 },
25185 &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
25186 # time the request has been fully processed (known as *end-of-stream*)
25187 # up until the response has been processed. Timeout includes
25188 # all retries.
25189 #
25190 # If not specified, this field uses the largest timeout among all backend
25191 # services associated with the route.
25192 #
25193 # Not supported when the URL map is bound to a target gRPC proxy that
25194 # has validateForProxyless field set to true.
25195 # as a count of seconds and fractions of seconds at nanosecond
25196 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
25197 # or &quot;month&quot;. Range is approximately 10,000 years.
25198 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
25199 # Durations less than one second are represented with a 0
25200 # `seconds` field and a positive `nanos` field. Must be from 0
25201 # to 999,999,999 inclusive.
25202 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
25203 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
25204 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
25205 },
25206 &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
25207 # to the matched service.
25208 #
25209 # urlRewrite is the only action supported in UrlMaps
25210 # for classic Application Load Balancers.
25211 #
25212 # Not supported when the URL map is bound to a target gRPC proxy that
25213 # has the validateForProxyless field set to true.
25214 # backend service.
25215 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
25216 # host header is replaced with contents of hostRewrite.
25217 #
25218 # The value must be from 1 to 255 characters.
25219 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
25220 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
25221 #
25222 # The value must be from 1 to 1024 characters.
25223 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
25224 # header) using the HTTP template syntax.
25225 #
25226 # A corresponding
25227 # path_template_match must be specified. Any template variables must exist in
25228 # the path_template_match field.
25229 #
25230 #
25231 # - -At least one variable must be specified in the path_template_match
25232 # field
25233 # - You can omit variables from the rewritten URL
25234 # - The * and ** operators cannot be matched
25235 # unless they have a corresponding variable name - e.g.
25236 # {format=*} or {var=**}.
25237 #
25238 # For example, a path_template_match of /static/{format=**}
25239 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
25240 # rewrite, so that /{country}/{format}/{suffix=**} can be
25241 # rewritten as /content/{format}/{country}/{suffix}.
25242 #
25243 # At least
25244 # one non-empty routeRules[].matchRules[].path_template_match is
25245 # required.
25246 #
25247 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
25248 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
25249 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
25250 # It uses RE2 syntax with the following constraints:
25251 #
25252 #
25253 # - Any single character operators
25254 # - Groups are allowed to have only submatch operator inside
25255 # - Groups are allowed only without any char repetition, e.g.
25256 # .*
25257 # - Any char repetition, e.g. .*, is
25258 # only allowed to be used in a single regex together with:
25259 #
25260 #
25261 # - Empty string operators
25262 # - Other repetitions
25263 # - Ranges
25264 # - Repetitions of ranges
25265 #
25266 #
25267 # - Ranges are only allowed to have:
25268 #
25269 #
25270 # - Character range
25271 # - Digits range
25272 # - Symbols listed in characters allowed for ranges
25273 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
25274 # the path.
25275 },
25276 },
25277 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
25278 # occurs. The weights determine the fraction of traffic that flows to
25279 # their corresponding backend service. If all traffic needs to
25280 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
25281 #
25282 # After a backend service is identified and before forwarding
25283 # the request to
25284 # the backend service, advanced routing actions such as URL rewrites and
25285 # header transformations are applied depending on additional settings
25286 # specified in this HttpRouteAction.
25287 { # In contrast to a single BackendService in
25288 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
25289 # multiple backend services. The volume of traffic for each
25290 # backend service is proportional to the weight specified
25291 # in each WeightedBackendService
25292 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
25293 # resource. Before
25294 # forwarding the request to backendService, the load balancer
25295 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
25296 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
25297 # effect for the selected backendService.
25298 #
25299 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
25300 #
25301 # headerAction is not supported for load balancers that have
25302 # their loadBalancingScheme set to EXTERNAL.
25303 #
25304 # Not supported when the URL map is bound to a target gRPC proxy that
25305 # has validateForProxyless field set to true.
25306 # the request is passed along to the selected backendService.
25307 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
25308 { # Specification determining how headers are added to requests or responses.
25309 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
25310 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
25311 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
25312 # that already
25313 # exist for the header. If true, headerValue is set for the
25314 # header, discarding any values that were set for that header.
25315 #
25316 # The default value is true,
25317 # unless a variable is present in headerValue,
25318 # in which case the default value is false.
25319 # .
25320 },
25321 ],
25322 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
25323 # request before forwarding the request to the backendService.
25324 &quot;A String&quot;,
25325 ],
25326 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
25327 # client.
25328 { # Specification determining how headers are added to requests or responses.
25329 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
25330 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
25331 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
25332 # that already
25333 # exist for the header. If true, headerValue is set for the
25334 # header, discarding any values that were set for that header.
25335 #
25336 # The default value is true,
25337 # unless a variable is present in headerValue,
25338 # in which case the default value is false.
25339 # .
25340 },
25341 ],
25342 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
25343 # response before sending the response back to the client.
25344 &quot;A String&quot;,
25345 ],
25346 },
25347 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
25348 # computed asweight / (sum of all weightedBackendService weights in routeAction).
25349 #
25350 # The selection of a backend service is determined only for new traffic.
25351 # Once a user&#x27;s request has been directed to a backend service,
25352 # subsequent requests are sent to the same backend service as
25353 # determined by the backend service&#x27;s session affinity policy.
25354 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
25355 # splitting. If you do, the weighted traffic splitting configuration takes
25356 # precedence.
25357 #
25358 # The value must be from 0 to 1000.
25359 },
25360 ],
25361 },
25362 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL of the defaultService resource to
25363 # which traffic is directed if none of the hostRules match.
25364 # If defaultRouteAction is also specified, advanced
25365 # routing actions, such as URL rewrites, take effect before sending the
25366 # request to the backend.
25367 #
25368 #
25369 # Only one of defaultUrlRedirect, defaultService
25370 # or defaultRouteAction.weightedBackendService can be set.
25371 #
25372 #
25373 # defaultService has no effect when the URL map is bound
25374 # to a target gRPC proxy that has the validateForProxyless field
25375 # set to true.
25376 &quot;defaultUrlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
25377 # is redirected to a URL specified by defaultUrlRedirect.
25378 #
25379 #
25380 # Only one of defaultUrlRedirect, defaultService
25381 # or defaultRouteAction.weightedBackendService can be set.
25382 #
25383 #
25384 # Not supported when the URL map is bound to a target gRPC proxy.
25385 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
25386 # was supplied in the request.
25387 #
25388 # The value must be from 1 to 255
25389 # characters.
25390 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
25391 # set to HTTPS.
25392 # If set to false, the URL scheme of the redirected request
25393 # remains the same as that of the request.
25394 #
25395 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
25396 #
25397 # The default is set to false.
25398 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
25399 # that was supplied in the request.
25400 #
25401 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
25402 # supplied, the path of the original request is used for the redirect.
25403 #
25404 # The value must be from 1 to 1024 characters.
25405 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
25406 # the HttpRouteRuleMatch, retaining the remaining portion
25407 # of the URL before redirecting the request.
25408 #
25409 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
25410 # supplied, the path of the original request is used for the redirect.
25411 #
25412 # The value must be from 1 to 1024 characters.
25413 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
25414 #
25415 # Supported values are:
25416 #
25417 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
25418 # to 301.
25419 # - FOUND, which corresponds to 302.
25420 # - SEE_OTHER which corresponds to 303.
25421 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
25422 # method is retained.
25423 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
25424 # method is retained.
25425 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
25426 # URL is
25427 # removed before redirecting the request. If set to false, the
25428 # query portion of the original URL is retained.
25429 #
25430 # The default is set to false.
25431 },
25432 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
25433 # create the resource.
25434 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. A hash of the contents stored in this object.
25435 # This field is used in optimistic locking. This field is ignored when
25436 # inserting a UrlMap. An up-to-date fingerprint must be provided
25437 # in order to update the UrlMap, otherwise the request will
25438 # fail with error 412 conditionNotMet.
25439 #
25440 # To see the latest fingerprint, make a get() request to
25441 # retrieve a UrlMap.
25442 &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
25443 # for the selected backendService.
25444 #
25445 # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
25446 #
25447 # headerAction is not supported for load balancers
25448 # that have
25449 # their loadBalancingScheme set to EXTERNAL.
25450 #
25451 # Not supported when the URL map is bound to a target gRPC proxy that
25452 # has validateForProxyless field set to true.
25453 # the request is passed along to the selected backendService.
25454 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
25455 { # Specification determining how headers are added to requests or responses.
25456 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
25457 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
25458 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
25459 # that already
25460 # exist for the header. If true, headerValue is set for the
25461 # header, discarding any values that were set for that header.
25462 #
25463 # The default value is true,
25464 # unless a variable is present in headerValue,
25465 # in which case the default value is false.
25466 # .
25467 },
25468 ],
25469 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
25470 # request before forwarding the request to the backendService.
25471 &quot;A String&quot;,
25472 ],
25473 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
25474 # client.
25475 { # Specification determining how headers are added to requests or responses.
25476 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
25477 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
25478 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
25479 # that already
25480 # exist for the header. If true, headerValue is set for the
25481 # header, discarding any values that were set for that header.
25482 #
25483 # The default value is true,
25484 # unless a variable is present in headerValue,
25485 # in which case the default value is false.
25486 # .
25487 },
25488 ],
25489 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
25490 # response before sending the response back to the client.
25491 &quot;A String&quot;,
25492 ],
25493 },
25494 &quot;hostRules&quot;: [ # The list of host rules to use against the URL.
25495 { # UrlMaps
25496 # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
25497 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
25498 # create the resource.
25499 &quot;hosts&quot;: [ # The list of host patterns to match. They must be valid hostnames with
25500 # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
25501 # that case, * must be the first character, and if followed by
25502 # anything, the immediate following character must be either -
25503 # or ..
25504 #
25505 # * based matching is not supported when the URL map is bound
25506 # to a target gRPC proxy that has the validateForProxyless field
25507 # set to true.
25508 &quot;A String&quot;,
25509 ],
25510 &quot;pathMatcher&quot;: &quot;A String&quot;, # The name of the PathMatcher to use to match the path portion
25511 # of the URL if the hostRule matches the URL&#x27;s host portion.
25512 },
25513 ],
25514 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the resource. This identifier is
25515 # defined by the server.
25516 &quot;kind&quot;: &quot;compute#urlMap&quot;, # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
25517 # url maps.
25518 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
25519 # The name must be 1-63 characters long, and comply withRFC1035.
25520 # Specifically, the name must be 1-63 characters long and match the regular
25521 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
25522 # character must be a lowercase letter, and all following characters must
25523 # be a dash, lowercase letter, or digit, except the last character, which
25524 # cannot be a dash.
25525 &quot;pathMatchers&quot;: [ # The list of named PathMatchers to use against the URL.
25526 { # A matcher for the path portion of the URL. The BackendService
25527 # from the longest-matched rule will serve the URL. If no rule was matched, the
25528 # default service is used.
25529 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
25530 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
25531 #
25532 # This policy takes
25533 # effect at the PathMatcher level and applies only when no
25534 # 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
25535 # in defaultCustomErrorResponsePolicy, then a policy defined for
25536 # the error code in UrlMap.defaultCustomErrorResponsePolicy
25537 # takes effect.
25538 #
25539 # For example, consider a UrlMap with the following
25540 # configuration:
25541 #
25542 #
25543 # - UrlMap.defaultCustomErrorResponsePolicy is configured
25544 # with policies for 5xx and 4xx errors
25545 # - A RouteRule for /coming_soon/ is configured for the
25546 # error code 404.
25547 #
25548 # 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
25549 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
25550 # the policy in RouteRule.customErrorResponsePolicy takes
25551 # effect. If any of the requests in this example encounter a 500
25552 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
25553 #
25554 # When
25555 # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
25556 # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
25557 # a retry, if load balancer is successful in reaching the
25558 # service, the defaultCustomErrorResponsePolicy is ignored and
25559 # the response from the service is returned to the client.
25560 #
25561 # defaultCustomErrorResponsePolicy is supported only for
25562 # global external Application Load Balancers.
25563 # backend service or backend bucket responds with an error.
25564 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
25565 #
25566 # In a given policy, if you specify rules for both a range of error codes
25567 # as well as rules for specific error codes then rules with specific error
25568 # codes have a higher priority. For example, assume that you configure a rule
25569 # for 401 (Un-authorized) code, and another for all 4 series
25570 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
25571 # However if the backend service returns a 403, the rule for4xx takes effect.
25572 { # Specifies the mapping between the response code that will be returned along
25573 # with the custom error content and the response code returned by the backend
25574 # service.
25575 &quot;matchResponseCodes&quot;: [ # Valid values include:
25576 #
25577 #
25578 # - A number between 400 and 599: For example
25579 # 401 or 503, in which case the load balancer
25580 # applies the policy if the error code exactly matches this value.
25581 # - 5xx: Load Balancer will apply the policy if the
25582 # backend service responds with any response code in the range of
25583 # 500 to 599.
25584 # - 4xx: Load
25585 # Balancer will apply the policy if the backend service responds with any
25586 # response code in the range of 400 to
25587 # 499.
25588 #
25589 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
25590 &quot;A String&quot;,
25591 ],
25592 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
25593 # error content. If overrideResponseCode is not supplied, the
25594 # same response code returned by the original backend bucket or backend
25595 # service is returned to the client.
25596 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
25597 #
25598 # path must start
25599 # with a leading slash. path cannot have trailing slashes.
25600 #
25601 # If the file is not available in backendBucket or the
25602 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
25603 #
25604 # The value must
25605 # be from 1 to 1024 characters
25606 },
25607 ],
25608 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
25609 # contains the custom error content. Examples are:
25610 #
25611 #
25612 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
25613 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
25614 # - global/backendBuckets/myBackendBucket
25615 #
25616 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
25617 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
25618 #
25619 # If load balancer cannot reach
25620 # the backendBucket, a simple Not Found Error will
25621 # be returned, with the original response code (oroverrideResponseCode if configured).
25622 #
25623 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
25624 },
25625 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
25626 # pathRules or routeRules match. The load balancer
25627 # performs advanced routing actions, such as URL rewrites and
25628 # header transformations, before forwarding the request to the
25629 # selected backend.
25630 #
25631 #
25632 # Only one of defaultUrlRedirect, defaultService
25633 # or defaultRouteAction.weightedBackendService can be set.
25634 #
25635 #
25636 # URL maps for classic Application Load Balancers only support
25637 # the urlRewrite action within a path matcher&#x27;sdefaultRouteAction.
25638 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
25639 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
25640 # property must be specified. This policy cannot be specified if any target
25641 # backend has Identity-Aware Proxy enabled.
25642 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
25643 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
25644 # header names can be specified. The cache is bypassed for all `cacheMode`
25645 # values.
25646 &quot;A String&quot;,
25647 ],
25648 &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
25649 # on the backend type: for Backend Services, the complete request URI is
25650 # used; for Backend Buckets, the request URI is used without the protocol or
25651 # host, and only query parameters known to Cloud Storage are included.
25652 # Policy defined on Route Action.
25653 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
25654 # parameters will be included. Either specify `excludedQueryParameters`
25655 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
25656 # encoded and not treated as delimiters.
25657 #
25658 # Note: This field applies to routes that use backend services. Attempting
25659 # to set it on a route that points exclusively to Backend Buckets will
25660 # result in a configuration error. For routes that point to a Backend
25661 # Bucket, use `includedQueryParameters` to define which parameters should
25662 # be part of the cache key.
25663 &quot;A String&quot;,
25664 ],
25665 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
25666 #
25667 # Note: This setting is only applicable to routes that use a Backend
25668 # Service. It does not affect requests served by a Backend Bucket, as the
25669 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
25670 # it on a route that points exclusively to Backend Buckets will result in a
25671 # configuration error.
25672 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
25673 #
25674 # Note: This setting is only applicable to routes that use a Backend
25675 # Service. It does not affect requests served by a Backend Bucket, as the
25676 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
25677 # set on a route that points exclusively to Backend Buckets will result in
25678 # a configuration error.
25679 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
25680 # `includedQueryParameters` and `excludedQueryParameters`. If neither
25681 # is set, the entire query string will be included. If false, the query
25682 # string will be excluded from the cache key entirely.
25683 #
25684 # Note: This field applies to routes that use backend services. Attempting
25685 # to set it on a route that points exclusively to Backend Buckets will
25686 # result in a configuration error. For routes that point to a Backend
25687 # Bucket, use `includedQueryParameters` to define which parameters should
25688 # be part of the cache key.
25689 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
25690 # The name=value pair will be used in the cache key Cloud CDN generates.
25691 #
25692 # Note: This setting is only applicable to routes that use a Backend
25693 # Service. It does not affect requests served by a Backend Bucket.
25694 # Attempting to set it on a route that points exclusively to Backend
25695 # Buckets will result in a configuration error. Up to 5 cookie names can be
25696 # specified.
25697 &quot;A String&quot;,
25698 ],
25699 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
25700 &quot;A String&quot;,
25701 ],
25702 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
25703 # parameters will be excluded. Either specify `includedQueryParameters`
25704 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
25705 # encoded and not treated as delimiters.
25706 &quot;A String&quot;,
25707 ],
25708 },
25709 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
25710 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
25711 &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
25712 # content. This is used to clamp the max-age (or Expires) value sent to the
25713 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
25714 # is used for the response max-age directive, along with a &quot;public&quot;
25715 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
25716 # clamps the max-age from the origin (if specified), or else sets the
25717 # response max-age directive to the lesser of the `clientTtl` and
25718 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
25719 # present. The maximum allowed value is 31,622,400s (1 year). If not
25720 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
25721 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
25722 # `USE_ORIGIN_HEADERS`.
25723 # as a count of seconds and fractions of seconds at nanosecond
25724 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
25725 # or &quot;month&quot;. Range is approximately 10,000 years.
25726 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
25727 # Durations less than one second are represented with a 0
25728 # `seconds` field and a positive `nanos` field. Must be from 0
25729 # to 999,999,999 inclusive.
25730 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
25731 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
25732 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
25733 },
25734 &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
25735 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
25736 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
25737 # greater than that of `maxTtl`. When the `cacheMode` is set to
25738 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
25739 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
25740 # accessed objects may be evicted from the cache before the defined TTL. If
25741 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
25742 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
25743 # `USE_ORIGIN_HEADERS`.
25744 # as a count of seconds and fractions of seconds at nanosecond
25745 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
25746 # or &quot;month&quot;. Range is approximately 10,000 years.
25747 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
25748 # Durations less than one second are represented with a 0
25749 # `seconds` field and a positive `nanos` field. Must be from 0
25750 # to 999,999,999 inclusive.
25751 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
25752 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
25753 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
25754 },
25755 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
25756 # attempt to set a max-age or s-maxage higher than this, or an Expires header
25757 # more than `maxTtl` seconds in the future will be capped at the value of
25758 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
25759 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
25760 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
25761 # Infrequently accessed objects may be evicted from the cache before the
25762 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
25763 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
25764 # mode.
25765 # as a count of seconds and fractions of seconds at nanosecond
25766 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
25767 # or &quot;month&quot;. Range is approximately 10,000 years.
25768 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
25769 # Durations less than one second are represented with a 0
25770 # `seconds` field and a positive `nanos` field. Must be from 0
25771 # to 999,999,999 inclusive.
25772 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
25773 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
25774 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
25775 },
25776 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
25777 # to apply fine-grained caching for common errors or redirects.
25778 # This can reduce the load on your origin and improve end-user
25779 # experience by reducing response latency.
25780 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
25781 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
25782 # the specified response code that lack any Cache-Control, Expires, or
25783 # Pragma: no-cache directives. When the `cacheMode` is set to
25784 # `FORCE_CACHE_ALL`, negative caching applies to all responses
25785 # with the specified response code, and overrides any caching headers. By
25786 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
25787 #
25788 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
25789 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
25790 # * 405 (Method Not Found), 501 (Not Implemented): 60s
25791 #
25792 # These defaults can be overridden in `negativeCachingPolicy`.
25793 # If not specified, Cloud CDN applies negative caching by default.
25794 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
25795 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
25796 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
25797 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
25798 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
25799 # all response codes that you wish to cache. Cloud CDN will not apply any
25800 # default negative caching when a policy exists.
25801 { # Specify CDN TTLs for response error codes.
25802 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
25803 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
25804 # specified as values, and you cannot specify a status code more than
25805 # once.
25806 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
25807 # corresponding status code.
25808 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
25809 # objects may be evicted from the cache before the defined TTL.
25810 # as a count of seconds and fractions of seconds at nanosecond
25811 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
25812 # or &quot;month&quot;. Range is approximately 10,000 years.
25813 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
25814 # Durations less than one second are represented with a 0
25815 # `seconds` field and a positive `nanos` field. Must be from 0
25816 # to 999,999,999 inclusive.
25817 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
25818 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
25819 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
25820 },
25821 },
25822 ],
25823 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
25824 # requests into a small number of requests to the origin. If not specified,
25825 # Cloud CDN applies request coalescing by default.
25826 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
25827 # content with the origin, or when an error is encountered when refreshing
25828 # the cache.
25829 # This setting defines the default &quot;max-stale&quot; duration for any cached
25830 # responses that do not specify a max-stale directive. Stale responses that
25831 # exceed the TTL configured here will not be served. The default limit
25832 # (max-stale) is 86400s (1 day), which will allow stale content to be
25833 # served up to this limit beyond the max-age (or s-maxage) of a cached
25834 # response.
25835 # The maximum allowed value is 604800 (1 week).
25836 # Set this to zero (0) to disable serve-while-stale.
25837 # as a count of seconds and fractions of seconds at nanosecond
25838 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
25839 # or &quot;month&quot;. Range is approximately 10,000 years.
25840 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
25841 # Durations less than one second are represented with a 0
25842 # `seconds` field and a positive `nanos` field. Must be from 0
25843 # to 999,999,999 inclusive.
25844 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
25845 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
25846 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
25847 },
25848 },
25849 &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
25850 # information about the W3C recommendation for cross-origin resource sharing
25851 # (CORS), see Fetch API Living
25852 # Standard.
25853 #
25854 # Not supported when the URL map is bound to a target gRPC proxy.
25855 # information about the W3C recommendation for cross-origin resource sharing
25856 # (CORS), see Fetch API Living
25857 # Standard.
25858 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
25859 # indicates that
25860 # the actual request can include user credentials. This field translates to
25861 # the Access-Control-Allow-Credentials header.
25862 #
25863 # Default is false.
25864 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
25865 # header.
25866 &quot;A String&quot;,
25867 ],
25868 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
25869 # header.
25870 &quot;A String&quot;,
25871 ],
25872 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
25873 # more information, see regular expression syntax.
25874 #
25875 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
25876 #
25877 # Regular expressions can only be used when the loadBalancingScheme is
25878 # set to INTERNAL_SELF_MANAGED.
25879 &quot;A String&quot;,
25880 ],
25881 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
25882 #
25883 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
25884 &quot;A String&quot;,
25885 ],
25886 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
25887 # The default value is false, which indicates that the CORS
25888 # policy is in effect.
25889 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
25890 # header.
25891 &quot;A String&quot;,
25892 ],
25893 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
25894 # seconds. This field translates to the Access-Control-Max-Age
25895 # header.
25896 },
25897 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
25898 # the resiliency of clients to backend service failure. As part of fault
25899 # injection, when clients send requests to a backend service, delays can be
25900 # introduced by a load balancer on a percentage of requests before sending
25901 # those requests to the backend service. Similarly requests from clients can
25902 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
25903 # that are configured with a fault_injection_policy if:
25904 # 1. The traffic is generated by fault injection AND
25905 # 2. The fault injection is not a delay fault injection.
25906 # Fault injection is not supported with the classic Application Load Balancer
25907 # . To see which load balancers support fault injection,
25908 # see Load
25909 # balancing: Routing and traffic management features.
25910 # the resiliency of clients to backend service failure. As part of fault
25911 # injection, when clients send requests to a backend service, delays can be
25912 # introduced by the load balancer on a percentage of requests before sending
25913 # those request to the backend service. Similarly requests from clients can be
25914 # aborted by the load balancer for a percentage of requests.
25915 &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
25916 # injection.
25917 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
25918 #
25919 # The value must be from 200 to 599 inclusive.
25920 #
25921 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
25922 # according to this
25923 # mapping table. HTTP status 200 is mapped to gRPC status
25924 # UNKNOWN. Injecting an OK status is currently not supported by
25925 # Traffic Director.
25926 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
25927 # that is aborted as part of fault injection.
25928 #
25929 # The value must be from 0.0 to 100.0 inclusive.
25930 },
25931 &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
25932 # injection, before being sent to a backend service.
25933 # request to the backend service as part of fault injection.
25934 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
25935 # as a count of seconds and fractions of seconds at nanosecond
25936 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
25937 # or &quot;month&quot;. Range is approximately 10,000 years.
25938 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
25939 # Durations less than one second are represented with a 0
25940 # `seconds` field and a positive `nanos` field. Must be from 0
25941 # to 999,999,999 inclusive.
25942 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
25943 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
25944 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
25945 },
25946 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
25947 # which a delay is introduced as part of fault injection.
25948 #
25949 # The value must be from 0.0 to 100.0 inclusive.
25950 },
25951 },
25952 &quot;imageOptimizationPolicy&quot;: { # The configuration for Cloud CDN&#x27;s image optimization feature. This feature # Image optimization policy for this URL Map&#x27;s route. Available only for
25953 # Global EXTERNAL_MANAGED load balancer schemes.
25954 # Either Cloud CDN must be enabled on the backend service or backend bucket
25955 # serving the route, or cache policy must be configured on the same route
25956 # dynamically processes and delivers images from the network edge.
25957 # Image Optimization is only available for Global External Application Load
25958 # Balancers.
25959 # Either Cloud CDN must be enabled on the backend service or backend bucket
25960 # serving the route, or cache policy must be configured on the same route.
25961 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
25962 },
25963 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
25964 # Unlike the timeout field where the timeout duration starts
25965 # from the time the request has been fully processed (known as*end-of-stream*),
25966 # the duration in this field is computed from the beginning of the stream
25967 # until the response has been processed, including all retries. A
25968 # stream that does not complete in this duration is closed.
25969 #
25970 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
25971 # with the route.
25972 #
25973 # This field is only allowed if the Url map is used with backend services
25974 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
25975 # as a count of seconds and fractions of seconds at nanosecond
25976 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
25977 # or &quot;month&quot;. Range is approximately 10,000 years.
25978 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
25979 # Durations less than one second are represented with a 0
25980 # `seconds` field and a positive `nanos` field. Must be from 0
25981 # to 999,999,999 inclusive.
25982 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
25983 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
25984 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
25985 },
25986 &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
25987 # are shadowed to a separate mirrored backend service. The load balancer does
25988 # not wait for responses from the shadow service. Before sending traffic
25989 # to the shadow service, the host / authority header is suffixed with-shadow.
25990 #
25991 # Not supported when the URL map is bound to a target gRPC proxy that
25992 # has the validateForProxyless field set to true.
25993 # are shadowed to a separate mirrored backend service. The load balancer
25994 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
25995 # to the shadow service, the host or authority header is suffixed with-shadow.
25996 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
25997 # mirrored to.
25998 #
25999 # The backend service configured for a mirroring
26000 # policy must reference backends that are of the same type as the original
26001 # backend service matched in the URL map.
26002 #
26003 # Serverless NEG backends are not currently supported as a mirrored
26004 # backend service.
26005 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
26006 },
26007 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
26008 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
26009 # If not specified, defaults to 1.
26010 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
26011 #
26012 # If not specified, will use the timeout set in theHttpRouteAction field.
26013 # If timeout in the HttpRouteAction field is not set, this field
26014 # uses the largest timeout
26015 # among all backend services associated with the route.
26016 #
26017 # Not supported when the URL map is bound to a target gRPC proxy that
26018 # has the validateForProxyless field set to true.
26019 # as a count of seconds and fractions of seconds at nanosecond
26020 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
26021 # or &quot;month&quot;. Range is approximately 10,000 years.
26022 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
26023 # Durations less than one second are represented with a 0
26024 # `seconds` field and a positive `nanos` field. Must be from 0
26025 # to 999,999,999 inclusive.
26026 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
26027 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
26028 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
26029 },
26030 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
26031 # values are:
26032 #
26033 # - 5xx: retry is attempted if the instance or endpoint
26034 # responds with any 5xx response code, or if the instance or
26035 # endpoint does not respond at all. For example, disconnects, reset, read
26036 # timeout, connection failure, and refused streams.
26037 # - gateway-error: Similar to 5xx, but only
26038 # applies to response codes 502, 503 or504.
26039 # - connect-failure: a retry is attempted on failures
26040 # connecting to the instance or endpoint. For example, connection
26041 # timeouts.
26042 # - retriable-4xx: a retry is attempted if the instance
26043 # or endpoint responds with a 4xx response code.
26044 # The only error that you can retry is error code 409.
26045 # - refused-stream: a retry is attempted if the instance
26046 # or endpoint resets the stream with a REFUSED_STREAM error
26047 # code. This reset type indicates that it is safe to retry.
26048 # - cancelled: a retry is attempted if the gRPC status
26049 # code in the response header is set to cancelled.
26050 # - deadline-exceeded: a retry is attempted if the gRPC
26051 # status code in the response header is set todeadline-exceeded.
26052 # - internal: a retry is attempted if the gRPC
26053 # status code in the response header is set tointernal.
26054 # - resource-exhausted: a retry is attempted if the gRPC
26055 # status code in the response header is set toresource-exhausted.
26056 # - unavailable: a retry is attempted if the gRPC
26057 # status code in the response header is set tounavailable.
26058 #
26059 # Only the following codes are supported when the URL map is bound to
26060 # target gRPC proxy that has validateForProxyless field set to true.
26061 #
26062 # - cancelled
26063 # - deadline-exceeded
26064 # - internal
26065 # - resource-exhausted
26066 # - unavailable
26067 &quot;A String&quot;,
26068 ],
26069 },
26070 &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
26071 # time the request has been fully processed (known as *end-of-stream*)
26072 # up until the response has been processed. Timeout includes
26073 # all retries.
26074 #
26075 # If not specified, this field uses the largest timeout among all backend
26076 # services associated with the route.
26077 #
26078 # Not supported when the URL map is bound to a target gRPC proxy that
26079 # has validateForProxyless field set to true.
26080 # as a count of seconds and fractions of seconds at nanosecond
26081 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
26082 # or &quot;month&quot;. Range is approximately 10,000 years.
26083 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
26084 # Durations less than one second are represented with a 0
26085 # `seconds` field and a positive `nanos` field. Must be from 0
26086 # to 999,999,999 inclusive.
26087 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
26088 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
26089 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
26090 },
26091 &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
26092 # to the matched service.
26093 #
26094 # urlRewrite is the only action supported in UrlMaps
26095 # for classic Application Load Balancers.
26096 #
26097 # Not supported when the URL map is bound to a target gRPC proxy that
26098 # has the validateForProxyless field set to true.
26099 # backend service.
26100 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
26101 # host header is replaced with contents of hostRewrite.
26102 #
26103 # The value must be from 1 to 255 characters.
26104 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
26105 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
26106 #
26107 # The value must be from 1 to 1024 characters.
26108 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
26109 # header) using the HTTP template syntax.
26110 #
26111 # A corresponding
26112 # path_template_match must be specified. Any template variables must exist in
26113 # the path_template_match field.
26114 #
26115 #
26116 # - -At least one variable must be specified in the path_template_match
26117 # field
26118 # - You can omit variables from the rewritten URL
26119 # - The * and ** operators cannot be matched
26120 # unless they have a corresponding variable name - e.g.
26121 # {format=*} or {var=**}.
26122 #
26123 # For example, a path_template_match of /static/{format=**}
26124 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
26125 # rewrite, so that /{country}/{format}/{suffix=**} can be
26126 # rewritten as /content/{format}/{country}/{suffix}.
26127 #
26128 # At least
26129 # one non-empty routeRules[].matchRules[].path_template_match is
26130 # required.
26131 #
26132 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
26133 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
26134 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
26135 # It uses RE2 syntax with the following constraints:
26136 #
26137 #
26138 # - Any single character operators
26139 # - Groups are allowed to have only submatch operator inside
26140 # - Groups are allowed only without any char repetition, e.g.
26141 # .*
26142 # - Any char repetition, e.g. .*, is
26143 # only allowed to be used in a single regex together with:
26144 #
26145 #
26146 # - Empty string operators
26147 # - Other repetitions
26148 # - Ranges
26149 # - Repetitions of ranges
26150 #
26151 #
26152 # - Ranges are only allowed to have:
26153 #
26154 #
26155 # - Character range
26156 # - Digits range
26157 # - Symbols listed in characters allowed for ranges
26158 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
26159 # the path.
26160 },
26161 },
26162 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
26163 # occurs. The weights determine the fraction of traffic that flows to
26164 # their corresponding backend service. If all traffic needs to
26165 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
26166 #
26167 # After a backend service is identified and before forwarding
26168 # the request to
26169 # the backend service, advanced routing actions such as URL rewrites and
26170 # header transformations are applied depending on additional settings
26171 # specified in this HttpRouteAction.
26172 { # In contrast to a single BackendService in
26173 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
26174 # multiple backend services. The volume of traffic for each
26175 # backend service is proportional to the weight specified
26176 # in each WeightedBackendService
26177 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
26178 # resource. Before
26179 # forwarding the request to backendService, the load balancer
26180 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
26181 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
26182 # effect for the selected backendService.
26183 #
26184 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
26185 #
26186 # headerAction is not supported for load balancers that have
26187 # their loadBalancingScheme set to EXTERNAL.
26188 #
26189 # Not supported when the URL map is bound to a target gRPC proxy that
26190 # has validateForProxyless field set to true.
26191 # the request is passed along to the selected backendService.
26192 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
26193 { # Specification determining how headers are added to requests or responses.
26194 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
26195 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
26196 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
26197 # that already
26198 # exist for the header. If true, headerValue is set for the
26199 # header, discarding any values that were set for that header.
26200 #
26201 # The default value is true,
26202 # unless a variable is present in headerValue,
26203 # in which case the default value is false.
26204 # .
26205 },
26206 ],
26207 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
26208 # request before forwarding the request to the backendService.
26209 &quot;A String&quot;,
26210 ],
26211 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
26212 # client.
26213 { # Specification determining how headers are added to requests or responses.
26214 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
26215 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
26216 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
26217 # that already
26218 # exist for the header. If true, headerValue is set for the
26219 # header, discarding any values that were set for that header.
26220 #
26221 # The default value is true,
26222 # unless a variable is present in headerValue,
26223 # in which case the default value is false.
26224 # .
26225 },
26226 ],
26227 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
26228 # response before sending the response back to the client.
26229 &quot;A String&quot;,
26230 ],
26231 },
26232 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
26233 # computed asweight / (sum of all weightedBackendService weights in routeAction).
26234 #
26235 # The selection of a backend service is determined only for new traffic.
26236 # Once a user&#x27;s request has been directed to a backend service,
26237 # subsequent requests are sent to the same backend service as
26238 # determined by the backend service&#x27;s session affinity policy.
26239 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
26240 # splitting. If you do, the weighted traffic splitting configuration takes
26241 # precedence.
26242 #
26243 # The value must be from 0 to 1000.
26244 },
26245 ],
26246 },
26247 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource. This
26248 # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
26249 # matched. For example, the
26250 # following are all valid URLs to a BackendService resource:
26251 #
26252 #
26253 # - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
26254 # - compute/v1/projects/project/global/backendServices/backendService
26255 # - global/backendServices/backendService
26256 #
26257 #
26258 # If defaultRouteAction is also specified, advanced
26259 # routing actions, such as URL rewrites, take effect before sending the
26260 # request to the backend.
26261 #
26262 #
26263 # Only one of defaultUrlRedirect, defaultService
26264 # or defaultRouteAction.weightedBackendService can be set.
26265 #
26266 #
26267 # Authorization requires one or more of the following Google IAM permissions on the
26268 # specified resource default_service:
26269 #
26270 #
26271 # - compute.backendBuckets.use
26272 # - compute.backendServices.use
26273 &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
26274 # by defaultUrlRedirect.
26275 #
26276 #
26277 # Only one of defaultUrlRedirect, defaultService
26278 # or defaultRouteAction.weightedBackendService can be set.
26279 #
26280 #
26281 # Not supported when the URL map is bound to a target gRPC proxy.
26282 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
26283 # was supplied in the request.
26284 #
26285 # The value must be from 1 to 255
26286 # characters.
26287 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
26288 # set to HTTPS.
26289 # If set to false, the URL scheme of the redirected request
26290 # remains the same as that of the request.
26291 #
26292 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
26293 #
26294 # The default is set to false.
26295 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
26296 # that was supplied in the request.
26297 #
26298 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
26299 # supplied, the path of the original request is used for the redirect.
26300 #
26301 # The value must be from 1 to 1024 characters.
26302 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
26303 # the HttpRouteRuleMatch, retaining the remaining portion
26304 # of the URL before redirecting the request.
26305 #
26306 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
26307 # supplied, the path of the original request is used for the redirect.
26308 #
26309 # The value must be from 1 to 1024 characters.
26310 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
26311 #
26312 # Supported values are:
26313 #
26314 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
26315 # to 301.
26316 # - FOUND, which corresponds to 302.
26317 # - SEE_OTHER which corresponds to 303.
26318 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
26319 # method is retained.
26320 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
26321 # method is retained.
26322 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
26323 # URL is
26324 # removed before redirecting the request. If set to false, the
26325 # query portion of the original URL is retained.
26326 #
26327 # The default is set to false.
26328 },
26329 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
26330 # create the resource.
26331 &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
26332 # for the selected backend service.
26333 #
26334 # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
26335 #
26336 # HeaderAction is not supported for load balancers
26337 # that have
26338 # their loadBalancingScheme set to EXTERNAL.
26339 #
26340 # Not supported when the URL map is bound to a target gRPC proxy that
26341 # has validateForProxyless field set to true.
26342 # the request is passed along to the selected backendService.
26343 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
26344 { # Specification determining how headers are added to requests or responses.
26345 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
26346 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
26347 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
26348 # that already
26349 # exist for the header. If true, headerValue is set for the
26350 # header, discarding any values that were set for that header.
26351 #
26352 # The default value is true,
26353 # unless a variable is present in headerValue,
26354 # in which case the default value is false.
26355 # .
26356 },
26357 ],
26358 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
26359 # request before forwarding the request to the backendService.
26360 &quot;A String&quot;,
26361 ],
26362 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
26363 # client.
26364 { # Specification determining how headers are added to requests or responses.
26365 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
26366 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
26367 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
26368 # that already
26369 # exist for the header. If true, headerValue is set for the
26370 # header, discarding any values that were set for that header.
26371 #
26372 # The default value is true,
26373 # unless a variable is present in headerValue,
26374 # in which case the default value is false.
26375 # .
26376 },
26377 ],
26378 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
26379 # response before sending the response back to the client.
26380 &quot;A String&quot;,
26381 ],
26382 },
26383 &quot;name&quot;: &quot;A String&quot;, # The name to which this PathMatcher is referred by theHostRule.
26384 &quot;pathRules&quot;: [ # The list of path rules. Use this list instead of routeRules
26385 # when routing based on simple path matching is all that&#x27;s required. A path
26386 # rule can only include a wildcard character (*) after a
26387 # forward slash character (&quot;/&quot;).
26388 #
26389 # The order by which path rules are specified does not matter.
26390 # Matches are always done on the longest-path-first basis.
26391 #
26392 # For example: a pathRule with a path /a/b/c/* will match
26393 # before /a/b/* irrespective of the order in which those paths appear in this
26394 # list.
26395 #
26396 # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
26397 { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
26398 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
26399 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
26400 #
26401 # If a policy for an
26402 # error code is not configured for the PathRule, a policy for
26403 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
26404 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
26405 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
26406 # effect.
26407 #
26408 # For example, consider a UrlMap with the following configuration:
26409 #
26410 #
26411 # - UrlMap.defaultCustomErrorResponsePolicy are configured
26412 # with policies for 5xx and 4xx errors
26413 # - A PathRule for /coming_soon/ is configured for the error
26414 # code 404.
26415 #
26416 # 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
26417 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
26418 # the policy in PathRule.customErrorResponsePolicy takes
26419 # effect. If any of the requests in this example encounter a 500
26420 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
26421 #
26422 # customErrorResponsePolicy is supported only for
26423 # global external Application Load Balancers.
26424 # backend service or backend bucket responds with an error.
26425 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
26426 #
26427 # In a given policy, if you specify rules for both a range of error codes
26428 # as well as rules for specific error codes then rules with specific error
26429 # codes have a higher priority. For example, assume that you configure a rule
26430 # for 401 (Un-authorized) code, and another for all 4 series
26431 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
26432 # However if the backend service returns a 403, the rule for4xx takes effect.
26433 { # Specifies the mapping between the response code that will be returned along
26434 # with the custom error content and the response code returned by the backend
26435 # service.
26436 &quot;matchResponseCodes&quot;: [ # Valid values include:
26437 #
26438 #
26439 # - A number between 400 and 599: For example
26440 # 401 or 503, in which case the load balancer
26441 # applies the policy if the error code exactly matches this value.
26442 # - 5xx: Load Balancer will apply the policy if the
26443 # backend service responds with any response code in the range of
26444 # 500 to 599.
26445 # - 4xx: Load
26446 # Balancer will apply the policy if the backend service responds with any
26447 # response code in the range of 400 to
26448 # 499.
26449 #
26450 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
26451 &quot;A String&quot;,
26452 ],
26453 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
26454 # error content. If overrideResponseCode is not supplied, the
26455 # same response code returned by the original backend bucket or backend
26456 # service is returned to the client.
26457 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
26458 #
26459 # path must start
26460 # with a leading slash. path cannot have trailing slashes.
26461 #
26462 # If the file is not available in backendBucket or the
26463 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
26464 #
26465 # The value must
26466 # be from 1 to 1024 characters
26467 },
26468 ],
26469 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
26470 # contains the custom error content. Examples are:
26471 #
26472 #
26473 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
26474 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
26475 # - global/backendBuckets/myBackendBucket
26476 #
26477 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
26478 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
26479 #
26480 # If load balancer cannot reach
26481 # the backendBucket, a simple Not Found Error will
26482 # be returned, with the original response code (oroverrideResponseCode if configured).
26483 #
26484 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
26485 },
26486 &quot;paths&quot;: [ # The list of path patterns to match. Each must start with /
26487 # and the only place a * is allowed is at the end following
26488 # a /. The string fed to the path matcher does not include
26489 # any text after the first ? or #, and
26490 # those chars are not allowed here.
26491 &quot;A String&quot;,
26492 ],
26493 &quot;routeAction&quot;: { # In response to a matching path, the load balancer
26494 # performs advanced routing actions, such as URL rewrites and header
26495 # transformations, before forwarding the request to the selected
26496 # backend.
26497 #
26498 #
26499 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
26500 #
26501 #
26502 # URL maps for classic Application Load Balancers only support
26503 # the urlRewrite action within a path rule&#x27;srouteAction.
26504 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
26505 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
26506 # property must be specified. This policy cannot be specified if any target
26507 # backend has Identity-Aware Proxy enabled.
26508 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
26509 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
26510 # header names can be specified. The cache is bypassed for all `cacheMode`
26511 # values.
26512 &quot;A String&quot;,
26513 ],
26514 &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
26515 # on the backend type: for Backend Services, the complete request URI is
26516 # used; for Backend Buckets, the request URI is used without the protocol or
26517 # host, and only query parameters known to Cloud Storage are included.
26518 # Policy defined on Route Action.
26519 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
26520 # parameters will be included. Either specify `excludedQueryParameters`
26521 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
26522 # encoded and not treated as delimiters.
26523 #
26524 # Note: This field applies to routes that use backend services. Attempting
26525 # to set it on a route that points exclusively to Backend Buckets will
26526 # result in a configuration error. For routes that point to a Backend
26527 # Bucket, use `includedQueryParameters` to define which parameters should
26528 # be part of the cache key.
26529 &quot;A String&quot;,
26530 ],
26531 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
26532 #
26533 # Note: This setting is only applicable to routes that use a Backend
26534 # Service. It does not affect requests served by a Backend Bucket, as the
26535 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
26536 # it on a route that points exclusively to Backend Buckets will result in a
26537 # configuration error.
26538 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
26539 #
26540 # Note: This setting is only applicable to routes that use a Backend
26541 # Service. It does not affect requests served by a Backend Bucket, as the
26542 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
26543 # set on a route that points exclusively to Backend Buckets will result in
26544 # a configuration error.
26545 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
26546 # `includedQueryParameters` and `excludedQueryParameters`. If neither
26547 # is set, the entire query string will be included. If false, the query
26548 # string will be excluded from the cache key entirely.
26549 #
26550 # Note: This field applies to routes that use backend services. Attempting
26551 # to set it on a route that points exclusively to Backend Buckets will
26552 # result in a configuration error. For routes that point to a Backend
26553 # Bucket, use `includedQueryParameters` to define which parameters should
26554 # be part of the cache key.
26555 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
26556 # The name=value pair will be used in the cache key Cloud CDN generates.
26557 #
26558 # Note: This setting is only applicable to routes that use a Backend
26559 # Service. It does not affect requests served by a Backend Bucket.
26560 # Attempting to set it on a route that points exclusively to Backend
26561 # Buckets will result in a configuration error. Up to 5 cookie names can be
26562 # specified.
26563 &quot;A String&quot;,
26564 ],
26565 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
26566 &quot;A String&quot;,
26567 ],
26568 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
26569 # parameters will be excluded. Either specify `includedQueryParameters`
26570 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
26571 # encoded and not treated as delimiters.
26572 &quot;A String&quot;,
26573 ],
26574 },
26575 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
26576 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
26577 &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
26578 # content. This is used to clamp the max-age (or Expires) value sent to the
26579 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
26580 # is used for the response max-age directive, along with a &quot;public&quot;
26581 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
26582 # clamps the max-age from the origin (if specified), or else sets the
26583 # response max-age directive to the lesser of the `clientTtl` and
26584 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
26585 # present. The maximum allowed value is 31,622,400s (1 year). If not
26586 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
26587 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
26588 # `USE_ORIGIN_HEADERS`.
26589 # as a count of seconds and fractions of seconds at nanosecond
26590 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
26591 # or &quot;month&quot;. Range is approximately 10,000 years.
26592 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
26593 # Durations less than one second are represented with a 0
26594 # `seconds` field and a positive `nanos` field. Must be from 0
26595 # to 999,999,999 inclusive.
26596 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
26597 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
26598 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
26599 },
26600 &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
26601 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
26602 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
26603 # greater than that of `maxTtl`. When the `cacheMode` is set to
26604 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
26605 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
26606 # accessed objects may be evicted from the cache before the defined TTL. If
26607 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
26608 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
26609 # `USE_ORIGIN_HEADERS`.
26610 # as a count of seconds and fractions of seconds at nanosecond
26611 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
26612 # or &quot;month&quot;. Range is approximately 10,000 years.
26613 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
26614 # Durations less than one second are represented with a 0
26615 # `seconds` field and a positive `nanos` field. Must be from 0
26616 # to 999,999,999 inclusive.
26617 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
26618 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
26619 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
26620 },
26621 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
26622 # attempt to set a max-age or s-maxage higher than this, or an Expires header
26623 # more than `maxTtl` seconds in the future will be capped at the value of
26624 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
26625 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
26626 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
26627 # Infrequently accessed objects may be evicted from the cache before the
26628 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
26629 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
26630 # mode.
26631 # as a count of seconds and fractions of seconds at nanosecond
26632 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
26633 # or &quot;month&quot;. Range is approximately 10,000 years.
26634 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
26635 # Durations less than one second are represented with a 0
26636 # `seconds` field and a positive `nanos` field. Must be from 0
26637 # to 999,999,999 inclusive.
26638 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
26639 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
26640 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
26641 },
26642 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
26643 # to apply fine-grained caching for common errors or redirects.
26644 # This can reduce the load on your origin and improve end-user
26645 # experience by reducing response latency.
26646 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
26647 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
26648 # the specified response code that lack any Cache-Control, Expires, or
26649 # Pragma: no-cache directives. When the `cacheMode` is set to
26650 # `FORCE_CACHE_ALL`, negative caching applies to all responses
26651 # with the specified response code, and overrides any caching headers. By
26652 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
26653 #
26654 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
26655 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
26656 # * 405 (Method Not Found), 501 (Not Implemented): 60s
26657 #
26658 # These defaults can be overridden in `negativeCachingPolicy`.
26659 # If not specified, Cloud CDN applies negative caching by default.
26660 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
26661 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
26662 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
26663 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
26664 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
26665 # all response codes that you wish to cache. Cloud CDN will not apply any
26666 # default negative caching when a policy exists.
26667 { # Specify CDN TTLs for response error codes.
26668 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
26669 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
26670 # specified as values, and you cannot specify a status code more than
26671 # once.
26672 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
26673 # corresponding status code.
26674 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
26675 # objects may be evicted from the cache before the defined TTL.
26676 # as a count of seconds and fractions of seconds at nanosecond
26677 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
26678 # or &quot;month&quot;. Range is approximately 10,000 years.
26679 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
26680 # Durations less than one second are represented with a 0
26681 # `seconds` field and a positive `nanos` field. Must be from 0
26682 # to 999,999,999 inclusive.
26683 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
26684 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
26685 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
26686 },
26687 },
26688 ],
26689 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
26690 # requests into a small number of requests to the origin. If not specified,
26691 # Cloud CDN applies request coalescing by default.
26692 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
26693 # content with the origin, or when an error is encountered when refreshing
26694 # the cache.
26695 # This setting defines the default &quot;max-stale&quot; duration for any cached
26696 # responses that do not specify a max-stale directive. Stale responses that
26697 # exceed the TTL configured here will not be served. The default limit
26698 # (max-stale) is 86400s (1 day), which will allow stale content to be
26699 # served up to this limit beyond the max-age (or s-maxage) of a cached
26700 # response.
26701 # The maximum allowed value is 604800 (1 week).
26702 # Set this to zero (0) to disable serve-while-stale.
26703 # as a count of seconds and fractions of seconds at nanosecond
26704 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
26705 # or &quot;month&quot;. Range is approximately 10,000 years.
26706 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
26707 # Durations less than one second are represented with a 0
26708 # `seconds` field and a positive `nanos` field. Must be from 0
26709 # to 999,999,999 inclusive.
26710 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
26711 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
26712 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
26713 },
26714 },
26715 &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
26716 # information about the W3C recommendation for cross-origin resource sharing
26717 # (CORS), see Fetch API Living
26718 # Standard.
26719 #
26720 # Not supported when the URL map is bound to a target gRPC proxy.
26721 # information about the W3C recommendation for cross-origin resource sharing
26722 # (CORS), see Fetch API Living
26723 # Standard.
26724 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
26725 # indicates that
26726 # the actual request can include user credentials. This field translates to
26727 # the Access-Control-Allow-Credentials header.
26728 #
26729 # Default is false.
26730 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
26731 # header.
26732 &quot;A String&quot;,
26733 ],
26734 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
26735 # header.
26736 &quot;A String&quot;,
26737 ],
26738 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
26739 # more information, see regular expression syntax.
26740 #
26741 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
26742 #
26743 # Regular expressions can only be used when the loadBalancingScheme is
26744 # set to INTERNAL_SELF_MANAGED.
26745 &quot;A String&quot;,
26746 ],
26747 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
26748 #
26749 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
26750 &quot;A String&quot;,
26751 ],
26752 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
26753 # The default value is false, which indicates that the CORS
26754 # policy is in effect.
26755 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
26756 # header.
26757 &quot;A String&quot;,
26758 ],
26759 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
26760 # seconds. This field translates to the Access-Control-Max-Age
26761 # header.
26762 },
26763 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
26764 # the resiliency of clients to backend service failure. As part of fault
26765 # injection, when clients send requests to a backend service, delays can be
26766 # introduced by a load balancer on a percentage of requests before sending
26767 # those requests to the backend service. Similarly requests from clients can
26768 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
26769 # that are configured with a fault_injection_policy if:
26770 # 1. The traffic is generated by fault injection AND
26771 # 2. The fault injection is not a delay fault injection.
26772 # Fault injection is not supported with the classic Application Load Balancer
26773 # . To see which load balancers support fault injection,
26774 # see Load
26775 # balancing: Routing and traffic management features.
26776 # the resiliency of clients to backend service failure. As part of fault
26777 # injection, when clients send requests to a backend service, delays can be
26778 # introduced by the load balancer on a percentage of requests before sending
26779 # those request to the backend service. Similarly requests from clients can be
26780 # aborted by the load balancer for a percentage of requests.
26781 &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
26782 # injection.
26783 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
26784 #
26785 # The value must be from 200 to 599 inclusive.
26786 #
26787 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
26788 # according to this
26789 # mapping table. HTTP status 200 is mapped to gRPC status
26790 # UNKNOWN. Injecting an OK status is currently not supported by
26791 # Traffic Director.
26792 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
26793 # that is aborted as part of fault injection.
26794 #
26795 # The value must be from 0.0 to 100.0 inclusive.
26796 },
26797 &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
26798 # injection, before being sent to a backend service.
26799 # request to the backend service as part of fault injection.
26800 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
26801 # as a count of seconds and fractions of seconds at nanosecond
26802 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
26803 # or &quot;month&quot;. Range is approximately 10,000 years.
26804 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
26805 # Durations less than one second are represented with a 0
26806 # `seconds` field and a positive `nanos` field. Must be from 0
26807 # to 999,999,999 inclusive.
26808 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
26809 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
26810 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
26811 },
26812 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
26813 # which a delay is introduced as part of fault injection.
26814 #
26815 # The value must be from 0.0 to 100.0 inclusive.
26816 },
26817 },
26818 &quot;imageOptimizationPolicy&quot;: { # The configuration for Cloud CDN&#x27;s image optimization feature. This feature # Image optimization policy for this URL Map&#x27;s route. Available only for
26819 # Global EXTERNAL_MANAGED load balancer schemes.
26820 # Either Cloud CDN must be enabled on the backend service or backend bucket
26821 # serving the route, or cache policy must be configured on the same route
26822 # dynamically processes and delivers images from the network edge.
26823 # Image Optimization is only available for Global External Application Load
26824 # Balancers.
26825 # Either Cloud CDN must be enabled on the backend service or backend bucket
26826 # serving the route, or cache policy must be configured on the same route.
26827 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
26828 },
26829 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
26830 # Unlike the timeout field where the timeout duration starts
26831 # from the time the request has been fully processed (known as*end-of-stream*),
26832 # the duration in this field is computed from the beginning of the stream
26833 # until the response has been processed, including all retries. A
26834 # stream that does not complete in this duration is closed.
26835 #
26836 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
26837 # with the route.
26838 #
26839 # This field is only allowed if the Url map is used with backend services
26840 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
26841 # as a count of seconds and fractions of seconds at nanosecond
26842 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
26843 # or &quot;month&quot;. Range is approximately 10,000 years.
26844 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
26845 # Durations less than one second are represented with a 0
26846 # `seconds` field and a positive `nanos` field. Must be from 0
26847 # to 999,999,999 inclusive.
26848 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
26849 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
26850 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
26851 },
26852 &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
26853 # are shadowed to a separate mirrored backend service. The load balancer does
26854 # not wait for responses from the shadow service. Before sending traffic
26855 # to the shadow service, the host / authority header is suffixed with-shadow.
26856 #
26857 # Not supported when the URL map is bound to a target gRPC proxy that
26858 # has the validateForProxyless field set to true.
26859 # are shadowed to a separate mirrored backend service. The load balancer
26860 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
26861 # to the shadow service, the host or authority header is suffixed with-shadow.
26862 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
26863 # mirrored to.
26864 #
26865 # The backend service configured for a mirroring
26866 # policy must reference backends that are of the same type as the original
26867 # backend service matched in the URL map.
26868 #
26869 # Serverless NEG backends are not currently supported as a mirrored
26870 # backend service.
26871 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
26872 },
26873 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
26874 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
26875 # If not specified, defaults to 1.
26876 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
26877 #
26878 # If not specified, will use the timeout set in theHttpRouteAction field.
26879 # If timeout in the HttpRouteAction field is not set, this field
26880 # uses the largest timeout
26881 # among all backend services associated with the route.
26882 #
26883 # Not supported when the URL map is bound to a target gRPC proxy that
26884 # has the validateForProxyless field set to true.
26885 # as a count of seconds and fractions of seconds at nanosecond
26886 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
26887 # or &quot;month&quot;. Range is approximately 10,000 years.
26888 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
26889 # Durations less than one second are represented with a 0
26890 # `seconds` field and a positive `nanos` field. Must be from 0
26891 # to 999,999,999 inclusive.
26892 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
26893 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
26894 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
26895 },
26896 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
26897 # values are:
26898 #
26899 # - 5xx: retry is attempted if the instance or endpoint
26900 # responds with any 5xx response code, or if the instance or
26901 # endpoint does not respond at all. For example, disconnects, reset, read
26902 # timeout, connection failure, and refused streams.
26903 # - gateway-error: Similar to 5xx, but only
26904 # applies to response codes 502, 503 or504.
26905 # - connect-failure: a retry is attempted on failures
26906 # connecting to the instance or endpoint. For example, connection
26907 # timeouts.
26908 # - retriable-4xx: a retry is attempted if the instance
26909 # or endpoint responds with a 4xx response code.
26910 # The only error that you can retry is error code 409.
26911 # - refused-stream: a retry is attempted if the instance
26912 # or endpoint resets the stream with a REFUSED_STREAM error
26913 # code. This reset type indicates that it is safe to retry.
26914 # - cancelled: a retry is attempted if the gRPC status
26915 # code in the response header is set to cancelled.
26916 # - deadline-exceeded: a retry is attempted if the gRPC
26917 # status code in the response header is set todeadline-exceeded.
26918 # - internal: a retry is attempted if the gRPC
26919 # status code in the response header is set tointernal.
26920 # - resource-exhausted: a retry is attempted if the gRPC
26921 # status code in the response header is set toresource-exhausted.
26922 # - unavailable: a retry is attempted if the gRPC
26923 # status code in the response header is set tounavailable.
26924 #
26925 # Only the following codes are supported when the URL map is bound to
26926 # target gRPC proxy that has validateForProxyless field set to true.
26927 #
26928 # - cancelled
26929 # - deadline-exceeded
26930 # - internal
26931 # - resource-exhausted
26932 # - unavailable
26933 &quot;A String&quot;,
26934 ],
26935 },
26936 &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
26937 # time the request has been fully processed (known as *end-of-stream*)
26938 # up until the response has been processed. Timeout includes
26939 # all retries.
26940 #
26941 # If not specified, this field uses the largest timeout among all backend
26942 # services associated with the route.
26943 #
26944 # Not supported when the URL map is bound to a target gRPC proxy that
26945 # has validateForProxyless field set to true.
26946 # as a count of seconds and fractions of seconds at nanosecond
26947 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
26948 # or &quot;month&quot;. Range is approximately 10,000 years.
26949 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
26950 # Durations less than one second are represented with a 0
26951 # `seconds` field and a positive `nanos` field. Must be from 0
26952 # to 999,999,999 inclusive.
26953 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
26954 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
26955 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
26956 },
26957 &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
26958 # to the matched service.
26959 #
26960 # urlRewrite is the only action supported in UrlMaps
26961 # for classic Application Load Balancers.
26962 #
26963 # Not supported when the URL map is bound to a target gRPC proxy that
26964 # has the validateForProxyless field set to true.
26965 # backend service.
26966 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
26967 # host header is replaced with contents of hostRewrite.
26968 #
26969 # The value must be from 1 to 255 characters.
26970 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
26971 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
26972 #
26973 # The value must be from 1 to 1024 characters.
26974 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
26975 # header) using the HTTP template syntax.
26976 #
26977 # A corresponding
26978 # path_template_match must be specified. Any template variables must exist in
26979 # the path_template_match field.
26980 #
26981 #
26982 # - -At least one variable must be specified in the path_template_match
26983 # field
26984 # - You can omit variables from the rewritten URL
26985 # - The * and ** operators cannot be matched
26986 # unless they have a corresponding variable name - e.g.
26987 # {format=*} or {var=**}.
26988 #
26989 # For example, a path_template_match of /static/{format=**}
26990 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
26991 # rewrite, so that /{country}/{format}/{suffix=**} can be
26992 # rewritten as /content/{format}/{country}/{suffix}.
26993 #
26994 # At least
26995 # one non-empty routeRules[].matchRules[].path_template_match is
26996 # required.
26997 #
26998 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
26999 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
27000 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
27001 # It uses RE2 syntax with the following constraints:
27002 #
27003 #
27004 # - Any single character operators
27005 # - Groups are allowed to have only submatch operator inside
27006 # - Groups are allowed only without any char repetition, e.g.
27007 # .*
27008 # - Any char repetition, e.g. .*, is
27009 # only allowed to be used in a single regex together with:
27010 #
27011 #
27012 # - Empty string operators
27013 # - Other repetitions
27014 # - Ranges
27015 # - Repetitions of ranges
27016 #
27017 #
27018 # - Ranges are only allowed to have:
27019 #
27020 #
27021 # - Character range
27022 # - Digits range
27023 # - Symbols listed in characters allowed for ranges
27024 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
27025 # the path.
27026 },
27027 },
27028 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
27029 # occurs. The weights determine the fraction of traffic that flows to
27030 # their corresponding backend service. If all traffic needs to
27031 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
27032 #
27033 # After a backend service is identified and before forwarding
27034 # the request to
27035 # the backend service, advanced routing actions such as URL rewrites and
27036 # header transformations are applied depending on additional settings
27037 # specified in this HttpRouteAction.
27038 { # In contrast to a single BackendService in
27039 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
27040 # multiple backend services. The volume of traffic for each
27041 # backend service is proportional to the weight specified
27042 # in each WeightedBackendService
27043 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
27044 # resource. Before
27045 # forwarding the request to backendService, the load balancer
27046 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
27047 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
27048 # effect for the selected backendService.
27049 #
27050 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
27051 #
27052 # headerAction is not supported for load balancers that have
27053 # their loadBalancingScheme set to EXTERNAL.
27054 #
27055 # Not supported when the URL map is bound to a target gRPC proxy that
27056 # has validateForProxyless field set to true.
27057 # the request is passed along to the selected backendService.
27058 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
27059 { # Specification determining how headers are added to requests or responses.
27060 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
27061 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
27062 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
27063 # that already
27064 # exist for the header. If true, headerValue is set for the
27065 # header, discarding any values that were set for that header.
27066 #
27067 # The default value is true,
27068 # unless a variable is present in headerValue,
27069 # in which case the default value is false.
27070 # .
27071 },
27072 ],
27073 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
27074 # request before forwarding the request to the backendService.
27075 &quot;A String&quot;,
27076 ],
27077 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
27078 # client.
27079 { # Specification determining how headers are added to requests or responses.
27080 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
27081 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
27082 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
27083 # that already
27084 # exist for the header. If true, headerValue is set for the
27085 # header, discarding any values that were set for that header.
27086 #
27087 # The default value is true,
27088 # unless a variable is present in headerValue,
27089 # in which case the default value is false.
27090 # .
27091 },
27092 ],
27093 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
27094 # response before sending the response back to the client.
27095 &quot;A String&quot;,
27096 ],
27097 },
27098 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
27099 # computed asweight / (sum of all weightedBackendService weights in routeAction).
27100 #
27101 # The selection of a backend service is determined only for new traffic.
27102 # Once a user&#x27;s request has been directed to a backend service,
27103 # subsequent requests are sent to the same backend service as
27104 # determined by the backend service&#x27;s session affinity policy.
27105 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
27106 # splitting. If you do, the weighted traffic splitting configuration takes
27107 # precedence.
27108 #
27109 # The value must be from 0 to 1000.
27110 },
27111 ],
27112 },
27113 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
27114 # is directed if this rule is matched. If routeAction is
27115 # also specified, advanced routing actions, such as URL rewrites,
27116 # take effect before sending the request to the backend.
27117 #
27118 #
27119 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
27120 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
27121 # specified by urlRedirect.
27122 #
27123 #
27124 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
27125 #
27126 #
27127 # Not supported when the URL map is bound to a target gRPC proxy.
27128 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
27129 # was supplied in the request.
27130 #
27131 # The value must be from 1 to 255
27132 # characters.
27133 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
27134 # set to HTTPS.
27135 # If set to false, the URL scheme of the redirected request
27136 # remains the same as that of the request.
27137 #
27138 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
27139 #
27140 # The default is set to false.
27141 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
27142 # that was supplied in the request.
27143 #
27144 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
27145 # supplied, the path of the original request is used for the redirect.
27146 #
27147 # The value must be from 1 to 1024 characters.
27148 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
27149 # the HttpRouteRuleMatch, retaining the remaining portion
27150 # of the URL before redirecting the request.
27151 #
27152 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
27153 # supplied, the path of the original request is used for the redirect.
27154 #
27155 # The value must be from 1 to 1024 characters.
27156 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
27157 #
27158 # Supported values are:
27159 #
27160 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
27161 # to 301.
27162 # - FOUND, which corresponds to 302.
27163 # - SEE_OTHER which corresponds to 303.
27164 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
27165 # method is retained.
27166 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
27167 # method is retained.
27168 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
27169 # URL is
27170 # removed before redirecting the request. If set to false, the
27171 # query portion of the original URL is retained.
27172 #
27173 # The default is set to false.
27174 },
27175 },
27176 ],
27177 &quot;routeRules&quot;: [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
27178 # desired. routeRules are evaluated in order of priority, from
27179 # the lowest to highest number.
27180 #
27181 # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
27182 { # The HttpRouteRule setting specifies how to match an HTTP request
27183 # and the corresponding routing action that load balancing proxies perform.
27184 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
27185 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
27186 #
27187 # If a policy for an
27188 # error code is not configured for the RouteRule, a policy for
27189 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
27190 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
27191 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
27192 # effect.
27193 #
27194 # For example, consider a UrlMap with the following configuration:
27195 #
27196 #
27197 # - UrlMap.defaultCustomErrorResponsePolicy are configured
27198 # with policies for 5xx and 4xx errors
27199 # - A RouteRule for /coming_soon/ is configured for the
27200 # error code 404.
27201 #
27202 # 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
27203 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
27204 # the policy in RouteRule.customErrorResponsePolicy takes
27205 # effect. If any of the requests in this example encounter a 500
27206 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
27207 #
27208 # When
27209 # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
27210 # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
27211 # a retry, if load balancer is successful in reaching the
27212 # service, the customErrorResponsePolicy is ignored and
27213 # the response from the service is returned to the client.
27214 #
27215 # customErrorResponsePolicy is supported only for
27216 # global external Application Load Balancers.
27217 # backend service or backend bucket responds with an error.
27218 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
27219 #
27220 # In a given policy, if you specify rules for both a range of error codes
27221 # as well as rules for specific error codes then rules with specific error
27222 # codes have a higher priority. For example, assume that you configure a rule
27223 # for 401 (Un-authorized) code, and another for all 4 series
27224 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
27225 # However if the backend service returns a 403, the rule for4xx takes effect.
27226 { # Specifies the mapping between the response code that will be returned along
27227 # with the custom error content and the response code returned by the backend
27228 # service.
27229 &quot;matchResponseCodes&quot;: [ # Valid values include:
27230 #
27231 #
27232 # - A number between 400 and 599: For example
27233 # 401 or 503, in which case the load balancer
27234 # applies the policy if the error code exactly matches this value.
27235 # - 5xx: Load Balancer will apply the policy if the
27236 # backend service responds with any response code in the range of
27237 # 500 to 599.
27238 # - 4xx: Load
27239 # Balancer will apply the policy if the backend service responds with any
27240 # response code in the range of 400 to
27241 # 499.
27242 #
27243 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
27244 &quot;A String&quot;,
27245 ],
27246 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
27247 # error content. If overrideResponseCode is not supplied, the
27248 # same response code returned by the original backend bucket or backend
27249 # service is returned to the client.
27250 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
27251 #
27252 # path must start
27253 # with a leading slash. path cannot have trailing slashes.
27254 #
27255 # If the file is not available in backendBucket or the
27256 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
27257 #
27258 # The value must
27259 # be from 1 to 1024 characters
27260 },
27261 ],
27262 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
27263 # contains the custom error content. Examples are:
27264 #
27265 #
27266 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
27267 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
27268 # - global/backendBuckets/myBackendBucket
27269 #
27270 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
27271 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
27272 #
27273 # If load balancer cannot reach
27274 # the backendBucket, a simple Not Found Error will
27275 # be returned, with the original response code (oroverrideResponseCode if configured).
27276 #
27277 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
27278 },
27279 &quot;description&quot;: &quot;A String&quot;, # The short description conveying the intent of this routeRule.
27280 #
27281 #
27282 # The description can have a maximum length of 1024 characters.
27283 &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
27284 # for the selected backendService.
27285 #
27286 # The headerAction value specified here is applied before the
27287 # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
27288 #
27289 # HeaderAction is not supported for load balancers
27290 # that have
27291 # their loadBalancingScheme set to EXTERNAL.
27292 #
27293 # Not supported when the URL map is bound to a target gRPC proxy that
27294 # has validateForProxyless field set to true.
27295 # the request is passed along to the selected backendService.
27296 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
27297 { # Specification determining how headers are added to requests or responses.
27298 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
27299 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
27300 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
27301 # that already
27302 # exist for the header. If true, headerValue is set for the
27303 # header, discarding any values that were set for that header.
27304 #
27305 # The default value is true,
27306 # unless a variable is present in headerValue,
27307 # in which case the default value is false.
27308 # .
27309 },
27310 ],
27311 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
27312 # request before forwarding the request to the backendService.
27313 &quot;A String&quot;,
27314 ],
27315 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
27316 # client.
27317 { # Specification determining how headers are added to requests or responses.
27318 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
27319 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
27320 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
27321 # that already
27322 # exist for the header. If true, headerValue is set for the
27323 # header, discarding any values that were set for that header.
27324 #
27325 # The default value is true,
27326 # unless a variable is present in headerValue,
27327 # in which case the default value is false.
27328 # .
27329 },
27330 ],
27331 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
27332 # response before sending the response back to the client.
27333 &quot;A String&quot;,
27334 ],
27335 },
27336 &quot;httpFilterConfigs&quot;: [ # Outbound route specific configuration fornetworkservices.HttpFilter resources enabled by Traffic
27337 # Director. httpFilterConfigs only applies for load balancers
27338 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
27339 # more details.
27340 #
27341 # Not supported when the URL map is bound to a target gRPC proxy that
27342 # has validateForProxyless field set to true.
27343 { # HttpFilterConfiguration supplies additional contextual settings
27344 # for networkservices.HttpFilter resources enabled by Traffic
27345 # Director.
27346 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
27347 # YAML formatted and only contain fields defined in the protobuf identified
27348 # in configTypeUrl
27349 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
27350 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
27351 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
27352 # configuration belongs to. This name must be known to the xDS client.
27353 # Example: envoy.wasm
27354 },
27355 ],
27356 &quot;httpFilterMetadata&quot;: [ # Outbound route specific metadata supplied tonetworkservices.HttpFilter resources enabled by Traffic
27357 # Director. httpFilterMetadata only applies for load balancers
27358 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
27359 # more details.
27360 #
27361 # The only configTypeUrl supported istype.googleapis.com/google.protobuf.Struct
27362 #
27363 # Not supported when the URL map is bound to a target gRPC proxy that
27364 # has validateForProxyless field set to true.
27365 { # HttpFilterConfiguration supplies additional contextual settings
27366 # for networkservices.HttpFilter resources enabled by Traffic
27367 # Director.
27368 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
27369 # YAML formatted and only contain fields defined in the protobuf identified
27370 # in configTypeUrl
27371 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
27372 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
27373 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
27374 # configuration belongs to. This name must be known to the xDS client.
27375 # Example: envoy.wasm
27376 },
27377 ],
27378 &quot;matchRules&quot;: [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
27379 # this routeRule when any of thematchRules are satisfied. However predicates within
27380 # a given matchRule have AND semantics. All predicates
27381 # within a matchRule must match for the request to
27382 # match the rule.
27383 { # HttpRouteRuleMatch specifies a set of criteria for matching
27384 # requests to an HttpRouteRule. All specified criteria must
27385 # be satisfied for a match to occur.
27386 &quot;fullPathMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
27387 # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
27388 # that may be part of the original URL.
27389 #
27390 # fullPathMatch must be from 1 to 1024 characters.
27391 #
27392 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
27393 # specified.
27394 &quot;headerMatches&quot;: [ # Specifies a list of header match criteria, all of which must match
27395 # corresponding headers in the request.
27396 { # matchRule criteria for request header matches.
27397 &quot;exactMatch&quot;: &quot;A String&quot;, # The value should exactly match contents of exactMatch.
27398 #
27399 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
27400 &quot;headerName&quot;: &quot;A String&quot;, # The name of the HTTP header to match.
27401 #
27402 # For matching against the HTTP request&#x27;s authority, use a headerMatch
27403 # with the header name &quot;:authority&quot;.
27404 #
27405 # For matching a request&#x27;s method, use the headerName &quot;:method&quot;.
27406 #
27407 # When the URL map is bound to a target gRPC proxy that has
27408 # the validateForProxyless field set to true, only
27409 # non-binary
27410 # user-specified custom metadata and the `content-type` header are supported.
27411 # The following transport-level headers cannot be used in header matching
27412 # rules:
27413 # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
27414 # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
27415 # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
27416 # `grpc-timeout` and `grpc-trace-bin`.
27417 &quot;invertMatch&quot;: True or False, # If set to false, the headerMatch is considered a
27418 # match if the preceding match criteria are met. If set to true,
27419 # the headerMatch is considered a match if the preceding
27420 # match criteria are NOT met.
27421 #
27422 # The default setting is false.
27423 &quot;prefixMatch&quot;: &quot;A String&quot;, # The value of the header must start with the contents ofprefixMatch.
27424 #
27425 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
27426 &quot;presentMatch&quot;: True or False, # A header with the contents of headerName must exist. The
27427 # match takes place whether or not the request&#x27;s header has a value.
27428 #
27429 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
27430 &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
27431 # specified in rangeMatch. If the header does not contain an
27432 # integer, number or is empty, the match fails.
27433 #
27434 # For example for a range [-5, 0]
27435 #
27436 #
27437 # - -3 will match.
27438 # - 0 will not match.
27439 # - 0.25 will not match.
27440 # - -3someString will not match.
27441 #
27442 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
27443 #
27444 # rangeMatch is not supported for load balancers
27445 # that have loadBalancingScheme set to EXTERNAL.
27446 # within the specified integer range.
27447 &quot;rangeEnd&quot;: &quot;A String&quot;, # The end of the range (exclusive) in signed long integer format.
27448 &quot;rangeStart&quot;: &quot;A String&quot;, # The start of the range (inclusive) in signed long integer format.
27449 },
27450 &quot;regexMatch&quot;: &quot;A String&quot;, # The value of the header must match the regular expression specified inregexMatch.
27451 # For more information about regular expression syntax, see Syntax.
27452 #
27453 # For matching against a port specified in the HTTP request, use a
27454 # headerMatch with headerName set to PORT and a regular expression that
27455 # satisfies the RFC2616 Host header&#x27;s port specifier.
27456 #
27457 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
27458 #
27459 # Regular expressions can only be used when the loadBalancingScheme is
27460 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
27461 # (regional scope) or INTERNAL_MANAGED.
27462 &quot;suffixMatch&quot;: &quot;A String&quot;, # The value of the header must end with the contents ofsuffixMatch.
27463 #
27464 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
27465 },
27466 ],
27467 &quot;ignoreCase&quot;: True or False, # Specifies that prefixMatch and fullPathMatch
27468 # matches are case sensitive.
27469 #
27470 # The default value is false.
27471 #
27472 # ignoreCase must not be used with regexMatch.
27473 #
27474 # Not supported when the URL map is bound to a target gRPC proxy.
27475 &quot;metadataFilters&quot;: [ # Opaque filter criteria used by the load balancer to restrict routing
27476 # configuration to a limited set of xDS
27477 # compliant clients. In their xDS requests to the load balancer, xDS clients
27478 # present node
27479 # metadata. When there is a match, the relevant routing configuration
27480 # is made available to those proxies.
27481 #
27482 # 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
27483 # the metadata. If its filterMatchCriteria is set to
27484 # MATCH_ALL, then all of its filterLabels must match with
27485 # corresponding labels provided in the metadata. If multiple
27486 # metadata filters are specified, all of them need to be
27487 # satisfied in order to be considered a match.
27488 #
27489 # metadataFilters specified here is applied after those
27490 # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
27491 #
27492 # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
27493 #
27494 # Not supported when the URL map is bound to a target gRPC proxy that
27495 # has validateForProxyless field set to true.
27496 { # Opaque filter criteria used by load balancers to restrict routing
27497 # configuration to a limited set of load balancing proxies. Proxies and
27498 # sidecars involved in load balancing would typically present metadata to the
27499 # load balancers that need to match criteria specified here. If a match takes
27500 # place, the relevant configuration is made available to those
27501 # proxies.
27502 #
27503 # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
27504 # one of thefilterLabels must match the corresponding label provided in
27505 # the metadata. If its filterMatchCriteria is set to
27506 # MATCH_ALL, then all of its filterLabels must match with
27507 # corresponding labels provided in the metadata.
27508 #
27509 # An example for using metadataFilters would be: if
27510 # load balancing involves
27511 # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in of their XDS requests to loadbalancers.
27512 &quot;filterLabels&quot;: [ # The list of label value pairs that must match labels in the provided
27513 # metadata based on filterMatchCriteria
27514 #
27515 # This list must not be empty and can have at the most 64 entries.
27516 { # MetadataFilter label name value pairs that are expected
27517 # to match corresponding labels presented as metadata to the load balancer.
27518 &quot;name&quot;: &quot;A String&quot;, # Name of metadata label.
27519 #
27520 # The name can have a maximum length of 1024 characters and must be at
27521 # least 1 character long.
27522 &quot;value&quot;: &quot;A String&quot;, # The value of the label must match the specified value.
27523 #
27524 # value can have a maximum length of 1024 characters.
27525 },
27526 ],
27527 &quot;filterMatchCriteria&quot;: &quot;A String&quot;, # Specifies how individual filter label matches
27528 # within the list of filterLabels and contributes toward the
27529 # overall metadataFilter match.
27530 #
27531 # Supported values are:
27532 #
27533 # - MATCH_ANY: at least one of the filterLabels
27534 # must have a matching label in the provided metadata.
27535 # - MATCH_ALL: all filterLabels must have
27536 # matching labels in the provided metadata.
27537 },
27538 ],
27539 &quot;pathTemplateMatch&quot;: &quot;A String&quot;, # If specified, this field defines a path template pattern that must match
27540 # the :path header after the query string is removed.
27541 #
27542 # A path template pattern can include variables and wildcards.
27543 # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
27544 # matches a single path segment, and ** that matches zero or
27545 # more path segments. The pattern must follow these rules:
27546 #
27547 #
27548 # - The value must be between 1 and 1024 characters.
27549 # - The pattern must start with a leading slash (&quot;/&quot;).
27550 # - No more than 5 operators (variables or wildcards) may appear in
27551 # the pattern.
27552 #
27553 # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
27554 # set.
27555 &quot;prefixMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the request&#x27;s
27556 # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
27557 #
27558 # The value must be from 1 to 1024 characters.
27559 #
27560 # The * character inside a prefix match is
27561 # treated as a literal character, not as a wildcard.
27562 #
27563 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
27564 # used within a matchRule.
27565 &quot;queryParameterMatches&quot;: [ # Specifies a list of query parameter match criteria, all of which must
27566 # match corresponding query parameters in the request.
27567 #
27568 # Not supported when the URL map is bound to a target gRPC proxy.
27569 { # HttpRouteRuleMatch criteria for a request&#x27;s query parameter.
27570 &quot;exactMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
27571 # parameter exactly matches the contents of exactMatch.
27572 #
27573 # Only one of presentMatch, exactMatch, orregexMatch must be set.
27574 &quot;name&quot;: &quot;A String&quot;, # The name of the query parameter to match. The query parameter must exist in
27575 # the request, in the absence of which the request match fails.
27576 &quot;presentMatch&quot;: True or False, # Specifies that the queryParameterMatch matches if the
27577 # request contains the query parameter, irrespective of whether the
27578 # parameter has a value or not.
27579 #
27580 # Only one of presentMatch, exactMatch, orregexMatch must be set.
27581 &quot;regexMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
27582 # parameter matches the regular expression specified byregexMatch. For
27583 # more information about regular expression syntax, see Syntax.
27584 #
27585 # Only one of presentMatch, exactMatch, orregexMatch must be set.
27586 #
27587 # Regular expressions can only be used when the loadBalancingScheme is
27588 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
27589 # (regional scope) or INTERNAL_MANAGED.
27590 },
27591 ],
27592 &quot;regexMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
27593 # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
27594 # supplied with the original URL. For
27595 # more information about regular expression syntax, see Syntax.
27596 #
27597 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
27598 # specified.
27599 #
27600 # Regular expressions can only be used when the loadBalancingScheme is
27601 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
27602 # (regional scope) or INTERNAL_MANAGED.
27603 },
27604 ],
27605 &quot;priority&quot;: 42, # For routeRules within a given pathMatcher,
27606 # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
27607 # of priority, from the lowest to highest number. The priority of a
27608 # rule decreases as its number increases (1, 2, 3, N+1). The first rule
27609 # that matches the request is applied.
27610 #
27611 #
27612 # You cannot configure two or more routeRules with the same priority.
27613 # Priority for each rule must be set to a number from 0 to 2147483647
27614 # inclusive.
27615 #
27616 #
27617 # Priority numbers can have gaps, which enable you to add or remove rules
27618 # in the future without affecting the rest of the rules. For example, 1, 2,
27619 # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
27620 # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
27621 # without any impact on existing rules.
27622 &quot;routeAction&quot;: { # In response to a matching matchRule, the load balancer
27623 # performs advanced routing actions, such as URL rewrites and header
27624 # transformations, before forwarding the request to the selected backend.
27625 #
27626 #
27627 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
27628 #
27629 #
27630 # URL maps for classic Application Load Balancers only support
27631 # the urlRewrite action within a route rule&#x27;srouteAction.
27632 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
27633 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
27634 # property must be specified. This policy cannot be specified if any target
27635 # backend has Identity-Aware Proxy enabled.
27636 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
27637 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
27638 # header names can be specified. The cache is bypassed for all `cacheMode`
27639 # values.
27640 &quot;A String&quot;,
27641 ],
27642 &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
27643 # on the backend type: for Backend Services, the complete request URI is
27644 # used; for Backend Buckets, the request URI is used without the protocol or
27645 # host, and only query parameters known to Cloud Storage are included.
27646 # Policy defined on Route Action.
27647 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
27648 # parameters will be included. Either specify `excludedQueryParameters`
27649 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
27650 # encoded and not treated as delimiters.
27651 #
27652 # Note: This field applies to routes that use backend services. Attempting
27653 # to set it on a route that points exclusively to Backend Buckets will
27654 # result in a configuration error. For routes that point to a Backend
27655 # Bucket, use `includedQueryParameters` to define which parameters should
27656 # be part of the cache key.
27657 &quot;A String&quot;,
27658 ],
27659 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
27660 #
27661 # Note: This setting is only applicable to routes that use a Backend
27662 # Service. It does not affect requests served by a Backend Bucket, as the
27663 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
27664 # it on a route that points exclusively to Backend Buckets will result in a
27665 # configuration error.
27666 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
27667 #
27668 # Note: This setting is only applicable to routes that use a Backend
27669 # Service. It does not affect requests served by a Backend Bucket, as the
27670 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
27671 # set on a route that points exclusively to Backend Buckets will result in
27672 # a configuration error.
27673 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
27674 # `includedQueryParameters` and `excludedQueryParameters`. If neither
27675 # is set, the entire query string will be included. If false, the query
27676 # string will be excluded from the cache key entirely.
27677 #
27678 # Note: This field applies to routes that use backend services. Attempting
27679 # to set it on a route that points exclusively to Backend Buckets will
27680 # result in a configuration error. For routes that point to a Backend
27681 # Bucket, use `includedQueryParameters` to define which parameters should
27682 # be part of the cache key.
27683 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
27684 # The name=value pair will be used in the cache key Cloud CDN generates.
27685 #
27686 # Note: This setting is only applicable to routes that use a Backend
27687 # Service. It does not affect requests served by a Backend Bucket.
27688 # Attempting to set it on a route that points exclusively to Backend
27689 # Buckets will result in a configuration error. Up to 5 cookie names can be
27690 # specified.
27691 &quot;A String&quot;,
27692 ],
27693 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
27694 &quot;A String&quot;,
27695 ],
27696 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
27697 # parameters will be excluded. Either specify `includedQueryParameters`
27698 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
27699 # encoded and not treated as delimiters.
27700 &quot;A String&quot;,
27701 ],
27702 },
27703 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
27704 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
27705 &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
27706 # content. This is used to clamp the max-age (or Expires) value sent to the
27707 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
27708 # is used for the response max-age directive, along with a &quot;public&quot;
27709 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
27710 # clamps the max-age from the origin (if specified), or else sets the
27711 # response max-age directive to the lesser of the `clientTtl` and
27712 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
27713 # present. The maximum allowed value is 31,622,400s (1 year). If not
27714 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
27715 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
27716 # `USE_ORIGIN_HEADERS`.
27717 # as a count of seconds and fractions of seconds at nanosecond
27718 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
27719 # or &quot;month&quot;. Range is approximately 10,000 years.
27720 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
27721 # Durations less than one second are represented with a 0
27722 # `seconds` field and a positive `nanos` field. Must be from 0
27723 # to 999,999,999 inclusive.
27724 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
27725 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
27726 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
27727 },
27728 &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
27729 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
27730 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
27731 # greater than that of `maxTtl`. When the `cacheMode` is set to
27732 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
27733 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
27734 # accessed objects may be evicted from the cache before the defined TTL. If
27735 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
27736 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
27737 # `USE_ORIGIN_HEADERS`.
27738 # as a count of seconds and fractions of seconds at nanosecond
27739 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
27740 # or &quot;month&quot;. Range is approximately 10,000 years.
27741 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
27742 # Durations less than one second are represented with a 0
27743 # `seconds` field and a positive `nanos` field. Must be from 0
27744 # to 999,999,999 inclusive.
27745 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
27746 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
27747 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
27748 },
27749 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
27750 # attempt to set a max-age or s-maxage higher than this, or an Expires header
27751 # more than `maxTtl` seconds in the future will be capped at the value of
27752 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
27753 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
27754 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
27755 # Infrequently accessed objects may be evicted from the cache before the
27756 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
27757 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
27758 # mode.
27759 # as a count of seconds and fractions of seconds at nanosecond
27760 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
27761 # or &quot;month&quot;. Range is approximately 10,000 years.
27762 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
27763 # Durations less than one second are represented with a 0
27764 # `seconds` field and a positive `nanos` field. Must be from 0
27765 # to 999,999,999 inclusive.
27766 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
27767 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
27768 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
27769 },
27770 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
27771 # to apply fine-grained caching for common errors or redirects.
27772 # This can reduce the load on your origin and improve end-user
27773 # experience by reducing response latency.
27774 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
27775 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
27776 # the specified response code that lack any Cache-Control, Expires, or
27777 # Pragma: no-cache directives. When the `cacheMode` is set to
27778 # `FORCE_CACHE_ALL`, negative caching applies to all responses
27779 # with the specified response code, and overrides any caching headers. By
27780 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
27781 #
27782 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
27783 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
27784 # * 405 (Method Not Found), 501 (Not Implemented): 60s
27785 #
27786 # These defaults can be overridden in `negativeCachingPolicy`.
27787 # If not specified, Cloud CDN applies negative caching by default.
27788 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
27789 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
27790 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
27791 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
27792 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
27793 # all response codes that you wish to cache. Cloud CDN will not apply any
27794 # default negative caching when a policy exists.
27795 { # Specify CDN TTLs for response error codes.
27796 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
27797 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
27798 # specified as values, and you cannot specify a status code more than
27799 # once.
27800 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
27801 # corresponding status code.
27802 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
27803 # objects may be evicted from the cache before the defined TTL.
27804 # as a count of seconds and fractions of seconds at nanosecond
27805 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
27806 # or &quot;month&quot;. Range is approximately 10,000 years.
27807 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
27808 # Durations less than one second are represented with a 0
27809 # `seconds` field and a positive `nanos` field. Must be from 0
27810 # to 999,999,999 inclusive.
27811 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
27812 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
27813 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
27814 },
27815 },
27816 ],
27817 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
27818 # requests into a small number of requests to the origin. If not specified,
27819 # Cloud CDN applies request coalescing by default.
27820 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
27821 # content with the origin, or when an error is encountered when refreshing
27822 # the cache.
27823 # This setting defines the default &quot;max-stale&quot; duration for any cached
27824 # responses that do not specify a max-stale directive. Stale responses that
27825 # exceed the TTL configured here will not be served. The default limit
27826 # (max-stale) is 86400s (1 day), which will allow stale content to be
27827 # served up to this limit beyond the max-age (or s-maxage) of a cached
27828 # response.
27829 # The maximum allowed value is 604800 (1 week).
27830 # Set this to zero (0) to disable serve-while-stale.
27831 # as a count of seconds and fractions of seconds at nanosecond
27832 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
27833 # or &quot;month&quot;. Range is approximately 10,000 years.
27834 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
27835 # Durations less than one second are represented with a 0
27836 # `seconds` field and a positive `nanos` field. Must be from 0
27837 # to 999,999,999 inclusive.
27838 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
27839 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
27840 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
27841 },
27842 },
27843 &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
27844 # information about the W3C recommendation for cross-origin resource sharing
27845 # (CORS), see Fetch API Living
27846 # Standard.
27847 #
27848 # Not supported when the URL map is bound to a target gRPC proxy.
27849 # information about the W3C recommendation for cross-origin resource sharing
27850 # (CORS), see Fetch API Living
27851 # Standard.
27852 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
27853 # indicates that
27854 # the actual request can include user credentials. This field translates to
27855 # the Access-Control-Allow-Credentials header.
27856 #
27857 # Default is false.
27858 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
27859 # header.
27860 &quot;A String&quot;,
27861 ],
27862 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
27863 # header.
27864 &quot;A String&quot;,
27865 ],
27866 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
27867 # more information, see regular expression syntax.
27868 #
27869 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
27870 #
27871 # Regular expressions can only be used when the loadBalancingScheme is
27872 # set to INTERNAL_SELF_MANAGED.
27873 &quot;A String&quot;,
27874 ],
27875 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
27876 #
27877 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
27878 &quot;A String&quot;,
27879 ],
27880 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
27881 # The default value is false, which indicates that the CORS
27882 # policy is in effect.
27883 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
27884 # header.
27885 &quot;A String&quot;,
27886 ],
27887 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
27888 # seconds. This field translates to the Access-Control-Max-Age
27889 # header.
27890 },
27891 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
27892 # the resiliency of clients to backend service failure. As part of fault
27893 # injection, when clients send requests to a backend service, delays can be
27894 # introduced by a load balancer on a percentage of requests before sending
27895 # those requests to the backend service. Similarly requests from clients can
27896 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
27897 # that are configured with a fault_injection_policy if:
27898 # 1. The traffic is generated by fault injection AND
27899 # 2. The fault injection is not a delay fault injection.
27900 # Fault injection is not supported with the classic Application Load Balancer
27901 # . To see which load balancers support fault injection,
27902 # see Load
27903 # balancing: Routing and traffic management features.
27904 # the resiliency of clients to backend service failure. As part of fault
27905 # injection, when clients send requests to a backend service, delays can be
27906 # introduced by the load balancer on a percentage of requests before sending
27907 # those request to the backend service. Similarly requests from clients can be
27908 # aborted by the load balancer for a percentage of requests.
27909 &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
27910 # injection.
27911 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
27912 #
27913 # The value must be from 200 to 599 inclusive.
27914 #
27915 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
27916 # according to this
27917 # mapping table. HTTP status 200 is mapped to gRPC status
27918 # UNKNOWN. Injecting an OK status is currently not supported by
27919 # Traffic Director.
27920 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
27921 # that is aborted as part of fault injection.
27922 #
27923 # The value must be from 0.0 to 100.0 inclusive.
27924 },
27925 &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
27926 # injection, before being sent to a backend service.
27927 # request to the backend service as part of fault injection.
27928 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
27929 # as a count of seconds and fractions of seconds at nanosecond
27930 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
27931 # or &quot;month&quot;. Range is approximately 10,000 years.
27932 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
27933 # Durations less than one second are represented with a 0
27934 # `seconds` field and a positive `nanos` field. Must be from 0
27935 # to 999,999,999 inclusive.
27936 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
27937 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
27938 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
27939 },
27940 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
27941 # which a delay is introduced as part of fault injection.
27942 #
27943 # The value must be from 0.0 to 100.0 inclusive.
27944 },
27945 },
27946 &quot;imageOptimizationPolicy&quot;: { # The configuration for Cloud CDN&#x27;s image optimization feature. This feature # Image optimization policy for this URL Map&#x27;s route. Available only for
27947 # Global EXTERNAL_MANAGED load balancer schemes.
27948 # Either Cloud CDN must be enabled on the backend service or backend bucket
27949 # serving the route, or cache policy must be configured on the same route
27950 # dynamically processes and delivers images from the network edge.
27951 # Image Optimization is only available for Global External Application Load
27952 # Balancers.
27953 # Either Cloud CDN must be enabled on the backend service or backend bucket
27954 # serving the route, or cache policy must be configured on the same route.
27955 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
27956 },
27957 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
27958 # Unlike the timeout field where the timeout duration starts
27959 # from the time the request has been fully processed (known as*end-of-stream*),
27960 # the duration in this field is computed from the beginning of the stream
27961 # until the response has been processed, including all retries. A
27962 # stream that does not complete in this duration is closed.
27963 #
27964 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
27965 # with the route.
27966 #
27967 # This field is only allowed if the Url map is used with backend services
27968 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
27969 # as a count of seconds and fractions of seconds at nanosecond
27970 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
27971 # or &quot;month&quot;. Range is approximately 10,000 years.
27972 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
27973 # Durations less than one second are represented with a 0
27974 # `seconds` field and a positive `nanos` field. Must be from 0
27975 # to 999,999,999 inclusive.
27976 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
27977 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
27978 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
27979 },
27980 &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
27981 # are shadowed to a separate mirrored backend service. The load balancer does
27982 # not wait for responses from the shadow service. Before sending traffic
27983 # to the shadow service, the host / authority header is suffixed with-shadow.
27984 #
27985 # Not supported when the URL map is bound to a target gRPC proxy that
27986 # has the validateForProxyless field set to true.
27987 # are shadowed to a separate mirrored backend service. The load balancer
27988 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
27989 # to the shadow service, the host or authority header is suffixed with-shadow.
27990 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
27991 # mirrored to.
27992 #
27993 # The backend service configured for a mirroring
27994 # policy must reference backends that are of the same type as the original
27995 # backend service matched in the URL map.
27996 #
27997 # Serverless NEG backends are not currently supported as a mirrored
27998 # backend service.
27999 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
28000 },
28001 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
28002 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
28003 # If not specified, defaults to 1.
28004 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
28005 #
28006 # If not specified, will use the timeout set in theHttpRouteAction field.
28007 # If timeout in the HttpRouteAction field is not set, this field
28008 # uses the largest timeout
28009 # among all backend services associated with the route.
28010 #
28011 # Not supported when the URL map is bound to a target gRPC proxy that
28012 # has the validateForProxyless field set to true.
28013 # as a count of seconds and fractions of seconds at nanosecond
28014 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
28015 # or &quot;month&quot;. Range is approximately 10,000 years.
28016 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
28017 # Durations less than one second are represented with a 0
28018 # `seconds` field and a positive `nanos` field. Must be from 0
28019 # to 999,999,999 inclusive.
28020 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
28021 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
28022 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
28023 },
28024 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
28025 # values are:
28026 #
28027 # - 5xx: retry is attempted if the instance or endpoint
28028 # responds with any 5xx response code, or if the instance or
28029 # endpoint does not respond at all. For example, disconnects, reset, read
28030 # timeout, connection failure, and refused streams.
28031 # - gateway-error: Similar to 5xx, but only
28032 # applies to response codes 502, 503 or504.
28033 # - connect-failure: a retry is attempted on failures
28034 # connecting to the instance or endpoint. For example, connection
28035 # timeouts.
28036 # - retriable-4xx: a retry is attempted if the instance
28037 # or endpoint responds with a 4xx response code.
28038 # The only error that you can retry is error code 409.
28039 # - refused-stream: a retry is attempted if the instance
28040 # or endpoint resets the stream with a REFUSED_STREAM error
28041 # code. This reset type indicates that it is safe to retry.
28042 # - cancelled: a retry is attempted if the gRPC status
28043 # code in the response header is set to cancelled.
28044 # - deadline-exceeded: a retry is attempted if the gRPC
28045 # status code in the response header is set todeadline-exceeded.
28046 # - internal: a retry is attempted if the gRPC
28047 # status code in the response header is set tointernal.
28048 # - resource-exhausted: a retry is attempted if the gRPC
28049 # status code in the response header is set toresource-exhausted.
28050 # - unavailable: a retry is attempted if the gRPC
28051 # status code in the response header is set tounavailable.
28052 #
28053 # Only the following codes are supported when the URL map is bound to
28054 # target gRPC proxy that has validateForProxyless field set to true.
28055 #
28056 # - cancelled
28057 # - deadline-exceeded
28058 # - internal
28059 # - resource-exhausted
28060 # - unavailable
28061 &quot;A String&quot;,
28062 ],
28063 },
28064 &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
28065 # time the request has been fully processed (known as *end-of-stream*)
28066 # up until the response has been processed. Timeout includes
28067 # all retries.
28068 #
28069 # If not specified, this field uses the largest timeout among all backend
28070 # services associated with the route.
28071 #
28072 # Not supported when the URL map is bound to a target gRPC proxy that
28073 # has validateForProxyless field set to true.
28074 # as a count of seconds and fractions of seconds at nanosecond
28075 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
28076 # or &quot;month&quot;. Range is approximately 10,000 years.
28077 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
28078 # Durations less than one second are represented with a 0
28079 # `seconds` field and a positive `nanos` field. Must be from 0
28080 # to 999,999,999 inclusive.
28081 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
28082 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
28083 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
28084 },
28085 &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
28086 # to the matched service.
28087 #
28088 # urlRewrite is the only action supported in UrlMaps
28089 # for classic Application Load Balancers.
28090 #
28091 # Not supported when the URL map is bound to a target gRPC proxy that
28092 # has the validateForProxyless field set to true.
28093 # backend service.
28094 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
28095 # host header is replaced with contents of hostRewrite.
28096 #
28097 # The value must be from 1 to 255 characters.
28098 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
28099 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
28100 #
28101 # The value must be from 1 to 1024 characters.
28102 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
28103 # header) using the HTTP template syntax.
28104 #
28105 # A corresponding
28106 # path_template_match must be specified. Any template variables must exist in
28107 # the path_template_match field.
28108 #
28109 #
28110 # - -At least one variable must be specified in the path_template_match
28111 # field
28112 # - You can omit variables from the rewritten URL
28113 # - The * and ** operators cannot be matched
28114 # unless they have a corresponding variable name - e.g.
28115 # {format=*} or {var=**}.
28116 #
28117 # For example, a path_template_match of /static/{format=**}
28118 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
28119 # rewrite, so that /{country}/{format}/{suffix=**} can be
28120 # rewritten as /content/{format}/{country}/{suffix}.
28121 #
28122 # At least
28123 # one non-empty routeRules[].matchRules[].path_template_match is
28124 # required.
28125 #
28126 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
28127 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
28128 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
28129 # It uses RE2 syntax with the following constraints:
28130 #
28131 #
28132 # - Any single character operators
28133 # - Groups are allowed to have only submatch operator inside
28134 # - Groups are allowed only without any char repetition, e.g.
28135 # .*
28136 # - Any char repetition, e.g. .*, is
28137 # only allowed to be used in a single regex together with:
28138 #
28139 #
28140 # - Empty string operators
28141 # - Other repetitions
28142 # - Ranges
28143 # - Repetitions of ranges
28144 #
28145 #
28146 # - Ranges are only allowed to have:
28147 #
28148 #
28149 # - Character range
28150 # - Digits range
28151 # - Symbols listed in characters allowed for ranges
28152 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
28153 # the path.
28154 },
28155 },
28156 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
28157 # occurs. The weights determine the fraction of traffic that flows to
28158 # their corresponding backend service. If all traffic needs to
28159 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
28160 #
28161 # After a backend service is identified and before forwarding
28162 # the request to
28163 # the backend service, advanced routing actions such as URL rewrites and
28164 # header transformations are applied depending on additional settings
28165 # specified in this HttpRouteAction.
28166 { # In contrast to a single BackendService in
28167 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
28168 # multiple backend services. The volume of traffic for each
28169 # backend service is proportional to the weight specified
28170 # in each WeightedBackendService
28171 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
28172 # resource. Before
28173 # forwarding the request to backendService, the load balancer
28174 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
28175 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
28176 # effect for the selected backendService.
28177 #
28178 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
28179 #
28180 # headerAction is not supported for load balancers that have
28181 # their loadBalancingScheme set to EXTERNAL.
28182 #
28183 # Not supported when the URL map is bound to a target gRPC proxy that
28184 # has validateForProxyless field set to true.
28185 # the request is passed along to the selected backendService.
28186 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
28187 { # Specification determining how headers are added to requests or responses.
28188 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
28189 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
28190 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
28191 # that already
28192 # exist for the header. If true, headerValue is set for the
28193 # header, discarding any values that were set for that header.
28194 #
28195 # The default value is true,
28196 # unless a variable is present in headerValue,
28197 # in which case the default value is false.
28198 # .
28199 },
28200 ],
28201 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
28202 # request before forwarding the request to the backendService.
28203 &quot;A String&quot;,
28204 ],
28205 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
28206 # client.
28207 { # Specification determining how headers are added to requests or responses.
28208 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
28209 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
28210 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
28211 # that already
28212 # exist for the header. If true, headerValue is set for the
28213 # header, discarding any values that were set for that header.
28214 #
28215 # The default value is true,
28216 # unless a variable is present in headerValue,
28217 # in which case the default value is false.
28218 # .
28219 },
28220 ],
28221 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
28222 # response before sending the response back to the client.
28223 &quot;A String&quot;,
28224 ],
28225 },
28226 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
28227 # computed asweight / (sum of all weightedBackendService weights in routeAction).
28228 #
28229 # The selection of a backend service is determined only for new traffic.
28230 # Once a user&#x27;s request has been directed to a backend service,
28231 # subsequent requests are sent to the same backend service as
28232 # determined by the backend service&#x27;s session affinity policy.
28233 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
28234 # splitting. If you do, the weighted traffic splitting configuration takes
28235 # precedence.
28236 #
28237 # The value must be from 0 to 1000.
28238 },
28239 ],
28240 },
28241 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
28242 # is directed if this rule is matched. If routeAction is
28243 # also specified, advanced routing actions, such as URL rewrites,
28244 # take effect before sending the request to the backend.
28245 #
28246 #
28247 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
28248 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
28249 # specified by urlRedirect.
28250 #
28251 #
28252 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
28253 #
28254 #
28255 # Not supported when the URL map is bound to a target gRPC proxy.
28256 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
28257 # was supplied in the request.
28258 #
28259 # The value must be from 1 to 255
28260 # characters.
28261 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
28262 # set to HTTPS.
28263 # If set to false, the URL scheme of the redirected request
28264 # remains the same as that of the request.
28265 #
28266 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
28267 #
28268 # The default is set to false.
28269 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
28270 # that was supplied in the request.
28271 #
28272 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
28273 # supplied, the path of the original request is used for the redirect.
28274 #
28275 # The value must be from 1 to 1024 characters.
28276 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
28277 # the HttpRouteRuleMatch, retaining the remaining portion
28278 # of the URL before redirecting the request.
28279 #
28280 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
28281 # supplied, the path of the original request is used for the redirect.
28282 #
28283 # The value must be from 1 to 1024 characters.
28284 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
28285 #
28286 # Supported values are:
28287 #
28288 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
28289 # to 301.
28290 # - FOUND, which corresponds to 302.
28291 # - SEE_OTHER which corresponds to 303.
28292 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
28293 # method is retained.
28294 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
28295 # method is retained.
28296 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
28297 # URL is
28298 # removed before redirecting the request. If set to false, the
28299 # query portion of the original URL is retained.
28300 #
28301 # The default is set to false.
28302 },
28303 },
28304 ],
28305 },
28306 ],
28307 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the regional URL map resides.
28308 # This field is not applicable to global URL maps.
28309 # You must specify this field as part of the HTTP request URL. It is
28310 # not settable as a field in the request body.
28311 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
28312 &quot;status&quot;: { # [Output Only] The status of the URL map. # Output only. [Output Only] The status of the URL map.
28313 &quot;quotaUsage&quot;: { # Message representing the quota usage for a UrlMap. # Output only. Summary of quota usage for given UrlMap.
28314 &quot;forwardingRules&quot;: 42, # Output only. The number of forwarding rules that uses this UrlMap.
28315 &quot;units&quot;: &quot;A String&quot;, # Output only. The number of quota units calculated for this UrlMap.
28316 },
28317 },
28318 &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
28319 # maximum of 100 tests per UrlMap.
28320 #
28321 # Not supported when the URL map is bound to a target gRPC proxy that
28322 # has validateForProxyless field set to true.
28323 { # Message for the expected URL mappings.
28324 &quot;backendServiceWeight&quot;: 42, # The weight to use for the supplied host and path when using advanced
28325 # routing rules that involve traffic splitting.
28326 &quot;description&quot;: &quot;A String&quot;, # Description of this test case.
28327 &quot;expectedOutputUrl&quot;: &quot;A String&quot;, # The expected output URL evaluated by the load balancer
28328 # containing the scheme, host, path and query parameters.
28329 #
28330 # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
28331 # the load balancer to backends. For rules with urlRewrite,
28332 # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
28333 #
28334 # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer&#x27;s
28335 # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
28336 # If urlRedirect specifies strip_query, the test
28337 # passes only if expectedOutputUrl does not contain any query
28338 # parameters.
28339 #
28340 # expectedOutputUrl is optional whenservice is specified.
28341 &quot;expectedRedirectResponseCode&quot;: 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
28342 # load balancer&#x27;s redirect response.
28343 #
28344 # expectedRedirectResponseCode cannot be set whenservice is set.
28345 &quot;expectedUrlRedirect&quot;: &quot;A String&quot;, # The expected URL that should be redirected to for the host and path
28346 # being tested.
28347 # [Deprecated] This field is deprecated.
28348 # Use expected_output_url instead.
28349 &quot;headers&quot;: [ # HTTP headers for this request. If headers contains
28350 # a host header, then host must also match the header value.
28351 { # HTTP headers used in UrlMapTests.
28352 &quot;name&quot;: &quot;A String&quot;, # Header name.
28353 &quot;value&quot;: &quot;A String&quot;, # Header value.
28354 },
28355 ],
28356 &quot;host&quot;: &quot;A String&quot;, # Host portion of the URL. If headers contains a host header,
28357 # then host must also match the header value.
28358 &quot;path&quot;: &quot;A String&quot;, # Path portion of the URL.
28359 &quot;service&quot;: &quot;A String&quot;, # Expected BackendService or BackendBucket resource
28360 # the given URL should be mapped to.
28361 #
28362 # The service field cannot
28363 # be set if expectedRedirectResponseCode is set.
28364 },
28365 ],
28366 },
28367 }
28368
28369 x__xgafv: string, V1 error format.
28370 Allowed values
28371 1 - v1 error format
28372 2 - v2 error format
28373
28374 Returns:
28375 An object of the form:
28376
28377 {
28378 &quot;result&quot;: { # Message representing the validation result for a UrlMap.
28379 &quot;loadErrors&quot;: [
28380 &quot;A String&quot;,
28381 ],
28382 &quot;loadSucceeded&quot;: True or False, # Whether the given UrlMap can be successfully loaded.
28383 # If false, &#x27;loadErrors&#x27; indicates the reasons.
28384 &quot;quotaUsage&quot;: { # Message representing the quota usage for a UrlMap. # Output only. Summary of quota usage for given UrlMap.
28385 &quot;forwardingRules&quot;: 42, # Output only. The number of forwarding rules that uses this UrlMap.
28386 &quot;units&quot;: &quot;A String&quot;, # Output only. The number of quota units calculated for this UrlMap.
28387 },
28388 &quot;testFailures&quot;: [
28389 {
28390 &quot;actualOutputUrl&quot;: &quot;A String&quot;, # The actual output URL evaluated by a load balancer containing the scheme,
28391 # host, path and query parameters.
28392 &quot;actualRedirectResponseCode&quot;: 42, # Actual HTTP status code for rule with `urlRedirect`
28393 # calculated by load balancer
28394 &quot;actualService&quot;: &quot;A String&quot;, # BackendService or BackendBucket returned by load
28395 # balancer.
28396 &quot;expectedOutputUrl&quot;: &quot;A String&quot;, # The expected output URL evaluated by a load balancer containing the scheme,
28397 # host, path and query parameters.
28398 &quot;expectedRedirectResponseCode&quot;: 42, # Expected HTTP status code for rule with `urlRedirect`
28399 # calculated by load balancer
28400 &quot;expectedService&quot;: &quot;A String&quot;, # Expected BackendService or BackendBucket resource
28401 # the given URL should be mapped to.
28402 &quot;headers&quot;: [ # HTTP headers of the request.
28403 { # HTTP headers used in UrlMapTests.
28404 &quot;name&quot;: &quot;A String&quot;, # Header name.
28405 &quot;value&quot;: &quot;A String&quot;, # Header value.
28406 },
28407 ],
28408 &quot;host&quot;: &quot;A String&quot;, # Host portion of the URL.
28409 &quot;path&quot;: &quot;A String&quot;, # Path portion including query parameters in the URL.
28410 },
28411 ],
28412 &quot;testPassed&quot;: True or False, # If successfully loaded, this field indicates whether the test passed.
28413 # If false, &#x27;testFailures&#x27;s indicate the reason of failure.
28414 },
28415 }</pre>
28416 </div>
28417
28418 </body></html>