Debian Codegraph @

docs/dyn/compute_beta.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_beta.html">Compute Engine API</a> . <a href="compute_beta.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/beta/urlMaps)
237 # * [Regional](/compute/docs/reference/rest/beta/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 },
871 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
872 # occurs. The weights determine the fraction of traffic that flows to
873 # their corresponding backend service. If all traffic needs to
874 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
875 #
876 # After a backend service is identified and before forwarding
877 # the request to
878 # the backend service, advanced routing actions such as URL rewrites and
879 # header transformations are applied depending on additional settings
880 # specified in this HttpRouteAction.
881 { # In contrast to a single BackendService in
882 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
883 # multiple backend services. The volume of traffic for each
884 # backend service is proportional to the weight specified
885 # in each WeightedBackendService
886 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
887 # resource. Before
888 # forwarding the request to backendService, the load balancer
889 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
890 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
891 # effect for the selected backendService.
892 #
893 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
894 #
895 # headerAction is not supported for load balancers that have
896 # their loadBalancingScheme set to EXTERNAL.
897 #
898 # Not supported when the URL map is bound to a target gRPC proxy that
899 # has validateForProxyless field set to true.
900 # the request is passed along to the selected backendService.
901 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
902 { # Specification determining how headers are added to requests or responses.
903 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
904 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
905 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
906 # that already
907 # exist for the header. If true, headerValue is set for the
908 # header, discarding any values that were set for that header.
909 #
910 # The default value is true,
911 # unless a variable is present in headerValue,
912 # in which case the default value is false.
913 # .
914 },
915 ],
916 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
917 # request before forwarding the request to the backendService.
918 &quot;A String&quot;,
919 ],
920 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
921 # client.
922 { # Specification determining how headers are added to requests or responses.
923 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
924 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
925 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
926 # that already
927 # exist for the header. If true, headerValue is set for the
928 # header, discarding any values that were set for that header.
929 #
930 # The default value is true,
931 # unless a variable is present in headerValue,
932 # in which case the default value is false.
933 # .
934 },
935 ],
936 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
937 # response before sending the response back to the client.
938 &quot;A String&quot;,
939 ],
940 },
941 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
942 # computed asweight / (sum of all weightedBackendService weights in routeAction).
943 #
944 # The selection of a backend service is determined only for new traffic.
945 # Once a user&#x27;s request has been directed to a backend service,
946 # subsequent requests are sent to the same backend service as
947 # determined by the backend service&#x27;s session affinity policy.
948 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
949 # splitting. If you do, the weighted traffic splitting configuration takes
950 # precedence.
951 #
952 # The value must be from 0 to 1000.
953 },
954 ],
955 },
956 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL of the defaultService resource to
957 # which traffic is directed if none of the hostRules match.
958 # If defaultRouteAction is also specified, advanced
959 # routing actions, such as URL rewrites, take effect before sending the
960 # request to the backend.
961 #
962 #
963 # Only one of defaultUrlRedirect, defaultService
964 # or defaultRouteAction.weightedBackendService can be set.
965 #
966 #
967 # defaultService has no effect when the URL map is bound
968 # to a target gRPC proxy that has the validateForProxyless field
969 # set to true.
970 &quot;defaultUrlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
971 # is redirected to a URL specified by defaultUrlRedirect.
972 #
973 #
974 # Only one of defaultUrlRedirect, defaultService
975 # or defaultRouteAction.weightedBackendService can be set.
976 #
977 #
978 # Not supported when the URL map is bound to a target gRPC proxy.
979 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
980 # was supplied in the request.
981 #
982 # The value must be from 1 to 255
983 # characters.
984 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
985 # set to HTTPS.
986 # If set to false, the URL scheme of the redirected request
987 # remains the same as that of the request.
988 #
989 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
990 #
991 # The default is set to false.
992 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
993 # that was supplied in the request.
994 #
995 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
996 # supplied, the path of the original request is used for the redirect.
997 #
998 # The value must be from 1 to 1024 characters.
999 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
1000 # the HttpRouteRuleMatch, retaining the remaining portion
1001 # of the URL before redirecting the request.
1002 #
1003 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
1004 # supplied, the path of the original request is used for the redirect.
1005 #
1006 # The value must be from 1 to 1024 characters.
1007 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
1008 #
1009 # Supported values are:
1010 #
1011 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
1012 # to 301.
1013 # - FOUND, which corresponds to 302.
1014 # - SEE_OTHER which corresponds to 303.
1015 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
1016 # method is retained.
1017 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
1018 # method is retained.
1019 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
1020 # URL is
1021 # removed before redirecting the request. If set to false, the
1022 # query portion of the original URL is retained.
1023 #
1024 # The default is set to false.
1025 },
1026 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
1027 # create the resource.
1028 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. A hash of the contents stored in this object.
1029 # This field is used in optimistic locking. This field is ignored when
1030 # inserting a UrlMap. An up-to-date fingerprint must be provided
1031 # in order to update the UrlMap, otherwise the request will
1032 # fail with error 412 conditionNotMet.
1033 #
1034 # To see the latest fingerprint, make a get() request to
1035 # retrieve a UrlMap.
1036 &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
1037 # for the selected backendService.
1038 #
1039 # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
1040 #
1041 # headerAction is not supported for load balancers
1042 # that have
1043 # their loadBalancingScheme set to EXTERNAL.
1044 #
1045 # Not supported when the URL map is bound to a target gRPC proxy that
1046 # has validateForProxyless field set to true.
1047 # the request is passed along to the selected backendService.
1048 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
1049 { # Specification determining how headers are added to requests or responses.
1050 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
1051 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
1052 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
1053 # that already
1054 # exist for the header. If true, headerValue is set for the
1055 # header, discarding any values that were set for that header.
1056 #
1057 # The default value is true,
1058 # unless a variable is present in headerValue,
1059 # in which case the default value is false.
1060 # .
1061 },
1062 ],
1063 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
1064 # request before forwarding the request to the backendService.
1065 &quot;A String&quot;,
1066 ],
1067 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
1068 # client.
1069 { # Specification determining how headers are added to requests or responses.
1070 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
1071 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
1072 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
1073 # that already
1074 # exist for the header. If true, headerValue is set for the
1075 # header, discarding any values that were set for that header.
1076 #
1077 # The default value is true,
1078 # unless a variable is present in headerValue,
1079 # in which case the default value is false.
1080 # .
1081 },
1082 ],
1083 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
1084 # response before sending the response back to the client.
1085 &quot;A String&quot;,
1086 ],
1087 },
1088 &quot;hostRules&quot;: [ # The list of host rules to use against the URL.
1089 { # UrlMaps
1090 # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
1091 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
1092 # create the resource.
1093 &quot;hosts&quot;: [ # The list of host patterns to match. They must be valid hostnames with
1094 # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
1095 # that case, * must be the first character, and if followed by
1096 # anything, the immediate following character must be either -
1097 # or ..
1098 #
1099 # * based matching is not supported when the URL map is bound
1100 # to a target gRPC proxy that has the validateForProxyless field
1101 # set to true.
1102 &quot;A String&quot;,
1103 ],
1104 &quot;pathMatcher&quot;: &quot;A String&quot;, # The name of the PathMatcher to use to match the path portion
1105 # of the URL if the hostRule matches the URL&#x27;s host portion.
1106 },
1107 ],
1108 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the resource. This identifier is
1109 # defined by the server.
1110 &quot;kind&quot;: &quot;compute#urlMap&quot;, # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
1111 # url maps.
1112 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
1113 # The name must be 1-63 characters long, and comply withRFC1035.
1114 # Specifically, the name must be 1-63 characters long and match the regular
1115 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
1116 # character must be a lowercase letter, and all following characters must
1117 # be a dash, lowercase letter, or digit, except the last character, which
1118 # cannot be a dash.
1119 &quot;pathMatchers&quot;: [ # The list of named PathMatchers to use against the URL.
1120 { # A matcher for the path portion of the URL. The BackendService
1121 # from the longest-matched rule will serve the URL. If no rule was matched, the
1122 # default service is used.
1123 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
1124 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
1125 #
1126 # This policy takes
1127 # effect at the PathMatcher level and applies only when no
1128 # 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
1129 # in defaultCustomErrorResponsePolicy, then a policy defined for
1130 # the error code in UrlMap.defaultCustomErrorResponsePolicy
1131 # takes effect.
1132 #
1133 # For example, consider a UrlMap with the following
1134 # configuration:
1135 #
1136 #
1137 # - UrlMap.defaultCustomErrorResponsePolicy is configured
1138 # with policies for 5xx and 4xx errors
1139 # - A RouteRule for /coming_soon/ is configured for the
1140 # error code 404.
1141 #
1142 # 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
1143 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
1144 # the policy in RouteRule.customErrorResponsePolicy takes
1145 # effect. If any of the requests in this example encounter a 500
1146 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
1147 #
1148 # When
1149 # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
1150 # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
1151 # a retry, if load balancer is successful in reaching the
1152 # service, the defaultCustomErrorResponsePolicy is ignored and
1153 # the response from the service is returned to the client.
1154 #
1155 # defaultCustomErrorResponsePolicy is supported only for
1156 # global external Application Load Balancers.
1157 # backend service or backend bucket responds with an error.
1158 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
1159 #
1160 # In a given policy, if you specify rules for both a range of error codes
1161 # as well as rules for specific error codes then rules with specific error
1162 # codes have a higher priority. For example, assume that you configure a rule
1163 # for 401 (Un-authorized) code, and another for all 4 series
1164 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
1165 # However if the backend service returns a 403, the rule for4xx takes effect.
1166 { # Specifies the mapping between the response code that will be returned along
1167 # with the custom error content and the response code returned by the backend
1168 # service.
1169 &quot;matchResponseCodes&quot;: [ # Valid values include:
1170 #
1171 #
1172 # - A number between 400 and 599: For example
1173 # 401 or 503, in which case the load balancer
1174 # applies the policy if the error code exactly matches this value.
1175 # - 5xx: Load Balancer will apply the policy if the
1176 # backend service responds with any response code in the range of
1177 # 500 to 599.
1178 # - 4xx: Load
1179 # Balancer will apply the policy if the backend service responds with any
1180 # response code in the range of 400 to
1181 # 499.
1182 #
1183 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
1184 &quot;A String&quot;,
1185 ],
1186 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
1187 # error content. If overrideResponseCode is not supplied, the
1188 # same response code returned by the original backend bucket or backend
1189 # service is returned to the client.
1190 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
1191 #
1192 # path must start
1193 # with a leading slash. path cannot have trailing slashes.
1194 #
1195 # If the file is not available in backendBucket or the
1196 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
1197 #
1198 # The value must
1199 # be from 1 to 1024 characters
1200 },
1201 ],
1202 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
1203 # contains the custom error content. Examples are:
1204 #
1205 #
1206 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
1207 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
1208 # - global/backendBuckets/myBackendBucket
1209 #
1210 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
1211 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
1212 #
1213 # If load balancer cannot reach
1214 # the backendBucket, a simple Not Found Error will
1215 # be returned, with the original response code (oroverrideResponseCode if configured).
1216 #
1217 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
1218 },
1219 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
1220 # pathRules or routeRules match. The load balancer
1221 # performs advanced routing actions, such as URL rewrites and
1222 # header transformations, before forwarding the request to the
1223 # selected backend.
1224 #
1225 #
1226 # Only one of defaultUrlRedirect, defaultService
1227 # or defaultRouteAction.weightedBackendService can be set.
1228 #
1229 #
1230 # URL maps for classic Application Load Balancers only support
1231 # the urlRewrite action within a path matcher&#x27;sdefaultRouteAction.
1232 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
1233 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
1234 # property must be specified. This policy cannot be specified if any target
1235 # backend has Identity-Aware Proxy enabled.
1236 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
1237 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
1238 # header names can be specified. The cache is bypassed for all `cacheMode`
1239 # values.
1240 &quot;A String&quot;,
1241 ],
1242 &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
1243 # on the backend type: for Backend Services, the complete request URI is
1244 # used; for Backend Buckets, the request URI is used without the protocol or
1245 # host, and only query parameters known to Cloud Storage are included.
1246 # Policy defined on Route Action.
1247 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
1248 # parameters will be included. Either specify `excludedQueryParameters`
1249 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
1250 # encoded and not treated as delimiters.
1251 #
1252 # Note: This field applies to routes that use backend services. Attempting
1253 # to set it on a route that points exclusively to Backend Buckets will
1254 # result in a configuration error. For routes that point to a Backend
1255 # Bucket, use `includedQueryParameters` to define which parameters should
1256 # be part of the cache key.
1257 &quot;A String&quot;,
1258 ],
1259 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
1260 #
1261 # Note: This setting is only applicable to routes that use a Backend
1262 # Service. It does not affect requests served by a Backend Bucket, as the
1263 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
1264 # it on a route that points exclusively to Backend Buckets will result in a
1265 # configuration error.
1266 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
1267 #
1268 # Note: This setting is only applicable to routes that use a Backend
1269 # Service. It does not affect requests served by a Backend Bucket, as the
1270 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
1271 # set on a route that points exclusively to Backend Buckets will result in
1272 # a configuration error.
1273 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
1274 # `includedQueryParameters` and `excludedQueryParameters`. If neither
1275 # is set, the entire query string will be included. If false, the query
1276 # string will be excluded from the cache key entirely.
1277 #
1278 # Note: This field applies to routes that use backend services. Attempting
1279 # to set it on a route that points exclusively to Backend Buckets will
1280 # result in a configuration error. For routes that point to a Backend
1281 # Bucket, use `includedQueryParameters` to define which parameters should
1282 # be part of the cache key.
1283 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
1284 # The name=value pair will be used in the cache key Cloud CDN generates.
1285 #
1286 # Note: This setting is only applicable to routes that use a Backend
1287 # Service. It does not affect requests served by a Backend Bucket.
1288 # Attempting to set it on a route that points exclusively to Backend
1289 # Buckets will result in a configuration error. Up to 5 cookie names can be
1290 # specified.
1291 &quot;A String&quot;,
1292 ],
1293 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
1294 &quot;A String&quot;,
1295 ],
1296 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
1297 # parameters will be excluded. Either specify `includedQueryParameters`
1298 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
1299 # encoded and not treated as delimiters.
1300 &quot;A String&quot;,
1301 ],
1302 },
1303 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
1304 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
1305 &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
1306 # content. This is used to clamp the max-age (or Expires) value sent to the
1307 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
1308 # is used for the response max-age directive, along with a &quot;public&quot;
1309 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
1310 # clamps the max-age from the origin (if specified), or else sets the
1311 # response max-age directive to the lesser of the `clientTtl` and
1312 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
1313 # present. The maximum allowed value is 31,622,400s (1 year). If not
1314 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
1315 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
1316 # `USE_ORIGIN_HEADERS`.
1317 # as a count of seconds and fractions of seconds at nanosecond
1318 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1319 # or &quot;month&quot;. Range is approximately 10,000 years.
1320 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1321 # Durations less than one second are represented with a 0
1322 # `seconds` field and a positive `nanos` field. Must be from 0
1323 # to 999,999,999 inclusive.
1324 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1325 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1326 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1327 },
1328 &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
1329 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
1330 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
1331 # greater than that of `maxTtl`. When the `cacheMode` is set to
1332 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
1333 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
1334 # accessed objects may be evicted from the cache before the defined TTL. If
1335 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
1336 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
1337 # `USE_ORIGIN_HEADERS`.
1338 # as a count of seconds and fractions of seconds at nanosecond
1339 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1340 # or &quot;month&quot;. Range is approximately 10,000 years.
1341 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1342 # Durations less than one second are represented with a 0
1343 # `seconds` field and a positive `nanos` field. Must be from 0
1344 # to 999,999,999 inclusive.
1345 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1346 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1347 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1348 },
1349 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
1350 # attempt to set a max-age or s-maxage higher than this, or an Expires header
1351 # more than `maxTtl` seconds in the future will be capped at the value of
1352 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
1353 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
1354 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
1355 # Infrequently accessed objects may be evicted from the cache before the
1356 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
1357 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
1358 # mode.
1359 # as a count of seconds and fractions of seconds at nanosecond
1360 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1361 # or &quot;month&quot;. Range is approximately 10,000 years.
1362 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1363 # Durations less than one second are represented with a 0
1364 # `seconds` field and a positive `nanos` field. Must be from 0
1365 # to 999,999,999 inclusive.
1366 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1367 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1368 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1369 },
1370 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
1371 # to apply fine-grained caching for common errors or redirects.
1372 # This can reduce the load on your origin and improve end-user
1373 # experience by reducing response latency.
1374 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
1375 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
1376 # the specified response code that lack any Cache-Control, Expires, or
1377 # Pragma: no-cache directives. When the `cacheMode` is set to
1378 # `FORCE_CACHE_ALL`, negative caching applies to all responses
1379 # with the specified response code, and overrides any caching headers. By
1380 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
1381 #
1382 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
1383 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
1384 # * 405 (Method Not Found), 501 (Not Implemented): 60s
1385 #
1386 # These defaults can be overridden in `negativeCachingPolicy`.
1387 # If not specified, Cloud CDN applies negative caching by default.
1388 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
1389 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
1390 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
1391 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
1392 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
1393 # all response codes that you wish to cache. Cloud CDN will not apply any
1394 # default negative caching when a policy exists.
1395 { # Specify CDN TTLs for response error codes.
1396 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
1397 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
1398 # specified as values, and you cannot specify a status code more than
1399 # once.
1400 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
1401 # corresponding status code.
1402 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
1403 # objects may be evicted from the cache before the defined TTL.
1404 # as a count of seconds and fractions of seconds at nanosecond
1405 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1406 # or &quot;month&quot;. Range is approximately 10,000 years.
1407 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1408 # Durations less than one second are represented with a 0
1409 # `seconds` field and a positive `nanos` field. Must be from 0
1410 # to 999,999,999 inclusive.
1411 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1412 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1413 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1414 },
1415 },
1416 ],
1417 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
1418 # requests into a small number of requests to the origin. If not specified,
1419 # Cloud CDN applies request coalescing by default.
1420 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
1421 # content with the origin, or when an error is encountered when refreshing
1422 # the cache.
1423 # This setting defines the default &quot;max-stale&quot; duration for any cached
1424 # responses that do not specify a max-stale directive. Stale responses that
1425 # exceed the TTL configured here will not be served. The default limit
1426 # (max-stale) is 86400s (1 day), which will allow stale content to be
1427 # served up to this limit beyond the max-age (or s-maxage) of a cached
1428 # response.
1429 # The maximum allowed value is 604800 (1 week).
1430 # Set this to zero (0) to disable serve-while-stale.
1431 # as a count of seconds and fractions of seconds at nanosecond
1432 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1433 # or &quot;month&quot;. Range is approximately 10,000 years.
1434 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1435 # Durations less than one second are represented with a 0
1436 # `seconds` field and a positive `nanos` field. Must be from 0
1437 # to 999,999,999 inclusive.
1438 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1439 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1440 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1441 },
1442 },
1443 &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
1444 # information about the W3C recommendation for cross-origin resource sharing
1445 # (CORS), see Fetch API Living
1446 # Standard.
1447 #
1448 # Not supported when the URL map is bound to a target gRPC proxy.
1449 # information about the W3C recommendation for cross-origin resource sharing
1450 # (CORS), see Fetch API Living
1451 # Standard.
1452 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
1453 # indicates that
1454 # the actual request can include user credentials. This field translates to
1455 # the Access-Control-Allow-Credentials header.
1456 #
1457 # Default is false.
1458 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
1459 # header.
1460 &quot;A String&quot;,
1461 ],
1462 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
1463 # header.
1464 &quot;A String&quot;,
1465 ],
1466 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
1467 # more information, see regular expression syntax.
1468 #
1469 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
1470 #
1471 # Regular expressions can only be used when the loadBalancingScheme is
1472 # set to INTERNAL_SELF_MANAGED.
1473 &quot;A String&quot;,
1474 ],
1475 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
1476 #
1477 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
1478 &quot;A String&quot;,
1479 ],
1480 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
1481 # The default value is false, which indicates that the CORS
1482 # policy is in effect.
1483 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
1484 # header.
1485 &quot;A String&quot;,
1486 ],
1487 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
1488 # seconds. This field translates to the Access-Control-Max-Age
1489 # header.
1490 },
1491 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
1492 # the resiliency of clients to backend service failure. As part of fault
1493 # injection, when clients send requests to a backend service, delays can be
1494 # introduced by a load balancer on a percentage of requests before sending
1495 # those requests to the backend service. Similarly requests from clients can
1496 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
1497 # that are configured with a fault_injection_policy if:
1498 # 1. The traffic is generated by fault injection AND
1499 # 2. The fault injection is not a delay fault injection.
1500 # Fault injection is not supported with the classic Application Load Balancer
1501 # . To see which load balancers support fault injection,
1502 # see Load
1503 # balancing: Routing and traffic management features.
1504 # the resiliency of clients to backend service failure. As part of fault
1505 # injection, when clients send requests to a backend service, delays can be
1506 # introduced by the load balancer on a percentage of requests before sending
1507 # those request to the backend service. Similarly requests from clients can be
1508 # aborted by the load balancer for a percentage of requests.
1509 &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
1510 # injection.
1511 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
1512 #
1513 # The value must be from 200 to 599 inclusive.
1514 #
1515 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
1516 # according to this
1517 # mapping table. HTTP status 200 is mapped to gRPC status
1518 # UNKNOWN. Injecting an OK status is currently not supported by
1519 # Traffic Director.
1520 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
1521 # that is aborted as part of fault injection.
1522 #
1523 # The value must be from 0.0 to 100.0 inclusive.
1524 },
1525 &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
1526 # injection, before being sent to a backend service.
1527 # request to the backend service as part of fault injection.
1528 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
1529 # as a count of seconds and fractions of seconds at nanosecond
1530 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1531 # or &quot;month&quot;. Range is approximately 10,000 years.
1532 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1533 # Durations less than one second are represented with a 0
1534 # `seconds` field and a positive `nanos` field. Must be from 0
1535 # to 999,999,999 inclusive.
1536 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1537 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1538 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1539 },
1540 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
1541 # which a delay is introduced as part of fault injection.
1542 #
1543 # The value must be from 0.0 to 100.0 inclusive.
1544 },
1545 },
1546 &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
1547 # Global EXTERNAL_MANAGED load balancer schemes.
1548 # Either Cloud CDN must be enabled on the backend service or backend bucket
1549 # serving the route, or cache policy must be configured on the same route
1550 # dynamically processes and delivers images from the network edge.
1551 # Image Optimization is only available for Global External Application Load
1552 # Balancers.
1553 # Either Cloud CDN must be enabled on the backend service or backend bucket
1554 # serving the route, or cache policy must be configured on the same route.
1555 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
1556 },
1557 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
1558 # Unlike the timeout field where the timeout duration starts
1559 # from the time the request has been fully processed (known as*end-of-stream*),
1560 # the duration in this field is computed from the beginning of the stream
1561 # until the response has been processed, including all retries. A
1562 # stream that does not complete in this duration is closed.
1563 #
1564 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
1565 # with the route.
1566 #
1567 # This field is only allowed if the Url map is used with backend services
1568 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
1569 # as a count of seconds and fractions of seconds at nanosecond
1570 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1571 # or &quot;month&quot;. Range is approximately 10,000 years.
1572 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1573 # Durations less than one second are represented with a 0
1574 # `seconds` field and a positive `nanos` field. Must be from 0
1575 # to 999,999,999 inclusive.
1576 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1577 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1578 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1579 },
1580 &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
1581 # are shadowed to a separate mirrored backend service. The load balancer does
1582 # not wait for responses from the shadow service. Before sending traffic
1583 # to the shadow service, the host / authority header is suffixed with-shadow.
1584 #
1585 # Not supported when the URL map is bound to a target gRPC proxy that
1586 # has the validateForProxyless field set to true.
1587 # are shadowed to a separate mirrored backend service. The load balancer
1588 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
1589 # to the shadow service, the host or authority header is suffixed with-shadow.
1590 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
1591 # mirrored to.
1592 #
1593 # The backend service configured for a mirroring
1594 # policy must reference backends that are of the same type as the original
1595 # backend service matched in the URL map.
1596 #
1597 # Serverless NEG backends are not currently supported as a mirrored
1598 # backend service.
1599 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
1600 },
1601 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
1602 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
1603 # If not specified, defaults to 1.
1604 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
1605 #
1606 # If not specified, will use the timeout set in theHttpRouteAction field.
1607 # If timeout in the HttpRouteAction field is not set, this field
1608 # uses the largest timeout
1609 # among all backend services associated with the route.
1610 #
1611 # Not supported when the URL map is bound to a target gRPC proxy that
1612 # has the validateForProxyless field set to true.
1613 # as a count of seconds and fractions of seconds at nanosecond
1614 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1615 # or &quot;month&quot;. Range is approximately 10,000 years.
1616 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1617 # Durations less than one second are represented with a 0
1618 # `seconds` field and a positive `nanos` field. Must be from 0
1619 # to 999,999,999 inclusive.
1620 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1621 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1622 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1623 },
1624 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
1625 # values are:
1626 #
1627 # - 5xx: retry is attempted if the instance or endpoint
1628 # responds with any 5xx response code, or if the instance or
1629 # endpoint does not respond at all. For example, disconnects, reset, read
1630 # timeout, connection failure, and refused streams.
1631 # - gateway-error: Similar to 5xx, but only
1632 # applies to response codes 502, 503 or504.
1633 # - connect-failure: a retry is attempted on failures
1634 # connecting to the instance or endpoint. For example, connection
1635 # timeouts.
1636 # - retriable-4xx: a retry is attempted if the instance
1637 # or endpoint responds with a 4xx response code.
1638 # The only error that you can retry is error code 409.
1639 # - refused-stream: a retry is attempted if the instance
1640 # or endpoint resets the stream with a REFUSED_STREAM error
1641 # code. This reset type indicates that it is safe to retry.
1642 # - cancelled: a retry is attempted if the gRPC status
1643 # code in the response header is set to cancelled.
1644 # - deadline-exceeded: a retry is attempted if the gRPC
1645 # status code in the response header is set todeadline-exceeded.
1646 # - internal: a retry is attempted if the gRPC
1647 # status code in the response header is set tointernal.
1648 # - resource-exhausted: a retry is attempted if the gRPC
1649 # status code in the response header is set toresource-exhausted.
1650 # - unavailable: a retry is attempted if the gRPC
1651 # status code in the response header is set tounavailable.
1652 #
1653 # Only the following codes are supported when the URL map is bound to
1654 # target gRPC proxy that has validateForProxyless field set to true.
1655 #
1656 # - cancelled
1657 # - deadline-exceeded
1658 # - internal
1659 # - resource-exhausted
1660 # - unavailable
1661 &quot;A String&quot;,
1662 ],
1663 },
1664 &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
1665 # time the request has been fully processed (known as *end-of-stream*)
1666 # up until the response has been processed. Timeout includes
1667 # all retries.
1668 #
1669 # If not specified, this field uses the largest timeout among all backend
1670 # services associated with the route.
1671 #
1672 # Not supported when the URL map is bound to a target gRPC proxy that
1673 # has validateForProxyless field set to true.
1674 # as a count of seconds and fractions of seconds at nanosecond
1675 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1676 # or &quot;month&quot;. Range is approximately 10,000 years.
1677 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1678 # Durations less than one second are represented with a 0
1679 # `seconds` field and a positive `nanos` field. Must be from 0
1680 # to 999,999,999 inclusive.
1681 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1682 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1683 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1684 },
1685 &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
1686 # to the matched service.
1687 #
1688 # urlRewrite is the only action supported in UrlMaps
1689 # for classic Application Load Balancers.
1690 #
1691 # Not supported when the URL map is bound to a target gRPC proxy that
1692 # has the validateForProxyless field set to true.
1693 # backend service.
1694 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
1695 # host header is replaced with contents of hostRewrite.
1696 #
1697 # The value must be from 1 to 255 characters.
1698 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
1699 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
1700 #
1701 # The value must be from 1 to 1024 characters.
1702 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
1703 # header) using the HTTP template syntax.
1704 #
1705 # A corresponding
1706 # path_template_match must be specified. Any template variables must exist in
1707 # the path_template_match field.
1708 #
1709 #
1710 # - -At least one variable must be specified in the path_template_match
1711 # field
1712 # - You can omit variables from the rewritten URL
1713 # - The * and ** operators cannot be matched
1714 # unless they have a corresponding variable name - e.g.
1715 # {format=*} or {var=**}.
1716 #
1717 # For example, a path_template_match of /static/{format=**}
1718 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
1719 # rewrite, so that /{country}/{format}/{suffix=**} can be
1720 # rewritten as /content/{format}/{country}/{suffix}.
1721 #
1722 # At least
1723 # one non-empty routeRules[].matchRules[].path_template_match is
1724 # required.
1725 #
1726 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
1727 },
1728 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
1729 # occurs. The weights determine the fraction of traffic that flows to
1730 # their corresponding backend service. If all traffic needs to
1731 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
1732 #
1733 # After a backend service is identified and before forwarding
1734 # the request to
1735 # the backend service, advanced routing actions such as URL rewrites and
1736 # header transformations are applied depending on additional settings
1737 # specified in this HttpRouteAction.
1738 { # In contrast to a single BackendService in
1739 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
1740 # multiple backend services. The volume of traffic for each
1741 # backend service is proportional to the weight specified
1742 # in each WeightedBackendService
1743 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
1744 # resource. Before
1745 # forwarding the request to backendService, the load balancer
1746 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
1747 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
1748 # effect for the selected backendService.
1749 #
1750 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
1751 #
1752 # headerAction is not supported for load balancers that have
1753 # their loadBalancingScheme set to EXTERNAL.
1754 #
1755 # Not supported when the URL map is bound to a target gRPC proxy that
1756 # has validateForProxyless field set to true.
1757 # the request is passed along to the selected backendService.
1758 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
1759 { # Specification determining how headers are added to requests or responses.
1760 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
1761 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
1762 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
1763 # that already
1764 # exist for the header. If true, headerValue is set for the
1765 # header, discarding any values that were set for that header.
1766 #
1767 # The default value is true,
1768 # unless a variable is present in headerValue,
1769 # in which case the default value is false.
1770 # .
1771 },
1772 ],
1773 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
1774 # request before forwarding the request to the backendService.
1775 &quot;A String&quot;,
1776 ],
1777 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
1778 # client.
1779 { # Specification determining how headers are added to requests or responses.
1780 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
1781 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
1782 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
1783 # that already
1784 # exist for the header. If true, headerValue is set for the
1785 # header, discarding any values that were set for that header.
1786 #
1787 # The default value is true,
1788 # unless a variable is present in headerValue,
1789 # in which case the default value is false.
1790 # .
1791 },
1792 ],
1793 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
1794 # response before sending the response back to the client.
1795 &quot;A String&quot;,
1796 ],
1797 },
1798 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
1799 # computed asweight / (sum of all weightedBackendService weights in routeAction).
1800 #
1801 # The selection of a backend service is determined only for new traffic.
1802 # Once a user&#x27;s request has been directed to a backend service,
1803 # subsequent requests are sent to the same backend service as
1804 # determined by the backend service&#x27;s session affinity policy.
1805 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
1806 # splitting. If you do, the weighted traffic splitting configuration takes
1807 # precedence.
1808 #
1809 # The value must be from 0 to 1000.
1810 },
1811 ],
1812 },
1813 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource. This
1814 # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
1815 # matched. For example, the
1816 # following are all valid URLs to a BackendService resource:
1817 #
1818 #
1819 # - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
1820 # - compute/v1/projects/project/global/backendServices/backendService
1821 # - global/backendServices/backendService
1822 #
1823 #
1824 # If defaultRouteAction is also specified, advanced
1825 # routing actions, such as URL rewrites, take effect before sending the
1826 # request to the backend.
1827 #
1828 #
1829 # Only one of defaultUrlRedirect, defaultService
1830 # or defaultRouteAction.weightedBackendService can be set.
1831 #
1832 #
1833 # Authorization requires one or more of the following Google IAM permissions on the
1834 # specified resource default_service:
1835 #
1836 #
1837 # - compute.backendBuckets.use
1838 # - compute.backendServices.use
1839 &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
1840 # by defaultUrlRedirect.
1841 #
1842 #
1843 # Only one of defaultUrlRedirect, defaultService
1844 # or defaultRouteAction.weightedBackendService can be set.
1845 #
1846 #
1847 # Not supported when the URL map is bound to a target gRPC proxy.
1848 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
1849 # was supplied in the request.
1850 #
1851 # The value must be from 1 to 255
1852 # characters.
1853 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
1854 # set to HTTPS.
1855 # If set to false, the URL scheme of the redirected request
1856 # remains the same as that of the request.
1857 #
1858 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
1859 #
1860 # The default is set to false.
1861 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
1862 # that was supplied in the request.
1863 #
1864 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
1865 # supplied, the path of the original request is used for the redirect.
1866 #
1867 # The value must be from 1 to 1024 characters.
1868 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
1869 # the HttpRouteRuleMatch, retaining the remaining portion
1870 # of the URL before redirecting the request.
1871 #
1872 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
1873 # supplied, the path of the original request is used for the redirect.
1874 #
1875 # The value must be from 1 to 1024 characters.
1876 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
1877 #
1878 # Supported values are:
1879 #
1880 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
1881 # to 301.
1882 # - FOUND, which corresponds to 302.
1883 # - SEE_OTHER which corresponds to 303.
1884 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
1885 # method is retained.
1886 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
1887 # method is retained.
1888 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
1889 # URL is
1890 # removed before redirecting the request. If set to false, the
1891 # query portion of the original URL is retained.
1892 #
1893 # The default is set to false.
1894 },
1895 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
1896 # create the resource.
1897 &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
1898 # for the selected backend service.
1899 #
1900 # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
1901 #
1902 # HeaderAction is not supported for load balancers
1903 # that have
1904 # their loadBalancingScheme set to EXTERNAL.
1905 #
1906 # Not supported when the URL map is bound to a target gRPC proxy that
1907 # has validateForProxyless field set to true.
1908 # the request is passed along to the selected backendService.
1909 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
1910 { # Specification determining how headers are added to requests or responses.
1911 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
1912 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
1913 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
1914 # that already
1915 # exist for the header. If true, headerValue is set for the
1916 # header, discarding any values that were set for that header.
1917 #
1918 # The default value is true,
1919 # unless a variable is present in headerValue,
1920 # in which case the default value is false.
1921 # .
1922 },
1923 ],
1924 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
1925 # request before forwarding the request to the backendService.
1926 &quot;A String&quot;,
1927 ],
1928 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
1929 # client.
1930 { # Specification determining how headers are added to requests or responses.
1931 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
1932 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
1933 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
1934 # that already
1935 # exist for the header. If true, headerValue is set for the
1936 # header, discarding any values that were set for that header.
1937 #
1938 # The default value is true,
1939 # unless a variable is present in headerValue,
1940 # in which case the default value is false.
1941 # .
1942 },
1943 ],
1944 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
1945 # response before sending the response back to the client.
1946 &quot;A String&quot;,
1947 ],
1948 },
1949 &quot;name&quot;: &quot;A String&quot;, # The name to which this PathMatcher is referred by theHostRule.
1950 &quot;pathRules&quot;: [ # The list of path rules. Use this list instead of routeRules
1951 # when routing based on simple path matching is all that&#x27;s required. A path
1952 # rule can only include a wildcard character (*) after a
1953 # forward slash character (&quot;/&quot;).
1954 #
1955 # The order by which path rules are specified does not matter.
1956 # Matches are always done on the longest-path-first basis.
1957 #
1958 # For example: a pathRule with a path /a/b/c/* will match
1959 # before /a/b/* irrespective of the order in which those paths appear in this
1960 # list.
1961 #
1962 # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
1963 { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
1964 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
1965 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
1966 #
1967 # If a policy for an
1968 # error code is not configured for the PathRule, a policy for
1969 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
1970 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
1971 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
1972 # effect.
1973 #
1974 # For example, consider a UrlMap with the following configuration:
1975 #
1976 #
1977 # - UrlMap.defaultCustomErrorResponsePolicy are configured
1978 # with policies for 5xx and 4xx errors
1979 # - A PathRule for /coming_soon/ is configured for the error
1980 # code 404.
1981 #
1982 # 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
1983 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
1984 # the policy in PathRule.customErrorResponsePolicy takes
1985 # effect. If any of the requests in this example encounter a 500
1986 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
1987 #
1988 # customErrorResponsePolicy is supported only for
1989 # global external Application Load Balancers.
1990 # backend service or backend bucket responds with an error.
1991 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
1992 #
1993 # In a given policy, if you specify rules for both a range of error codes
1994 # as well as rules for specific error codes then rules with specific error
1995 # codes have a higher priority. For example, assume that you configure a rule
1996 # for 401 (Un-authorized) code, and another for all 4 series
1997 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
1998 # However if the backend service returns a 403, the rule for4xx takes effect.
1999 { # Specifies the mapping between the response code that will be returned along
2000 # with the custom error content and the response code returned by the backend
2001 # service.
2002 &quot;matchResponseCodes&quot;: [ # Valid values include:
2003 #
2004 #
2005 # - A number between 400 and 599: For example
2006 # 401 or 503, in which case the load balancer
2007 # applies the policy if the error code exactly matches this value.
2008 # - 5xx: Load Balancer will apply the policy if the
2009 # backend service responds with any response code in the range of
2010 # 500 to 599.
2011 # - 4xx: Load
2012 # Balancer will apply the policy if the backend service responds with any
2013 # response code in the range of 400 to
2014 # 499.
2015 #
2016 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
2017 &quot;A String&quot;,
2018 ],
2019 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
2020 # error content. If overrideResponseCode is not supplied, the
2021 # same response code returned by the original backend bucket or backend
2022 # service is returned to the client.
2023 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
2024 #
2025 # path must start
2026 # with a leading slash. path cannot have trailing slashes.
2027 #
2028 # If the file is not available in backendBucket or the
2029 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
2030 #
2031 # The value must
2032 # be from 1 to 1024 characters
2033 },
2034 ],
2035 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
2036 # contains the custom error content. Examples are:
2037 #
2038 #
2039 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
2040 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
2041 # - global/backendBuckets/myBackendBucket
2042 #
2043 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
2044 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
2045 #
2046 # If load balancer cannot reach
2047 # the backendBucket, a simple Not Found Error will
2048 # be returned, with the original response code (oroverrideResponseCode if configured).
2049 #
2050 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
2051 },
2052 &quot;paths&quot;: [ # The list of path patterns to match. Each must start with /
2053 # and the only place a * is allowed is at the end following
2054 # a /. The string fed to the path matcher does not include
2055 # any text after the first ? or #, and
2056 # those chars are not allowed here.
2057 &quot;A String&quot;,
2058 ],
2059 &quot;routeAction&quot;: { # In response to a matching path, the load balancer
2060 # performs advanced routing actions, such as URL rewrites and header
2061 # transformations, before forwarding the request to the selected
2062 # backend.
2063 #
2064 #
2065 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
2066 #
2067 #
2068 # URL maps for classic Application Load Balancers only support
2069 # the urlRewrite action within a path rule&#x27;srouteAction.
2070 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
2071 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
2072 # property must be specified. This policy cannot be specified if any target
2073 # backend has Identity-Aware Proxy enabled.
2074 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
2075 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
2076 # header names can be specified. The cache is bypassed for all `cacheMode`
2077 # values.
2078 &quot;A String&quot;,
2079 ],
2080 &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
2081 # on the backend type: for Backend Services, the complete request URI is
2082 # used; for Backend Buckets, the request URI is used without the protocol or
2083 # host, and only query parameters known to Cloud Storage are included.
2084 # Policy defined on Route Action.
2085 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
2086 # parameters will be included. Either specify `excludedQueryParameters`
2087 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
2088 # encoded and not treated as delimiters.
2089 #
2090 # Note: This field applies to routes that use backend services. Attempting
2091 # to set it on a route that points exclusively to Backend Buckets will
2092 # result in a configuration error. For routes that point to a Backend
2093 # Bucket, use `includedQueryParameters` to define which parameters should
2094 # be part of the cache key.
2095 &quot;A String&quot;,
2096 ],
2097 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
2098 #
2099 # Note: This setting is only applicable to routes that use a Backend
2100 # Service. It does not affect requests served by a Backend Bucket, as the
2101 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
2102 # it on a route that points exclusively to Backend Buckets will result in a
2103 # configuration error.
2104 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
2105 #
2106 # Note: This setting is only applicable to routes that use a Backend
2107 # Service. It does not affect requests served by a Backend Bucket, as the
2108 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
2109 # set on a route that points exclusively to Backend Buckets will result in
2110 # a configuration error.
2111 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
2112 # `includedQueryParameters` and `excludedQueryParameters`. If neither
2113 # is set, the entire query string will be included. If false, the query
2114 # string will be excluded from the cache key entirely.
2115 #
2116 # Note: This field applies to routes that use backend services. Attempting
2117 # to set it on a route that points exclusively to Backend Buckets will
2118 # result in a configuration error. For routes that point to a Backend
2119 # Bucket, use `includedQueryParameters` to define which parameters should
2120 # be part of the cache key.
2121 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
2122 # The name=value pair will be used in the cache key Cloud CDN generates.
2123 #
2124 # Note: This setting is only applicable to routes that use a Backend
2125 # Service. It does not affect requests served by a Backend Bucket.
2126 # Attempting to set it on a route that points exclusively to Backend
2127 # Buckets will result in a configuration error. Up to 5 cookie names can be
2128 # specified.
2129 &quot;A String&quot;,
2130 ],
2131 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
2132 &quot;A String&quot;,
2133 ],
2134 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
2135 # parameters will be excluded. Either specify `includedQueryParameters`
2136 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
2137 # encoded and not treated as delimiters.
2138 &quot;A String&quot;,
2139 ],
2140 },
2141 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
2142 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
2143 &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
2144 # content. This is used to clamp the max-age (or Expires) value sent to the
2145 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
2146 # is used for the response max-age directive, along with a &quot;public&quot;
2147 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
2148 # clamps the max-age from the origin (if specified), or else sets the
2149 # response max-age directive to the lesser of the `clientTtl` and
2150 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
2151 # present. The maximum allowed value is 31,622,400s (1 year). If not
2152 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
2153 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
2154 # `USE_ORIGIN_HEADERS`.
2155 # as a count of seconds and fractions of seconds at nanosecond
2156 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2157 # or &quot;month&quot;. Range is approximately 10,000 years.
2158 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2159 # Durations less than one second are represented with a 0
2160 # `seconds` field and a positive `nanos` field. Must be from 0
2161 # to 999,999,999 inclusive.
2162 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2163 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2164 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2165 },
2166 &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
2167 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
2168 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
2169 # greater than that of `maxTtl`. When the `cacheMode` is set to
2170 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
2171 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
2172 # accessed objects may be evicted from the cache before the defined TTL. If
2173 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
2174 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
2175 # `USE_ORIGIN_HEADERS`.
2176 # as a count of seconds and fractions of seconds at nanosecond
2177 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2178 # or &quot;month&quot;. Range is approximately 10,000 years.
2179 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2180 # Durations less than one second are represented with a 0
2181 # `seconds` field and a positive `nanos` field. Must be from 0
2182 # to 999,999,999 inclusive.
2183 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2184 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2185 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2186 },
2187 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
2188 # attempt to set a max-age or s-maxage higher than this, or an Expires header
2189 # more than `maxTtl` seconds in the future will be capped at the value of
2190 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
2191 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
2192 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
2193 # Infrequently accessed objects may be evicted from the cache before the
2194 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
2195 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
2196 # mode.
2197 # as a count of seconds and fractions of seconds at nanosecond
2198 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2199 # or &quot;month&quot;. Range is approximately 10,000 years.
2200 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2201 # Durations less than one second are represented with a 0
2202 # `seconds` field and a positive `nanos` field. Must be from 0
2203 # to 999,999,999 inclusive.
2204 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2205 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2206 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2207 },
2208 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
2209 # to apply fine-grained caching for common errors or redirects.
2210 # This can reduce the load on your origin and improve end-user
2211 # experience by reducing response latency.
2212 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
2213 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
2214 # the specified response code that lack any Cache-Control, Expires, or
2215 # Pragma: no-cache directives. When the `cacheMode` is set to
2216 # `FORCE_CACHE_ALL`, negative caching applies to all responses
2217 # with the specified response code, and overrides any caching headers. By
2218 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
2219 #
2220 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
2221 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
2222 # * 405 (Method Not Found), 501 (Not Implemented): 60s
2223 #
2224 # These defaults can be overridden in `negativeCachingPolicy`.
2225 # If not specified, Cloud CDN applies negative caching by default.
2226 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
2227 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
2228 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
2229 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
2230 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
2231 # all response codes that you wish to cache. Cloud CDN will not apply any
2232 # default negative caching when a policy exists.
2233 { # Specify CDN TTLs for response error codes.
2234 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
2235 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
2236 # specified as values, and you cannot specify a status code more than
2237 # once.
2238 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
2239 # corresponding status code.
2240 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
2241 # objects may be evicted from the cache before the defined TTL.
2242 # as a count of seconds and fractions of seconds at nanosecond
2243 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2244 # or &quot;month&quot;. Range is approximately 10,000 years.
2245 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2246 # Durations less than one second are represented with a 0
2247 # `seconds` field and a positive `nanos` field. Must be from 0
2248 # to 999,999,999 inclusive.
2249 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2250 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2251 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2252 },
2253 },
2254 ],
2255 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
2256 # requests into a small number of requests to the origin. If not specified,
2257 # Cloud CDN applies request coalescing by default.
2258 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
2259 # content with the origin, or when an error is encountered when refreshing
2260 # the cache.
2261 # This setting defines the default &quot;max-stale&quot; duration for any cached
2262 # responses that do not specify a max-stale directive. Stale responses that
2263 # exceed the TTL configured here will not be served. The default limit
2264 # (max-stale) is 86400s (1 day), which will allow stale content to be
2265 # served up to this limit beyond the max-age (or s-maxage) of a cached
2266 # response.
2267 # The maximum allowed value is 604800 (1 week).
2268 # Set this to zero (0) to disable serve-while-stale.
2269 # as a count of seconds and fractions of seconds at nanosecond
2270 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2271 # or &quot;month&quot;. Range is approximately 10,000 years.
2272 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2273 # Durations less than one second are represented with a 0
2274 # `seconds` field and a positive `nanos` field. Must be from 0
2275 # to 999,999,999 inclusive.
2276 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2277 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2278 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2279 },
2280 },
2281 &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
2282 # information about the W3C recommendation for cross-origin resource sharing
2283 # (CORS), see Fetch API Living
2284 # Standard.
2285 #
2286 # Not supported when the URL map is bound to a target gRPC proxy.
2287 # information about the W3C recommendation for cross-origin resource sharing
2288 # (CORS), see Fetch API Living
2289 # Standard.
2290 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
2291 # indicates that
2292 # the actual request can include user credentials. This field translates to
2293 # the Access-Control-Allow-Credentials header.
2294 #
2295 # Default is false.
2296 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
2297 # header.
2298 &quot;A String&quot;,
2299 ],
2300 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
2301 # header.
2302 &quot;A String&quot;,
2303 ],
2304 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
2305 # more information, see regular expression syntax.
2306 #
2307 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
2308 #
2309 # Regular expressions can only be used when the loadBalancingScheme is
2310 # set to INTERNAL_SELF_MANAGED.
2311 &quot;A String&quot;,
2312 ],
2313 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
2314 #
2315 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
2316 &quot;A String&quot;,
2317 ],
2318 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
2319 # The default value is false, which indicates that the CORS
2320 # policy is in effect.
2321 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
2322 # header.
2323 &quot;A String&quot;,
2324 ],
2325 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
2326 # seconds. This field translates to the Access-Control-Max-Age
2327 # header.
2328 },
2329 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
2330 # the resiliency of clients to backend service failure. As part of fault
2331 # injection, when clients send requests to a backend service, delays can be
2332 # introduced by a load balancer on a percentage of requests before sending
2333 # those requests to the backend service. Similarly requests from clients can
2334 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
2335 # that are configured with a fault_injection_policy if:
2336 # 1. The traffic is generated by fault injection AND
2337 # 2. The fault injection is not a delay fault injection.
2338 # Fault injection is not supported with the classic Application Load Balancer
2339 # . To see which load balancers support fault injection,
2340 # see Load
2341 # balancing: Routing and traffic management features.
2342 # the resiliency of clients to backend service failure. As part of fault
2343 # injection, when clients send requests to a backend service, delays can be
2344 # introduced by the load balancer on a percentage of requests before sending
2345 # those request to the backend service. Similarly requests from clients can be
2346 # aborted by the load balancer for a percentage of requests.
2347 &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
2348 # injection.
2349 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
2350 #
2351 # The value must be from 200 to 599 inclusive.
2352 #
2353 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
2354 # according to this
2355 # mapping table. HTTP status 200 is mapped to gRPC status
2356 # UNKNOWN. Injecting an OK status is currently not supported by
2357 # Traffic Director.
2358 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
2359 # that is aborted as part of fault injection.
2360 #
2361 # The value must be from 0.0 to 100.0 inclusive.
2362 },
2363 &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
2364 # injection, before being sent to a backend service.
2365 # request to the backend service as part of fault injection.
2366 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
2367 # as a count of seconds and fractions of seconds at nanosecond
2368 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2369 # or &quot;month&quot;. Range is approximately 10,000 years.
2370 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2371 # Durations less than one second are represented with a 0
2372 # `seconds` field and a positive `nanos` field. Must be from 0
2373 # to 999,999,999 inclusive.
2374 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2375 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2376 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2377 },
2378 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
2379 # which a delay is introduced as part of fault injection.
2380 #
2381 # The value must be from 0.0 to 100.0 inclusive.
2382 },
2383 },
2384 &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
2385 # Global EXTERNAL_MANAGED load balancer schemes.
2386 # Either Cloud CDN must be enabled on the backend service or backend bucket
2387 # serving the route, or cache policy must be configured on the same route
2388 # dynamically processes and delivers images from the network edge.
2389 # Image Optimization is only available for Global External Application Load
2390 # Balancers.
2391 # Either Cloud CDN must be enabled on the backend service or backend bucket
2392 # serving the route, or cache policy must be configured on the same route.
2393 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
2394 },
2395 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
2396 # Unlike the timeout field where the timeout duration starts
2397 # from the time the request has been fully processed (known as*end-of-stream*),
2398 # the duration in this field is computed from the beginning of the stream
2399 # until the response has been processed, including all retries. A
2400 # stream that does not complete in this duration is closed.
2401 #
2402 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
2403 # with the route.
2404 #
2405 # This field is only allowed if the Url map is used with backend services
2406 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
2407 # as a count of seconds and fractions of seconds at nanosecond
2408 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2409 # or &quot;month&quot;. Range is approximately 10,000 years.
2410 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2411 # Durations less than one second are represented with a 0
2412 # `seconds` field and a positive `nanos` field. Must be from 0
2413 # to 999,999,999 inclusive.
2414 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2415 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2416 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2417 },
2418 &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
2419 # are shadowed to a separate mirrored backend service. The load balancer does
2420 # not wait for responses from the shadow service. Before sending traffic
2421 # to the shadow service, the host / authority header is suffixed with-shadow.
2422 #
2423 # Not supported when the URL map is bound to a target gRPC proxy that
2424 # has the validateForProxyless field set to true.
2425 # are shadowed to a separate mirrored backend service. The load balancer
2426 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
2427 # to the shadow service, the host or authority header is suffixed with-shadow.
2428 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
2429 # mirrored to.
2430 #
2431 # The backend service configured for a mirroring
2432 # policy must reference backends that are of the same type as the original
2433 # backend service matched in the URL map.
2434 #
2435 # Serverless NEG backends are not currently supported as a mirrored
2436 # backend service.
2437 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
2438 },
2439 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
2440 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
2441 # If not specified, defaults to 1.
2442 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
2443 #
2444 # If not specified, will use the timeout set in theHttpRouteAction field.
2445 # If timeout in the HttpRouteAction field is not set, this field
2446 # uses the largest timeout
2447 # among all backend services associated with the route.
2448 #
2449 # Not supported when the URL map is bound to a target gRPC proxy that
2450 # has the validateForProxyless field set to true.
2451 # as a count of seconds and fractions of seconds at nanosecond
2452 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2453 # or &quot;month&quot;. Range is approximately 10,000 years.
2454 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2455 # Durations less than one second are represented with a 0
2456 # `seconds` field and a positive `nanos` field. Must be from 0
2457 # to 999,999,999 inclusive.
2458 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2459 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2460 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2461 },
2462 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
2463 # values are:
2464 #
2465 # - 5xx: retry is attempted if the instance or endpoint
2466 # responds with any 5xx response code, or if the instance or
2467 # endpoint does not respond at all. For example, disconnects, reset, read
2468 # timeout, connection failure, and refused streams.
2469 # - gateway-error: Similar to 5xx, but only
2470 # applies to response codes 502, 503 or504.
2471 # - connect-failure: a retry is attempted on failures
2472 # connecting to the instance or endpoint. For example, connection
2473 # timeouts.
2474 # - retriable-4xx: a retry is attempted if the instance
2475 # or endpoint responds with a 4xx response code.
2476 # The only error that you can retry is error code 409.
2477 # - refused-stream: a retry is attempted if the instance
2478 # or endpoint resets the stream with a REFUSED_STREAM error
2479 # code. This reset type indicates that it is safe to retry.
2480 # - cancelled: a retry is attempted if the gRPC status
2481 # code in the response header is set to cancelled.
2482 # - deadline-exceeded: a retry is attempted if the gRPC
2483 # status code in the response header is set todeadline-exceeded.
2484 # - internal: a retry is attempted if the gRPC
2485 # status code in the response header is set tointernal.
2486 # - resource-exhausted: a retry is attempted if the gRPC
2487 # status code in the response header is set toresource-exhausted.
2488 # - unavailable: a retry is attempted if the gRPC
2489 # status code in the response header is set tounavailable.
2490 #
2491 # Only the following codes are supported when the URL map is bound to
2492 # target gRPC proxy that has validateForProxyless field set to true.
2493 #
2494 # - cancelled
2495 # - deadline-exceeded
2496 # - internal
2497 # - resource-exhausted
2498 # - unavailable
2499 &quot;A String&quot;,
2500 ],
2501 },
2502 &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
2503 # time the request has been fully processed (known as *end-of-stream*)
2504 # up until the response has been processed. Timeout includes
2505 # all retries.
2506 #
2507 # If not specified, this field uses the largest timeout among all backend
2508 # services associated with the route.
2509 #
2510 # Not supported when the URL map is bound to a target gRPC proxy that
2511 # has validateForProxyless field set to true.
2512 # as a count of seconds and fractions of seconds at nanosecond
2513 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2514 # or &quot;month&quot;. Range is approximately 10,000 years.
2515 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2516 # Durations less than one second are represented with a 0
2517 # `seconds` field and a positive `nanos` field. Must be from 0
2518 # to 999,999,999 inclusive.
2519 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2520 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2521 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2522 },
2523 &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
2524 # to the matched service.
2525 #
2526 # urlRewrite is the only action supported in UrlMaps
2527 # for classic Application Load Balancers.
2528 #
2529 # Not supported when the URL map is bound to a target gRPC proxy that
2530 # has the validateForProxyless field set to true.
2531 # backend service.
2532 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
2533 # host header is replaced with contents of hostRewrite.
2534 #
2535 # The value must be from 1 to 255 characters.
2536 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
2537 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
2538 #
2539 # The value must be from 1 to 1024 characters.
2540 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
2541 # header) using the HTTP template syntax.
2542 #
2543 # A corresponding
2544 # path_template_match must be specified. Any template variables must exist in
2545 # the path_template_match field.
2546 #
2547 #
2548 # - -At least one variable must be specified in the path_template_match
2549 # field
2550 # - You can omit variables from the rewritten URL
2551 # - The * and ** operators cannot be matched
2552 # unless they have a corresponding variable name - e.g.
2553 # {format=*} or {var=**}.
2554 #
2555 # For example, a path_template_match of /static/{format=**}
2556 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
2557 # rewrite, so that /{country}/{format}/{suffix=**} can be
2558 # rewritten as /content/{format}/{country}/{suffix}.
2559 #
2560 # At least
2561 # one non-empty routeRules[].matchRules[].path_template_match is
2562 # required.
2563 #
2564 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
2565 },
2566 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
2567 # occurs. The weights determine the fraction of traffic that flows to
2568 # their corresponding backend service. If all traffic needs to
2569 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
2570 #
2571 # After a backend service is identified and before forwarding
2572 # the request to
2573 # the backend service, advanced routing actions such as URL rewrites and
2574 # header transformations are applied depending on additional settings
2575 # specified in this HttpRouteAction.
2576 { # In contrast to a single BackendService in
2577 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
2578 # multiple backend services. The volume of traffic for each
2579 # backend service is proportional to the weight specified
2580 # in each WeightedBackendService
2581 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
2582 # resource. Before
2583 # forwarding the request to backendService, the load balancer
2584 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
2585 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
2586 # effect for the selected backendService.
2587 #
2588 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
2589 #
2590 # headerAction is not supported for load balancers that have
2591 # their loadBalancingScheme set to EXTERNAL.
2592 #
2593 # Not supported when the URL map is bound to a target gRPC proxy that
2594 # has validateForProxyless field set to true.
2595 # the request is passed along to the selected backendService.
2596 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
2597 { # Specification determining how headers are added to requests or responses.
2598 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
2599 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
2600 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
2601 # that already
2602 # exist for the header. If true, headerValue is set for the
2603 # header, discarding any values that were set for that header.
2604 #
2605 # The default value is true,
2606 # unless a variable is present in headerValue,
2607 # in which case the default value is false.
2608 # .
2609 },
2610 ],
2611 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
2612 # request before forwarding the request to the backendService.
2613 &quot;A String&quot;,
2614 ],
2615 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
2616 # client.
2617 { # Specification determining how headers are added to requests or responses.
2618 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
2619 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
2620 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
2621 # that already
2622 # exist for the header. If true, headerValue is set for the
2623 # header, discarding any values that were set for that header.
2624 #
2625 # The default value is true,
2626 # unless a variable is present in headerValue,
2627 # in which case the default value is false.
2628 # .
2629 },
2630 ],
2631 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
2632 # response before sending the response back to the client.
2633 &quot;A String&quot;,
2634 ],
2635 },
2636 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
2637 # computed asweight / (sum of all weightedBackendService weights in routeAction).
2638 #
2639 # The selection of a backend service is determined only for new traffic.
2640 # Once a user&#x27;s request has been directed to a backend service,
2641 # subsequent requests are sent to the same backend service as
2642 # determined by the backend service&#x27;s session affinity policy.
2643 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
2644 # splitting. If you do, the weighted traffic splitting configuration takes
2645 # precedence.
2646 #
2647 # The value must be from 0 to 1000.
2648 },
2649 ],
2650 },
2651 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
2652 # is directed if this rule is matched. If routeAction is
2653 # also specified, advanced routing actions, such as URL rewrites,
2654 # take effect before sending the request to the backend.
2655 #
2656 #
2657 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
2658 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
2659 # specified by urlRedirect.
2660 #
2661 #
2662 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
2663 #
2664 #
2665 # Not supported when the URL map is bound to a target gRPC proxy.
2666 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
2667 # was supplied in the request.
2668 #
2669 # The value must be from 1 to 255
2670 # characters.
2671 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
2672 # set to HTTPS.
2673 # If set to false, the URL scheme of the redirected request
2674 # remains the same as that of the request.
2675 #
2676 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
2677 #
2678 # The default is set to false.
2679 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
2680 # that was supplied in the request.
2681 #
2682 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
2683 # supplied, the path of the original request is used for the redirect.
2684 #
2685 # The value must be from 1 to 1024 characters.
2686 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
2687 # the HttpRouteRuleMatch, retaining the remaining portion
2688 # of the URL before redirecting the request.
2689 #
2690 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
2691 # supplied, the path of the original request is used for the redirect.
2692 #
2693 # The value must be from 1 to 1024 characters.
2694 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
2695 #
2696 # Supported values are:
2697 #
2698 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
2699 # to 301.
2700 # - FOUND, which corresponds to 302.
2701 # - SEE_OTHER which corresponds to 303.
2702 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
2703 # method is retained.
2704 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
2705 # method is retained.
2706 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
2707 # URL is
2708 # removed before redirecting the request. If set to false, the
2709 # query portion of the original URL is retained.
2710 #
2711 # The default is set to false.
2712 },
2713 },
2714 ],
2715 &quot;routeRules&quot;: [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
2716 # desired. routeRules are evaluated in order of priority, from
2717 # the lowest to highest number.
2718 #
2719 # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
2720 { # The HttpRouteRule setting specifies how to match an HTTP request
2721 # and the corresponding routing action that load balancing proxies perform.
2722 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
2723 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
2724 #
2725 # If a policy for an
2726 # error code is not configured for the RouteRule, a policy for
2727 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
2728 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
2729 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
2730 # effect.
2731 #
2732 # For example, consider a UrlMap with the following configuration:
2733 #
2734 #
2735 # - UrlMap.defaultCustomErrorResponsePolicy are configured
2736 # with policies for 5xx and 4xx errors
2737 # - A RouteRule for /coming_soon/ is configured for the
2738 # error code 404.
2739 #
2740 # 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
2741 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
2742 # the policy in RouteRule.customErrorResponsePolicy takes
2743 # effect. If any of the requests in this example encounter a 500
2744 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
2745 #
2746 # When
2747 # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
2748 # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
2749 # a retry, if load balancer is successful in reaching the
2750 # service, the customErrorResponsePolicy is ignored and
2751 # the response from the service is returned to the client.
2752 #
2753 # customErrorResponsePolicy is supported only for
2754 # global external Application Load Balancers.
2755 # backend service or backend bucket responds with an error.
2756 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
2757 #
2758 # In a given policy, if you specify rules for both a range of error codes
2759 # as well as rules for specific error codes then rules with specific error
2760 # codes have a higher priority. For example, assume that you configure a rule
2761 # for 401 (Un-authorized) code, and another for all 4 series
2762 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
2763 # However if the backend service returns a 403, the rule for4xx takes effect.
2764 { # Specifies the mapping between the response code that will be returned along
2765 # with the custom error content and the response code returned by the backend
2766 # service.
2767 &quot;matchResponseCodes&quot;: [ # Valid values include:
2768 #
2769 #
2770 # - A number between 400 and 599: For example
2771 # 401 or 503, in which case the load balancer
2772 # applies the policy if the error code exactly matches this value.
2773 # - 5xx: Load Balancer will apply the policy if the
2774 # backend service responds with any response code in the range of
2775 # 500 to 599.
2776 # - 4xx: Load
2777 # Balancer will apply the policy if the backend service responds with any
2778 # response code in the range of 400 to
2779 # 499.
2780 #
2781 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
2782 &quot;A String&quot;,
2783 ],
2784 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
2785 # error content. If overrideResponseCode is not supplied, the
2786 # same response code returned by the original backend bucket or backend
2787 # service is returned to the client.
2788 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
2789 #
2790 # path must start
2791 # with a leading slash. path cannot have trailing slashes.
2792 #
2793 # If the file is not available in backendBucket or the
2794 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
2795 #
2796 # The value must
2797 # be from 1 to 1024 characters
2798 },
2799 ],
2800 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
2801 # contains the custom error content. Examples are:
2802 #
2803 #
2804 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
2805 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
2806 # - global/backendBuckets/myBackendBucket
2807 #
2808 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
2809 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
2810 #
2811 # If load balancer cannot reach
2812 # the backendBucket, a simple Not Found Error will
2813 # be returned, with the original response code (oroverrideResponseCode if configured).
2814 #
2815 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
2816 },
2817 &quot;description&quot;: &quot;A String&quot;, # The short description conveying the intent of this routeRule.
2818 #
2819 #
2820 # The description can have a maximum length of 1024 characters.
2821 &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
2822 # for the selected backendService.
2823 #
2824 # The headerAction value specified here is applied before the
2825 # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
2826 #
2827 # HeaderAction is not supported for load balancers
2828 # that have
2829 # their loadBalancingScheme set to EXTERNAL.
2830 #
2831 # Not supported when the URL map is bound to a target gRPC proxy that
2832 # has validateForProxyless field set to true.
2833 # the request is passed along to the selected backendService.
2834 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
2835 { # Specification determining how headers are added to requests or responses.
2836 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
2837 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
2838 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
2839 # that already
2840 # exist for the header. If true, headerValue is set for the
2841 # header, discarding any values that were set for that header.
2842 #
2843 # The default value is true,
2844 # unless a variable is present in headerValue,
2845 # in which case the default value is false.
2846 # .
2847 },
2848 ],
2849 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
2850 # request before forwarding the request to the backendService.
2851 &quot;A String&quot;,
2852 ],
2853 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
2854 # client.
2855 { # Specification determining how headers are added to requests or responses.
2856 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
2857 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
2858 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
2859 # that already
2860 # exist for the header. If true, headerValue is set for the
2861 # header, discarding any values that were set for that header.
2862 #
2863 # The default value is true,
2864 # unless a variable is present in headerValue,
2865 # in which case the default value is false.
2866 # .
2867 },
2868 ],
2869 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
2870 # response before sending the response back to the client.
2871 &quot;A String&quot;,
2872 ],
2873 },
2874 &quot;httpFilterConfigs&quot;: [ # Outbound route specific configuration fornetworkservices.HttpFilter resources enabled by Traffic
2875 # Director. httpFilterConfigs only applies for load balancers
2876 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
2877 # more details.
2878 #
2879 # Not supported when the URL map is bound to a target gRPC proxy that
2880 # has validateForProxyless field set to true.
2881 { # HttpFilterConfiguration supplies additional contextual settings
2882 # for networkservices.HttpFilter resources enabled by Traffic
2883 # Director.
2884 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
2885 # YAML formatted and only contain fields defined in the protobuf identified
2886 # in configTypeUrl
2887 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
2888 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
2889 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
2890 # configuration belongs to. This name must be known to the xDS client.
2891 # Example: envoy.wasm
2892 },
2893 ],
2894 &quot;httpFilterMetadata&quot;: [ # Outbound route specific metadata supplied tonetworkservices.HttpFilter resources enabled by Traffic
2895 # Director. httpFilterMetadata only applies for load balancers
2896 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
2897 # more details.
2898 #
2899 # The only configTypeUrl supported istype.googleapis.com/google.protobuf.Struct
2900 #
2901 # Not supported when the URL map is bound to a target gRPC proxy that
2902 # has validateForProxyless field set to true.
2903 { # HttpFilterConfiguration supplies additional contextual settings
2904 # for networkservices.HttpFilter resources enabled by Traffic
2905 # Director.
2906 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
2907 # YAML formatted and only contain fields defined in the protobuf identified
2908 # in configTypeUrl
2909 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
2910 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
2911 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
2912 # configuration belongs to. This name must be known to the xDS client.
2913 # Example: envoy.wasm
2914 },
2915 ],
2916 &quot;matchRules&quot;: [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
2917 # this routeRule when any of thematchRules are satisfied. However predicates within
2918 # a given matchRule have AND semantics. All predicates
2919 # within a matchRule must match for the request to
2920 # match the rule.
2921 { # HttpRouteRuleMatch specifies a set of criteria for matching
2922 # requests to an HttpRouteRule. All specified criteria must
2923 # be satisfied for a match to occur.
2924 &quot;fullPathMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
2925 # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
2926 # that may be part of the original URL.
2927 #
2928 # fullPathMatch must be from 1 to 1024 characters.
2929 #
2930 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
2931 # specified.
2932 &quot;headerMatches&quot;: [ # Specifies a list of header match criteria, all of which must match
2933 # corresponding headers in the request.
2934 { # matchRule criteria for request header matches.
2935 &quot;exactMatch&quot;: &quot;A String&quot;, # The value should exactly match contents of exactMatch.
2936 #
2937 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
2938 &quot;headerName&quot;: &quot;A String&quot;, # The name of the HTTP header to match.
2939 #
2940 # For matching against the HTTP request&#x27;s authority, use a headerMatch
2941 # with the header name &quot;:authority&quot;.
2942 #
2943 # For matching a request&#x27;s method, use the headerName &quot;:method&quot;.
2944 #
2945 # When the URL map is bound to a target gRPC proxy that has
2946 # the validateForProxyless field set to true, only
2947 # non-binary
2948 # user-specified custom metadata and the `content-type` header are supported.
2949 # The following transport-level headers cannot be used in header matching
2950 # rules:
2951 # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
2952 # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
2953 # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
2954 # `grpc-timeout` and `grpc-trace-bin`.
2955 &quot;invertMatch&quot;: True or False, # If set to false, the headerMatch is considered a
2956 # match if the preceding match criteria are met. If set to true,
2957 # the headerMatch is considered a match if the preceding
2958 # match criteria are NOT met.
2959 #
2960 # The default setting is false.
2961 &quot;prefixMatch&quot;: &quot;A String&quot;, # The value of the header must start with the contents ofprefixMatch.
2962 #
2963 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
2964 &quot;presentMatch&quot;: True or False, # A header with the contents of headerName must exist. The
2965 # match takes place whether or not the request&#x27;s header has a value.
2966 #
2967 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
2968 &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
2969 # specified in rangeMatch. If the header does not contain an
2970 # integer, number or is empty, the match fails.
2971 #
2972 # For example for a range [-5, 0]
2973 #
2974 #
2975 # - -3 will match.
2976 # - 0 will not match.
2977 # - 0.25 will not match.
2978 # - -3someString will not match.
2979 #
2980 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
2981 #
2982 # rangeMatch is not supported for load balancers
2983 # that have loadBalancingScheme set to EXTERNAL.
2984 # within the specified integer range.
2985 &quot;rangeEnd&quot;: &quot;A String&quot;, # The end of the range (exclusive) in signed long integer format.
2986 &quot;rangeStart&quot;: &quot;A String&quot;, # The start of the range (inclusive) in signed long integer format.
2987 },
2988 &quot;regexMatch&quot;: &quot;A String&quot;, # The value of the header must match the regular expression specified inregexMatch.
2989 # For more information about regular expression syntax, see Syntax.
2990 #
2991 # For matching against a port specified in the HTTP request, use a
2992 # headerMatch with headerName set to PORT and a regular expression that
2993 # satisfies the RFC2616 Host header&#x27;s port specifier.
2994 #
2995 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
2996 #
2997 # Regular expressions can only be used when the loadBalancingScheme is
2998 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
2999 # (regional scope) or INTERNAL_MANAGED.
3000 &quot;suffixMatch&quot;: &quot;A String&quot;, # The value of the header must end with the contents ofsuffixMatch.
3001 #
3002 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
3003 },
3004 ],
3005 &quot;ignoreCase&quot;: True or False, # Specifies that prefixMatch and fullPathMatch
3006 # matches are case sensitive.
3007 #
3008 # The default value is false.
3009 #
3010 # ignoreCase must not be used with regexMatch.
3011 #
3012 # Not supported when the URL map is bound to a target gRPC proxy.
3013 &quot;metadataFilters&quot;: [ # Opaque filter criteria used by the load balancer to restrict routing
3014 # configuration to a limited set of xDS
3015 # compliant clients. In their xDS requests to the load balancer, xDS clients
3016 # present node
3017 # metadata. When there is a match, the relevant routing configuration
3018 # is made available to those proxies.
3019 #
3020 # 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
3021 # the metadata. If its filterMatchCriteria is set to
3022 # MATCH_ALL, then all of its filterLabels must match with
3023 # corresponding labels provided in the metadata. If multiple
3024 # metadata filters are specified, all of them need to be
3025 # satisfied in order to be considered a match.
3026 #
3027 # metadataFilters specified here is applied after those
3028 # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
3029 #
3030 # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
3031 #
3032 # Not supported when the URL map is bound to a target gRPC proxy that
3033 # has validateForProxyless field set to true.
3034 { # Opaque filter criteria used by load balancers to restrict routing
3035 # configuration to a limited set of load balancing proxies. Proxies and
3036 # sidecars involved in load balancing would typically present metadata to the
3037 # load balancers that need to match criteria specified here. If a match takes
3038 # place, the relevant configuration is made available to those
3039 # proxies.
3040 #
3041 # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
3042 # one of thefilterLabels must match the corresponding label provided in
3043 # the metadata. If its filterMatchCriteria is set to
3044 # MATCH_ALL, then all of its filterLabels must match with
3045 # corresponding labels provided in the metadata.
3046 #
3047 # An example for using metadataFilters would be: if
3048 # load balancing involves
3049 # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in of their XDS requests to loadbalancers.
3050 &quot;filterLabels&quot;: [ # The list of label value pairs that must match labels in the provided
3051 # metadata based on filterMatchCriteria
3052 #
3053 # This list must not be empty and can have at the most 64 entries.
3054 { # MetadataFilter label name value pairs that are expected
3055 # to match corresponding labels presented as metadata to the load balancer.
3056 &quot;name&quot;: &quot;A String&quot;, # Name of metadata label.
3057 #
3058 # The name can have a maximum length of 1024 characters and must be at
3059 # least 1 character long.
3060 &quot;value&quot;: &quot;A String&quot;, # The value of the label must match the specified value.
3061 #
3062 # value can have a maximum length of 1024 characters.
3063 },
3064 ],
3065 &quot;filterMatchCriteria&quot;: &quot;A String&quot;, # Specifies how individual filter label matches
3066 # within the list of filterLabels and contributes toward the
3067 # overall metadataFilter match.
3068 #
3069 # Supported values are:
3070 #
3071 # - MATCH_ANY: at least one of the filterLabels
3072 # must have a matching label in the provided metadata.
3073 # - MATCH_ALL: all filterLabels must have
3074 # matching labels in the provided metadata.
3075 },
3076 ],
3077 &quot;pathTemplateMatch&quot;: &quot;A String&quot;, # If specified, this field defines a path template pattern that must match
3078 # the :path header after the query string is removed.
3079 #
3080 # A path template pattern can include variables and wildcards.
3081 # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
3082 # matches a single path segment, and ** that matches zero or
3083 # more path segments. The pattern must follow these rules:
3084 #
3085 #
3086 # - The value must be between 1 and 1024 characters.
3087 # - The pattern must start with a leading slash (&quot;/&quot;).
3088 # - No more than 5 operators (variables or wildcards) may appear in
3089 # the pattern.
3090 #
3091 # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
3092 # set.
3093 &quot;prefixMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the request&#x27;s
3094 # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
3095 #
3096 # The value must be from 1 to 1024 characters.
3097 #
3098 # The * character inside a prefix match is
3099 # treated as a literal character, not as a wildcard.
3100 #
3101 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
3102 # used within a matchRule.
3103 &quot;queryParameterMatches&quot;: [ # Specifies a list of query parameter match criteria, all of which must
3104 # match corresponding query parameters in the request.
3105 #
3106 # Not supported when the URL map is bound to a target gRPC proxy.
3107 { # HttpRouteRuleMatch criteria for a request&#x27;s query parameter.
3108 &quot;exactMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
3109 # parameter exactly matches the contents of exactMatch.
3110 #
3111 # Only one of presentMatch, exactMatch, orregexMatch must be set.
3112 &quot;name&quot;: &quot;A String&quot;, # The name of the query parameter to match. The query parameter must exist in
3113 # the request, in the absence of which the request match fails.
3114 &quot;presentMatch&quot;: True or False, # Specifies that the queryParameterMatch matches if the
3115 # request contains the query parameter, irrespective of whether the
3116 # parameter has a value or not.
3117 #
3118 # Only one of presentMatch, exactMatch, orregexMatch must be set.
3119 &quot;regexMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
3120 # parameter matches the regular expression specified byregexMatch. For
3121 # more information about regular expression syntax, see Syntax.
3122 #
3123 # Only one of presentMatch, exactMatch, orregexMatch must be set.
3124 #
3125 # Regular expressions can only be used when the loadBalancingScheme is
3126 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
3127 # (regional scope) or INTERNAL_MANAGED.
3128 },
3129 ],
3130 &quot;regexMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
3131 # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
3132 # supplied with the original URL. For
3133 # more information about regular expression syntax, see Syntax.
3134 #
3135 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
3136 # specified.
3137 #
3138 # Regular expressions can only be used when the loadBalancingScheme is
3139 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
3140 # (regional scope) or INTERNAL_MANAGED.
3141 },
3142 ],
3143 &quot;priority&quot;: 42, # For routeRules within a given pathMatcher,
3144 # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
3145 # of priority, from the lowest to highest number. The priority of a
3146 # rule decreases as its number increases (1, 2, 3, N+1). The first rule
3147 # that matches the request is applied.
3148 #
3149 #
3150 # You cannot configure two or more routeRules with the same priority.
3151 # Priority for each rule must be set to a number from 0 to 2147483647
3152 # inclusive.
3153 #
3154 #
3155 # Priority numbers can have gaps, which enable you to add or remove rules
3156 # in the future without affecting the rest of the rules. For example, 1, 2,
3157 # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
3158 # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
3159 # without any impact on existing rules.
3160 &quot;routeAction&quot;: { # In response to a matching matchRule, the load balancer
3161 # performs advanced routing actions, such as URL rewrites and header
3162 # transformations, before forwarding the request to the selected backend.
3163 #
3164 #
3165 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
3166 #
3167 #
3168 # URL maps for classic Application Load Balancers only support
3169 # the urlRewrite action within a route rule&#x27;srouteAction.
3170 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
3171 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
3172 # property must be specified. This policy cannot be specified if any target
3173 # backend has Identity-Aware Proxy enabled.
3174 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
3175 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
3176 # header names can be specified. The cache is bypassed for all `cacheMode`
3177 # values.
3178 &quot;A String&quot;,
3179 ],
3180 &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
3181 # on the backend type: for Backend Services, the complete request URI is
3182 # used; for Backend Buckets, the request URI is used without the protocol or
3183 # host, and only query parameters known to Cloud Storage are included.
3184 # Policy defined on Route Action.
3185 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
3186 # parameters will be included. Either specify `excludedQueryParameters`
3187 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
3188 # encoded and not treated as delimiters.
3189 #
3190 # Note: This field applies to routes that use backend services. Attempting
3191 # to set it on a route that points exclusively to Backend Buckets will
3192 # result in a configuration error. For routes that point to a Backend
3193 # Bucket, use `includedQueryParameters` to define which parameters should
3194 # be part of the cache key.
3195 &quot;A String&quot;,
3196 ],
3197 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
3198 #
3199 # Note: This setting is only applicable to routes that use a Backend
3200 # Service. It does not affect requests served by a Backend Bucket, as the
3201 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
3202 # it on a route that points exclusively to Backend Buckets will result in a
3203 # configuration error.
3204 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
3205 #
3206 # Note: This setting is only applicable to routes that use a Backend
3207 # Service. It does not affect requests served by a Backend Bucket, as the
3208 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
3209 # set on a route that points exclusively to Backend Buckets will result in
3210 # a configuration error.
3211 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
3212 # `includedQueryParameters` and `excludedQueryParameters`. If neither
3213 # is set, the entire query string will be included. If false, the query
3214 # string will be excluded from the cache key entirely.
3215 #
3216 # Note: This field applies to routes that use backend services. Attempting
3217 # to set it on a route that points exclusively to Backend Buckets will
3218 # result in a configuration error. For routes that point to a Backend
3219 # Bucket, use `includedQueryParameters` to define which parameters should
3220 # be part of the cache key.
3221 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
3222 # The name=value pair will be used in the cache key Cloud CDN generates.
3223 #
3224 # Note: This setting is only applicable to routes that use a Backend
3225 # Service. It does not affect requests served by a Backend Bucket.
3226 # Attempting to set it on a route that points exclusively to Backend
3227 # Buckets will result in a configuration error. Up to 5 cookie names can be
3228 # specified.
3229 &quot;A String&quot;,
3230 ],
3231 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
3232 &quot;A String&quot;,
3233 ],
3234 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
3235 # parameters will be excluded. Either specify `includedQueryParameters`
3236 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
3237 # encoded and not treated as delimiters.
3238 &quot;A String&quot;,
3239 ],
3240 },
3241 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
3242 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
3243 &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
3244 # content. This is used to clamp the max-age (or Expires) value sent to the
3245 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
3246 # is used for the response max-age directive, along with a &quot;public&quot;
3247 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
3248 # clamps the max-age from the origin (if specified), or else sets the
3249 # response max-age directive to the lesser of the `clientTtl` and
3250 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
3251 # present. The maximum allowed value is 31,622,400s (1 year). If not
3252 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
3253 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
3254 # `USE_ORIGIN_HEADERS`.
3255 # as a count of seconds and fractions of seconds at nanosecond
3256 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3257 # or &quot;month&quot;. Range is approximately 10,000 years.
3258 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3259 # Durations less than one second are represented with a 0
3260 # `seconds` field and a positive `nanos` field. Must be from 0
3261 # to 999,999,999 inclusive.
3262 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3263 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3264 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3265 },
3266 &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
3267 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
3268 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
3269 # greater than that of `maxTtl`. When the `cacheMode` is set to
3270 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
3271 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
3272 # accessed objects may be evicted from the cache before the defined TTL. If
3273 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
3274 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
3275 # `USE_ORIGIN_HEADERS`.
3276 # as a count of seconds and fractions of seconds at nanosecond
3277 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3278 # or &quot;month&quot;. Range is approximately 10,000 years.
3279 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3280 # Durations less than one second are represented with a 0
3281 # `seconds` field and a positive `nanos` field. Must be from 0
3282 # to 999,999,999 inclusive.
3283 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3284 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3285 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3286 },
3287 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
3288 # attempt to set a max-age or s-maxage higher than this, or an Expires header
3289 # more than `maxTtl` seconds in the future will be capped at the value of
3290 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
3291 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
3292 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
3293 # Infrequently accessed objects may be evicted from the cache before the
3294 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
3295 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
3296 # mode.
3297 # as a count of seconds and fractions of seconds at nanosecond
3298 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3299 # or &quot;month&quot;. Range is approximately 10,000 years.
3300 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3301 # Durations less than one second are represented with a 0
3302 # `seconds` field and a positive `nanos` field. Must be from 0
3303 # to 999,999,999 inclusive.
3304 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3305 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3306 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3307 },
3308 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
3309 # to apply fine-grained caching for common errors or redirects.
3310 # This can reduce the load on your origin and improve end-user
3311 # experience by reducing response latency.
3312 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
3313 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
3314 # the specified response code that lack any Cache-Control, Expires, or
3315 # Pragma: no-cache directives. When the `cacheMode` is set to
3316 # `FORCE_CACHE_ALL`, negative caching applies to all responses
3317 # with the specified response code, and overrides any caching headers. By
3318 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
3319 #
3320 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
3321 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
3322 # * 405 (Method Not Found), 501 (Not Implemented): 60s
3323 #
3324 # These defaults can be overridden in `negativeCachingPolicy`.
3325 # If not specified, Cloud CDN applies negative caching by default.
3326 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
3327 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
3328 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
3329 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
3330 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
3331 # all response codes that you wish to cache. Cloud CDN will not apply any
3332 # default negative caching when a policy exists.
3333 { # Specify CDN TTLs for response error codes.
3334 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
3335 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
3336 # specified as values, and you cannot specify a status code more than
3337 # once.
3338 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
3339 # corresponding status code.
3340 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
3341 # objects may be evicted from the cache before the defined TTL.
3342 # as a count of seconds and fractions of seconds at nanosecond
3343 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3344 # or &quot;month&quot;. Range is approximately 10,000 years.
3345 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3346 # Durations less than one second are represented with a 0
3347 # `seconds` field and a positive `nanos` field. Must be from 0
3348 # to 999,999,999 inclusive.
3349 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3350 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3351 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3352 },
3353 },
3354 ],
3355 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
3356 # requests into a small number of requests to the origin. If not specified,
3357 # Cloud CDN applies request coalescing by default.
3358 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
3359 # content with the origin, or when an error is encountered when refreshing
3360 # the cache.
3361 # This setting defines the default &quot;max-stale&quot; duration for any cached
3362 # responses that do not specify a max-stale directive. Stale responses that
3363 # exceed the TTL configured here will not be served. The default limit
3364 # (max-stale) is 86400s (1 day), which will allow stale content to be
3365 # served up to this limit beyond the max-age (or s-maxage) of a cached
3366 # response.
3367 # The maximum allowed value is 604800 (1 week).
3368 # Set this to zero (0) to disable serve-while-stale.
3369 # as a count of seconds and fractions of seconds at nanosecond
3370 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3371 # or &quot;month&quot;. Range is approximately 10,000 years.
3372 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3373 # Durations less than one second are represented with a 0
3374 # `seconds` field and a positive `nanos` field. Must be from 0
3375 # to 999,999,999 inclusive.
3376 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3377 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3378 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3379 },
3380 },
3381 &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
3382 # information about the W3C recommendation for cross-origin resource sharing
3383 # (CORS), see Fetch API Living
3384 # Standard.
3385 #
3386 # Not supported when the URL map is bound to a target gRPC proxy.
3387 # information about the W3C recommendation for cross-origin resource sharing
3388 # (CORS), see Fetch API Living
3389 # Standard.
3390 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
3391 # indicates that
3392 # the actual request can include user credentials. This field translates to
3393 # the Access-Control-Allow-Credentials header.
3394 #
3395 # Default is false.
3396 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
3397 # header.
3398 &quot;A String&quot;,
3399 ],
3400 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
3401 # header.
3402 &quot;A String&quot;,
3403 ],
3404 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
3405 # more information, see regular expression syntax.
3406 #
3407 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
3408 #
3409 # Regular expressions can only be used when the loadBalancingScheme is
3410 # set to INTERNAL_SELF_MANAGED.
3411 &quot;A String&quot;,
3412 ],
3413 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
3414 #
3415 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
3416 &quot;A String&quot;,
3417 ],
3418 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
3419 # The default value is false, which indicates that the CORS
3420 # policy is in effect.
3421 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
3422 # header.
3423 &quot;A String&quot;,
3424 ],
3425 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
3426 # seconds. This field translates to the Access-Control-Max-Age
3427 # header.
3428 },
3429 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
3430 # the resiliency of clients to backend service failure. As part of fault
3431 # injection, when clients send requests to a backend service, delays can be
3432 # introduced by a load balancer on a percentage of requests before sending
3433 # those requests to the backend service. Similarly requests from clients can
3434 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
3435 # that are configured with a fault_injection_policy if:
3436 # 1. The traffic is generated by fault injection AND
3437 # 2. The fault injection is not a delay fault injection.
3438 # Fault injection is not supported with the classic Application Load Balancer
3439 # . To see which load balancers support fault injection,
3440 # see Load
3441 # balancing: Routing and traffic management features.
3442 # the resiliency of clients to backend service failure. As part of fault
3443 # injection, when clients send requests to a backend service, delays can be
3444 # introduced by the load balancer on a percentage of requests before sending
3445 # those request to the backend service. Similarly requests from clients can be
3446 # aborted by the load balancer for a percentage of requests.
3447 &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
3448 # injection.
3449 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
3450 #
3451 # The value must be from 200 to 599 inclusive.
3452 #
3453 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
3454 # according to this
3455 # mapping table. HTTP status 200 is mapped to gRPC status
3456 # UNKNOWN. Injecting an OK status is currently not supported by
3457 # Traffic Director.
3458 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
3459 # that is aborted as part of fault injection.
3460 #
3461 # The value must be from 0.0 to 100.0 inclusive.
3462 },
3463 &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
3464 # injection, before being sent to a backend service.
3465 # request to the backend service as part of fault injection.
3466 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
3467 # as a count of seconds and fractions of seconds at nanosecond
3468 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3469 # or &quot;month&quot;. Range is approximately 10,000 years.
3470 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3471 # Durations less than one second are represented with a 0
3472 # `seconds` field and a positive `nanos` field. Must be from 0
3473 # to 999,999,999 inclusive.
3474 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3475 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3476 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3477 },
3478 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
3479 # which a delay is introduced as part of fault injection.
3480 #
3481 # The value must be from 0.0 to 100.0 inclusive.
3482 },
3483 },
3484 &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
3485 # Global EXTERNAL_MANAGED load balancer schemes.
3486 # Either Cloud CDN must be enabled on the backend service or backend bucket
3487 # serving the route, or cache policy must be configured on the same route
3488 # dynamically processes and delivers images from the network edge.
3489 # Image Optimization is only available for Global External Application Load
3490 # Balancers.
3491 # Either Cloud CDN must be enabled on the backend service or backend bucket
3492 # serving the route, or cache policy must be configured on the same route.
3493 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
3494 },
3495 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
3496 # Unlike the timeout field where the timeout duration starts
3497 # from the time the request has been fully processed (known as*end-of-stream*),
3498 # the duration in this field is computed from the beginning of the stream
3499 # until the response has been processed, including all retries. A
3500 # stream that does not complete in this duration is closed.
3501 #
3502 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
3503 # with the route.
3504 #
3505 # This field is only allowed if the Url map is used with backend services
3506 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
3507 # as a count of seconds and fractions of seconds at nanosecond
3508 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3509 # or &quot;month&quot;. Range is approximately 10,000 years.
3510 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3511 # Durations less than one second are represented with a 0
3512 # `seconds` field and a positive `nanos` field. Must be from 0
3513 # to 999,999,999 inclusive.
3514 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3515 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3516 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3517 },
3518 &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
3519 # are shadowed to a separate mirrored backend service. The load balancer does
3520 # not wait for responses from the shadow service. Before sending traffic
3521 # to the shadow service, the host / authority header is suffixed with-shadow.
3522 #
3523 # Not supported when the URL map is bound to a target gRPC proxy that
3524 # has the validateForProxyless field set to true.
3525 # are shadowed to a separate mirrored backend service. The load balancer
3526 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
3527 # to the shadow service, the host or authority header is suffixed with-shadow.
3528 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
3529 # mirrored to.
3530 #
3531 # The backend service configured for a mirroring
3532 # policy must reference backends that are of the same type as the original
3533 # backend service matched in the URL map.
3534 #
3535 # Serverless NEG backends are not currently supported as a mirrored
3536 # backend service.
3537 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
3538 },
3539 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
3540 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
3541 # If not specified, defaults to 1.
3542 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
3543 #
3544 # If not specified, will use the timeout set in theHttpRouteAction field.
3545 # If timeout in the HttpRouteAction field is not set, this field
3546 # uses the largest timeout
3547 # among all backend services associated with the route.
3548 #
3549 # Not supported when the URL map is bound to a target gRPC proxy that
3550 # has the validateForProxyless field set to true.
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;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
3563 # values are:
3564 #
3565 # - 5xx: retry is attempted if the instance or endpoint
3566 # responds with any 5xx response code, or if the instance or
3567 # endpoint does not respond at all. For example, disconnects, reset, read
3568 # timeout, connection failure, and refused streams.
3569 # - gateway-error: Similar to 5xx, but only
3570 # applies to response codes 502, 503 or504.
3571 # - connect-failure: a retry is attempted on failures
3572 # connecting to the instance or endpoint. For example, connection
3573 # timeouts.
3574 # - retriable-4xx: a retry is attempted if the instance
3575 # or endpoint responds with a 4xx response code.
3576 # The only error that you can retry is error code 409.
3577 # - refused-stream: a retry is attempted if the instance
3578 # or endpoint resets the stream with a REFUSED_STREAM error
3579 # code. This reset type indicates that it is safe to retry.
3580 # - cancelled: a retry is attempted if the gRPC status
3581 # code in the response header is set to cancelled.
3582 # - deadline-exceeded: a retry is attempted if the gRPC
3583 # status code in the response header is set todeadline-exceeded.
3584 # - internal: a retry is attempted if the gRPC
3585 # status code in the response header is set tointernal.
3586 # - resource-exhausted: a retry is attempted if the gRPC
3587 # status code in the response header is set toresource-exhausted.
3588 # - unavailable: a retry is attempted if the gRPC
3589 # status code in the response header is set tounavailable.
3590 #
3591 # Only the following codes are supported when the URL map is bound to
3592 # target gRPC proxy that has validateForProxyless field set to true.
3593 #
3594 # - cancelled
3595 # - deadline-exceeded
3596 # - internal
3597 # - resource-exhausted
3598 # - unavailable
3599 &quot;A String&quot;,
3600 ],
3601 },
3602 &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
3603 # time the request has been fully processed (known as *end-of-stream*)
3604 # up until the response has been processed. Timeout includes
3605 # all retries.
3606 #
3607 # If not specified, this field uses the largest timeout among all backend
3608 # services associated with the route.
3609 #
3610 # Not supported when the URL map is bound to a target gRPC proxy that
3611 # has validateForProxyless field set to true.
3612 # as a count of seconds and fractions of seconds at nanosecond
3613 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3614 # or &quot;month&quot;. Range is approximately 10,000 years.
3615 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3616 # Durations less than one second are represented with a 0
3617 # `seconds` field and a positive `nanos` field. Must be from 0
3618 # to 999,999,999 inclusive.
3619 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3620 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3621 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3622 },
3623 &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
3624 # to the matched service.
3625 #
3626 # urlRewrite is the only action supported in UrlMaps
3627 # for classic Application Load Balancers.
3628 #
3629 # Not supported when the URL map is bound to a target gRPC proxy that
3630 # has the validateForProxyless field set to true.
3631 # backend service.
3632 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
3633 # host header is replaced with contents of hostRewrite.
3634 #
3635 # The value must be from 1 to 255 characters.
3636 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
3637 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
3638 #
3639 # The value must be from 1 to 1024 characters.
3640 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
3641 # header) using the HTTP template syntax.
3642 #
3643 # A corresponding
3644 # path_template_match must be specified. Any template variables must exist in
3645 # the path_template_match field.
3646 #
3647 #
3648 # - -At least one variable must be specified in the path_template_match
3649 # field
3650 # - You can omit variables from the rewritten URL
3651 # - The * and ** operators cannot be matched
3652 # unless they have a corresponding variable name - e.g.
3653 # {format=*} or {var=**}.
3654 #
3655 # For example, a path_template_match of /static/{format=**}
3656 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
3657 # rewrite, so that /{country}/{format}/{suffix=**} can be
3658 # rewritten as /content/{format}/{country}/{suffix}.
3659 #
3660 # At least
3661 # one non-empty routeRules[].matchRules[].path_template_match is
3662 # required.
3663 #
3664 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
3665 },
3666 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
3667 # occurs. The weights determine the fraction of traffic that flows to
3668 # their corresponding backend service. If all traffic needs to
3669 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
3670 #
3671 # After a backend service is identified and before forwarding
3672 # the request to
3673 # the backend service, advanced routing actions such as URL rewrites and
3674 # header transformations are applied depending on additional settings
3675 # specified in this HttpRouteAction.
3676 { # In contrast to a single BackendService in
3677 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
3678 # multiple backend services. The volume of traffic for each
3679 # backend service is proportional to the weight specified
3680 # in each WeightedBackendService
3681 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
3682 # resource. Before
3683 # forwarding the request to backendService, the load balancer
3684 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
3685 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
3686 # effect for the selected backendService.
3687 #
3688 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
3689 #
3690 # headerAction is not supported for load balancers that have
3691 # their loadBalancingScheme set to EXTERNAL.
3692 #
3693 # Not supported when the URL map is bound to a target gRPC proxy that
3694 # has validateForProxyless field set to true.
3695 # the request is passed along to the selected backendService.
3696 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
3697 { # Specification determining how headers are added to requests or responses.
3698 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
3699 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
3700 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
3701 # that already
3702 # exist for the header. If true, headerValue is set for the
3703 # header, discarding any values that were set for that header.
3704 #
3705 # The default value is true,
3706 # unless a variable is present in headerValue,
3707 # in which case the default value is false.
3708 # .
3709 },
3710 ],
3711 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
3712 # request before forwarding the request to the backendService.
3713 &quot;A String&quot;,
3714 ],
3715 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
3716 # client.
3717 { # Specification determining how headers are added to requests or responses.
3718 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
3719 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
3720 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
3721 # that already
3722 # exist for the header. If true, headerValue is set for the
3723 # header, discarding any values that were set for that header.
3724 #
3725 # The default value is true,
3726 # unless a variable is present in headerValue,
3727 # in which case the default value is false.
3728 # .
3729 },
3730 ],
3731 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
3732 # response before sending the response back to the client.
3733 &quot;A String&quot;,
3734 ],
3735 },
3736 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
3737 # computed asweight / (sum of all weightedBackendService weights in routeAction).
3738 #
3739 # The selection of a backend service is determined only for new traffic.
3740 # Once a user&#x27;s request has been directed to a backend service,
3741 # subsequent requests are sent to the same backend service as
3742 # determined by the backend service&#x27;s session affinity policy.
3743 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
3744 # splitting. If you do, the weighted traffic splitting configuration takes
3745 # precedence.
3746 #
3747 # The value must be from 0 to 1000.
3748 },
3749 ],
3750 },
3751 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
3752 # is directed if this rule is matched. If routeAction is
3753 # also specified, advanced routing actions, such as URL rewrites,
3754 # take effect before sending the request to the backend.
3755 #
3756 #
3757 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
3758 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
3759 # specified by urlRedirect.
3760 #
3761 #
3762 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
3763 #
3764 #
3765 # Not supported when the URL map is bound to a target gRPC proxy.
3766 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
3767 # was supplied in the request.
3768 #
3769 # The value must be from 1 to 255
3770 # characters.
3771 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
3772 # set to HTTPS.
3773 # If set to false, the URL scheme of the redirected request
3774 # remains the same as that of the request.
3775 #
3776 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
3777 #
3778 # The default is set to false.
3779 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
3780 # that was supplied in the request.
3781 #
3782 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
3783 # supplied, the path of the original request is used for the redirect.
3784 #
3785 # The value must be from 1 to 1024 characters.
3786 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
3787 # the HttpRouteRuleMatch, retaining the remaining portion
3788 # of the URL before redirecting the request.
3789 #
3790 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
3791 # supplied, the path of the original request is used for the redirect.
3792 #
3793 # The value must be from 1 to 1024 characters.
3794 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
3795 #
3796 # Supported values are:
3797 #
3798 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
3799 # to 301.
3800 # - FOUND, which corresponds to 302.
3801 # - SEE_OTHER which corresponds to 303.
3802 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
3803 # method is retained.
3804 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
3805 # method is retained.
3806 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
3807 # URL is
3808 # removed before redirecting the request. If set to false, the
3809 # query portion of the original URL is retained.
3810 #
3811 # The default is set to false.
3812 },
3813 },
3814 ],
3815 },
3816 ],
3817 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the regional URL map resides.
3818 # This field is not applicable to global URL maps.
3819 # You must specify this field as part of the HTTP request URL. It is
3820 # not settable as a field in the request body.
3821 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
3822 &quot;status&quot;: { # [Output Only] The status of the URL map. # Output only. [Output Only] The status of the URL map.
3823 &quot;quotaUsage&quot;: { # Message representing the quota usage for a UrlMap. # Output only. Summary of quota usage for given UrlMap.
3824 &quot;forwardingRules&quot;: 42, # Output only. The number of forwarding rules that uses this UrlMap.
3825 &quot;units&quot;: &quot;A String&quot;, # Output only. The number of quota units calculated for this UrlMap.
3826 },
3827 },
3828 &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
3829 # maximum of 100 tests per UrlMap.
3830 #
3831 # Not supported when the URL map is bound to a target gRPC proxy that
3832 # has validateForProxyless field set to true.
3833 { # Message for the expected URL mappings.
3834 &quot;description&quot;: &quot;A String&quot;, # Description of this test case.
3835 &quot;expectedOutputUrl&quot;: &quot;A String&quot;, # The expected output URL evaluated by the load balancer
3836 # containing the scheme, host, path and query parameters.
3837 #
3838 # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
3839 # the load balancer to backends. For rules with urlRewrite,
3840 # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
3841 #
3842 # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer&#x27;s
3843 # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
3844 # If urlRedirect specifies strip_query, the test
3845 # passes only if expectedOutputUrl does not contain any query
3846 # parameters.
3847 #
3848 # expectedOutputUrl is optional whenservice is specified.
3849 &quot;expectedRedirectResponseCode&quot;: 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
3850 # load balancer&#x27;s redirect response.
3851 #
3852 # expectedRedirectResponseCode cannot be set whenservice is set.
3853 &quot;headers&quot;: [ # HTTP headers for this request. If headers contains
3854 # a host header, then host must also match the header value.
3855 { # HTTP headers used in UrlMapTests.
3856 &quot;name&quot;: &quot;A String&quot;, # Header name.
3857 &quot;value&quot;: &quot;A String&quot;, # Header value.
3858 },
3859 ],
3860 &quot;host&quot;: &quot;A String&quot;, # Host portion of the URL. If headers contains a host header,
3861 # then host must also match the header value.
3862 &quot;path&quot;: &quot;A String&quot;, # Path portion of the URL.
3863 &quot;service&quot;: &quot;A String&quot;, # Expected BackendService or BackendBucket resource
3864 # the given URL should be mapped to.
3865 #
3866 # The service field cannot
3867 # be set if expectedRedirectResponseCode is set.
3868 },
3869 ],
3870 },
3871 ],
3872 &quot;warning&quot;: { # Informational warning which replaces the list of
3873 # backend services when the list is empty.
3874 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
3875 # Engine returns NO_RESULTS_ON_PAGE if there
3876 # are no results in the response.
3877 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
3878 # value format. For example:
3879 #
3880 # &quot;data&quot;: [
3881 # {
3882 # &quot;key&quot;: &quot;scope&quot;,
3883 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
3884 # }
3885 {
3886 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
3887 # returned. For example, for warnings where there are no results in a list
3888 # request for a particular zone, this key might be scope and
3889 # the key value might be the zone name. Other examples might be a key
3890 # indicating a deprecated resource and a suggested replacement, or a
3891 # warning about invalid network settings (for example, if an instance
3892 # attempts to perform IP forwarding but is not enabled for IP forwarding).
3893 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
3894 },
3895 ],
3896 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
3897 },
3898 },
3899 },
3900 &quot;kind&quot;: &quot;compute#urlMapsAggregatedList&quot;, # Output only. Type of resource.
3901 &quot;nextPageToken&quot;: &quot;A String&quot;, # [Output Only] This token allows you to get the next page of results for
3902 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
3903 # the query parameter pageToken in the next list request.
3904 # Subsequent list requests will have their own nextPageToken to
3905 # continue paging through the results.
3906 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource.
3907 &quot;unreachables&quot;: [ # Output only. [Output Only] Unreachable resources.
3908 &quot;A String&quot;,
3909 ],
3910 &quot;warning&quot;: { # [Output Only] Informational warning message.
3911 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
3912 # Engine returns NO_RESULTS_ON_PAGE if there
3913 # are no results in the response.
3914 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
3915 # value format. For example:
3916 #
3917 # &quot;data&quot;: [
3918 # {
3919 # &quot;key&quot;: &quot;scope&quot;,
3920 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
3921 # }
3922 {
3923 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
3924 # returned. For example, for warnings where there are no results in a list
3925 # request for a particular zone, this key might be scope and
3926 # the key value might be the zone name. Other examples might be a key
3927 # indicating a deprecated resource and a suggested replacement, or a
3928 # warning about invalid network settings (for example, if an instance
3929 # attempts to perform IP forwarding but is not enabled for IP forwarding).
3930 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
3931 },
3932 ],
3933 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
3934 },
3935 }</pre>
3936 </div>
3937
3938 <div class="method">
3939 <code class="details" id="aggregatedList_next">aggregatedList_next()</code>
3940 <pre>Retrieves the next page of results.
3941
3942 Args:
3943 previous_request: The request for the previous page. (required)
3944 previous_response: The response from the request for the previous page. (required)
3945
3946 Returns:
3947 A request object that you can call &#x27;execute()&#x27; on to request the next
3948 page. Returns None if there are no more items in the collection.
3949 </pre>
3950 </div>
3951
3952 <div class="method">
3953 <code class="details" id="close">close()</code>
3954 <pre>Close httplib2 connections.</pre>
3955 </div>
3956
3957 <div class="method">
3958 <code class="details" id="delete">delete(project, urlMap, requestId=None, x__xgafv=None)</code>
3959 <pre>Deletes the specified UrlMap resource.
3960
3961 Args:
3962 project: string, Project ID for this request. (required)
3963 urlMap: string, Name of the UrlMap resource to delete. (required)
3964 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
3965 that if you must retry your request, the server will know to ignore the
3966 request if it has already been completed.
3967
3968 For example, consider a situation where you make an initial request and
3969 the request times out. If you make the request again with the same
3970 request ID, the server can check if original operation with the same
3971 request ID was received, and if so, will ignore the second request. This
3972 prevents clients from accidentally creating duplicate commitments.
3973
3974 The request ID must be
3975 a valid UUID with the exception that zero UUID is not supported
3976 (00000000-0000-0000-0000-000000000000).
3977 x__xgafv: string, V1 error format.
3978 Allowed values
3979 1 - v1 error format
3980 2 - v2 error format
3981
3982 Returns:
3983 An object of the form:
3984
3985 { # Represents an Operation resource.
3986 #
3987 # Google Compute Engine has three Operation resources:
3988 #
3989 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
3990 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
3991 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
3992 #
3993 # You can use an operation resource to manage asynchronous API requests.
3994 # For more information, readHandling
3995 # API responses.
3996 #
3997 # Operations can be global, regional or zonal.
3998 #
3999 # - For global operations, use the `globalOperations`
4000 # resource.
4001 # - For regional operations, use the
4002 # `regionOperations` resource.
4003 # - For zonal operations, use
4004 # the `zoneOperations` resource.
4005 #
4006 #
4007 #
4008 # For more information, read
4009 # Global, Regional, and Zonal Resources.
4010 #
4011 # Note that completed Operation resources have a limited
4012 # retention period.
4013 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
4014 # Not present otherwise.
4015 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
4016 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
4017 # set when the operation is created.
4018 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
4019 # text format.
4020 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
4021 # this field will be populated.
4022 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
4023 # operation.
4024 {
4025 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
4026 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
4027 # details. There is a set of defined message types to use for providing
4028 # details.The syntax depends on the error code. For example,
4029 # QuotaExceededInfo will have details when the error code is
4030 # QUOTA_EXCEEDED.
4031 {
4032 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
4033 #
4034 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
4035 # is not enabled:
4036 #
4037 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
4038 # &quot;domain&quot;: &quot;googleapis.com&quot;
4039 # &quot;metadata&quot;: {
4040 # &quot;resource&quot;: &quot;projects/123&quot;,
4041 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
4042 # }
4043 # }
4044 #
4045 # This response indicates that the pubsub.googleapis.com API is not enabled.
4046 #
4047 # Example of an error that is returned when attempting to create a Spanner
4048 # instance in a region that is out of stock:
4049 #
4050 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
4051 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
4052 # &quot;metadata&quot;: {
4053 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
4054 # }
4055 # }
4056 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
4057 # is typically the registered service name of the tool or product that
4058 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
4059 # generated by some common infrastructure, the error domain must be a
4060 # globally unique value that identifies the infrastructure. For Google API
4061 # infrastructure, the error domain is &quot;googleapis.com&quot;.
4062 &quot;metadatas&quot;: { # Additional structured details about this error.
4063 #
4064 # Keys must match a regular expression of `a-z+` but should
4065 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
4066 # length. When identifying the current value of an exceeded limit, the units
4067 # should be contained in the key, not the value. For example, rather than
4068 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
4069 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
4070 # instances that can be created in a single (batch) request.
4071 &quot;a_key&quot;: &quot;A String&quot;,
4072 },
4073 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
4074 # proximate cause of the error. Error reasons are unique within a particular
4075 # domain of errors. This should be at most 63 characters and match a
4076 # regular expression of `A-Z+[A-Z0-9]`, which represents
4077 # UPPER_SNAKE_CASE.
4078 },
4079 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
4080 #
4081 # For example, if a quota check failed with an error indicating the calling
4082 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
4083 # directly to the right place in the developer console to flip the bit.
4084 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
4085 { # Describes a URL link.
4086 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
4087 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
4088 },
4089 ],
4090 },
4091 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
4092 # which can be attached to an RPC error.
4093 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
4094 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
4095 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
4096 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
4097 },
4098 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
4099 &quot;dimensions&quot;: { # The map holding related quota dimensions.
4100 &quot;a_key&quot;: &quot;A String&quot;,
4101 },
4102 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
4103 # type or metric.
4104 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
4105 # or metric.
4106 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
4107 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
4108 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
4109 },
4110 },
4111 ],
4112 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
4113 # This property is optional.
4114 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
4115 },
4116 ],
4117 },
4118 &quot;getVersionOperationMetadata&quot;: {
4119 &quot;inlineSbomInfo&quot;: {
4120 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
4121 # appropriate identifiers.
4122 &quot;a_key&quot;: &quot;A String&quot;,
4123 },
4124 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
4125 # identifiers.
4126 &quot;a_key&quot;: &quot;A String&quot;,
4127 },
4128 },
4129 },
4130 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
4131 # message that was returned, such as `NOT FOUND`.
4132 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
4133 # status code that was returned. For example, a `404` means the
4134 # resource was not found.
4135 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
4136 # defined by the server.
4137 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
4138 # This value is inRFC3339
4139 # text format.
4140 &quot;instancesBulkInsertOperationMetadata&quot;: {
4141 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
4142 # Example key: zones/us-central1-a
4143 &quot;a_key&quot;: {
4144 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
4145 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
4146 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
4147 # error.
4148 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
4149 # if the flow is rolling forward or rolling back.
4150 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
4151 },
4152 },
4153 },
4154 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
4155 # Operation resources.
4156 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
4157 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
4158 # group of operations results from a `bulkInsert` API request.
4159 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
4160 # `update`, or `delete`, and so on.
4161 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
4162 # There is no requirement that this be linear or support any granularity of
4163 # operations. This should not be used to guess when the operation will be
4164 # complete. This number should monotonically increase as the operation
4165 # progresses.
4166 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
4167 # applicable when performing regional operations.
4168 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
4169 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
4170 # this field will contain information on all underlying zonal actions and
4171 # their state.
4172 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
4173 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
4174 # Example key: zones/us-central1-a
4175 &quot;a_key&quot;: {
4176 &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
4177 # populated.
4178 # different programming environments, including REST APIs and RPC APIs. It is
4179 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
4180 # three pieces of data: error code, error message, and error details.
4181 #
4182 # You can find out more about this error model and how to work with it in the
4183 # [API Design Guide](https://cloud.google.com/apis/design/errors).
4184 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
4185 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
4186 # message types for APIs to use.
4187 {
4188 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
4189 },
4190 ],
4191 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
4192 # user-facing error message should be localized and sent in the
4193 # google.rpc.Status.details field, or localized by the client.
4194 },
4195 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
4196 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
4197 },
4198 },
4199 },
4200 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
4201 # This value is inRFC3339
4202 # text format.
4203 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
4204 # following:
4205 # `PENDING`, `RUNNING`, or `DONE`.
4206 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
4207 # operation.
4208 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
4209 # of the target resource.
4210 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
4211 # operations related to creating a snapshot, this points to the disk
4212 # that the snapshot was created from.
4213 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
4214 # `[email protected]` or
4215 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
4216 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
4217 # operation, this field will be populated.
4218 {
4219 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
4220 # Engine returns NO_RESULTS_ON_PAGE if there
4221 # are no results in the response.
4222 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
4223 # value format. For example:
4224 #
4225 # &quot;data&quot;: [
4226 # {
4227 # &quot;key&quot;: &quot;scope&quot;,
4228 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
4229 # }
4230 {
4231 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
4232 # returned. For example, for warnings where there are no results in a list
4233 # request for a particular zone, this key might be scope and
4234 # the key value might be the zone name. Other examples might be a key
4235 # indicating a deprecated resource and a suggested replacement, or a
4236 # warning about invalid network settings (for example, if an instance
4237 # attempts to perform IP forwarding but is not enabled for IP forwarding).
4238 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
4239 },
4240 ],
4241 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
4242 },
4243 ],
4244 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
4245 # applicable when performing per-zone operations.
4246 }</pre>
4247 </div>
4248
4249 <div class="method">
4250 <code class="details" id="get">get(project, urlMap, x__xgafv=None)</code>
4251 <pre>Returns the specified UrlMap resource.
4252
4253 Args:
4254 project: string, Project ID for this request. (required)
4255 urlMap: string, Name of the UrlMap resource to return. (required)
4256 x__xgafv: string, V1 error format.
4257 Allowed values
4258 1 - v1 error format
4259 2 - v2 error format
4260
4261 Returns:
4262 An object of the form:
4263
4264 { # Represents a URL Map resource.
4265 #
4266 # Compute Engine has two URL Map resources:
4267 #
4268 # * [Global](/compute/docs/reference/rest/beta/urlMaps)
4269 # * [Regional](/compute/docs/reference/rest/beta/regionUrlMaps)
4270 #
4271 # A URL map resource is a component of certain types of cloud load balancers
4272 # and Traffic Director:
4273 #
4274 # * urlMaps are used by global external Application Load
4275 # Balancers, classic Application Load Balancers, and cross-region internal
4276 # Application Load Balancers.
4277 # * regionUrlMaps are used by internal Application Load Balancers,
4278 # regional external Application Load Balancers and regional internal
4279 # Application Load Balancers.
4280 #
4281 # For a list of supported URL map features by the load balancer type, see the
4282 # Load balancing features: Routing and traffic management table.
4283 #
4284 # For a list of supported URL map features for Traffic Director, see the
4285 # Traffic Director features: Routing and traffic management table.
4286 #
4287 # This resource defines mappings from hostnames and URL paths to either a
4288 # backend service or a backend bucket.
4289 #
4290 # To use the global urlMaps resource, the backend service must
4291 # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
4292 # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
4293 # information, read URL
4294 # Map Concepts.
4295 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
4296 # text format.
4297 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
4298 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
4299 #
4300 # This policy takes
4301 # effect at the load balancer level and applies only when no policy has been
4302 # defined for the error code at lower levels like PathMatcher, RouteRule and
4303 # PathRule within this UrlMap.
4304 #
4305 # For example, consider a UrlMap with the
4306 # following configuration:
4307 #
4308 #
4309 # - defaultCustomErrorResponsePolicy containing policies for
4310 # responding to 5xx and 4xx errors
4311 # - A PathMatcher configured for *.example.com has
4312 # defaultCustomErrorResponsePolicy for 4xx.
4313 #
4314 # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
4315 # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
4316 # a request that does not match any host in *.example.com such
4317 # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
4318 # takes effect.
4319 #
4320 # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
4321 # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
4322 # a retry, if load balancer is successful in reaching the
4323 # service, the defaultCustomErrorResponsePolicy is ignored and
4324 # the response from the service is returned to the client.
4325 #
4326 # defaultCustomErrorResponsePolicy is supported only for
4327 # global external Application Load Balancers.
4328 # backend service or backend bucket responds with an error.
4329 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
4330 #
4331 # In a given policy, if you specify rules for both a range of error codes
4332 # as well as rules for specific error codes then rules with specific error
4333 # codes have a higher priority. For example, assume that you configure a rule
4334 # for 401 (Un-authorized) code, and another for all 4 series
4335 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
4336 # However if the backend service returns a 403, the rule for4xx takes effect.
4337 { # Specifies the mapping between the response code that will be returned along
4338 # with the custom error content and the response code returned by the backend
4339 # service.
4340 &quot;matchResponseCodes&quot;: [ # Valid values include:
4341 #
4342 #
4343 # - A number between 400 and 599: For example
4344 # 401 or 503, in which case the load balancer
4345 # applies the policy if the error code exactly matches this value.
4346 # - 5xx: Load Balancer will apply the policy if the
4347 # backend service responds with any response code in the range of
4348 # 500 to 599.
4349 # - 4xx: Load
4350 # Balancer will apply the policy if the backend service responds with any
4351 # response code in the range of 400 to
4352 # 499.
4353 #
4354 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
4355 &quot;A String&quot;,
4356 ],
4357 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
4358 # error content. If overrideResponseCode is not supplied, the
4359 # same response code returned by the original backend bucket or backend
4360 # service is returned to the client.
4361 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
4362 #
4363 # path must start
4364 # with a leading slash. path cannot have trailing slashes.
4365 #
4366 # If the file is not available in backendBucket or the
4367 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
4368 #
4369 # The value must
4370 # be from 1 to 1024 characters
4371 },
4372 ],
4373 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
4374 # contains the custom error content. Examples are:
4375 #
4376 #
4377 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
4378 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
4379 # - global/backendBuckets/myBackendBucket
4380 #
4381 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
4382 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
4383 #
4384 # If load balancer cannot reach
4385 # the backendBucket, a simple Not Found Error will
4386 # be returned, with the original response code (oroverrideResponseCode if configured).
4387 #
4388 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
4389 },
4390 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
4391 # hostRules match. The load balancer performs advanced routing
4392 # actions, such as URL rewrites and header transformations, before forwarding
4393 # the request to the selected backend.
4394 #
4395 #
4396 # Only one of defaultUrlRedirect, defaultService
4397 # or defaultRouteAction.weightedBackendService can be set.
4398 #
4399 #
4400 # URL maps for classic Application Load Balancers only support
4401 # the urlRewrite action within defaultRouteAction.
4402 #
4403 #
4404 # defaultRouteAction has no effect when the URL map is bound
4405 # to a target gRPC proxy that has the validateForProxyless field
4406 # set to true.
4407 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
4408 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
4409 # property must be specified. This policy cannot be specified if any target
4410 # backend has Identity-Aware Proxy enabled.
4411 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
4412 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
4413 # header names can be specified. The cache is bypassed for all `cacheMode`
4414 # values.
4415 &quot;A String&quot;,
4416 ],
4417 &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
4418 # on the backend type: for Backend Services, the complete request URI is
4419 # used; for Backend Buckets, the request URI is used without the protocol or
4420 # host, and only query parameters known to Cloud Storage are included.
4421 # Policy defined on Route Action.
4422 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
4423 # parameters will be included. Either specify `excludedQueryParameters`
4424 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
4425 # encoded and not treated as delimiters.
4426 #
4427 # Note: This field applies to routes that use backend services. Attempting
4428 # to set it on a route that points exclusively to Backend Buckets will
4429 # result in a configuration error. For routes that point to a Backend
4430 # Bucket, use `includedQueryParameters` to define which parameters should
4431 # be part of the cache key.
4432 &quot;A String&quot;,
4433 ],
4434 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
4435 #
4436 # Note: This setting is only applicable to routes that use a Backend
4437 # Service. It does not affect requests served by a Backend Bucket, as the
4438 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
4439 # it on a route that points exclusively to Backend Buckets will result in a
4440 # configuration error.
4441 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
4442 #
4443 # Note: This setting is only applicable to routes that use a Backend
4444 # Service. It does not affect requests served by a Backend Bucket, as the
4445 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
4446 # set on a route that points exclusively to Backend Buckets will result in
4447 # a configuration error.
4448 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
4449 # `includedQueryParameters` and `excludedQueryParameters`. If neither
4450 # is set, the entire query string will be included. If false, the query
4451 # string will be excluded from the cache key entirely.
4452 #
4453 # Note: This field applies to routes that use backend services. Attempting
4454 # to set it on a route that points exclusively to Backend Buckets will
4455 # result in a configuration error. For routes that point to a Backend
4456 # Bucket, use `includedQueryParameters` to define which parameters should
4457 # be part of the cache key.
4458 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
4459 # The name=value pair will be used in the cache key Cloud CDN generates.
4460 #
4461 # Note: This setting is only applicable to routes that use a Backend
4462 # Service. It does not affect requests served by a Backend Bucket.
4463 # Attempting to set it on a route that points exclusively to Backend
4464 # Buckets will result in a configuration error. Up to 5 cookie names can be
4465 # specified.
4466 &quot;A String&quot;,
4467 ],
4468 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
4469 &quot;A String&quot;,
4470 ],
4471 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
4472 # parameters will be excluded. Either specify `includedQueryParameters`
4473 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
4474 # encoded and not treated as delimiters.
4475 &quot;A String&quot;,
4476 ],
4477 },
4478 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
4479 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
4480 &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
4481 # content. This is used to clamp the max-age (or Expires) value sent to the
4482 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
4483 # is used for the response max-age directive, along with a &quot;public&quot;
4484 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
4485 # clamps the max-age from the origin (if specified), or else sets the
4486 # response max-age directive to the lesser of the `clientTtl` and
4487 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
4488 # present. The maximum allowed value is 31,622,400s (1 year). If not
4489 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
4490 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
4491 # `USE_ORIGIN_HEADERS`.
4492 # as a count of seconds and fractions of seconds at nanosecond
4493 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4494 # or &quot;month&quot;. Range is approximately 10,000 years.
4495 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4496 # Durations less than one second are represented with a 0
4497 # `seconds` field and a positive `nanos` field. Must be from 0
4498 # to 999,999,999 inclusive.
4499 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4500 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4501 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4502 },
4503 &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
4504 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
4505 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
4506 # greater than that of `maxTtl`. When the `cacheMode` is set to
4507 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
4508 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
4509 # accessed objects may be evicted from the cache before the defined TTL. If
4510 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
4511 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
4512 # `USE_ORIGIN_HEADERS`.
4513 # as a count of seconds and fractions of seconds at nanosecond
4514 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4515 # or &quot;month&quot;. Range is approximately 10,000 years.
4516 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4517 # Durations less than one second are represented with a 0
4518 # `seconds` field and a positive `nanos` field. Must be from 0
4519 # to 999,999,999 inclusive.
4520 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4521 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4522 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4523 },
4524 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
4525 # attempt to set a max-age or s-maxage higher than this, or an Expires header
4526 # more than `maxTtl` seconds in the future will be capped at the value of
4527 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
4528 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
4529 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
4530 # Infrequently accessed objects may be evicted from the cache before the
4531 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
4532 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
4533 # mode.
4534 # as a count of seconds and fractions of seconds at nanosecond
4535 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4536 # or &quot;month&quot;. Range is approximately 10,000 years.
4537 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4538 # Durations less than one second are represented with a 0
4539 # `seconds` field and a positive `nanos` field. Must be from 0
4540 # to 999,999,999 inclusive.
4541 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4542 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4543 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4544 },
4545 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
4546 # to apply fine-grained caching for common errors or redirects.
4547 # This can reduce the load on your origin and improve end-user
4548 # experience by reducing response latency.
4549 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
4550 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
4551 # the specified response code that lack any Cache-Control, Expires, or
4552 # Pragma: no-cache directives. When the `cacheMode` is set to
4553 # `FORCE_CACHE_ALL`, negative caching applies to all responses
4554 # with the specified response code, and overrides any caching headers. By
4555 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
4556 #
4557 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
4558 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
4559 # * 405 (Method Not Found), 501 (Not Implemented): 60s
4560 #
4561 # These defaults can be overridden in `negativeCachingPolicy`.
4562 # If not specified, Cloud CDN applies negative caching by default.
4563 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
4564 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
4565 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
4566 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
4567 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
4568 # all response codes that you wish to cache. Cloud CDN will not apply any
4569 # default negative caching when a policy exists.
4570 { # Specify CDN TTLs for response error codes.
4571 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
4572 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
4573 # specified as values, and you cannot specify a status code more than
4574 # once.
4575 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
4576 # corresponding status code.
4577 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
4578 # objects may be evicted from the cache before the defined TTL.
4579 # as a count of seconds and fractions of seconds at nanosecond
4580 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4581 # or &quot;month&quot;. Range is approximately 10,000 years.
4582 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4583 # Durations less than one second are represented with a 0
4584 # `seconds` field and a positive `nanos` field. Must be from 0
4585 # to 999,999,999 inclusive.
4586 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4587 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4588 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4589 },
4590 },
4591 ],
4592 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
4593 # requests into a small number of requests to the origin. If not specified,
4594 # Cloud CDN applies request coalescing by default.
4595 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
4596 # content with the origin, or when an error is encountered when refreshing
4597 # the cache.
4598 # This setting defines the default &quot;max-stale&quot; duration for any cached
4599 # responses that do not specify a max-stale directive. Stale responses that
4600 # exceed the TTL configured here will not be served. The default limit
4601 # (max-stale) is 86400s (1 day), which will allow stale content to be
4602 # served up to this limit beyond the max-age (or s-maxage) of a cached
4603 # response.
4604 # The maximum allowed value is 604800 (1 week).
4605 # Set this to zero (0) to disable serve-while-stale.
4606 # as a count of seconds and fractions of seconds at nanosecond
4607 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4608 # or &quot;month&quot;. Range is approximately 10,000 years.
4609 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4610 # Durations less than one second are represented with a 0
4611 # `seconds` field and a positive `nanos` field. Must be from 0
4612 # to 999,999,999 inclusive.
4613 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4614 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4615 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4616 },
4617 },
4618 &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
4619 # information about the W3C recommendation for cross-origin resource sharing
4620 # (CORS), see Fetch API Living
4621 # Standard.
4622 #
4623 # Not supported when the URL map is bound to a target gRPC proxy.
4624 # information about the W3C recommendation for cross-origin resource sharing
4625 # (CORS), see Fetch API Living
4626 # Standard.
4627 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
4628 # indicates that
4629 # the actual request can include user credentials. This field translates to
4630 # the Access-Control-Allow-Credentials header.
4631 #
4632 # Default is false.
4633 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
4634 # header.
4635 &quot;A String&quot;,
4636 ],
4637 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
4638 # header.
4639 &quot;A String&quot;,
4640 ],
4641 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
4642 # more information, see regular expression syntax.
4643 #
4644 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
4645 #
4646 # Regular expressions can only be used when the loadBalancingScheme is
4647 # set to INTERNAL_SELF_MANAGED.
4648 &quot;A String&quot;,
4649 ],
4650 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
4651 #
4652 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
4653 &quot;A String&quot;,
4654 ],
4655 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
4656 # The default value is false, which indicates that the CORS
4657 # policy is in effect.
4658 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
4659 # header.
4660 &quot;A String&quot;,
4661 ],
4662 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
4663 # seconds. This field translates to the Access-Control-Max-Age
4664 # header.
4665 },
4666 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
4667 # the resiliency of clients to backend service failure. As part of fault
4668 # injection, when clients send requests to a backend service, delays can be
4669 # introduced by a load balancer on a percentage of requests before sending
4670 # those requests to the backend service. Similarly requests from clients can
4671 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
4672 # that are configured with a fault_injection_policy if:
4673 # 1. The traffic is generated by fault injection AND
4674 # 2. The fault injection is not a delay fault injection.
4675 # Fault injection is not supported with the classic Application Load Balancer
4676 # . To see which load balancers support fault injection,
4677 # see Load
4678 # balancing: Routing and traffic management features.
4679 # the resiliency of clients to backend service failure. As part of fault
4680 # injection, when clients send requests to a backend service, delays can be
4681 # introduced by the load balancer on a percentage of requests before sending
4682 # those request to the backend service. Similarly requests from clients can be
4683 # aborted by the load balancer for a percentage of requests.
4684 &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
4685 # injection.
4686 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
4687 #
4688 # The value must be from 200 to 599 inclusive.
4689 #
4690 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
4691 # according to this
4692 # mapping table. HTTP status 200 is mapped to gRPC status
4693 # UNKNOWN. Injecting an OK status is currently not supported by
4694 # Traffic Director.
4695 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
4696 # that is aborted as part of fault injection.
4697 #
4698 # The value must be from 0.0 to 100.0 inclusive.
4699 },
4700 &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
4701 # injection, before being sent to a backend service.
4702 # request to the backend service as part of fault injection.
4703 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
4704 # as a count of seconds and fractions of seconds at nanosecond
4705 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4706 # or &quot;month&quot;. Range is approximately 10,000 years.
4707 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4708 # Durations less than one second are represented with a 0
4709 # `seconds` field and a positive `nanos` field. Must be from 0
4710 # to 999,999,999 inclusive.
4711 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4712 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4713 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4714 },
4715 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
4716 # which a delay is introduced as part of fault injection.
4717 #
4718 # The value must be from 0.0 to 100.0 inclusive.
4719 },
4720 },
4721 &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
4722 # Global EXTERNAL_MANAGED load balancer schemes.
4723 # Either Cloud CDN must be enabled on the backend service or backend bucket
4724 # serving the route, or cache policy must be configured on the same route
4725 # dynamically processes and delivers images from the network edge.
4726 # Image Optimization is only available for Global External Application Load
4727 # Balancers.
4728 # Either Cloud CDN must be enabled on the backend service or backend bucket
4729 # serving the route, or cache policy must be configured on the same route.
4730 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
4731 },
4732 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
4733 # Unlike the timeout field where the timeout duration starts
4734 # from the time the request has been fully processed (known as*end-of-stream*),
4735 # the duration in this field is computed from the beginning of the stream
4736 # until the response has been processed, including all retries. A
4737 # stream that does not complete in this duration is closed.
4738 #
4739 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
4740 # with the route.
4741 #
4742 # This field is only allowed if the Url map is used with backend services
4743 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
4744 # as a count of seconds and fractions of seconds at nanosecond
4745 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4746 # or &quot;month&quot;. Range is approximately 10,000 years.
4747 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4748 # Durations less than one second are represented with a 0
4749 # `seconds` field and a positive `nanos` field. Must be from 0
4750 # to 999,999,999 inclusive.
4751 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4752 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4753 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4754 },
4755 &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
4756 # are shadowed to a separate mirrored backend service. The load balancer does
4757 # not wait for responses from the shadow service. Before sending traffic
4758 # to the shadow service, the host / authority header is suffixed with-shadow.
4759 #
4760 # Not supported when the URL map is bound to a target gRPC proxy that
4761 # has the validateForProxyless field set to true.
4762 # are shadowed to a separate mirrored backend service. The load balancer
4763 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
4764 # to the shadow service, the host or authority header is suffixed with-shadow.
4765 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
4766 # mirrored to.
4767 #
4768 # The backend service configured for a mirroring
4769 # policy must reference backends that are of the same type as the original
4770 # backend service matched in the URL map.
4771 #
4772 # Serverless NEG backends are not currently supported as a mirrored
4773 # backend service.
4774 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
4775 },
4776 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
4777 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
4778 # If not specified, defaults to 1.
4779 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
4780 #
4781 # If not specified, will use the timeout set in theHttpRouteAction field.
4782 # If timeout in the HttpRouteAction field is not set, this field
4783 # uses the largest timeout
4784 # among all backend services associated with the route.
4785 #
4786 # Not supported when the URL map is bound to a target gRPC proxy that
4787 # has the validateForProxyless field set to true.
4788 # as a count of seconds and fractions of seconds at nanosecond
4789 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4790 # or &quot;month&quot;. Range is approximately 10,000 years.
4791 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4792 # Durations less than one second are represented with a 0
4793 # `seconds` field and a positive `nanos` field. Must be from 0
4794 # to 999,999,999 inclusive.
4795 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4796 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4797 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4798 },
4799 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
4800 # values are:
4801 #
4802 # - 5xx: retry is attempted if the instance or endpoint
4803 # responds with any 5xx response code, or if the instance or
4804 # endpoint does not respond at all. For example, disconnects, reset, read
4805 # timeout, connection failure, and refused streams.
4806 # - gateway-error: Similar to 5xx, but only
4807 # applies to response codes 502, 503 or504.
4808 # - connect-failure: a retry is attempted on failures
4809 # connecting to the instance or endpoint. For example, connection
4810 # timeouts.
4811 # - retriable-4xx: a retry is attempted if the instance
4812 # or endpoint responds with a 4xx response code.
4813 # The only error that you can retry is error code 409.
4814 # - refused-stream: a retry is attempted if the instance
4815 # or endpoint resets the stream with a REFUSED_STREAM error
4816 # code. This reset type indicates that it is safe to retry.
4817 # - cancelled: a retry is attempted if the gRPC status
4818 # code in the response header is set to cancelled.
4819 # - deadline-exceeded: a retry is attempted if the gRPC
4820 # status code in the response header is set todeadline-exceeded.
4821 # - internal: a retry is attempted if the gRPC
4822 # status code in the response header is set tointernal.
4823 # - resource-exhausted: a retry is attempted if the gRPC
4824 # status code in the response header is set toresource-exhausted.
4825 # - unavailable: a retry is attempted if the gRPC
4826 # status code in the response header is set tounavailable.
4827 #
4828 # Only the following codes are supported when the URL map is bound to
4829 # target gRPC proxy that has validateForProxyless field set to true.
4830 #
4831 # - cancelled
4832 # - deadline-exceeded
4833 # - internal
4834 # - resource-exhausted
4835 # - unavailable
4836 &quot;A String&quot;,
4837 ],
4838 },
4839 &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
4840 # time the request has been fully processed (known as *end-of-stream*)
4841 # up until the response has been processed. Timeout includes
4842 # all retries.
4843 #
4844 # If not specified, this field uses the largest timeout among all backend
4845 # services associated with the route.
4846 #
4847 # Not supported when the URL map is bound to a target gRPC proxy that
4848 # has validateForProxyless field set to true.
4849 # as a count of seconds and fractions of seconds at nanosecond
4850 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4851 # or &quot;month&quot;. Range is approximately 10,000 years.
4852 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4853 # Durations less than one second are represented with a 0
4854 # `seconds` field and a positive `nanos` field. Must be from 0
4855 # to 999,999,999 inclusive.
4856 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4857 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4858 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4859 },
4860 &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
4861 # to the matched service.
4862 #
4863 # urlRewrite is the only action supported in UrlMaps
4864 # for classic Application Load Balancers.
4865 #
4866 # Not supported when the URL map is bound to a target gRPC proxy that
4867 # has the validateForProxyless field set to true.
4868 # backend service.
4869 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
4870 # host header is replaced with contents of hostRewrite.
4871 #
4872 # The value must be from 1 to 255 characters.
4873 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
4874 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
4875 #
4876 # The value must be from 1 to 1024 characters.
4877 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
4878 # header) using the HTTP template syntax.
4879 #
4880 # A corresponding
4881 # path_template_match must be specified. Any template variables must exist in
4882 # the path_template_match field.
4883 #
4884 #
4885 # - -At least one variable must be specified in the path_template_match
4886 # field
4887 # - You can omit variables from the rewritten URL
4888 # - The * and ** operators cannot be matched
4889 # unless they have a corresponding variable name - e.g.
4890 # {format=*} or {var=**}.
4891 #
4892 # For example, a path_template_match of /static/{format=**}
4893 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
4894 # rewrite, so that /{country}/{format}/{suffix=**} can be
4895 # rewritten as /content/{format}/{country}/{suffix}.
4896 #
4897 # At least
4898 # one non-empty routeRules[].matchRules[].path_template_match is
4899 # required.
4900 #
4901 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
4902 },
4903 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
4904 # occurs. The weights determine the fraction of traffic that flows to
4905 # their corresponding backend service. If all traffic needs to
4906 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
4907 #
4908 # After a backend service is identified and before forwarding
4909 # the request to
4910 # the backend service, advanced routing actions such as URL rewrites and
4911 # header transformations are applied depending on additional settings
4912 # specified in this HttpRouteAction.
4913 { # In contrast to a single BackendService in
4914 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
4915 # multiple backend services. The volume of traffic for each
4916 # backend service is proportional to the weight specified
4917 # in each WeightedBackendService
4918 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
4919 # resource. Before
4920 # forwarding the request to backendService, the load balancer
4921 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
4922 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
4923 # effect for the selected backendService.
4924 #
4925 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
4926 #
4927 # headerAction is not supported for load balancers that have
4928 # their loadBalancingScheme set to EXTERNAL.
4929 #
4930 # Not supported when the URL map is bound to a target gRPC proxy that
4931 # has validateForProxyless field set to true.
4932 # the request is passed along to the selected backendService.
4933 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
4934 { # Specification determining how headers are added to requests or responses.
4935 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
4936 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
4937 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
4938 # that already
4939 # exist for the header. If true, headerValue is set for the
4940 # header, discarding any values that were set for that header.
4941 #
4942 # The default value is true,
4943 # unless a variable is present in headerValue,
4944 # in which case the default value is false.
4945 # .
4946 },
4947 ],
4948 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
4949 # request before forwarding the request to the backendService.
4950 &quot;A String&quot;,
4951 ],
4952 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
4953 # client.
4954 { # Specification determining how headers are added to requests or responses.
4955 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
4956 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
4957 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
4958 # that already
4959 # exist for the header. If true, headerValue is set for the
4960 # header, discarding any values that were set for that header.
4961 #
4962 # The default value is true,
4963 # unless a variable is present in headerValue,
4964 # in which case the default value is false.
4965 # .
4966 },
4967 ],
4968 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
4969 # response before sending the response back to the client.
4970 &quot;A String&quot;,
4971 ],
4972 },
4973 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
4974 # computed asweight / (sum of all weightedBackendService weights in routeAction).
4975 #
4976 # The selection of a backend service is determined only for new traffic.
4977 # Once a user&#x27;s request has been directed to a backend service,
4978 # subsequent requests are sent to the same backend service as
4979 # determined by the backend service&#x27;s session affinity policy.
4980 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
4981 # splitting. If you do, the weighted traffic splitting configuration takes
4982 # precedence.
4983 #
4984 # The value must be from 0 to 1000.
4985 },
4986 ],
4987 },
4988 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL of the defaultService resource to
4989 # which traffic is directed if none of the hostRules match.
4990 # If defaultRouteAction is also specified, advanced
4991 # routing actions, such as URL rewrites, take effect before sending the
4992 # request to the backend.
4993 #
4994 #
4995 # Only one of defaultUrlRedirect, defaultService
4996 # or defaultRouteAction.weightedBackendService can be set.
4997 #
4998 #
4999 # defaultService has no effect when the URL map is bound
5000 # to a target gRPC proxy that has the validateForProxyless field
5001 # set to true.
5002 &quot;defaultUrlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
5003 # is redirected to a URL specified by defaultUrlRedirect.
5004 #
5005 #
5006 # Only one of defaultUrlRedirect, defaultService
5007 # or defaultRouteAction.weightedBackendService can be set.
5008 #
5009 #
5010 # Not supported when the URL map is bound to a target gRPC proxy.
5011 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
5012 # was supplied in the request.
5013 #
5014 # The value must be from 1 to 255
5015 # characters.
5016 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
5017 # set to HTTPS.
5018 # If set to false, the URL scheme of the redirected request
5019 # remains the same as that of the request.
5020 #
5021 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
5022 #
5023 # The default is set to false.
5024 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
5025 # that was supplied in the request.
5026 #
5027 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
5028 # supplied, the path of the original request is used for the redirect.
5029 #
5030 # The value must be from 1 to 1024 characters.
5031 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
5032 # the HttpRouteRuleMatch, retaining the remaining portion
5033 # of the URL before redirecting the request.
5034 #
5035 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
5036 # supplied, the path of the original request is used for the redirect.
5037 #
5038 # The value must be from 1 to 1024 characters.
5039 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
5040 #
5041 # Supported values are:
5042 #
5043 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
5044 # to 301.
5045 # - FOUND, which corresponds to 302.
5046 # - SEE_OTHER which corresponds to 303.
5047 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
5048 # method is retained.
5049 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
5050 # method is retained.
5051 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
5052 # URL is
5053 # removed before redirecting the request. If set to false, the
5054 # query portion of the original URL is retained.
5055 #
5056 # The default is set to false.
5057 },
5058 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
5059 # create the resource.
5060 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. A hash of the contents stored in this object.
5061 # This field is used in optimistic locking. This field is ignored when
5062 # inserting a UrlMap. An up-to-date fingerprint must be provided
5063 # in order to update the UrlMap, otherwise the request will
5064 # fail with error 412 conditionNotMet.
5065 #
5066 # To see the latest fingerprint, make a get() request to
5067 # retrieve a UrlMap.
5068 &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
5069 # for the selected backendService.
5070 #
5071 # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
5072 #
5073 # headerAction is not supported for load balancers
5074 # 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;hostRules&quot;: [ # The list of host rules to use against the URL.
5121 { # UrlMaps
5122 # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
5123 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
5124 # create the resource.
5125 &quot;hosts&quot;: [ # The list of host patterns to match. They must be valid hostnames with
5126 # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
5127 # that case, * must be the first character, and if followed by
5128 # anything, the immediate following character must be either -
5129 # or ..
5130 #
5131 # * based matching is not supported when the URL map is bound
5132 # to a target gRPC proxy that has the validateForProxyless field
5133 # set to true.
5134 &quot;A String&quot;,
5135 ],
5136 &quot;pathMatcher&quot;: &quot;A String&quot;, # The name of the PathMatcher to use to match the path portion
5137 # of the URL if the hostRule matches the URL&#x27;s host portion.
5138 },
5139 ],
5140 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the resource. This identifier is
5141 # defined by the server.
5142 &quot;kind&quot;: &quot;compute#urlMap&quot;, # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
5143 # url maps.
5144 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
5145 # The name must be 1-63 characters long, and comply withRFC1035.
5146 # Specifically, the name must be 1-63 characters long and match the regular
5147 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
5148 # character must be a lowercase letter, and all following characters must
5149 # be a dash, lowercase letter, or digit, except the last character, which
5150 # cannot be a dash.
5151 &quot;pathMatchers&quot;: [ # The list of named PathMatchers to use against the URL.
5152 { # A matcher for the path portion of the URL. The BackendService
5153 # from the longest-matched rule will serve the URL. If no rule was matched, the
5154 # default service is used.
5155 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
5156 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
5157 #
5158 # This policy takes
5159 # effect at the PathMatcher level and applies only when no
5160 # 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
5161 # in defaultCustomErrorResponsePolicy, then a policy defined for
5162 # the error code in UrlMap.defaultCustomErrorResponsePolicy
5163 # takes effect.
5164 #
5165 # For example, consider a UrlMap with the following
5166 # configuration:
5167 #
5168 #
5169 # - UrlMap.defaultCustomErrorResponsePolicy is configured
5170 # with policies for 5xx and 4xx errors
5171 # - A RouteRule for /coming_soon/ is configured for the
5172 # error code 404.
5173 #
5174 # 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
5175 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
5176 # the policy in RouteRule.customErrorResponsePolicy takes
5177 # effect. If any of the requests in this example encounter a 500
5178 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
5179 #
5180 # When
5181 # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
5182 # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
5183 # a retry, if load balancer is successful in reaching the
5184 # service, the defaultCustomErrorResponsePolicy is ignored and
5185 # the response from the service is returned to the client.
5186 #
5187 # defaultCustomErrorResponsePolicy is supported only for
5188 # global external Application Load Balancers.
5189 # backend service or backend bucket responds with an error.
5190 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
5191 #
5192 # In a given policy, if you specify rules for both a range of error codes
5193 # as well as rules for specific error codes then rules with specific error
5194 # codes have a higher priority. For example, assume that you configure a rule
5195 # for 401 (Un-authorized) code, and another for all 4 series
5196 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
5197 # However if the backend service returns a 403, the rule for4xx takes effect.
5198 { # Specifies the mapping between the response code that will be returned along
5199 # with the custom error content and the response code returned by the backend
5200 # service.
5201 &quot;matchResponseCodes&quot;: [ # Valid values include:
5202 #
5203 #
5204 # - A number between 400 and 599: For example
5205 # 401 or 503, in which case the load balancer
5206 # applies the policy if the error code exactly matches this value.
5207 # - 5xx: Load Balancer will apply the policy if the
5208 # backend service responds with any response code in the range of
5209 # 500 to 599.
5210 # - 4xx: Load
5211 # Balancer will apply the policy if the backend service responds with any
5212 # response code in the range of 400 to
5213 # 499.
5214 #
5215 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
5216 &quot;A String&quot;,
5217 ],
5218 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
5219 # error content. If overrideResponseCode is not supplied, the
5220 # same response code returned by the original backend bucket or backend
5221 # service is returned to the client.
5222 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
5223 #
5224 # path must start
5225 # with a leading slash. path cannot have trailing slashes.
5226 #
5227 # If the file is not available in backendBucket or the
5228 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
5229 #
5230 # The value must
5231 # be from 1 to 1024 characters
5232 },
5233 ],
5234 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
5235 # contains the custom error content. Examples are:
5236 #
5237 #
5238 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
5239 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
5240 # - global/backendBuckets/myBackendBucket
5241 #
5242 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
5243 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
5244 #
5245 # If load balancer cannot reach
5246 # the backendBucket, a simple Not Found Error will
5247 # be returned, with the original response code (oroverrideResponseCode if configured).
5248 #
5249 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
5250 },
5251 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
5252 # pathRules or routeRules match. The load balancer
5253 # performs advanced routing actions, such as URL rewrites and
5254 # header transformations, before forwarding the request to the
5255 # selected backend.
5256 #
5257 #
5258 # Only one of defaultUrlRedirect, defaultService
5259 # or defaultRouteAction.weightedBackendService can be set.
5260 #
5261 #
5262 # URL maps for classic Application Load Balancers only support
5263 # the urlRewrite action within a path matcher&#x27;sdefaultRouteAction.
5264 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
5265 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
5266 # property must be specified. This policy cannot be specified if any target
5267 # backend has Identity-Aware Proxy enabled.
5268 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
5269 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
5270 # header names can be specified. The cache is bypassed for all `cacheMode`
5271 # values.
5272 &quot;A String&quot;,
5273 ],
5274 &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
5275 # on the backend type: for Backend Services, the complete request URI is
5276 # used; for Backend Buckets, the request URI is used without the protocol or
5277 # host, and only query parameters known to Cloud Storage are included.
5278 # Policy defined on Route Action.
5279 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
5280 # parameters will be included. Either specify `excludedQueryParameters`
5281 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
5282 # encoded and not treated as delimiters.
5283 #
5284 # Note: This field applies to routes that use backend services. Attempting
5285 # to set it on a route that points exclusively to Backend Buckets will
5286 # result in a configuration error. For routes that point to a Backend
5287 # Bucket, use `includedQueryParameters` to define which parameters should
5288 # be part of the cache key.
5289 &quot;A String&quot;,
5290 ],
5291 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
5292 #
5293 # Note: This setting is only applicable to routes that use a Backend
5294 # Service. It does not affect requests served by a Backend Bucket, as the
5295 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
5296 # it on a route that points exclusively to Backend Buckets will result in a
5297 # configuration error.
5298 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
5299 #
5300 # Note: This setting is only applicable to routes that use a Backend
5301 # Service. It does not affect requests served by a Backend Bucket, as the
5302 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
5303 # set on a route that points exclusively to Backend Buckets will result in
5304 # a configuration error.
5305 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
5306 # `includedQueryParameters` and `excludedQueryParameters`. If neither
5307 # is set, the entire query string will be included. If false, the query
5308 # string will be excluded from the cache key entirely.
5309 #
5310 # Note: This field applies to routes that use backend services. Attempting
5311 # to set it on a route that points exclusively to Backend Buckets will
5312 # result in a configuration error. For routes that point to a Backend
5313 # Bucket, use `includedQueryParameters` to define which parameters should
5314 # be part of the cache key.
5315 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
5316 # The name=value pair will be used in the cache key Cloud CDN generates.
5317 #
5318 # Note: This setting is only applicable to routes that use a Backend
5319 # Service. It does not affect requests served by a Backend Bucket.
5320 # Attempting to set it on a route that points exclusively to Backend
5321 # Buckets will result in a configuration error. Up to 5 cookie names can be
5322 # specified.
5323 &quot;A String&quot;,
5324 ],
5325 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
5326 &quot;A String&quot;,
5327 ],
5328 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
5329 # parameters will be excluded. Either specify `includedQueryParameters`
5330 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
5331 # encoded and not treated as delimiters.
5332 &quot;A String&quot;,
5333 ],
5334 },
5335 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
5336 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
5337 &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
5338 # content. This is used to clamp the max-age (or Expires) value sent to the
5339 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
5340 # is used for the response max-age directive, along with a &quot;public&quot;
5341 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
5342 # clamps the max-age from the origin (if specified), or else sets the
5343 # response max-age directive to the lesser of the `clientTtl` and
5344 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
5345 # present. The maximum allowed value is 31,622,400s (1 year). If not
5346 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
5347 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
5348 # `USE_ORIGIN_HEADERS`.
5349 # as a count of seconds and fractions of seconds at nanosecond
5350 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5351 # or &quot;month&quot;. Range is approximately 10,000 years.
5352 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5353 # Durations less than one second are represented with a 0
5354 # `seconds` field and a positive `nanos` field. Must be from 0
5355 # to 999,999,999 inclusive.
5356 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5357 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5358 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5359 },
5360 &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
5361 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
5362 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
5363 # greater than that of `maxTtl`. When the `cacheMode` is set to
5364 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
5365 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
5366 # accessed objects may be evicted from the cache before the defined TTL. If
5367 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
5368 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
5369 # `USE_ORIGIN_HEADERS`.
5370 # as a count of seconds and fractions of seconds at nanosecond
5371 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5372 # or &quot;month&quot;. Range is approximately 10,000 years.
5373 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5374 # Durations less than one second are represented with a 0
5375 # `seconds` field and a positive `nanos` field. Must be from 0
5376 # to 999,999,999 inclusive.
5377 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5378 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5379 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5380 },
5381 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
5382 # attempt to set a max-age or s-maxage higher than this, or an Expires header
5383 # more than `maxTtl` seconds in the future will be capped at the value of
5384 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
5385 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
5386 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
5387 # Infrequently accessed objects may be evicted from the cache before the
5388 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
5389 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
5390 # mode.
5391 # as a count of seconds and fractions of seconds at nanosecond
5392 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5393 # or &quot;month&quot;. Range is approximately 10,000 years.
5394 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5395 # Durations less than one second are represented with a 0
5396 # `seconds` field and a positive `nanos` field. Must be from 0
5397 # to 999,999,999 inclusive.
5398 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5399 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5400 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5401 },
5402 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
5403 # to apply fine-grained caching for common errors or redirects.
5404 # This can reduce the load on your origin and improve end-user
5405 # experience by reducing response latency.
5406 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
5407 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
5408 # the specified response code that lack any Cache-Control, Expires, or
5409 # Pragma: no-cache directives. When the `cacheMode` is set to
5410 # `FORCE_CACHE_ALL`, negative caching applies to all responses
5411 # with the specified response code, and overrides any caching headers. By
5412 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
5413 #
5414 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
5415 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
5416 # * 405 (Method Not Found), 501 (Not Implemented): 60s
5417 #
5418 # These defaults can be overridden in `negativeCachingPolicy`.
5419 # If not specified, Cloud CDN applies negative caching by default.
5420 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
5421 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
5422 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
5423 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
5424 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
5425 # all response codes that you wish to cache. Cloud CDN will not apply any
5426 # default negative caching when a policy exists.
5427 { # Specify CDN TTLs for response error codes.
5428 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
5429 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
5430 # specified as values, and you cannot specify a status code more than
5431 # once.
5432 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
5433 # corresponding status code.
5434 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
5435 # objects may be evicted from the cache before the defined TTL.
5436 # as a count of seconds and fractions of seconds at nanosecond
5437 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5438 # or &quot;month&quot;. Range is approximately 10,000 years.
5439 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5440 # Durations less than one second are represented with a 0
5441 # `seconds` field and a positive `nanos` field. Must be from 0
5442 # to 999,999,999 inclusive.
5443 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5444 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5445 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5446 },
5447 },
5448 ],
5449 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
5450 # requests into a small number of requests to the origin. If not specified,
5451 # Cloud CDN applies request coalescing by default.
5452 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
5453 # content with the origin, or when an error is encountered when refreshing
5454 # the cache.
5455 # This setting defines the default &quot;max-stale&quot; duration for any cached
5456 # responses that do not specify a max-stale directive. Stale responses that
5457 # exceed the TTL configured here will not be served. The default limit
5458 # (max-stale) is 86400s (1 day), which will allow stale content to be
5459 # served up to this limit beyond the max-age (or s-maxage) of a cached
5460 # response.
5461 # The maximum allowed value is 604800 (1 week).
5462 # Set this to zero (0) to disable serve-while-stale.
5463 # as a count of seconds and fractions of seconds at nanosecond
5464 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5465 # or &quot;month&quot;. Range is approximately 10,000 years.
5466 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5467 # Durations less than one second are represented with a 0
5468 # `seconds` field and a positive `nanos` field. Must be from 0
5469 # to 999,999,999 inclusive.
5470 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5471 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5472 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5473 },
5474 },
5475 &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
5476 # information about the W3C recommendation for cross-origin resource sharing
5477 # (CORS), see Fetch API Living
5478 # Standard.
5479 #
5480 # Not supported when the URL map is bound to a target gRPC proxy.
5481 # information about the W3C recommendation for cross-origin resource sharing
5482 # (CORS), see Fetch API Living
5483 # Standard.
5484 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
5485 # indicates that
5486 # the actual request can include user credentials. This field translates to
5487 # the Access-Control-Allow-Credentials header.
5488 #
5489 # Default is false.
5490 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
5491 # header.
5492 &quot;A String&quot;,
5493 ],
5494 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
5495 # header.
5496 &quot;A String&quot;,
5497 ],
5498 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
5499 # more information, see regular expression syntax.
5500 #
5501 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
5502 #
5503 # Regular expressions can only be used when the loadBalancingScheme is
5504 # set to INTERNAL_SELF_MANAGED.
5505 &quot;A String&quot;,
5506 ],
5507 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
5508 #
5509 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
5510 &quot;A String&quot;,
5511 ],
5512 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
5513 # The default value is false, which indicates that the CORS
5514 # policy is in effect.
5515 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
5516 # header.
5517 &quot;A String&quot;,
5518 ],
5519 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
5520 # seconds. This field translates to the Access-Control-Max-Age
5521 # header.
5522 },
5523 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
5524 # the resiliency of clients to backend service failure. As part of fault
5525 # injection, when clients send requests to a backend service, delays can be
5526 # introduced by a load balancer on a percentage of requests before sending
5527 # those requests to the backend service. Similarly requests from clients can
5528 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
5529 # that are configured with a fault_injection_policy if:
5530 # 1. The traffic is generated by fault injection AND
5531 # 2. The fault injection is not a delay fault injection.
5532 # Fault injection is not supported with the classic Application Load Balancer
5533 # . To see which load balancers support fault injection,
5534 # see Load
5535 # balancing: Routing and traffic management features.
5536 # the resiliency of clients to backend service failure. As part of fault
5537 # injection, when clients send requests to a backend service, delays can be
5538 # introduced by the load balancer on a percentage of requests before sending
5539 # those request to the backend service. Similarly requests from clients can be
5540 # aborted by the load balancer for a percentage of requests.
5541 &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
5542 # injection.
5543 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
5544 #
5545 # The value must be from 200 to 599 inclusive.
5546 #
5547 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
5548 # according to this
5549 # mapping table. HTTP status 200 is mapped to gRPC status
5550 # UNKNOWN. Injecting an OK status is currently not supported by
5551 # Traffic Director.
5552 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
5553 # that is aborted as part of fault injection.
5554 #
5555 # The value must be from 0.0 to 100.0 inclusive.
5556 },
5557 &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
5558 # injection, before being sent to a backend service.
5559 # request to the backend service as part of fault injection.
5560 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
5561 # as a count of seconds and fractions of seconds at nanosecond
5562 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5563 # or &quot;month&quot;. Range is approximately 10,000 years.
5564 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5565 # Durations less than one second are represented with a 0
5566 # `seconds` field and a positive `nanos` field. Must be from 0
5567 # to 999,999,999 inclusive.
5568 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5569 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5570 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5571 },
5572 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
5573 # which a delay is introduced as part of fault injection.
5574 #
5575 # The value must be from 0.0 to 100.0 inclusive.
5576 },
5577 },
5578 &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
5579 # Global EXTERNAL_MANAGED load balancer schemes.
5580 # Either Cloud CDN must be enabled on the backend service or backend bucket
5581 # serving the route, or cache policy must be configured on the same route
5582 # dynamically processes and delivers images from the network edge.
5583 # Image Optimization is only available for Global External Application Load
5584 # Balancers.
5585 # Either Cloud CDN must be enabled on the backend service or backend bucket
5586 # serving the route, or cache policy must be configured on the same route.
5587 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
5588 },
5589 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
5590 # Unlike the timeout field where the timeout duration starts
5591 # from the time the request has been fully processed (known as*end-of-stream*),
5592 # the duration in this field is computed from the beginning of the stream
5593 # until the response has been processed, including all retries. A
5594 # stream that does not complete in this duration is closed.
5595 #
5596 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
5597 # with the route.
5598 #
5599 # This field is only allowed if the Url map is used with backend services
5600 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
5601 # as a count of seconds and fractions of seconds at nanosecond
5602 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5603 # or &quot;month&quot;. Range is approximately 10,000 years.
5604 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5605 # Durations less than one second are represented with a 0
5606 # `seconds` field and a positive `nanos` field. Must be from 0
5607 # to 999,999,999 inclusive.
5608 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5609 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5610 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5611 },
5612 &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
5613 # are shadowed to a separate mirrored backend service. The load balancer does
5614 # not wait for responses from the shadow service. Before sending traffic
5615 # to the shadow service, the host / authority header is suffixed with-shadow.
5616 #
5617 # Not supported when the URL map is bound to a target gRPC proxy that
5618 # has the validateForProxyless field set to true.
5619 # are shadowed to a separate mirrored backend service. The load balancer
5620 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
5621 # to the shadow service, the host or authority header is suffixed with-shadow.
5622 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
5623 # mirrored to.
5624 #
5625 # The backend service configured for a mirroring
5626 # policy must reference backends that are of the same type as the original
5627 # backend service matched in the URL map.
5628 #
5629 # Serverless NEG backends are not currently supported as a mirrored
5630 # backend service.
5631 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
5632 },
5633 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
5634 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
5635 # If not specified, defaults to 1.
5636 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
5637 #
5638 # If not specified, will use the timeout set in theHttpRouteAction field.
5639 # If timeout in the HttpRouteAction field is not set, this field
5640 # uses the largest timeout
5641 # among all backend services associated with the route.
5642 #
5643 # Not supported when the URL map is bound to a target gRPC proxy that
5644 # has the validateForProxyless field set to true.
5645 # as a count of seconds and fractions of seconds at nanosecond
5646 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5647 # or &quot;month&quot;. Range is approximately 10,000 years.
5648 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5649 # Durations less than one second are represented with a 0
5650 # `seconds` field and a positive `nanos` field. Must be from 0
5651 # to 999,999,999 inclusive.
5652 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5653 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5654 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5655 },
5656 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
5657 # values are:
5658 #
5659 # - 5xx: retry is attempted if the instance or endpoint
5660 # responds with any 5xx response code, or if the instance or
5661 # endpoint does not respond at all. For example, disconnects, reset, read
5662 # timeout, connection failure, and refused streams.
5663 # - gateway-error: Similar to 5xx, but only
5664 # applies to response codes 502, 503 or504.
5665 # - connect-failure: a retry is attempted on failures
5666 # connecting to the instance or endpoint. For example, connection
5667 # timeouts.
5668 # - retriable-4xx: a retry is attempted if the instance
5669 # or endpoint responds with a 4xx response code.
5670 # The only error that you can retry is error code 409.
5671 # - refused-stream: a retry is attempted if the instance
5672 # or endpoint resets the stream with a REFUSED_STREAM error
5673 # code. This reset type indicates that it is safe to retry.
5674 # - cancelled: a retry is attempted if the gRPC status
5675 # code in the response header is set to cancelled.
5676 # - deadline-exceeded: a retry is attempted if the gRPC
5677 # status code in the response header is set todeadline-exceeded.
5678 # - internal: a retry is attempted if the gRPC
5679 # status code in the response header is set tointernal.
5680 # - resource-exhausted: a retry is attempted if the gRPC
5681 # status code in the response header is set toresource-exhausted.
5682 # - unavailable: a retry is attempted if the gRPC
5683 # status code in the response header is set tounavailable.
5684 #
5685 # Only the following codes are supported when the URL map is bound to
5686 # target gRPC proxy that has validateForProxyless field set to true.
5687 #
5688 # - cancelled
5689 # - deadline-exceeded
5690 # - internal
5691 # - resource-exhausted
5692 # - unavailable
5693 &quot;A String&quot;,
5694 ],
5695 },
5696 &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
5697 # time the request has been fully processed (known as *end-of-stream*)
5698 # up until the response has been processed. Timeout includes
5699 # all retries.
5700 #
5701 # If not specified, this field uses the largest timeout among all backend
5702 # services associated with the route.
5703 #
5704 # Not supported when the URL map is bound to a target gRPC proxy that
5705 # has validateForProxyless field set to true.
5706 # as a count of seconds and fractions of seconds at nanosecond
5707 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5708 # or &quot;month&quot;. Range is approximately 10,000 years.
5709 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5710 # Durations less than one second are represented with a 0
5711 # `seconds` field and a positive `nanos` field. Must be from 0
5712 # to 999,999,999 inclusive.
5713 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5714 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5715 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5716 },
5717 &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
5718 # to the matched service.
5719 #
5720 # urlRewrite is the only action supported in UrlMaps
5721 # for classic Application Load Balancers.
5722 #
5723 # Not supported when the URL map is bound to a target gRPC proxy that
5724 # has the validateForProxyless field set to true.
5725 # backend service.
5726 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
5727 # host header is replaced with contents of hostRewrite.
5728 #
5729 # The value must be from 1 to 255 characters.
5730 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
5731 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
5732 #
5733 # The value must be from 1 to 1024 characters.
5734 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
5735 # header) using the HTTP template syntax.
5736 #
5737 # A corresponding
5738 # path_template_match must be specified. Any template variables must exist in
5739 # the path_template_match field.
5740 #
5741 #
5742 # - -At least one variable must be specified in the path_template_match
5743 # field
5744 # - You can omit variables from the rewritten URL
5745 # - The * and ** operators cannot be matched
5746 # unless they have a corresponding variable name - e.g.
5747 # {format=*} or {var=**}.
5748 #
5749 # For example, a path_template_match of /static/{format=**}
5750 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
5751 # rewrite, so that /{country}/{format}/{suffix=**} can be
5752 # rewritten as /content/{format}/{country}/{suffix}.
5753 #
5754 # At least
5755 # one non-empty routeRules[].matchRules[].path_template_match is
5756 # required.
5757 #
5758 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
5759 },
5760 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
5761 # occurs. The weights determine the fraction of traffic that flows to
5762 # their corresponding backend service. If all traffic needs to
5763 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
5764 #
5765 # After a backend service is identified and before forwarding
5766 # the request to
5767 # the backend service, advanced routing actions such as URL rewrites and
5768 # header transformations are applied depending on additional settings
5769 # specified in this HttpRouteAction.
5770 { # In contrast to a single BackendService in
5771 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
5772 # multiple backend services. The volume of traffic for each
5773 # backend service is proportional to the weight specified
5774 # in each WeightedBackendService
5775 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
5776 # resource. Before
5777 # forwarding the request to backendService, the load balancer
5778 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
5779 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
5780 # effect for the selected backendService.
5781 #
5782 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
5783 #
5784 # headerAction is not supported for load balancers that have
5785 # their loadBalancingScheme set to EXTERNAL.
5786 #
5787 # Not supported when the URL map is bound to a target gRPC proxy that
5788 # has validateForProxyless field set to true.
5789 # the request is passed along to the selected backendService.
5790 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
5791 { # Specification determining how headers are added to requests or responses.
5792 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
5793 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
5794 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
5795 # that already
5796 # exist for the header. If true, headerValue is set for the
5797 # header, discarding any values that were set for that header.
5798 #
5799 # The default value is true,
5800 # unless a variable is present in headerValue,
5801 # in which case the default value is false.
5802 # .
5803 },
5804 ],
5805 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
5806 # request before forwarding the request to the backendService.
5807 &quot;A String&quot;,
5808 ],
5809 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
5810 # client.
5811 { # Specification determining how headers are added to requests or responses.
5812 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
5813 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
5814 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
5815 # that already
5816 # exist for the header. If true, headerValue is set for the
5817 # header, discarding any values that were set for that header.
5818 #
5819 # The default value is true,
5820 # unless a variable is present in headerValue,
5821 # in which case the default value is false.
5822 # .
5823 },
5824 ],
5825 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
5826 # response before sending the response back to the client.
5827 &quot;A String&quot;,
5828 ],
5829 },
5830 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
5831 # computed asweight / (sum of all weightedBackendService weights in routeAction).
5832 #
5833 # The selection of a backend service is determined only for new traffic.
5834 # Once a user&#x27;s request has been directed to a backend service,
5835 # subsequent requests are sent to the same backend service as
5836 # determined by the backend service&#x27;s session affinity policy.
5837 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
5838 # splitting. If you do, the weighted traffic splitting configuration takes
5839 # precedence.
5840 #
5841 # The value must be from 0 to 1000.
5842 },
5843 ],
5844 },
5845 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource. This
5846 # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
5847 # matched. For example, the
5848 # following are all valid URLs to a BackendService resource:
5849 #
5850 #
5851 # - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
5852 # - compute/v1/projects/project/global/backendServices/backendService
5853 # - global/backendServices/backendService
5854 #
5855 #
5856 # If defaultRouteAction is also specified, advanced
5857 # routing actions, such as URL rewrites, take effect before sending the
5858 # request to the backend.
5859 #
5860 #
5861 # Only one of defaultUrlRedirect, defaultService
5862 # or defaultRouteAction.weightedBackendService can be set.
5863 #
5864 #
5865 # Authorization requires one or more of the following Google IAM permissions on the
5866 # specified resource default_service:
5867 #
5868 #
5869 # - compute.backendBuckets.use
5870 # - compute.backendServices.use
5871 &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
5872 # by defaultUrlRedirect.
5873 #
5874 #
5875 # Only one of defaultUrlRedirect, defaultService
5876 # or defaultRouteAction.weightedBackendService can be set.
5877 #
5878 #
5879 # Not supported when the URL map is bound to a target gRPC proxy.
5880 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
5881 # was supplied in the request.
5882 #
5883 # The value must be from 1 to 255
5884 # characters.
5885 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
5886 # set to HTTPS.
5887 # If set to false, the URL scheme of the redirected request
5888 # remains the same as that of the request.
5889 #
5890 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
5891 #
5892 # The default is set to false.
5893 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
5894 # that was supplied in the request.
5895 #
5896 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
5897 # supplied, the path of the original request is used for the redirect.
5898 #
5899 # The value must be from 1 to 1024 characters.
5900 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
5901 # the HttpRouteRuleMatch, retaining the remaining portion
5902 # of the URL before redirecting the request.
5903 #
5904 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
5905 # supplied, the path of the original request is used for the redirect.
5906 #
5907 # The value must be from 1 to 1024 characters.
5908 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
5909 #
5910 # Supported values are:
5911 #
5912 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
5913 # to 301.
5914 # - FOUND, which corresponds to 302.
5915 # - SEE_OTHER which corresponds to 303.
5916 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
5917 # method is retained.
5918 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
5919 # method is retained.
5920 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
5921 # URL is
5922 # removed before redirecting the request. If set to false, the
5923 # query portion of the original URL is retained.
5924 #
5925 # The default is set to false.
5926 },
5927 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
5928 # create the resource.
5929 &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
5930 # for the selected backend service.
5931 #
5932 # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
5933 #
5934 # HeaderAction is not supported for load balancers
5935 # that have
5936 # their loadBalancingScheme set to EXTERNAL.
5937 #
5938 # Not supported when the URL map is bound to a target gRPC proxy that
5939 # has validateForProxyless field set to true.
5940 # the request is passed along to the selected backendService.
5941 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
5942 { # Specification determining how headers are added to requests or responses.
5943 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
5944 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
5945 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
5946 # that already
5947 # exist for the header. If true, headerValue is set for the
5948 # header, discarding any values that were set for that header.
5949 #
5950 # The default value is true,
5951 # unless a variable is present in headerValue,
5952 # in which case the default value is false.
5953 # .
5954 },
5955 ],
5956 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
5957 # request before forwarding the request to the backendService.
5958 &quot;A String&quot;,
5959 ],
5960 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
5961 # client.
5962 { # Specification determining how headers are added to requests or responses.
5963 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
5964 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
5965 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
5966 # that already
5967 # exist for the header. If true, headerValue is set for the
5968 # header, discarding any values that were set for that header.
5969 #
5970 # The default value is true,
5971 # unless a variable is present in headerValue,
5972 # in which case the default value is false.
5973 # .
5974 },
5975 ],
5976 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
5977 # response before sending the response back to the client.
5978 &quot;A String&quot;,
5979 ],
5980 },
5981 &quot;name&quot;: &quot;A String&quot;, # The name to which this PathMatcher is referred by theHostRule.
5982 &quot;pathRules&quot;: [ # The list of path rules. Use this list instead of routeRules
5983 # when routing based on simple path matching is all that&#x27;s required. A path
5984 # rule can only include a wildcard character (*) after a
5985 # forward slash character (&quot;/&quot;).
5986 #
5987 # The order by which path rules are specified does not matter.
5988 # Matches are always done on the longest-path-first basis.
5989 #
5990 # For example: a pathRule with a path /a/b/c/* will match
5991 # before /a/b/* irrespective of the order in which those paths appear in this
5992 # list.
5993 #
5994 # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
5995 { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
5996 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
5997 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
5998 #
5999 # If a policy for an
6000 # error code is not configured for the PathRule, a policy for
6001 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
6002 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
6003 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
6004 # effect.
6005 #
6006 # For example, consider a UrlMap with the following configuration:
6007 #
6008 #
6009 # - UrlMap.defaultCustomErrorResponsePolicy are configured
6010 # with policies for 5xx and 4xx errors
6011 # - A PathRule for /coming_soon/ is configured for the error
6012 # code 404.
6013 #
6014 # 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
6015 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
6016 # the policy in PathRule.customErrorResponsePolicy takes
6017 # effect. If any of the requests in this example encounter a 500
6018 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
6019 #
6020 # customErrorResponsePolicy is supported only for
6021 # global external Application Load Balancers.
6022 # backend service or backend bucket responds with an error.
6023 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
6024 #
6025 # In a given policy, if you specify rules for both a range of error codes
6026 # as well as rules for specific error codes then rules with specific error
6027 # codes have a higher priority. For example, assume that you configure a rule
6028 # for 401 (Un-authorized) code, and another for all 4 series
6029 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
6030 # However if the backend service returns a 403, the rule for4xx takes effect.
6031 { # Specifies the mapping between the response code that will be returned along
6032 # with the custom error content and the response code returned by the backend
6033 # service.
6034 &quot;matchResponseCodes&quot;: [ # Valid values include:
6035 #
6036 #
6037 # - A number between 400 and 599: For example
6038 # 401 or 503, in which case the load balancer
6039 # applies the policy if the error code exactly matches this value.
6040 # - 5xx: Load Balancer will apply the policy if the
6041 # backend service responds with any response code in the range of
6042 # 500 to 599.
6043 # - 4xx: Load
6044 # Balancer will apply the policy if the backend service responds with any
6045 # response code in the range of 400 to
6046 # 499.
6047 #
6048 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
6049 &quot;A String&quot;,
6050 ],
6051 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
6052 # error content. If overrideResponseCode is not supplied, the
6053 # same response code returned by the original backend bucket or backend
6054 # service is returned to the client.
6055 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
6056 #
6057 # path must start
6058 # with a leading slash. path cannot have trailing slashes.
6059 #
6060 # If the file is not available in backendBucket or the
6061 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
6062 #
6063 # The value must
6064 # be from 1 to 1024 characters
6065 },
6066 ],
6067 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
6068 # contains the custom error content. Examples are:
6069 #
6070 #
6071 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
6072 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
6073 # - global/backendBuckets/myBackendBucket
6074 #
6075 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
6076 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
6077 #
6078 # If load balancer cannot reach
6079 # the backendBucket, a simple Not Found Error will
6080 # be returned, with the original response code (oroverrideResponseCode if configured).
6081 #
6082 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
6083 },
6084 &quot;paths&quot;: [ # The list of path patterns to match. Each must start with /
6085 # and the only place a * is allowed is at the end following
6086 # a /. The string fed to the path matcher does not include
6087 # any text after the first ? or #, and
6088 # those chars are not allowed here.
6089 &quot;A String&quot;,
6090 ],
6091 &quot;routeAction&quot;: { # In response to a matching path, the load balancer
6092 # performs advanced routing actions, such as URL rewrites and header
6093 # transformations, before forwarding the request to the selected
6094 # backend.
6095 #
6096 #
6097 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
6098 #
6099 #
6100 # URL maps for classic Application Load Balancers only support
6101 # the urlRewrite action within a path rule&#x27;srouteAction.
6102 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
6103 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
6104 # property must be specified. This policy cannot be specified if any target
6105 # backend has Identity-Aware Proxy enabled.
6106 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
6107 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
6108 # header names can be specified. The cache is bypassed for all `cacheMode`
6109 # values.
6110 &quot;A String&quot;,
6111 ],
6112 &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
6113 # on the backend type: for Backend Services, the complete request URI is
6114 # used; for Backend Buckets, the request URI is used without the protocol or
6115 # host, and only query parameters known to Cloud Storage are included.
6116 # Policy defined on Route Action.
6117 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
6118 # parameters will be included. Either specify `excludedQueryParameters`
6119 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
6120 # encoded and not treated as delimiters.
6121 #
6122 # Note: This field applies to routes that use backend services. Attempting
6123 # to set it on a route that points exclusively to Backend Buckets will
6124 # result in a configuration error. For routes that point to a Backend
6125 # Bucket, use `includedQueryParameters` to define which parameters should
6126 # be part of the cache key.
6127 &quot;A String&quot;,
6128 ],
6129 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
6130 #
6131 # Note: This setting is only applicable to routes that use a Backend
6132 # Service. It does not affect requests served by a Backend Bucket, as the
6133 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
6134 # it on a route that points exclusively to Backend Buckets will result in a
6135 # configuration error.
6136 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
6137 #
6138 # Note: This setting is only applicable to routes that use a Backend
6139 # Service. It does not affect requests served by a Backend Bucket, as the
6140 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
6141 # set on a route that points exclusively to Backend Buckets will result in
6142 # a configuration error.
6143 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
6144 # `includedQueryParameters` and `excludedQueryParameters`. If neither
6145 # is set, the entire query string will be included. If false, the query
6146 # string will be excluded from the cache key entirely.
6147 #
6148 # Note: This field applies to routes that use backend services. Attempting
6149 # to set it on a route that points exclusively to Backend Buckets will
6150 # result in a configuration error. For routes that point to a Backend
6151 # Bucket, use `includedQueryParameters` to define which parameters should
6152 # be part of the cache key.
6153 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
6154 # The name=value pair will be used in the cache key Cloud CDN generates.
6155 #
6156 # Note: This setting is only applicable to routes that use a Backend
6157 # Service. It does not affect requests served by a Backend Bucket.
6158 # Attempting to set it on a route that points exclusively to Backend
6159 # Buckets will result in a configuration error. Up to 5 cookie names can be
6160 # specified.
6161 &quot;A String&quot;,
6162 ],
6163 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
6164 &quot;A String&quot;,
6165 ],
6166 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
6167 # parameters will be excluded. Either specify `includedQueryParameters`
6168 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
6169 # encoded and not treated as delimiters.
6170 &quot;A String&quot;,
6171 ],
6172 },
6173 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
6174 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
6175 &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
6176 # content. This is used to clamp the max-age (or Expires) value sent to the
6177 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
6178 # is used for the response max-age directive, along with a &quot;public&quot;
6179 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
6180 # clamps the max-age from the origin (if specified), or else sets the
6181 # response max-age directive to the lesser of the `clientTtl` and
6182 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
6183 # present. The maximum allowed value is 31,622,400s (1 year). If not
6184 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
6185 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
6186 # `USE_ORIGIN_HEADERS`.
6187 # as a count of seconds and fractions of seconds at nanosecond
6188 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6189 # or &quot;month&quot;. Range is approximately 10,000 years.
6190 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6191 # Durations less than one second are represented with a 0
6192 # `seconds` field and a positive `nanos` field. Must be from 0
6193 # to 999,999,999 inclusive.
6194 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6195 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6196 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6197 },
6198 &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
6199 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
6200 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
6201 # greater than that of `maxTtl`. When the `cacheMode` is set to
6202 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
6203 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
6204 # accessed objects may be evicted from the cache before the defined TTL. If
6205 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
6206 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
6207 # `USE_ORIGIN_HEADERS`.
6208 # as a count of seconds and fractions of seconds at nanosecond
6209 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6210 # or &quot;month&quot;. Range is approximately 10,000 years.
6211 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6212 # Durations less than one second are represented with a 0
6213 # `seconds` field and a positive `nanos` field. Must be from 0
6214 # to 999,999,999 inclusive.
6215 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6216 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6217 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6218 },
6219 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
6220 # attempt to set a max-age or s-maxage higher than this, or an Expires header
6221 # more than `maxTtl` seconds in the future will be capped at the value of
6222 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
6223 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
6224 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
6225 # Infrequently accessed objects may be evicted from the cache before the
6226 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
6227 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
6228 # mode.
6229 # as a count of seconds and fractions of seconds at nanosecond
6230 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6231 # or &quot;month&quot;. Range is approximately 10,000 years.
6232 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6233 # Durations less than one second are represented with a 0
6234 # `seconds` field and a positive `nanos` field. Must be from 0
6235 # to 999,999,999 inclusive.
6236 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6237 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6238 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6239 },
6240 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
6241 # to apply fine-grained caching for common errors or redirects.
6242 # This can reduce the load on your origin and improve end-user
6243 # experience by reducing response latency.
6244 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
6245 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
6246 # the specified response code that lack any Cache-Control, Expires, or
6247 # Pragma: no-cache directives. When the `cacheMode` is set to
6248 # `FORCE_CACHE_ALL`, negative caching applies to all responses
6249 # with the specified response code, and overrides any caching headers. By
6250 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
6251 #
6252 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
6253 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
6254 # * 405 (Method Not Found), 501 (Not Implemented): 60s
6255 #
6256 # These defaults can be overridden in `negativeCachingPolicy`.
6257 # If not specified, Cloud CDN applies negative caching by default.
6258 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
6259 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
6260 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
6261 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
6262 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
6263 # all response codes that you wish to cache. Cloud CDN will not apply any
6264 # default negative caching when a policy exists.
6265 { # Specify CDN TTLs for response error codes.
6266 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
6267 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
6268 # specified as values, and you cannot specify a status code more than
6269 # once.
6270 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
6271 # corresponding status code.
6272 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
6273 # objects may be evicted from the cache before the defined TTL.
6274 # as a count of seconds and fractions of seconds at nanosecond
6275 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6276 # or &quot;month&quot;. Range is approximately 10,000 years.
6277 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6278 # Durations less than one second are represented with a 0
6279 # `seconds` field and a positive `nanos` field. Must be from 0
6280 # to 999,999,999 inclusive.
6281 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6282 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6283 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6284 },
6285 },
6286 ],
6287 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
6288 # requests into a small number of requests to the origin. If not specified,
6289 # Cloud CDN applies request coalescing by default.
6290 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
6291 # content with the origin, or when an error is encountered when refreshing
6292 # the cache.
6293 # This setting defines the default &quot;max-stale&quot; duration for any cached
6294 # responses that do not specify a max-stale directive. Stale responses that
6295 # exceed the TTL configured here will not be served. The default limit
6296 # (max-stale) is 86400s (1 day), which will allow stale content to be
6297 # served up to this limit beyond the max-age (or s-maxage) of a cached
6298 # response.
6299 # The maximum allowed value is 604800 (1 week).
6300 # Set this to zero (0) to disable serve-while-stale.
6301 # as a count of seconds and fractions of seconds at nanosecond
6302 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6303 # or &quot;month&quot;. Range is approximately 10,000 years.
6304 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6305 # Durations less than one second are represented with a 0
6306 # `seconds` field and a positive `nanos` field. Must be from 0
6307 # to 999,999,999 inclusive.
6308 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6309 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6310 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6311 },
6312 },
6313 &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
6314 # information about the W3C recommendation for cross-origin resource sharing
6315 # (CORS), see Fetch API Living
6316 # Standard.
6317 #
6318 # Not supported when the URL map is bound to a target gRPC proxy.
6319 # information about the W3C recommendation for cross-origin resource sharing
6320 # (CORS), see Fetch API Living
6321 # Standard.
6322 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
6323 # indicates that
6324 # the actual request can include user credentials. This field translates to
6325 # the Access-Control-Allow-Credentials header.
6326 #
6327 # Default is false.
6328 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
6329 # header.
6330 &quot;A String&quot;,
6331 ],
6332 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
6333 # header.
6334 &quot;A String&quot;,
6335 ],
6336 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
6337 # more information, see regular expression syntax.
6338 #
6339 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
6340 #
6341 # Regular expressions can only be used when the loadBalancingScheme is
6342 # set to INTERNAL_SELF_MANAGED.
6343 &quot;A String&quot;,
6344 ],
6345 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
6346 #
6347 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
6348 &quot;A String&quot;,
6349 ],
6350 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
6351 # The default value is false, which indicates that the CORS
6352 # policy is in effect.
6353 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
6354 # header.
6355 &quot;A String&quot;,
6356 ],
6357 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
6358 # seconds. This field translates to the Access-Control-Max-Age
6359 # header.
6360 },
6361 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
6362 # the resiliency of clients to backend service failure. As part of fault
6363 # injection, when clients send requests to a backend service, delays can be
6364 # introduced by a load balancer on a percentage of requests before sending
6365 # those requests to the backend service. Similarly requests from clients can
6366 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
6367 # that are configured with a fault_injection_policy if:
6368 # 1. The traffic is generated by fault injection AND
6369 # 2. The fault injection is not a delay fault injection.
6370 # Fault injection is not supported with the classic Application Load Balancer
6371 # . To see which load balancers support fault injection,
6372 # see Load
6373 # balancing: Routing and traffic management features.
6374 # the resiliency of clients to backend service failure. As part of fault
6375 # injection, when clients send requests to a backend service, delays can be
6376 # introduced by the load balancer on a percentage of requests before sending
6377 # those request to the backend service. Similarly requests from clients can be
6378 # aborted by the load balancer for a percentage of requests.
6379 &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
6380 # injection.
6381 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
6382 #
6383 # The value must be from 200 to 599 inclusive.
6384 #
6385 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
6386 # according to this
6387 # mapping table. HTTP status 200 is mapped to gRPC status
6388 # UNKNOWN. Injecting an OK status is currently not supported by
6389 # Traffic Director.
6390 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
6391 # that is aborted as part of fault injection.
6392 #
6393 # The value must be from 0.0 to 100.0 inclusive.
6394 },
6395 &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
6396 # injection, before being sent to a backend service.
6397 # request to the backend service as part of fault injection.
6398 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
6399 # as a count of seconds and fractions of seconds at nanosecond
6400 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6401 # or &quot;month&quot;. Range is approximately 10,000 years.
6402 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6403 # Durations less than one second are represented with a 0
6404 # `seconds` field and a positive `nanos` field. Must be from 0
6405 # to 999,999,999 inclusive.
6406 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6407 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6408 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6409 },
6410 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
6411 # which a delay is introduced as part of fault injection.
6412 #
6413 # The value must be from 0.0 to 100.0 inclusive.
6414 },
6415 },
6416 &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
6417 # Global EXTERNAL_MANAGED load balancer schemes.
6418 # Either Cloud CDN must be enabled on the backend service or backend bucket
6419 # serving the route, or cache policy must be configured on the same route
6420 # dynamically processes and delivers images from the network edge.
6421 # Image Optimization is only available for Global External Application Load
6422 # Balancers.
6423 # Either Cloud CDN must be enabled on the backend service or backend bucket
6424 # serving the route, or cache policy must be configured on the same route.
6425 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
6426 },
6427 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
6428 # Unlike the timeout field where the timeout duration starts
6429 # from the time the request has been fully processed (known as*end-of-stream*),
6430 # the duration in this field is computed from the beginning of the stream
6431 # until the response has been processed, including all retries. A
6432 # stream that does not complete in this duration is closed.
6433 #
6434 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
6435 # with the route.
6436 #
6437 # This field is only allowed if the Url map is used with backend services
6438 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
6439 # as a count of seconds and fractions of seconds at nanosecond
6440 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6441 # or &quot;month&quot;. Range is approximately 10,000 years.
6442 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6443 # Durations less than one second are represented with a 0
6444 # `seconds` field and a positive `nanos` field. Must be from 0
6445 # to 999,999,999 inclusive.
6446 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6447 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6448 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6449 },
6450 &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
6451 # are shadowed to a separate mirrored backend service. The load balancer does
6452 # not wait for responses from the shadow service. Before sending traffic
6453 # to the shadow service, the host / authority header is suffixed with-shadow.
6454 #
6455 # Not supported when the URL map is bound to a target gRPC proxy that
6456 # has the validateForProxyless field set to true.
6457 # are shadowed to a separate mirrored backend service. The load balancer
6458 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
6459 # to the shadow service, the host or authority header is suffixed with-shadow.
6460 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
6461 # mirrored to.
6462 #
6463 # The backend service configured for a mirroring
6464 # policy must reference backends that are of the same type as the original
6465 # backend service matched in the URL map.
6466 #
6467 # Serverless NEG backends are not currently supported as a mirrored
6468 # backend service.
6469 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
6470 },
6471 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
6472 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
6473 # If not specified, defaults to 1.
6474 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
6475 #
6476 # If not specified, will use the timeout set in theHttpRouteAction field.
6477 # If timeout in the HttpRouteAction field is not set, this field
6478 # uses the largest timeout
6479 # among all backend services associated with the route.
6480 #
6481 # Not supported when the URL map is bound to a target gRPC proxy that
6482 # has the validateForProxyless field set to true.
6483 # as a count of seconds and fractions of seconds at nanosecond
6484 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6485 # or &quot;month&quot;. Range is approximately 10,000 years.
6486 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6487 # Durations less than one second are represented with a 0
6488 # `seconds` field and a positive `nanos` field. Must be from 0
6489 # to 999,999,999 inclusive.
6490 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6491 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6492 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6493 },
6494 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
6495 # values are:
6496 #
6497 # - 5xx: retry is attempted if the instance or endpoint
6498 # responds with any 5xx response code, or if the instance or
6499 # endpoint does not respond at all. For example, disconnects, reset, read
6500 # timeout, connection failure, and refused streams.
6501 # - gateway-error: Similar to 5xx, but only
6502 # applies to response codes 502, 503 or504.
6503 # - connect-failure: a retry is attempted on failures
6504 # connecting to the instance or endpoint. For example, connection
6505 # timeouts.
6506 # - retriable-4xx: a retry is attempted if the instance
6507 # or endpoint responds with a 4xx response code.
6508 # The only error that you can retry is error code 409.
6509 # - refused-stream: a retry is attempted if the instance
6510 # or endpoint resets the stream with a REFUSED_STREAM error
6511 # code. This reset type indicates that it is safe to retry.
6512 # - cancelled: a retry is attempted if the gRPC status
6513 # code in the response header is set to cancelled.
6514 # - deadline-exceeded: a retry is attempted if the gRPC
6515 # status code in the response header is set todeadline-exceeded.
6516 # - internal: a retry is attempted if the gRPC
6517 # status code in the response header is set tointernal.
6518 # - resource-exhausted: a retry is attempted if the gRPC
6519 # status code in the response header is set toresource-exhausted.
6520 # - unavailable: a retry is attempted if the gRPC
6521 # status code in the response header is set tounavailable.
6522 #
6523 # Only the following codes are supported when the URL map is bound to
6524 # target gRPC proxy that has validateForProxyless field set to true.
6525 #
6526 # - cancelled
6527 # - deadline-exceeded
6528 # - internal
6529 # - resource-exhausted
6530 # - unavailable
6531 &quot;A String&quot;,
6532 ],
6533 },
6534 &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
6535 # time the request has been fully processed (known as *end-of-stream*)
6536 # up until the response has been processed. Timeout includes
6537 # all retries.
6538 #
6539 # If not specified, this field uses the largest timeout among all backend
6540 # services associated with the route.
6541 #
6542 # Not supported when the URL map is bound to a target gRPC proxy that
6543 # has validateForProxyless field set to true.
6544 # as a count of seconds and fractions of seconds at nanosecond
6545 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6546 # or &quot;month&quot;. Range is approximately 10,000 years.
6547 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6548 # Durations less than one second are represented with a 0
6549 # `seconds` field and a positive `nanos` field. Must be from 0
6550 # to 999,999,999 inclusive.
6551 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6552 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6553 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6554 },
6555 &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
6556 # to the matched service.
6557 #
6558 # urlRewrite is the only action supported in UrlMaps
6559 # for classic Application Load Balancers.
6560 #
6561 # Not supported when the URL map is bound to a target gRPC proxy that
6562 # has the validateForProxyless field set to true.
6563 # backend service.
6564 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
6565 # host header is replaced with contents of hostRewrite.
6566 #
6567 # The value must be from 1 to 255 characters.
6568 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
6569 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
6570 #
6571 # The value must be from 1 to 1024 characters.
6572 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
6573 # header) using the HTTP template syntax.
6574 #
6575 # A corresponding
6576 # path_template_match must be specified. Any template variables must exist in
6577 # the path_template_match field.
6578 #
6579 #
6580 # - -At least one variable must be specified in the path_template_match
6581 # field
6582 # - You can omit variables from the rewritten URL
6583 # - The * and ** operators cannot be matched
6584 # unless they have a corresponding variable name - e.g.
6585 # {format=*} or {var=**}.
6586 #
6587 # For example, a path_template_match of /static/{format=**}
6588 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
6589 # rewrite, so that /{country}/{format}/{suffix=**} can be
6590 # rewritten as /content/{format}/{country}/{suffix}.
6591 #
6592 # At least
6593 # one non-empty routeRules[].matchRules[].path_template_match is
6594 # required.
6595 #
6596 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
6597 },
6598 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
6599 # occurs. The weights determine the fraction of traffic that flows to
6600 # their corresponding backend service. If all traffic needs to
6601 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
6602 #
6603 # After a backend service is identified and before forwarding
6604 # the request to
6605 # the backend service, advanced routing actions such as URL rewrites and
6606 # header transformations are applied depending on additional settings
6607 # specified in this HttpRouteAction.
6608 { # In contrast to a single BackendService in
6609 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
6610 # multiple backend services. The volume of traffic for each
6611 # backend service is proportional to the weight specified
6612 # in each WeightedBackendService
6613 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
6614 # resource. Before
6615 # forwarding the request to backendService, the load balancer
6616 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
6617 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
6618 # effect for the selected backendService.
6619 #
6620 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
6621 #
6622 # headerAction is not supported for load balancers that have
6623 # their loadBalancingScheme set to EXTERNAL.
6624 #
6625 # Not supported when the URL map is bound to a target gRPC proxy that
6626 # has validateForProxyless field set to true.
6627 # the request is passed along to the selected backendService.
6628 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
6629 { # Specification determining how headers are added to requests or responses.
6630 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
6631 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
6632 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
6633 # that already
6634 # exist for the header. If true, headerValue is set for the
6635 # header, discarding any values that were set for that header.
6636 #
6637 # The default value is true,
6638 # unless a variable is present in headerValue,
6639 # in which case the default value is false.
6640 # .
6641 },
6642 ],
6643 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
6644 # request before forwarding the request to the backendService.
6645 &quot;A String&quot;,
6646 ],
6647 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
6648 # client.
6649 { # Specification determining how headers are added to requests or responses.
6650 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
6651 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
6652 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
6653 # that already
6654 # exist for the header. If true, headerValue is set for the
6655 # header, discarding any values that were set for that header.
6656 #
6657 # The default value is true,
6658 # unless a variable is present in headerValue,
6659 # in which case the default value is false.
6660 # .
6661 },
6662 ],
6663 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
6664 # response before sending the response back to the client.
6665 &quot;A String&quot;,
6666 ],
6667 },
6668 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
6669 # computed asweight / (sum of all weightedBackendService weights in routeAction).
6670 #
6671 # The selection of a backend service is determined only for new traffic.
6672 # Once a user&#x27;s request has been directed to a backend service,
6673 # subsequent requests are sent to the same backend service as
6674 # determined by the backend service&#x27;s session affinity policy.
6675 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
6676 # splitting. If you do, the weighted traffic splitting configuration takes
6677 # precedence.
6678 #
6679 # The value must be from 0 to 1000.
6680 },
6681 ],
6682 },
6683 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
6684 # is directed if this rule is matched. If routeAction is
6685 # also specified, advanced routing actions, such as URL rewrites,
6686 # take effect before sending the request to the backend.
6687 #
6688 #
6689 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
6690 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
6691 # specified by urlRedirect.
6692 #
6693 #
6694 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
6695 #
6696 #
6697 # Not supported when the URL map is bound to a target gRPC proxy.
6698 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
6699 # was supplied in the request.
6700 #
6701 # The value must be from 1 to 255
6702 # characters.
6703 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
6704 # set to HTTPS.
6705 # If set to false, the URL scheme of the redirected request
6706 # remains the same as that of the request.
6707 #
6708 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
6709 #
6710 # The default is set to false.
6711 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
6712 # that was supplied in the request.
6713 #
6714 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
6715 # supplied, the path of the original request is used for the redirect.
6716 #
6717 # The value must be from 1 to 1024 characters.
6718 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
6719 # the HttpRouteRuleMatch, retaining the remaining portion
6720 # of the URL before redirecting the request.
6721 #
6722 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
6723 # supplied, the path of the original request is used for the redirect.
6724 #
6725 # The value must be from 1 to 1024 characters.
6726 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
6727 #
6728 # Supported values are:
6729 #
6730 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
6731 # to 301.
6732 # - FOUND, which corresponds to 302.
6733 # - SEE_OTHER which corresponds to 303.
6734 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
6735 # method is retained.
6736 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
6737 # method is retained.
6738 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
6739 # URL is
6740 # removed before redirecting the request. If set to false, the
6741 # query portion of the original URL is retained.
6742 #
6743 # The default is set to false.
6744 },
6745 },
6746 ],
6747 &quot;routeRules&quot;: [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
6748 # desired. routeRules are evaluated in order of priority, from
6749 # the lowest to highest number.
6750 #
6751 # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
6752 { # The HttpRouteRule setting specifies how to match an HTTP request
6753 # and the corresponding routing action that load balancing proxies perform.
6754 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
6755 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
6756 #
6757 # If a policy for an
6758 # error code is not configured for the RouteRule, a policy for
6759 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
6760 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
6761 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
6762 # effect.
6763 #
6764 # For example, consider a UrlMap with the following configuration:
6765 #
6766 #
6767 # - UrlMap.defaultCustomErrorResponsePolicy are configured
6768 # with policies for 5xx and 4xx errors
6769 # - A RouteRule for /coming_soon/ is configured for the
6770 # error code 404.
6771 #
6772 # 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
6773 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
6774 # the policy in RouteRule.customErrorResponsePolicy takes
6775 # effect. If any of the requests in this example encounter a 500
6776 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
6777 #
6778 # When
6779 # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
6780 # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
6781 # a retry, if load balancer is successful in reaching the
6782 # service, the customErrorResponsePolicy is ignored and
6783 # the response from the service is returned to the client.
6784 #
6785 # customErrorResponsePolicy is supported only for
6786 # global external Application Load Balancers.
6787 # backend service or backend bucket responds with an error.
6788 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
6789 #
6790 # In a given policy, if you specify rules for both a range of error codes
6791 # as well as rules for specific error codes then rules with specific error
6792 # codes have a higher priority. For example, assume that you configure a rule
6793 # for 401 (Un-authorized) code, and another for all 4 series
6794 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
6795 # However if the backend service returns a 403, the rule for4xx takes effect.
6796 { # Specifies the mapping between the response code that will be returned along
6797 # with the custom error content and the response code returned by the backend
6798 # service.
6799 &quot;matchResponseCodes&quot;: [ # Valid values include:
6800 #
6801 #
6802 # - A number between 400 and 599: For example
6803 # 401 or 503, in which case the load balancer
6804 # applies the policy if the error code exactly matches this value.
6805 # - 5xx: Load Balancer will apply the policy if the
6806 # backend service responds with any response code in the range of
6807 # 500 to 599.
6808 # - 4xx: Load
6809 # Balancer will apply the policy if the backend service responds with any
6810 # response code in the range of 400 to
6811 # 499.
6812 #
6813 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
6814 &quot;A String&quot;,
6815 ],
6816 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
6817 # error content. If overrideResponseCode is not supplied, the
6818 # same response code returned by the original backend bucket or backend
6819 # service is returned to the client.
6820 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
6821 #
6822 # path must start
6823 # with a leading slash. path cannot have trailing slashes.
6824 #
6825 # If the file is not available in backendBucket or the
6826 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
6827 #
6828 # The value must
6829 # be from 1 to 1024 characters
6830 },
6831 ],
6832 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
6833 # contains the custom error content. Examples are:
6834 #
6835 #
6836 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
6837 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
6838 # - global/backendBuckets/myBackendBucket
6839 #
6840 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
6841 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
6842 #
6843 # If load balancer cannot reach
6844 # the backendBucket, a simple Not Found Error will
6845 # be returned, with the original response code (oroverrideResponseCode if configured).
6846 #
6847 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
6848 },
6849 &quot;description&quot;: &quot;A String&quot;, # The short description conveying the intent of this routeRule.
6850 #
6851 #
6852 # The description can have a maximum length of 1024 characters.
6853 &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
6854 # for the selected backendService.
6855 #
6856 # The headerAction value specified here is applied before the
6857 # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
6858 #
6859 # HeaderAction is not supported for load balancers
6860 # that have
6861 # their loadBalancingScheme set to EXTERNAL.
6862 #
6863 # Not supported when the URL map is bound to a target gRPC proxy that
6864 # has validateForProxyless field set to true.
6865 # the request is passed along to the selected backendService.
6866 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
6867 { # Specification determining how headers are added to requests or responses.
6868 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
6869 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
6870 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
6871 # that already
6872 # exist for the header. If true, headerValue is set for the
6873 # header, discarding any values that were set for that header.
6874 #
6875 # The default value is true,
6876 # unless a variable is present in headerValue,
6877 # in which case the default value is false.
6878 # .
6879 },
6880 ],
6881 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
6882 # request before forwarding the request to the backendService.
6883 &quot;A String&quot;,
6884 ],
6885 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
6886 # client.
6887 { # Specification determining how headers are added to requests or responses.
6888 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
6889 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
6890 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
6891 # that already
6892 # exist for the header. If true, headerValue is set for the
6893 # header, discarding any values that were set for that header.
6894 #
6895 # The default value is true,
6896 # unless a variable is present in headerValue,
6897 # in which case the default value is false.
6898 # .
6899 },
6900 ],
6901 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
6902 # response before sending the response back to the client.
6903 &quot;A String&quot;,
6904 ],
6905 },
6906 &quot;httpFilterConfigs&quot;: [ # Outbound route specific configuration fornetworkservices.HttpFilter resources enabled by Traffic
6907 # Director. httpFilterConfigs only applies for load balancers
6908 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
6909 # more details.
6910 #
6911 # Not supported when the URL map is bound to a target gRPC proxy that
6912 # has validateForProxyless field set to true.
6913 { # HttpFilterConfiguration supplies additional contextual settings
6914 # for networkservices.HttpFilter resources enabled by Traffic
6915 # Director.
6916 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
6917 # YAML formatted and only contain fields defined in the protobuf identified
6918 # in configTypeUrl
6919 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
6920 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
6921 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
6922 # configuration belongs to. This name must be known to the xDS client.
6923 # Example: envoy.wasm
6924 },
6925 ],
6926 &quot;httpFilterMetadata&quot;: [ # Outbound route specific metadata supplied tonetworkservices.HttpFilter resources enabled by Traffic
6927 # Director. httpFilterMetadata only applies for load balancers
6928 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
6929 # more details.
6930 #
6931 # The only configTypeUrl supported istype.googleapis.com/google.protobuf.Struct
6932 #
6933 # Not supported when the URL map is bound to a target gRPC proxy that
6934 # has validateForProxyless field set to true.
6935 { # HttpFilterConfiguration supplies additional contextual settings
6936 # for networkservices.HttpFilter resources enabled by Traffic
6937 # Director.
6938 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
6939 # YAML formatted and only contain fields defined in the protobuf identified
6940 # in configTypeUrl
6941 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
6942 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
6943 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
6944 # configuration belongs to. This name must be known to the xDS client.
6945 # Example: envoy.wasm
6946 },
6947 ],
6948 &quot;matchRules&quot;: [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
6949 # this routeRule when any of thematchRules are satisfied. However predicates within
6950 # a given matchRule have AND semantics. All predicates
6951 # within a matchRule must match for the request to
6952 # match the rule.
6953 { # HttpRouteRuleMatch specifies a set of criteria for matching
6954 # requests to an HttpRouteRule. All specified criteria must
6955 # be satisfied for a match to occur.
6956 &quot;fullPathMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
6957 # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
6958 # that may be part of the original URL.
6959 #
6960 # fullPathMatch must be from 1 to 1024 characters.
6961 #
6962 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
6963 # specified.
6964 &quot;headerMatches&quot;: [ # Specifies a list of header match criteria, all of which must match
6965 # corresponding headers in the request.
6966 { # matchRule criteria for request header matches.
6967 &quot;exactMatch&quot;: &quot;A String&quot;, # The value should exactly match contents of exactMatch.
6968 #
6969 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
6970 &quot;headerName&quot;: &quot;A String&quot;, # The name of the HTTP header to match.
6971 #
6972 # For matching against the HTTP request&#x27;s authority, use a headerMatch
6973 # with the header name &quot;:authority&quot;.
6974 #
6975 # For matching a request&#x27;s method, use the headerName &quot;:method&quot;.
6976 #
6977 # When the URL map is bound to a target gRPC proxy that has
6978 # the validateForProxyless field set to true, only
6979 # non-binary
6980 # user-specified custom metadata and the `content-type` header are supported.
6981 # The following transport-level headers cannot be used in header matching
6982 # rules:
6983 # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
6984 # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
6985 # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
6986 # `grpc-timeout` and `grpc-trace-bin`.
6987 &quot;invertMatch&quot;: True or False, # If set to false, the headerMatch is considered a
6988 # match if the preceding match criteria are met. If set to true,
6989 # the headerMatch is considered a match if the preceding
6990 # match criteria are NOT met.
6991 #
6992 # The default setting is false.
6993 &quot;prefixMatch&quot;: &quot;A String&quot;, # The value of the header must start with the contents ofprefixMatch.
6994 #
6995 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
6996 &quot;presentMatch&quot;: True or False, # A header with the contents of headerName must exist. The
6997 # match takes place whether or not the request&#x27;s header has a value.
6998 #
6999 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
7000 &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
7001 # specified in rangeMatch. If the header does not contain an
7002 # integer, number or is empty, the match fails.
7003 #
7004 # For example for a range [-5, 0]
7005 #
7006 #
7007 # - -3 will match.
7008 # - 0 will not match.
7009 # - 0.25 will not match.
7010 # - -3someString will not match.
7011 #
7012 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
7013 #
7014 # rangeMatch is not supported for load balancers
7015 # that have loadBalancingScheme set to EXTERNAL.
7016 # within the specified integer range.
7017 &quot;rangeEnd&quot;: &quot;A String&quot;, # The end of the range (exclusive) in signed long integer format.
7018 &quot;rangeStart&quot;: &quot;A String&quot;, # The start of the range (inclusive) in signed long integer format.
7019 },
7020 &quot;regexMatch&quot;: &quot;A String&quot;, # The value of the header must match the regular expression specified inregexMatch.
7021 # For more information about regular expression syntax, see Syntax.
7022 #
7023 # For matching against a port specified in the HTTP request, use a
7024 # headerMatch with headerName set to PORT and a regular expression that
7025 # satisfies the RFC2616 Host header&#x27;s port specifier.
7026 #
7027 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
7028 #
7029 # Regular expressions can only be used when the loadBalancingScheme is
7030 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
7031 # (regional scope) or INTERNAL_MANAGED.
7032 &quot;suffixMatch&quot;: &quot;A String&quot;, # The value of the header must end with the contents ofsuffixMatch.
7033 #
7034 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
7035 },
7036 ],
7037 &quot;ignoreCase&quot;: True or False, # Specifies that prefixMatch and fullPathMatch
7038 # matches are case sensitive.
7039 #
7040 # The default value is false.
7041 #
7042 # ignoreCase must not be used with regexMatch.
7043 #
7044 # Not supported when the URL map is bound to a target gRPC proxy.
7045 &quot;metadataFilters&quot;: [ # Opaque filter criteria used by the load balancer to restrict routing
7046 # configuration to a limited set of xDS
7047 # compliant clients. In their xDS requests to the load balancer, xDS clients
7048 # present node
7049 # metadata. When there is a match, the relevant routing configuration
7050 # is made available to those proxies.
7051 #
7052 # 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
7053 # the metadata. If its filterMatchCriteria is set to
7054 # MATCH_ALL, then all of its filterLabels must match with
7055 # corresponding labels provided in the metadata. If multiple
7056 # metadata filters are specified, all of them need to be
7057 # satisfied in order to be considered a match.
7058 #
7059 # metadataFilters specified here is applied after those
7060 # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
7061 #
7062 # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
7063 #
7064 # Not supported when the URL map is bound to a target gRPC proxy that
7065 # has validateForProxyless field set to true.
7066 { # Opaque filter criteria used by load balancers to restrict routing
7067 # configuration to a limited set of load balancing proxies. Proxies and
7068 # sidecars involved in load balancing would typically present metadata to the
7069 # load balancers that need to match criteria specified here. If a match takes
7070 # place, the relevant configuration is made available to those
7071 # proxies.
7072 #
7073 # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
7074 # one of thefilterLabels must match the corresponding label provided in
7075 # the metadata. If its filterMatchCriteria is set to
7076 # MATCH_ALL, then all of its filterLabels must match with
7077 # corresponding labels provided in the metadata.
7078 #
7079 # An example for using metadataFilters would be: if
7080 # load balancing involves
7081 # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in of their XDS requests to loadbalancers.
7082 &quot;filterLabels&quot;: [ # The list of label value pairs that must match labels in the provided
7083 # metadata based on filterMatchCriteria
7084 #
7085 # This list must not be empty and can have at the most 64 entries.
7086 { # MetadataFilter label name value pairs that are expected
7087 # to match corresponding labels presented as metadata to the load balancer.
7088 &quot;name&quot;: &quot;A String&quot;, # Name of metadata label.
7089 #
7090 # The name can have a maximum length of 1024 characters and must be at
7091 # least 1 character long.
7092 &quot;value&quot;: &quot;A String&quot;, # The value of the label must match the specified value.
7093 #
7094 # value can have a maximum length of 1024 characters.
7095 },
7096 ],
7097 &quot;filterMatchCriteria&quot;: &quot;A String&quot;, # Specifies how individual filter label matches
7098 # within the list of filterLabels and contributes toward the
7099 # overall metadataFilter match.
7100 #
7101 # Supported values are:
7102 #
7103 # - MATCH_ANY: at least one of the filterLabels
7104 # must have a matching label in the provided metadata.
7105 # - MATCH_ALL: all filterLabels must have
7106 # matching labels in the provided metadata.
7107 },
7108 ],
7109 &quot;pathTemplateMatch&quot;: &quot;A String&quot;, # If specified, this field defines a path template pattern that must match
7110 # the :path header after the query string is removed.
7111 #
7112 # A path template pattern can include variables and wildcards.
7113 # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
7114 # matches a single path segment, and ** that matches zero or
7115 # more path segments. The pattern must follow these rules:
7116 #
7117 #
7118 # - The value must be between 1 and 1024 characters.
7119 # - The pattern must start with a leading slash (&quot;/&quot;).
7120 # - No more than 5 operators (variables or wildcards) may appear in
7121 # the pattern.
7122 #
7123 # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
7124 # set.
7125 &quot;prefixMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the request&#x27;s
7126 # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
7127 #
7128 # The value must be from 1 to 1024 characters.
7129 #
7130 # The * character inside a prefix match is
7131 # treated as a literal character, not as a wildcard.
7132 #
7133 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
7134 # used within a matchRule.
7135 &quot;queryParameterMatches&quot;: [ # Specifies a list of query parameter match criteria, all of which must
7136 # match corresponding query parameters in the request.
7137 #
7138 # Not supported when the URL map is bound to a target gRPC proxy.
7139 { # HttpRouteRuleMatch criteria for a request&#x27;s query parameter.
7140 &quot;exactMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
7141 # parameter exactly matches the contents of exactMatch.
7142 #
7143 # Only one of presentMatch, exactMatch, orregexMatch must be set.
7144 &quot;name&quot;: &quot;A String&quot;, # The name of the query parameter to match. The query parameter must exist in
7145 # the request, in the absence of which the request match fails.
7146 &quot;presentMatch&quot;: True or False, # Specifies that the queryParameterMatch matches if the
7147 # request contains the query parameter, irrespective of whether the
7148 # parameter has a value or not.
7149 #
7150 # Only one of presentMatch, exactMatch, orregexMatch must be set.
7151 &quot;regexMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
7152 # parameter matches the regular expression specified byregexMatch. For
7153 # more information about regular expression syntax, see Syntax.
7154 #
7155 # Only one of presentMatch, exactMatch, orregexMatch must be set.
7156 #
7157 # Regular expressions can only be used when the loadBalancingScheme is
7158 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
7159 # (regional scope) or INTERNAL_MANAGED.
7160 },
7161 ],
7162 &quot;regexMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
7163 # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
7164 # supplied with the original URL. For
7165 # more information about regular expression syntax, see Syntax.
7166 #
7167 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
7168 # specified.
7169 #
7170 # Regular expressions can only be used when the loadBalancingScheme is
7171 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
7172 # (regional scope) or INTERNAL_MANAGED.
7173 },
7174 ],
7175 &quot;priority&quot;: 42, # For routeRules within a given pathMatcher,
7176 # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
7177 # of priority, from the lowest to highest number. The priority of a
7178 # rule decreases as its number increases (1, 2, 3, N+1). The first rule
7179 # that matches the request is applied.
7180 #
7181 #
7182 # You cannot configure two or more routeRules with the same priority.
7183 # Priority for each rule must be set to a number from 0 to 2147483647
7184 # inclusive.
7185 #
7186 #
7187 # Priority numbers can have gaps, which enable you to add or remove rules
7188 # in the future without affecting the rest of the rules. For example, 1, 2,
7189 # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
7190 # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
7191 # without any impact on existing rules.
7192 &quot;routeAction&quot;: { # In response to a matching matchRule, the load balancer
7193 # performs advanced routing actions, such as URL rewrites and header
7194 # transformations, before forwarding the request to the selected backend.
7195 #
7196 #
7197 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
7198 #
7199 #
7200 # URL maps for classic Application Load Balancers only support
7201 # the urlRewrite action within a route rule&#x27;srouteAction.
7202 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
7203 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
7204 # property must be specified. This policy cannot be specified if any target
7205 # backend has Identity-Aware Proxy enabled.
7206 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
7207 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
7208 # header names can be specified. The cache is bypassed for all `cacheMode`
7209 # values.
7210 &quot;A String&quot;,
7211 ],
7212 &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
7213 # on the backend type: for Backend Services, the complete request URI is
7214 # used; for Backend Buckets, the request URI is used without the protocol or
7215 # host, and only query parameters known to Cloud Storage are included.
7216 # Policy defined on Route Action.
7217 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
7218 # parameters will be included. Either specify `excludedQueryParameters`
7219 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
7220 # encoded and not treated as delimiters.
7221 #
7222 # Note: This field applies to routes that use backend services. Attempting
7223 # to set it on a route that points exclusively to Backend Buckets will
7224 # result in a configuration error. For routes that point to a Backend
7225 # Bucket, use `includedQueryParameters` to define which parameters should
7226 # be part of the cache key.
7227 &quot;A String&quot;,
7228 ],
7229 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
7230 #
7231 # Note: This setting is only applicable to routes that use a Backend
7232 # Service. It does not affect requests served by a Backend Bucket, as the
7233 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
7234 # it on a route that points exclusively to Backend Buckets will result in a
7235 # configuration error.
7236 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
7237 #
7238 # Note: This setting is only applicable to routes that use a Backend
7239 # Service. It does not affect requests served by a Backend Bucket, as the
7240 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
7241 # set on a route that points exclusively to Backend Buckets will result in
7242 # a configuration error.
7243 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
7244 # `includedQueryParameters` and `excludedQueryParameters`. If neither
7245 # is set, the entire query string will be included. If false, the query
7246 # string will be excluded from the cache key entirely.
7247 #
7248 # Note: This field applies to routes that use backend services. Attempting
7249 # to set it on a route that points exclusively to Backend Buckets will
7250 # result in a configuration error. For routes that point to a Backend
7251 # Bucket, use `includedQueryParameters` to define which parameters should
7252 # be part of the cache key.
7253 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
7254 # The name=value pair will be used in the cache key Cloud CDN generates.
7255 #
7256 # Note: This setting is only applicable to routes that use a Backend
7257 # Service. It does not affect requests served by a Backend Bucket.
7258 # Attempting to set it on a route that points exclusively to Backend
7259 # Buckets will result in a configuration error. Up to 5 cookie names can be
7260 # specified.
7261 &quot;A String&quot;,
7262 ],
7263 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
7264 &quot;A String&quot;,
7265 ],
7266 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
7267 # parameters will be excluded. Either specify `includedQueryParameters`
7268 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
7269 # encoded and not treated as delimiters.
7270 &quot;A String&quot;,
7271 ],
7272 },
7273 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
7274 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
7275 &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
7276 # content. This is used to clamp the max-age (or Expires) value sent to the
7277 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
7278 # is used for the response max-age directive, along with a &quot;public&quot;
7279 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
7280 # clamps the max-age from the origin (if specified), or else sets the
7281 # response max-age directive to the lesser of the `clientTtl` and
7282 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
7283 # present. The maximum allowed value is 31,622,400s (1 year). If not
7284 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
7285 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
7286 # `USE_ORIGIN_HEADERS`.
7287 # as a count of seconds and fractions of seconds at nanosecond
7288 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7289 # or &quot;month&quot;. Range is approximately 10,000 years.
7290 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7291 # Durations less than one second are represented with a 0
7292 # `seconds` field and a positive `nanos` field. Must be from 0
7293 # to 999,999,999 inclusive.
7294 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7295 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7296 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7297 },
7298 &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
7299 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
7300 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
7301 # greater than that of `maxTtl`. When the `cacheMode` is set to
7302 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
7303 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
7304 # accessed objects may be evicted from the cache before the defined TTL. If
7305 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
7306 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
7307 # `USE_ORIGIN_HEADERS`.
7308 # as a count of seconds and fractions of seconds at nanosecond
7309 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7310 # or &quot;month&quot;. Range is approximately 10,000 years.
7311 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7312 # Durations less than one second are represented with a 0
7313 # `seconds` field and a positive `nanos` field. Must be from 0
7314 # to 999,999,999 inclusive.
7315 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7316 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7317 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7318 },
7319 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
7320 # attempt to set a max-age or s-maxage higher than this, or an Expires header
7321 # more than `maxTtl` seconds in the future will be capped at the value of
7322 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
7323 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
7324 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
7325 # Infrequently accessed objects may be evicted from the cache before the
7326 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
7327 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
7328 # mode.
7329 # as a count of seconds and fractions of seconds at nanosecond
7330 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7331 # or &quot;month&quot;. Range is approximately 10,000 years.
7332 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7333 # Durations less than one second are represented with a 0
7334 # `seconds` field and a positive `nanos` field. Must be from 0
7335 # to 999,999,999 inclusive.
7336 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7337 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7338 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7339 },
7340 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
7341 # to apply fine-grained caching for common errors or redirects.
7342 # This can reduce the load on your origin and improve end-user
7343 # experience by reducing response latency.
7344 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
7345 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
7346 # the specified response code that lack any Cache-Control, Expires, or
7347 # Pragma: no-cache directives. When the `cacheMode` is set to
7348 # `FORCE_CACHE_ALL`, negative caching applies to all responses
7349 # with the specified response code, and overrides any caching headers. By
7350 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
7351 #
7352 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
7353 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
7354 # * 405 (Method Not Found), 501 (Not Implemented): 60s
7355 #
7356 # These defaults can be overridden in `negativeCachingPolicy`.
7357 # If not specified, Cloud CDN applies negative caching by default.
7358 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
7359 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
7360 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
7361 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
7362 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
7363 # all response codes that you wish to cache. Cloud CDN will not apply any
7364 # default negative caching when a policy exists.
7365 { # Specify CDN TTLs for response error codes.
7366 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
7367 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
7368 # specified as values, and you cannot specify a status code more than
7369 # once.
7370 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
7371 # corresponding status code.
7372 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
7373 # objects may be evicted from the cache before the defined TTL.
7374 # as a count of seconds and fractions of seconds at nanosecond
7375 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7376 # or &quot;month&quot;. Range is approximately 10,000 years.
7377 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7378 # Durations less than one second are represented with a 0
7379 # `seconds` field and a positive `nanos` field. Must be from 0
7380 # to 999,999,999 inclusive.
7381 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7382 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7383 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7384 },
7385 },
7386 ],
7387 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
7388 # requests into a small number of requests to the origin. If not specified,
7389 # Cloud CDN applies request coalescing by default.
7390 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
7391 # content with the origin, or when an error is encountered when refreshing
7392 # the cache.
7393 # This setting defines the default &quot;max-stale&quot; duration for any cached
7394 # responses that do not specify a max-stale directive. Stale responses that
7395 # exceed the TTL configured here will not be served. The default limit
7396 # (max-stale) is 86400s (1 day), which will allow stale content to be
7397 # served up to this limit beyond the max-age (or s-maxage) of a cached
7398 # response.
7399 # The maximum allowed value is 604800 (1 week).
7400 # Set this to zero (0) to disable serve-while-stale.
7401 # as a count of seconds and fractions of seconds at nanosecond
7402 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7403 # or &quot;month&quot;. Range is approximately 10,000 years.
7404 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7405 # Durations less than one second are represented with a 0
7406 # `seconds` field and a positive `nanos` field. Must be from 0
7407 # to 999,999,999 inclusive.
7408 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7409 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7410 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7411 },
7412 },
7413 &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
7414 # information about the W3C recommendation for cross-origin resource sharing
7415 # (CORS), see Fetch API Living
7416 # Standard.
7417 #
7418 # Not supported when the URL map is bound to a target gRPC proxy.
7419 # information about the W3C recommendation for cross-origin resource sharing
7420 # (CORS), see Fetch API Living
7421 # Standard.
7422 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
7423 # indicates that
7424 # the actual request can include user credentials. This field translates to
7425 # the Access-Control-Allow-Credentials header.
7426 #
7427 # Default is false.
7428 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
7429 # header.
7430 &quot;A String&quot;,
7431 ],
7432 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
7433 # header.
7434 &quot;A String&quot;,
7435 ],
7436 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
7437 # more information, see regular expression syntax.
7438 #
7439 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
7440 #
7441 # Regular expressions can only be used when the loadBalancingScheme is
7442 # set to INTERNAL_SELF_MANAGED.
7443 &quot;A String&quot;,
7444 ],
7445 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
7446 #
7447 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
7448 &quot;A String&quot;,
7449 ],
7450 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
7451 # The default value is false, which indicates that the CORS
7452 # policy is in effect.
7453 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
7454 # header.
7455 &quot;A String&quot;,
7456 ],
7457 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
7458 # seconds. This field translates to the Access-Control-Max-Age
7459 # header.
7460 },
7461 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
7462 # the resiliency of clients to backend service failure. As part of fault
7463 # injection, when clients send requests to a backend service, delays can be
7464 # introduced by a load balancer on a percentage of requests before sending
7465 # those requests to the backend service. Similarly requests from clients can
7466 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
7467 # that are configured with a fault_injection_policy if:
7468 # 1. The traffic is generated by fault injection AND
7469 # 2. The fault injection is not a delay fault injection.
7470 # Fault injection is not supported with the classic Application Load Balancer
7471 # . To see which load balancers support fault injection,
7472 # see Load
7473 # balancing: Routing and traffic management features.
7474 # the resiliency of clients to backend service failure. As part of fault
7475 # injection, when clients send requests to a backend service, delays can be
7476 # introduced by the load balancer on a percentage of requests before sending
7477 # those request to the backend service. Similarly requests from clients can be
7478 # aborted by the load balancer for a percentage of requests.
7479 &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
7480 # injection.
7481 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
7482 #
7483 # The value must be from 200 to 599 inclusive.
7484 #
7485 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
7486 # according to this
7487 # mapping table. HTTP status 200 is mapped to gRPC status
7488 # UNKNOWN. Injecting an OK status is currently not supported by
7489 # Traffic Director.
7490 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
7491 # that is aborted as part of fault injection.
7492 #
7493 # The value must be from 0.0 to 100.0 inclusive.
7494 },
7495 &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
7496 # injection, before being sent to a backend service.
7497 # request to the backend service as part of fault injection.
7498 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
7499 # as a count of seconds and fractions of seconds at nanosecond
7500 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7501 # or &quot;month&quot;. Range is approximately 10,000 years.
7502 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7503 # Durations less than one second are represented with a 0
7504 # `seconds` field and a positive `nanos` field. Must be from 0
7505 # to 999,999,999 inclusive.
7506 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7507 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7508 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7509 },
7510 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
7511 # which a delay is introduced as part of fault injection.
7512 #
7513 # The value must be from 0.0 to 100.0 inclusive.
7514 },
7515 },
7516 &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
7517 # Global EXTERNAL_MANAGED load balancer schemes.
7518 # Either Cloud CDN must be enabled on the backend service or backend bucket
7519 # serving the route, or cache policy must be configured on the same route
7520 # dynamically processes and delivers images from the network edge.
7521 # Image Optimization is only available for Global External Application Load
7522 # Balancers.
7523 # Either Cloud CDN must be enabled on the backend service or backend bucket
7524 # serving the route, or cache policy must be configured on the same route.
7525 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
7526 },
7527 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
7528 # Unlike the timeout field where the timeout duration starts
7529 # from the time the request has been fully processed (known as*end-of-stream*),
7530 # the duration in this field is computed from the beginning of the stream
7531 # until the response has been processed, including all retries. A
7532 # stream that does not complete in this duration is closed.
7533 #
7534 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
7535 # with the route.
7536 #
7537 # This field is only allowed if the Url map is used with backend services
7538 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
7539 # as a count of seconds and fractions of seconds at nanosecond
7540 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7541 # or &quot;month&quot;. Range is approximately 10,000 years.
7542 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7543 # Durations less than one second are represented with a 0
7544 # `seconds` field and a positive `nanos` field. Must be from 0
7545 # to 999,999,999 inclusive.
7546 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7547 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7548 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7549 },
7550 &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
7551 # are shadowed to a separate mirrored backend service. The load balancer does
7552 # not wait for responses from the shadow service. Before sending traffic
7553 # to the shadow service, the host / authority header is suffixed with-shadow.
7554 #
7555 # Not supported when the URL map is bound to a target gRPC proxy that
7556 # has the validateForProxyless field set to true.
7557 # are shadowed to a separate mirrored backend service. The load balancer
7558 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
7559 # to the shadow service, the host or authority header is suffixed with-shadow.
7560 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
7561 # mirrored to.
7562 #
7563 # The backend service configured for a mirroring
7564 # policy must reference backends that are of the same type as the original
7565 # backend service matched in the URL map.
7566 #
7567 # Serverless NEG backends are not currently supported as a mirrored
7568 # backend service.
7569 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
7570 },
7571 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
7572 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
7573 # If not specified, defaults to 1.
7574 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
7575 #
7576 # If not specified, will use the timeout set in theHttpRouteAction field.
7577 # If timeout in the HttpRouteAction field is not set, this field
7578 # uses the largest timeout
7579 # among all backend services associated with the route.
7580 #
7581 # Not supported when the URL map is bound to a target gRPC proxy that
7582 # has the validateForProxyless field set to true.
7583 # as a count of seconds and fractions of seconds at nanosecond
7584 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7585 # or &quot;month&quot;. Range is approximately 10,000 years.
7586 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7587 # Durations less than one second are represented with a 0
7588 # `seconds` field and a positive `nanos` field. Must be from 0
7589 # to 999,999,999 inclusive.
7590 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7591 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7592 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7593 },
7594 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
7595 # values are:
7596 #
7597 # - 5xx: retry is attempted if the instance or endpoint
7598 # responds with any 5xx response code, or if the instance or
7599 # endpoint does not respond at all. For example, disconnects, reset, read
7600 # timeout, connection failure, and refused streams.
7601 # - gateway-error: Similar to 5xx, but only
7602 # applies to response codes 502, 503 or504.
7603 # - connect-failure: a retry is attempted on failures
7604 # connecting to the instance or endpoint. For example, connection
7605 # timeouts.
7606 # - retriable-4xx: a retry is attempted if the instance
7607 # or endpoint responds with a 4xx response code.
7608 # The only error that you can retry is error code 409.
7609 # - refused-stream: a retry is attempted if the instance
7610 # or endpoint resets the stream with a REFUSED_STREAM error
7611 # code. This reset type indicates that it is safe to retry.
7612 # - cancelled: a retry is attempted if the gRPC status
7613 # code in the response header is set to cancelled.
7614 # - deadline-exceeded: a retry is attempted if the gRPC
7615 # status code in the response header is set todeadline-exceeded.
7616 # - internal: a retry is attempted if the gRPC
7617 # status code in the response header is set tointernal.
7618 # - resource-exhausted: a retry is attempted if the gRPC
7619 # status code in the response header is set toresource-exhausted.
7620 # - unavailable: a retry is attempted if the gRPC
7621 # status code in the response header is set tounavailable.
7622 #
7623 # Only the following codes are supported when the URL map is bound to
7624 # target gRPC proxy that has validateForProxyless field set to true.
7625 #
7626 # - cancelled
7627 # - deadline-exceeded
7628 # - internal
7629 # - resource-exhausted
7630 # - unavailable
7631 &quot;A String&quot;,
7632 ],
7633 },
7634 &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
7635 # time the request has been fully processed (known as *end-of-stream*)
7636 # up until the response has been processed. Timeout includes
7637 # all retries.
7638 #
7639 # If not specified, this field uses the largest timeout among all backend
7640 # services associated with the route.
7641 #
7642 # Not supported when the URL map is bound to a target gRPC proxy that
7643 # has validateForProxyless field set to true.
7644 # as a count of seconds and fractions of seconds at nanosecond
7645 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7646 # or &quot;month&quot;. Range is approximately 10,000 years.
7647 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7648 # Durations less than one second are represented with a 0
7649 # `seconds` field and a positive `nanos` field. Must be from 0
7650 # to 999,999,999 inclusive.
7651 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7652 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7653 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7654 },
7655 &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
7656 # to the matched service.
7657 #
7658 # urlRewrite is the only action supported in UrlMaps
7659 # for classic Application Load Balancers.
7660 #
7661 # Not supported when the URL map is bound to a target gRPC proxy that
7662 # has the validateForProxyless field set to true.
7663 # backend service.
7664 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
7665 # host header is replaced with contents of hostRewrite.
7666 #
7667 # The value must be from 1 to 255 characters.
7668 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
7669 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
7670 #
7671 # The value must be from 1 to 1024 characters.
7672 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
7673 # header) using the HTTP template syntax.
7674 #
7675 # A corresponding
7676 # path_template_match must be specified. Any template variables must exist in
7677 # the path_template_match field.
7678 #
7679 #
7680 # - -At least one variable must be specified in the path_template_match
7681 # field
7682 # - You can omit variables from the rewritten URL
7683 # - The * and ** operators cannot be matched
7684 # unless they have a corresponding variable name - e.g.
7685 # {format=*} or {var=**}.
7686 #
7687 # For example, a path_template_match of /static/{format=**}
7688 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
7689 # rewrite, so that /{country}/{format}/{suffix=**} can be
7690 # rewritten as /content/{format}/{country}/{suffix}.
7691 #
7692 # At least
7693 # one non-empty routeRules[].matchRules[].path_template_match is
7694 # required.
7695 #
7696 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
7697 },
7698 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
7699 # occurs. The weights determine the fraction of traffic that flows to
7700 # their corresponding backend service. If all traffic needs to
7701 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
7702 #
7703 # After a backend service is identified and before forwarding
7704 # the request to
7705 # the backend service, advanced routing actions such as URL rewrites and
7706 # header transformations are applied depending on additional settings
7707 # specified in this HttpRouteAction.
7708 { # In contrast to a single BackendService in
7709 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
7710 # multiple backend services. The volume of traffic for each
7711 # backend service is proportional to the weight specified
7712 # in each WeightedBackendService
7713 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
7714 # resource. Before
7715 # forwarding the request to backendService, the load balancer
7716 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
7717 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
7718 # effect for the selected backendService.
7719 #
7720 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
7721 #
7722 # headerAction is not supported for load balancers that have
7723 # their loadBalancingScheme set to EXTERNAL.
7724 #
7725 # Not supported when the URL map is bound to a target gRPC proxy that
7726 # has validateForProxyless field set to true.
7727 # the request is passed along to the selected backendService.
7728 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
7729 { # Specification determining how headers are added to requests or responses.
7730 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
7731 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
7732 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
7733 # that already
7734 # exist for the header. If true, headerValue is set for the
7735 # header, discarding any values that were set for that header.
7736 #
7737 # The default value is true,
7738 # unless a variable is present in headerValue,
7739 # in which case the default value is false.
7740 # .
7741 },
7742 ],
7743 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
7744 # request before forwarding the request to the backendService.
7745 &quot;A String&quot;,
7746 ],
7747 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
7748 # client.
7749 { # Specification determining how headers are added to requests or responses.
7750 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
7751 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
7752 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
7753 # that already
7754 # exist for the header. If true, headerValue is set for the
7755 # header, discarding any values that were set for that header.
7756 #
7757 # The default value is true,
7758 # unless a variable is present in headerValue,
7759 # in which case the default value is false.
7760 # .
7761 },
7762 ],
7763 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
7764 # response before sending the response back to the client.
7765 &quot;A String&quot;,
7766 ],
7767 },
7768 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
7769 # computed asweight / (sum of all weightedBackendService weights in routeAction).
7770 #
7771 # The selection of a backend service is determined only for new traffic.
7772 # Once a user&#x27;s request has been directed to a backend service,
7773 # subsequent requests are sent to the same backend service as
7774 # determined by the backend service&#x27;s session affinity policy.
7775 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
7776 # splitting. If you do, the weighted traffic splitting configuration takes
7777 # precedence.
7778 #
7779 # The value must be from 0 to 1000.
7780 },
7781 ],
7782 },
7783 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
7784 # is directed if this rule is matched. If routeAction is
7785 # also specified, advanced routing actions, such as URL rewrites,
7786 # take effect before sending the request to the backend.
7787 #
7788 #
7789 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
7790 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
7791 # specified by urlRedirect.
7792 #
7793 #
7794 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
7795 #
7796 #
7797 # Not supported when the URL map is bound to a target gRPC proxy.
7798 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
7799 # was supplied in the request.
7800 #
7801 # The value must be from 1 to 255
7802 # characters.
7803 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
7804 # set to HTTPS.
7805 # If set to false, the URL scheme of the redirected request
7806 # remains the same as that of the request.
7807 #
7808 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
7809 #
7810 # The default is set to false.
7811 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
7812 # that was supplied in the request.
7813 #
7814 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
7815 # supplied, the path of the original request is used for the redirect.
7816 #
7817 # The value must be from 1 to 1024 characters.
7818 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
7819 # the HttpRouteRuleMatch, retaining the remaining portion
7820 # of the URL before redirecting the request.
7821 #
7822 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
7823 # supplied, the path of the original request is used for the redirect.
7824 #
7825 # The value must be from 1 to 1024 characters.
7826 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
7827 #
7828 # Supported values are:
7829 #
7830 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
7831 # to 301.
7832 # - FOUND, which corresponds to 302.
7833 # - SEE_OTHER which corresponds to 303.
7834 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
7835 # method is retained.
7836 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
7837 # method is retained.
7838 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
7839 # URL is
7840 # removed before redirecting the request. If set to false, the
7841 # query portion of the original URL is retained.
7842 #
7843 # The default is set to false.
7844 },
7845 },
7846 ],
7847 },
7848 ],
7849 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the regional URL map resides.
7850 # This field is not applicable to global URL maps.
7851 # You must specify this field as part of the HTTP request URL. It is
7852 # not settable as a field in the request body.
7853 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
7854 &quot;status&quot;: { # [Output Only] The status of the URL map. # Output only. [Output Only] The status of the URL map.
7855 &quot;quotaUsage&quot;: { # Message representing the quota usage for a UrlMap. # Output only. Summary of quota usage for given UrlMap.
7856 &quot;forwardingRules&quot;: 42, # Output only. The number of forwarding rules that uses this UrlMap.
7857 &quot;units&quot;: &quot;A String&quot;, # Output only. The number of quota units calculated for this UrlMap.
7858 },
7859 },
7860 &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
7861 # maximum of 100 tests per UrlMap.
7862 #
7863 # Not supported when the URL map is bound to a target gRPC proxy that
7864 # has validateForProxyless field set to true.
7865 { # Message for the expected URL mappings.
7866 &quot;description&quot;: &quot;A String&quot;, # Description of this test case.
7867 &quot;expectedOutputUrl&quot;: &quot;A String&quot;, # The expected output URL evaluated by the load balancer
7868 # containing the scheme, host, path and query parameters.
7869 #
7870 # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
7871 # the load balancer to backends. For rules with urlRewrite,
7872 # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
7873 #
7874 # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer&#x27;s
7875 # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
7876 # If urlRedirect specifies strip_query, the test
7877 # passes only if expectedOutputUrl does not contain any query
7878 # parameters.
7879 #
7880 # expectedOutputUrl is optional whenservice is specified.
7881 &quot;expectedRedirectResponseCode&quot;: 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
7882 # load balancer&#x27;s redirect response.
7883 #
7884 # expectedRedirectResponseCode cannot be set whenservice is set.
7885 &quot;headers&quot;: [ # HTTP headers for this request. If headers contains
7886 # a host header, then host must also match the header value.
7887 { # HTTP headers used in UrlMapTests.
7888 &quot;name&quot;: &quot;A String&quot;, # Header name.
7889 &quot;value&quot;: &quot;A String&quot;, # Header value.
7890 },
7891 ],
7892 &quot;host&quot;: &quot;A String&quot;, # Host portion of the URL. If headers contains a host header,
7893 # then host must also match the header value.
7894 &quot;path&quot;: &quot;A String&quot;, # Path portion of the URL.
7895 &quot;service&quot;: &quot;A String&quot;, # Expected BackendService or BackendBucket resource
7896 # the given URL should be mapped to.
7897 #
7898 # The service field cannot
7899 # be set if expectedRedirectResponseCode is set.
7900 },
7901 ],
7902 }</pre>
7903 </div>
7904
7905 <div class="method">
7906 <code class="details" id="insert">insert(project, body=None, requestId=None, x__xgafv=None)</code>
7907 <pre>Creates a UrlMap resource in the specified project using
7908 the data included in the request.
7909
7910 Args:
7911 project: string, Project ID for this request. (required)
7912 body: object, The request body.
7913 The object takes the form of:
7914
7915 { # Represents a URL Map resource.
7916 #
7917 # Compute Engine has two URL Map resources:
7918 #
7919 # * [Global](/compute/docs/reference/rest/beta/urlMaps)
7920 # * [Regional](/compute/docs/reference/rest/beta/regionUrlMaps)
7921 #
7922 # A URL map resource is a component of certain types of cloud load balancers
7923 # and Traffic Director:
7924 #
7925 # * urlMaps are used by global external Application Load
7926 # Balancers, classic Application Load Balancers, and cross-region internal
7927 # Application Load Balancers.
7928 # * regionUrlMaps are used by internal Application Load Balancers,
7929 # regional external Application Load Balancers and regional internal
7930 # Application Load Balancers.
7931 #
7932 # For a list of supported URL map features by the load balancer type, see the
7933 # Load balancing features: Routing and traffic management table.
7934 #
7935 # For a list of supported URL map features for Traffic Director, see the
7936 # Traffic Director features: Routing and traffic management table.
7937 #
7938 # This resource defines mappings from hostnames and URL paths to either a
7939 # backend service or a backend bucket.
7940 #
7941 # To use the global urlMaps resource, the backend service must
7942 # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
7943 # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
7944 # information, read URL
7945 # Map Concepts.
7946 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
7947 # text format.
7948 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
7949 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
7950 #
7951 # This policy takes
7952 # effect at the load balancer level and applies only when no policy has been
7953 # defined for the error code at lower levels like PathMatcher, RouteRule and
7954 # PathRule within this UrlMap.
7955 #
7956 # For example, consider a UrlMap with the
7957 # following configuration:
7958 #
7959 #
7960 # - defaultCustomErrorResponsePolicy containing policies for
7961 # responding to 5xx and 4xx errors
7962 # - A PathMatcher configured for *.example.com has
7963 # defaultCustomErrorResponsePolicy for 4xx.
7964 #
7965 # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
7966 # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
7967 # a request that does not match any host in *.example.com such
7968 # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
7969 # takes effect.
7970 #
7971 # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
7972 # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
7973 # a retry, if load balancer is successful in reaching the
7974 # service, the defaultCustomErrorResponsePolicy is ignored and
7975 # the response from the service is returned to the client.
7976 #
7977 # defaultCustomErrorResponsePolicy is supported only for
7978 # global external Application Load Balancers.
7979 # backend service or backend bucket responds with an error.
7980 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
7981 #
7982 # In a given policy, if you specify rules for both a range of error codes
7983 # as well as rules for specific error codes then rules with specific error
7984 # codes have a higher priority. For example, assume that you configure a rule
7985 # for 401 (Un-authorized) code, and another for all 4 series
7986 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
7987 # However if the backend service returns a 403, the rule for4xx takes effect.
7988 { # Specifies the mapping between the response code that will be returned along
7989 # with the custom error content and the response code returned by the backend
7990 # service.
7991 &quot;matchResponseCodes&quot;: [ # Valid values include:
7992 #
7993 #
7994 # - A number between 400 and 599: For example
7995 # 401 or 503, in which case the load balancer
7996 # applies the policy if the error code exactly matches this value.
7997 # - 5xx: Load Balancer will apply the policy if the
7998 # backend service responds with any response code in the range of
7999 # 500 to 599.
8000 # - 4xx: Load
8001 # Balancer will apply the policy if the backend service responds with any
8002 # response code in the range of 400 to
8003 # 499.
8004 #
8005 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
8006 &quot;A String&quot;,
8007 ],
8008 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
8009 # error content. If overrideResponseCode is not supplied, the
8010 # same response code returned by the original backend bucket or backend
8011 # service is returned to the client.
8012 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
8013 #
8014 # path must start
8015 # with a leading slash. path cannot have trailing slashes.
8016 #
8017 # If the file is not available in backendBucket or the
8018 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
8019 #
8020 # The value must
8021 # be from 1 to 1024 characters
8022 },
8023 ],
8024 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
8025 # contains the custom error content. Examples are:
8026 #
8027 #
8028 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
8029 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
8030 # - global/backendBuckets/myBackendBucket
8031 #
8032 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
8033 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
8034 #
8035 # If load balancer cannot reach
8036 # the backendBucket, a simple Not Found Error will
8037 # be returned, with the original response code (oroverrideResponseCode if configured).
8038 #
8039 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
8040 },
8041 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
8042 # hostRules match. The load balancer performs advanced routing
8043 # actions, such as URL rewrites and header transformations, before forwarding
8044 # the request to the selected backend.
8045 #
8046 #
8047 # Only one of defaultUrlRedirect, defaultService
8048 # or defaultRouteAction.weightedBackendService can be set.
8049 #
8050 #
8051 # URL maps for classic Application Load Balancers only support
8052 # the urlRewrite action within defaultRouteAction.
8053 #
8054 #
8055 # defaultRouteAction has no effect when the URL map is bound
8056 # to a target gRPC proxy that has the validateForProxyless field
8057 # set to true.
8058 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
8059 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
8060 # property must be specified. This policy cannot be specified if any target
8061 # backend has Identity-Aware Proxy enabled.
8062 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
8063 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
8064 # header names can be specified. The cache is bypassed for all `cacheMode`
8065 # values.
8066 &quot;A String&quot;,
8067 ],
8068 &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
8069 # on the backend type: for Backend Services, the complete request URI is
8070 # used; for Backend Buckets, the request URI is used without the protocol or
8071 # host, and only query parameters known to Cloud Storage are included.
8072 # Policy defined on Route Action.
8073 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
8074 # parameters will be included. Either specify `excludedQueryParameters`
8075 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
8076 # encoded and not treated as delimiters.
8077 #
8078 # Note: This field applies to routes that use backend services. Attempting
8079 # to set it on a route that points exclusively to Backend Buckets will
8080 # result in a configuration error. For routes that point to a Backend
8081 # Bucket, use `includedQueryParameters` to define which parameters should
8082 # be part of the cache key.
8083 &quot;A String&quot;,
8084 ],
8085 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
8086 #
8087 # Note: This setting is only applicable to routes that use a Backend
8088 # Service. It does not affect requests served by a Backend Bucket, as the
8089 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
8090 # it on a route that points exclusively to Backend Buckets will result in a
8091 # configuration error.
8092 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
8093 #
8094 # Note: This setting is only applicable to routes that use a Backend
8095 # Service. It does not affect requests served by a Backend Bucket, as the
8096 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
8097 # set on a route that points exclusively to Backend Buckets will result in
8098 # a configuration error.
8099 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
8100 # `includedQueryParameters` and `excludedQueryParameters`. If neither
8101 # is set, the entire query string will be included. If false, the query
8102 # string will be excluded from the cache key entirely.
8103 #
8104 # Note: This field applies to routes that use backend services. Attempting
8105 # to set it on a route that points exclusively to Backend Buckets will
8106 # result in a configuration error. For routes that point to a Backend
8107 # Bucket, use `includedQueryParameters` to define which parameters should
8108 # be part of the cache key.
8109 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
8110 # The name=value pair will be used in the cache key Cloud CDN generates.
8111 #
8112 # Note: This setting is only applicable to routes that use a Backend
8113 # Service. It does not affect requests served by a Backend Bucket.
8114 # Attempting to set it on a route that points exclusively to Backend
8115 # Buckets will result in a configuration error. Up to 5 cookie names can be
8116 # specified.
8117 &quot;A String&quot;,
8118 ],
8119 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
8120 &quot;A String&quot;,
8121 ],
8122 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
8123 # parameters will be excluded. Either specify `includedQueryParameters`
8124 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
8125 # encoded and not treated as delimiters.
8126 &quot;A String&quot;,
8127 ],
8128 },
8129 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
8130 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
8131 &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
8132 # content. This is used to clamp the max-age (or Expires) value sent to the
8133 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
8134 # is used for the response max-age directive, along with a &quot;public&quot;
8135 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
8136 # clamps the max-age from the origin (if specified), or else sets the
8137 # response max-age directive to the lesser of the `clientTtl` and
8138 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
8139 # present. The maximum allowed value is 31,622,400s (1 year). If not
8140 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
8141 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
8142 # `USE_ORIGIN_HEADERS`.
8143 # as a count of seconds and fractions of seconds at nanosecond
8144 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8145 # or &quot;month&quot;. Range is approximately 10,000 years.
8146 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8147 # Durations less than one second are represented with a 0
8148 # `seconds` field and a positive `nanos` field. Must be from 0
8149 # to 999,999,999 inclusive.
8150 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8151 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8152 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8153 },
8154 &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
8155 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
8156 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
8157 # greater than that of `maxTtl`. When the `cacheMode` is set to
8158 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
8159 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
8160 # accessed objects may be evicted from the cache before the defined TTL. If
8161 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
8162 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
8163 # `USE_ORIGIN_HEADERS`.
8164 # as a count of seconds and fractions of seconds at nanosecond
8165 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8166 # or &quot;month&quot;. Range is approximately 10,000 years.
8167 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8168 # Durations less than one second are represented with a 0
8169 # `seconds` field and a positive `nanos` field. Must be from 0
8170 # to 999,999,999 inclusive.
8171 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8172 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8173 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8174 },
8175 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
8176 # attempt to set a max-age or s-maxage higher than this, or an Expires header
8177 # more than `maxTtl` seconds in the future will be capped at the value of
8178 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
8179 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
8180 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
8181 # Infrequently accessed objects may be evicted from the cache before the
8182 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
8183 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
8184 # mode.
8185 # as a count of seconds and fractions of seconds at nanosecond
8186 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8187 # or &quot;month&quot;. Range is approximately 10,000 years.
8188 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8189 # Durations less than one second are represented with a 0
8190 # `seconds` field and a positive `nanos` field. Must be from 0
8191 # to 999,999,999 inclusive.
8192 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8193 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8194 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8195 },
8196 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
8197 # to apply fine-grained caching for common errors or redirects.
8198 # This can reduce the load on your origin and improve end-user
8199 # experience by reducing response latency.
8200 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
8201 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
8202 # the specified response code that lack any Cache-Control, Expires, or
8203 # Pragma: no-cache directives. When the `cacheMode` is set to
8204 # `FORCE_CACHE_ALL`, negative caching applies to all responses
8205 # with the specified response code, and overrides any caching headers. By
8206 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
8207 #
8208 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
8209 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
8210 # * 405 (Method Not Found), 501 (Not Implemented): 60s
8211 #
8212 # These defaults can be overridden in `negativeCachingPolicy`.
8213 # If not specified, Cloud CDN applies negative caching by default.
8214 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
8215 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
8216 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
8217 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
8218 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
8219 # all response codes that you wish to cache. Cloud CDN will not apply any
8220 # default negative caching when a policy exists.
8221 { # Specify CDN TTLs for response error codes.
8222 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
8223 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
8224 # specified as values, and you cannot specify a status code more than
8225 # once.
8226 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
8227 # corresponding status code.
8228 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
8229 # objects may be evicted from the cache before the defined TTL.
8230 # as a count of seconds and fractions of seconds at nanosecond
8231 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8232 # or &quot;month&quot;. Range is approximately 10,000 years.
8233 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8234 # Durations less than one second are represented with a 0
8235 # `seconds` field and a positive `nanos` field. Must be from 0
8236 # to 999,999,999 inclusive.
8237 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8238 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8239 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8240 },
8241 },
8242 ],
8243 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
8244 # requests into a small number of requests to the origin. If not specified,
8245 # Cloud CDN applies request coalescing by default.
8246 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
8247 # content with the origin, or when an error is encountered when refreshing
8248 # the cache.
8249 # This setting defines the default &quot;max-stale&quot; duration for any cached
8250 # responses that do not specify a max-stale directive. Stale responses that
8251 # exceed the TTL configured here will not be served. The default limit
8252 # (max-stale) is 86400s (1 day), which will allow stale content to be
8253 # served up to this limit beyond the max-age (or s-maxage) of a cached
8254 # response.
8255 # The maximum allowed value is 604800 (1 week).
8256 # Set this to zero (0) to disable serve-while-stale.
8257 # as a count of seconds and fractions of seconds at nanosecond
8258 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8259 # or &quot;month&quot;. Range is approximately 10,000 years.
8260 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8261 # Durations less than one second are represented with a 0
8262 # `seconds` field and a positive `nanos` field. Must be from 0
8263 # to 999,999,999 inclusive.
8264 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8265 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8266 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8267 },
8268 },
8269 &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
8270 # information about the W3C recommendation for cross-origin resource sharing
8271 # (CORS), see Fetch API Living
8272 # Standard.
8273 #
8274 # Not supported when the URL map is bound to a target gRPC proxy.
8275 # information about the W3C recommendation for cross-origin resource sharing
8276 # (CORS), see Fetch API Living
8277 # Standard.
8278 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
8279 # indicates that
8280 # the actual request can include user credentials. This field translates to
8281 # the Access-Control-Allow-Credentials header.
8282 #
8283 # Default is false.
8284 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
8285 # header.
8286 &quot;A String&quot;,
8287 ],
8288 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
8289 # header.
8290 &quot;A String&quot;,
8291 ],
8292 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
8293 # more information, see regular expression syntax.
8294 #
8295 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
8296 #
8297 # Regular expressions can only be used when the loadBalancingScheme is
8298 # set to INTERNAL_SELF_MANAGED.
8299 &quot;A String&quot;,
8300 ],
8301 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
8302 #
8303 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
8304 &quot;A String&quot;,
8305 ],
8306 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
8307 # The default value is false, which indicates that the CORS
8308 # policy is in effect.
8309 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
8310 # header.
8311 &quot;A String&quot;,
8312 ],
8313 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
8314 # seconds. This field translates to the Access-Control-Max-Age
8315 # header.
8316 },
8317 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
8318 # the resiliency of clients to backend service failure. As part of fault
8319 # injection, when clients send requests to a backend service, delays can be
8320 # introduced by a load balancer on a percentage of requests before sending
8321 # those requests to the backend service. Similarly requests from clients can
8322 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
8323 # that are configured with a fault_injection_policy if:
8324 # 1. The traffic is generated by fault injection AND
8325 # 2. The fault injection is not a delay fault injection.
8326 # Fault injection is not supported with the classic Application Load Balancer
8327 # . To see which load balancers support fault injection,
8328 # see Load
8329 # balancing: Routing and traffic management features.
8330 # the resiliency of clients to backend service failure. As part of fault
8331 # injection, when clients send requests to a backend service, delays can be
8332 # introduced by the load balancer on a percentage of requests before sending
8333 # those request to the backend service. Similarly requests from clients can be
8334 # aborted by the load balancer for a percentage of requests.
8335 &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
8336 # injection.
8337 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
8338 #
8339 # The value must be from 200 to 599 inclusive.
8340 #
8341 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
8342 # according to this
8343 # mapping table. HTTP status 200 is mapped to gRPC status
8344 # UNKNOWN. Injecting an OK status is currently not supported by
8345 # Traffic Director.
8346 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
8347 # that is aborted as part of fault injection.
8348 #
8349 # The value must be from 0.0 to 100.0 inclusive.
8350 },
8351 &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
8352 # injection, before being sent to a backend service.
8353 # request to the backend service as part of fault injection.
8354 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
8355 # as a count of seconds and fractions of seconds at nanosecond
8356 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8357 # or &quot;month&quot;. Range is approximately 10,000 years.
8358 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8359 # Durations less than one second are represented with a 0
8360 # `seconds` field and a positive `nanos` field. Must be from 0
8361 # to 999,999,999 inclusive.
8362 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8363 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8364 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8365 },
8366 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
8367 # which a delay is introduced as part of fault injection.
8368 #
8369 # The value must be from 0.0 to 100.0 inclusive.
8370 },
8371 },
8372 &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
8373 # Global EXTERNAL_MANAGED load balancer schemes.
8374 # Either Cloud CDN must be enabled on the backend service or backend bucket
8375 # serving the route, or cache policy must be configured on the same route
8376 # dynamically processes and delivers images from the network edge.
8377 # Image Optimization is only available for Global External Application Load
8378 # Balancers.
8379 # Either Cloud CDN must be enabled on the backend service or backend bucket
8380 # serving the route, or cache policy must be configured on the same route.
8381 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
8382 },
8383 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
8384 # Unlike the timeout field where the timeout duration starts
8385 # from the time the request has been fully processed (known as*end-of-stream*),
8386 # the duration in this field is computed from the beginning of the stream
8387 # until the response has been processed, including all retries. A
8388 # stream that does not complete in this duration is closed.
8389 #
8390 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
8391 # with the route.
8392 #
8393 # This field is only allowed if the Url map is used with backend services
8394 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
8395 # as a count of seconds and fractions of seconds at nanosecond
8396 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8397 # or &quot;month&quot;. Range is approximately 10,000 years.
8398 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8399 # Durations less than one second are represented with a 0
8400 # `seconds` field and a positive `nanos` field. Must be from 0
8401 # to 999,999,999 inclusive.
8402 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8403 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8404 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8405 },
8406 &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
8407 # are shadowed to a separate mirrored backend service. The load balancer does
8408 # not wait for responses from the shadow service. Before sending traffic
8409 # to the shadow service, the host / authority header is suffixed with-shadow.
8410 #
8411 # Not supported when the URL map is bound to a target gRPC proxy that
8412 # has the validateForProxyless field set to true.
8413 # are shadowed to a separate mirrored backend service. The load balancer
8414 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
8415 # to the shadow service, the host or authority header is suffixed with-shadow.
8416 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
8417 # mirrored to.
8418 #
8419 # The backend service configured for a mirroring
8420 # policy must reference backends that are of the same type as the original
8421 # backend service matched in the URL map.
8422 #
8423 # Serverless NEG backends are not currently supported as a mirrored
8424 # backend service.
8425 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
8426 },
8427 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
8428 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
8429 # If not specified, defaults to 1.
8430 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
8431 #
8432 # If not specified, will use the timeout set in theHttpRouteAction field.
8433 # If timeout in the HttpRouteAction field is not set, this field
8434 # uses the largest timeout
8435 # among all backend services associated with the route.
8436 #
8437 # Not supported when the URL map is bound to a target gRPC proxy that
8438 # has the validateForProxyless field set to true.
8439 # as a count of seconds and fractions of seconds at nanosecond
8440 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8441 # or &quot;month&quot;. Range is approximately 10,000 years.
8442 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8443 # Durations less than one second are represented with a 0
8444 # `seconds` field and a positive `nanos` field. Must be from 0
8445 # to 999,999,999 inclusive.
8446 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8447 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8448 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8449 },
8450 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
8451 # values are:
8452 #
8453 # - 5xx: retry is attempted if the instance or endpoint
8454 # responds with any 5xx response code, or if the instance or
8455 # endpoint does not respond at all. For example, disconnects, reset, read
8456 # timeout, connection failure, and refused streams.
8457 # - gateway-error: Similar to 5xx, but only
8458 # applies to response codes 502, 503 or504.
8459 # - connect-failure: a retry is attempted on failures
8460 # connecting to the instance or endpoint. For example, connection
8461 # timeouts.
8462 # - retriable-4xx: a retry is attempted if the instance
8463 # or endpoint responds with a 4xx response code.
8464 # The only error that you can retry is error code 409.
8465 # - refused-stream: a retry is attempted if the instance
8466 # or endpoint resets the stream with a REFUSED_STREAM error
8467 # code. This reset type indicates that it is safe to retry.
8468 # - cancelled: a retry is attempted if the gRPC status
8469 # code in the response header is set to cancelled.
8470 # - deadline-exceeded: a retry is attempted if the gRPC
8471 # status code in the response header is set todeadline-exceeded.
8472 # - internal: a retry is attempted if the gRPC
8473 # status code in the response header is set tointernal.
8474 # - resource-exhausted: a retry is attempted if the gRPC
8475 # status code in the response header is set toresource-exhausted.
8476 # - unavailable: a retry is attempted if the gRPC
8477 # status code in the response header is set tounavailable.
8478 #
8479 # Only the following codes are supported when the URL map is bound to
8480 # target gRPC proxy that has validateForProxyless field set to true.
8481 #
8482 # - cancelled
8483 # - deadline-exceeded
8484 # - internal
8485 # - resource-exhausted
8486 # - unavailable
8487 &quot;A String&quot;,
8488 ],
8489 },
8490 &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
8491 # time the request has been fully processed (known as *end-of-stream*)
8492 # up until the response has been processed. Timeout includes
8493 # all retries.
8494 #
8495 # If not specified, this field uses the largest timeout among all backend
8496 # services associated with the route.
8497 #
8498 # Not supported when the URL map is bound to a target gRPC proxy that
8499 # has validateForProxyless field set to true.
8500 # as a count of seconds and fractions of seconds at nanosecond
8501 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8502 # or &quot;month&quot;. Range is approximately 10,000 years.
8503 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8504 # Durations less than one second are represented with a 0
8505 # `seconds` field and a positive `nanos` field. Must be from 0
8506 # to 999,999,999 inclusive.
8507 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8508 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8509 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8510 },
8511 &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
8512 # to the matched service.
8513 #
8514 # urlRewrite is the only action supported in UrlMaps
8515 # for classic Application Load Balancers.
8516 #
8517 # Not supported when the URL map is bound to a target gRPC proxy that
8518 # has the validateForProxyless field set to true.
8519 # backend service.
8520 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
8521 # host header is replaced with contents of hostRewrite.
8522 #
8523 # The value must be from 1 to 255 characters.
8524 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
8525 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
8526 #
8527 # The value must be from 1 to 1024 characters.
8528 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
8529 # header) using the HTTP template syntax.
8530 #
8531 # A corresponding
8532 # path_template_match must be specified. Any template variables must exist in
8533 # the path_template_match field.
8534 #
8535 #
8536 # - -At least one variable must be specified in the path_template_match
8537 # field
8538 # - You can omit variables from the rewritten URL
8539 # - The * and ** operators cannot be matched
8540 # unless they have a corresponding variable name - e.g.
8541 # {format=*} or {var=**}.
8542 #
8543 # For example, a path_template_match of /static/{format=**}
8544 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
8545 # rewrite, so that /{country}/{format}/{suffix=**} can be
8546 # rewritten as /content/{format}/{country}/{suffix}.
8547 #
8548 # At least
8549 # one non-empty routeRules[].matchRules[].path_template_match is
8550 # required.
8551 #
8552 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
8553 },
8554 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
8555 # occurs. The weights determine the fraction of traffic that flows to
8556 # their corresponding backend service. If all traffic needs to
8557 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
8558 #
8559 # After a backend service is identified and before forwarding
8560 # the request to
8561 # the backend service, advanced routing actions such as URL rewrites and
8562 # header transformations are applied depending on additional settings
8563 # specified in this HttpRouteAction.
8564 { # In contrast to a single BackendService in
8565 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
8566 # multiple backend services. The volume of traffic for each
8567 # backend service is proportional to the weight specified
8568 # in each WeightedBackendService
8569 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
8570 # resource. Before
8571 # forwarding the request to backendService, the load balancer
8572 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
8573 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
8574 # effect for the selected backendService.
8575 #
8576 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
8577 #
8578 # headerAction is not supported for load balancers that have
8579 # their loadBalancingScheme set to EXTERNAL.
8580 #
8581 # Not supported when the URL map is bound to a target gRPC proxy that
8582 # has validateForProxyless field set to true.
8583 # the request is passed along to the selected backendService.
8584 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
8585 { # Specification determining how headers are added to requests or responses.
8586 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
8587 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
8588 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
8589 # that already
8590 # exist for the header. If true, headerValue is set for the
8591 # header, discarding any values that were set for that header.
8592 #
8593 # The default value is true,
8594 # unless a variable is present in headerValue,
8595 # in which case the default value is false.
8596 # .
8597 },
8598 ],
8599 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
8600 # request before forwarding the request to the backendService.
8601 &quot;A String&quot;,
8602 ],
8603 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
8604 # client.
8605 { # Specification determining how headers are added to requests or responses.
8606 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
8607 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
8608 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
8609 # that already
8610 # exist for the header. If true, headerValue is set for the
8611 # header, discarding any values that were set for that header.
8612 #
8613 # The default value is true,
8614 # unless a variable is present in headerValue,
8615 # in which case the default value is false.
8616 # .
8617 },
8618 ],
8619 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
8620 # response before sending the response back to the client.
8621 &quot;A String&quot;,
8622 ],
8623 },
8624 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
8625 # computed asweight / (sum of all weightedBackendService weights in routeAction).
8626 #
8627 # The selection of a backend service is determined only for new traffic.
8628 # Once a user&#x27;s request has been directed to a backend service,
8629 # subsequent requests are sent to the same backend service as
8630 # determined by the backend service&#x27;s session affinity policy.
8631 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
8632 # splitting. If you do, the weighted traffic splitting configuration takes
8633 # precedence.
8634 #
8635 # The value must be from 0 to 1000.
8636 },
8637 ],
8638 },
8639 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL of the defaultService resource to
8640 # which traffic is directed if none of the hostRules match.
8641 # If defaultRouteAction is also specified, advanced
8642 # routing actions, such as URL rewrites, take effect before sending the
8643 # request to the backend.
8644 #
8645 #
8646 # Only one of defaultUrlRedirect, defaultService
8647 # or defaultRouteAction.weightedBackendService can be set.
8648 #
8649 #
8650 # defaultService has no effect when the URL map is bound
8651 # to a target gRPC proxy that has the validateForProxyless field
8652 # set to true.
8653 &quot;defaultUrlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
8654 # is redirected to a URL specified by defaultUrlRedirect.
8655 #
8656 #
8657 # Only one of defaultUrlRedirect, defaultService
8658 # or defaultRouteAction.weightedBackendService can be set.
8659 #
8660 #
8661 # Not supported when the URL map is bound to a target gRPC proxy.
8662 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
8663 # was supplied in the request.
8664 #
8665 # The value must be from 1 to 255
8666 # characters.
8667 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
8668 # set to HTTPS.
8669 # If set to false, the URL scheme of the redirected request
8670 # remains the same as that of the request.
8671 #
8672 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
8673 #
8674 # The default is set to false.
8675 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
8676 # that was supplied in the request.
8677 #
8678 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
8679 # supplied, the path of the original request is used for the redirect.
8680 #
8681 # The value must be from 1 to 1024 characters.
8682 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
8683 # the HttpRouteRuleMatch, retaining the remaining portion
8684 # of the URL before redirecting the request.
8685 #
8686 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
8687 # supplied, the path of the original request is used for the redirect.
8688 #
8689 # The value must be from 1 to 1024 characters.
8690 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
8691 #
8692 # Supported values are:
8693 #
8694 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
8695 # to 301.
8696 # - FOUND, which corresponds to 302.
8697 # - SEE_OTHER which corresponds to 303.
8698 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
8699 # method is retained.
8700 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
8701 # method is retained.
8702 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
8703 # URL is
8704 # removed before redirecting the request. If set to false, the
8705 # query portion of the original URL is retained.
8706 #
8707 # The default is set to false.
8708 },
8709 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
8710 # create the resource.
8711 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. A hash of the contents stored in this object.
8712 # This field is used in optimistic locking. This field is ignored when
8713 # inserting a UrlMap. An up-to-date fingerprint must be provided
8714 # in order to update the UrlMap, otherwise the request will
8715 # fail with error 412 conditionNotMet.
8716 #
8717 # To see the latest fingerprint, make a get() request to
8718 # retrieve a UrlMap.
8719 &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
8720 # for the selected backendService.
8721 #
8722 # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
8723 #
8724 # headerAction is not supported for load balancers
8725 # that have
8726 # their loadBalancingScheme set to EXTERNAL.
8727 #
8728 # Not supported when the URL map is bound to a target gRPC proxy that
8729 # has validateForProxyless field set to true.
8730 # the request is passed along to the selected backendService.
8731 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
8732 { # Specification determining how headers are added to requests or responses.
8733 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
8734 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
8735 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
8736 # that already
8737 # exist for the header. If true, headerValue is set for the
8738 # header, discarding any values that were set for that header.
8739 #
8740 # The default value is true,
8741 # unless a variable is present in headerValue,
8742 # in which case the default value is false.
8743 # .
8744 },
8745 ],
8746 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
8747 # request before forwarding the request to the backendService.
8748 &quot;A String&quot;,
8749 ],
8750 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
8751 # client.
8752 { # Specification determining how headers are added to requests or responses.
8753 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
8754 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
8755 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
8756 # that already
8757 # exist for the header. If true, headerValue is set for the
8758 # header, discarding any values that were set for that header.
8759 #
8760 # The default value is true,
8761 # unless a variable is present in headerValue,
8762 # in which case the default value is false.
8763 # .
8764 },
8765 ],
8766 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
8767 # response before sending the response back to the client.
8768 &quot;A String&quot;,
8769 ],
8770 },
8771 &quot;hostRules&quot;: [ # The list of host rules to use against the URL.
8772 { # UrlMaps
8773 # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
8774 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
8775 # create the resource.
8776 &quot;hosts&quot;: [ # The list of host patterns to match. They must be valid hostnames with
8777 # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
8778 # that case, * must be the first character, and if followed by
8779 # anything, the immediate following character must be either -
8780 # or ..
8781 #
8782 # * based matching is not supported when the URL map is bound
8783 # to a target gRPC proxy that has the validateForProxyless field
8784 # set to true.
8785 &quot;A String&quot;,
8786 ],
8787 &quot;pathMatcher&quot;: &quot;A String&quot;, # The name of the PathMatcher to use to match the path portion
8788 # of the URL if the hostRule matches the URL&#x27;s host portion.
8789 },
8790 ],
8791 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the resource. This identifier is
8792 # defined by the server.
8793 &quot;kind&quot;: &quot;compute#urlMap&quot;, # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
8794 # url maps.
8795 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
8796 # The name must be 1-63 characters long, and comply withRFC1035.
8797 # Specifically, the name must be 1-63 characters long and match the regular
8798 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
8799 # character must be a lowercase letter, and all following characters must
8800 # be a dash, lowercase letter, or digit, except the last character, which
8801 # cannot be a dash.
8802 &quot;pathMatchers&quot;: [ # The list of named PathMatchers to use against the URL.
8803 { # A matcher for the path portion of the URL. The BackendService
8804 # from the longest-matched rule will serve the URL. If no rule was matched, the
8805 # default service is used.
8806 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
8807 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
8808 #
8809 # This policy takes
8810 # effect at the PathMatcher level and applies only when no
8811 # 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
8812 # in defaultCustomErrorResponsePolicy, then a policy defined for
8813 # the error code in UrlMap.defaultCustomErrorResponsePolicy
8814 # takes effect.
8815 #
8816 # For example, consider a UrlMap with the following
8817 # configuration:
8818 #
8819 #
8820 # - UrlMap.defaultCustomErrorResponsePolicy is configured
8821 # with policies for 5xx and 4xx errors
8822 # - A RouteRule for /coming_soon/ is configured for the
8823 # error code 404.
8824 #
8825 # 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
8826 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
8827 # the policy in RouteRule.customErrorResponsePolicy takes
8828 # effect. If any of the requests in this example encounter a 500
8829 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
8830 #
8831 # When
8832 # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
8833 # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
8834 # a retry, if load balancer is successful in reaching the
8835 # service, the defaultCustomErrorResponsePolicy is ignored and
8836 # the response from the service is returned to the client.
8837 #
8838 # defaultCustomErrorResponsePolicy is supported only for
8839 # global external Application Load Balancers.
8840 # backend service or backend bucket responds with an error.
8841 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
8842 #
8843 # In a given policy, if you specify rules for both a range of error codes
8844 # as well as rules for specific error codes then rules with specific error
8845 # codes have a higher priority. For example, assume that you configure a rule
8846 # for 401 (Un-authorized) code, and another for all 4 series
8847 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
8848 # However if the backend service returns a 403, the rule for4xx takes effect.
8849 { # Specifies the mapping between the response code that will be returned along
8850 # with the custom error content and the response code returned by the backend
8851 # service.
8852 &quot;matchResponseCodes&quot;: [ # Valid values include:
8853 #
8854 #
8855 # - A number between 400 and 599: For example
8856 # 401 or 503, in which case the load balancer
8857 # applies the policy if the error code exactly matches this value.
8858 # - 5xx: Load Balancer will apply the policy if the
8859 # backend service responds with any response code in the range of
8860 # 500 to 599.
8861 # - 4xx: Load
8862 # Balancer will apply the policy if the backend service responds with any
8863 # response code in the range of 400 to
8864 # 499.
8865 #
8866 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
8867 &quot;A String&quot;,
8868 ],
8869 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
8870 # error content. If overrideResponseCode is not supplied, the
8871 # same response code returned by the original backend bucket or backend
8872 # service is returned to the client.
8873 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
8874 #
8875 # path must start
8876 # with a leading slash. path cannot have trailing slashes.
8877 #
8878 # If the file is not available in backendBucket or the
8879 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
8880 #
8881 # The value must
8882 # be from 1 to 1024 characters
8883 },
8884 ],
8885 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
8886 # contains the custom error content. Examples are:
8887 #
8888 #
8889 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
8890 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
8891 # - global/backendBuckets/myBackendBucket
8892 #
8893 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
8894 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
8895 #
8896 # If load balancer cannot reach
8897 # the backendBucket, a simple Not Found Error will
8898 # be returned, with the original response code (oroverrideResponseCode if configured).
8899 #
8900 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
8901 },
8902 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
8903 # pathRules or routeRules match. The load balancer
8904 # performs advanced routing actions, such as URL rewrites and
8905 # header transformations, before forwarding the request to the
8906 # selected backend.
8907 #
8908 #
8909 # Only one of defaultUrlRedirect, defaultService
8910 # or defaultRouteAction.weightedBackendService can be set.
8911 #
8912 #
8913 # URL maps for classic Application Load Balancers only support
8914 # the urlRewrite action within a path matcher&#x27;sdefaultRouteAction.
8915 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
8916 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
8917 # property must be specified. This policy cannot be specified if any target
8918 # backend has Identity-Aware Proxy enabled.
8919 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
8920 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
8921 # header names can be specified. The cache is bypassed for all `cacheMode`
8922 # values.
8923 &quot;A String&quot;,
8924 ],
8925 &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
8926 # on the backend type: for Backend Services, the complete request URI is
8927 # used; for Backend Buckets, the request URI is used without the protocol or
8928 # host, and only query parameters known to Cloud Storage are included.
8929 # Policy defined on Route Action.
8930 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
8931 # parameters will be included. Either specify `excludedQueryParameters`
8932 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
8933 # encoded and not treated as delimiters.
8934 #
8935 # Note: This field applies to routes that use backend services. Attempting
8936 # to set it on a route that points exclusively to Backend Buckets will
8937 # result in a configuration error. For routes that point to a Backend
8938 # Bucket, use `includedQueryParameters` to define which parameters should
8939 # be part of the cache key.
8940 &quot;A String&quot;,
8941 ],
8942 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
8943 #
8944 # Note: This setting is only applicable to routes that use a Backend
8945 # Service. It does not affect requests served by a Backend Bucket, as the
8946 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
8947 # it on a route that points exclusively to Backend Buckets will result in a
8948 # configuration error.
8949 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
8950 #
8951 # Note: This setting is only applicable to routes that use a Backend
8952 # Service. It does not affect requests served by a Backend Bucket, as the
8953 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
8954 # set on a route that points exclusively to Backend Buckets will result in
8955 # a configuration error.
8956 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
8957 # `includedQueryParameters` and `excludedQueryParameters`. If neither
8958 # is set, the entire query string will be included. If false, the query
8959 # string will be excluded from the cache key entirely.
8960 #
8961 # Note: This field applies to routes that use backend services. Attempting
8962 # to set it on a route that points exclusively to Backend Buckets will
8963 # result in a configuration error. For routes that point to a Backend
8964 # Bucket, use `includedQueryParameters` to define which parameters should
8965 # be part of the cache key.
8966 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
8967 # The name=value pair will be used in the cache key Cloud CDN generates.
8968 #
8969 # Note: This setting is only applicable to routes that use a Backend
8970 # Service. It does not affect requests served by a Backend Bucket.
8971 # Attempting to set it on a route that points exclusively to Backend
8972 # Buckets will result in a configuration error. Up to 5 cookie names can be
8973 # specified.
8974 &quot;A String&quot;,
8975 ],
8976 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
8977 &quot;A String&quot;,
8978 ],
8979 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
8980 # parameters will be excluded. Either specify `includedQueryParameters`
8981 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
8982 # encoded and not treated as delimiters.
8983 &quot;A String&quot;,
8984 ],
8985 },
8986 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
8987 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
8988 &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
8989 # content. This is used to clamp the max-age (or Expires) value sent to the
8990 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
8991 # is used for the response max-age directive, along with a &quot;public&quot;
8992 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
8993 # clamps the max-age from the origin (if specified), or else sets the
8994 # response max-age directive to the lesser of the `clientTtl` and
8995 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
8996 # present. The maximum allowed value is 31,622,400s (1 year). If not
8997 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
8998 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
8999 # `USE_ORIGIN_HEADERS`.
9000 # as a count of seconds and fractions of seconds at nanosecond
9001 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9002 # or &quot;month&quot;. Range is approximately 10,000 years.
9003 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9004 # Durations less than one second are represented with a 0
9005 # `seconds` field and a positive `nanos` field. Must be from 0
9006 # to 999,999,999 inclusive.
9007 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9008 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9009 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9010 },
9011 &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
9012 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
9013 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
9014 # greater than that of `maxTtl`. When the `cacheMode` is set to
9015 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
9016 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
9017 # accessed objects may be evicted from the cache before the defined TTL. If
9018 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
9019 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
9020 # `USE_ORIGIN_HEADERS`.
9021 # as a count of seconds and fractions of seconds at nanosecond
9022 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9023 # or &quot;month&quot;. Range is approximately 10,000 years.
9024 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9025 # Durations less than one second are represented with a 0
9026 # `seconds` field and a positive `nanos` field. Must be from 0
9027 # to 999,999,999 inclusive.
9028 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9029 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9030 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9031 },
9032 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
9033 # attempt to set a max-age or s-maxage higher than this, or an Expires header
9034 # more than `maxTtl` seconds in the future will be capped at the value of
9035 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
9036 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
9037 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
9038 # Infrequently accessed objects may be evicted from the cache before the
9039 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
9040 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
9041 # mode.
9042 # as a count of seconds and fractions of seconds at nanosecond
9043 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9044 # or &quot;month&quot;. Range is approximately 10,000 years.
9045 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9046 # Durations less than one second are represented with a 0
9047 # `seconds` field and a positive `nanos` field. Must be from 0
9048 # to 999,999,999 inclusive.
9049 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9050 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9051 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9052 },
9053 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
9054 # to apply fine-grained caching for common errors or redirects.
9055 # This can reduce the load on your origin and improve end-user
9056 # experience by reducing response latency.
9057 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
9058 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
9059 # the specified response code that lack any Cache-Control, Expires, or
9060 # Pragma: no-cache directives. When the `cacheMode` is set to
9061 # `FORCE_CACHE_ALL`, negative caching applies to all responses
9062 # with the specified response code, and overrides any caching headers. By
9063 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
9064 #
9065 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
9066 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
9067 # * 405 (Method Not Found), 501 (Not Implemented): 60s
9068 #
9069 # These defaults can be overridden in `negativeCachingPolicy`.
9070 # If not specified, Cloud CDN applies negative caching by default.
9071 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
9072 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
9073 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
9074 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
9075 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
9076 # all response codes that you wish to cache. Cloud CDN will not apply any
9077 # default negative caching when a policy exists.
9078 { # Specify CDN TTLs for response error codes.
9079 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
9080 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
9081 # specified as values, and you cannot specify a status code more than
9082 # once.
9083 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
9084 # corresponding status code.
9085 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
9086 # objects may be evicted from the cache before the defined TTL.
9087 # as a count of seconds and fractions of seconds at nanosecond
9088 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9089 # or &quot;month&quot;. Range is approximately 10,000 years.
9090 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9091 # Durations less than one second are represented with a 0
9092 # `seconds` field and a positive `nanos` field. Must be from 0
9093 # to 999,999,999 inclusive.
9094 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9095 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9096 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9097 },
9098 },
9099 ],
9100 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
9101 # requests into a small number of requests to the origin. If not specified,
9102 # Cloud CDN applies request coalescing by default.
9103 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
9104 # content with the origin, or when an error is encountered when refreshing
9105 # the cache.
9106 # This setting defines the default &quot;max-stale&quot; duration for any cached
9107 # responses that do not specify a max-stale directive. Stale responses that
9108 # exceed the TTL configured here will not be served. The default limit
9109 # (max-stale) is 86400s (1 day), which will allow stale content to be
9110 # served up to this limit beyond the max-age (or s-maxage) of a cached
9111 # response.
9112 # The maximum allowed value is 604800 (1 week).
9113 # Set this to zero (0) to disable serve-while-stale.
9114 # as a count of seconds and fractions of seconds at nanosecond
9115 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9116 # or &quot;month&quot;. Range is approximately 10,000 years.
9117 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9118 # Durations less than one second are represented with a 0
9119 # `seconds` field and a positive `nanos` field. Must be from 0
9120 # to 999,999,999 inclusive.
9121 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9122 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9123 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9124 },
9125 },
9126 &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
9127 # information about the W3C recommendation for cross-origin resource sharing
9128 # (CORS), see Fetch API Living
9129 # Standard.
9130 #
9131 # Not supported when the URL map is bound to a target gRPC proxy.
9132 # information about the W3C recommendation for cross-origin resource sharing
9133 # (CORS), see Fetch API Living
9134 # Standard.
9135 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
9136 # indicates that
9137 # the actual request can include user credentials. This field translates to
9138 # the Access-Control-Allow-Credentials header.
9139 #
9140 # Default is false.
9141 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
9142 # header.
9143 &quot;A String&quot;,
9144 ],
9145 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
9146 # header.
9147 &quot;A String&quot;,
9148 ],
9149 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
9150 # more information, see regular expression syntax.
9151 #
9152 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
9153 #
9154 # Regular expressions can only be used when the loadBalancingScheme is
9155 # set to INTERNAL_SELF_MANAGED.
9156 &quot;A String&quot;,
9157 ],
9158 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
9159 #
9160 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
9161 &quot;A String&quot;,
9162 ],
9163 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
9164 # The default value is false, which indicates that the CORS
9165 # policy is in effect.
9166 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
9167 # header.
9168 &quot;A String&quot;,
9169 ],
9170 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
9171 # seconds. This field translates to the Access-Control-Max-Age
9172 # header.
9173 },
9174 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
9175 # the resiliency of clients to backend service failure. As part of fault
9176 # injection, when clients send requests to a backend service, delays can be
9177 # introduced by a load balancer on a percentage of requests before sending
9178 # those requests to the backend service. Similarly requests from clients can
9179 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
9180 # that are configured with a fault_injection_policy if:
9181 # 1. The traffic is generated by fault injection AND
9182 # 2. The fault injection is not a delay fault injection.
9183 # Fault injection is not supported with the classic Application Load Balancer
9184 # . To see which load balancers support fault injection,
9185 # see Load
9186 # balancing: Routing and traffic management features.
9187 # the resiliency of clients to backend service failure. As part of fault
9188 # injection, when clients send requests to a backend service, delays can be
9189 # introduced by the load balancer on a percentage of requests before sending
9190 # those request to the backend service. Similarly requests from clients can be
9191 # aborted by the load balancer for a percentage of requests.
9192 &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
9193 # injection.
9194 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
9195 #
9196 # The value must be from 200 to 599 inclusive.
9197 #
9198 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
9199 # according to this
9200 # mapping table. HTTP status 200 is mapped to gRPC status
9201 # UNKNOWN. Injecting an OK status is currently not supported by
9202 # Traffic Director.
9203 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
9204 # that is aborted as part of fault injection.
9205 #
9206 # The value must be from 0.0 to 100.0 inclusive.
9207 },
9208 &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
9209 # injection, before being sent to a backend service.
9210 # request to the backend service as part of fault injection.
9211 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
9212 # as a count of seconds and fractions of seconds at nanosecond
9213 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9214 # or &quot;month&quot;. Range is approximately 10,000 years.
9215 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9216 # Durations less than one second are represented with a 0
9217 # `seconds` field and a positive `nanos` field. Must be from 0
9218 # to 999,999,999 inclusive.
9219 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9220 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9221 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9222 },
9223 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
9224 # which a delay is introduced as part of fault injection.
9225 #
9226 # The value must be from 0.0 to 100.0 inclusive.
9227 },
9228 },
9229 &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
9230 # Global EXTERNAL_MANAGED load balancer schemes.
9231 # Either Cloud CDN must be enabled on the backend service or backend bucket
9232 # serving the route, or cache policy must be configured on the same route
9233 # dynamically processes and delivers images from the network edge.
9234 # Image Optimization is only available for Global External Application Load
9235 # Balancers.
9236 # Either Cloud CDN must be enabled on the backend service or backend bucket
9237 # serving the route, or cache policy must be configured on the same route.
9238 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
9239 },
9240 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
9241 # Unlike the timeout field where the timeout duration starts
9242 # from the time the request has been fully processed (known as*end-of-stream*),
9243 # the duration in this field is computed from the beginning of the stream
9244 # until the response has been processed, including all retries. A
9245 # stream that does not complete in this duration is closed.
9246 #
9247 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
9248 # with the route.
9249 #
9250 # This field is only allowed if the Url map is used with backend services
9251 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
9252 # as a count of seconds and fractions of seconds at nanosecond
9253 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9254 # or &quot;month&quot;. Range is approximately 10,000 years.
9255 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9256 # Durations less than one second are represented with a 0
9257 # `seconds` field and a positive `nanos` field. Must be from 0
9258 # to 999,999,999 inclusive.
9259 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9260 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9261 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9262 },
9263 &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
9264 # are shadowed to a separate mirrored backend service. The load balancer does
9265 # not wait for responses from the shadow service. Before sending traffic
9266 # to the shadow service, the host / authority header is suffixed with-shadow.
9267 #
9268 # Not supported when the URL map is bound to a target gRPC proxy that
9269 # has the validateForProxyless field set to true.
9270 # are shadowed to a separate mirrored backend service. The load balancer
9271 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
9272 # to the shadow service, the host or authority header is suffixed with-shadow.
9273 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
9274 # mirrored to.
9275 #
9276 # The backend service configured for a mirroring
9277 # policy must reference backends that are of the same type as the original
9278 # backend service matched in the URL map.
9279 #
9280 # Serverless NEG backends are not currently supported as a mirrored
9281 # backend service.
9282 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
9283 },
9284 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
9285 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
9286 # If not specified, defaults to 1.
9287 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
9288 #
9289 # If not specified, will use the timeout set in theHttpRouteAction field.
9290 # If timeout in the HttpRouteAction field is not set, this field
9291 # uses the largest timeout
9292 # among all backend services associated with the route.
9293 #
9294 # Not supported when the URL map is bound to a target gRPC proxy that
9295 # has the validateForProxyless field set to true.
9296 # as a count of seconds and fractions of seconds at nanosecond
9297 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9298 # or &quot;month&quot;. Range is approximately 10,000 years.
9299 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9300 # Durations less than one second are represented with a 0
9301 # `seconds` field and a positive `nanos` field. Must be from 0
9302 # to 999,999,999 inclusive.
9303 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9304 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9305 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9306 },
9307 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
9308 # values are:
9309 #
9310 # - 5xx: retry is attempted if the instance or endpoint
9311 # responds with any 5xx response code, or if the instance or
9312 # endpoint does not respond at all. For example, disconnects, reset, read
9313 # timeout, connection failure, and refused streams.
9314 # - gateway-error: Similar to 5xx, but only
9315 # applies to response codes 502, 503 or504.
9316 # - connect-failure: a retry is attempted on failures
9317 # connecting to the instance or endpoint. For example, connection
9318 # timeouts.
9319 # - retriable-4xx: a retry is attempted if the instance
9320 # or endpoint responds with a 4xx response code.
9321 # The only error that you can retry is error code 409.
9322 # - refused-stream: a retry is attempted if the instance
9323 # or endpoint resets the stream with a REFUSED_STREAM error
9324 # code. This reset type indicates that it is safe to retry.
9325 # - cancelled: a retry is attempted if the gRPC status
9326 # code in the response header is set to cancelled.
9327 # - deadline-exceeded: a retry is attempted if the gRPC
9328 # status code in the response header is set todeadline-exceeded.
9329 # - internal: a retry is attempted if the gRPC
9330 # status code in the response header is set tointernal.
9331 # - resource-exhausted: a retry is attempted if the gRPC
9332 # status code in the response header is set toresource-exhausted.
9333 # - unavailable: a retry is attempted if the gRPC
9334 # status code in the response header is set tounavailable.
9335 #
9336 # Only the following codes are supported when the URL map is bound to
9337 # target gRPC proxy that has validateForProxyless field set to true.
9338 #
9339 # - cancelled
9340 # - deadline-exceeded
9341 # - internal
9342 # - resource-exhausted
9343 # - unavailable
9344 &quot;A String&quot;,
9345 ],
9346 },
9347 &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
9348 # time the request has been fully processed (known as *end-of-stream*)
9349 # up until the response has been processed. Timeout includes
9350 # all retries.
9351 #
9352 # If not specified, this field uses the largest timeout among all backend
9353 # services associated with the route.
9354 #
9355 # Not supported when the URL map is bound to a target gRPC proxy that
9356 # has validateForProxyless field set to true.
9357 # as a count of seconds and fractions of seconds at nanosecond
9358 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9359 # or &quot;month&quot;. Range is approximately 10,000 years.
9360 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9361 # Durations less than one second are represented with a 0
9362 # `seconds` field and a positive `nanos` field. Must be from 0
9363 # to 999,999,999 inclusive.
9364 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9365 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9366 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9367 },
9368 &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
9369 # to the matched service.
9370 #
9371 # urlRewrite is the only action supported in UrlMaps
9372 # for classic Application Load Balancers.
9373 #
9374 # Not supported when the URL map is bound to a target gRPC proxy that
9375 # has the validateForProxyless field set to true.
9376 # backend service.
9377 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
9378 # host header is replaced with contents of hostRewrite.
9379 #
9380 # The value must be from 1 to 255 characters.
9381 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
9382 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
9383 #
9384 # The value must be from 1 to 1024 characters.
9385 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
9386 # header) using the HTTP template syntax.
9387 #
9388 # A corresponding
9389 # path_template_match must be specified. Any template variables must exist in
9390 # the path_template_match field.
9391 #
9392 #
9393 # - -At least one variable must be specified in the path_template_match
9394 # field
9395 # - You can omit variables from the rewritten URL
9396 # - The * and ** operators cannot be matched
9397 # unless they have a corresponding variable name - e.g.
9398 # {format=*} or {var=**}.
9399 #
9400 # For example, a path_template_match of /static/{format=**}
9401 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
9402 # rewrite, so that /{country}/{format}/{suffix=**} can be
9403 # rewritten as /content/{format}/{country}/{suffix}.
9404 #
9405 # At least
9406 # one non-empty routeRules[].matchRules[].path_template_match is
9407 # required.
9408 #
9409 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
9410 },
9411 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
9412 # occurs. The weights determine the fraction of traffic that flows to
9413 # their corresponding backend service. If all traffic needs to
9414 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
9415 #
9416 # After a backend service is identified and before forwarding
9417 # the request to
9418 # the backend service, advanced routing actions such as URL rewrites and
9419 # header transformations are applied depending on additional settings
9420 # specified in this HttpRouteAction.
9421 { # In contrast to a single BackendService in
9422 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
9423 # multiple backend services. The volume of traffic for each
9424 # backend service is proportional to the weight specified
9425 # in each WeightedBackendService
9426 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
9427 # resource. Before
9428 # forwarding the request to backendService, the load balancer
9429 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
9430 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
9431 # effect for the selected backendService.
9432 #
9433 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
9434 #
9435 # headerAction is not supported for load balancers that have
9436 # their loadBalancingScheme set to EXTERNAL.
9437 #
9438 # Not supported when the URL map is bound to a target gRPC proxy that
9439 # has validateForProxyless field set to true.
9440 # the request is passed along to the selected backendService.
9441 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
9442 { # Specification determining how headers are added to requests or responses.
9443 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
9444 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
9445 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
9446 # that already
9447 # exist for the header. If true, headerValue is set for the
9448 # header, discarding any values that were set for that header.
9449 #
9450 # The default value is true,
9451 # unless a variable is present in headerValue,
9452 # in which case the default value is false.
9453 # .
9454 },
9455 ],
9456 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
9457 # request before forwarding the request to the backendService.
9458 &quot;A String&quot;,
9459 ],
9460 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
9461 # client.
9462 { # Specification determining how headers are added to requests or responses.
9463 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
9464 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
9465 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
9466 # that already
9467 # exist for the header. If true, headerValue is set for the
9468 # header, discarding any values that were set for that header.
9469 #
9470 # The default value is true,
9471 # unless a variable is present in headerValue,
9472 # in which case the default value is false.
9473 # .
9474 },
9475 ],
9476 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
9477 # response before sending the response back to the client.
9478 &quot;A String&quot;,
9479 ],
9480 },
9481 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
9482 # computed asweight / (sum of all weightedBackendService weights in routeAction).
9483 #
9484 # The selection of a backend service is determined only for new traffic.
9485 # Once a user&#x27;s request has been directed to a backend service,
9486 # subsequent requests are sent to the same backend service as
9487 # determined by the backend service&#x27;s session affinity policy.
9488 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
9489 # splitting. If you do, the weighted traffic splitting configuration takes
9490 # precedence.
9491 #
9492 # The value must be from 0 to 1000.
9493 },
9494 ],
9495 },
9496 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource. This
9497 # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
9498 # matched. For example, the
9499 # following are all valid URLs to a BackendService resource:
9500 #
9501 #
9502 # - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
9503 # - compute/v1/projects/project/global/backendServices/backendService
9504 # - global/backendServices/backendService
9505 #
9506 #
9507 # If defaultRouteAction is also specified, advanced
9508 # routing actions, such as URL rewrites, take effect before sending the
9509 # request to the backend.
9510 #
9511 #
9512 # Only one of defaultUrlRedirect, defaultService
9513 # or defaultRouteAction.weightedBackendService can be set.
9514 #
9515 #
9516 # Authorization requires one or more of the following Google IAM permissions on the
9517 # specified resource default_service:
9518 #
9519 #
9520 # - compute.backendBuckets.use
9521 # - compute.backendServices.use
9522 &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
9523 # by defaultUrlRedirect.
9524 #
9525 #
9526 # Only one of defaultUrlRedirect, defaultService
9527 # or defaultRouteAction.weightedBackendService can be set.
9528 #
9529 #
9530 # Not supported when the URL map is bound to a target gRPC proxy.
9531 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
9532 # was supplied in the request.
9533 #
9534 # The value must be from 1 to 255
9535 # characters.
9536 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
9537 # set to HTTPS.
9538 # If set to false, the URL scheme of the redirected request
9539 # remains the same as that of the request.
9540 #
9541 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
9542 #
9543 # The default is set to false.
9544 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
9545 # that was supplied in the request.
9546 #
9547 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
9548 # supplied, the path of the original request is used for the redirect.
9549 #
9550 # The value must be from 1 to 1024 characters.
9551 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
9552 # the HttpRouteRuleMatch, retaining the remaining portion
9553 # of the URL before redirecting the request.
9554 #
9555 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
9556 # supplied, the path of the original request is used for the redirect.
9557 #
9558 # The value must be from 1 to 1024 characters.
9559 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
9560 #
9561 # Supported values are:
9562 #
9563 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
9564 # to 301.
9565 # - FOUND, which corresponds to 302.
9566 # - SEE_OTHER which corresponds to 303.
9567 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
9568 # method is retained.
9569 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
9570 # method is retained.
9571 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
9572 # URL is
9573 # removed before redirecting the request. If set to false, the
9574 # query portion of the original URL is retained.
9575 #
9576 # The default is set to false.
9577 },
9578 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
9579 # create the resource.
9580 &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
9581 # for the selected backend service.
9582 #
9583 # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
9584 #
9585 # HeaderAction is not supported for load balancers
9586 # that have
9587 # their loadBalancingScheme set to EXTERNAL.
9588 #
9589 # Not supported when the URL map is bound to a target gRPC proxy that
9590 # has validateForProxyless field set to true.
9591 # the request is passed along to the selected backendService.
9592 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
9593 { # Specification determining how headers are added to requests or responses.
9594 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
9595 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
9596 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
9597 # that already
9598 # exist for the header. If true, headerValue is set for the
9599 # header, discarding any values that were set for that header.
9600 #
9601 # The default value is true,
9602 # unless a variable is present in headerValue,
9603 # in which case the default value is false.
9604 # .
9605 },
9606 ],
9607 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
9608 # request before forwarding the request to the backendService.
9609 &quot;A String&quot;,
9610 ],
9611 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
9612 # client.
9613 { # Specification determining how headers are added to requests or responses.
9614 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
9615 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
9616 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
9617 # that already
9618 # exist for the header. If true, headerValue is set for the
9619 # header, discarding any values that were set for that header.
9620 #
9621 # The default value is true,
9622 # unless a variable is present in headerValue,
9623 # in which case the default value is false.
9624 # .
9625 },
9626 ],
9627 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
9628 # response before sending the response back to the client.
9629 &quot;A String&quot;,
9630 ],
9631 },
9632 &quot;name&quot;: &quot;A String&quot;, # The name to which this PathMatcher is referred by theHostRule.
9633 &quot;pathRules&quot;: [ # The list of path rules. Use this list instead of routeRules
9634 # when routing based on simple path matching is all that&#x27;s required. A path
9635 # rule can only include a wildcard character (*) after a
9636 # forward slash character (&quot;/&quot;).
9637 #
9638 # The order by which path rules are specified does not matter.
9639 # Matches are always done on the longest-path-first basis.
9640 #
9641 # For example: a pathRule with a path /a/b/c/* will match
9642 # before /a/b/* irrespective of the order in which those paths appear in this
9643 # list.
9644 #
9645 # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
9646 { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
9647 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
9648 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
9649 #
9650 # If a policy for an
9651 # error code is not configured for the PathRule, a policy for
9652 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
9653 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
9654 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
9655 # effect.
9656 #
9657 # For example, consider a UrlMap with the following configuration:
9658 #
9659 #
9660 # - UrlMap.defaultCustomErrorResponsePolicy are configured
9661 # with policies for 5xx and 4xx errors
9662 # - A PathRule for /coming_soon/ is configured for the error
9663 # code 404.
9664 #
9665 # 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
9666 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
9667 # the policy in PathRule.customErrorResponsePolicy takes
9668 # effect. If any of the requests in this example encounter a 500
9669 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
9670 #
9671 # customErrorResponsePolicy is supported only for
9672 # global external Application Load Balancers.
9673 # backend service or backend bucket responds with an error.
9674 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
9675 #
9676 # In a given policy, if you specify rules for both a range of error codes
9677 # as well as rules for specific error codes then rules with specific error
9678 # codes have a higher priority. For example, assume that you configure a rule
9679 # for 401 (Un-authorized) code, and another for all 4 series
9680 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
9681 # However if the backend service returns a 403, the rule for4xx takes effect.
9682 { # Specifies the mapping between the response code that will be returned along
9683 # with the custom error content and the response code returned by the backend
9684 # service.
9685 &quot;matchResponseCodes&quot;: [ # Valid values include:
9686 #
9687 #
9688 # - A number between 400 and 599: For example
9689 # 401 or 503, in which case the load balancer
9690 # applies the policy if the error code exactly matches this value.
9691 # - 5xx: Load Balancer will apply the policy if the
9692 # backend service responds with any response code in the range of
9693 # 500 to 599.
9694 # - 4xx: Load
9695 # Balancer will apply the policy if the backend service responds with any
9696 # response code in the range of 400 to
9697 # 499.
9698 #
9699 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
9700 &quot;A String&quot;,
9701 ],
9702 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
9703 # error content. If overrideResponseCode is not supplied, the
9704 # same response code returned by the original backend bucket or backend
9705 # service is returned to the client.
9706 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
9707 #
9708 # path must start
9709 # with a leading slash. path cannot have trailing slashes.
9710 #
9711 # If the file is not available in backendBucket or the
9712 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
9713 #
9714 # The value must
9715 # be from 1 to 1024 characters
9716 },
9717 ],
9718 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
9719 # contains the custom error content. Examples are:
9720 #
9721 #
9722 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
9723 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
9724 # - global/backendBuckets/myBackendBucket
9725 #
9726 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
9727 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
9728 #
9729 # If load balancer cannot reach
9730 # the backendBucket, a simple Not Found Error will
9731 # be returned, with the original response code (oroverrideResponseCode if configured).
9732 #
9733 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
9734 },
9735 &quot;paths&quot;: [ # The list of path patterns to match. Each must start with /
9736 # and the only place a * is allowed is at the end following
9737 # a /. The string fed to the path matcher does not include
9738 # any text after the first ? or #, and
9739 # those chars are not allowed here.
9740 &quot;A String&quot;,
9741 ],
9742 &quot;routeAction&quot;: { # In response to a matching path, the load balancer
9743 # performs advanced routing actions, such as URL rewrites and header
9744 # transformations, before forwarding the request to the selected
9745 # backend.
9746 #
9747 #
9748 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
9749 #
9750 #
9751 # URL maps for classic Application Load Balancers only support
9752 # the urlRewrite action within a path rule&#x27;srouteAction.
9753 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
9754 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
9755 # property must be specified. This policy cannot be specified if any target
9756 # backend has Identity-Aware Proxy enabled.
9757 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
9758 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
9759 # header names can be specified. The cache is bypassed for all `cacheMode`
9760 # values.
9761 &quot;A String&quot;,
9762 ],
9763 &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
9764 # on the backend type: for Backend Services, the complete request URI is
9765 # used; for Backend Buckets, the request URI is used without the protocol or
9766 # host, and only query parameters known to Cloud Storage are included.
9767 # Policy defined on Route Action.
9768 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
9769 # parameters will be included. Either specify `excludedQueryParameters`
9770 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
9771 # encoded and not treated as delimiters.
9772 #
9773 # Note: This field applies to routes that use backend services. Attempting
9774 # to set it on a route that points exclusively to Backend Buckets will
9775 # result in a configuration error. For routes that point to a Backend
9776 # Bucket, use `includedQueryParameters` to define which parameters should
9777 # be part of the cache key.
9778 &quot;A String&quot;,
9779 ],
9780 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
9781 #
9782 # Note: This setting is only applicable to routes that use a Backend
9783 # Service. It does not affect requests served by a Backend Bucket, as the
9784 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
9785 # it on a route that points exclusively to Backend Buckets will result in a
9786 # configuration error.
9787 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
9788 #
9789 # Note: This setting is only applicable to routes that use a Backend
9790 # Service. It does not affect requests served by a Backend Bucket, as the
9791 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
9792 # set on a route that points exclusively to Backend Buckets will result in
9793 # a configuration error.
9794 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
9795 # `includedQueryParameters` and `excludedQueryParameters`. If neither
9796 # is set, the entire query string will be included. If false, the query
9797 # string will be excluded from the cache key entirely.
9798 #
9799 # Note: This field applies to routes that use backend services. Attempting
9800 # to set it on a route that points exclusively to Backend Buckets will
9801 # result in a configuration error. For routes that point to a Backend
9802 # Bucket, use `includedQueryParameters` to define which parameters should
9803 # be part of the cache key.
9804 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
9805 # The name=value pair will be used in the cache key Cloud CDN generates.
9806 #
9807 # Note: This setting is only applicable to routes that use a Backend
9808 # Service. It does not affect requests served by a Backend Bucket.
9809 # Attempting to set it on a route that points exclusively to Backend
9810 # Buckets will result in a configuration error. Up to 5 cookie names can be
9811 # specified.
9812 &quot;A String&quot;,
9813 ],
9814 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
9815 &quot;A String&quot;,
9816 ],
9817 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
9818 # parameters will be excluded. Either specify `includedQueryParameters`
9819 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
9820 # encoded and not treated as delimiters.
9821 &quot;A String&quot;,
9822 ],
9823 },
9824 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
9825 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
9826 &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
9827 # content. This is used to clamp the max-age (or Expires) value sent to the
9828 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
9829 # is used for the response max-age directive, along with a &quot;public&quot;
9830 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
9831 # clamps the max-age from the origin (if specified), or else sets the
9832 # response max-age directive to the lesser of the `clientTtl` and
9833 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
9834 # present. The maximum allowed value is 31,622,400s (1 year). If not
9835 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
9836 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
9837 # `USE_ORIGIN_HEADERS`.
9838 # as a count of seconds and fractions of seconds at nanosecond
9839 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9840 # or &quot;month&quot;. Range is approximately 10,000 years.
9841 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9842 # Durations less than one second are represented with a 0
9843 # `seconds` field and a positive `nanos` field. Must be from 0
9844 # to 999,999,999 inclusive.
9845 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9846 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9847 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9848 },
9849 &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
9850 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
9851 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
9852 # greater than that of `maxTtl`. When the `cacheMode` is set to
9853 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
9854 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
9855 # accessed objects may be evicted from the cache before the defined TTL. If
9856 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
9857 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
9858 # `USE_ORIGIN_HEADERS`.
9859 # as a count of seconds and fractions of seconds at nanosecond
9860 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9861 # or &quot;month&quot;. Range is approximately 10,000 years.
9862 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9863 # Durations less than one second are represented with a 0
9864 # `seconds` field and a positive `nanos` field. Must be from 0
9865 # to 999,999,999 inclusive.
9866 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9867 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9868 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9869 },
9870 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
9871 # attempt to set a max-age or s-maxage higher than this, or an Expires header
9872 # more than `maxTtl` seconds in the future will be capped at the value of
9873 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
9874 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
9875 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
9876 # Infrequently accessed objects may be evicted from the cache before the
9877 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
9878 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
9879 # mode.
9880 # as a count of seconds and fractions of seconds at nanosecond
9881 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9882 # or &quot;month&quot;. Range is approximately 10,000 years.
9883 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9884 # Durations less than one second are represented with a 0
9885 # `seconds` field and a positive `nanos` field. Must be from 0
9886 # to 999,999,999 inclusive.
9887 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9888 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9889 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9890 },
9891 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
9892 # to apply fine-grained caching for common errors or redirects.
9893 # This can reduce the load on your origin and improve end-user
9894 # experience by reducing response latency.
9895 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
9896 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
9897 # the specified response code that lack any Cache-Control, Expires, or
9898 # Pragma: no-cache directives. When the `cacheMode` is set to
9899 # `FORCE_CACHE_ALL`, negative caching applies to all responses
9900 # with the specified response code, and overrides any caching headers. By
9901 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
9902 #
9903 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
9904 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
9905 # * 405 (Method Not Found), 501 (Not Implemented): 60s
9906 #
9907 # These defaults can be overridden in `negativeCachingPolicy`.
9908 # If not specified, Cloud CDN applies negative caching by default.
9909 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
9910 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
9911 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
9912 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
9913 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
9914 # all response codes that you wish to cache. Cloud CDN will not apply any
9915 # default negative caching when a policy exists.
9916 { # Specify CDN TTLs for response error codes.
9917 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
9918 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
9919 # specified as values, and you cannot specify a status code more than
9920 # once.
9921 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
9922 # corresponding status code.
9923 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
9924 # objects may be evicted from the cache before the defined TTL.
9925 # as a count of seconds and fractions of seconds at nanosecond
9926 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9927 # or &quot;month&quot;. Range is approximately 10,000 years.
9928 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9929 # Durations less than one second are represented with a 0
9930 # `seconds` field and a positive `nanos` field. Must be from 0
9931 # to 999,999,999 inclusive.
9932 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9933 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9934 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9935 },
9936 },
9937 ],
9938 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
9939 # requests into a small number of requests to the origin. If not specified,
9940 # Cloud CDN applies request coalescing by default.
9941 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
9942 # content with the origin, or when an error is encountered when refreshing
9943 # the cache.
9944 # This setting defines the default &quot;max-stale&quot; duration for any cached
9945 # responses that do not specify a max-stale directive. Stale responses that
9946 # exceed the TTL configured here will not be served. The default limit
9947 # (max-stale) is 86400s (1 day), which will allow stale content to be
9948 # served up to this limit beyond the max-age (or s-maxage) of a cached
9949 # response.
9950 # The maximum allowed value is 604800 (1 week).
9951 # Set this to zero (0) to disable serve-while-stale.
9952 # as a count of seconds and fractions of seconds at nanosecond
9953 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9954 # or &quot;month&quot;. Range is approximately 10,000 years.
9955 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9956 # Durations less than one second are represented with a 0
9957 # `seconds` field and a positive `nanos` field. Must be from 0
9958 # to 999,999,999 inclusive.
9959 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9960 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9961 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9962 },
9963 },
9964 &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
9965 # information about the W3C recommendation for cross-origin resource sharing
9966 # (CORS), see Fetch API Living
9967 # Standard.
9968 #
9969 # Not supported when the URL map is bound to a target gRPC proxy.
9970 # information about the W3C recommendation for cross-origin resource sharing
9971 # (CORS), see Fetch API Living
9972 # Standard.
9973 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
9974 # indicates that
9975 # the actual request can include user credentials. This field translates to
9976 # the Access-Control-Allow-Credentials header.
9977 #
9978 # Default is false.
9979 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
9980 # header.
9981 &quot;A String&quot;,
9982 ],
9983 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
9984 # header.
9985 &quot;A String&quot;,
9986 ],
9987 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
9988 # more information, see regular expression syntax.
9989 #
9990 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
9991 #
9992 # Regular expressions can only be used when the loadBalancingScheme is
9993 # set to INTERNAL_SELF_MANAGED.
9994 &quot;A String&quot;,
9995 ],
9996 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
9997 #
9998 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
9999 &quot;A String&quot;,
10000 ],
10001 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
10002 # The default value is false, which indicates that the CORS
10003 # policy is in effect.
10004 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
10005 # header.
10006 &quot;A String&quot;,
10007 ],
10008 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
10009 # seconds. This field translates to the Access-Control-Max-Age
10010 # header.
10011 },
10012 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
10013 # the resiliency of clients to backend service failure. As part of fault
10014 # injection, when clients send requests to a backend service, delays can be
10015 # introduced by a load balancer on a percentage of requests before sending
10016 # those requests to the backend service. Similarly requests from clients can
10017 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
10018 # that are configured with a fault_injection_policy if:
10019 # 1. The traffic is generated by fault injection AND
10020 # 2. The fault injection is not a delay fault injection.
10021 # Fault injection is not supported with the classic Application Load Balancer
10022 # . To see which load balancers support fault injection,
10023 # see Load
10024 # balancing: Routing and traffic management features.
10025 # the resiliency of clients to backend service failure. As part of fault
10026 # injection, when clients send requests to a backend service, delays can be
10027 # introduced by the load balancer on a percentage of requests before sending
10028 # those request to the backend service. Similarly requests from clients can be
10029 # aborted by the load balancer for a percentage of requests.
10030 &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
10031 # injection.
10032 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
10033 #
10034 # The value must be from 200 to 599 inclusive.
10035 #
10036 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
10037 # according to this
10038 # mapping table. HTTP status 200 is mapped to gRPC status
10039 # UNKNOWN. Injecting an OK status is currently not supported by
10040 # Traffic Director.
10041 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
10042 # that is aborted as part of fault injection.
10043 #
10044 # The value must be from 0.0 to 100.0 inclusive.
10045 },
10046 &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
10047 # injection, before being sent to a backend service.
10048 # request to the backend service as part of fault injection.
10049 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
10050 # as a count of seconds and fractions of seconds at nanosecond
10051 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10052 # or &quot;month&quot;. Range is approximately 10,000 years.
10053 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10054 # Durations less than one second are represented with a 0
10055 # `seconds` field and a positive `nanos` field. Must be from 0
10056 # to 999,999,999 inclusive.
10057 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10058 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10059 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10060 },
10061 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
10062 # which a delay is introduced as part of fault injection.
10063 #
10064 # The value must be from 0.0 to 100.0 inclusive.
10065 },
10066 },
10067 &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
10068 # Global EXTERNAL_MANAGED load balancer schemes.
10069 # Either Cloud CDN must be enabled on the backend service or backend bucket
10070 # serving the route, or cache policy must be configured on the same route
10071 # dynamically processes and delivers images from the network edge.
10072 # Image Optimization is only available for Global External Application Load
10073 # Balancers.
10074 # Either Cloud CDN must be enabled on the backend service or backend bucket
10075 # serving the route, or cache policy must be configured on the same route.
10076 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
10077 },
10078 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
10079 # Unlike the timeout field where the timeout duration starts
10080 # from the time the request has been fully processed (known as*end-of-stream*),
10081 # the duration in this field is computed from the beginning of the stream
10082 # until the response has been processed, including all retries. A
10083 # stream that does not complete in this duration is closed.
10084 #
10085 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
10086 # with the route.
10087 #
10088 # This field is only allowed if the Url map is used with backend services
10089 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
10090 # as a count of seconds and fractions of seconds at nanosecond
10091 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10092 # or &quot;month&quot;. Range is approximately 10,000 years.
10093 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10094 # Durations less than one second are represented with a 0
10095 # `seconds` field and a positive `nanos` field. Must be from 0
10096 # to 999,999,999 inclusive.
10097 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10098 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10099 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10100 },
10101 &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
10102 # are shadowed to a separate mirrored backend service. The load balancer does
10103 # not wait for responses from the shadow service. Before sending traffic
10104 # to the shadow service, the host / authority header is suffixed with-shadow.
10105 #
10106 # Not supported when the URL map is bound to a target gRPC proxy that
10107 # has the validateForProxyless field set to true.
10108 # are shadowed to a separate mirrored backend service. The load balancer
10109 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
10110 # to the shadow service, the host or authority header is suffixed with-shadow.
10111 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
10112 # mirrored to.
10113 #
10114 # The backend service configured for a mirroring
10115 # policy must reference backends that are of the same type as the original
10116 # backend service matched in the URL map.
10117 #
10118 # Serverless NEG backends are not currently supported as a mirrored
10119 # backend service.
10120 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
10121 },
10122 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
10123 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
10124 # If not specified, defaults to 1.
10125 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
10126 #
10127 # If not specified, will use the timeout set in theHttpRouteAction field.
10128 # If timeout in the HttpRouteAction field is not set, this field
10129 # uses the largest timeout
10130 # among all backend services associated with the route.
10131 #
10132 # Not supported when the URL map is bound to a target gRPC proxy that
10133 # has the validateForProxyless field set to true.
10134 # as a count of seconds and fractions of seconds at nanosecond
10135 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10136 # or &quot;month&quot;. Range is approximately 10,000 years.
10137 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10138 # Durations less than one second are represented with a 0
10139 # `seconds` field and a positive `nanos` field. Must be from 0
10140 # to 999,999,999 inclusive.
10141 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10142 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10143 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10144 },
10145 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
10146 # values are:
10147 #
10148 # - 5xx: retry is attempted if the instance or endpoint
10149 # responds with any 5xx response code, or if the instance or
10150 # endpoint does not respond at all. For example, disconnects, reset, read
10151 # timeout, connection failure, and refused streams.
10152 # - gateway-error: Similar to 5xx, but only
10153 # applies to response codes 502, 503 or504.
10154 # - connect-failure: a retry is attempted on failures
10155 # connecting to the instance or endpoint. For example, connection
10156 # timeouts.
10157 # - retriable-4xx: a retry is attempted if the instance
10158 # or endpoint responds with a 4xx response code.
10159 # The only error that you can retry is error code 409.
10160 # - refused-stream: a retry is attempted if the instance
10161 # or endpoint resets the stream with a REFUSED_STREAM error
10162 # code. This reset type indicates that it is safe to retry.
10163 # - cancelled: a retry is attempted if the gRPC status
10164 # code in the response header is set to cancelled.
10165 # - deadline-exceeded: a retry is attempted if the gRPC
10166 # status code in the response header is set todeadline-exceeded.
10167 # - internal: a retry is attempted if the gRPC
10168 # status code in the response header is set tointernal.
10169 # - resource-exhausted: a retry is attempted if the gRPC
10170 # status code in the response header is set toresource-exhausted.
10171 # - unavailable: a retry is attempted if the gRPC
10172 # status code in the response header is set tounavailable.
10173 #
10174 # Only the following codes are supported when the URL map is bound to
10175 # target gRPC proxy that has validateForProxyless field set to true.
10176 #
10177 # - cancelled
10178 # - deadline-exceeded
10179 # - internal
10180 # - resource-exhausted
10181 # - unavailable
10182 &quot;A String&quot;,
10183 ],
10184 },
10185 &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
10186 # time the request has been fully processed (known as *end-of-stream*)
10187 # up until the response has been processed. Timeout includes
10188 # all retries.
10189 #
10190 # If not specified, this field uses the largest timeout among all backend
10191 # services associated with the route.
10192 #
10193 # Not supported when the URL map is bound to a target gRPC proxy that
10194 # has validateForProxyless field set to true.
10195 # as a count of seconds and fractions of seconds at nanosecond
10196 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10197 # or &quot;month&quot;. Range is approximately 10,000 years.
10198 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10199 # Durations less than one second are represented with a 0
10200 # `seconds` field and a positive `nanos` field. Must be from 0
10201 # to 999,999,999 inclusive.
10202 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10203 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10204 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10205 },
10206 &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
10207 # to the matched service.
10208 #
10209 # urlRewrite is the only action supported in UrlMaps
10210 # for classic Application Load Balancers.
10211 #
10212 # Not supported when the URL map is bound to a target gRPC proxy that
10213 # has the validateForProxyless field set to true.
10214 # backend service.
10215 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
10216 # host header is replaced with contents of hostRewrite.
10217 #
10218 # The value must be from 1 to 255 characters.
10219 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
10220 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
10221 #
10222 # The value must be from 1 to 1024 characters.
10223 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
10224 # header) using the HTTP template syntax.
10225 #
10226 # A corresponding
10227 # path_template_match must be specified. Any template variables must exist in
10228 # the path_template_match field.
10229 #
10230 #
10231 # - -At least one variable must be specified in the path_template_match
10232 # field
10233 # - You can omit variables from the rewritten URL
10234 # - The * and ** operators cannot be matched
10235 # unless they have a corresponding variable name - e.g.
10236 # {format=*} or {var=**}.
10237 #
10238 # For example, a path_template_match of /static/{format=**}
10239 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
10240 # rewrite, so that /{country}/{format}/{suffix=**} can be
10241 # rewritten as /content/{format}/{country}/{suffix}.
10242 #
10243 # At least
10244 # one non-empty routeRules[].matchRules[].path_template_match is
10245 # required.
10246 #
10247 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
10248 },
10249 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
10250 # occurs. The weights determine the fraction of traffic that flows to
10251 # their corresponding backend service. If all traffic needs to
10252 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
10253 #
10254 # After a backend service is identified and before forwarding
10255 # the request to
10256 # the backend service, advanced routing actions such as URL rewrites and
10257 # header transformations are applied depending on additional settings
10258 # specified in this HttpRouteAction.
10259 { # In contrast to a single BackendService in
10260 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
10261 # multiple backend services. The volume of traffic for each
10262 # backend service is proportional to the weight specified
10263 # in each WeightedBackendService
10264 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
10265 # resource. Before
10266 # forwarding the request to backendService, the load balancer
10267 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
10268 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
10269 # effect for the selected backendService.
10270 #
10271 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
10272 #
10273 # headerAction is not supported for load balancers that have
10274 # their loadBalancingScheme set to EXTERNAL.
10275 #
10276 # Not supported when the URL map is bound to a target gRPC proxy that
10277 # has validateForProxyless field set to true.
10278 # the request is passed along to the selected backendService.
10279 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
10280 { # Specification determining how headers are added to requests or responses.
10281 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
10282 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
10283 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
10284 # that already
10285 # exist for the header. If true, headerValue is set for the
10286 # header, discarding any values that were set for that header.
10287 #
10288 # The default value is true,
10289 # unless a variable is present in headerValue,
10290 # in which case the default value is false.
10291 # .
10292 },
10293 ],
10294 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
10295 # request before forwarding the request to the backendService.
10296 &quot;A String&quot;,
10297 ],
10298 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
10299 # client.
10300 { # Specification determining how headers are added to requests or responses.
10301 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
10302 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
10303 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
10304 # that already
10305 # exist for the header. If true, headerValue is set for the
10306 # header, discarding any values that were set for that header.
10307 #
10308 # The default value is true,
10309 # unless a variable is present in headerValue,
10310 # in which case the default value is false.
10311 # .
10312 },
10313 ],
10314 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
10315 # response before sending the response back to the client.
10316 &quot;A String&quot;,
10317 ],
10318 },
10319 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
10320 # computed asweight / (sum of all weightedBackendService weights in routeAction).
10321 #
10322 # The selection of a backend service is determined only for new traffic.
10323 # Once a user&#x27;s request has been directed to a backend service,
10324 # subsequent requests are sent to the same backend service as
10325 # determined by the backend service&#x27;s session affinity policy.
10326 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
10327 # splitting. If you do, the weighted traffic splitting configuration takes
10328 # precedence.
10329 #
10330 # The value must be from 0 to 1000.
10331 },
10332 ],
10333 },
10334 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
10335 # is directed if this rule is matched. If routeAction is
10336 # also specified, advanced routing actions, such as URL rewrites,
10337 # take effect before sending the request to the backend.
10338 #
10339 #
10340 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
10341 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
10342 # specified by urlRedirect.
10343 #
10344 #
10345 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
10346 #
10347 #
10348 # Not supported when the URL map is bound to a target gRPC proxy.
10349 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
10350 # was supplied in the request.
10351 #
10352 # The value must be from 1 to 255
10353 # characters.
10354 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
10355 # set to HTTPS.
10356 # If set to false, the URL scheme of the redirected request
10357 # remains the same as that of the request.
10358 #
10359 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
10360 #
10361 # The default is set to false.
10362 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
10363 # that was supplied in the request.
10364 #
10365 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
10366 # supplied, the path of the original request is used for the redirect.
10367 #
10368 # The value must be from 1 to 1024 characters.
10369 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
10370 # the HttpRouteRuleMatch, retaining the remaining portion
10371 # of the URL before redirecting the request.
10372 #
10373 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
10374 # supplied, the path of the original request is used for the redirect.
10375 #
10376 # The value must be from 1 to 1024 characters.
10377 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
10378 #
10379 # Supported values are:
10380 #
10381 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
10382 # to 301.
10383 # - FOUND, which corresponds to 302.
10384 # - SEE_OTHER which corresponds to 303.
10385 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
10386 # method is retained.
10387 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
10388 # method is retained.
10389 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
10390 # URL is
10391 # removed before redirecting the request. If set to false, the
10392 # query portion of the original URL is retained.
10393 #
10394 # The default is set to false.
10395 },
10396 },
10397 ],
10398 &quot;routeRules&quot;: [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
10399 # desired. routeRules are evaluated in order of priority, from
10400 # the lowest to highest number.
10401 #
10402 # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
10403 { # The HttpRouteRule setting specifies how to match an HTTP request
10404 # and the corresponding routing action that load balancing proxies perform.
10405 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
10406 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
10407 #
10408 # If a policy for an
10409 # error code is not configured for the RouteRule, a policy for
10410 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
10411 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
10412 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
10413 # effect.
10414 #
10415 # For example, consider a UrlMap with the following configuration:
10416 #
10417 #
10418 # - UrlMap.defaultCustomErrorResponsePolicy are configured
10419 # with policies for 5xx and 4xx errors
10420 # - A RouteRule for /coming_soon/ is configured for the
10421 # error code 404.
10422 #
10423 # 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
10424 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
10425 # the policy in RouteRule.customErrorResponsePolicy takes
10426 # effect. If any of the requests in this example encounter a 500
10427 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
10428 #
10429 # When
10430 # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
10431 # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
10432 # a retry, if load balancer is successful in reaching the
10433 # service, the customErrorResponsePolicy is ignored and
10434 # the response from the service is returned to the client.
10435 #
10436 # customErrorResponsePolicy is supported only for
10437 # global external Application Load Balancers.
10438 # backend service or backend bucket responds with an error.
10439 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
10440 #
10441 # In a given policy, if you specify rules for both a range of error codes
10442 # as well as rules for specific error codes then rules with specific error
10443 # codes have a higher priority. For example, assume that you configure a rule
10444 # for 401 (Un-authorized) code, and another for all 4 series
10445 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
10446 # However if the backend service returns a 403, the rule for4xx takes effect.
10447 { # Specifies the mapping between the response code that will be returned along
10448 # with the custom error content and the response code returned by the backend
10449 # service.
10450 &quot;matchResponseCodes&quot;: [ # Valid values include:
10451 #
10452 #
10453 # - A number between 400 and 599: For example
10454 # 401 or 503, in which case the load balancer
10455 # applies the policy if the error code exactly matches this value.
10456 # - 5xx: Load Balancer will apply the policy if the
10457 # backend service responds with any response code in the range of
10458 # 500 to 599.
10459 # - 4xx: Load
10460 # Balancer will apply the policy if the backend service responds with any
10461 # response code in the range of 400 to
10462 # 499.
10463 #
10464 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
10465 &quot;A String&quot;,
10466 ],
10467 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
10468 # error content. If overrideResponseCode is not supplied, the
10469 # same response code returned by the original backend bucket or backend
10470 # service is returned to the client.
10471 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
10472 #
10473 # path must start
10474 # with a leading slash. path cannot have trailing slashes.
10475 #
10476 # If the file is not available in backendBucket or the
10477 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
10478 #
10479 # The value must
10480 # be from 1 to 1024 characters
10481 },
10482 ],
10483 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
10484 # contains the custom error content. Examples are:
10485 #
10486 #
10487 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
10488 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
10489 # - global/backendBuckets/myBackendBucket
10490 #
10491 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
10492 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
10493 #
10494 # If load balancer cannot reach
10495 # the backendBucket, a simple Not Found Error will
10496 # be returned, with the original response code (oroverrideResponseCode if configured).
10497 #
10498 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
10499 },
10500 &quot;description&quot;: &quot;A String&quot;, # The short description conveying the intent of this routeRule.
10501 #
10502 #
10503 # The description can have a maximum length of 1024 characters.
10504 &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
10505 # for the selected backendService.
10506 #
10507 # The headerAction value specified here is applied before the
10508 # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
10509 #
10510 # HeaderAction is not supported for load balancers
10511 # that have
10512 # their loadBalancingScheme set to EXTERNAL.
10513 #
10514 # Not supported when the URL map is bound to a target gRPC proxy that
10515 # has validateForProxyless field set to true.
10516 # the request is passed along to the selected backendService.
10517 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
10518 { # Specification determining how headers are added to requests or responses.
10519 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
10520 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
10521 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
10522 # that already
10523 # exist for the header. If true, headerValue is set for the
10524 # header, discarding any values that were set for that header.
10525 #
10526 # The default value is true,
10527 # unless a variable is present in headerValue,
10528 # in which case the default value is false.
10529 # .
10530 },
10531 ],
10532 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
10533 # request before forwarding the request to the backendService.
10534 &quot;A String&quot;,
10535 ],
10536 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
10537 # client.
10538 { # Specification determining how headers are added to requests or responses.
10539 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
10540 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
10541 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
10542 # that already
10543 # exist for the header. If true, headerValue is set for the
10544 # header, discarding any values that were set for that header.
10545 #
10546 # The default value is true,
10547 # unless a variable is present in headerValue,
10548 # in which case the default value is false.
10549 # .
10550 },
10551 ],
10552 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
10553 # response before sending the response back to the client.
10554 &quot;A String&quot;,
10555 ],
10556 },
10557 &quot;httpFilterConfigs&quot;: [ # Outbound route specific configuration fornetworkservices.HttpFilter resources enabled by Traffic
10558 # Director. httpFilterConfigs only applies for load balancers
10559 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
10560 # more details.
10561 #
10562 # Not supported when the URL map is bound to a target gRPC proxy that
10563 # has validateForProxyless field set to true.
10564 { # HttpFilterConfiguration supplies additional contextual settings
10565 # for networkservices.HttpFilter resources enabled by Traffic
10566 # Director.
10567 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
10568 # YAML formatted and only contain fields defined in the protobuf identified
10569 # in configTypeUrl
10570 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
10571 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
10572 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
10573 # configuration belongs to. This name must be known to the xDS client.
10574 # Example: envoy.wasm
10575 },
10576 ],
10577 &quot;httpFilterMetadata&quot;: [ # Outbound route specific metadata supplied tonetworkservices.HttpFilter resources enabled by Traffic
10578 # Director. httpFilterMetadata only applies for load balancers
10579 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
10580 # more details.
10581 #
10582 # The only configTypeUrl supported istype.googleapis.com/google.protobuf.Struct
10583 #
10584 # Not supported when the URL map is bound to a target gRPC proxy that
10585 # has validateForProxyless field set to true.
10586 { # HttpFilterConfiguration supplies additional contextual settings
10587 # for networkservices.HttpFilter resources enabled by Traffic
10588 # Director.
10589 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
10590 # YAML formatted and only contain fields defined in the protobuf identified
10591 # in configTypeUrl
10592 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
10593 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
10594 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
10595 # configuration belongs to. This name must be known to the xDS client.
10596 # Example: envoy.wasm
10597 },
10598 ],
10599 &quot;matchRules&quot;: [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
10600 # this routeRule when any of thematchRules are satisfied. However predicates within
10601 # a given matchRule have AND semantics. All predicates
10602 # within a matchRule must match for the request to
10603 # match the rule.
10604 { # HttpRouteRuleMatch specifies a set of criteria for matching
10605 # requests to an HttpRouteRule. All specified criteria must
10606 # be satisfied for a match to occur.
10607 &quot;fullPathMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
10608 # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
10609 # that may be part of the original URL.
10610 #
10611 # fullPathMatch must be from 1 to 1024 characters.
10612 #
10613 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
10614 # specified.
10615 &quot;headerMatches&quot;: [ # Specifies a list of header match criteria, all of which must match
10616 # corresponding headers in the request.
10617 { # matchRule criteria for request header matches.
10618 &quot;exactMatch&quot;: &quot;A String&quot;, # The value should exactly match contents of exactMatch.
10619 #
10620 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
10621 &quot;headerName&quot;: &quot;A String&quot;, # The name of the HTTP header to match.
10622 #
10623 # For matching against the HTTP request&#x27;s authority, use a headerMatch
10624 # with the header name &quot;:authority&quot;.
10625 #
10626 # For matching a request&#x27;s method, use the headerName &quot;:method&quot;.
10627 #
10628 # When the URL map is bound to a target gRPC proxy that has
10629 # the validateForProxyless field set to true, only
10630 # non-binary
10631 # user-specified custom metadata and the `content-type` header are supported.
10632 # The following transport-level headers cannot be used in header matching
10633 # rules:
10634 # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
10635 # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
10636 # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
10637 # `grpc-timeout` and `grpc-trace-bin`.
10638 &quot;invertMatch&quot;: True or False, # If set to false, the headerMatch is considered a
10639 # match if the preceding match criteria are met. If set to true,
10640 # the headerMatch is considered a match if the preceding
10641 # match criteria are NOT met.
10642 #
10643 # The default setting is false.
10644 &quot;prefixMatch&quot;: &quot;A String&quot;, # The value of the header must start with the contents ofprefixMatch.
10645 #
10646 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
10647 &quot;presentMatch&quot;: True or False, # A header with the contents of headerName must exist. The
10648 # match takes place whether or not the request&#x27;s header has a value.
10649 #
10650 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
10651 &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
10652 # specified in rangeMatch. If the header does not contain an
10653 # integer, number or is empty, the match fails.
10654 #
10655 # For example for a range [-5, 0]
10656 #
10657 #
10658 # - -3 will match.
10659 # - 0 will not match.
10660 # - 0.25 will not match.
10661 # - -3someString will not match.
10662 #
10663 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
10664 #
10665 # rangeMatch is not supported for load balancers
10666 # that have loadBalancingScheme set to EXTERNAL.
10667 # within the specified integer range.
10668 &quot;rangeEnd&quot;: &quot;A String&quot;, # The end of the range (exclusive) in signed long integer format.
10669 &quot;rangeStart&quot;: &quot;A String&quot;, # The start of the range (inclusive) in signed long integer format.
10670 },
10671 &quot;regexMatch&quot;: &quot;A String&quot;, # The value of the header must match the regular expression specified inregexMatch.
10672 # For more information about regular expression syntax, see Syntax.
10673 #
10674 # For matching against a port specified in the HTTP request, use a
10675 # headerMatch with headerName set to PORT and a regular expression that
10676 # satisfies the RFC2616 Host header&#x27;s port specifier.
10677 #
10678 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
10679 #
10680 # Regular expressions can only be used when the loadBalancingScheme is
10681 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
10682 # (regional scope) or INTERNAL_MANAGED.
10683 &quot;suffixMatch&quot;: &quot;A String&quot;, # The value of the header must end with the contents ofsuffixMatch.
10684 #
10685 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
10686 },
10687 ],
10688 &quot;ignoreCase&quot;: True or False, # Specifies that prefixMatch and fullPathMatch
10689 # matches are case sensitive.
10690 #
10691 # The default value is false.
10692 #
10693 # ignoreCase must not be used with regexMatch.
10694 #
10695 # Not supported when the URL map is bound to a target gRPC proxy.
10696 &quot;metadataFilters&quot;: [ # Opaque filter criteria used by the load balancer to restrict routing
10697 # configuration to a limited set of xDS
10698 # compliant clients. In their xDS requests to the load balancer, xDS clients
10699 # present node
10700 # metadata. When there is a match, the relevant routing configuration
10701 # is made available to those proxies.
10702 #
10703 # 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
10704 # the metadata. If its filterMatchCriteria is set to
10705 # MATCH_ALL, then all of its filterLabels must match with
10706 # corresponding labels provided in the metadata. If multiple
10707 # metadata filters are specified, all of them need to be
10708 # satisfied in order to be considered a match.
10709 #
10710 # metadataFilters specified here is applied after those
10711 # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
10712 #
10713 # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
10714 #
10715 # Not supported when the URL map is bound to a target gRPC proxy that
10716 # has validateForProxyless field set to true.
10717 { # Opaque filter criteria used by load balancers to restrict routing
10718 # configuration to a limited set of load balancing proxies. Proxies and
10719 # sidecars involved in load balancing would typically present metadata to the
10720 # load balancers that need to match criteria specified here. If a match takes
10721 # place, the relevant configuration is made available to those
10722 # proxies.
10723 #
10724 # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
10725 # one of thefilterLabels must match the corresponding label provided in
10726 # the metadata. If its filterMatchCriteria is set to
10727 # MATCH_ALL, then all of its filterLabels must match with
10728 # corresponding labels provided in the metadata.
10729 #
10730 # An example for using metadataFilters would be: if
10731 # load balancing involves
10732 # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in of their XDS requests to loadbalancers.
10733 &quot;filterLabels&quot;: [ # The list of label value pairs that must match labels in the provided
10734 # metadata based on filterMatchCriteria
10735 #
10736 # This list must not be empty and can have at the most 64 entries.
10737 { # MetadataFilter label name value pairs that are expected
10738 # to match corresponding labels presented as metadata to the load balancer.
10739 &quot;name&quot;: &quot;A String&quot;, # Name of metadata label.
10740 #
10741 # The name can have a maximum length of 1024 characters and must be at
10742 # least 1 character long.
10743 &quot;value&quot;: &quot;A String&quot;, # The value of the label must match the specified value.
10744 #
10745 # value can have a maximum length of 1024 characters.
10746 },
10747 ],
10748 &quot;filterMatchCriteria&quot;: &quot;A String&quot;, # Specifies how individual filter label matches
10749 # within the list of filterLabels and contributes toward the
10750 # overall metadataFilter match.
10751 #
10752 # Supported values are:
10753 #
10754 # - MATCH_ANY: at least one of the filterLabels
10755 # must have a matching label in the provided metadata.
10756 # - MATCH_ALL: all filterLabels must have
10757 # matching labels in the provided metadata.
10758 },
10759 ],
10760 &quot;pathTemplateMatch&quot;: &quot;A String&quot;, # If specified, this field defines a path template pattern that must match
10761 # the :path header after the query string is removed.
10762 #
10763 # A path template pattern can include variables and wildcards.
10764 # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
10765 # matches a single path segment, and ** that matches zero or
10766 # more path segments. The pattern must follow these rules:
10767 #
10768 #
10769 # - The value must be between 1 and 1024 characters.
10770 # - The pattern must start with a leading slash (&quot;/&quot;).
10771 # - No more than 5 operators (variables or wildcards) may appear in
10772 # the pattern.
10773 #
10774 # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
10775 # set.
10776 &quot;prefixMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the request&#x27;s
10777 # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
10778 #
10779 # The value must be from 1 to 1024 characters.
10780 #
10781 # The * character inside a prefix match is
10782 # treated as a literal character, not as a wildcard.
10783 #
10784 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
10785 # used within a matchRule.
10786 &quot;queryParameterMatches&quot;: [ # Specifies a list of query parameter match criteria, all of which must
10787 # match corresponding query parameters in the request.
10788 #
10789 # Not supported when the URL map is bound to a target gRPC proxy.
10790 { # HttpRouteRuleMatch criteria for a request&#x27;s query parameter.
10791 &quot;exactMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
10792 # parameter exactly matches the contents of exactMatch.
10793 #
10794 # Only one of presentMatch, exactMatch, orregexMatch must be set.
10795 &quot;name&quot;: &quot;A String&quot;, # The name of the query parameter to match. The query parameter must exist in
10796 # the request, in the absence of which the request match fails.
10797 &quot;presentMatch&quot;: True or False, # Specifies that the queryParameterMatch matches if the
10798 # request contains the query parameter, irrespective of whether the
10799 # parameter has a value or not.
10800 #
10801 # Only one of presentMatch, exactMatch, orregexMatch must be set.
10802 &quot;regexMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
10803 # parameter matches the regular expression specified byregexMatch. For
10804 # more information about regular expression syntax, see Syntax.
10805 #
10806 # Only one of presentMatch, exactMatch, orregexMatch must be set.
10807 #
10808 # Regular expressions can only be used when the loadBalancingScheme is
10809 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
10810 # (regional scope) or INTERNAL_MANAGED.
10811 },
10812 ],
10813 &quot;regexMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
10814 # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
10815 # supplied with the original URL. For
10816 # more information about regular expression syntax, see Syntax.
10817 #
10818 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
10819 # specified.
10820 #
10821 # Regular expressions can only be used when the loadBalancingScheme is
10822 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
10823 # (regional scope) or INTERNAL_MANAGED.
10824 },
10825 ],
10826 &quot;priority&quot;: 42, # For routeRules within a given pathMatcher,
10827 # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
10828 # of priority, from the lowest to highest number. The priority of a
10829 # rule decreases as its number increases (1, 2, 3, N+1). The first rule
10830 # that matches the request is applied.
10831 #
10832 #
10833 # You cannot configure two or more routeRules with the same priority.
10834 # Priority for each rule must be set to a number from 0 to 2147483647
10835 # inclusive.
10836 #
10837 #
10838 # Priority numbers can have gaps, which enable you to add or remove rules
10839 # in the future without affecting the rest of the rules. For example, 1, 2,
10840 # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
10841 # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
10842 # without any impact on existing rules.
10843 &quot;routeAction&quot;: { # In response to a matching matchRule, the load balancer
10844 # performs advanced routing actions, such as URL rewrites and header
10845 # transformations, before forwarding the request to the selected backend.
10846 #
10847 #
10848 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
10849 #
10850 #
10851 # URL maps for classic Application Load Balancers only support
10852 # the urlRewrite action within a route rule&#x27;srouteAction.
10853 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
10854 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
10855 # property must be specified. This policy cannot be specified if any target
10856 # backend has Identity-Aware Proxy enabled.
10857 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
10858 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
10859 # header names can be specified. The cache is bypassed for all `cacheMode`
10860 # values.
10861 &quot;A String&quot;,
10862 ],
10863 &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
10864 # on the backend type: for Backend Services, the complete request URI is
10865 # used; for Backend Buckets, the request URI is used without the protocol or
10866 # host, and only query parameters known to Cloud Storage are included.
10867 # Policy defined on Route Action.
10868 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
10869 # parameters will be included. Either specify `excludedQueryParameters`
10870 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
10871 # encoded and not treated as delimiters.
10872 #
10873 # Note: This field applies to routes that use backend services. Attempting
10874 # to set it on a route that points exclusively to Backend Buckets will
10875 # result in a configuration error. For routes that point to a Backend
10876 # Bucket, use `includedQueryParameters` to define which parameters should
10877 # be part of the cache key.
10878 &quot;A String&quot;,
10879 ],
10880 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
10881 #
10882 # Note: This setting is only applicable to routes that use a Backend
10883 # Service. It does not affect requests served by a Backend Bucket, as the
10884 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
10885 # it on a route that points exclusively to Backend Buckets will result in a
10886 # configuration error.
10887 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
10888 #
10889 # Note: This setting is only applicable to routes that use a Backend
10890 # Service. It does not affect requests served by a Backend Bucket, as the
10891 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
10892 # set on a route that points exclusively to Backend Buckets will result in
10893 # a configuration error.
10894 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
10895 # `includedQueryParameters` and `excludedQueryParameters`. If neither
10896 # is set, the entire query string will be included. If false, the query
10897 # string will be excluded from the cache key entirely.
10898 #
10899 # Note: This field applies to routes that use backend services. Attempting
10900 # to set it on a route that points exclusively to Backend Buckets will
10901 # result in a configuration error. For routes that point to a Backend
10902 # Bucket, use `includedQueryParameters` to define which parameters should
10903 # be part of the cache key.
10904 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
10905 # The name=value pair will be used in the cache key Cloud CDN generates.
10906 #
10907 # Note: This setting is only applicable to routes that use a Backend
10908 # Service. It does not affect requests served by a Backend Bucket.
10909 # Attempting to set it on a route that points exclusively to Backend
10910 # Buckets will result in a configuration error. Up to 5 cookie names can be
10911 # specified.
10912 &quot;A String&quot;,
10913 ],
10914 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
10915 &quot;A String&quot;,
10916 ],
10917 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
10918 # parameters will be excluded. Either specify `includedQueryParameters`
10919 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
10920 # encoded and not treated as delimiters.
10921 &quot;A String&quot;,
10922 ],
10923 },
10924 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
10925 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
10926 &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
10927 # content. This is used to clamp the max-age (or Expires) value sent to the
10928 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
10929 # is used for the response max-age directive, along with a &quot;public&quot;
10930 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
10931 # clamps the max-age from the origin (if specified), or else sets the
10932 # response max-age directive to the lesser of the `clientTtl` and
10933 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
10934 # present. The maximum allowed value is 31,622,400s (1 year). If not
10935 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
10936 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
10937 # `USE_ORIGIN_HEADERS`.
10938 # as a count of seconds and fractions of seconds at nanosecond
10939 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10940 # or &quot;month&quot;. Range is approximately 10,000 years.
10941 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10942 # Durations less than one second are represented with a 0
10943 # `seconds` field and a positive `nanos` field. Must be from 0
10944 # to 999,999,999 inclusive.
10945 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10946 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10947 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10948 },
10949 &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
10950 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
10951 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
10952 # greater than that of `maxTtl`. When the `cacheMode` is set to
10953 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
10954 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
10955 # accessed objects may be evicted from the cache before the defined TTL. If
10956 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
10957 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
10958 # `USE_ORIGIN_HEADERS`.
10959 # as a count of seconds and fractions of seconds at nanosecond
10960 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10961 # or &quot;month&quot;. Range is approximately 10,000 years.
10962 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10963 # Durations less than one second are represented with a 0
10964 # `seconds` field and a positive `nanos` field. Must be from 0
10965 # to 999,999,999 inclusive.
10966 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10967 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10968 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10969 },
10970 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
10971 # attempt to set a max-age or s-maxage higher than this, or an Expires header
10972 # more than `maxTtl` seconds in the future will be capped at the value of
10973 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
10974 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
10975 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
10976 # Infrequently accessed objects may be evicted from the cache before the
10977 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
10978 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
10979 # mode.
10980 # as a count of seconds and fractions of seconds at nanosecond
10981 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10982 # or &quot;month&quot;. Range is approximately 10,000 years.
10983 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10984 # Durations less than one second are represented with a 0
10985 # `seconds` field and a positive `nanos` field. Must be from 0
10986 # to 999,999,999 inclusive.
10987 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10988 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10989 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10990 },
10991 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
10992 # to apply fine-grained caching for common errors or redirects.
10993 # This can reduce the load on your origin and improve end-user
10994 # experience by reducing response latency.
10995 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
10996 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
10997 # the specified response code that lack any Cache-Control, Expires, or
10998 # Pragma: no-cache directives. When the `cacheMode` is set to
10999 # `FORCE_CACHE_ALL`, negative caching applies to all responses
11000 # with the specified response code, and overrides any caching headers. By
11001 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
11002 #
11003 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
11004 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
11005 # * 405 (Method Not Found), 501 (Not Implemented): 60s
11006 #
11007 # These defaults can be overridden in `negativeCachingPolicy`.
11008 # If not specified, Cloud CDN applies negative caching by default.
11009 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
11010 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
11011 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
11012 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
11013 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
11014 # all response codes that you wish to cache. Cloud CDN will not apply any
11015 # default negative caching when a policy exists.
11016 { # Specify CDN TTLs for response error codes.
11017 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
11018 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
11019 # specified as values, and you cannot specify a status code more than
11020 # once.
11021 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
11022 # corresponding status code.
11023 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
11024 # objects may be evicted from the cache before the defined TTL.
11025 # as a count of seconds and fractions of seconds at nanosecond
11026 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
11027 # or &quot;month&quot;. Range is approximately 10,000 years.
11028 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
11029 # Durations less than one second are represented with a 0
11030 # `seconds` field and a positive `nanos` field. Must be from 0
11031 # to 999,999,999 inclusive.
11032 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
11033 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
11034 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
11035 },
11036 },
11037 ],
11038 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
11039 # requests into a small number of requests to the origin. If not specified,
11040 # Cloud CDN applies request coalescing by default.
11041 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
11042 # content with the origin, or when an error is encountered when refreshing
11043 # the cache.
11044 # This setting defines the default &quot;max-stale&quot; duration for any cached
11045 # responses that do not specify a max-stale directive. Stale responses that
11046 # exceed the TTL configured here will not be served. The default limit
11047 # (max-stale) is 86400s (1 day), which will allow stale content to be
11048 # served up to this limit beyond the max-age (or s-maxage) of a cached
11049 # response.
11050 # The maximum allowed value is 604800 (1 week).
11051 # Set this to zero (0) to disable serve-while-stale.
11052 # as a count of seconds and fractions of seconds at nanosecond
11053 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
11054 # or &quot;month&quot;. Range is approximately 10,000 years.
11055 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
11056 # Durations less than one second are represented with a 0
11057 # `seconds` field and a positive `nanos` field. Must be from 0
11058 # to 999,999,999 inclusive.
11059 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
11060 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
11061 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
11062 },
11063 },
11064 &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
11065 # information about the W3C recommendation for cross-origin resource sharing
11066 # (CORS), see Fetch API Living
11067 # Standard.
11068 #
11069 # Not supported when the URL map is bound to a target gRPC proxy.
11070 # information about the W3C recommendation for cross-origin resource sharing
11071 # (CORS), see Fetch API Living
11072 # Standard.
11073 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
11074 # indicates that
11075 # the actual request can include user credentials. This field translates to
11076 # the Access-Control-Allow-Credentials header.
11077 #
11078 # Default is false.
11079 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
11080 # header.
11081 &quot;A String&quot;,
11082 ],
11083 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
11084 # header.
11085 &quot;A String&quot;,
11086 ],
11087 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
11088 # more information, see regular expression syntax.
11089 #
11090 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
11091 #
11092 # Regular expressions can only be used when the loadBalancingScheme is
11093 # set to INTERNAL_SELF_MANAGED.
11094 &quot;A String&quot;,
11095 ],
11096 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
11097 #
11098 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
11099 &quot;A String&quot;,
11100 ],
11101 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
11102 # The default value is false, which indicates that the CORS
11103 # policy is in effect.
11104 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
11105 # header.
11106 &quot;A String&quot;,
11107 ],
11108 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
11109 # seconds. This field translates to the Access-Control-Max-Age
11110 # header.
11111 },
11112 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
11113 # the resiliency of clients to backend service failure. As part of fault
11114 # injection, when clients send requests to a backend service, delays can be
11115 # introduced by a load balancer on a percentage of requests before sending
11116 # those requests to the backend service. Similarly requests from clients can
11117 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
11118 # that are configured with a fault_injection_policy if:
11119 # 1. The traffic is generated by fault injection AND
11120 # 2. The fault injection is not a delay fault injection.
11121 # Fault injection is not supported with the classic Application Load Balancer
11122 # . To see which load balancers support fault injection,
11123 # see Load
11124 # balancing: Routing and traffic management features.
11125 # the resiliency of clients to backend service failure. As part of fault
11126 # injection, when clients send requests to a backend service, delays can be
11127 # introduced by the load balancer on a percentage of requests before sending
11128 # those request to the backend service. Similarly requests from clients can be
11129 # aborted by the load balancer for a percentage of requests.
11130 &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
11131 # injection.
11132 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
11133 #
11134 # The value must be from 200 to 599 inclusive.
11135 #
11136 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
11137 # according to this
11138 # mapping table. HTTP status 200 is mapped to gRPC status
11139 # UNKNOWN. Injecting an OK status is currently not supported by
11140 # Traffic Director.
11141 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
11142 # that is aborted as part of fault injection.
11143 #
11144 # The value must be from 0.0 to 100.0 inclusive.
11145 },
11146 &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
11147 # injection, before being sent to a backend service.
11148 # request to the backend service as part of fault injection.
11149 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
11150 # as a count of seconds and fractions of seconds at nanosecond
11151 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
11152 # or &quot;month&quot;. Range is approximately 10,000 years.
11153 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
11154 # Durations less than one second are represented with a 0
11155 # `seconds` field and a positive `nanos` field. Must be from 0
11156 # to 999,999,999 inclusive.
11157 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
11158 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
11159 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
11160 },
11161 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
11162 # which a delay is introduced as part of fault injection.
11163 #
11164 # The value must be from 0.0 to 100.0 inclusive.
11165 },
11166 },
11167 &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
11168 # Global EXTERNAL_MANAGED load balancer schemes.
11169 # Either Cloud CDN must be enabled on the backend service or backend bucket
11170 # serving the route, or cache policy must be configured on the same route
11171 # dynamically processes and delivers images from the network edge.
11172 # Image Optimization is only available for Global External Application Load
11173 # Balancers.
11174 # Either Cloud CDN must be enabled on the backend service or backend bucket
11175 # serving the route, or cache policy must be configured on the same route.
11176 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
11177 },
11178 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
11179 # Unlike the timeout field where the timeout duration starts
11180 # from the time the request has been fully processed (known as*end-of-stream*),
11181 # the duration in this field is computed from the beginning of the stream
11182 # until the response has been processed, including all retries. A
11183 # stream that does not complete in this duration is closed.
11184 #
11185 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
11186 # with the route.
11187 #
11188 # This field is only allowed if the Url map is used with backend services
11189 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
11190 # as a count of seconds and fractions of seconds at nanosecond
11191 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
11192 # or &quot;month&quot;. Range is approximately 10,000 years.
11193 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
11194 # Durations less than one second are represented with a 0
11195 # `seconds` field and a positive `nanos` field. Must be from 0
11196 # to 999,999,999 inclusive.
11197 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
11198 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
11199 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
11200 },
11201 &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
11202 # are shadowed to a separate mirrored backend service. The load balancer does
11203 # not wait for responses from the shadow service. Before sending traffic
11204 # to the shadow service, the host / authority header is suffixed with-shadow.
11205 #
11206 # Not supported when the URL map is bound to a target gRPC proxy that
11207 # has the validateForProxyless field set to true.
11208 # are shadowed to a separate mirrored backend service. The load balancer
11209 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
11210 # to the shadow service, the host or authority header is suffixed with-shadow.
11211 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
11212 # mirrored to.
11213 #
11214 # The backend service configured for a mirroring
11215 # policy must reference backends that are of the same type as the original
11216 # backend service matched in the URL map.
11217 #
11218 # Serverless NEG backends are not currently supported as a mirrored
11219 # backend service.
11220 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
11221 },
11222 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
11223 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
11224 # If not specified, defaults to 1.
11225 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
11226 #
11227 # If not specified, will use the timeout set in theHttpRouteAction field.
11228 # If timeout in the HttpRouteAction field is not set, this field
11229 # uses the largest timeout
11230 # among all backend services associated with the route.
11231 #
11232 # Not supported when the URL map is bound to a target gRPC proxy that
11233 # has the validateForProxyless field set to true.
11234 # as a count of seconds and fractions of seconds at nanosecond
11235 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
11236 # or &quot;month&quot;. Range is approximately 10,000 years.
11237 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
11238 # Durations less than one second are represented with a 0
11239 # `seconds` field and a positive `nanos` field. Must be from 0
11240 # to 999,999,999 inclusive.
11241 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
11242 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
11243 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
11244 },
11245 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
11246 # values are:
11247 #
11248 # - 5xx: retry is attempted if the instance or endpoint
11249 # responds with any 5xx response code, or if the instance or
11250 # endpoint does not respond at all. For example, disconnects, reset, read
11251 # timeout, connection failure, and refused streams.
11252 # - gateway-error: Similar to 5xx, but only
11253 # applies to response codes 502, 503 or504.
11254 # - connect-failure: a retry is attempted on failures
11255 # connecting to the instance or endpoint. For example, connection
11256 # timeouts.
11257 # - retriable-4xx: a retry is attempted if the instance
11258 # or endpoint responds with a 4xx response code.
11259 # The only error that you can retry is error code 409.
11260 # - refused-stream: a retry is attempted if the instance
11261 # or endpoint resets the stream with a REFUSED_STREAM error
11262 # code. This reset type indicates that it is safe to retry.
11263 # - cancelled: a retry is attempted if the gRPC status
11264 # code in the response header is set to cancelled.
11265 # - deadline-exceeded: a retry is attempted if the gRPC
11266 # status code in the response header is set todeadline-exceeded.
11267 # - internal: a retry is attempted if the gRPC
11268 # status code in the response header is set tointernal.
11269 # - resource-exhausted: a retry is attempted if the gRPC
11270 # status code in the response header is set toresource-exhausted.
11271 # - unavailable: a retry is attempted if the gRPC
11272 # status code in the response header is set tounavailable.
11273 #
11274 # Only the following codes are supported when the URL map is bound to
11275 # target gRPC proxy that has validateForProxyless field set to true.
11276 #
11277 # - cancelled
11278 # - deadline-exceeded
11279 # - internal
11280 # - resource-exhausted
11281 # - unavailable
11282 &quot;A String&quot;,
11283 ],
11284 },
11285 &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
11286 # time the request has been fully processed (known as *end-of-stream*)
11287 # up until the response has been processed. Timeout includes
11288 # all retries.
11289 #
11290 # If not specified, this field uses the largest timeout among all backend
11291 # services associated with the route.
11292 #
11293 # Not supported when the URL map is bound to a target gRPC proxy that
11294 # has validateForProxyless field set to true.
11295 # as a count of seconds and fractions of seconds at nanosecond
11296 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
11297 # or &quot;month&quot;. Range is approximately 10,000 years.
11298 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
11299 # Durations less than one second are represented with a 0
11300 # `seconds` field and a positive `nanos` field. Must be from 0
11301 # to 999,999,999 inclusive.
11302 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
11303 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
11304 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
11305 },
11306 &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
11307 # to the matched service.
11308 #
11309 # urlRewrite is the only action supported in UrlMaps
11310 # for classic Application Load Balancers.
11311 #
11312 # Not supported when the URL map is bound to a target gRPC proxy that
11313 # has the validateForProxyless field set to true.
11314 # backend service.
11315 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
11316 # host header is replaced with contents of hostRewrite.
11317 #
11318 # The value must be from 1 to 255 characters.
11319 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
11320 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
11321 #
11322 # The value must be from 1 to 1024 characters.
11323 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
11324 # header) using the HTTP template syntax.
11325 #
11326 # A corresponding
11327 # path_template_match must be specified. Any template variables must exist in
11328 # the path_template_match field.
11329 #
11330 #
11331 # - -At least one variable must be specified in the path_template_match
11332 # field
11333 # - You can omit variables from the rewritten URL
11334 # - The * and ** operators cannot be matched
11335 # unless they have a corresponding variable name - e.g.
11336 # {format=*} or {var=**}.
11337 #
11338 # For example, a path_template_match of /static/{format=**}
11339 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
11340 # rewrite, so that /{country}/{format}/{suffix=**} can be
11341 # rewritten as /content/{format}/{country}/{suffix}.
11342 #
11343 # At least
11344 # one non-empty routeRules[].matchRules[].path_template_match is
11345 # required.
11346 #
11347 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
11348 },
11349 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
11350 # occurs. The weights determine the fraction of traffic that flows to
11351 # their corresponding backend service. If all traffic needs to
11352 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
11353 #
11354 # After a backend service is identified and before forwarding
11355 # the request to
11356 # the backend service, advanced routing actions such as URL rewrites and
11357 # header transformations are applied depending on additional settings
11358 # specified in this HttpRouteAction.
11359 { # In contrast to a single BackendService in
11360 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
11361 # multiple backend services. The volume of traffic for each
11362 # backend service is proportional to the weight specified
11363 # in each WeightedBackendService
11364 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
11365 # resource. Before
11366 # forwarding the request to backendService, the load balancer
11367 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
11368 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
11369 # effect for the selected backendService.
11370 #
11371 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
11372 #
11373 # headerAction is not supported for load balancers that have
11374 # their loadBalancingScheme set to EXTERNAL.
11375 #
11376 # Not supported when the URL map is bound to a target gRPC proxy that
11377 # has validateForProxyless field set to true.
11378 # the request is passed along to the selected backendService.
11379 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
11380 { # Specification determining how headers are added to requests or responses.
11381 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
11382 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
11383 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
11384 # that already
11385 # exist for the header. If true, headerValue is set for the
11386 # header, discarding any values that were set for that header.
11387 #
11388 # The default value is true,
11389 # unless a variable is present in headerValue,
11390 # in which case the default value is false.
11391 # .
11392 },
11393 ],
11394 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
11395 # request before forwarding the request to the backendService.
11396 &quot;A String&quot;,
11397 ],
11398 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
11399 # client.
11400 { # Specification determining how headers are added to requests or responses.
11401 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
11402 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
11403 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
11404 # that already
11405 # exist for the header. If true, headerValue is set for the
11406 # header, discarding any values that were set for that header.
11407 #
11408 # The default value is true,
11409 # unless a variable is present in headerValue,
11410 # in which case the default value is false.
11411 # .
11412 },
11413 ],
11414 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
11415 # response before sending the response back to the client.
11416 &quot;A String&quot;,
11417 ],
11418 },
11419 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
11420 # computed asweight / (sum of all weightedBackendService weights in routeAction).
11421 #
11422 # The selection of a backend service is determined only for new traffic.
11423 # Once a user&#x27;s request has been directed to a backend service,
11424 # subsequent requests are sent to the same backend service as
11425 # determined by the backend service&#x27;s session affinity policy.
11426 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
11427 # splitting. If you do, the weighted traffic splitting configuration takes
11428 # precedence.
11429 #
11430 # The value must be from 0 to 1000.
11431 },
11432 ],
11433 },
11434 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
11435 # is directed if this rule is matched. If routeAction is
11436 # also specified, advanced routing actions, such as URL rewrites,
11437 # take effect before sending the request to the backend.
11438 #
11439 #
11440 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
11441 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
11442 # specified by urlRedirect.
11443 #
11444 #
11445 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
11446 #
11447 #
11448 # Not supported when the URL map is bound to a target gRPC proxy.
11449 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
11450 # was supplied in the request.
11451 #
11452 # The value must be from 1 to 255
11453 # characters.
11454 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
11455 # set to HTTPS.
11456 # If set to false, the URL scheme of the redirected request
11457 # remains the same as that of the request.
11458 #
11459 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
11460 #
11461 # The default is set to false.
11462 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
11463 # that was supplied in the request.
11464 #
11465 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
11466 # supplied, the path of the original request is used for the redirect.
11467 #
11468 # The value must be from 1 to 1024 characters.
11469 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
11470 # the HttpRouteRuleMatch, retaining the remaining portion
11471 # of the URL before redirecting the request.
11472 #
11473 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
11474 # supplied, the path of the original request is used for the redirect.
11475 #
11476 # The value must be from 1 to 1024 characters.
11477 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
11478 #
11479 # Supported values are:
11480 #
11481 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
11482 # to 301.
11483 # - FOUND, which corresponds to 302.
11484 # - SEE_OTHER which corresponds to 303.
11485 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
11486 # method is retained.
11487 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
11488 # method is retained.
11489 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
11490 # URL is
11491 # removed before redirecting the request. If set to false, the
11492 # query portion of the original URL is retained.
11493 #
11494 # The default is set to false.
11495 },
11496 },
11497 ],
11498 },
11499 ],
11500 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the regional URL map resides.
11501 # This field is not applicable to global URL maps.
11502 # You must specify this field as part of the HTTP request URL. It is
11503 # not settable as a field in the request body.
11504 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
11505 &quot;status&quot;: { # [Output Only] The status of the URL map. # Output only. [Output Only] The status of the URL map.
11506 &quot;quotaUsage&quot;: { # Message representing the quota usage for a UrlMap. # Output only. Summary of quota usage for given UrlMap.
11507 &quot;forwardingRules&quot;: 42, # Output only. The number of forwarding rules that uses this UrlMap.
11508 &quot;units&quot;: &quot;A String&quot;, # Output only. The number of quota units calculated for this UrlMap.
11509 },
11510 },
11511 &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
11512 # maximum of 100 tests per UrlMap.
11513 #
11514 # Not supported when the URL map is bound to a target gRPC proxy that
11515 # has validateForProxyless field set to true.
11516 { # Message for the expected URL mappings.
11517 &quot;description&quot;: &quot;A String&quot;, # Description of this test case.
11518 &quot;expectedOutputUrl&quot;: &quot;A String&quot;, # The expected output URL evaluated by the load balancer
11519 # containing the scheme, host, path and query parameters.
11520 #
11521 # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
11522 # the load balancer to backends. For rules with urlRewrite,
11523 # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
11524 #
11525 # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer&#x27;s
11526 # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
11527 # If urlRedirect specifies strip_query, the test
11528 # passes only if expectedOutputUrl does not contain any query
11529 # parameters.
11530 #
11531 # expectedOutputUrl is optional whenservice is specified.
11532 &quot;expectedRedirectResponseCode&quot;: 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
11533 # load balancer&#x27;s redirect response.
11534 #
11535 # expectedRedirectResponseCode cannot be set whenservice is set.
11536 &quot;headers&quot;: [ # HTTP headers for this request. If headers contains
11537 # a host header, then host must also match the header value.
11538 { # HTTP headers used in UrlMapTests.
11539 &quot;name&quot;: &quot;A String&quot;, # Header name.
11540 &quot;value&quot;: &quot;A String&quot;, # Header value.
11541 },
11542 ],
11543 &quot;host&quot;: &quot;A String&quot;, # Host portion of the URL. If headers contains a host header,
11544 # then host must also match the header value.
11545 &quot;path&quot;: &quot;A String&quot;, # Path portion of the URL.
11546 &quot;service&quot;: &quot;A String&quot;, # Expected BackendService or BackendBucket resource
11547 # the given URL should be mapped to.
11548 #
11549 # The service field cannot
11550 # be set if expectedRedirectResponseCode is set.
11551 },
11552 ],
11553 }
11554
11555 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
11556 that if you must retry your request, the server will know to ignore the
11557 request if it has already been completed.
11558
11559 For example, consider a situation where you make an initial request and
11560 the request times out. If you make the request again with the same
11561 request ID, the server can check if original operation with the same
11562 request ID was received, and if so, will ignore the second request. This
11563 prevents clients from accidentally creating duplicate commitments.
11564
11565 The request ID must be
11566 a valid UUID with the exception that zero UUID is not supported
11567 (00000000-0000-0000-0000-000000000000).
11568 x__xgafv: string, V1 error format.
11569 Allowed values
11570 1 - v1 error format
11571 2 - v2 error format
11572
11573 Returns:
11574 An object of the form:
11575
11576 { # Represents an Operation resource.
11577 #
11578 # Google Compute Engine has three Operation resources:
11579 #
11580 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
11581 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
11582 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
11583 #
11584 # You can use an operation resource to manage asynchronous API requests.
11585 # For more information, readHandling
11586 # API responses.
11587 #
11588 # Operations can be global, regional or zonal.
11589 #
11590 # - For global operations, use the `globalOperations`
11591 # resource.
11592 # - For regional operations, use the
11593 # `regionOperations` resource.
11594 # - For zonal operations, use
11595 # the `zoneOperations` resource.
11596 #
11597 #
11598 #
11599 # For more information, read
11600 # Global, Regional, and Zonal Resources.
11601 #
11602 # Note that completed Operation resources have a limited
11603 # retention period.
11604 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
11605 # Not present otherwise.
11606 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
11607 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
11608 # set when the operation is created.
11609 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
11610 # text format.
11611 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
11612 # this field will be populated.
11613 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
11614 # operation.
11615 {
11616 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
11617 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
11618 # details. There is a set of defined message types to use for providing
11619 # details.The syntax depends on the error code. For example,
11620 # QuotaExceededInfo will have details when the error code is
11621 # QUOTA_EXCEEDED.
11622 {
11623 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
11624 #
11625 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
11626 # is not enabled:
11627 #
11628 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
11629 # &quot;domain&quot;: &quot;googleapis.com&quot;
11630 # &quot;metadata&quot;: {
11631 # &quot;resource&quot;: &quot;projects/123&quot;,
11632 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
11633 # }
11634 # }
11635 #
11636 # This response indicates that the pubsub.googleapis.com API is not enabled.
11637 #
11638 # Example of an error that is returned when attempting to create a Spanner
11639 # instance in a region that is out of stock:
11640 #
11641 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
11642 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
11643 # &quot;metadata&quot;: {
11644 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
11645 # }
11646 # }
11647 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
11648 # is typically the registered service name of the tool or product that
11649 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
11650 # generated by some common infrastructure, the error domain must be a
11651 # globally unique value that identifies the infrastructure. For Google API
11652 # infrastructure, the error domain is &quot;googleapis.com&quot;.
11653 &quot;metadatas&quot;: { # Additional structured details about this error.
11654 #
11655 # Keys must match a regular expression of `a-z+` but should
11656 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
11657 # length. When identifying the current value of an exceeded limit, the units
11658 # should be contained in the key, not the value. For example, rather than
11659 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
11660 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
11661 # instances that can be created in a single (batch) request.
11662 &quot;a_key&quot;: &quot;A String&quot;,
11663 },
11664 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
11665 # proximate cause of the error. Error reasons are unique within a particular
11666 # domain of errors. This should be at most 63 characters and match a
11667 # regular expression of `A-Z+[A-Z0-9]`, which represents
11668 # UPPER_SNAKE_CASE.
11669 },
11670 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
11671 #
11672 # For example, if a quota check failed with an error indicating the calling
11673 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
11674 # directly to the right place in the developer console to flip the bit.
11675 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
11676 { # Describes a URL link.
11677 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
11678 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
11679 },
11680 ],
11681 },
11682 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
11683 # which can be attached to an RPC error.
11684 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
11685 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
11686 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
11687 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
11688 },
11689 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
11690 &quot;dimensions&quot;: { # The map holding related quota dimensions.
11691 &quot;a_key&quot;: &quot;A String&quot;,
11692 },
11693 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
11694 # type or metric.
11695 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
11696 # or metric.
11697 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
11698 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
11699 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
11700 },
11701 },
11702 ],
11703 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
11704 # This property is optional.
11705 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
11706 },
11707 ],
11708 },
11709 &quot;getVersionOperationMetadata&quot;: {
11710 &quot;inlineSbomInfo&quot;: {
11711 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
11712 # appropriate identifiers.
11713 &quot;a_key&quot;: &quot;A String&quot;,
11714 },
11715 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
11716 # identifiers.
11717 &quot;a_key&quot;: &quot;A String&quot;,
11718 },
11719 },
11720 },
11721 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
11722 # message that was returned, such as `NOT FOUND`.
11723 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
11724 # status code that was returned. For example, a `404` means the
11725 # resource was not found.
11726 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
11727 # defined by the server.
11728 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
11729 # This value is inRFC3339
11730 # text format.
11731 &quot;instancesBulkInsertOperationMetadata&quot;: {
11732 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
11733 # Example key: zones/us-central1-a
11734 &quot;a_key&quot;: {
11735 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
11736 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
11737 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
11738 # error.
11739 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
11740 # if the flow is rolling forward or rolling back.
11741 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
11742 },
11743 },
11744 },
11745 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
11746 # Operation resources.
11747 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
11748 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
11749 # group of operations results from a `bulkInsert` API request.
11750 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
11751 # `update`, or `delete`, and so on.
11752 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
11753 # There is no requirement that this be linear or support any granularity of
11754 # operations. This should not be used to guess when the operation will be
11755 # complete. This number should monotonically increase as the operation
11756 # progresses.
11757 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
11758 # applicable when performing regional operations.
11759 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
11760 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
11761 # this field will contain information on all underlying zonal actions and
11762 # their state.
11763 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
11764 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
11765 # Example key: zones/us-central1-a
11766 &quot;a_key&quot;: {
11767 &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
11768 # populated.
11769 # different programming environments, including REST APIs and RPC APIs. It is
11770 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
11771 # three pieces of data: error code, error message, and error details.
11772 #
11773 # You can find out more about this error model and how to work with it in the
11774 # [API Design Guide](https://cloud.google.com/apis/design/errors).
11775 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
11776 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
11777 # message types for APIs to use.
11778 {
11779 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
11780 },
11781 ],
11782 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
11783 # user-facing error message should be localized and sent in the
11784 # google.rpc.Status.details field, or localized by the client.
11785 },
11786 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
11787 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
11788 },
11789 },
11790 },
11791 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
11792 # This value is inRFC3339
11793 # text format.
11794 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
11795 # following:
11796 # `PENDING`, `RUNNING`, or `DONE`.
11797 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
11798 # operation.
11799 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
11800 # of the target resource.
11801 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
11802 # operations related to creating a snapshot, this points to the disk
11803 # that the snapshot was created from.
11804 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
11805 # `[email protected]` or
11806 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
11807 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
11808 # operation, this field will be populated.
11809 {
11810 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
11811 # Engine returns NO_RESULTS_ON_PAGE if there
11812 # are no results in the response.
11813 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
11814 # value format. For example:
11815 #
11816 # &quot;data&quot;: [
11817 # {
11818 # &quot;key&quot;: &quot;scope&quot;,
11819 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
11820 # }
11821 {
11822 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
11823 # returned. For example, for warnings where there are no results in a list
11824 # request for a particular zone, this key might be scope and
11825 # the key value might be the zone name. Other examples might be a key
11826 # indicating a deprecated resource and a suggested replacement, or a
11827 # warning about invalid network settings (for example, if an instance
11828 # attempts to perform IP forwarding but is not enabled for IP forwarding).
11829 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
11830 },
11831 ],
11832 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
11833 },
11834 ],
11835 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
11836 # applicable when performing per-zone operations.
11837 }</pre>
11838 </div>
11839
11840 <div class="method">
11841 <code class="details" id="invalidateCache">invalidateCache(project, urlMap, body=None, requestId=None, x__xgafv=None)</code>
11842 <pre>Initiates a cache invalidation operation, invalidating the specified path,
11843 scoped to the specified UrlMap.
11844
11845 For more information, see [Invalidating cached
11846 content](/cdn/docs/invalidating-cached-content).
11847
11848 Args:
11849 project: string, Project ID for this request. (required)
11850 urlMap: string, Name of the UrlMap scoping this request. (required)
11851 body: object, The request body.
11852 The object takes the form of:
11853
11854 {
11855 &quot;cacheTags&quot;: [ # A list of cache tags used to identify cached objects.
11856 #
11857 #
11858 # - Cache tags are specified when the response is first cached, by setting
11859 # the `Cache-Tag` response header at the origin.
11860 # - Multiple cache tags in the same invalidation request are treated as
11861 # Boolean `OR` - for example, `tag1 OR tag2 OR tag3`.
11862 # - If other fields are also specified, these are treated as Boolean `AND`
11863 # with any tags.
11864 #
11865 #
11866 # Up to 10 tags can be specified in a single invalidation request.
11867 &quot;A String&quot;,
11868 ],
11869 &quot;host&quot;: &quot;A String&quot;, # If set, this invalidation rule will only apply to requests with a Host
11870 # header matching host.
11871 &quot;path&quot;: &quot;A String&quot;,
11872 }
11873
11874 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
11875 that if you must retry your request, the server will know to ignore the
11876 request if it has already been completed.
11877
11878 For example, consider a situation where you make an initial request and
11879 the request times out. If you make the request again with the same
11880 request ID, the server can check if original operation with the same
11881 request ID was received, and if so, will ignore the second request. This
11882 prevents clients from accidentally creating duplicate commitments.
11883
11884 The request ID must be
11885 a valid UUID with the exception that zero UUID is not supported
11886 (00000000-0000-0000-0000-000000000000).
11887 x__xgafv: string, V1 error format.
11888 Allowed values
11889 1 - v1 error format
11890 2 - v2 error format
11891
11892 Returns:
11893 An object of the form:
11894
11895 { # Represents an Operation resource.
11896 #
11897 # Google Compute Engine has three Operation resources:
11898 #
11899 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
11900 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
11901 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
11902 #
11903 # You can use an operation resource to manage asynchronous API requests.
11904 # For more information, readHandling
11905 # API responses.
11906 #
11907 # Operations can be global, regional or zonal.
11908 #
11909 # - For global operations, use the `globalOperations`
11910 # resource.
11911 # - For regional operations, use the
11912 # `regionOperations` resource.
11913 # - For zonal operations, use
11914 # the `zoneOperations` resource.
11915 #
11916 #
11917 #
11918 # For more information, read
11919 # Global, Regional, and Zonal Resources.
11920 #
11921 # Note that completed Operation resources have a limited
11922 # retention period.
11923 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
11924 # Not present otherwise.
11925 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
11926 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
11927 # set when the operation is created.
11928 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
11929 # text format.
11930 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
11931 # this field will be populated.
11932 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
11933 # operation.
11934 {
11935 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
11936 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
11937 # details. There is a set of defined message types to use for providing
11938 # details.The syntax depends on the error code. For example,
11939 # QuotaExceededInfo will have details when the error code is
11940 # QUOTA_EXCEEDED.
11941 {
11942 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
11943 #
11944 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
11945 # is not enabled:
11946 #
11947 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
11948 # &quot;domain&quot;: &quot;googleapis.com&quot;
11949 # &quot;metadata&quot;: {
11950 # &quot;resource&quot;: &quot;projects/123&quot;,
11951 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
11952 # }
11953 # }
11954 #
11955 # This response indicates that the pubsub.googleapis.com API is not enabled.
11956 #
11957 # Example of an error that is returned when attempting to create a Spanner
11958 # instance in a region that is out of stock:
11959 #
11960 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
11961 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
11962 # &quot;metadata&quot;: {
11963 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
11964 # }
11965 # }
11966 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
11967 # is typically the registered service name of the tool or product that
11968 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
11969 # generated by some common infrastructure, the error domain must be a
11970 # globally unique value that identifies the infrastructure. For Google API
11971 # infrastructure, the error domain is &quot;googleapis.com&quot;.
11972 &quot;metadatas&quot;: { # Additional structured details about this error.
11973 #
11974 # Keys must match a regular expression of `a-z+` but should
11975 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
11976 # length. When identifying the current value of an exceeded limit, the units
11977 # should be contained in the key, not the value. For example, rather than
11978 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
11979 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
11980 # instances that can be created in a single (batch) request.
11981 &quot;a_key&quot;: &quot;A String&quot;,
11982 },
11983 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
11984 # proximate cause of the error. Error reasons are unique within a particular
11985 # domain of errors. This should be at most 63 characters and match a
11986 # regular expression of `A-Z+[A-Z0-9]`, which represents
11987 # UPPER_SNAKE_CASE.
11988 },
11989 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
11990 #
11991 # For example, if a quota check failed with an error indicating the calling
11992 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
11993 # directly to the right place in the developer console to flip the bit.
11994 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
11995 { # Describes a URL link.
11996 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
11997 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
11998 },
11999 ],
12000 },
12001 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
12002 # which can be attached to an RPC error.
12003 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
12004 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
12005 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
12006 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
12007 },
12008 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
12009 &quot;dimensions&quot;: { # The map holding related quota dimensions.
12010 &quot;a_key&quot;: &quot;A String&quot;,
12011 },
12012 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
12013 # type or metric.
12014 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
12015 # or metric.
12016 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
12017 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
12018 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
12019 },
12020 },
12021 ],
12022 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
12023 # This property is optional.
12024 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
12025 },
12026 ],
12027 },
12028 &quot;getVersionOperationMetadata&quot;: {
12029 &quot;inlineSbomInfo&quot;: {
12030 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
12031 # appropriate identifiers.
12032 &quot;a_key&quot;: &quot;A String&quot;,
12033 },
12034 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
12035 # identifiers.
12036 &quot;a_key&quot;: &quot;A String&quot;,
12037 },
12038 },
12039 },
12040 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
12041 # message that was returned, such as `NOT FOUND`.
12042 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
12043 # status code that was returned. For example, a `404` means the
12044 # resource was not found.
12045 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
12046 # defined by the server.
12047 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
12048 # This value is inRFC3339
12049 # text format.
12050 &quot;instancesBulkInsertOperationMetadata&quot;: {
12051 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
12052 # Example key: zones/us-central1-a
12053 &quot;a_key&quot;: {
12054 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
12055 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
12056 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
12057 # error.
12058 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
12059 # if the flow is rolling forward or rolling back.
12060 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
12061 },
12062 },
12063 },
12064 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
12065 # Operation resources.
12066 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
12067 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
12068 # group of operations results from a `bulkInsert` API request.
12069 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
12070 # `update`, or `delete`, and so on.
12071 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
12072 # There is no requirement that this be linear or support any granularity of
12073 # operations. This should not be used to guess when the operation will be
12074 # complete. This number should monotonically increase as the operation
12075 # progresses.
12076 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
12077 # applicable when performing regional operations.
12078 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
12079 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
12080 # this field will contain information on all underlying zonal actions and
12081 # their state.
12082 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
12083 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
12084 # Example key: zones/us-central1-a
12085 &quot;a_key&quot;: {
12086 &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
12087 # populated.
12088 # different programming environments, including REST APIs and RPC APIs. It is
12089 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
12090 # three pieces of data: error code, error message, and error details.
12091 #
12092 # You can find out more about this error model and how to work with it in the
12093 # [API Design Guide](https://cloud.google.com/apis/design/errors).
12094 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
12095 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
12096 # message types for APIs to use.
12097 {
12098 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
12099 },
12100 ],
12101 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
12102 # user-facing error message should be localized and sent in the
12103 # google.rpc.Status.details field, or localized by the client.
12104 },
12105 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
12106 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
12107 },
12108 },
12109 },
12110 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
12111 # This value is inRFC3339
12112 # text format.
12113 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
12114 # following:
12115 # `PENDING`, `RUNNING`, or `DONE`.
12116 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
12117 # operation.
12118 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
12119 # of the target resource.
12120 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
12121 # operations related to creating a snapshot, this points to the disk
12122 # that the snapshot was created from.
12123 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
12124 # `[email protected]` or
12125 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
12126 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
12127 # operation, this field will be populated.
12128 {
12129 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
12130 # Engine returns NO_RESULTS_ON_PAGE if there
12131 # are no results in the response.
12132 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
12133 # value format. For example:
12134 #
12135 # &quot;data&quot;: [
12136 # {
12137 # &quot;key&quot;: &quot;scope&quot;,
12138 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
12139 # }
12140 {
12141 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
12142 # returned. For example, for warnings where there are no results in a list
12143 # request for a particular zone, this key might be scope and
12144 # the key value might be the zone name. Other examples might be a key
12145 # indicating a deprecated resource and a suggested replacement, or a
12146 # warning about invalid network settings (for example, if an instance
12147 # attempts to perform IP forwarding but is not enabled for IP forwarding).
12148 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
12149 },
12150 ],
12151 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
12152 },
12153 ],
12154 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
12155 # applicable when performing per-zone operations.
12156 }</pre>
12157 </div>
12158
12159 <div class="method">
12160 <code class="details" id="list">list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</code>
12161 <pre>Retrieves the list of UrlMap resources available to the specified
12162 project.
12163
12164 Args:
12165 project: string, Project ID for this request. (required)
12166 filter: string, A filter expression that filters resources listed in the response. Most
12167 Compute resources support two types of filter expressions:
12168 expressions that support regular expressions and expressions that follow
12169 API improvement proposal AIP-160.
12170 These two types of filter expressions cannot be mixed in one request.
12171
12172 If you want to use AIP-160, your expression must specify the field name, an
12173 operator, and the value that you want to use for filtering. The value
12174 must be a string, a number, or a boolean. The operator
12175 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
12176
12177 For example, if you are filtering Compute Engine instances, you can
12178 exclude instances named `example-instance` by specifying
12179 `name != example-instance`.
12180
12181 The `:*` comparison can be used to test whether a key has been defined.
12182 For example, to find all objects with `owner` label use:
12183 ```
12184 labels.owner:*
12185 ```
12186
12187 You can also filter nested fields. For example, you could specify
12188 `scheduling.automaticRestart = false` to include instances only
12189 if they are not scheduled for automatic restarts. You can use filtering
12190 on nested fields to filter based onresource labels.
12191
12192 To filter on multiple expressions, provide each separate expression within
12193 parentheses. For example:
12194 ```
12195 (scheduling.automaticRestart = true)
12196 (cpuPlatform = &quot;Intel Skylake&quot;)
12197 ```
12198 By default, each expression is an `AND` expression. However, you
12199 can include `AND` and `OR` expressions explicitly.
12200 For example:
12201 ```
12202 (cpuPlatform = &quot;Intel Skylake&quot;) OR
12203 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
12204 (scheduling.automaticRestart = true)
12205 ```
12206
12207 If you want to use a regular expression, use the `eq` (equal) or `ne`
12208 (not equal) operator against a single un-parenthesized expression with or
12209 without quotes or against multiple parenthesized expressions. Examples:
12210
12211 `fieldname eq unquoted literal`
12212 `fieldname eq &#x27;single quoted literal&#x27;`
12213 `fieldname eq &quot;double quoted literal&quot;`
12214 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
12215
12216 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
12217 The literal value must match the entire field.
12218
12219 For example, to filter for instances that do not end with name &quot;instance&quot;,
12220 you would use `name ne .*instance`.
12221
12222 You cannot combine constraints on multiple fields using regular
12223 expressions.
12224 maxResults: integer, The maximum number of results per page that should be returned.
12225 If the number of available results is larger than `maxResults`,
12226 Compute Engine returns a `nextPageToken` that can be used to get
12227 the next page of results in subsequent list requests. Acceptable values are
12228 `0` to `500`, inclusive. (Default: `500`)
12229 orderBy: string, Sorts list results by a certain order. By default, results
12230 are returned in alphanumerical order based on the resource name.
12231
12232 You can also sort results in descending order based on the creation
12233 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
12234 results based on the `creationTimestamp` field in
12235 reverse chronological order (newest result first). Use this to sort
12236 resources like operations so that the newest operation is returned first.
12237
12238 Currently, only sorting by `name` or
12239 `creationTimestamp desc` is supported.
12240 pageToken: string, Specifies a page token to use. Set `pageToken` to the
12241 `nextPageToken` returned by a previous list request to get
12242 the next page of results.
12243 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
12244 of failure. The default value is false.
12245
12246 For example, when partial success behavior is enabled, aggregatedList for a
12247 single zone scope either returns all resources in the zone or no resources,
12248 with an error code.
12249 x__xgafv: string, V1 error format.
12250 Allowed values
12251 1 - v1 error format
12252 2 - v2 error format
12253
12254 Returns:
12255 An object of the form:
12256
12257 { # Contains a list of UrlMap resources.
12258 &quot;id&quot;: &quot;A String&quot;, # [Output Only] Unique identifier for the resource; defined by the server.
12259 &quot;items&quot;: [ # A list of UrlMap resources.
12260 { # Represents a URL Map resource.
12261 #
12262 # Compute Engine has two URL Map resources:
12263 #
12264 # * [Global](/compute/docs/reference/rest/beta/urlMaps)
12265 # * [Regional](/compute/docs/reference/rest/beta/regionUrlMaps)
12266 #
12267 # A URL map resource is a component of certain types of cloud load balancers
12268 # and Traffic Director:
12269 #
12270 # * urlMaps are used by global external Application Load
12271 # Balancers, classic Application Load Balancers, and cross-region internal
12272 # Application Load Balancers.
12273 # * regionUrlMaps are used by internal Application Load Balancers,
12274 # regional external Application Load Balancers and regional internal
12275 # Application Load Balancers.
12276 #
12277 # For a list of supported URL map features by the load balancer type, see the
12278 # Load balancing features: Routing and traffic management table.
12279 #
12280 # For a list of supported URL map features for Traffic Director, see the
12281 # Traffic Director features: Routing and traffic management table.
12282 #
12283 # This resource defines mappings from hostnames and URL paths to either a
12284 # backend service or a backend bucket.
12285 #
12286 # To use the global urlMaps resource, the backend service must
12287 # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
12288 # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
12289 # information, read URL
12290 # Map Concepts.
12291 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
12292 # text format.
12293 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
12294 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
12295 #
12296 # This policy takes
12297 # effect at the load balancer level and applies only when no policy has been
12298 # defined for the error code at lower levels like PathMatcher, RouteRule and
12299 # PathRule within this UrlMap.
12300 #
12301 # For example, consider a UrlMap with the
12302 # following configuration:
12303 #
12304 #
12305 # - defaultCustomErrorResponsePolicy containing policies for
12306 # responding to 5xx and 4xx errors
12307 # - A PathMatcher configured for *.example.com has
12308 # defaultCustomErrorResponsePolicy for 4xx.
12309 #
12310 # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
12311 # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
12312 # a request that does not match any host in *.example.com such
12313 # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
12314 # takes effect.
12315 #
12316 # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
12317 # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
12318 # a retry, if load balancer is successful in reaching the
12319 # service, the defaultCustomErrorResponsePolicy is ignored and
12320 # the response from the service is returned to the client.
12321 #
12322 # defaultCustomErrorResponsePolicy is supported only for
12323 # global external Application Load Balancers.
12324 # backend service or backend bucket responds with an error.
12325 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
12326 #
12327 # In a given policy, if you specify rules for both a range of error codes
12328 # as well as rules for specific error codes then rules with specific error
12329 # codes have a higher priority. For example, assume that you configure a rule
12330 # for 401 (Un-authorized) code, and another for all 4 series
12331 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
12332 # However if the backend service returns a 403, the rule for4xx takes effect.
12333 { # Specifies the mapping between the response code that will be returned along
12334 # with the custom error content and the response code returned by the backend
12335 # service.
12336 &quot;matchResponseCodes&quot;: [ # Valid values include:
12337 #
12338 #
12339 # - A number between 400 and 599: For example
12340 # 401 or 503, in which case the load balancer
12341 # applies the policy if the error code exactly matches this value.
12342 # - 5xx: Load Balancer will apply the policy if the
12343 # backend service responds with any response code in the range of
12344 # 500 to 599.
12345 # - 4xx: Load
12346 # Balancer will apply the policy if the backend service responds with any
12347 # response code in the range of 400 to
12348 # 499.
12349 #
12350 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
12351 &quot;A String&quot;,
12352 ],
12353 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
12354 # error content. If overrideResponseCode is not supplied, the
12355 # same response code returned by the original backend bucket or backend
12356 # service is returned to the client.
12357 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
12358 #
12359 # path must start
12360 # with a leading slash. path cannot have trailing slashes.
12361 #
12362 # If the file is not available in backendBucket or the
12363 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
12364 #
12365 # The value must
12366 # be from 1 to 1024 characters
12367 },
12368 ],
12369 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
12370 # contains the custom error content. Examples are:
12371 #
12372 #
12373 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
12374 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
12375 # - global/backendBuckets/myBackendBucket
12376 #
12377 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
12378 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
12379 #
12380 # If load balancer cannot reach
12381 # the backendBucket, a simple Not Found Error will
12382 # be returned, with the original response code (oroverrideResponseCode if configured).
12383 #
12384 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
12385 },
12386 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
12387 # hostRules match. The load balancer performs advanced routing
12388 # actions, such as URL rewrites and header transformations, before forwarding
12389 # the request to the selected backend.
12390 #
12391 #
12392 # Only one of defaultUrlRedirect, defaultService
12393 # or defaultRouteAction.weightedBackendService can be set.
12394 #
12395 #
12396 # URL maps for classic Application Load Balancers only support
12397 # the urlRewrite action within defaultRouteAction.
12398 #
12399 #
12400 # defaultRouteAction has no effect when the URL map is bound
12401 # to a target gRPC proxy that has the validateForProxyless field
12402 # set to true.
12403 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
12404 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
12405 # property must be specified. This policy cannot be specified if any target
12406 # backend has Identity-Aware Proxy enabled.
12407 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
12408 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
12409 # header names can be specified. The cache is bypassed for all `cacheMode`
12410 # values.
12411 &quot;A String&quot;,
12412 ],
12413 &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
12414 # on the backend type: for Backend Services, the complete request URI is
12415 # used; for Backend Buckets, the request URI is used without the protocol or
12416 # host, and only query parameters known to Cloud Storage are included.
12417 # Policy defined on Route Action.
12418 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
12419 # parameters will be included. Either specify `excludedQueryParameters`
12420 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
12421 # encoded and not treated as delimiters.
12422 #
12423 # Note: This field applies to routes that use backend services. Attempting
12424 # to set it on a route that points exclusively to Backend Buckets will
12425 # result in a configuration error. For routes that point to a Backend
12426 # Bucket, use `includedQueryParameters` to define which parameters should
12427 # be part of the cache key.
12428 &quot;A String&quot;,
12429 ],
12430 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
12431 #
12432 # Note: This setting is only applicable to routes that use a Backend
12433 # Service. It does not affect requests served by a Backend Bucket, as the
12434 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
12435 # it on a route that points exclusively to Backend Buckets will result in a
12436 # configuration error.
12437 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
12438 #
12439 # Note: This setting is only applicable to routes that use a Backend
12440 # Service. It does not affect requests served by a Backend Bucket, as the
12441 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
12442 # set on a route that points exclusively to Backend Buckets will result in
12443 # a configuration error.
12444 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
12445 # `includedQueryParameters` and `excludedQueryParameters`. If neither
12446 # is set, the entire query string will be included. If false, the query
12447 # string will be excluded from the cache key entirely.
12448 #
12449 # Note: This field applies to routes that use backend services. Attempting
12450 # to set it on a route that points exclusively to Backend Buckets will
12451 # result in a configuration error. For routes that point to a Backend
12452 # Bucket, use `includedQueryParameters` to define which parameters should
12453 # be part of the cache key.
12454 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
12455 # The name=value pair will be used in the cache key Cloud CDN generates.
12456 #
12457 # Note: This setting is only applicable to routes that use a Backend
12458 # Service. It does not affect requests served by a Backend Bucket.
12459 # Attempting to set it on a route that points exclusively to Backend
12460 # Buckets will result in a configuration error. Up to 5 cookie names can be
12461 # specified.
12462 &quot;A String&quot;,
12463 ],
12464 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
12465 &quot;A String&quot;,
12466 ],
12467 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
12468 # parameters will be excluded. Either specify `includedQueryParameters`
12469 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
12470 # encoded and not treated as delimiters.
12471 &quot;A String&quot;,
12472 ],
12473 },
12474 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
12475 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
12476 &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
12477 # content. This is used to clamp the max-age (or Expires) value sent to the
12478 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
12479 # is used for the response max-age directive, along with a &quot;public&quot;
12480 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
12481 # clamps the max-age from the origin (if specified), or else sets the
12482 # response max-age directive to the lesser of the `clientTtl` and
12483 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
12484 # present. The maximum allowed value is 31,622,400s (1 year). If not
12485 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
12486 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
12487 # `USE_ORIGIN_HEADERS`.
12488 # as a count of seconds and fractions of seconds at nanosecond
12489 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12490 # or &quot;month&quot;. Range is approximately 10,000 years.
12491 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12492 # Durations less than one second are represented with a 0
12493 # `seconds` field and a positive `nanos` field. Must be from 0
12494 # to 999,999,999 inclusive.
12495 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12496 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12497 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12498 },
12499 &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
12500 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
12501 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
12502 # greater than that of `maxTtl`. When the `cacheMode` is set to
12503 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
12504 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
12505 # accessed objects may be evicted from the cache before the defined TTL. If
12506 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
12507 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
12508 # `USE_ORIGIN_HEADERS`.
12509 # as a count of seconds and fractions of seconds at nanosecond
12510 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12511 # or &quot;month&quot;. Range is approximately 10,000 years.
12512 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12513 # Durations less than one second are represented with a 0
12514 # `seconds` field and a positive `nanos` field. Must be from 0
12515 # to 999,999,999 inclusive.
12516 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12517 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12518 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12519 },
12520 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
12521 # attempt to set a max-age or s-maxage higher than this, or an Expires header
12522 # more than `maxTtl` seconds in the future will be capped at the value of
12523 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
12524 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
12525 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
12526 # Infrequently accessed objects may be evicted from the cache before the
12527 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
12528 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
12529 # mode.
12530 # as a count of seconds and fractions of seconds at nanosecond
12531 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12532 # or &quot;month&quot;. Range is approximately 10,000 years.
12533 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12534 # Durations less than one second are represented with a 0
12535 # `seconds` field and a positive `nanos` field. Must be from 0
12536 # to 999,999,999 inclusive.
12537 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12538 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12539 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12540 },
12541 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
12542 # to apply fine-grained caching for common errors or redirects.
12543 # This can reduce the load on your origin and improve end-user
12544 # experience by reducing response latency.
12545 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
12546 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
12547 # the specified response code that lack any Cache-Control, Expires, or
12548 # Pragma: no-cache directives. When the `cacheMode` is set to
12549 # `FORCE_CACHE_ALL`, negative caching applies to all responses
12550 # with the specified response code, and overrides any caching headers. By
12551 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
12552 #
12553 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
12554 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
12555 # * 405 (Method Not Found), 501 (Not Implemented): 60s
12556 #
12557 # These defaults can be overridden in `negativeCachingPolicy`.
12558 # If not specified, Cloud CDN applies negative caching by default.
12559 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
12560 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
12561 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
12562 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
12563 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
12564 # all response codes that you wish to cache. Cloud CDN will not apply any
12565 # default negative caching when a policy exists.
12566 { # Specify CDN TTLs for response error codes.
12567 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
12568 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
12569 # specified as values, and you cannot specify a status code more than
12570 # once.
12571 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
12572 # corresponding status code.
12573 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
12574 # objects may be evicted from the cache before the defined TTL.
12575 # as a count of seconds and fractions of seconds at nanosecond
12576 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12577 # or &quot;month&quot;. Range is approximately 10,000 years.
12578 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12579 # Durations less than one second are represented with a 0
12580 # `seconds` field and a positive `nanos` field. Must be from 0
12581 # to 999,999,999 inclusive.
12582 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12583 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12584 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12585 },
12586 },
12587 ],
12588 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
12589 # requests into a small number of requests to the origin. If not specified,
12590 # Cloud CDN applies request coalescing by default.
12591 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
12592 # content with the origin, or when an error is encountered when refreshing
12593 # the cache.
12594 # This setting defines the default &quot;max-stale&quot; duration for any cached
12595 # responses that do not specify a max-stale directive. Stale responses that
12596 # exceed the TTL configured here will not be served. The default limit
12597 # (max-stale) is 86400s (1 day), which will allow stale content to be
12598 # served up to this limit beyond the max-age (or s-maxage) of a cached
12599 # response.
12600 # The maximum allowed value is 604800 (1 week).
12601 # Set this to zero (0) to disable serve-while-stale.
12602 # as a count of seconds and fractions of seconds at nanosecond
12603 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12604 # or &quot;month&quot;. Range is approximately 10,000 years.
12605 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12606 # Durations less than one second are represented with a 0
12607 # `seconds` field and a positive `nanos` field. Must be from 0
12608 # to 999,999,999 inclusive.
12609 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12610 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12611 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12612 },
12613 },
12614 &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
12615 # information about the W3C recommendation for cross-origin resource sharing
12616 # (CORS), see Fetch API Living
12617 # Standard.
12618 #
12619 # Not supported when the URL map is bound to a target gRPC proxy.
12620 # information about the W3C recommendation for cross-origin resource sharing
12621 # (CORS), see Fetch API Living
12622 # Standard.
12623 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
12624 # indicates that
12625 # the actual request can include user credentials. This field translates to
12626 # the Access-Control-Allow-Credentials header.
12627 #
12628 # Default is false.
12629 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
12630 # header.
12631 &quot;A String&quot;,
12632 ],
12633 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
12634 # header.
12635 &quot;A String&quot;,
12636 ],
12637 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
12638 # more information, see regular expression syntax.
12639 #
12640 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
12641 #
12642 # Regular expressions can only be used when the loadBalancingScheme is
12643 # set to INTERNAL_SELF_MANAGED.
12644 &quot;A String&quot;,
12645 ],
12646 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
12647 #
12648 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
12649 &quot;A String&quot;,
12650 ],
12651 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
12652 # The default value is false, which indicates that the CORS
12653 # policy is in effect.
12654 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
12655 # header.
12656 &quot;A String&quot;,
12657 ],
12658 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
12659 # seconds. This field translates to the Access-Control-Max-Age
12660 # header.
12661 },
12662 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
12663 # the resiliency of clients to backend service failure. As part of fault
12664 # injection, when clients send requests to a backend service, delays can be
12665 # introduced by a load balancer on a percentage of requests before sending
12666 # those requests to the backend service. Similarly requests from clients can
12667 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
12668 # that are configured with a fault_injection_policy if:
12669 # 1. The traffic is generated by fault injection AND
12670 # 2. The fault injection is not a delay fault injection.
12671 # Fault injection is not supported with the classic Application Load Balancer
12672 # . To see which load balancers support fault injection,
12673 # see Load
12674 # balancing: Routing and traffic management features.
12675 # the resiliency of clients to backend service failure. As part of fault
12676 # injection, when clients send requests to a backend service, delays can be
12677 # introduced by the load balancer on a percentage of requests before sending
12678 # those request to the backend service. Similarly requests from clients can be
12679 # aborted by the load balancer for a percentage of requests.
12680 &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
12681 # injection.
12682 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
12683 #
12684 # The value must be from 200 to 599 inclusive.
12685 #
12686 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
12687 # according to this
12688 # mapping table. HTTP status 200 is mapped to gRPC status
12689 # UNKNOWN. Injecting an OK status is currently not supported by
12690 # Traffic Director.
12691 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
12692 # that is aborted as part of fault injection.
12693 #
12694 # The value must be from 0.0 to 100.0 inclusive.
12695 },
12696 &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
12697 # injection, before being sent to a backend service.
12698 # request to the backend service as part of fault injection.
12699 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
12700 # as a count of seconds and fractions of seconds at nanosecond
12701 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12702 # or &quot;month&quot;. Range is approximately 10,000 years.
12703 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12704 # Durations less than one second are represented with a 0
12705 # `seconds` field and a positive `nanos` field. Must be from 0
12706 # to 999,999,999 inclusive.
12707 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12708 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12709 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12710 },
12711 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
12712 # which a delay is introduced as part of fault injection.
12713 #
12714 # The value must be from 0.0 to 100.0 inclusive.
12715 },
12716 },
12717 &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
12718 # Global EXTERNAL_MANAGED load balancer schemes.
12719 # Either Cloud CDN must be enabled on the backend service or backend bucket
12720 # serving the route, or cache policy must be configured on the same route
12721 # dynamically processes and delivers images from the network edge.
12722 # Image Optimization is only available for Global External Application Load
12723 # Balancers.
12724 # Either Cloud CDN must be enabled on the backend service or backend bucket
12725 # serving the route, or cache policy must be configured on the same route.
12726 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
12727 },
12728 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
12729 # Unlike the timeout field where the timeout duration starts
12730 # from the time the request has been fully processed (known as*end-of-stream*),
12731 # the duration in this field is computed from the beginning of the stream
12732 # until the response has been processed, including all retries. A
12733 # stream that does not complete in this duration is closed.
12734 #
12735 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
12736 # with the route.
12737 #
12738 # This field is only allowed if the Url map is used with backend services
12739 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
12740 # as a count of seconds and fractions of seconds at nanosecond
12741 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12742 # or &quot;month&quot;. Range is approximately 10,000 years.
12743 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12744 # Durations less than one second are represented with a 0
12745 # `seconds` field and a positive `nanos` field. Must be from 0
12746 # to 999,999,999 inclusive.
12747 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12748 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12749 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12750 },
12751 &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
12752 # are shadowed to a separate mirrored backend service. The load balancer does
12753 # not wait for responses from the shadow service. Before sending traffic
12754 # to the shadow service, the host / authority header is suffixed with-shadow.
12755 #
12756 # Not supported when the URL map is bound to a target gRPC proxy that
12757 # has the validateForProxyless field set to true.
12758 # are shadowed to a separate mirrored backend service. The load balancer
12759 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
12760 # to the shadow service, the host or authority header is suffixed with-shadow.
12761 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
12762 # mirrored to.
12763 #
12764 # The backend service configured for a mirroring
12765 # policy must reference backends that are of the same type as the original
12766 # backend service matched in the URL map.
12767 #
12768 # Serverless NEG backends are not currently supported as a mirrored
12769 # backend service.
12770 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
12771 },
12772 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
12773 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
12774 # If not specified, defaults to 1.
12775 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
12776 #
12777 # If not specified, will use the timeout set in theHttpRouteAction field.
12778 # If timeout in the HttpRouteAction field is not set, this field
12779 # uses the largest timeout
12780 # among all backend services associated with the route.
12781 #
12782 # Not supported when the URL map is bound to a target gRPC proxy that
12783 # has the validateForProxyless field set to true.
12784 # as a count of seconds and fractions of seconds at nanosecond
12785 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12786 # or &quot;month&quot;. Range is approximately 10,000 years.
12787 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12788 # Durations less than one second are represented with a 0
12789 # `seconds` field and a positive `nanos` field. Must be from 0
12790 # to 999,999,999 inclusive.
12791 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12792 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12793 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12794 },
12795 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
12796 # values are:
12797 #
12798 # - 5xx: retry is attempted if the instance or endpoint
12799 # responds with any 5xx response code, or if the instance or
12800 # endpoint does not respond at all. For example, disconnects, reset, read
12801 # timeout, connection failure, and refused streams.
12802 # - gateway-error: Similar to 5xx, but only
12803 # applies to response codes 502, 503 or504.
12804 # - connect-failure: a retry is attempted on failures
12805 # connecting to the instance or endpoint. For example, connection
12806 # timeouts.
12807 # - retriable-4xx: a retry is attempted if the instance
12808 # or endpoint responds with a 4xx response code.
12809 # The only error that you can retry is error code 409.
12810 # - refused-stream: a retry is attempted if the instance
12811 # or endpoint resets the stream with a REFUSED_STREAM error
12812 # code. This reset type indicates that it is safe to retry.
12813 # - cancelled: a retry is attempted if the gRPC status
12814 # code in the response header is set to cancelled.
12815 # - deadline-exceeded: a retry is attempted if the gRPC
12816 # status code in the response header is set todeadline-exceeded.
12817 # - internal: a retry is attempted if the gRPC
12818 # status code in the response header is set tointernal.
12819 # - resource-exhausted: a retry is attempted if the gRPC
12820 # status code in the response header is set toresource-exhausted.
12821 # - unavailable: a retry is attempted if the gRPC
12822 # status code in the response header is set tounavailable.
12823 #
12824 # Only the following codes are supported when the URL map is bound to
12825 # target gRPC proxy that has validateForProxyless field set to true.
12826 #
12827 # - cancelled
12828 # - deadline-exceeded
12829 # - internal
12830 # - resource-exhausted
12831 # - unavailable
12832 &quot;A String&quot;,
12833 ],
12834 },
12835 &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
12836 # time the request has been fully processed (known as *end-of-stream*)
12837 # up until the response has been processed. Timeout includes
12838 # all retries.
12839 #
12840 # If not specified, this field uses the largest timeout among all backend
12841 # services associated with the route.
12842 #
12843 # Not supported when the URL map is bound to a target gRPC proxy that
12844 # has validateForProxyless field set to true.
12845 # as a count of seconds and fractions of seconds at nanosecond
12846 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12847 # or &quot;month&quot;. Range is approximately 10,000 years.
12848 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12849 # Durations less than one second are represented with a 0
12850 # `seconds` field and a positive `nanos` field. Must be from 0
12851 # to 999,999,999 inclusive.
12852 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12853 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12854 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12855 },
12856 &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
12857 # to the matched service.
12858 #
12859 # urlRewrite is the only action supported in UrlMaps
12860 # for classic Application Load Balancers.
12861 #
12862 # Not supported when the URL map is bound to a target gRPC proxy that
12863 # has the validateForProxyless field set to true.
12864 # backend service.
12865 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
12866 # host header is replaced with contents of hostRewrite.
12867 #
12868 # The value must be from 1 to 255 characters.
12869 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
12870 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
12871 #
12872 # The value must be from 1 to 1024 characters.
12873 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
12874 # header) using the HTTP template syntax.
12875 #
12876 # A corresponding
12877 # path_template_match must be specified. Any template variables must exist in
12878 # the path_template_match field.
12879 #
12880 #
12881 # - -At least one variable must be specified in the path_template_match
12882 # field
12883 # - You can omit variables from the rewritten URL
12884 # - The * and ** operators cannot be matched
12885 # unless they have a corresponding variable name - e.g.
12886 # {format=*} or {var=**}.
12887 #
12888 # For example, a path_template_match of /static/{format=**}
12889 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
12890 # rewrite, so that /{country}/{format}/{suffix=**} can be
12891 # rewritten as /content/{format}/{country}/{suffix}.
12892 #
12893 # At least
12894 # one non-empty routeRules[].matchRules[].path_template_match is
12895 # required.
12896 #
12897 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
12898 },
12899 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
12900 # occurs. The weights determine the fraction of traffic that flows to
12901 # their corresponding backend service. If all traffic needs to
12902 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
12903 #
12904 # After a backend service is identified and before forwarding
12905 # the request to
12906 # the backend service, advanced routing actions such as URL rewrites and
12907 # header transformations are applied depending on additional settings
12908 # specified in this HttpRouteAction.
12909 { # In contrast to a single BackendService in
12910 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
12911 # multiple backend services. The volume of traffic for each
12912 # backend service is proportional to the weight specified
12913 # in each WeightedBackendService
12914 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
12915 # resource. Before
12916 # forwarding the request to backendService, the load balancer
12917 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
12918 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
12919 # effect for the selected backendService.
12920 #
12921 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
12922 #
12923 # headerAction is not supported for load balancers that have
12924 # their loadBalancingScheme set to EXTERNAL.
12925 #
12926 # Not supported when the URL map is bound to a target gRPC proxy that
12927 # has validateForProxyless field set to true.
12928 # the request is passed along to the selected backendService.
12929 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
12930 { # Specification determining how headers are added to requests or responses.
12931 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
12932 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
12933 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
12934 # that already
12935 # exist for the header. If true, headerValue is set for the
12936 # header, discarding any values that were set for that header.
12937 #
12938 # The default value is true,
12939 # unless a variable is present in headerValue,
12940 # in which case the default value is false.
12941 # .
12942 },
12943 ],
12944 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
12945 # request before forwarding the request to the backendService.
12946 &quot;A String&quot;,
12947 ],
12948 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
12949 # client.
12950 { # Specification determining how headers are added to requests or responses.
12951 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
12952 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
12953 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
12954 # that already
12955 # exist for the header. If true, headerValue is set for the
12956 # header, discarding any values that were set for that header.
12957 #
12958 # The default value is true,
12959 # unless a variable is present in headerValue,
12960 # in which case the default value is false.
12961 # .
12962 },
12963 ],
12964 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
12965 # response before sending the response back to the client.
12966 &quot;A String&quot;,
12967 ],
12968 },
12969 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
12970 # computed asweight / (sum of all weightedBackendService weights in routeAction).
12971 #
12972 # The selection of a backend service is determined only for new traffic.
12973 # Once a user&#x27;s request has been directed to a backend service,
12974 # subsequent requests are sent to the same backend service as
12975 # determined by the backend service&#x27;s session affinity policy.
12976 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
12977 # splitting. If you do, the weighted traffic splitting configuration takes
12978 # precedence.
12979 #
12980 # The value must be from 0 to 1000.
12981 },
12982 ],
12983 },
12984 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL of the defaultService resource to
12985 # which traffic is directed if none of the hostRules match.
12986 # If defaultRouteAction is also specified, advanced
12987 # routing actions, such as URL rewrites, take effect before sending the
12988 # request to the backend.
12989 #
12990 #
12991 # Only one of defaultUrlRedirect, defaultService
12992 # or defaultRouteAction.weightedBackendService can be set.
12993 #
12994 #
12995 # defaultService has no effect when the URL map is bound
12996 # to a target gRPC proxy that has the validateForProxyless field
12997 # set to true.
12998 &quot;defaultUrlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
12999 # is redirected to a URL specified by defaultUrlRedirect.
13000 #
13001 #
13002 # Only one of defaultUrlRedirect, defaultService
13003 # or defaultRouteAction.weightedBackendService can be set.
13004 #
13005 #
13006 # Not supported when the URL map is bound to a target gRPC proxy.
13007 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
13008 # was supplied in the request.
13009 #
13010 # The value must be from 1 to 255
13011 # characters.
13012 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
13013 # set to HTTPS.
13014 # If set to false, the URL scheme of the redirected request
13015 # remains the same as that of the request.
13016 #
13017 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
13018 #
13019 # The default is set to false.
13020 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
13021 # that was supplied in the request.
13022 #
13023 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
13024 # supplied, the path of the original request is used for the redirect.
13025 #
13026 # The value must be from 1 to 1024 characters.
13027 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
13028 # the HttpRouteRuleMatch, retaining the remaining portion
13029 # of the URL before redirecting the request.
13030 #
13031 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
13032 # supplied, the path of the original request is used for the redirect.
13033 #
13034 # The value must be from 1 to 1024 characters.
13035 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
13036 #
13037 # Supported values are:
13038 #
13039 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
13040 # to 301.
13041 # - FOUND, which corresponds to 302.
13042 # - SEE_OTHER which corresponds to 303.
13043 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
13044 # method is retained.
13045 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
13046 # method is retained.
13047 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
13048 # URL is
13049 # removed before redirecting the request. If set to false, the
13050 # query portion of the original URL is retained.
13051 #
13052 # The default is set to false.
13053 },
13054 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
13055 # create the resource.
13056 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. A hash of the contents stored in this object.
13057 # This field is used in optimistic locking. This field is ignored when
13058 # inserting a UrlMap. An up-to-date fingerprint must be provided
13059 # in order to update the UrlMap, otherwise the request will
13060 # fail with error 412 conditionNotMet.
13061 #
13062 # To see the latest fingerprint, make a get() request to
13063 # retrieve a UrlMap.
13064 &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
13065 # for the selected backendService.
13066 #
13067 # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
13068 #
13069 # headerAction is not supported for load balancers
13070 # that have
13071 # their loadBalancingScheme set to EXTERNAL.
13072 #
13073 # Not supported when the URL map is bound to a target gRPC proxy that
13074 # has validateForProxyless field set to true.
13075 # the request is passed along to the selected backendService.
13076 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
13077 { # Specification determining how headers are added to requests or responses.
13078 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
13079 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
13080 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
13081 # that already
13082 # exist for the header. If true, headerValue is set for the
13083 # header, discarding any values that were set for that header.
13084 #
13085 # The default value is true,
13086 # unless a variable is present in headerValue,
13087 # in which case the default value is false.
13088 # .
13089 },
13090 ],
13091 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
13092 # request before forwarding the request to the backendService.
13093 &quot;A String&quot;,
13094 ],
13095 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
13096 # client.
13097 { # Specification determining how headers are added to requests or responses.
13098 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
13099 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
13100 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
13101 # that already
13102 # exist for the header. If true, headerValue is set for the
13103 # header, discarding any values that were set for that header.
13104 #
13105 # The default value is true,
13106 # unless a variable is present in headerValue,
13107 # in which case the default value is false.
13108 # .
13109 },
13110 ],
13111 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
13112 # response before sending the response back to the client.
13113 &quot;A String&quot;,
13114 ],
13115 },
13116 &quot;hostRules&quot;: [ # The list of host rules to use against the URL.
13117 { # UrlMaps
13118 # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
13119 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
13120 # create the resource.
13121 &quot;hosts&quot;: [ # The list of host patterns to match. They must be valid hostnames with
13122 # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
13123 # that case, * must be the first character, and if followed by
13124 # anything, the immediate following character must be either -
13125 # or ..
13126 #
13127 # * based matching is not supported when the URL map is bound
13128 # to a target gRPC proxy that has the validateForProxyless field
13129 # set to true.
13130 &quot;A String&quot;,
13131 ],
13132 &quot;pathMatcher&quot;: &quot;A String&quot;, # The name of the PathMatcher to use to match the path portion
13133 # of the URL if the hostRule matches the URL&#x27;s host portion.
13134 },
13135 ],
13136 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the resource. This identifier is
13137 # defined by the server.
13138 &quot;kind&quot;: &quot;compute#urlMap&quot;, # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
13139 # url maps.
13140 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
13141 # The name must be 1-63 characters long, and comply withRFC1035.
13142 # Specifically, the name must be 1-63 characters long and match the regular
13143 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
13144 # character must be a lowercase letter, and all following characters must
13145 # be a dash, lowercase letter, or digit, except the last character, which
13146 # cannot be a dash.
13147 &quot;pathMatchers&quot;: [ # The list of named PathMatchers to use against the URL.
13148 { # A matcher for the path portion of the URL. The BackendService
13149 # from the longest-matched rule will serve the URL. If no rule was matched, the
13150 # default service is used.
13151 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
13152 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
13153 #
13154 # This policy takes
13155 # effect at the PathMatcher level and applies only when no
13156 # 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
13157 # in defaultCustomErrorResponsePolicy, then a policy defined for
13158 # the error code in UrlMap.defaultCustomErrorResponsePolicy
13159 # takes effect.
13160 #
13161 # For example, consider a UrlMap with the following
13162 # configuration:
13163 #
13164 #
13165 # - UrlMap.defaultCustomErrorResponsePolicy is configured
13166 # with policies for 5xx and 4xx errors
13167 # - A RouteRule for /coming_soon/ is configured for the
13168 # error code 404.
13169 #
13170 # 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
13171 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
13172 # the policy in RouteRule.customErrorResponsePolicy takes
13173 # effect. If any of the requests in this example encounter a 500
13174 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
13175 #
13176 # When
13177 # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
13178 # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
13179 # a retry, if load balancer is successful in reaching the
13180 # service, the defaultCustomErrorResponsePolicy is ignored and
13181 # the response from the service is returned to the client.
13182 #
13183 # defaultCustomErrorResponsePolicy is supported only for
13184 # global external Application Load Balancers.
13185 # backend service or backend bucket responds with an error.
13186 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
13187 #
13188 # In a given policy, if you specify rules for both a range of error codes
13189 # as well as rules for specific error codes then rules with specific error
13190 # codes have a higher priority. For example, assume that you configure a rule
13191 # for 401 (Un-authorized) code, and another for all 4 series
13192 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
13193 # However if the backend service returns a 403, the rule for4xx takes effect.
13194 { # Specifies the mapping between the response code that will be returned along
13195 # with the custom error content and the response code returned by the backend
13196 # service.
13197 &quot;matchResponseCodes&quot;: [ # Valid values include:
13198 #
13199 #
13200 # - A number between 400 and 599: For example
13201 # 401 or 503, in which case the load balancer
13202 # applies the policy if the error code exactly matches this value.
13203 # - 5xx: Load Balancer will apply the policy if the
13204 # backend service responds with any response code in the range of
13205 # 500 to 599.
13206 # - 4xx: Load
13207 # Balancer will apply the policy if the backend service responds with any
13208 # response code in the range of 400 to
13209 # 499.
13210 #
13211 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
13212 &quot;A String&quot;,
13213 ],
13214 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
13215 # error content. If overrideResponseCode is not supplied, the
13216 # same response code returned by the original backend bucket or backend
13217 # service is returned to the client.
13218 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
13219 #
13220 # path must start
13221 # with a leading slash. path cannot have trailing slashes.
13222 #
13223 # If the file is not available in backendBucket or the
13224 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
13225 #
13226 # The value must
13227 # be from 1 to 1024 characters
13228 },
13229 ],
13230 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
13231 # contains the custom error content. Examples are:
13232 #
13233 #
13234 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
13235 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
13236 # - global/backendBuckets/myBackendBucket
13237 #
13238 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
13239 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
13240 #
13241 # If load balancer cannot reach
13242 # the backendBucket, a simple Not Found Error will
13243 # be returned, with the original response code (oroverrideResponseCode if configured).
13244 #
13245 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
13246 },
13247 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
13248 # pathRules or routeRules match. The load balancer
13249 # performs advanced routing actions, such as URL rewrites and
13250 # header transformations, before forwarding the request to the
13251 # selected backend.
13252 #
13253 #
13254 # Only one of defaultUrlRedirect, defaultService
13255 # or defaultRouteAction.weightedBackendService can be set.
13256 #
13257 #
13258 # URL maps for classic Application Load Balancers only support
13259 # the urlRewrite action within a path matcher&#x27;sdefaultRouteAction.
13260 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
13261 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
13262 # property must be specified. This policy cannot be specified if any target
13263 # backend has Identity-Aware Proxy enabled.
13264 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
13265 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
13266 # header names can be specified. The cache is bypassed for all `cacheMode`
13267 # values.
13268 &quot;A String&quot;,
13269 ],
13270 &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
13271 # on the backend type: for Backend Services, the complete request URI is
13272 # used; for Backend Buckets, the request URI is used without the protocol or
13273 # host, and only query parameters known to Cloud Storage are included.
13274 # Policy defined on Route Action.
13275 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
13276 # parameters will be included. Either specify `excludedQueryParameters`
13277 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
13278 # encoded and not treated as delimiters.
13279 #
13280 # Note: This field applies to routes that use backend services. Attempting
13281 # to set it on a route that points exclusively to Backend Buckets will
13282 # result in a configuration error. For routes that point to a Backend
13283 # Bucket, use `includedQueryParameters` to define which parameters should
13284 # be part of the cache key.
13285 &quot;A String&quot;,
13286 ],
13287 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
13288 #
13289 # Note: This setting is only applicable to routes that use a Backend
13290 # Service. It does not affect requests served by a Backend Bucket, as the
13291 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
13292 # it on a route that points exclusively to Backend Buckets will result in a
13293 # configuration error.
13294 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
13295 #
13296 # Note: This setting is only applicable to routes that use a Backend
13297 # Service. It does not affect requests served by a Backend Bucket, as the
13298 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
13299 # set on a route that points exclusively to Backend Buckets will result in
13300 # a configuration error.
13301 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
13302 # `includedQueryParameters` and `excludedQueryParameters`. If neither
13303 # is set, the entire query string will be included. If false, the query
13304 # string will be excluded from the cache key entirely.
13305 #
13306 # Note: This field applies to routes that use backend services. Attempting
13307 # to set it on a route that points exclusively to Backend Buckets will
13308 # result in a configuration error. For routes that point to a Backend
13309 # Bucket, use `includedQueryParameters` to define which parameters should
13310 # be part of the cache key.
13311 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
13312 # The name=value pair will be used in the cache key Cloud CDN generates.
13313 #
13314 # Note: This setting is only applicable to routes that use a Backend
13315 # Service. It does not affect requests served by a Backend Bucket.
13316 # Attempting to set it on a route that points exclusively to Backend
13317 # Buckets will result in a configuration error. Up to 5 cookie names can be
13318 # specified.
13319 &quot;A String&quot;,
13320 ],
13321 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
13322 &quot;A String&quot;,
13323 ],
13324 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
13325 # parameters will be excluded. Either specify `includedQueryParameters`
13326 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
13327 # encoded and not treated as delimiters.
13328 &quot;A String&quot;,
13329 ],
13330 },
13331 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
13332 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
13333 &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
13334 # content. This is used to clamp the max-age (or Expires) value sent to the
13335 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
13336 # is used for the response max-age directive, along with a &quot;public&quot;
13337 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
13338 # clamps the max-age from the origin (if specified), or else sets the
13339 # response max-age directive to the lesser of the `clientTtl` and
13340 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
13341 # present. The maximum allowed value is 31,622,400s (1 year). If not
13342 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
13343 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
13344 # `USE_ORIGIN_HEADERS`.
13345 # as a count of seconds and fractions of seconds at nanosecond
13346 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13347 # or &quot;month&quot;. Range is approximately 10,000 years.
13348 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13349 # Durations less than one second are represented with a 0
13350 # `seconds` field and a positive `nanos` field. Must be from 0
13351 # to 999,999,999 inclusive.
13352 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13353 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13354 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13355 },
13356 &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
13357 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
13358 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
13359 # greater than that of `maxTtl`. When the `cacheMode` is set to
13360 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
13361 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
13362 # accessed objects may be evicted from the cache before the defined TTL. If
13363 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
13364 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
13365 # `USE_ORIGIN_HEADERS`.
13366 # as a count of seconds and fractions of seconds at nanosecond
13367 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13368 # or &quot;month&quot;. Range is approximately 10,000 years.
13369 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13370 # Durations less than one second are represented with a 0
13371 # `seconds` field and a positive `nanos` field. Must be from 0
13372 # to 999,999,999 inclusive.
13373 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13374 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13375 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13376 },
13377 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
13378 # attempt to set a max-age or s-maxage higher than this, or an Expires header
13379 # more than `maxTtl` seconds in the future will be capped at the value of
13380 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
13381 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
13382 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
13383 # Infrequently accessed objects may be evicted from the cache before the
13384 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
13385 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
13386 # mode.
13387 # as a count of seconds and fractions of seconds at nanosecond
13388 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13389 # or &quot;month&quot;. Range is approximately 10,000 years.
13390 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13391 # Durations less than one second are represented with a 0
13392 # `seconds` field and a positive `nanos` field. Must be from 0
13393 # to 999,999,999 inclusive.
13394 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13395 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13396 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13397 },
13398 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
13399 # to apply fine-grained caching for common errors or redirects.
13400 # This can reduce the load on your origin and improve end-user
13401 # experience by reducing response latency.
13402 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
13403 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
13404 # the specified response code that lack any Cache-Control, Expires, or
13405 # Pragma: no-cache directives. When the `cacheMode` is set to
13406 # `FORCE_CACHE_ALL`, negative caching applies to all responses
13407 # with the specified response code, and overrides any caching headers. By
13408 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
13409 #
13410 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
13411 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
13412 # * 405 (Method Not Found), 501 (Not Implemented): 60s
13413 #
13414 # These defaults can be overridden in `negativeCachingPolicy`.
13415 # If not specified, Cloud CDN applies negative caching by default.
13416 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
13417 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
13418 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
13419 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
13420 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
13421 # all response codes that you wish to cache. Cloud CDN will not apply any
13422 # default negative caching when a policy exists.
13423 { # Specify CDN TTLs for response error codes.
13424 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
13425 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
13426 # specified as values, and you cannot specify a status code more than
13427 # once.
13428 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
13429 # corresponding status code.
13430 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
13431 # objects may be evicted from the cache before the defined TTL.
13432 # as a count of seconds and fractions of seconds at nanosecond
13433 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13434 # or &quot;month&quot;. Range is approximately 10,000 years.
13435 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13436 # Durations less than one second are represented with a 0
13437 # `seconds` field and a positive `nanos` field. Must be from 0
13438 # to 999,999,999 inclusive.
13439 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13440 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13441 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13442 },
13443 },
13444 ],
13445 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
13446 # requests into a small number of requests to the origin. If not specified,
13447 # Cloud CDN applies request coalescing by default.
13448 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
13449 # content with the origin, or when an error is encountered when refreshing
13450 # the cache.
13451 # This setting defines the default &quot;max-stale&quot; duration for any cached
13452 # responses that do not specify a max-stale directive. Stale responses that
13453 # exceed the TTL configured here will not be served. The default limit
13454 # (max-stale) is 86400s (1 day), which will allow stale content to be
13455 # served up to this limit beyond the max-age (or s-maxage) of a cached
13456 # response.
13457 # The maximum allowed value is 604800 (1 week).
13458 # Set this to zero (0) to disable serve-while-stale.
13459 # as a count of seconds and fractions of seconds at nanosecond
13460 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13461 # or &quot;month&quot;. Range is approximately 10,000 years.
13462 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13463 # Durations less than one second are represented with a 0
13464 # `seconds` field and a positive `nanos` field. Must be from 0
13465 # to 999,999,999 inclusive.
13466 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13467 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13468 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13469 },
13470 },
13471 &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
13472 # information about the W3C recommendation for cross-origin resource sharing
13473 # (CORS), see Fetch API Living
13474 # Standard.
13475 #
13476 # Not supported when the URL map is bound to a target gRPC proxy.
13477 # information about the W3C recommendation for cross-origin resource sharing
13478 # (CORS), see Fetch API Living
13479 # Standard.
13480 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
13481 # indicates that
13482 # the actual request can include user credentials. This field translates to
13483 # the Access-Control-Allow-Credentials header.
13484 #
13485 # Default is false.
13486 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
13487 # header.
13488 &quot;A String&quot;,
13489 ],
13490 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
13491 # header.
13492 &quot;A String&quot;,
13493 ],
13494 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
13495 # more information, see regular expression syntax.
13496 #
13497 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
13498 #
13499 # Regular expressions can only be used when the loadBalancingScheme is
13500 # set to INTERNAL_SELF_MANAGED.
13501 &quot;A String&quot;,
13502 ],
13503 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
13504 #
13505 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
13506 &quot;A String&quot;,
13507 ],
13508 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
13509 # The default value is false, which indicates that the CORS
13510 # policy is in effect.
13511 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
13512 # header.
13513 &quot;A String&quot;,
13514 ],
13515 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
13516 # seconds. This field translates to the Access-Control-Max-Age
13517 # header.
13518 },
13519 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
13520 # the resiliency of clients to backend service failure. As part of fault
13521 # injection, when clients send requests to a backend service, delays can be
13522 # introduced by a load balancer on a percentage of requests before sending
13523 # those requests to the backend service. Similarly requests from clients can
13524 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
13525 # that are configured with a fault_injection_policy if:
13526 # 1. The traffic is generated by fault injection AND
13527 # 2. The fault injection is not a delay fault injection.
13528 # Fault injection is not supported with the classic Application Load Balancer
13529 # . To see which load balancers support fault injection,
13530 # see Load
13531 # balancing: Routing and traffic management features.
13532 # the resiliency of clients to backend service failure. As part of fault
13533 # injection, when clients send requests to a backend service, delays can be
13534 # introduced by the load balancer on a percentage of requests before sending
13535 # those request to the backend service. Similarly requests from clients can be
13536 # aborted by the load balancer for a percentage of requests.
13537 &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
13538 # injection.
13539 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
13540 #
13541 # The value must be from 200 to 599 inclusive.
13542 #
13543 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
13544 # according to this
13545 # mapping table. HTTP status 200 is mapped to gRPC status
13546 # UNKNOWN. Injecting an OK status is currently not supported by
13547 # Traffic Director.
13548 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
13549 # that is aborted as part of fault injection.
13550 #
13551 # The value must be from 0.0 to 100.0 inclusive.
13552 },
13553 &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
13554 # injection, before being sent to a backend service.
13555 # request to the backend service as part of fault injection.
13556 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
13557 # as a count of seconds and fractions of seconds at nanosecond
13558 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13559 # or &quot;month&quot;. Range is approximately 10,000 years.
13560 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13561 # Durations less than one second are represented with a 0
13562 # `seconds` field and a positive `nanos` field. Must be from 0
13563 # to 999,999,999 inclusive.
13564 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13565 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13566 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13567 },
13568 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
13569 # which a delay is introduced as part of fault injection.
13570 #
13571 # The value must be from 0.0 to 100.0 inclusive.
13572 },
13573 },
13574 &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
13575 # Global EXTERNAL_MANAGED load balancer schemes.
13576 # Either Cloud CDN must be enabled on the backend service or backend bucket
13577 # serving the route, or cache policy must be configured on the same route
13578 # dynamically processes and delivers images from the network edge.
13579 # Image Optimization is only available for Global External Application Load
13580 # Balancers.
13581 # Either Cloud CDN must be enabled on the backend service or backend bucket
13582 # serving the route, or cache policy must be configured on the same route.
13583 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
13584 },
13585 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
13586 # Unlike the timeout field where the timeout duration starts
13587 # from the time the request has been fully processed (known as*end-of-stream*),
13588 # the duration in this field is computed from the beginning of the stream
13589 # until the response has been processed, including all retries. A
13590 # stream that does not complete in this duration is closed.
13591 #
13592 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
13593 # with the route.
13594 #
13595 # This field is only allowed if the Url map is used with backend services
13596 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
13597 # as a count of seconds and fractions of seconds at nanosecond
13598 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13599 # or &quot;month&quot;. Range is approximately 10,000 years.
13600 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13601 # Durations less than one second are represented with a 0
13602 # `seconds` field and a positive `nanos` field. Must be from 0
13603 # to 999,999,999 inclusive.
13604 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13605 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13606 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13607 },
13608 &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
13609 # are shadowed to a separate mirrored backend service. The load balancer does
13610 # not wait for responses from the shadow service. Before sending traffic
13611 # to the shadow service, the host / authority header is suffixed with-shadow.
13612 #
13613 # Not supported when the URL map is bound to a target gRPC proxy that
13614 # has the validateForProxyless field set to true.
13615 # are shadowed to a separate mirrored backend service. The load balancer
13616 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
13617 # to the shadow service, the host or authority header is suffixed with-shadow.
13618 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
13619 # mirrored to.
13620 #
13621 # The backend service configured for a mirroring
13622 # policy must reference backends that are of the same type as the original
13623 # backend service matched in the URL map.
13624 #
13625 # Serverless NEG backends are not currently supported as a mirrored
13626 # backend service.
13627 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
13628 },
13629 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
13630 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
13631 # If not specified, defaults to 1.
13632 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
13633 #
13634 # If not specified, will use the timeout set in theHttpRouteAction field.
13635 # If timeout in the HttpRouteAction field is not set, this field
13636 # uses the largest timeout
13637 # among all backend services associated with the route.
13638 #
13639 # Not supported when the URL map is bound to a target gRPC proxy that
13640 # has the validateForProxyless field set to true.
13641 # as a count of seconds and fractions of seconds at nanosecond
13642 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13643 # or &quot;month&quot;. Range is approximately 10,000 years.
13644 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13645 # Durations less than one second are represented with a 0
13646 # `seconds` field and a positive `nanos` field. Must be from 0
13647 # to 999,999,999 inclusive.
13648 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13649 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13650 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13651 },
13652 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
13653 # values are:
13654 #
13655 # - 5xx: retry is attempted if the instance or endpoint
13656 # responds with any 5xx response code, or if the instance or
13657 # endpoint does not respond at all. For example, disconnects, reset, read
13658 # timeout, connection failure, and refused streams.
13659 # - gateway-error: Similar to 5xx, but only
13660 # applies to response codes 502, 503 or504.
13661 # - connect-failure: a retry is attempted on failures
13662 # connecting to the instance or endpoint. For example, connection
13663 # timeouts.
13664 # - retriable-4xx: a retry is attempted if the instance
13665 # or endpoint responds with a 4xx response code.
13666 # The only error that you can retry is error code 409.
13667 # - refused-stream: a retry is attempted if the instance
13668 # or endpoint resets the stream with a REFUSED_STREAM error
13669 # code. This reset type indicates that it is safe to retry.
13670 # - cancelled: a retry is attempted if the gRPC status
13671 # code in the response header is set to cancelled.
13672 # - deadline-exceeded: a retry is attempted if the gRPC
13673 # status code in the response header is set todeadline-exceeded.
13674 # - internal: a retry is attempted if the gRPC
13675 # status code in the response header is set tointernal.
13676 # - resource-exhausted: a retry is attempted if the gRPC
13677 # status code in the response header is set toresource-exhausted.
13678 # - unavailable: a retry is attempted if the gRPC
13679 # status code in the response header is set tounavailable.
13680 #
13681 # Only the following codes are supported when the URL map is bound to
13682 # target gRPC proxy that has validateForProxyless field set to true.
13683 #
13684 # - cancelled
13685 # - deadline-exceeded
13686 # - internal
13687 # - resource-exhausted
13688 # - unavailable
13689 &quot;A String&quot;,
13690 ],
13691 },
13692 &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
13693 # time the request has been fully processed (known as *end-of-stream*)
13694 # up until the response has been processed. Timeout includes
13695 # all retries.
13696 #
13697 # If not specified, this field uses the largest timeout among all backend
13698 # services associated with the route.
13699 #
13700 # Not supported when the URL map is bound to a target gRPC proxy that
13701 # has validateForProxyless field set to true.
13702 # as a count of seconds and fractions of seconds at nanosecond
13703 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13704 # or &quot;month&quot;. Range is approximately 10,000 years.
13705 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13706 # Durations less than one second are represented with a 0
13707 # `seconds` field and a positive `nanos` field. Must be from 0
13708 # to 999,999,999 inclusive.
13709 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13710 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13711 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13712 },
13713 &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
13714 # to the matched service.
13715 #
13716 # urlRewrite is the only action supported in UrlMaps
13717 # for classic Application Load Balancers.
13718 #
13719 # Not supported when the URL map is bound to a target gRPC proxy that
13720 # has the validateForProxyless field set to true.
13721 # backend service.
13722 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
13723 # host header is replaced with contents of hostRewrite.
13724 #
13725 # The value must be from 1 to 255 characters.
13726 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
13727 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
13728 #
13729 # The value must be from 1 to 1024 characters.
13730 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
13731 # header) using the HTTP template syntax.
13732 #
13733 # A corresponding
13734 # path_template_match must be specified. Any template variables must exist in
13735 # the path_template_match field.
13736 #
13737 #
13738 # - -At least one variable must be specified in the path_template_match
13739 # field
13740 # - You can omit variables from the rewritten URL
13741 # - The * and ** operators cannot be matched
13742 # unless they have a corresponding variable name - e.g.
13743 # {format=*} or {var=**}.
13744 #
13745 # For example, a path_template_match of /static/{format=**}
13746 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
13747 # rewrite, so that /{country}/{format}/{suffix=**} can be
13748 # rewritten as /content/{format}/{country}/{suffix}.
13749 #
13750 # At least
13751 # one non-empty routeRules[].matchRules[].path_template_match is
13752 # required.
13753 #
13754 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
13755 },
13756 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
13757 # occurs. The weights determine the fraction of traffic that flows to
13758 # their corresponding backend service. If all traffic needs to
13759 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
13760 #
13761 # After a backend service is identified and before forwarding
13762 # the request to
13763 # the backend service, advanced routing actions such as URL rewrites and
13764 # header transformations are applied depending on additional settings
13765 # specified in this HttpRouteAction.
13766 { # In contrast to a single BackendService in
13767 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
13768 # multiple backend services. The volume of traffic for each
13769 # backend service is proportional to the weight specified
13770 # in each WeightedBackendService
13771 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
13772 # resource. Before
13773 # forwarding the request to backendService, the load balancer
13774 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
13775 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
13776 # effect for the selected backendService.
13777 #
13778 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
13779 #
13780 # headerAction is not supported for load balancers that have
13781 # their loadBalancingScheme set to EXTERNAL.
13782 #
13783 # Not supported when the URL map is bound to a target gRPC proxy that
13784 # has validateForProxyless field set to true.
13785 # the request is passed along to the selected backendService.
13786 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
13787 { # Specification determining how headers are added to requests or responses.
13788 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
13789 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
13790 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
13791 # that already
13792 # exist for the header. If true, headerValue is set for the
13793 # header, discarding any values that were set for that header.
13794 #
13795 # The default value is true,
13796 # unless a variable is present in headerValue,
13797 # in which case the default value is false.
13798 # .
13799 },
13800 ],
13801 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
13802 # request before forwarding the request to the backendService.
13803 &quot;A String&quot;,
13804 ],
13805 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
13806 # client.
13807 { # Specification determining how headers are added to requests or responses.
13808 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
13809 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
13810 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
13811 # that already
13812 # exist for the header. If true, headerValue is set for the
13813 # header, discarding any values that were set for that header.
13814 #
13815 # The default value is true,
13816 # unless a variable is present in headerValue,
13817 # in which case the default value is false.
13818 # .
13819 },
13820 ],
13821 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
13822 # response before sending the response back to the client.
13823 &quot;A String&quot;,
13824 ],
13825 },
13826 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
13827 # computed asweight / (sum of all weightedBackendService weights in routeAction).
13828 #
13829 # The selection of a backend service is determined only for new traffic.
13830 # Once a user&#x27;s request has been directed to a backend service,
13831 # subsequent requests are sent to the same backend service as
13832 # determined by the backend service&#x27;s session affinity policy.
13833 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
13834 # splitting. If you do, the weighted traffic splitting configuration takes
13835 # precedence.
13836 #
13837 # The value must be from 0 to 1000.
13838 },
13839 ],
13840 },
13841 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource. This
13842 # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
13843 # matched. For example, the
13844 # following are all valid URLs to a BackendService resource:
13845 #
13846 #
13847 # - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
13848 # - compute/v1/projects/project/global/backendServices/backendService
13849 # - global/backendServices/backendService
13850 #
13851 #
13852 # If defaultRouteAction is also specified, advanced
13853 # routing actions, such as URL rewrites, take effect before sending the
13854 # request to the backend.
13855 #
13856 #
13857 # Only one of defaultUrlRedirect, defaultService
13858 # or defaultRouteAction.weightedBackendService can be set.
13859 #
13860 #
13861 # Authorization requires one or more of the following Google IAM permissions on the
13862 # specified resource default_service:
13863 #
13864 #
13865 # - compute.backendBuckets.use
13866 # - compute.backendServices.use
13867 &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
13868 # by defaultUrlRedirect.
13869 #
13870 #
13871 # Only one of defaultUrlRedirect, defaultService
13872 # or defaultRouteAction.weightedBackendService can be set.
13873 #
13874 #
13875 # Not supported when the URL map is bound to a target gRPC proxy.
13876 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
13877 # was supplied in the request.
13878 #
13879 # The value must be from 1 to 255
13880 # characters.
13881 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
13882 # set to HTTPS.
13883 # If set to false, the URL scheme of the redirected request
13884 # remains the same as that of the request.
13885 #
13886 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
13887 #
13888 # The default is set to false.
13889 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
13890 # that was supplied in the request.
13891 #
13892 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
13893 # supplied, the path of the original request is used for the redirect.
13894 #
13895 # The value must be from 1 to 1024 characters.
13896 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
13897 # the HttpRouteRuleMatch, retaining the remaining portion
13898 # of the URL before redirecting the request.
13899 #
13900 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
13901 # supplied, the path of the original request is used for the redirect.
13902 #
13903 # The value must be from 1 to 1024 characters.
13904 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
13905 #
13906 # Supported values are:
13907 #
13908 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
13909 # to 301.
13910 # - FOUND, which corresponds to 302.
13911 # - SEE_OTHER which corresponds to 303.
13912 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
13913 # method is retained.
13914 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
13915 # method is retained.
13916 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
13917 # URL is
13918 # removed before redirecting the request. If set to false, the
13919 # query portion of the original URL is retained.
13920 #
13921 # The default is set to false.
13922 },
13923 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
13924 # create the resource.
13925 &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
13926 # for the selected backend service.
13927 #
13928 # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
13929 #
13930 # HeaderAction is not supported for load balancers
13931 # that have
13932 # their loadBalancingScheme set to EXTERNAL.
13933 #
13934 # Not supported when the URL map is bound to a target gRPC proxy that
13935 # has validateForProxyless field set to true.
13936 # the request is passed along to the selected backendService.
13937 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
13938 { # Specification determining how headers are added to requests or responses.
13939 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
13940 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
13941 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
13942 # that already
13943 # exist for the header. If true, headerValue is set for the
13944 # header, discarding any values that were set for that header.
13945 #
13946 # The default value is true,
13947 # unless a variable is present in headerValue,
13948 # in which case the default value is false.
13949 # .
13950 },
13951 ],
13952 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
13953 # request before forwarding the request to the backendService.
13954 &quot;A String&quot;,
13955 ],
13956 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
13957 # client.
13958 { # Specification determining how headers are added to requests or responses.
13959 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
13960 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
13961 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
13962 # that already
13963 # exist for the header. If true, headerValue is set for the
13964 # header, discarding any values that were set for that header.
13965 #
13966 # The default value is true,
13967 # unless a variable is present in headerValue,
13968 # in which case the default value is false.
13969 # .
13970 },
13971 ],
13972 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
13973 # response before sending the response back to the client.
13974 &quot;A String&quot;,
13975 ],
13976 },
13977 &quot;name&quot;: &quot;A String&quot;, # The name to which this PathMatcher is referred by theHostRule.
13978 &quot;pathRules&quot;: [ # The list of path rules. Use this list instead of routeRules
13979 # when routing based on simple path matching is all that&#x27;s required. A path
13980 # rule can only include a wildcard character (*) after a
13981 # forward slash character (&quot;/&quot;).
13982 #
13983 # The order by which path rules are specified does not matter.
13984 # Matches are always done on the longest-path-first basis.
13985 #
13986 # For example: a pathRule with a path /a/b/c/* will match
13987 # before /a/b/* irrespective of the order in which those paths appear in this
13988 # list.
13989 #
13990 # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
13991 { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
13992 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
13993 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
13994 #
13995 # If a policy for an
13996 # error code is not configured for the PathRule, a policy for
13997 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
13998 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
13999 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
14000 # effect.
14001 #
14002 # For example, consider a UrlMap with the following configuration:
14003 #
14004 #
14005 # - UrlMap.defaultCustomErrorResponsePolicy are configured
14006 # with policies for 5xx and 4xx errors
14007 # - A PathRule for /coming_soon/ is configured for the error
14008 # code 404.
14009 #
14010 # 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
14011 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
14012 # the policy in PathRule.customErrorResponsePolicy takes
14013 # effect. If any of the requests in this example encounter a 500
14014 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
14015 #
14016 # customErrorResponsePolicy is supported only for
14017 # global external Application Load Balancers.
14018 # backend service or backend bucket responds with an error.
14019 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
14020 #
14021 # In a given policy, if you specify rules for both a range of error codes
14022 # as well as rules for specific error codes then rules with specific error
14023 # codes have a higher priority. For example, assume that you configure a rule
14024 # for 401 (Un-authorized) code, and another for all 4 series
14025 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
14026 # However if the backend service returns a 403, the rule for4xx takes effect.
14027 { # Specifies the mapping between the response code that will be returned along
14028 # with the custom error content and the response code returned by the backend
14029 # service.
14030 &quot;matchResponseCodes&quot;: [ # Valid values include:
14031 #
14032 #
14033 # - A number between 400 and 599: For example
14034 # 401 or 503, in which case the load balancer
14035 # applies the policy if the error code exactly matches this value.
14036 # - 5xx: Load Balancer will apply the policy if the
14037 # backend service responds with any response code in the range of
14038 # 500 to 599.
14039 # - 4xx: Load
14040 # Balancer will apply the policy if the backend service responds with any
14041 # response code in the range of 400 to
14042 # 499.
14043 #
14044 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
14045 &quot;A String&quot;,
14046 ],
14047 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
14048 # error content. If overrideResponseCode is not supplied, the
14049 # same response code returned by the original backend bucket or backend
14050 # service is returned to the client.
14051 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
14052 #
14053 # path must start
14054 # with a leading slash. path cannot have trailing slashes.
14055 #
14056 # If the file is not available in backendBucket or the
14057 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
14058 #
14059 # The value must
14060 # be from 1 to 1024 characters
14061 },
14062 ],
14063 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
14064 # contains the custom error content. Examples are:
14065 #
14066 #
14067 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
14068 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
14069 # - global/backendBuckets/myBackendBucket
14070 #
14071 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
14072 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
14073 #
14074 # If load balancer cannot reach
14075 # the backendBucket, a simple Not Found Error will
14076 # be returned, with the original response code (oroverrideResponseCode if configured).
14077 #
14078 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
14079 },
14080 &quot;paths&quot;: [ # The list of path patterns to match. Each must start with /
14081 # and the only place a * is allowed is at the end following
14082 # a /. The string fed to the path matcher does not include
14083 # any text after the first ? or #, and
14084 # those chars are not allowed here.
14085 &quot;A String&quot;,
14086 ],
14087 &quot;routeAction&quot;: { # In response to a matching path, the load balancer
14088 # performs advanced routing actions, such as URL rewrites and header
14089 # transformations, before forwarding the request to the selected
14090 # backend.
14091 #
14092 #
14093 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
14094 #
14095 #
14096 # URL maps for classic Application Load Balancers only support
14097 # the urlRewrite action within a path rule&#x27;srouteAction.
14098 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
14099 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
14100 # property must be specified. This policy cannot be specified if any target
14101 # backend has Identity-Aware Proxy enabled.
14102 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
14103 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
14104 # header names can be specified. The cache is bypassed for all `cacheMode`
14105 # values.
14106 &quot;A String&quot;,
14107 ],
14108 &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
14109 # on the backend type: for Backend Services, the complete request URI is
14110 # used; for Backend Buckets, the request URI is used without the protocol or
14111 # host, and only query parameters known to Cloud Storage are included.
14112 # Policy defined on Route Action.
14113 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
14114 # parameters will be included. Either specify `excludedQueryParameters`
14115 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
14116 # encoded and not treated as delimiters.
14117 #
14118 # Note: This field applies to routes that use backend services. Attempting
14119 # to set it on a route that points exclusively to Backend Buckets will
14120 # result in a configuration error. For routes that point to a Backend
14121 # Bucket, use `includedQueryParameters` to define which parameters should
14122 # be part of the cache key.
14123 &quot;A String&quot;,
14124 ],
14125 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
14126 #
14127 # Note: This setting is only applicable to routes that use a Backend
14128 # Service. It does not affect requests served by a Backend Bucket, as the
14129 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
14130 # it on a route that points exclusively to Backend Buckets will result in a
14131 # configuration error.
14132 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
14133 #
14134 # Note: This setting is only applicable to routes that use a Backend
14135 # Service. It does not affect requests served by a Backend Bucket, as the
14136 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
14137 # set on a route that points exclusively to Backend Buckets will result in
14138 # a configuration error.
14139 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
14140 # `includedQueryParameters` and `excludedQueryParameters`. If neither
14141 # is set, the entire query string will be included. If false, the query
14142 # string will be excluded from the cache key entirely.
14143 #
14144 # Note: This field applies to routes that use backend services. Attempting
14145 # to set it on a route that points exclusively to Backend Buckets will
14146 # result in a configuration error. For routes that point to a Backend
14147 # Bucket, use `includedQueryParameters` to define which parameters should
14148 # be part of the cache key.
14149 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
14150 # The name=value pair will be used in the cache key Cloud CDN generates.
14151 #
14152 # Note: This setting is only applicable to routes that use a Backend
14153 # Service. It does not affect requests served by a Backend Bucket.
14154 # Attempting to set it on a route that points exclusively to Backend
14155 # Buckets will result in a configuration error. Up to 5 cookie names can be
14156 # specified.
14157 &quot;A String&quot;,
14158 ],
14159 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
14160 &quot;A String&quot;,
14161 ],
14162 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
14163 # parameters will be excluded. Either specify `includedQueryParameters`
14164 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
14165 # encoded and not treated as delimiters.
14166 &quot;A String&quot;,
14167 ],
14168 },
14169 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
14170 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
14171 &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
14172 # content. This is used to clamp the max-age (or Expires) value sent to the
14173 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
14174 # is used for the response max-age directive, along with a &quot;public&quot;
14175 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
14176 # clamps the max-age from the origin (if specified), or else sets the
14177 # response max-age directive to the lesser of the `clientTtl` and
14178 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
14179 # present. The maximum allowed value is 31,622,400s (1 year). If not
14180 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
14181 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
14182 # `USE_ORIGIN_HEADERS`.
14183 # as a count of seconds and fractions of seconds at nanosecond
14184 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14185 # or &quot;month&quot;. Range is approximately 10,000 years.
14186 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14187 # Durations less than one second are represented with a 0
14188 # `seconds` field and a positive `nanos` field. Must be from 0
14189 # to 999,999,999 inclusive.
14190 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14191 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14192 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14193 },
14194 &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
14195 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
14196 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
14197 # greater than that of `maxTtl`. When the `cacheMode` is set to
14198 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
14199 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
14200 # accessed objects may be evicted from the cache before the defined TTL. If
14201 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
14202 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
14203 # `USE_ORIGIN_HEADERS`.
14204 # as a count of seconds and fractions of seconds at nanosecond
14205 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14206 # or &quot;month&quot;. Range is approximately 10,000 years.
14207 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14208 # Durations less than one second are represented with a 0
14209 # `seconds` field and a positive `nanos` field. Must be from 0
14210 # to 999,999,999 inclusive.
14211 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14212 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14213 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14214 },
14215 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
14216 # attempt to set a max-age or s-maxage higher than this, or an Expires header
14217 # more than `maxTtl` seconds in the future will be capped at the value of
14218 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
14219 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
14220 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
14221 # Infrequently accessed objects may be evicted from the cache before the
14222 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
14223 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
14224 # mode.
14225 # as a count of seconds and fractions of seconds at nanosecond
14226 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14227 # or &quot;month&quot;. Range is approximately 10,000 years.
14228 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14229 # Durations less than one second are represented with a 0
14230 # `seconds` field and a positive `nanos` field. Must be from 0
14231 # to 999,999,999 inclusive.
14232 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14233 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14234 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14235 },
14236 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
14237 # to apply fine-grained caching for common errors or redirects.
14238 # This can reduce the load on your origin and improve end-user
14239 # experience by reducing response latency.
14240 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
14241 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
14242 # the specified response code that lack any Cache-Control, Expires, or
14243 # Pragma: no-cache directives. When the `cacheMode` is set to
14244 # `FORCE_CACHE_ALL`, negative caching applies to all responses
14245 # with the specified response code, and overrides any caching headers. By
14246 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
14247 #
14248 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
14249 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
14250 # * 405 (Method Not Found), 501 (Not Implemented): 60s
14251 #
14252 # These defaults can be overridden in `negativeCachingPolicy`.
14253 # If not specified, Cloud CDN applies negative caching by default.
14254 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
14255 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
14256 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
14257 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
14258 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
14259 # all response codes that you wish to cache. Cloud CDN will not apply any
14260 # default negative caching when a policy exists.
14261 { # Specify CDN TTLs for response error codes.
14262 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
14263 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
14264 # specified as values, and you cannot specify a status code more than
14265 # once.
14266 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
14267 # corresponding status code.
14268 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
14269 # objects may be evicted from the cache before the defined TTL.
14270 # as a count of seconds and fractions of seconds at nanosecond
14271 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14272 # or &quot;month&quot;. Range is approximately 10,000 years.
14273 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14274 # Durations less than one second are represented with a 0
14275 # `seconds` field and a positive `nanos` field. Must be from 0
14276 # to 999,999,999 inclusive.
14277 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14278 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14279 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14280 },
14281 },
14282 ],
14283 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
14284 # requests into a small number of requests to the origin. If not specified,
14285 # Cloud CDN applies request coalescing by default.
14286 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
14287 # content with the origin, or when an error is encountered when refreshing
14288 # the cache.
14289 # This setting defines the default &quot;max-stale&quot; duration for any cached
14290 # responses that do not specify a max-stale directive. Stale responses that
14291 # exceed the TTL configured here will not be served. The default limit
14292 # (max-stale) is 86400s (1 day), which will allow stale content to be
14293 # served up to this limit beyond the max-age (or s-maxage) of a cached
14294 # response.
14295 # The maximum allowed value is 604800 (1 week).
14296 # Set this to zero (0) to disable serve-while-stale.
14297 # as a count of seconds and fractions of seconds at nanosecond
14298 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14299 # or &quot;month&quot;. Range is approximately 10,000 years.
14300 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14301 # Durations less than one second are represented with a 0
14302 # `seconds` field and a positive `nanos` field. Must be from 0
14303 # to 999,999,999 inclusive.
14304 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14305 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14306 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14307 },
14308 },
14309 &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
14310 # information about the W3C recommendation for cross-origin resource sharing
14311 # (CORS), see Fetch API Living
14312 # Standard.
14313 #
14314 # Not supported when the URL map is bound to a target gRPC proxy.
14315 # information about the W3C recommendation for cross-origin resource sharing
14316 # (CORS), see Fetch API Living
14317 # Standard.
14318 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
14319 # indicates that
14320 # the actual request can include user credentials. This field translates to
14321 # the Access-Control-Allow-Credentials header.
14322 #
14323 # Default is false.
14324 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
14325 # header.
14326 &quot;A String&quot;,
14327 ],
14328 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
14329 # header.
14330 &quot;A String&quot;,
14331 ],
14332 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
14333 # more information, see regular expression syntax.
14334 #
14335 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
14336 #
14337 # Regular expressions can only be used when the loadBalancingScheme is
14338 # set to INTERNAL_SELF_MANAGED.
14339 &quot;A String&quot;,
14340 ],
14341 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
14342 #
14343 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
14344 &quot;A String&quot;,
14345 ],
14346 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
14347 # The default value is false, which indicates that the CORS
14348 # policy is in effect.
14349 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
14350 # header.
14351 &quot;A String&quot;,
14352 ],
14353 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
14354 # seconds. This field translates to the Access-Control-Max-Age
14355 # header.
14356 },
14357 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
14358 # the resiliency of clients to backend service failure. As part of fault
14359 # injection, when clients send requests to a backend service, delays can be
14360 # introduced by a load balancer on a percentage of requests before sending
14361 # those requests to the backend service. Similarly requests from clients can
14362 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
14363 # that are configured with a fault_injection_policy if:
14364 # 1. The traffic is generated by fault injection AND
14365 # 2. The fault injection is not a delay fault injection.
14366 # Fault injection is not supported with the classic Application Load Balancer
14367 # . To see which load balancers support fault injection,
14368 # see Load
14369 # balancing: Routing and traffic management features.
14370 # the resiliency of clients to backend service failure. As part of fault
14371 # injection, when clients send requests to a backend service, delays can be
14372 # introduced by the load balancer on a percentage of requests before sending
14373 # those request to the backend service. Similarly requests from clients can be
14374 # aborted by the load balancer for a percentage of requests.
14375 &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
14376 # injection.
14377 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
14378 #
14379 # The value must be from 200 to 599 inclusive.
14380 #
14381 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
14382 # according to this
14383 # mapping table. HTTP status 200 is mapped to gRPC status
14384 # UNKNOWN. Injecting an OK status is currently not supported by
14385 # Traffic Director.
14386 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
14387 # that is aborted as part of fault injection.
14388 #
14389 # The value must be from 0.0 to 100.0 inclusive.
14390 },
14391 &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
14392 # injection, before being sent to a backend service.
14393 # request to the backend service as part of fault injection.
14394 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
14395 # as a count of seconds and fractions of seconds at nanosecond
14396 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14397 # or &quot;month&quot;. Range is approximately 10,000 years.
14398 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14399 # Durations less than one second are represented with a 0
14400 # `seconds` field and a positive `nanos` field. Must be from 0
14401 # to 999,999,999 inclusive.
14402 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14403 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14404 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14405 },
14406 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
14407 # which a delay is introduced as part of fault injection.
14408 #
14409 # The value must be from 0.0 to 100.0 inclusive.
14410 },
14411 },
14412 &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
14413 # Global EXTERNAL_MANAGED load balancer schemes.
14414 # Either Cloud CDN must be enabled on the backend service or backend bucket
14415 # serving the route, or cache policy must be configured on the same route
14416 # dynamically processes and delivers images from the network edge.
14417 # Image Optimization is only available for Global External Application Load
14418 # Balancers.
14419 # Either Cloud CDN must be enabled on the backend service or backend bucket
14420 # serving the route, or cache policy must be configured on the same route.
14421 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
14422 },
14423 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
14424 # Unlike the timeout field where the timeout duration starts
14425 # from the time the request has been fully processed (known as*end-of-stream*),
14426 # the duration in this field is computed from the beginning of the stream
14427 # until the response has been processed, including all retries. A
14428 # stream that does not complete in this duration is closed.
14429 #
14430 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
14431 # with the route.
14432 #
14433 # This field is only allowed if the Url map is used with backend services
14434 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
14435 # as a count of seconds and fractions of seconds at nanosecond
14436 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14437 # or &quot;month&quot;. Range is approximately 10,000 years.
14438 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14439 # Durations less than one second are represented with a 0
14440 # `seconds` field and a positive `nanos` field. Must be from 0
14441 # to 999,999,999 inclusive.
14442 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14443 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14444 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14445 },
14446 &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
14447 # are shadowed to a separate mirrored backend service. The load balancer does
14448 # not wait for responses from the shadow service. Before sending traffic
14449 # to the shadow service, the host / authority header is suffixed with-shadow.
14450 #
14451 # Not supported when the URL map is bound to a target gRPC proxy that
14452 # has the validateForProxyless field set to true.
14453 # are shadowed to a separate mirrored backend service. The load balancer
14454 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
14455 # to the shadow service, the host or authority header is suffixed with-shadow.
14456 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
14457 # mirrored to.
14458 #
14459 # The backend service configured for a mirroring
14460 # policy must reference backends that are of the same type as the original
14461 # backend service matched in the URL map.
14462 #
14463 # Serverless NEG backends are not currently supported as a mirrored
14464 # backend service.
14465 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
14466 },
14467 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
14468 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
14469 # If not specified, defaults to 1.
14470 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
14471 #
14472 # If not specified, will use the timeout set in theHttpRouteAction field.
14473 # If timeout in the HttpRouteAction field is not set, this field
14474 # uses the largest timeout
14475 # among all backend services associated with the route.
14476 #
14477 # Not supported when the URL map is bound to a target gRPC proxy that
14478 # has the validateForProxyless field set to true.
14479 # as a count of seconds and fractions of seconds at nanosecond
14480 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14481 # or &quot;month&quot;. Range is approximately 10,000 years.
14482 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14483 # Durations less than one second are represented with a 0
14484 # `seconds` field and a positive `nanos` field. Must be from 0
14485 # to 999,999,999 inclusive.
14486 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14487 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14488 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14489 },
14490 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
14491 # values are:
14492 #
14493 # - 5xx: retry is attempted if the instance or endpoint
14494 # responds with any 5xx response code, or if the instance or
14495 # endpoint does not respond at all. For example, disconnects, reset, read
14496 # timeout, connection failure, and refused streams.
14497 # - gateway-error: Similar to 5xx, but only
14498 # applies to response codes 502, 503 or504.
14499 # - connect-failure: a retry is attempted on failures
14500 # connecting to the instance or endpoint. For example, connection
14501 # timeouts.
14502 # - retriable-4xx: a retry is attempted if the instance
14503 # or endpoint responds with a 4xx response code.
14504 # The only error that you can retry is error code 409.
14505 # - refused-stream: a retry is attempted if the instance
14506 # or endpoint resets the stream with a REFUSED_STREAM error
14507 # code. This reset type indicates that it is safe to retry.
14508 # - cancelled: a retry is attempted if the gRPC status
14509 # code in the response header is set to cancelled.
14510 # - deadline-exceeded: a retry is attempted if the gRPC
14511 # status code in the response header is set todeadline-exceeded.
14512 # - internal: a retry is attempted if the gRPC
14513 # status code in the response header is set tointernal.
14514 # - resource-exhausted: a retry is attempted if the gRPC
14515 # status code in the response header is set toresource-exhausted.
14516 # - unavailable: a retry is attempted if the gRPC
14517 # status code in the response header is set tounavailable.
14518 #
14519 # Only the following codes are supported when the URL map is bound to
14520 # target gRPC proxy that has validateForProxyless field set to true.
14521 #
14522 # - cancelled
14523 # - deadline-exceeded
14524 # - internal
14525 # - resource-exhausted
14526 # - unavailable
14527 &quot;A String&quot;,
14528 ],
14529 },
14530 &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
14531 # time the request has been fully processed (known as *end-of-stream*)
14532 # up until the response has been processed. Timeout includes
14533 # all retries.
14534 #
14535 # If not specified, this field uses the largest timeout among all backend
14536 # services associated with the route.
14537 #
14538 # Not supported when the URL map is bound to a target gRPC proxy that
14539 # has validateForProxyless field set to true.
14540 # as a count of seconds and fractions of seconds at nanosecond
14541 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14542 # or &quot;month&quot;. Range is approximately 10,000 years.
14543 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14544 # Durations less than one second are represented with a 0
14545 # `seconds` field and a positive `nanos` field. Must be from 0
14546 # to 999,999,999 inclusive.
14547 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14548 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14549 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14550 },
14551 &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
14552 # to the matched service.
14553 #
14554 # urlRewrite is the only action supported in UrlMaps
14555 # for classic Application Load Balancers.
14556 #
14557 # Not supported when the URL map is bound to a target gRPC proxy that
14558 # has the validateForProxyless field set to true.
14559 # backend service.
14560 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
14561 # host header is replaced with contents of hostRewrite.
14562 #
14563 # The value must be from 1 to 255 characters.
14564 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
14565 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
14566 #
14567 # The value must be from 1 to 1024 characters.
14568 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
14569 # header) using the HTTP template syntax.
14570 #
14571 # A corresponding
14572 # path_template_match must be specified. Any template variables must exist in
14573 # the path_template_match field.
14574 #
14575 #
14576 # - -At least one variable must be specified in the path_template_match
14577 # field
14578 # - You can omit variables from the rewritten URL
14579 # - The * and ** operators cannot be matched
14580 # unless they have a corresponding variable name - e.g.
14581 # {format=*} or {var=**}.
14582 #
14583 # For example, a path_template_match of /static/{format=**}
14584 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
14585 # rewrite, so that /{country}/{format}/{suffix=**} can be
14586 # rewritten as /content/{format}/{country}/{suffix}.
14587 #
14588 # At least
14589 # one non-empty routeRules[].matchRules[].path_template_match is
14590 # required.
14591 #
14592 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
14593 },
14594 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
14595 # occurs. The weights determine the fraction of traffic that flows to
14596 # their corresponding backend service. If all traffic needs to
14597 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
14598 #
14599 # After a backend service is identified and before forwarding
14600 # the request to
14601 # the backend service, advanced routing actions such as URL rewrites and
14602 # header transformations are applied depending on additional settings
14603 # specified in this HttpRouteAction.
14604 { # In contrast to a single BackendService in
14605 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
14606 # multiple backend services. The volume of traffic for each
14607 # backend service is proportional to the weight specified
14608 # in each WeightedBackendService
14609 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
14610 # resource. Before
14611 # forwarding the request to backendService, the load balancer
14612 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
14613 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
14614 # effect for the selected backendService.
14615 #
14616 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
14617 #
14618 # headerAction is not supported for load balancers that have
14619 # their loadBalancingScheme set to EXTERNAL.
14620 #
14621 # Not supported when the URL map is bound to a target gRPC proxy that
14622 # has validateForProxyless field set to true.
14623 # the request is passed along to the selected backendService.
14624 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
14625 { # Specification determining how headers are added to requests or responses.
14626 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
14627 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
14628 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
14629 # that already
14630 # exist for the header. If true, headerValue is set for the
14631 # header, discarding any values that were set for that header.
14632 #
14633 # The default value is true,
14634 # unless a variable is present in headerValue,
14635 # in which case the default value is false.
14636 # .
14637 },
14638 ],
14639 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
14640 # request before forwarding the request to the backendService.
14641 &quot;A String&quot;,
14642 ],
14643 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
14644 # client.
14645 { # Specification determining how headers are added to requests or responses.
14646 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
14647 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
14648 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
14649 # that already
14650 # exist for the header. If true, headerValue is set for the
14651 # header, discarding any values that were set for that header.
14652 #
14653 # The default value is true,
14654 # unless a variable is present in headerValue,
14655 # in which case the default value is false.
14656 # .
14657 },
14658 ],
14659 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
14660 # response before sending the response back to the client.
14661 &quot;A String&quot;,
14662 ],
14663 },
14664 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
14665 # computed asweight / (sum of all weightedBackendService weights in routeAction).
14666 #
14667 # The selection of a backend service is determined only for new traffic.
14668 # Once a user&#x27;s request has been directed to a backend service,
14669 # subsequent requests are sent to the same backend service as
14670 # determined by the backend service&#x27;s session affinity policy.
14671 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
14672 # splitting. If you do, the weighted traffic splitting configuration takes
14673 # precedence.
14674 #
14675 # The value must be from 0 to 1000.
14676 },
14677 ],
14678 },
14679 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
14680 # is directed if this rule is matched. If routeAction is
14681 # also specified, advanced routing actions, such as URL rewrites,
14682 # take effect before sending the request to the backend.
14683 #
14684 #
14685 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
14686 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
14687 # specified by urlRedirect.
14688 #
14689 #
14690 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
14691 #
14692 #
14693 # Not supported when the URL map is bound to a target gRPC proxy.
14694 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
14695 # was supplied in the request.
14696 #
14697 # The value must be from 1 to 255
14698 # characters.
14699 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
14700 # set to HTTPS.
14701 # If set to false, the URL scheme of the redirected request
14702 # remains the same as that of the request.
14703 #
14704 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
14705 #
14706 # The default is set to false.
14707 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
14708 # that was supplied in the request.
14709 #
14710 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
14711 # supplied, the path of the original request is used for the redirect.
14712 #
14713 # The value must be from 1 to 1024 characters.
14714 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
14715 # the HttpRouteRuleMatch, retaining the remaining portion
14716 # of the URL before redirecting the request.
14717 #
14718 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
14719 # supplied, the path of the original request is used for the redirect.
14720 #
14721 # The value must be from 1 to 1024 characters.
14722 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
14723 #
14724 # Supported values are:
14725 #
14726 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
14727 # to 301.
14728 # - FOUND, which corresponds to 302.
14729 # - SEE_OTHER which corresponds to 303.
14730 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
14731 # method is retained.
14732 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
14733 # method is retained.
14734 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
14735 # URL is
14736 # removed before redirecting the request. If set to false, the
14737 # query portion of the original URL is retained.
14738 #
14739 # The default is set to false.
14740 },
14741 },
14742 ],
14743 &quot;routeRules&quot;: [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
14744 # desired. routeRules are evaluated in order of priority, from
14745 # the lowest to highest number.
14746 #
14747 # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
14748 { # The HttpRouteRule setting specifies how to match an HTTP request
14749 # and the corresponding routing action that load balancing proxies perform.
14750 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
14751 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
14752 #
14753 # If a policy for an
14754 # error code is not configured for the RouteRule, a policy for
14755 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
14756 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
14757 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
14758 # effect.
14759 #
14760 # For example, consider a UrlMap with the following configuration:
14761 #
14762 #
14763 # - UrlMap.defaultCustomErrorResponsePolicy are configured
14764 # with policies for 5xx and 4xx errors
14765 # - A RouteRule for /coming_soon/ is configured for the
14766 # error code 404.
14767 #
14768 # 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
14769 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
14770 # the policy in RouteRule.customErrorResponsePolicy takes
14771 # effect. If any of the requests in this example encounter a 500
14772 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
14773 #
14774 # When
14775 # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
14776 # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
14777 # a retry, if load balancer is successful in reaching the
14778 # service, the customErrorResponsePolicy is ignored and
14779 # the response from the service is returned to the client.
14780 #
14781 # customErrorResponsePolicy is supported only for
14782 # global external Application Load Balancers.
14783 # backend service or backend bucket responds with an error.
14784 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
14785 #
14786 # In a given policy, if you specify rules for both a range of error codes
14787 # as well as rules for specific error codes then rules with specific error
14788 # codes have a higher priority. For example, assume that you configure a rule
14789 # for 401 (Un-authorized) code, and another for all 4 series
14790 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
14791 # However if the backend service returns a 403, the rule for4xx takes effect.
14792 { # Specifies the mapping between the response code that will be returned along
14793 # with the custom error content and the response code returned by the backend
14794 # service.
14795 &quot;matchResponseCodes&quot;: [ # Valid values include:
14796 #
14797 #
14798 # - A number between 400 and 599: For example
14799 # 401 or 503, in which case the load balancer
14800 # applies the policy if the error code exactly matches this value.
14801 # - 5xx: Load Balancer will apply the policy if the
14802 # backend service responds with any response code in the range of
14803 # 500 to 599.
14804 # - 4xx: Load
14805 # Balancer will apply the policy if the backend service responds with any
14806 # response code in the range of 400 to
14807 # 499.
14808 #
14809 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
14810 &quot;A String&quot;,
14811 ],
14812 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
14813 # error content. If overrideResponseCode is not supplied, the
14814 # same response code returned by the original backend bucket or backend
14815 # service is returned to the client.
14816 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
14817 #
14818 # path must start
14819 # with a leading slash. path cannot have trailing slashes.
14820 #
14821 # If the file is not available in backendBucket or the
14822 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
14823 #
14824 # The value must
14825 # be from 1 to 1024 characters
14826 },
14827 ],
14828 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
14829 # contains the custom error content. Examples are:
14830 #
14831 #
14832 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
14833 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
14834 # - global/backendBuckets/myBackendBucket
14835 #
14836 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
14837 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
14838 #
14839 # If load balancer cannot reach
14840 # the backendBucket, a simple Not Found Error will
14841 # be returned, with the original response code (oroverrideResponseCode if configured).
14842 #
14843 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
14844 },
14845 &quot;description&quot;: &quot;A String&quot;, # The short description conveying the intent of this routeRule.
14846 #
14847 #
14848 # The description can have a maximum length of 1024 characters.
14849 &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
14850 # for the selected backendService.
14851 #
14852 # The headerAction value specified here is applied before the
14853 # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
14854 #
14855 # HeaderAction is not supported for load balancers
14856 # that have
14857 # their loadBalancingScheme set to EXTERNAL.
14858 #
14859 # Not supported when the URL map is bound to a target gRPC proxy that
14860 # has validateForProxyless field set to true.
14861 # the request is passed along to the selected backendService.
14862 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
14863 { # Specification determining how headers are added to requests or responses.
14864 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
14865 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
14866 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
14867 # that already
14868 # exist for the header. If true, headerValue is set for the
14869 # header, discarding any values that were set for that header.
14870 #
14871 # The default value is true,
14872 # unless a variable is present in headerValue,
14873 # in which case the default value is false.
14874 # .
14875 },
14876 ],
14877 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
14878 # request before forwarding the request to the backendService.
14879 &quot;A String&quot;,
14880 ],
14881 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
14882 # client.
14883 { # Specification determining how headers are added to requests or responses.
14884 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
14885 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
14886 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
14887 # that already
14888 # exist for the header. If true, headerValue is set for the
14889 # header, discarding any values that were set for that header.
14890 #
14891 # The default value is true,
14892 # unless a variable is present in headerValue,
14893 # in which case the default value is false.
14894 # .
14895 },
14896 ],
14897 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
14898 # response before sending the response back to the client.
14899 &quot;A String&quot;,
14900 ],
14901 },
14902 &quot;httpFilterConfigs&quot;: [ # Outbound route specific configuration fornetworkservices.HttpFilter resources enabled by Traffic
14903 # Director. httpFilterConfigs only applies for load balancers
14904 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
14905 # more details.
14906 #
14907 # Not supported when the URL map is bound to a target gRPC proxy that
14908 # has validateForProxyless field set to true.
14909 { # HttpFilterConfiguration supplies additional contextual settings
14910 # for networkservices.HttpFilter resources enabled by Traffic
14911 # Director.
14912 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
14913 # YAML formatted and only contain fields defined in the protobuf identified
14914 # in configTypeUrl
14915 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
14916 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
14917 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
14918 # configuration belongs to. This name must be known to the xDS client.
14919 # Example: envoy.wasm
14920 },
14921 ],
14922 &quot;httpFilterMetadata&quot;: [ # Outbound route specific metadata supplied tonetworkservices.HttpFilter resources enabled by Traffic
14923 # Director. httpFilterMetadata only applies for load balancers
14924 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
14925 # more details.
14926 #
14927 # The only configTypeUrl supported istype.googleapis.com/google.protobuf.Struct
14928 #
14929 # Not supported when the URL map is bound to a target gRPC proxy that
14930 # has validateForProxyless field set to true.
14931 { # HttpFilterConfiguration supplies additional contextual settings
14932 # for networkservices.HttpFilter resources enabled by Traffic
14933 # Director.
14934 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
14935 # YAML formatted and only contain fields defined in the protobuf identified
14936 # in configTypeUrl
14937 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
14938 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
14939 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
14940 # configuration belongs to. This name must be known to the xDS client.
14941 # Example: envoy.wasm
14942 },
14943 ],
14944 &quot;matchRules&quot;: [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
14945 # this routeRule when any of thematchRules are satisfied. However predicates within
14946 # a given matchRule have AND semantics. All predicates
14947 # within a matchRule must match for the request to
14948 # match the rule.
14949 { # HttpRouteRuleMatch specifies a set of criteria for matching
14950 # requests to an HttpRouteRule. All specified criteria must
14951 # be satisfied for a match to occur.
14952 &quot;fullPathMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
14953 # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
14954 # that may be part of the original URL.
14955 #
14956 # fullPathMatch must be from 1 to 1024 characters.
14957 #
14958 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
14959 # specified.
14960 &quot;headerMatches&quot;: [ # Specifies a list of header match criteria, all of which must match
14961 # corresponding headers in the request.
14962 { # matchRule criteria for request header matches.
14963 &quot;exactMatch&quot;: &quot;A String&quot;, # The value should exactly match contents of exactMatch.
14964 #
14965 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
14966 &quot;headerName&quot;: &quot;A String&quot;, # The name of the HTTP header to match.
14967 #
14968 # For matching against the HTTP request&#x27;s authority, use a headerMatch
14969 # with the header name &quot;:authority&quot;.
14970 #
14971 # For matching a request&#x27;s method, use the headerName &quot;:method&quot;.
14972 #
14973 # When the URL map is bound to a target gRPC proxy that has
14974 # the validateForProxyless field set to true, only
14975 # non-binary
14976 # user-specified custom metadata and the `content-type` header are supported.
14977 # The following transport-level headers cannot be used in header matching
14978 # rules:
14979 # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
14980 # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
14981 # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
14982 # `grpc-timeout` and `grpc-trace-bin`.
14983 &quot;invertMatch&quot;: True or False, # If set to false, the headerMatch is considered a
14984 # match if the preceding match criteria are met. If set to true,
14985 # the headerMatch is considered a match if the preceding
14986 # match criteria are NOT met.
14987 #
14988 # The default setting is false.
14989 &quot;prefixMatch&quot;: &quot;A String&quot;, # The value of the header must start with the contents ofprefixMatch.
14990 #
14991 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
14992 &quot;presentMatch&quot;: True or False, # A header with the contents of headerName must exist. The
14993 # match takes place whether or not the request&#x27;s header has a value.
14994 #
14995 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
14996 &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
14997 # specified in rangeMatch. If the header does not contain an
14998 # integer, number or is empty, the match fails.
14999 #
15000 # For example for a range [-5, 0]
15001 #
15002 #
15003 # - -3 will match.
15004 # - 0 will not match.
15005 # - 0.25 will not match.
15006 # - -3someString will not match.
15007 #
15008 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
15009 #
15010 # rangeMatch is not supported for load balancers
15011 # that have loadBalancingScheme set to EXTERNAL.
15012 # within the specified integer range.
15013 &quot;rangeEnd&quot;: &quot;A String&quot;, # The end of the range (exclusive) in signed long integer format.
15014 &quot;rangeStart&quot;: &quot;A String&quot;, # The start of the range (inclusive) in signed long integer format.
15015 },
15016 &quot;regexMatch&quot;: &quot;A String&quot;, # The value of the header must match the regular expression specified inregexMatch.
15017 # For more information about regular expression syntax, see Syntax.
15018 #
15019 # For matching against a port specified in the HTTP request, use a
15020 # headerMatch with headerName set to PORT and a regular expression that
15021 # satisfies the RFC2616 Host header&#x27;s port specifier.
15022 #
15023 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
15024 #
15025 # Regular expressions can only be used when the loadBalancingScheme is
15026 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
15027 # (regional scope) or INTERNAL_MANAGED.
15028 &quot;suffixMatch&quot;: &quot;A String&quot;, # The value of the header must end with the contents ofsuffixMatch.
15029 #
15030 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
15031 },
15032 ],
15033 &quot;ignoreCase&quot;: True or False, # Specifies that prefixMatch and fullPathMatch
15034 # matches are case sensitive.
15035 #
15036 # The default value is false.
15037 #
15038 # ignoreCase must not be used with regexMatch.
15039 #
15040 # Not supported when the URL map is bound to a target gRPC proxy.
15041 &quot;metadataFilters&quot;: [ # Opaque filter criteria used by the load balancer to restrict routing
15042 # configuration to a limited set of xDS
15043 # compliant clients. In their xDS requests to the load balancer, xDS clients
15044 # present node
15045 # metadata. When there is a match, the relevant routing configuration
15046 # is made available to those proxies.
15047 #
15048 # 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
15049 # the metadata. If its filterMatchCriteria is set to
15050 # MATCH_ALL, then all of its filterLabels must match with
15051 # corresponding labels provided in the metadata. If multiple
15052 # metadata filters are specified, all of them need to be
15053 # satisfied in order to be considered a match.
15054 #
15055 # metadataFilters specified here is applied after those
15056 # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
15057 #
15058 # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
15059 #
15060 # Not supported when the URL map is bound to a target gRPC proxy that
15061 # has validateForProxyless field set to true.
15062 { # Opaque filter criteria used by load balancers to restrict routing
15063 # configuration to a limited set of load balancing proxies. Proxies and
15064 # sidecars involved in load balancing would typically present metadata to the
15065 # load balancers that need to match criteria specified here. If a match takes
15066 # place, the relevant configuration is made available to those
15067 # proxies.
15068 #
15069 # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
15070 # one of thefilterLabels must match the corresponding label provided in
15071 # the metadata. If its filterMatchCriteria is set to
15072 # MATCH_ALL, then all of its filterLabels must match with
15073 # corresponding labels provided in the metadata.
15074 #
15075 # An example for using metadataFilters would be: if
15076 # load balancing involves
15077 # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in of their XDS requests to loadbalancers.
15078 &quot;filterLabels&quot;: [ # The list of label value pairs that must match labels in the provided
15079 # metadata based on filterMatchCriteria
15080 #
15081 # This list must not be empty and can have at the most 64 entries.
15082 { # MetadataFilter label name value pairs that are expected
15083 # to match corresponding labels presented as metadata to the load balancer.
15084 &quot;name&quot;: &quot;A String&quot;, # Name of metadata label.
15085 #
15086 # The name can have a maximum length of 1024 characters and must be at
15087 # least 1 character long.
15088 &quot;value&quot;: &quot;A String&quot;, # The value of the label must match the specified value.
15089 #
15090 # value can have a maximum length of 1024 characters.
15091 },
15092 ],
15093 &quot;filterMatchCriteria&quot;: &quot;A String&quot;, # Specifies how individual filter label matches
15094 # within the list of filterLabels and contributes toward the
15095 # overall metadataFilter match.
15096 #
15097 # Supported values are:
15098 #
15099 # - MATCH_ANY: at least one of the filterLabels
15100 # must have a matching label in the provided metadata.
15101 # - MATCH_ALL: all filterLabels must have
15102 # matching labels in the provided metadata.
15103 },
15104 ],
15105 &quot;pathTemplateMatch&quot;: &quot;A String&quot;, # If specified, this field defines a path template pattern that must match
15106 # the :path header after the query string is removed.
15107 #
15108 # A path template pattern can include variables and wildcards.
15109 # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
15110 # matches a single path segment, and ** that matches zero or
15111 # more path segments. The pattern must follow these rules:
15112 #
15113 #
15114 # - The value must be between 1 and 1024 characters.
15115 # - The pattern must start with a leading slash (&quot;/&quot;).
15116 # - No more than 5 operators (variables or wildcards) may appear in
15117 # the pattern.
15118 #
15119 # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
15120 # set.
15121 &quot;prefixMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the request&#x27;s
15122 # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
15123 #
15124 # The value must be from 1 to 1024 characters.
15125 #
15126 # The * character inside a prefix match is
15127 # treated as a literal character, not as a wildcard.
15128 #
15129 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
15130 # used within a matchRule.
15131 &quot;queryParameterMatches&quot;: [ # Specifies a list of query parameter match criteria, all of which must
15132 # match corresponding query parameters in the request.
15133 #
15134 # Not supported when the URL map is bound to a target gRPC proxy.
15135 { # HttpRouteRuleMatch criteria for a request&#x27;s query parameter.
15136 &quot;exactMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
15137 # parameter exactly matches the contents of exactMatch.
15138 #
15139 # Only one of presentMatch, exactMatch, orregexMatch must be set.
15140 &quot;name&quot;: &quot;A String&quot;, # The name of the query parameter to match. The query parameter must exist in
15141 # the request, in the absence of which the request match fails.
15142 &quot;presentMatch&quot;: True or False, # Specifies that the queryParameterMatch matches if the
15143 # request contains the query parameter, irrespective of whether the
15144 # parameter has a value or not.
15145 #
15146 # Only one of presentMatch, exactMatch, orregexMatch must be set.
15147 &quot;regexMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
15148 # parameter matches the regular expression specified byregexMatch. For
15149 # more information about regular expression syntax, see Syntax.
15150 #
15151 # Only one of presentMatch, exactMatch, orregexMatch must be set.
15152 #
15153 # Regular expressions can only be used when the loadBalancingScheme is
15154 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
15155 # (regional scope) or INTERNAL_MANAGED.
15156 },
15157 ],
15158 &quot;regexMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
15159 # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
15160 # supplied with the original URL. For
15161 # more information about regular expression syntax, see Syntax.
15162 #
15163 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
15164 # specified.
15165 #
15166 # Regular expressions can only be used when the loadBalancingScheme is
15167 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
15168 # (regional scope) or INTERNAL_MANAGED.
15169 },
15170 ],
15171 &quot;priority&quot;: 42, # For routeRules within a given pathMatcher,
15172 # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
15173 # of priority, from the lowest to highest number. The priority of a
15174 # rule decreases as its number increases (1, 2, 3, N+1). The first rule
15175 # that matches the request is applied.
15176 #
15177 #
15178 # You cannot configure two or more routeRules with the same priority.
15179 # Priority for each rule must be set to a number from 0 to 2147483647
15180 # inclusive.
15181 #
15182 #
15183 # Priority numbers can have gaps, which enable you to add or remove rules
15184 # in the future without affecting the rest of the rules. For example, 1, 2,
15185 # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
15186 # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
15187 # without any impact on existing rules.
15188 &quot;routeAction&quot;: { # In response to a matching matchRule, the load balancer
15189 # performs advanced routing actions, such as URL rewrites and header
15190 # transformations, before forwarding the request to the selected backend.
15191 #
15192 #
15193 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
15194 #
15195 #
15196 # URL maps for classic Application Load Balancers only support
15197 # the urlRewrite action within a route rule&#x27;srouteAction.
15198 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
15199 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
15200 # property must be specified. This policy cannot be specified if any target
15201 # backend has Identity-Aware Proxy enabled.
15202 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
15203 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
15204 # header names can be specified. The cache is bypassed for all `cacheMode`
15205 # values.
15206 &quot;A String&quot;,
15207 ],
15208 &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
15209 # on the backend type: for Backend Services, the complete request URI is
15210 # used; for Backend Buckets, the request URI is used without the protocol or
15211 # host, and only query parameters known to Cloud Storage are included.
15212 # Policy defined on Route Action.
15213 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
15214 # parameters will be included. Either specify `excludedQueryParameters`
15215 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
15216 # encoded and not treated as delimiters.
15217 #
15218 # Note: This field applies to routes that use backend services. Attempting
15219 # to set it on a route that points exclusively to Backend Buckets will
15220 # result in a configuration error. For routes that point to a Backend
15221 # Bucket, use `includedQueryParameters` to define which parameters should
15222 # be part of the cache key.
15223 &quot;A String&quot;,
15224 ],
15225 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
15226 #
15227 # Note: This setting is only applicable to routes that use a Backend
15228 # Service. It does not affect requests served by a Backend Bucket, as the
15229 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
15230 # it on a route that points exclusively to Backend Buckets will result in a
15231 # configuration error.
15232 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
15233 #
15234 # Note: This setting is only applicable to routes that use a Backend
15235 # Service. It does not affect requests served by a Backend Bucket, as the
15236 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
15237 # set on a route that points exclusively to Backend Buckets will result in
15238 # a configuration error.
15239 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
15240 # `includedQueryParameters` and `excludedQueryParameters`. If neither
15241 # is set, the entire query string will be included. If false, the query
15242 # string will be excluded from the cache key entirely.
15243 #
15244 # Note: This field applies to routes that use backend services. Attempting
15245 # to set it on a route that points exclusively to Backend Buckets will
15246 # result in a configuration error. For routes that point to a Backend
15247 # Bucket, use `includedQueryParameters` to define which parameters should
15248 # be part of the cache key.
15249 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
15250 # The name=value pair will be used in the cache key Cloud CDN generates.
15251 #
15252 # Note: This setting is only applicable to routes that use a Backend
15253 # Service. It does not affect requests served by a Backend Bucket.
15254 # Attempting to set it on a route that points exclusively to Backend
15255 # Buckets will result in a configuration error. Up to 5 cookie names can be
15256 # specified.
15257 &quot;A String&quot;,
15258 ],
15259 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
15260 &quot;A String&quot;,
15261 ],
15262 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
15263 # parameters will be excluded. Either specify `includedQueryParameters`
15264 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
15265 # encoded and not treated as delimiters.
15266 &quot;A String&quot;,
15267 ],
15268 },
15269 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
15270 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
15271 &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
15272 # content. This is used to clamp the max-age (or Expires) value sent to the
15273 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
15274 # is used for the response max-age directive, along with a &quot;public&quot;
15275 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
15276 # clamps the max-age from the origin (if specified), or else sets the
15277 # response max-age directive to the lesser of the `clientTtl` and
15278 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
15279 # present. The maximum allowed value is 31,622,400s (1 year). If not
15280 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
15281 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
15282 # `USE_ORIGIN_HEADERS`.
15283 # as a count of seconds and fractions of seconds at nanosecond
15284 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15285 # or &quot;month&quot;. Range is approximately 10,000 years.
15286 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15287 # Durations less than one second are represented with a 0
15288 # `seconds` field and a positive `nanos` field. Must be from 0
15289 # to 999,999,999 inclusive.
15290 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15291 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15292 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15293 },
15294 &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
15295 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
15296 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
15297 # greater than that of `maxTtl`. When the `cacheMode` is set to
15298 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
15299 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
15300 # accessed objects may be evicted from the cache before the defined TTL. If
15301 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
15302 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
15303 # `USE_ORIGIN_HEADERS`.
15304 # as a count of seconds and fractions of seconds at nanosecond
15305 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15306 # or &quot;month&quot;. Range is approximately 10,000 years.
15307 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15308 # Durations less than one second are represented with a 0
15309 # `seconds` field and a positive `nanos` field. Must be from 0
15310 # to 999,999,999 inclusive.
15311 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15312 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15313 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15314 },
15315 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
15316 # attempt to set a max-age or s-maxage higher than this, or an Expires header
15317 # more than `maxTtl` seconds in the future will be capped at the value of
15318 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
15319 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
15320 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
15321 # Infrequently accessed objects may be evicted from the cache before the
15322 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
15323 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
15324 # mode.
15325 # as a count of seconds and fractions of seconds at nanosecond
15326 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15327 # or &quot;month&quot;. Range is approximately 10,000 years.
15328 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15329 # Durations less than one second are represented with a 0
15330 # `seconds` field and a positive `nanos` field. Must be from 0
15331 # to 999,999,999 inclusive.
15332 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15333 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15334 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15335 },
15336 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
15337 # to apply fine-grained caching for common errors or redirects.
15338 # This can reduce the load on your origin and improve end-user
15339 # experience by reducing response latency.
15340 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
15341 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
15342 # the specified response code that lack any Cache-Control, Expires, or
15343 # Pragma: no-cache directives. When the `cacheMode` is set to
15344 # `FORCE_CACHE_ALL`, negative caching applies to all responses
15345 # with the specified response code, and overrides any caching headers. By
15346 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
15347 #
15348 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
15349 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
15350 # * 405 (Method Not Found), 501 (Not Implemented): 60s
15351 #
15352 # These defaults can be overridden in `negativeCachingPolicy`.
15353 # If not specified, Cloud CDN applies negative caching by default.
15354 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
15355 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
15356 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
15357 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
15358 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
15359 # all response codes that you wish to cache. Cloud CDN will not apply any
15360 # default negative caching when a policy exists.
15361 { # Specify CDN TTLs for response error codes.
15362 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
15363 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
15364 # specified as values, and you cannot specify a status code more than
15365 # once.
15366 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
15367 # corresponding status code.
15368 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
15369 # objects may be evicted from the cache before the defined TTL.
15370 # as a count of seconds and fractions of seconds at nanosecond
15371 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15372 # or &quot;month&quot;. Range is approximately 10,000 years.
15373 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15374 # Durations less than one second are represented with a 0
15375 # `seconds` field and a positive `nanos` field. Must be from 0
15376 # to 999,999,999 inclusive.
15377 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15378 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15379 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15380 },
15381 },
15382 ],
15383 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
15384 # requests into a small number of requests to the origin. If not specified,
15385 # Cloud CDN applies request coalescing by default.
15386 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
15387 # content with the origin, or when an error is encountered when refreshing
15388 # the cache.
15389 # This setting defines the default &quot;max-stale&quot; duration for any cached
15390 # responses that do not specify a max-stale directive. Stale responses that
15391 # exceed the TTL configured here will not be served. The default limit
15392 # (max-stale) is 86400s (1 day), which will allow stale content to be
15393 # served up to this limit beyond the max-age (or s-maxage) of a cached
15394 # response.
15395 # The maximum allowed value is 604800 (1 week).
15396 # Set this to zero (0) to disable serve-while-stale.
15397 # as a count of seconds and fractions of seconds at nanosecond
15398 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15399 # or &quot;month&quot;. Range is approximately 10,000 years.
15400 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15401 # Durations less than one second are represented with a 0
15402 # `seconds` field and a positive `nanos` field. Must be from 0
15403 # to 999,999,999 inclusive.
15404 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15405 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15406 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15407 },
15408 },
15409 &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
15410 # information about the W3C recommendation for cross-origin resource sharing
15411 # (CORS), see Fetch API Living
15412 # Standard.
15413 #
15414 # Not supported when the URL map is bound to a target gRPC proxy.
15415 # information about the W3C recommendation for cross-origin resource sharing
15416 # (CORS), see Fetch API Living
15417 # Standard.
15418 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
15419 # indicates that
15420 # the actual request can include user credentials. This field translates to
15421 # the Access-Control-Allow-Credentials header.
15422 #
15423 # Default is false.
15424 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
15425 # header.
15426 &quot;A String&quot;,
15427 ],
15428 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
15429 # header.
15430 &quot;A String&quot;,
15431 ],
15432 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
15433 # more information, see regular expression syntax.
15434 #
15435 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
15436 #
15437 # Regular expressions can only be used when the loadBalancingScheme is
15438 # set to INTERNAL_SELF_MANAGED.
15439 &quot;A String&quot;,
15440 ],
15441 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
15442 #
15443 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
15444 &quot;A String&quot;,
15445 ],
15446 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
15447 # The default value is false, which indicates that the CORS
15448 # policy is in effect.
15449 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
15450 # header.
15451 &quot;A String&quot;,
15452 ],
15453 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
15454 # seconds. This field translates to the Access-Control-Max-Age
15455 # header.
15456 },
15457 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
15458 # the resiliency of clients to backend service failure. As part of fault
15459 # injection, when clients send requests to a backend service, delays can be
15460 # introduced by a load balancer on a percentage of requests before sending
15461 # those requests to the backend service. Similarly requests from clients can
15462 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
15463 # that are configured with a fault_injection_policy if:
15464 # 1. The traffic is generated by fault injection AND
15465 # 2. The fault injection is not a delay fault injection.
15466 # Fault injection is not supported with the classic Application Load Balancer
15467 # . To see which load balancers support fault injection,
15468 # see Load
15469 # balancing: Routing and traffic management features.
15470 # the resiliency of clients to backend service failure. As part of fault
15471 # injection, when clients send requests to a backend service, delays can be
15472 # introduced by the load balancer on a percentage of requests before sending
15473 # those request to the backend service. Similarly requests from clients can be
15474 # aborted by the load balancer for a percentage of requests.
15475 &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
15476 # injection.
15477 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
15478 #
15479 # The value must be from 200 to 599 inclusive.
15480 #
15481 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
15482 # according to this
15483 # mapping table. HTTP status 200 is mapped to gRPC status
15484 # UNKNOWN. Injecting an OK status is currently not supported by
15485 # Traffic Director.
15486 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
15487 # that is aborted as part of fault injection.
15488 #
15489 # The value must be from 0.0 to 100.0 inclusive.
15490 },
15491 &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
15492 # injection, before being sent to a backend service.
15493 # request to the backend service as part of fault injection.
15494 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
15495 # as a count of seconds and fractions of seconds at nanosecond
15496 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15497 # or &quot;month&quot;. Range is approximately 10,000 years.
15498 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15499 # Durations less than one second are represented with a 0
15500 # `seconds` field and a positive `nanos` field. Must be from 0
15501 # to 999,999,999 inclusive.
15502 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15503 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15504 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15505 },
15506 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
15507 # which a delay is introduced as part of fault injection.
15508 #
15509 # The value must be from 0.0 to 100.0 inclusive.
15510 },
15511 },
15512 &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
15513 # Global EXTERNAL_MANAGED load balancer schemes.
15514 # Either Cloud CDN must be enabled on the backend service or backend bucket
15515 # serving the route, or cache policy must be configured on the same route
15516 # dynamically processes and delivers images from the network edge.
15517 # Image Optimization is only available for Global External Application Load
15518 # Balancers.
15519 # Either Cloud CDN must be enabled on the backend service or backend bucket
15520 # serving the route, or cache policy must be configured on the same route.
15521 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
15522 },
15523 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
15524 # Unlike the timeout field where the timeout duration starts
15525 # from the time the request has been fully processed (known as*end-of-stream*),
15526 # the duration in this field is computed from the beginning of the stream
15527 # until the response has been processed, including all retries. A
15528 # stream that does not complete in this duration is closed.
15529 #
15530 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
15531 # with the route.
15532 #
15533 # This field is only allowed if the Url map is used with backend services
15534 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
15535 # as a count of seconds and fractions of seconds at nanosecond
15536 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15537 # or &quot;month&quot;. Range is approximately 10,000 years.
15538 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15539 # Durations less than one second are represented with a 0
15540 # `seconds` field and a positive `nanos` field. Must be from 0
15541 # to 999,999,999 inclusive.
15542 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15543 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15544 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15545 },
15546 &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
15547 # are shadowed to a separate mirrored backend service. The load balancer does
15548 # not wait for responses from the shadow service. Before sending traffic
15549 # to the shadow service, the host / authority header is suffixed with-shadow.
15550 #
15551 # Not supported when the URL map is bound to a target gRPC proxy that
15552 # has the validateForProxyless field set to true.
15553 # are shadowed to a separate mirrored backend service. The load balancer
15554 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
15555 # to the shadow service, the host or authority header is suffixed with-shadow.
15556 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
15557 # mirrored to.
15558 #
15559 # The backend service configured for a mirroring
15560 # policy must reference backends that are of the same type as the original
15561 # backend service matched in the URL map.
15562 #
15563 # Serverless NEG backends are not currently supported as a mirrored
15564 # backend service.
15565 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
15566 },
15567 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
15568 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
15569 # If not specified, defaults to 1.
15570 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
15571 #
15572 # If not specified, will use the timeout set in theHttpRouteAction field.
15573 # If timeout in the HttpRouteAction field is not set, this field
15574 # uses the largest timeout
15575 # among all backend services associated with the route.
15576 #
15577 # Not supported when the URL map is bound to a target gRPC proxy that
15578 # has the validateForProxyless field set to true.
15579 # as a count of seconds and fractions of seconds at nanosecond
15580 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15581 # or &quot;month&quot;. Range is approximately 10,000 years.
15582 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15583 # Durations less than one second are represented with a 0
15584 # `seconds` field and a positive `nanos` field. Must be from 0
15585 # to 999,999,999 inclusive.
15586 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15587 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15588 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15589 },
15590 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
15591 # values are:
15592 #
15593 # - 5xx: retry is attempted if the instance or endpoint
15594 # responds with any 5xx response code, or if the instance or
15595 # endpoint does not respond at all. For example, disconnects, reset, read
15596 # timeout, connection failure, and refused streams.
15597 # - gateway-error: Similar to 5xx, but only
15598 # applies to response codes 502, 503 or504.
15599 # - connect-failure: a retry is attempted on failures
15600 # connecting to the instance or endpoint. For example, connection
15601 # timeouts.
15602 # - retriable-4xx: a retry is attempted if the instance
15603 # or endpoint responds with a 4xx response code.
15604 # The only error that you can retry is error code 409.
15605 # - refused-stream: a retry is attempted if the instance
15606 # or endpoint resets the stream with a REFUSED_STREAM error
15607 # code. This reset type indicates that it is safe to retry.
15608 # - cancelled: a retry is attempted if the gRPC status
15609 # code in the response header is set to cancelled.
15610 # - deadline-exceeded: a retry is attempted if the gRPC
15611 # status code in the response header is set todeadline-exceeded.
15612 # - internal: a retry is attempted if the gRPC
15613 # status code in the response header is set tointernal.
15614 # - resource-exhausted: a retry is attempted if the gRPC
15615 # status code in the response header is set toresource-exhausted.
15616 # - unavailable: a retry is attempted if the gRPC
15617 # status code in the response header is set tounavailable.
15618 #
15619 # Only the following codes are supported when the URL map is bound to
15620 # target gRPC proxy that has validateForProxyless field set to true.
15621 #
15622 # - cancelled
15623 # - deadline-exceeded
15624 # - internal
15625 # - resource-exhausted
15626 # - unavailable
15627 &quot;A String&quot;,
15628 ],
15629 },
15630 &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
15631 # time the request has been fully processed (known as *end-of-stream*)
15632 # up until the response has been processed. Timeout includes
15633 # all retries.
15634 #
15635 # If not specified, this field uses the largest timeout among all backend
15636 # services associated with the route.
15637 #
15638 # Not supported when the URL map is bound to a target gRPC proxy that
15639 # has validateForProxyless field set to true.
15640 # as a count of seconds and fractions of seconds at nanosecond
15641 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15642 # or &quot;month&quot;. Range is approximately 10,000 years.
15643 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15644 # Durations less than one second are represented with a 0
15645 # `seconds` field and a positive `nanos` field. Must be from 0
15646 # to 999,999,999 inclusive.
15647 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15648 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15649 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15650 },
15651 &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
15652 # to the matched service.
15653 #
15654 # urlRewrite is the only action supported in UrlMaps
15655 # for classic Application Load Balancers.
15656 #
15657 # Not supported when the URL map is bound to a target gRPC proxy that
15658 # has the validateForProxyless field set to true.
15659 # backend service.
15660 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
15661 # host header is replaced with contents of hostRewrite.
15662 #
15663 # The value must be from 1 to 255 characters.
15664 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
15665 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
15666 #
15667 # The value must be from 1 to 1024 characters.
15668 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
15669 # header) using the HTTP template syntax.
15670 #
15671 # A corresponding
15672 # path_template_match must be specified. Any template variables must exist in
15673 # the path_template_match field.
15674 #
15675 #
15676 # - -At least one variable must be specified in the path_template_match
15677 # field
15678 # - You can omit variables from the rewritten URL
15679 # - The * and ** operators cannot be matched
15680 # unless they have a corresponding variable name - e.g.
15681 # {format=*} or {var=**}.
15682 #
15683 # For example, a path_template_match of /static/{format=**}
15684 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
15685 # rewrite, so that /{country}/{format}/{suffix=**} can be
15686 # rewritten as /content/{format}/{country}/{suffix}.
15687 #
15688 # At least
15689 # one non-empty routeRules[].matchRules[].path_template_match is
15690 # required.
15691 #
15692 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
15693 },
15694 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
15695 # occurs. The weights determine the fraction of traffic that flows to
15696 # their corresponding backend service. If all traffic needs to
15697 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
15698 #
15699 # After a backend service is identified and before forwarding
15700 # the request to
15701 # the backend service, advanced routing actions such as URL rewrites and
15702 # header transformations are applied depending on additional settings
15703 # specified in this HttpRouteAction.
15704 { # In contrast to a single BackendService in
15705 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
15706 # multiple backend services. The volume of traffic for each
15707 # backend service is proportional to the weight specified
15708 # in each WeightedBackendService
15709 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
15710 # resource. Before
15711 # forwarding the request to backendService, the load balancer
15712 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
15713 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
15714 # effect for the selected backendService.
15715 #
15716 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
15717 #
15718 # headerAction is not supported for load balancers that have
15719 # their loadBalancingScheme set to EXTERNAL.
15720 #
15721 # Not supported when the URL map is bound to a target gRPC proxy that
15722 # has validateForProxyless field set to true.
15723 # the request is passed along to the selected backendService.
15724 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
15725 { # Specification determining how headers are added to requests or responses.
15726 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
15727 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
15728 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
15729 # that already
15730 # exist for the header. If true, headerValue is set for the
15731 # header, discarding any values that were set for that header.
15732 #
15733 # The default value is true,
15734 # unless a variable is present in headerValue,
15735 # in which case the default value is false.
15736 # .
15737 },
15738 ],
15739 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
15740 # request before forwarding the request to the backendService.
15741 &quot;A String&quot;,
15742 ],
15743 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
15744 # client.
15745 { # Specification determining how headers are added to requests or responses.
15746 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
15747 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
15748 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
15749 # that already
15750 # exist for the header. If true, headerValue is set for the
15751 # header, discarding any values that were set for that header.
15752 #
15753 # The default value is true,
15754 # unless a variable is present in headerValue,
15755 # in which case the default value is false.
15756 # .
15757 },
15758 ],
15759 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
15760 # response before sending the response back to the client.
15761 &quot;A String&quot;,
15762 ],
15763 },
15764 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
15765 # computed asweight / (sum of all weightedBackendService weights in routeAction).
15766 #
15767 # The selection of a backend service is determined only for new traffic.
15768 # Once a user&#x27;s request has been directed to a backend service,
15769 # subsequent requests are sent to the same backend service as
15770 # determined by the backend service&#x27;s session affinity policy.
15771 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
15772 # splitting. If you do, the weighted traffic splitting configuration takes
15773 # precedence.
15774 #
15775 # The value must be from 0 to 1000.
15776 },
15777 ],
15778 },
15779 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
15780 # is directed if this rule is matched. If routeAction is
15781 # also specified, advanced routing actions, such as URL rewrites,
15782 # take effect before sending the request to the backend.
15783 #
15784 #
15785 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
15786 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
15787 # specified by urlRedirect.
15788 #
15789 #
15790 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
15791 #
15792 #
15793 # Not supported when the URL map is bound to a target gRPC proxy.
15794 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
15795 # was supplied in the request.
15796 #
15797 # The value must be from 1 to 255
15798 # characters.
15799 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
15800 # set to HTTPS.
15801 # If set to false, the URL scheme of the redirected request
15802 # remains the same as that of the request.
15803 #
15804 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
15805 #
15806 # The default is set to false.
15807 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
15808 # that was supplied in the request.
15809 #
15810 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
15811 # supplied, the path of the original request is used for the redirect.
15812 #
15813 # The value must be from 1 to 1024 characters.
15814 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
15815 # the HttpRouteRuleMatch, retaining the remaining portion
15816 # of the URL before redirecting the request.
15817 #
15818 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
15819 # supplied, the path of the original request is used for the redirect.
15820 #
15821 # The value must be from 1 to 1024 characters.
15822 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
15823 #
15824 # Supported values are:
15825 #
15826 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
15827 # to 301.
15828 # - FOUND, which corresponds to 302.
15829 # - SEE_OTHER which corresponds to 303.
15830 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
15831 # method is retained.
15832 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
15833 # method is retained.
15834 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
15835 # URL is
15836 # removed before redirecting the request. If set to false, the
15837 # query portion of the original URL is retained.
15838 #
15839 # The default is set to false.
15840 },
15841 },
15842 ],
15843 },
15844 ],
15845 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the regional URL map resides.
15846 # This field is not applicable to global URL maps.
15847 # You must specify this field as part of the HTTP request URL. It is
15848 # not settable as a field in the request body.
15849 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
15850 &quot;status&quot;: { # [Output Only] The status of the URL map. # Output only. [Output Only] The status of the URL map.
15851 &quot;quotaUsage&quot;: { # Message representing the quota usage for a UrlMap. # Output only. Summary of quota usage for given UrlMap.
15852 &quot;forwardingRules&quot;: 42, # Output only. The number of forwarding rules that uses this UrlMap.
15853 &quot;units&quot;: &quot;A String&quot;, # Output only. The number of quota units calculated for this UrlMap.
15854 },
15855 },
15856 &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
15857 # maximum of 100 tests per UrlMap.
15858 #
15859 # Not supported when the URL map is bound to a target gRPC proxy that
15860 # has validateForProxyless field set to true.
15861 { # Message for the expected URL mappings.
15862 &quot;description&quot;: &quot;A String&quot;, # Description of this test case.
15863 &quot;expectedOutputUrl&quot;: &quot;A String&quot;, # The expected output URL evaluated by the load balancer
15864 # containing the scheme, host, path and query parameters.
15865 #
15866 # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
15867 # the load balancer to backends. For rules with urlRewrite,
15868 # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
15869 #
15870 # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer&#x27;s
15871 # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
15872 # If urlRedirect specifies strip_query, the test
15873 # passes only if expectedOutputUrl does not contain any query
15874 # parameters.
15875 #
15876 # expectedOutputUrl is optional whenservice is specified.
15877 &quot;expectedRedirectResponseCode&quot;: 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
15878 # load balancer&#x27;s redirect response.
15879 #
15880 # expectedRedirectResponseCode cannot be set whenservice is set.
15881 &quot;headers&quot;: [ # HTTP headers for this request. If headers contains
15882 # a host header, then host must also match the header value.
15883 { # HTTP headers used in UrlMapTests.
15884 &quot;name&quot;: &quot;A String&quot;, # Header name.
15885 &quot;value&quot;: &quot;A String&quot;, # Header value.
15886 },
15887 ],
15888 &quot;host&quot;: &quot;A String&quot;, # Host portion of the URL. If headers contains a host header,
15889 # then host must also match the header value.
15890 &quot;path&quot;: &quot;A String&quot;, # Path portion of the URL.
15891 &quot;service&quot;: &quot;A String&quot;, # Expected BackendService or BackendBucket resource
15892 # the given URL should be mapped to.
15893 #
15894 # The service field cannot
15895 # be set if expectedRedirectResponseCode is set.
15896 },
15897 ],
15898 },
15899 ],
15900 &quot;kind&quot;: &quot;compute#urlMapList&quot;, # Output only. Type of resource.
15901 &quot;nextPageToken&quot;: &quot;A String&quot;, # [Output Only] This token allows you to get the next page of results for
15902 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
15903 # the query parameter pageToken in the next list request.
15904 # Subsequent list requests will have their own nextPageToken to
15905 # continue paging through the results.
15906 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource.
15907 &quot;warning&quot;: { # [Output Only] Informational warning message.
15908 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
15909 # Engine returns NO_RESULTS_ON_PAGE if there
15910 # are no results in the response.
15911 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
15912 # value format. For example:
15913 #
15914 # &quot;data&quot;: [
15915 # {
15916 # &quot;key&quot;: &quot;scope&quot;,
15917 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
15918 # }
15919 {
15920 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
15921 # returned. For example, for warnings where there are no results in a list
15922 # request for a particular zone, this key might be scope and
15923 # the key value might be the zone name. Other examples might be a key
15924 # indicating a deprecated resource and a suggested replacement, or a
15925 # warning about invalid network settings (for example, if an instance
15926 # attempts to perform IP forwarding but is not enabled for IP forwarding).
15927 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
15928 },
15929 ],
15930 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
15931 },
15932 }</pre>
15933 </div>
15934
15935 <div class="method">
15936 <code class="details" id="list_next">list_next()</code>
15937 <pre>Retrieves the next page of results.
15938
15939 Args:
15940 previous_request: The request for the previous page. (required)
15941 previous_response: The response from the request for the previous page. (required)
15942
15943 Returns:
15944 A request object that you can call &#x27;execute()&#x27; on to request the next
15945 page. Returns None if there are no more items in the collection.
15946 </pre>
15947 </div>
15948
15949 <div class="method">
15950 <code class="details" id="patch">patch(project, urlMap, body=None, requestId=None, x__xgafv=None)</code>
15951 <pre>Patches the specified UrlMap resource with the data included in the
15952 request. This method supportsPATCH
15953 semantics and uses theJSON merge
15954 patch format and processing rules.
15955
15956 Args:
15957 project: string, Project ID for this request. (required)
15958 urlMap: string, Name of the UrlMap resource to patch. (required)
15959 body: object, The request body.
15960 The object takes the form of:
15961
15962 { # Represents a URL Map resource.
15963 #
15964 # Compute Engine has two URL Map resources:
15965 #
15966 # * [Global](/compute/docs/reference/rest/beta/urlMaps)
15967 # * [Regional](/compute/docs/reference/rest/beta/regionUrlMaps)
15968 #
15969 # A URL map resource is a component of certain types of cloud load balancers
15970 # and Traffic Director:
15971 #
15972 # * urlMaps are used by global external Application Load
15973 # Balancers, classic Application Load Balancers, and cross-region internal
15974 # Application Load Balancers.
15975 # * regionUrlMaps are used by internal Application Load Balancers,
15976 # regional external Application Load Balancers and regional internal
15977 # Application Load Balancers.
15978 #
15979 # For a list of supported URL map features by the load balancer type, see the
15980 # Load balancing features: Routing and traffic management table.
15981 #
15982 # For a list of supported URL map features for Traffic Director, see the
15983 # Traffic Director features: Routing and traffic management table.
15984 #
15985 # This resource defines mappings from hostnames and URL paths to either a
15986 # backend service or a backend bucket.
15987 #
15988 # To use the global urlMaps resource, the backend service must
15989 # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
15990 # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
15991 # information, read URL
15992 # Map Concepts.
15993 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
15994 # text format.
15995 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
15996 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
15997 #
15998 # This policy takes
15999 # effect at the load balancer level and applies only when no policy has been
16000 # defined for the error code at lower levels like PathMatcher, RouteRule and
16001 # PathRule within this UrlMap.
16002 #
16003 # For example, consider a UrlMap with the
16004 # following configuration:
16005 #
16006 #
16007 # - defaultCustomErrorResponsePolicy containing policies for
16008 # responding to 5xx and 4xx errors
16009 # - A PathMatcher configured for *.example.com has
16010 # defaultCustomErrorResponsePolicy for 4xx.
16011 #
16012 # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
16013 # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
16014 # a request that does not match any host in *.example.com such
16015 # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
16016 # takes effect.
16017 #
16018 # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
16019 # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
16020 # a retry, if load balancer is successful in reaching the
16021 # service, the defaultCustomErrorResponsePolicy is ignored and
16022 # the response from the service is returned to the client.
16023 #
16024 # defaultCustomErrorResponsePolicy is supported only for
16025 # global external Application Load Balancers.
16026 # backend service or backend bucket responds with an error.
16027 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
16028 #
16029 # In a given policy, if you specify rules for both a range of error codes
16030 # as well as rules for specific error codes then rules with specific error
16031 # codes have a higher priority. For example, assume that you configure a rule
16032 # for 401 (Un-authorized) code, and another for all 4 series
16033 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
16034 # However if the backend service returns a 403, the rule for4xx takes effect.
16035 { # Specifies the mapping between the response code that will be returned along
16036 # with the custom error content and the response code returned by the backend
16037 # service.
16038 &quot;matchResponseCodes&quot;: [ # Valid values include:
16039 #
16040 #
16041 # - A number between 400 and 599: For example
16042 # 401 or 503, in which case the load balancer
16043 # applies the policy if the error code exactly matches this value.
16044 # - 5xx: Load Balancer will apply the policy if the
16045 # backend service responds with any response code in the range of
16046 # 500 to 599.
16047 # - 4xx: Load
16048 # Balancer will apply the policy if the backend service responds with any
16049 # response code in the range of 400 to
16050 # 499.
16051 #
16052 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
16053 &quot;A String&quot;,
16054 ],
16055 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
16056 # error content. If overrideResponseCode is not supplied, the
16057 # same response code returned by the original backend bucket or backend
16058 # service is returned to the client.
16059 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
16060 #
16061 # path must start
16062 # with a leading slash. path cannot have trailing slashes.
16063 #
16064 # If the file is not available in backendBucket or the
16065 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
16066 #
16067 # The value must
16068 # be from 1 to 1024 characters
16069 },
16070 ],
16071 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
16072 # contains the custom error content. Examples are:
16073 #
16074 #
16075 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
16076 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
16077 # - global/backendBuckets/myBackendBucket
16078 #
16079 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
16080 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
16081 #
16082 # If load balancer cannot reach
16083 # the backendBucket, a simple Not Found Error will
16084 # be returned, with the original response code (oroverrideResponseCode if configured).
16085 #
16086 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
16087 },
16088 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
16089 # hostRules match. The load balancer performs advanced routing
16090 # actions, such as URL rewrites and header transformations, before forwarding
16091 # the request to the selected backend.
16092 #
16093 #
16094 # Only one of defaultUrlRedirect, defaultService
16095 # or defaultRouteAction.weightedBackendService can be set.
16096 #
16097 #
16098 # URL maps for classic Application Load Balancers only support
16099 # the urlRewrite action within defaultRouteAction.
16100 #
16101 #
16102 # defaultRouteAction has no effect when the URL map is bound
16103 # to a target gRPC proxy that has the validateForProxyless field
16104 # set to true.
16105 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
16106 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
16107 # property must be specified. This policy cannot be specified if any target
16108 # backend has Identity-Aware Proxy enabled.
16109 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
16110 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
16111 # header names can be specified. The cache is bypassed for all `cacheMode`
16112 # values.
16113 &quot;A String&quot;,
16114 ],
16115 &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
16116 # on the backend type: for Backend Services, the complete request URI is
16117 # used; for Backend Buckets, the request URI is used without the protocol or
16118 # host, and only query parameters known to Cloud Storage are included.
16119 # Policy defined on Route Action.
16120 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
16121 # parameters will be included. Either specify `excludedQueryParameters`
16122 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
16123 # encoded and not treated as delimiters.
16124 #
16125 # Note: This field applies to routes that use backend services. Attempting
16126 # to set it on a route that points exclusively to Backend Buckets will
16127 # result in a configuration error. For routes that point to a Backend
16128 # Bucket, use `includedQueryParameters` to define which parameters should
16129 # be part of the cache key.
16130 &quot;A String&quot;,
16131 ],
16132 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
16133 #
16134 # Note: This setting is only applicable to routes that use a Backend
16135 # Service. It does not affect requests served by a Backend Bucket, as the
16136 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
16137 # it on a route that points exclusively to Backend Buckets will result in a
16138 # configuration error.
16139 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
16140 #
16141 # Note: This setting is only applicable to routes that use a Backend
16142 # Service. It does not affect requests served by a Backend Bucket, as the
16143 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
16144 # set on a route that points exclusively to Backend Buckets will result in
16145 # a configuration error.
16146 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
16147 # `includedQueryParameters` and `excludedQueryParameters`. If neither
16148 # is set, the entire query string will be included. If false, the query
16149 # string will be excluded from the cache key entirely.
16150 #
16151 # Note: This field applies to routes that use backend services. Attempting
16152 # to set it on a route that points exclusively to Backend Buckets will
16153 # result in a configuration error. For routes that point to a Backend
16154 # Bucket, use `includedQueryParameters` to define which parameters should
16155 # be part of the cache key.
16156 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
16157 # The name=value pair will be used in the cache key Cloud CDN generates.
16158 #
16159 # Note: This setting is only applicable to routes that use a Backend
16160 # Service. It does not affect requests served by a Backend Bucket.
16161 # Attempting to set it on a route that points exclusively to Backend
16162 # Buckets will result in a configuration error. Up to 5 cookie names can be
16163 # specified.
16164 &quot;A String&quot;,
16165 ],
16166 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
16167 &quot;A String&quot;,
16168 ],
16169 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
16170 # parameters will be excluded. Either specify `includedQueryParameters`
16171 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
16172 # encoded and not treated as delimiters.
16173 &quot;A String&quot;,
16174 ],
16175 },
16176 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
16177 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
16178 &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
16179 # content. This is used to clamp the max-age (or Expires) value sent to the
16180 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
16181 # is used for the response max-age directive, along with a &quot;public&quot;
16182 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
16183 # clamps the max-age from the origin (if specified), or else sets the
16184 # response max-age directive to the lesser of the `clientTtl` and
16185 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
16186 # present. The maximum allowed value is 31,622,400s (1 year). If not
16187 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
16188 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
16189 # `USE_ORIGIN_HEADERS`.
16190 # as a count of seconds and fractions of seconds at nanosecond
16191 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16192 # or &quot;month&quot;. Range is approximately 10,000 years.
16193 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16194 # Durations less than one second are represented with a 0
16195 # `seconds` field and a positive `nanos` field. Must be from 0
16196 # to 999,999,999 inclusive.
16197 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16198 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16199 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16200 },
16201 &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
16202 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
16203 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
16204 # greater than that of `maxTtl`. When the `cacheMode` is set to
16205 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
16206 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
16207 # accessed objects may be evicted from the cache before the defined TTL. If
16208 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
16209 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
16210 # `USE_ORIGIN_HEADERS`.
16211 # as a count of seconds and fractions of seconds at nanosecond
16212 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16213 # or &quot;month&quot;. Range is approximately 10,000 years.
16214 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16215 # Durations less than one second are represented with a 0
16216 # `seconds` field and a positive `nanos` field. Must be from 0
16217 # to 999,999,999 inclusive.
16218 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16219 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16220 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16221 },
16222 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
16223 # attempt to set a max-age or s-maxage higher than this, or an Expires header
16224 # more than `maxTtl` seconds in the future will be capped at the value of
16225 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
16226 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
16227 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
16228 # Infrequently accessed objects may be evicted from the cache before the
16229 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
16230 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
16231 # mode.
16232 # as a count of seconds and fractions of seconds at nanosecond
16233 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16234 # or &quot;month&quot;. Range is approximately 10,000 years.
16235 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16236 # Durations less than one second are represented with a 0
16237 # `seconds` field and a positive `nanos` field. Must be from 0
16238 # to 999,999,999 inclusive.
16239 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16240 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16241 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16242 },
16243 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
16244 # to apply fine-grained caching for common errors or redirects.
16245 # This can reduce the load on your origin and improve end-user
16246 # experience by reducing response latency.
16247 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
16248 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
16249 # the specified response code that lack any Cache-Control, Expires, or
16250 # Pragma: no-cache directives. When the `cacheMode` is set to
16251 # `FORCE_CACHE_ALL`, negative caching applies to all responses
16252 # with the specified response code, and overrides any caching headers. By
16253 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
16254 #
16255 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
16256 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
16257 # * 405 (Method Not Found), 501 (Not Implemented): 60s
16258 #
16259 # These defaults can be overridden in `negativeCachingPolicy`.
16260 # If not specified, Cloud CDN applies negative caching by default.
16261 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
16262 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
16263 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
16264 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
16265 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
16266 # all response codes that you wish to cache. Cloud CDN will not apply any
16267 # default negative caching when a policy exists.
16268 { # Specify CDN TTLs for response error codes.
16269 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
16270 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
16271 # specified as values, and you cannot specify a status code more than
16272 # once.
16273 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
16274 # corresponding status code.
16275 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
16276 # objects may be evicted from the cache before the defined TTL.
16277 # as a count of seconds and fractions of seconds at nanosecond
16278 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16279 # or &quot;month&quot;. Range is approximately 10,000 years.
16280 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16281 # Durations less than one second are represented with a 0
16282 # `seconds` field and a positive `nanos` field. Must be from 0
16283 # to 999,999,999 inclusive.
16284 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16285 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16286 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16287 },
16288 },
16289 ],
16290 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
16291 # requests into a small number of requests to the origin. If not specified,
16292 # Cloud CDN applies request coalescing by default.
16293 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
16294 # content with the origin, or when an error is encountered when refreshing
16295 # the cache.
16296 # This setting defines the default &quot;max-stale&quot; duration for any cached
16297 # responses that do not specify a max-stale directive. Stale responses that
16298 # exceed the TTL configured here will not be served. The default limit
16299 # (max-stale) is 86400s (1 day), which will allow stale content to be
16300 # served up to this limit beyond the max-age (or s-maxage) of a cached
16301 # response.
16302 # The maximum allowed value is 604800 (1 week).
16303 # Set this to zero (0) to disable serve-while-stale.
16304 # as a count of seconds and fractions of seconds at nanosecond
16305 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16306 # or &quot;month&quot;. Range is approximately 10,000 years.
16307 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16308 # Durations less than one second are represented with a 0
16309 # `seconds` field and a positive `nanos` field. Must be from 0
16310 # to 999,999,999 inclusive.
16311 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16312 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16313 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16314 },
16315 },
16316 &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
16317 # information about the W3C recommendation for cross-origin resource sharing
16318 # (CORS), see Fetch API Living
16319 # Standard.
16320 #
16321 # Not supported when the URL map is bound to a target gRPC proxy.
16322 # information about the W3C recommendation for cross-origin resource sharing
16323 # (CORS), see Fetch API Living
16324 # Standard.
16325 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
16326 # indicates that
16327 # the actual request can include user credentials. This field translates to
16328 # the Access-Control-Allow-Credentials header.
16329 #
16330 # Default is false.
16331 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
16332 # header.
16333 &quot;A String&quot;,
16334 ],
16335 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
16336 # header.
16337 &quot;A String&quot;,
16338 ],
16339 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
16340 # more information, see regular expression syntax.
16341 #
16342 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
16343 #
16344 # Regular expressions can only be used when the loadBalancingScheme is
16345 # set to INTERNAL_SELF_MANAGED.
16346 &quot;A String&quot;,
16347 ],
16348 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
16349 #
16350 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
16351 &quot;A String&quot;,
16352 ],
16353 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
16354 # The default value is false, which indicates that the CORS
16355 # policy is in effect.
16356 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
16357 # header.
16358 &quot;A String&quot;,
16359 ],
16360 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
16361 # seconds. This field translates to the Access-Control-Max-Age
16362 # header.
16363 },
16364 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
16365 # the resiliency of clients to backend service failure. As part of fault
16366 # injection, when clients send requests to a backend service, delays can be
16367 # introduced by a load balancer on a percentage of requests before sending
16368 # those requests to the backend service. Similarly requests from clients can
16369 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
16370 # that are configured with a fault_injection_policy if:
16371 # 1. The traffic is generated by fault injection AND
16372 # 2. The fault injection is not a delay fault injection.
16373 # Fault injection is not supported with the classic Application Load Balancer
16374 # . To see which load balancers support fault injection,
16375 # see Load
16376 # balancing: Routing and traffic management features.
16377 # the resiliency of clients to backend service failure. As part of fault
16378 # injection, when clients send requests to a backend service, delays can be
16379 # introduced by the load balancer on a percentage of requests before sending
16380 # those request to the backend service. Similarly requests from clients can be
16381 # aborted by the load balancer for a percentage of requests.
16382 &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
16383 # injection.
16384 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
16385 #
16386 # The value must be from 200 to 599 inclusive.
16387 #
16388 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
16389 # according to this
16390 # mapping table. HTTP status 200 is mapped to gRPC status
16391 # UNKNOWN. Injecting an OK status is currently not supported by
16392 # Traffic Director.
16393 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
16394 # that is aborted as part of fault injection.
16395 #
16396 # The value must be from 0.0 to 100.0 inclusive.
16397 },
16398 &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
16399 # injection, before being sent to a backend service.
16400 # request to the backend service as part of fault injection.
16401 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
16402 # as a count of seconds and fractions of seconds at nanosecond
16403 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16404 # or &quot;month&quot;. Range is approximately 10,000 years.
16405 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16406 # Durations less than one second are represented with a 0
16407 # `seconds` field and a positive `nanos` field. Must be from 0
16408 # to 999,999,999 inclusive.
16409 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16410 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16411 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16412 },
16413 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
16414 # which a delay is introduced as part of fault injection.
16415 #
16416 # The value must be from 0.0 to 100.0 inclusive.
16417 },
16418 },
16419 &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
16420 # Global EXTERNAL_MANAGED load balancer schemes.
16421 # Either Cloud CDN must be enabled on the backend service or backend bucket
16422 # serving the route, or cache policy must be configured on the same route
16423 # dynamically processes and delivers images from the network edge.
16424 # Image Optimization is only available for Global External Application Load
16425 # Balancers.
16426 # Either Cloud CDN must be enabled on the backend service or backend bucket
16427 # serving the route, or cache policy must be configured on the same route.
16428 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
16429 },
16430 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
16431 # Unlike the timeout field where the timeout duration starts
16432 # from the time the request has been fully processed (known as*end-of-stream*),
16433 # the duration in this field is computed from the beginning of the stream
16434 # until the response has been processed, including all retries. A
16435 # stream that does not complete in this duration is closed.
16436 #
16437 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
16438 # with the route.
16439 #
16440 # This field is only allowed if the Url map is used with backend services
16441 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
16442 # as a count of seconds and fractions of seconds at nanosecond
16443 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16444 # or &quot;month&quot;. Range is approximately 10,000 years.
16445 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16446 # Durations less than one second are represented with a 0
16447 # `seconds` field and a positive `nanos` field. Must be from 0
16448 # to 999,999,999 inclusive.
16449 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16450 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16451 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16452 },
16453 &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
16454 # are shadowed to a separate mirrored backend service. The load balancer does
16455 # not wait for responses from the shadow service. Before sending traffic
16456 # to the shadow service, the host / authority header is suffixed with-shadow.
16457 #
16458 # Not supported when the URL map is bound to a target gRPC proxy that
16459 # has the validateForProxyless field set to true.
16460 # are shadowed to a separate mirrored backend service. The load balancer
16461 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
16462 # to the shadow service, the host or authority header is suffixed with-shadow.
16463 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
16464 # mirrored to.
16465 #
16466 # The backend service configured for a mirroring
16467 # policy must reference backends that are of the same type as the original
16468 # backend service matched in the URL map.
16469 #
16470 # Serverless NEG backends are not currently supported as a mirrored
16471 # backend service.
16472 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
16473 },
16474 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
16475 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
16476 # If not specified, defaults to 1.
16477 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
16478 #
16479 # If not specified, will use the timeout set in theHttpRouteAction field.
16480 # If timeout in the HttpRouteAction field is not set, this field
16481 # uses the largest timeout
16482 # among all backend services associated with the route.
16483 #
16484 # Not supported when the URL map is bound to a target gRPC proxy that
16485 # has the validateForProxyless field set to true.
16486 # as a count of seconds and fractions of seconds at nanosecond
16487 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16488 # or &quot;month&quot;. Range is approximately 10,000 years.
16489 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16490 # Durations less than one second are represented with a 0
16491 # `seconds` field and a positive `nanos` field. Must be from 0
16492 # to 999,999,999 inclusive.
16493 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16494 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16495 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16496 },
16497 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
16498 # values are:
16499 #
16500 # - 5xx: retry is attempted if the instance or endpoint
16501 # responds with any 5xx response code, or if the instance or
16502 # endpoint does not respond at all. For example, disconnects, reset, read
16503 # timeout, connection failure, and refused streams.
16504 # - gateway-error: Similar to 5xx, but only
16505 # applies to response codes 502, 503 or504.
16506 # - connect-failure: a retry is attempted on failures
16507 # connecting to the instance or endpoint. For example, connection
16508 # timeouts.
16509 # - retriable-4xx: a retry is attempted if the instance
16510 # or endpoint responds with a 4xx response code.
16511 # The only error that you can retry is error code 409.
16512 # - refused-stream: a retry is attempted if the instance
16513 # or endpoint resets the stream with a REFUSED_STREAM error
16514 # code. This reset type indicates that it is safe to retry.
16515 # - cancelled: a retry is attempted if the gRPC status
16516 # code in the response header is set to cancelled.
16517 # - deadline-exceeded: a retry is attempted if the gRPC
16518 # status code in the response header is set todeadline-exceeded.
16519 # - internal: a retry is attempted if the gRPC
16520 # status code in the response header is set tointernal.
16521 # - resource-exhausted: a retry is attempted if the gRPC
16522 # status code in the response header is set toresource-exhausted.
16523 # - unavailable: a retry is attempted if the gRPC
16524 # status code in the response header is set tounavailable.
16525 #
16526 # Only the following codes are supported when the URL map is bound to
16527 # target gRPC proxy that has validateForProxyless field set to true.
16528 #
16529 # - cancelled
16530 # - deadline-exceeded
16531 # - internal
16532 # - resource-exhausted
16533 # - unavailable
16534 &quot;A String&quot;,
16535 ],
16536 },
16537 &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
16538 # time the request has been fully processed (known as *end-of-stream*)
16539 # up until the response has been processed. Timeout includes
16540 # all retries.
16541 #
16542 # If not specified, this field uses the largest timeout among all backend
16543 # services associated with the route.
16544 #
16545 # Not supported when the URL map is bound to a target gRPC proxy that
16546 # has validateForProxyless field set to true.
16547 # as a count of seconds and fractions of seconds at nanosecond
16548 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16549 # or &quot;month&quot;. Range is approximately 10,000 years.
16550 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16551 # Durations less than one second are represented with a 0
16552 # `seconds` field and a positive `nanos` field. Must be from 0
16553 # to 999,999,999 inclusive.
16554 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16555 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16556 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16557 },
16558 &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
16559 # to the matched service.
16560 #
16561 # urlRewrite is the only action supported in UrlMaps
16562 # for classic Application Load Balancers.
16563 #
16564 # Not supported when the URL map is bound to a target gRPC proxy that
16565 # has the validateForProxyless field set to true.
16566 # backend service.
16567 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
16568 # host header is replaced with contents of hostRewrite.
16569 #
16570 # The value must be from 1 to 255 characters.
16571 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
16572 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
16573 #
16574 # The value must be from 1 to 1024 characters.
16575 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
16576 # header) using the HTTP template syntax.
16577 #
16578 # A corresponding
16579 # path_template_match must be specified. Any template variables must exist in
16580 # the path_template_match field.
16581 #
16582 #
16583 # - -At least one variable must be specified in the path_template_match
16584 # field
16585 # - You can omit variables from the rewritten URL
16586 # - The * and ** operators cannot be matched
16587 # unless they have a corresponding variable name - e.g.
16588 # {format=*} or {var=**}.
16589 #
16590 # For example, a path_template_match of /static/{format=**}
16591 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
16592 # rewrite, so that /{country}/{format}/{suffix=**} can be
16593 # rewritten as /content/{format}/{country}/{suffix}.
16594 #
16595 # At least
16596 # one non-empty routeRules[].matchRules[].path_template_match is
16597 # required.
16598 #
16599 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
16600 },
16601 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
16602 # occurs. The weights determine the fraction of traffic that flows to
16603 # their corresponding backend service. If all traffic needs to
16604 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
16605 #
16606 # After a backend service is identified and before forwarding
16607 # the request to
16608 # the backend service, advanced routing actions such as URL rewrites and
16609 # header transformations are applied depending on additional settings
16610 # specified in this HttpRouteAction.
16611 { # In contrast to a single BackendService in
16612 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
16613 # multiple backend services. The volume of traffic for each
16614 # backend service is proportional to the weight specified
16615 # in each WeightedBackendService
16616 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
16617 # resource. Before
16618 # forwarding the request to backendService, the load balancer
16619 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
16620 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
16621 # effect for the selected backendService.
16622 #
16623 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
16624 #
16625 # headerAction is not supported for load balancers that have
16626 # their loadBalancingScheme set to EXTERNAL.
16627 #
16628 # Not supported when the URL map is bound to a target gRPC proxy that
16629 # has validateForProxyless field set to true.
16630 # the request is passed along to the selected backendService.
16631 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
16632 { # Specification determining how headers are added to requests or responses.
16633 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
16634 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
16635 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
16636 # that already
16637 # exist for the header. If true, headerValue is set for the
16638 # header, discarding any values that were set for that header.
16639 #
16640 # The default value is true,
16641 # unless a variable is present in headerValue,
16642 # in which case the default value is false.
16643 # .
16644 },
16645 ],
16646 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
16647 # request before forwarding the request to the backendService.
16648 &quot;A String&quot;,
16649 ],
16650 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
16651 # client.
16652 { # Specification determining how headers are added to requests or responses.
16653 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
16654 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
16655 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
16656 # that already
16657 # exist for the header. If true, headerValue is set for the
16658 # header, discarding any values that were set for that header.
16659 #
16660 # The default value is true,
16661 # unless a variable is present in headerValue,
16662 # in which case the default value is false.
16663 # .
16664 },
16665 ],
16666 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
16667 # response before sending the response back to the client.
16668 &quot;A String&quot;,
16669 ],
16670 },
16671 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
16672 # computed asweight / (sum of all weightedBackendService weights in routeAction).
16673 #
16674 # The selection of a backend service is determined only for new traffic.
16675 # Once a user&#x27;s request has been directed to a backend service,
16676 # subsequent requests are sent to the same backend service as
16677 # determined by the backend service&#x27;s session affinity policy.
16678 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
16679 # splitting. If you do, the weighted traffic splitting configuration takes
16680 # precedence.
16681 #
16682 # The value must be from 0 to 1000.
16683 },
16684 ],
16685 },
16686 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL of the defaultService resource to
16687 # which traffic is directed if none of the hostRules match.
16688 # If defaultRouteAction is also specified, advanced
16689 # routing actions, such as URL rewrites, take effect before sending the
16690 # request to the backend.
16691 #
16692 #
16693 # Only one of defaultUrlRedirect, defaultService
16694 # or defaultRouteAction.weightedBackendService can be set.
16695 #
16696 #
16697 # defaultService has no effect when the URL map is bound
16698 # to a target gRPC proxy that has the validateForProxyless field
16699 # set to true.
16700 &quot;defaultUrlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
16701 # is redirected to a URL specified by defaultUrlRedirect.
16702 #
16703 #
16704 # Only one of defaultUrlRedirect, defaultService
16705 # or defaultRouteAction.weightedBackendService can be set.
16706 #
16707 #
16708 # Not supported when the URL map is bound to a target gRPC proxy.
16709 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
16710 # was supplied in the request.
16711 #
16712 # The value must be from 1 to 255
16713 # characters.
16714 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
16715 # set to HTTPS.
16716 # If set to false, the URL scheme of the redirected request
16717 # remains the same as that of the request.
16718 #
16719 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
16720 #
16721 # The default is set to false.
16722 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
16723 # that was supplied in the request.
16724 #
16725 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
16726 # supplied, the path of the original request is used for the redirect.
16727 #
16728 # The value must be from 1 to 1024 characters.
16729 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
16730 # the HttpRouteRuleMatch, retaining the remaining portion
16731 # of the URL before redirecting the request.
16732 #
16733 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
16734 # supplied, the path of the original request is used for the redirect.
16735 #
16736 # The value must be from 1 to 1024 characters.
16737 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
16738 #
16739 # Supported values are:
16740 #
16741 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
16742 # to 301.
16743 # - FOUND, which corresponds to 302.
16744 # - SEE_OTHER which corresponds to 303.
16745 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
16746 # method is retained.
16747 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
16748 # method is retained.
16749 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
16750 # URL is
16751 # removed before redirecting the request. If set to false, the
16752 # query portion of the original URL is retained.
16753 #
16754 # The default is set to false.
16755 },
16756 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
16757 # create the resource.
16758 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. A hash of the contents stored in this object.
16759 # This field is used in optimistic locking. This field is ignored when
16760 # inserting a UrlMap. An up-to-date fingerprint must be provided
16761 # in order to update the UrlMap, otherwise the request will
16762 # fail with error 412 conditionNotMet.
16763 #
16764 # To see the latest fingerprint, make a get() request to
16765 # retrieve a UrlMap.
16766 &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
16767 # for the selected backendService.
16768 #
16769 # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
16770 #
16771 # headerAction is not supported for load balancers
16772 # that have
16773 # their loadBalancingScheme set to EXTERNAL.
16774 #
16775 # Not supported when the URL map is bound to a target gRPC proxy that
16776 # has validateForProxyless field set to true.
16777 # the request is passed along to the selected backendService.
16778 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
16779 { # Specification determining how headers are added to requests or responses.
16780 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
16781 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
16782 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
16783 # that already
16784 # exist for the header. If true, headerValue is set for the
16785 # header, discarding any values that were set for that header.
16786 #
16787 # The default value is true,
16788 # unless a variable is present in headerValue,
16789 # in which case the default value is false.
16790 # .
16791 },
16792 ],
16793 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
16794 # request before forwarding the request to the backendService.
16795 &quot;A String&quot;,
16796 ],
16797 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
16798 # client.
16799 { # Specification determining how headers are added to requests or responses.
16800 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
16801 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
16802 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
16803 # that already
16804 # exist for the header. If true, headerValue is set for the
16805 # header, discarding any values that were set for that header.
16806 #
16807 # The default value is true,
16808 # unless a variable is present in headerValue,
16809 # in which case the default value is false.
16810 # .
16811 },
16812 ],
16813 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
16814 # response before sending the response back to the client.
16815 &quot;A String&quot;,
16816 ],
16817 },
16818 &quot;hostRules&quot;: [ # The list of host rules to use against the URL.
16819 { # UrlMaps
16820 # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
16821 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
16822 # create the resource.
16823 &quot;hosts&quot;: [ # The list of host patterns to match. They must be valid hostnames with
16824 # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
16825 # that case, * must be the first character, and if followed by
16826 # anything, the immediate following character must be either -
16827 # or ..
16828 #
16829 # * based matching is not supported when the URL map is bound
16830 # to a target gRPC proxy that has the validateForProxyless field
16831 # set to true.
16832 &quot;A String&quot;,
16833 ],
16834 &quot;pathMatcher&quot;: &quot;A String&quot;, # The name of the PathMatcher to use to match the path portion
16835 # of the URL if the hostRule matches the URL&#x27;s host portion.
16836 },
16837 ],
16838 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the resource. This identifier is
16839 # defined by the server.
16840 &quot;kind&quot;: &quot;compute#urlMap&quot;, # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
16841 # url maps.
16842 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
16843 # The name must be 1-63 characters long, and comply withRFC1035.
16844 # Specifically, the name must be 1-63 characters long and match the regular
16845 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
16846 # character must be a lowercase letter, and all following characters must
16847 # be a dash, lowercase letter, or digit, except the last character, which
16848 # cannot be a dash.
16849 &quot;pathMatchers&quot;: [ # The list of named PathMatchers to use against the URL.
16850 { # A matcher for the path portion of the URL. The BackendService
16851 # from the longest-matched rule will serve the URL. If no rule was matched, the
16852 # default service is used.
16853 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
16854 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
16855 #
16856 # This policy takes
16857 # effect at the PathMatcher level and applies only when no
16858 # 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
16859 # in defaultCustomErrorResponsePolicy, then a policy defined for
16860 # the error code in UrlMap.defaultCustomErrorResponsePolicy
16861 # takes effect.
16862 #
16863 # For example, consider a UrlMap with the following
16864 # configuration:
16865 #
16866 #
16867 # - UrlMap.defaultCustomErrorResponsePolicy is configured
16868 # with policies for 5xx and 4xx errors
16869 # - A RouteRule for /coming_soon/ is configured for the
16870 # error code 404.
16871 #
16872 # 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
16873 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
16874 # the policy in RouteRule.customErrorResponsePolicy takes
16875 # effect. If any of the requests in this example encounter a 500
16876 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
16877 #
16878 # When
16879 # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
16880 # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
16881 # a retry, if load balancer is successful in reaching the
16882 # service, the defaultCustomErrorResponsePolicy is ignored and
16883 # the response from the service is returned to the client.
16884 #
16885 # defaultCustomErrorResponsePolicy is supported only for
16886 # global external Application Load Balancers.
16887 # backend service or backend bucket responds with an error.
16888 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
16889 #
16890 # In a given policy, if you specify rules for both a range of error codes
16891 # as well as rules for specific error codes then rules with specific error
16892 # codes have a higher priority. For example, assume that you configure a rule
16893 # for 401 (Un-authorized) code, and another for all 4 series
16894 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
16895 # However if the backend service returns a 403, the rule for4xx takes effect.
16896 { # Specifies the mapping between the response code that will be returned along
16897 # with the custom error content and the response code returned by the backend
16898 # service.
16899 &quot;matchResponseCodes&quot;: [ # Valid values include:
16900 #
16901 #
16902 # - A number between 400 and 599: For example
16903 # 401 or 503, in which case the load balancer
16904 # applies the policy if the error code exactly matches this value.
16905 # - 5xx: Load Balancer will apply the policy if the
16906 # backend service responds with any response code in the range of
16907 # 500 to 599.
16908 # - 4xx: Load
16909 # Balancer will apply the policy if the backend service responds with any
16910 # response code in the range of 400 to
16911 # 499.
16912 #
16913 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
16914 &quot;A String&quot;,
16915 ],
16916 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
16917 # error content. If overrideResponseCode is not supplied, the
16918 # same response code returned by the original backend bucket or backend
16919 # service is returned to the client.
16920 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
16921 #
16922 # path must start
16923 # with a leading slash. path cannot have trailing slashes.
16924 #
16925 # If the file is not available in backendBucket or the
16926 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
16927 #
16928 # The value must
16929 # be from 1 to 1024 characters
16930 },
16931 ],
16932 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
16933 # contains the custom error content. Examples are:
16934 #
16935 #
16936 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
16937 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
16938 # - global/backendBuckets/myBackendBucket
16939 #
16940 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
16941 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
16942 #
16943 # If load balancer cannot reach
16944 # the backendBucket, a simple Not Found Error will
16945 # be returned, with the original response code (oroverrideResponseCode if configured).
16946 #
16947 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
16948 },
16949 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
16950 # pathRules or routeRules match. The load balancer
16951 # performs advanced routing actions, such as URL rewrites and
16952 # header transformations, before forwarding the request to the
16953 # selected backend.
16954 #
16955 #
16956 # Only one of defaultUrlRedirect, defaultService
16957 # or defaultRouteAction.weightedBackendService can be set.
16958 #
16959 #
16960 # URL maps for classic Application Load Balancers only support
16961 # the urlRewrite action within a path matcher&#x27;sdefaultRouteAction.
16962 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
16963 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
16964 # property must be specified. This policy cannot be specified if any target
16965 # backend has Identity-Aware Proxy enabled.
16966 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
16967 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
16968 # header names can be specified. The cache is bypassed for all `cacheMode`
16969 # values.
16970 &quot;A String&quot;,
16971 ],
16972 &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
16973 # on the backend type: for Backend Services, the complete request URI is
16974 # used; for Backend Buckets, the request URI is used without the protocol or
16975 # host, and only query parameters known to Cloud Storage are included.
16976 # Policy defined on Route Action.
16977 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
16978 # parameters will be included. Either specify `excludedQueryParameters`
16979 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
16980 # encoded and not treated as delimiters.
16981 #
16982 # Note: This field applies to routes that use backend services. Attempting
16983 # to set it on a route that points exclusively to Backend Buckets will
16984 # result in a configuration error. For routes that point to a Backend
16985 # Bucket, use `includedQueryParameters` to define which parameters should
16986 # be part of the cache key.
16987 &quot;A String&quot;,
16988 ],
16989 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
16990 #
16991 # Note: This setting is only applicable to routes that use a Backend
16992 # Service. It does not affect requests served by a Backend Bucket, as the
16993 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
16994 # it on a route that points exclusively to Backend Buckets will result in a
16995 # configuration error.
16996 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
16997 #
16998 # Note: This setting is only applicable to routes that use a Backend
16999 # Service. It does not affect requests served by a Backend Bucket, as the
17000 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
17001 # set on a route that points exclusively to Backend Buckets will result in
17002 # a configuration error.
17003 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
17004 # `includedQueryParameters` and `excludedQueryParameters`. If neither
17005 # is set, the entire query string will be included. If false, the query
17006 # string will be excluded from the cache key entirely.
17007 #
17008 # Note: This field applies to routes that use backend services. Attempting
17009 # to set it on a route that points exclusively to Backend Buckets will
17010 # result in a configuration error. For routes that point to a Backend
17011 # Bucket, use `includedQueryParameters` to define which parameters should
17012 # be part of the cache key.
17013 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
17014 # The name=value pair will be used in the cache key Cloud CDN generates.
17015 #
17016 # Note: This setting is only applicable to routes that use a Backend
17017 # Service. It does not affect requests served by a Backend Bucket.
17018 # Attempting to set it on a route that points exclusively to Backend
17019 # Buckets will result in a configuration error. Up to 5 cookie names can be
17020 # specified.
17021 &quot;A String&quot;,
17022 ],
17023 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
17024 &quot;A String&quot;,
17025 ],
17026 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
17027 # parameters will be excluded. Either specify `includedQueryParameters`
17028 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
17029 # encoded and not treated as delimiters.
17030 &quot;A String&quot;,
17031 ],
17032 },
17033 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
17034 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
17035 &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
17036 # content. This is used to clamp the max-age (or Expires) value sent to the
17037 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
17038 # is used for the response max-age directive, along with a &quot;public&quot;
17039 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
17040 # clamps the max-age from the origin (if specified), or else sets the
17041 # response max-age directive to the lesser of the `clientTtl` and
17042 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
17043 # present. The maximum allowed value is 31,622,400s (1 year). If not
17044 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
17045 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
17046 # `USE_ORIGIN_HEADERS`.
17047 # as a count of seconds and fractions of seconds at nanosecond
17048 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17049 # or &quot;month&quot;. Range is approximately 10,000 years.
17050 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17051 # Durations less than one second are represented with a 0
17052 # `seconds` field and a positive `nanos` field. Must be from 0
17053 # to 999,999,999 inclusive.
17054 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17055 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17056 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17057 },
17058 &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
17059 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
17060 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
17061 # greater than that of `maxTtl`. When the `cacheMode` is set to
17062 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
17063 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
17064 # accessed objects may be evicted from the cache before the defined TTL. If
17065 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
17066 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
17067 # `USE_ORIGIN_HEADERS`.
17068 # as a count of seconds and fractions of seconds at nanosecond
17069 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17070 # or &quot;month&quot;. Range is approximately 10,000 years.
17071 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17072 # Durations less than one second are represented with a 0
17073 # `seconds` field and a positive `nanos` field. Must be from 0
17074 # to 999,999,999 inclusive.
17075 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17076 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17077 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17078 },
17079 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
17080 # attempt to set a max-age or s-maxage higher than this, or an Expires header
17081 # more than `maxTtl` seconds in the future will be capped at the value of
17082 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
17083 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
17084 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
17085 # Infrequently accessed objects may be evicted from the cache before the
17086 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
17087 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
17088 # mode.
17089 # as a count of seconds and fractions of seconds at nanosecond
17090 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17091 # or &quot;month&quot;. Range is approximately 10,000 years.
17092 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17093 # Durations less than one second are represented with a 0
17094 # `seconds` field and a positive `nanos` field. Must be from 0
17095 # to 999,999,999 inclusive.
17096 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17097 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17098 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17099 },
17100 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
17101 # to apply fine-grained caching for common errors or redirects.
17102 # This can reduce the load on your origin and improve end-user
17103 # experience by reducing response latency.
17104 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
17105 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
17106 # the specified response code that lack any Cache-Control, Expires, or
17107 # Pragma: no-cache directives. When the `cacheMode` is set to
17108 # `FORCE_CACHE_ALL`, negative caching applies to all responses
17109 # with the specified response code, and overrides any caching headers. By
17110 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
17111 #
17112 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
17113 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
17114 # * 405 (Method Not Found), 501 (Not Implemented): 60s
17115 #
17116 # These defaults can be overridden in `negativeCachingPolicy`.
17117 # If not specified, Cloud CDN applies negative caching by default.
17118 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
17119 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
17120 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
17121 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
17122 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
17123 # all response codes that you wish to cache. Cloud CDN will not apply any
17124 # default negative caching when a policy exists.
17125 { # Specify CDN TTLs for response error codes.
17126 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
17127 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
17128 # specified as values, and you cannot specify a status code more than
17129 # once.
17130 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
17131 # corresponding status code.
17132 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
17133 # objects may be evicted from the cache before the defined TTL.
17134 # as a count of seconds and fractions of seconds at nanosecond
17135 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17136 # or &quot;month&quot;. Range is approximately 10,000 years.
17137 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17138 # Durations less than one second are represented with a 0
17139 # `seconds` field and a positive `nanos` field. Must be from 0
17140 # to 999,999,999 inclusive.
17141 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17142 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17143 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17144 },
17145 },
17146 ],
17147 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
17148 # requests into a small number of requests to the origin. If not specified,
17149 # Cloud CDN applies request coalescing by default.
17150 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
17151 # content with the origin, or when an error is encountered when refreshing
17152 # the cache.
17153 # This setting defines the default &quot;max-stale&quot; duration for any cached
17154 # responses that do not specify a max-stale directive. Stale responses that
17155 # exceed the TTL configured here will not be served. The default limit
17156 # (max-stale) is 86400s (1 day), which will allow stale content to be
17157 # served up to this limit beyond the max-age (or s-maxage) of a cached
17158 # response.
17159 # The maximum allowed value is 604800 (1 week).
17160 # Set this to zero (0) to disable serve-while-stale.
17161 # as a count of seconds and fractions of seconds at nanosecond
17162 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17163 # or &quot;month&quot;. Range is approximately 10,000 years.
17164 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17165 # Durations less than one second are represented with a 0
17166 # `seconds` field and a positive `nanos` field. Must be from 0
17167 # to 999,999,999 inclusive.
17168 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17169 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17170 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17171 },
17172 },
17173 &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
17174 # information about the W3C recommendation for cross-origin resource sharing
17175 # (CORS), see Fetch API Living
17176 # Standard.
17177 #
17178 # Not supported when the URL map is bound to a target gRPC proxy.
17179 # information about the W3C recommendation for cross-origin resource sharing
17180 # (CORS), see Fetch API Living
17181 # Standard.
17182 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
17183 # indicates that
17184 # the actual request can include user credentials. This field translates to
17185 # the Access-Control-Allow-Credentials header.
17186 #
17187 # Default is false.
17188 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
17189 # header.
17190 &quot;A String&quot;,
17191 ],
17192 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
17193 # header.
17194 &quot;A String&quot;,
17195 ],
17196 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
17197 # more information, see regular expression syntax.
17198 #
17199 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
17200 #
17201 # Regular expressions can only be used when the loadBalancingScheme is
17202 # set to INTERNAL_SELF_MANAGED.
17203 &quot;A String&quot;,
17204 ],
17205 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
17206 #
17207 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
17208 &quot;A String&quot;,
17209 ],
17210 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
17211 # The default value is false, which indicates that the CORS
17212 # policy is in effect.
17213 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
17214 # header.
17215 &quot;A String&quot;,
17216 ],
17217 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
17218 # seconds. This field translates to the Access-Control-Max-Age
17219 # header.
17220 },
17221 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
17222 # the resiliency of clients to backend service failure. As part of fault
17223 # injection, when clients send requests to a backend service, delays can be
17224 # introduced by a load balancer on a percentage of requests before sending
17225 # those requests to the backend service. Similarly requests from clients can
17226 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
17227 # that are configured with a fault_injection_policy if:
17228 # 1. The traffic is generated by fault injection AND
17229 # 2. The fault injection is not a delay fault injection.
17230 # Fault injection is not supported with the classic Application Load Balancer
17231 # . To see which load balancers support fault injection,
17232 # see Load
17233 # balancing: Routing and traffic management features.
17234 # the resiliency of clients to backend service failure. As part of fault
17235 # injection, when clients send requests to a backend service, delays can be
17236 # introduced by the load balancer on a percentage of requests before sending
17237 # those request to the backend service. Similarly requests from clients can be
17238 # aborted by the load balancer for a percentage of requests.
17239 &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
17240 # injection.
17241 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
17242 #
17243 # The value must be from 200 to 599 inclusive.
17244 #
17245 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
17246 # according to this
17247 # mapping table. HTTP status 200 is mapped to gRPC status
17248 # UNKNOWN. Injecting an OK status is currently not supported by
17249 # Traffic Director.
17250 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
17251 # that is aborted as part of fault injection.
17252 #
17253 # The value must be from 0.0 to 100.0 inclusive.
17254 },
17255 &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
17256 # injection, before being sent to a backend service.
17257 # request to the backend service as part of fault injection.
17258 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
17259 # as a count of seconds and fractions of seconds at nanosecond
17260 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17261 # or &quot;month&quot;. Range is approximately 10,000 years.
17262 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17263 # Durations less than one second are represented with a 0
17264 # `seconds` field and a positive `nanos` field. Must be from 0
17265 # to 999,999,999 inclusive.
17266 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17267 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17268 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17269 },
17270 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
17271 # which a delay is introduced as part of fault injection.
17272 #
17273 # The value must be from 0.0 to 100.0 inclusive.
17274 },
17275 },
17276 &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
17277 # Global EXTERNAL_MANAGED load balancer schemes.
17278 # Either Cloud CDN must be enabled on the backend service or backend bucket
17279 # serving the route, or cache policy must be configured on the same route
17280 # dynamically processes and delivers images from the network edge.
17281 # Image Optimization is only available for Global External Application Load
17282 # Balancers.
17283 # Either Cloud CDN must be enabled on the backend service or backend bucket
17284 # serving the route, or cache policy must be configured on the same route.
17285 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
17286 },
17287 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
17288 # Unlike the timeout field where the timeout duration starts
17289 # from the time the request has been fully processed (known as*end-of-stream*),
17290 # the duration in this field is computed from the beginning of the stream
17291 # until the response has been processed, including all retries. A
17292 # stream that does not complete in this duration is closed.
17293 #
17294 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
17295 # with the route.
17296 #
17297 # This field is only allowed if the Url map is used with backend services
17298 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
17299 # as a count of seconds and fractions of seconds at nanosecond
17300 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17301 # or &quot;month&quot;. Range is approximately 10,000 years.
17302 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17303 # Durations less than one second are represented with a 0
17304 # `seconds` field and a positive `nanos` field. Must be from 0
17305 # to 999,999,999 inclusive.
17306 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17307 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17308 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17309 },
17310 &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
17311 # are shadowed to a separate mirrored backend service. The load balancer does
17312 # not wait for responses from the shadow service. Before sending traffic
17313 # to the shadow service, the host / authority header is suffixed with-shadow.
17314 #
17315 # Not supported when the URL map is bound to a target gRPC proxy that
17316 # has the validateForProxyless field set to true.
17317 # are shadowed to a separate mirrored backend service. The load balancer
17318 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
17319 # to the shadow service, the host or authority header is suffixed with-shadow.
17320 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
17321 # mirrored to.
17322 #
17323 # The backend service configured for a mirroring
17324 # policy must reference backends that are of the same type as the original
17325 # backend service matched in the URL map.
17326 #
17327 # Serverless NEG backends are not currently supported as a mirrored
17328 # backend service.
17329 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
17330 },
17331 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
17332 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
17333 # If not specified, defaults to 1.
17334 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
17335 #
17336 # If not specified, will use the timeout set in theHttpRouteAction field.
17337 # If timeout in the HttpRouteAction field is not set, this field
17338 # uses the largest timeout
17339 # among all backend services associated with the route.
17340 #
17341 # Not supported when the URL map is bound to a target gRPC proxy that
17342 # has the validateForProxyless field set to true.
17343 # as a count of seconds and fractions of seconds at nanosecond
17344 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17345 # or &quot;month&quot;. Range is approximately 10,000 years.
17346 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17347 # Durations less than one second are represented with a 0
17348 # `seconds` field and a positive `nanos` field. Must be from 0
17349 # to 999,999,999 inclusive.
17350 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17351 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17352 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17353 },
17354 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
17355 # values are:
17356 #
17357 # - 5xx: retry is attempted if the instance or endpoint
17358 # responds with any 5xx response code, or if the instance or
17359 # endpoint does not respond at all. For example, disconnects, reset, read
17360 # timeout, connection failure, and refused streams.
17361 # - gateway-error: Similar to 5xx, but only
17362 # applies to response codes 502, 503 or504.
17363 # - connect-failure: a retry is attempted on failures
17364 # connecting to the instance or endpoint. For example, connection
17365 # timeouts.
17366 # - retriable-4xx: a retry is attempted if the instance
17367 # or endpoint responds with a 4xx response code.
17368 # The only error that you can retry is error code 409.
17369 # - refused-stream: a retry is attempted if the instance
17370 # or endpoint resets the stream with a REFUSED_STREAM error
17371 # code. This reset type indicates that it is safe to retry.
17372 # - cancelled: a retry is attempted if the gRPC status
17373 # code in the response header is set to cancelled.
17374 # - deadline-exceeded: a retry is attempted if the gRPC
17375 # status code in the response header is set todeadline-exceeded.
17376 # - internal: a retry is attempted if the gRPC
17377 # status code in the response header is set tointernal.
17378 # - resource-exhausted: a retry is attempted if the gRPC
17379 # status code in the response header is set toresource-exhausted.
17380 # - unavailable: a retry is attempted if the gRPC
17381 # status code in the response header is set tounavailable.
17382 #
17383 # Only the following codes are supported when the URL map is bound to
17384 # target gRPC proxy that has validateForProxyless field set to true.
17385 #
17386 # - cancelled
17387 # - deadline-exceeded
17388 # - internal
17389 # - resource-exhausted
17390 # - unavailable
17391 &quot;A String&quot;,
17392 ],
17393 },
17394 &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
17395 # time the request has been fully processed (known as *end-of-stream*)
17396 # up until the response has been processed. Timeout includes
17397 # all retries.
17398 #
17399 # If not specified, this field uses the largest timeout among all backend
17400 # services associated with the route.
17401 #
17402 # Not supported when the URL map is bound to a target gRPC proxy that
17403 # has validateForProxyless field set to true.
17404 # as a count of seconds and fractions of seconds at nanosecond
17405 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17406 # or &quot;month&quot;. Range is approximately 10,000 years.
17407 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17408 # Durations less than one second are represented with a 0
17409 # `seconds` field and a positive `nanos` field. Must be from 0
17410 # to 999,999,999 inclusive.
17411 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17412 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17413 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17414 },
17415 &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
17416 # to the matched service.
17417 #
17418 # urlRewrite is the only action supported in UrlMaps
17419 # for classic Application Load Balancers.
17420 #
17421 # Not supported when the URL map is bound to a target gRPC proxy that
17422 # has the validateForProxyless field set to true.
17423 # backend service.
17424 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
17425 # host header is replaced with contents of hostRewrite.
17426 #
17427 # The value must be from 1 to 255 characters.
17428 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
17429 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
17430 #
17431 # The value must be from 1 to 1024 characters.
17432 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
17433 # header) using the HTTP template syntax.
17434 #
17435 # A corresponding
17436 # path_template_match must be specified. Any template variables must exist in
17437 # the path_template_match field.
17438 #
17439 #
17440 # - -At least one variable must be specified in the path_template_match
17441 # field
17442 # - You can omit variables from the rewritten URL
17443 # - The * and ** operators cannot be matched
17444 # unless they have a corresponding variable name - e.g.
17445 # {format=*} or {var=**}.
17446 #
17447 # For example, a path_template_match of /static/{format=**}
17448 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
17449 # rewrite, so that /{country}/{format}/{suffix=**} can be
17450 # rewritten as /content/{format}/{country}/{suffix}.
17451 #
17452 # At least
17453 # one non-empty routeRules[].matchRules[].path_template_match is
17454 # required.
17455 #
17456 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
17457 },
17458 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
17459 # occurs. The weights determine the fraction of traffic that flows to
17460 # their corresponding backend service. If all traffic needs to
17461 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
17462 #
17463 # After a backend service is identified and before forwarding
17464 # the request to
17465 # the backend service, advanced routing actions such as URL rewrites and
17466 # header transformations are applied depending on additional settings
17467 # specified in this HttpRouteAction.
17468 { # In contrast to a single BackendService in
17469 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
17470 # multiple backend services. The volume of traffic for each
17471 # backend service is proportional to the weight specified
17472 # in each WeightedBackendService
17473 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
17474 # resource. Before
17475 # forwarding the request to backendService, the load balancer
17476 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
17477 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
17478 # effect for the selected backendService.
17479 #
17480 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
17481 #
17482 # headerAction is not supported for load balancers that have
17483 # their loadBalancingScheme set to EXTERNAL.
17484 #
17485 # Not supported when the URL map is bound to a target gRPC proxy that
17486 # has validateForProxyless field set to true.
17487 # the request is passed along to the selected backendService.
17488 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
17489 { # Specification determining how headers are added to requests or responses.
17490 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
17491 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
17492 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
17493 # that already
17494 # exist for the header. If true, headerValue is set for the
17495 # header, discarding any values that were set for that header.
17496 #
17497 # The default value is true,
17498 # unless a variable is present in headerValue,
17499 # in which case the default value is false.
17500 # .
17501 },
17502 ],
17503 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
17504 # request before forwarding the request to the backendService.
17505 &quot;A String&quot;,
17506 ],
17507 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
17508 # client.
17509 { # Specification determining how headers are added to requests or responses.
17510 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
17511 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
17512 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
17513 # that already
17514 # exist for the header. If true, headerValue is set for the
17515 # header, discarding any values that were set for that header.
17516 #
17517 # The default value is true,
17518 # unless a variable is present in headerValue,
17519 # in which case the default value is false.
17520 # .
17521 },
17522 ],
17523 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
17524 # response before sending the response back to the client.
17525 &quot;A String&quot;,
17526 ],
17527 },
17528 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
17529 # computed asweight / (sum of all weightedBackendService weights in routeAction).
17530 #
17531 # The selection of a backend service is determined only for new traffic.
17532 # Once a user&#x27;s request has been directed to a backend service,
17533 # subsequent requests are sent to the same backend service as
17534 # determined by the backend service&#x27;s session affinity policy.
17535 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
17536 # splitting. If you do, the weighted traffic splitting configuration takes
17537 # precedence.
17538 #
17539 # The value must be from 0 to 1000.
17540 },
17541 ],
17542 },
17543 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource. This
17544 # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
17545 # matched. For example, the
17546 # following are all valid URLs to a BackendService resource:
17547 #
17548 #
17549 # - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
17550 # - compute/v1/projects/project/global/backendServices/backendService
17551 # - global/backendServices/backendService
17552 #
17553 #
17554 # If defaultRouteAction is also specified, advanced
17555 # routing actions, such as URL rewrites, take effect before sending the
17556 # request to the backend.
17557 #
17558 #
17559 # Only one of defaultUrlRedirect, defaultService
17560 # or defaultRouteAction.weightedBackendService can be set.
17561 #
17562 #
17563 # Authorization requires one or more of the following Google IAM permissions on the
17564 # specified resource default_service:
17565 #
17566 #
17567 # - compute.backendBuckets.use
17568 # - compute.backendServices.use
17569 &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
17570 # by defaultUrlRedirect.
17571 #
17572 #
17573 # Only one of defaultUrlRedirect, defaultService
17574 # or defaultRouteAction.weightedBackendService can be set.
17575 #
17576 #
17577 # Not supported when the URL map is bound to a target gRPC proxy.
17578 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
17579 # was supplied in the request.
17580 #
17581 # The value must be from 1 to 255
17582 # characters.
17583 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
17584 # set to HTTPS.
17585 # If set to false, the URL scheme of the redirected request
17586 # remains the same as that of the request.
17587 #
17588 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
17589 #
17590 # The default is set to false.
17591 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
17592 # that was supplied in the request.
17593 #
17594 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
17595 # supplied, the path of the original request is used for the redirect.
17596 #
17597 # The value must be from 1 to 1024 characters.
17598 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
17599 # the HttpRouteRuleMatch, retaining the remaining portion
17600 # of the URL before redirecting the request.
17601 #
17602 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
17603 # supplied, the path of the original request is used for the redirect.
17604 #
17605 # The value must be from 1 to 1024 characters.
17606 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
17607 #
17608 # Supported values are:
17609 #
17610 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
17611 # to 301.
17612 # - FOUND, which corresponds to 302.
17613 # - SEE_OTHER which corresponds to 303.
17614 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
17615 # method is retained.
17616 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
17617 # method is retained.
17618 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
17619 # URL is
17620 # removed before redirecting the request. If set to false, the
17621 # query portion of the original URL is retained.
17622 #
17623 # The default is set to false.
17624 },
17625 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
17626 # create the resource.
17627 &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
17628 # for the selected backend service.
17629 #
17630 # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
17631 #
17632 # HeaderAction is not supported for load balancers
17633 # that have
17634 # their loadBalancingScheme set to EXTERNAL.
17635 #
17636 # Not supported when the URL map is bound to a target gRPC proxy that
17637 # has validateForProxyless field set to true.
17638 # the request is passed along to the selected backendService.
17639 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
17640 { # Specification determining how headers are added to requests or responses.
17641 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
17642 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
17643 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
17644 # that already
17645 # exist for the header. If true, headerValue is set for the
17646 # header, discarding any values that were set for that header.
17647 #
17648 # The default value is true,
17649 # unless a variable is present in headerValue,
17650 # in which case the default value is false.
17651 # .
17652 },
17653 ],
17654 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
17655 # request before forwarding the request to the backendService.
17656 &quot;A String&quot;,
17657 ],
17658 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
17659 # client.
17660 { # Specification determining how headers are added to requests or responses.
17661 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
17662 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
17663 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
17664 # that already
17665 # exist for the header. If true, headerValue is set for the
17666 # header, discarding any values that were set for that header.
17667 #
17668 # The default value is true,
17669 # unless a variable is present in headerValue,
17670 # in which case the default value is false.
17671 # .
17672 },
17673 ],
17674 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
17675 # response before sending the response back to the client.
17676 &quot;A String&quot;,
17677 ],
17678 },
17679 &quot;name&quot;: &quot;A String&quot;, # The name to which this PathMatcher is referred by theHostRule.
17680 &quot;pathRules&quot;: [ # The list of path rules. Use this list instead of routeRules
17681 # when routing based on simple path matching is all that&#x27;s required. A path
17682 # rule can only include a wildcard character (*) after a
17683 # forward slash character (&quot;/&quot;).
17684 #
17685 # The order by which path rules are specified does not matter.
17686 # Matches are always done on the longest-path-first basis.
17687 #
17688 # For example: a pathRule with a path /a/b/c/* will match
17689 # before /a/b/* irrespective of the order in which those paths appear in this
17690 # list.
17691 #
17692 # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
17693 { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
17694 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
17695 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
17696 #
17697 # If a policy for an
17698 # error code is not configured for the PathRule, a policy for
17699 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
17700 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
17701 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
17702 # effect.
17703 #
17704 # For example, consider a UrlMap with the following configuration:
17705 #
17706 #
17707 # - UrlMap.defaultCustomErrorResponsePolicy are configured
17708 # with policies for 5xx and 4xx errors
17709 # - A PathRule for /coming_soon/ is configured for the error
17710 # code 404.
17711 #
17712 # 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
17713 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
17714 # the policy in PathRule.customErrorResponsePolicy takes
17715 # effect. If any of the requests in this example encounter a 500
17716 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
17717 #
17718 # customErrorResponsePolicy is supported only for
17719 # global external Application Load Balancers.
17720 # backend service or backend bucket responds with an error.
17721 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
17722 #
17723 # In a given policy, if you specify rules for both a range of error codes
17724 # as well as rules for specific error codes then rules with specific error
17725 # codes have a higher priority. For example, assume that you configure a rule
17726 # for 401 (Un-authorized) code, and another for all 4 series
17727 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
17728 # However if the backend service returns a 403, the rule for4xx takes effect.
17729 { # Specifies the mapping between the response code that will be returned along
17730 # with the custom error content and the response code returned by the backend
17731 # service.
17732 &quot;matchResponseCodes&quot;: [ # Valid values include:
17733 #
17734 #
17735 # - A number between 400 and 599: For example
17736 # 401 or 503, in which case the load balancer
17737 # applies the policy if the error code exactly matches this value.
17738 # - 5xx: Load Balancer will apply the policy if the
17739 # backend service responds with any response code in the range of
17740 # 500 to 599.
17741 # - 4xx: Load
17742 # Balancer will apply the policy if the backend service responds with any
17743 # response code in the range of 400 to
17744 # 499.
17745 #
17746 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
17747 &quot;A String&quot;,
17748 ],
17749 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
17750 # error content. If overrideResponseCode is not supplied, the
17751 # same response code returned by the original backend bucket or backend
17752 # service is returned to the client.
17753 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
17754 #
17755 # path must start
17756 # with a leading slash. path cannot have trailing slashes.
17757 #
17758 # If the file is not available in backendBucket or the
17759 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
17760 #
17761 # The value must
17762 # be from 1 to 1024 characters
17763 },
17764 ],
17765 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
17766 # contains the custom error content. Examples are:
17767 #
17768 #
17769 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
17770 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
17771 # - global/backendBuckets/myBackendBucket
17772 #
17773 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
17774 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
17775 #
17776 # If load balancer cannot reach
17777 # the backendBucket, a simple Not Found Error will
17778 # be returned, with the original response code (oroverrideResponseCode if configured).
17779 #
17780 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
17781 },
17782 &quot;paths&quot;: [ # The list of path patterns to match. Each must start with /
17783 # and the only place a * is allowed is at the end following
17784 # a /. The string fed to the path matcher does not include
17785 # any text after the first ? or #, and
17786 # those chars are not allowed here.
17787 &quot;A String&quot;,
17788 ],
17789 &quot;routeAction&quot;: { # In response to a matching path, the load balancer
17790 # performs advanced routing actions, such as URL rewrites and header
17791 # transformations, before forwarding the request to the selected
17792 # backend.
17793 #
17794 #
17795 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
17796 #
17797 #
17798 # URL maps for classic Application Load Balancers only support
17799 # the urlRewrite action within a path rule&#x27;srouteAction.
17800 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
17801 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
17802 # property must be specified. This policy cannot be specified if any target
17803 # backend has Identity-Aware Proxy enabled.
17804 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
17805 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
17806 # header names can be specified. The cache is bypassed for all `cacheMode`
17807 # values.
17808 &quot;A String&quot;,
17809 ],
17810 &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
17811 # on the backend type: for Backend Services, the complete request URI is
17812 # used; for Backend Buckets, the request URI is used without the protocol or
17813 # host, and only query parameters known to Cloud Storage are included.
17814 # Policy defined on Route Action.
17815 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
17816 # parameters will be included. Either specify `excludedQueryParameters`
17817 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
17818 # encoded and not treated as delimiters.
17819 #
17820 # Note: This field applies to routes that use backend services. Attempting
17821 # to set it on a route that points exclusively to Backend Buckets will
17822 # result in a configuration error. For routes that point to a Backend
17823 # Bucket, use `includedQueryParameters` to define which parameters should
17824 # be part of the cache key.
17825 &quot;A String&quot;,
17826 ],
17827 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
17828 #
17829 # Note: This setting is only applicable to routes that use a Backend
17830 # Service. It does not affect requests served by a Backend Bucket, as the
17831 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
17832 # it on a route that points exclusively to Backend Buckets will result in a
17833 # configuration error.
17834 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
17835 #
17836 # Note: This setting is only applicable to routes that use a Backend
17837 # Service. It does not affect requests served by a Backend Bucket, as the
17838 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
17839 # set on a route that points exclusively to Backend Buckets will result in
17840 # a configuration error.
17841 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
17842 # `includedQueryParameters` and `excludedQueryParameters`. If neither
17843 # is set, the entire query string will be included. If false, the query
17844 # string will be excluded from the cache key entirely.
17845 #
17846 # Note: This field applies to routes that use backend services. Attempting
17847 # to set it on a route that points exclusively to Backend Buckets will
17848 # result in a configuration error. For routes that point to a Backend
17849 # Bucket, use `includedQueryParameters` to define which parameters should
17850 # be part of the cache key.
17851 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
17852 # The name=value pair will be used in the cache key Cloud CDN generates.
17853 #
17854 # Note: This setting is only applicable to routes that use a Backend
17855 # Service. It does not affect requests served by a Backend Bucket.
17856 # Attempting to set it on a route that points exclusively to Backend
17857 # Buckets will result in a configuration error. Up to 5 cookie names can be
17858 # specified.
17859 &quot;A String&quot;,
17860 ],
17861 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
17862 &quot;A String&quot;,
17863 ],
17864 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
17865 # parameters will be excluded. Either specify `includedQueryParameters`
17866 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
17867 # encoded and not treated as delimiters.
17868 &quot;A String&quot;,
17869 ],
17870 },
17871 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
17872 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
17873 &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
17874 # content. This is used to clamp the max-age (or Expires) value sent to the
17875 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
17876 # is used for the response max-age directive, along with a &quot;public&quot;
17877 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
17878 # clamps the max-age from the origin (if specified), or else sets the
17879 # response max-age directive to the lesser of the `clientTtl` and
17880 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
17881 # present. The maximum allowed value is 31,622,400s (1 year). If not
17882 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
17883 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
17884 # `USE_ORIGIN_HEADERS`.
17885 # as a count of seconds and fractions of seconds at nanosecond
17886 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17887 # or &quot;month&quot;. Range is approximately 10,000 years.
17888 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17889 # Durations less than one second are represented with a 0
17890 # `seconds` field and a positive `nanos` field. Must be from 0
17891 # to 999,999,999 inclusive.
17892 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17893 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17894 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17895 },
17896 &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
17897 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
17898 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
17899 # greater than that of `maxTtl`. When the `cacheMode` is set to
17900 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
17901 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
17902 # accessed objects may be evicted from the cache before the defined TTL. If
17903 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
17904 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
17905 # `USE_ORIGIN_HEADERS`.
17906 # as a count of seconds and fractions of seconds at nanosecond
17907 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17908 # or &quot;month&quot;. Range is approximately 10,000 years.
17909 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17910 # Durations less than one second are represented with a 0
17911 # `seconds` field and a positive `nanos` field. Must be from 0
17912 # to 999,999,999 inclusive.
17913 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17914 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17915 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17916 },
17917 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
17918 # attempt to set a max-age or s-maxage higher than this, or an Expires header
17919 # more than `maxTtl` seconds in the future will be capped at the value of
17920 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
17921 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
17922 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
17923 # Infrequently accessed objects may be evicted from the cache before the
17924 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
17925 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
17926 # mode.
17927 # as a count of seconds and fractions of seconds at nanosecond
17928 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17929 # or &quot;month&quot;. Range is approximately 10,000 years.
17930 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17931 # Durations less than one second are represented with a 0
17932 # `seconds` field and a positive `nanos` field. Must be from 0
17933 # to 999,999,999 inclusive.
17934 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17935 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17936 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17937 },
17938 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
17939 # to apply fine-grained caching for common errors or redirects.
17940 # This can reduce the load on your origin and improve end-user
17941 # experience by reducing response latency.
17942 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
17943 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
17944 # the specified response code that lack any Cache-Control, Expires, or
17945 # Pragma: no-cache directives. When the `cacheMode` is set to
17946 # `FORCE_CACHE_ALL`, negative caching applies to all responses
17947 # with the specified response code, and overrides any caching headers. By
17948 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
17949 #
17950 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
17951 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
17952 # * 405 (Method Not Found), 501 (Not Implemented): 60s
17953 #
17954 # These defaults can be overridden in `negativeCachingPolicy`.
17955 # If not specified, Cloud CDN applies negative caching by default.
17956 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
17957 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
17958 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
17959 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
17960 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
17961 # all response codes that you wish to cache. Cloud CDN will not apply any
17962 # default negative caching when a policy exists.
17963 { # Specify CDN TTLs for response error codes.
17964 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
17965 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
17966 # specified as values, and you cannot specify a status code more than
17967 # once.
17968 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
17969 # corresponding status code.
17970 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
17971 # objects may be evicted from the cache before the defined TTL.
17972 # as a count of seconds and fractions of seconds at nanosecond
17973 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17974 # or &quot;month&quot;. Range is approximately 10,000 years.
17975 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17976 # Durations less than one second are represented with a 0
17977 # `seconds` field and a positive `nanos` field. Must be from 0
17978 # to 999,999,999 inclusive.
17979 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17980 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17981 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17982 },
17983 },
17984 ],
17985 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
17986 # requests into a small number of requests to the origin. If not specified,
17987 # Cloud CDN applies request coalescing by default.
17988 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
17989 # content with the origin, or when an error is encountered when refreshing
17990 # the cache.
17991 # This setting defines the default &quot;max-stale&quot; duration for any cached
17992 # responses that do not specify a max-stale directive. Stale responses that
17993 # exceed the TTL configured here will not be served. The default limit
17994 # (max-stale) is 86400s (1 day), which will allow stale content to be
17995 # served up to this limit beyond the max-age (or s-maxage) of a cached
17996 # response.
17997 # The maximum allowed value is 604800 (1 week).
17998 # Set this to zero (0) to disable serve-while-stale.
17999 # as a count of seconds and fractions of seconds at nanosecond
18000 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18001 # or &quot;month&quot;. Range is approximately 10,000 years.
18002 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18003 # Durations less than one second are represented with a 0
18004 # `seconds` field and a positive `nanos` field. Must be from 0
18005 # to 999,999,999 inclusive.
18006 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18007 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18008 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18009 },
18010 },
18011 &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
18012 # information about the W3C recommendation for cross-origin resource sharing
18013 # (CORS), see Fetch API Living
18014 # Standard.
18015 #
18016 # Not supported when the URL map is bound to a target gRPC proxy.
18017 # information about the W3C recommendation for cross-origin resource sharing
18018 # (CORS), see Fetch API Living
18019 # Standard.
18020 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
18021 # indicates that
18022 # the actual request can include user credentials. This field translates to
18023 # the Access-Control-Allow-Credentials header.
18024 #
18025 # Default is false.
18026 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
18027 # header.
18028 &quot;A String&quot;,
18029 ],
18030 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
18031 # header.
18032 &quot;A String&quot;,
18033 ],
18034 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
18035 # more information, see regular expression syntax.
18036 #
18037 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
18038 #
18039 # Regular expressions can only be used when the loadBalancingScheme is
18040 # set to INTERNAL_SELF_MANAGED.
18041 &quot;A String&quot;,
18042 ],
18043 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
18044 #
18045 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
18046 &quot;A String&quot;,
18047 ],
18048 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
18049 # The default value is false, which indicates that the CORS
18050 # policy is in effect.
18051 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
18052 # header.
18053 &quot;A String&quot;,
18054 ],
18055 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
18056 # seconds. This field translates to the Access-Control-Max-Age
18057 # header.
18058 },
18059 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
18060 # the resiliency of clients to backend service failure. As part of fault
18061 # injection, when clients send requests to a backend service, delays can be
18062 # introduced by a load balancer on a percentage of requests before sending
18063 # those requests to the backend service. Similarly requests from clients can
18064 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
18065 # that are configured with a fault_injection_policy if:
18066 # 1. The traffic is generated by fault injection AND
18067 # 2. The fault injection is not a delay fault injection.
18068 # Fault injection is not supported with the classic Application Load Balancer
18069 # . To see which load balancers support fault injection,
18070 # see Load
18071 # balancing: Routing and traffic management features.
18072 # the resiliency of clients to backend service failure. As part of fault
18073 # injection, when clients send requests to a backend service, delays can be
18074 # introduced by the load balancer on a percentage of requests before sending
18075 # those request to the backend service. Similarly requests from clients can be
18076 # aborted by the load balancer for a percentage of requests.
18077 &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
18078 # injection.
18079 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
18080 #
18081 # The value must be from 200 to 599 inclusive.
18082 #
18083 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
18084 # according to this
18085 # mapping table. HTTP status 200 is mapped to gRPC status
18086 # UNKNOWN. Injecting an OK status is currently not supported by
18087 # Traffic Director.
18088 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
18089 # that is aborted as part of fault injection.
18090 #
18091 # The value must be from 0.0 to 100.0 inclusive.
18092 },
18093 &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
18094 # injection, before being sent to a backend service.
18095 # request to the backend service as part of fault injection.
18096 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
18097 # as a count of seconds and fractions of seconds at nanosecond
18098 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18099 # or &quot;month&quot;. Range is approximately 10,000 years.
18100 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18101 # Durations less than one second are represented with a 0
18102 # `seconds` field and a positive `nanos` field. Must be from 0
18103 # to 999,999,999 inclusive.
18104 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18105 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18106 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18107 },
18108 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
18109 # which a delay is introduced as part of fault injection.
18110 #
18111 # The value must be from 0.0 to 100.0 inclusive.
18112 },
18113 },
18114 &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
18115 # Global EXTERNAL_MANAGED load balancer schemes.
18116 # Either Cloud CDN must be enabled on the backend service or backend bucket
18117 # serving the route, or cache policy must be configured on the same route
18118 # dynamically processes and delivers images from the network edge.
18119 # Image Optimization is only available for Global External Application Load
18120 # Balancers.
18121 # Either Cloud CDN must be enabled on the backend service or backend bucket
18122 # serving the route, or cache policy must be configured on the same route.
18123 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
18124 },
18125 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
18126 # Unlike the timeout field where the timeout duration starts
18127 # from the time the request has been fully processed (known as*end-of-stream*),
18128 # the duration in this field is computed from the beginning of the stream
18129 # until the response has been processed, including all retries. A
18130 # stream that does not complete in this duration is closed.
18131 #
18132 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
18133 # with the route.
18134 #
18135 # This field is only allowed if the Url map is used with backend services
18136 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
18137 # as a count of seconds and fractions of seconds at nanosecond
18138 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18139 # or &quot;month&quot;. Range is approximately 10,000 years.
18140 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18141 # Durations less than one second are represented with a 0
18142 # `seconds` field and a positive `nanos` field. Must be from 0
18143 # to 999,999,999 inclusive.
18144 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18145 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18146 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18147 },
18148 &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
18149 # are shadowed to a separate mirrored backend service. The load balancer does
18150 # not wait for responses from the shadow service. Before sending traffic
18151 # to the shadow service, the host / authority header is suffixed with-shadow.
18152 #
18153 # Not supported when the URL map is bound to a target gRPC proxy that
18154 # has the validateForProxyless field set to true.
18155 # are shadowed to a separate mirrored backend service. The load balancer
18156 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
18157 # to the shadow service, the host or authority header is suffixed with-shadow.
18158 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
18159 # mirrored to.
18160 #
18161 # The backend service configured for a mirroring
18162 # policy must reference backends that are of the same type as the original
18163 # backend service matched in the URL map.
18164 #
18165 # Serverless NEG backends are not currently supported as a mirrored
18166 # backend service.
18167 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
18168 },
18169 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
18170 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
18171 # If not specified, defaults to 1.
18172 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
18173 #
18174 # If not specified, will use the timeout set in theHttpRouteAction field.
18175 # If timeout in the HttpRouteAction field is not set, this field
18176 # uses the largest timeout
18177 # among all backend services associated with the route.
18178 #
18179 # Not supported when the URL map is bound to a target gRPC proxy that
18180 # has the validateForProxyless field set to true.
18181 # as a count of seconds and fractions of seconds at nanosecond
18182 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18183 # or &quot;month&quot;. Range is approximately 10,000 years.
18184 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18185 # Durations less than one second are represented with a 0
18186 # `seconds` field and a positive `nanos` field. Must be from 0
18187 # to 999,999,999 inclusive.
18188 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18189 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18190 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18191 },
18192 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
18193 # values are:
18194 #
18195 # - 5xx: retry is attempted if the instance or endpoint
18196 # responds with any 5xx response code, or if the instance or
18197 # endpoint does not respond at all. For example, disconnects, reset, read
18198 # timeout, connection failure, and refused streams.
18199 # - gateway-error: Similar to 5xx, but only
18200 # applies to response codes 502, 503 or504.
18201 # - connect-failure: a retry is attempted on failures
18202 # connecting to the instance or endpoint. For example, connection
18203 # timeouts.
18204 # - retriable-4xx: a retry is attempted if the instance
18205 # or endpoint responds with a 4xx response code.
18206 # The only error that you can retry is error code 409.
18207 # - refused-stream: a retry is attempted if the instance
18208 # or endpoint resets the stream with a REFUSED_STREAM error
18209 # code. This reset type indicates that it is safe to retry.
18210 # - cancelled: a retry is attempted if the gRPC status
18211 # code in the response header is set to cancelled.
18212 # - deadline-exceeded: a retry is attempted if the gRPC
18213 # status code in the response header is set todeadline-exceeded.
18214 # - internal: a retry is attempted if the gRPC
18215 # status code in the response header is set tointernal.
18216 # - resource-exhausted: a retry is attempted if the gRPC
18217 # status code in the response header is set toresource-exhausted.
18218 # - unavailable: a retry is attempted if the gRPC
18219 # status code in the response header is set tounavailable.
18220 #
18221 # Only the following codes are supported when the URL map is bound to
18222 # target gRPC proxy that has validateForProxyless field set to true.
18223 #
18224 # - cancelled
18225 # - deadline-exceeded
18226 # - internal
18227 # - resource-exhausted
18228 # - unavailable
18229 &quot;A String&quot;,
18230 ],
18231 },
18232 &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
18233 # time the request has been fully processed (known as *end-of-stream*)
18234 # up until the response has been processed. Timeout includes
18235 # all retries.
18236 #
18237 # If not specified, this field uses the largest timeout among all backend
18238 # services associated with the route.
18239 #
18240 # Not supported when the URL map is bound to a target gRPC proxy that
18241 # has validateForProxyless field set to true.
18242 # as a count of seconds and fractions of seconds at nanosecond
18243 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18244 # or &quot;month&quot;. Range is approximately 10,000 years.
18245 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18246 # Durations less than one second are represented with a 0
18247 # `seconds` field and a positive `nanos` field. Must be from 0
18248 # to 999,999,999 inclusive.
18249 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18250 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18251 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18252 },
18253 &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
18254 # to the matched service.
18255 #
18256 # urlRewrite is the only action supported in UrlMaps
18257 # for classic Application Load Balancers.
18258 #
18259 # Not supported when the URL map is bound to a target gRPC proxy that
18260 # has the validateForProxyless field set to true.
18261 # backend service.
18262 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
18263 # host header is replaced with contents of hostRewrite.
18264 #
18265 # The value must be from 1 to 255 characters.
18266 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
18267 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
18268 #
18269 # The value must be from 1 to 1024 characters.
18270 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
18271 # header) using the HTTP template syntax.
18272 #
18273 # A corresponding
18274 # path_template_match must be specified. Any template variables must exist in
18275 # the path_template_match field.
18276 #
18277 #
18278 # - -At least one variable must be specified in the path_template_match
18279 # field
18280 # - You can omit variables from the rewritten URL
18281 # - The * and ** operators cannot be matched
18282 # unless they have a corresponding variable name - e.g.
18283 # {format=*} or {var=**}.
18284 #
18285 # For example, a path_template_match of /static/{format=**}
18286 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
18287 # rewrite, so that /{country}/{format}/{suffix=**} can be
18288 # rewritten as /content/{format}/{country}/{suffix}.
18289 #
18290 # At least
18291 # one non-empty routeRules[].matchRules[].path_template_match is
18292 # required.
18293 #
18294 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
18295 },
18296 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
18297 # occurs. The weights determine the fraction of traffic that flows to
18298 # their corresponding backend service. If all traffic needs to
18299 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
18300 #
18301 # After a backend service is identified and before forwarding
18302 # the request to
18303 # the backend service, advanced routing actions such as URL rewrites and
18304 # header transformations are applied depending on additional settings
18305 # specified in this HttpRouteAction.
18306 { # In contrast to a single BackendService in
18307 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
18308 # multiple backend services. The volume of traffic for each
18309 # backend service is proportional to the weight specified
18310 # in each WeightedBackendService
18311 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
18312 # resource. Before
18313 # forwarding the request to backendService, the load balancer
18314 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
18315 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
18316 # effect for the selected backendService.
18317 #
18318 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
18319 #
18320 # headerAction is not supported for load balancers that have
18321 # their loadBalancingScheme set to EXTERNAL.
18322 #
18323 # Not supported when the URL map is bound to a target gRPC proxy that
18324 # has validateForProxyless field set to true.
18325 # the request is passed along to the selected backendService.
18326 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
18327 { # Specification determining how headers are added to requests or responses.
18328 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
18329 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
18330 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
18331 # that already
18332 # exist for the header. If true, headerValue is set for the
18333 # header, discarding any values that were set for that header.
18334 #
18335 # The default value is true,
18336 # unless a variable is present in headerValue,
18337 # in which case the default value is false.
18338 # .
18339 },
18340 ],
18341 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
18342 # request before forwarding the request to the backendService.
18343 &quot;A String&quot;,
18344 ],
18345 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
18346 # client.
18347 { # Specification determining how headers are added to requests or responses.
18348 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
18349 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
18350 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
18351 # that already
18352 # exist for the header. If true, headerValue is set for the
18353 # header, discarding any values that were set for that header.
18354 #
18355 # The default value is true,
18356 # unless a variable is present in headerValue,
18357 # in which case the default value is false.
18358 # .
18359 },
18360 ],
18361 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
18362 # response before sending the response back to the client.
18363 &quot;A String&quot;,
18364 ],
18365 },
18366 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
18367 # computed asweight / (sum of all weightedBackendService weights in routeAction).
18368 #
18369 # The selection of a backend service is determined only for new traffic.
18370 # Once a user&#x27;s request has been directed to a backend service,
18371 # subsequent requests are sent to the same backend service as
18372 # determined by the backend service&#x27;s session affinity policy.
18373 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
18374 # splitting. If you do, the weighted traffic splitting configuration takes
18375 # precedence.
18376 #
18377 # The value must be from 0 to 1000.
18378 },
18379 ],
18380 },
18381 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
18382 # is directed if this rule is matched. If routeAction is
18383 # also specified, advanced routing actions, such as URL rewrites,
18384 # take effect before sending the request to the backend.
18385 #
18386 #
18387 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
18388 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
18389 # specified by urlRedirect.
18390 #
18391 #
18392 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
18393 #
18394 #
18395 # Not supported when the URL map is bound to a target gRPC proxy.
18396 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
18397 # was supplied in the request.
18398 #
18399 # The value must be from 1 to 255
18400 # characters.
18401 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
18402 # set to HTTPS.
18403 # If set to false, the URL scheme of the redirected request
18404 # remains the same as that of the request.
18405 #
18406 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
18407 #
18408 # The default is set to false.
18409 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
18410 # that was supplied in the request.
18411 #
18412 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
18413 # supplied, the path of the original request is used for the redirect.
18414 #
18415 # The value must be from 1 to 1024 characters.
18416 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
18417 # the HttpRouteRuleMatch, retaining the remaining portion
18418 # of the URL before redirecting the request.
18419 #
18420 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
18421 # supplied, the path of the original request is used for the redirect.
18422 #
18423 # The value must be from 1 to 1024 characters.
18424 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
18425 #
18426 # Supported values are:
18427 #
18428 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
18429 # to 301.
18430 # - FOUND, which corresponds to 302.
18431 # - SEE_OTHER which corresponds to 303.
18432 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
18433 # method is retained.
18434 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
18435 # method is retained.
18436 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
18437 # URL is
18438 # removed before redirecting the request. If set to false, the
18439 # query portion of the original URL is retained.
18440 #
18441 # The default is set to false.
18442 },
18443 },
18444 ],
18445 &quot;routeRules&quot;: [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
18446 # desired. routeRules are evaluated in order of priority, from
18447 # the lowest to highest number.
18448 #
18449 # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
18450 { # The HttpRouteRule setting specifies how to match an HTTP request
18451 # and the corresponding routing action that load balancing proxies perform.
18452 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
18453 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
18454 #
18455 # If a policy for an
18456 # error code is not configured for the RouteRule, a policy for
18457 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
18458 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
18459 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
18460 # effect.
18461 #
18462 # For example, consider a UrlMap with the following configuration:
18463 #
18464 #
18465 # - UrlMap.defaultCustomErrorResponsePolicy are configured
18466 # with policies for 5xx and 4xx errors
18467 # - A RouteRule for /coming_soon/ is configured for the
18468 # error code 404.
18469 #
18470 # 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
18471 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
18472 # the policy in RouteRule.customErrorResponsePolicy takes
18473 # effect. If any of the requests in this example encounter a 500
18474 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
18475 #
18476 # When
18477 # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
18478 # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
18479 # a retry, if load balancer is successful in reaching the
18480 # service, the customErrorResponsePolicy is ignored and
18481 # the response from the service is returned to the client.
18482 #
18483 # customErrorResponsePolicy is supported only for
18484 # global external Application Load Balancers.
18485 # backend service or backend bucket responds with an error.
18486 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
18487 #
18488 # In a given policy, if you specify rules for both a range of error codes
18489 # as well as rules for specific error codes then rules with specific error
18490 # codes have a higher priority. For example, assume that you configure a rule
18491 # for 401 (Un-authorized) code, and another for all 4 series
18492 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
18493 # However if the backend service returns a 403, the rule for4xx takes effect.
18494 { # Specifies the mapping between the response code that will be returned along
18495 # with the custom error content and the response code returned by the backend
18496 # service.
18497 &quot;matchResponseCodes&quot;: [ # Valid values include:
18498 #
18499 #
18500 # - A number between 400 and 599: For example
18501 # 401 or 503, in which case the load balancer
18502 # applies the policy if the error code exactly matches this value.
18503 # - 5xx: Load Balancer will apply the policy if the
18504 # backend service responds with any response code in the range of
18505 # 500 to 599.
18506 # - 4xx: Load
18507 # Balancer will apply the policy if the backend service responds with any
18508 # response code in the range of 400 to
18509 # 499.
18510 #
18511 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
18512 &quot;A String&quot;,
18513 ],
18514 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
18515 # error content. If overrideResponseCode is not supplied, the
18516 # same response code returned by the original backend bucket or backend
18517 # service is returned to the client.
18518 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
18519 #
18520 # path must start
18521 # with a leading slash. path cannot have trailing slashes.
18522 #
18523 # If the file is not available in backendBucket or the
18524 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
18525 #
18526 # The value must
18527 # be from 1 to 1024 characters
18528 },
18529 ],
18530 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
18531 # contains the custom error content. Examples are:
18532 #
18533 #
18534 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
18535 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
18536 # - global/backendBuckets/myBackendBucket
18537 #
18538 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
18539 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
18540 #
18541 # If load balancer cannot reach
18542 # the backendBucket, a simple Not Found Error will
18543 # be returned, with the original response code (oroverrideResponseCode if configured).
18544 #
18545 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
18546 },
18547 &quot;description&quot;: &quot;A String&quot;, # The short description conveying the intent of this routeRule.
18548 #
18549 #
18550 # The description can have a maximum length of 1024 characters.
18551 &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
18552 # for the selected backendService.
18553 #
18554 # The headerAction value specified here is applied before the
18555 # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
18556 #
18557 # HeaderAction is not supported for load balancers
18558 # that have
18559 # their loadBalancingScheme set to EXTERNAL.
18560 #
18561 # Not supported when the URL map is bound to a target gRPC proxy that
18562 # has validateForProxyless field set to true.
18563 # the request is passed along to the selected backendService.
18564 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
18565 { # Specification determining how headers are added to requests or responses.
18566 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
18567 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
18568 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
18569 # that already
18570 # exist for the header. If true, headerValue is set for the
18571 # header, discarding any values that were set for that header.
18572 #
18573 # The default value is true,
18574 # unless a variable is present in headerValue,
18575 # in which case the default value is false.
18576 # .
18577 },
18578 ],
18579 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
18580 # request before forwarding the request to the backendService.
18581 &quot;A String&quot;,
18582 ],
18583 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
18584 # client.
18585 { # Specification determining how headers are added to requests or responses.
18586 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
18587 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
18588 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
18589 # that already
18590 # exist for the header. If true, headerValue is set for the
18591 # header, discarding any values that were set for that header.
18592 #
18593 # The default value is true,
18594 # unless a variable is present in headerValue,
18595 # in which case the default value is false.
18596 # .
18597 },
18598 ],
18599 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
18600 # response before sending the response back to the client.
18601 &quot;A String&quot;,
18602 ],
18603 },
18604 &quot;httpFilterConfigs&quot;: [ # Outbound route specific configuration fornetworkservices.HttpFilter resources enabled by Traffic
18605 # Director. httpFilterConfigs only applies for load balancers
18606 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
18607 # more details.
18608 #
18609 # Not supported when the URL map is bound to a target gRPC proxy that
18610 # has validateForProxyless field set to true.
18611 { # HttpFilterConfiguration supplies additional contextual settings
18612 # for networkservices.HttpFilter resources enabled by Traffic
18613 # Director.
18614 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
18615 # YAML formatted and only contain fields defined in the protobuf identified
18616 # in configTypeUrl
18617 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
18618 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
18619 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
18620 # configuration belongs to. This name must be known to the xDS client.
18621 # Example: envoy.wasm
18622 },
18623 ],
18624 &quot;httpFilterMetadata&quot;: [ # Outbound route specific metadata supplied tonetworkservices.HttpFilter resources enabled by Traffic
18625 # Director. httpFilterMetadata only applies for load balancers
18626 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
18627 # more details.
18628 #
18629 # The only configTypeUrl supported istype.googleapis.com/google.protobuf.Struct
18630 #
18631 # Not supported when the URL map is bound to a target gRPC proxy that
18632 # has validateForProxyless field set to true.
18633 { # HttpFilterConfiguration supplies additional contextual settings
18634 # for networkservices.HttpFilter resources enabled by Traffic
18635 # Director.
18636 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
18637 # YAML formatted and only contain fields defined in the protobuf identified
18638 # in configTypeUrl
18639 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
18640 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
18641 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
18642 # configuration belongs to. This name must be known to the xDS client.
18643 # Example: envoy.wasm
18644 },
18645 ],
18646 &quot;matchRules&quot;: [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
18647 # this routeRule when any of thematchRules are satisfied. However predicates within
18648 # a given matchRule have AND semantics. All predicates
18649 # within a matchRule must match for the request to
18650 # match the rule.
18651 { # HttpRouteRuleMatch specifies a set of criteria for matching
18652 # requests to an HttpRouteRule. All specified criteria must
18653 # be satisfied for a match to occur.
18654 &quot;fullPathMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
18655 # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
18656 # that may be part of the original URL.
18657 #
18658 # fullPathMatch must be from 1 to 1024 characters.
18659 #
18660 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
18661 # specified.
18662 &quot;headerMatches&quot;: [ # Specifies a list of header match criteria, all of which must match
18663 # corresponding headers in the request.
18664 { # matchRule criteria for request header matches.
18665 &quot;exactMatch&quot;: &quot;A String&quot;, # The value should exactly match contents of exactMatch.
18666 #
18667 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
18668 &quot;headerName&quot;: &quot;A String&quot;, # The name of the HTTP header to match.
18669 #
18670 # For matching against the HTTP request&#x27;s authority, use a headerMatch
18671 # with the header name &quot;:authority&quot;.
18672 #
18673 # For matching a request&#x27;s method, use the headerName &quot;:method&quot;.
18674 #
18675 # When the URL map is bound to a target gRPC proxy that has
18676 # the validateForProxyless field set to true, only
18677 # non-binary
18678 # user-specified custom metadata and the `content-type` header are supported.
18679 # The following transport-level headers cannot be used in header matching
18680 # rules:
18681 # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
18682 # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
18683 # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
18684 # `grpc-timeout` and `grpc-trace-bin`.
18685 &quot;invertMatch&quot;: True or False, # If set to false, the headerMatch is considered a
18686 # match if the preceding match criteria are met. If set to true,
18687 # the headerMatch is considered a match if the preceding
18688 # match criteria are NOT met.
18689 #
18690 # The default setting is false.
18691 &quot;prefixMatch&quot;: &quot;A String&quot;, # The value of the header must start with the contents ofprefixMatch.
18692 #
18693 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
18694 &quot;presentMatch&quot;: True or False, # A header with the contents of headerName must exist. The
18695 # match takes place whether or not the request&#x27;s header has a value.
18696 #
18697 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
18698 &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
18699 # specified in rangeMatch. If the header does not contain an
18700 # integer, number or is empty, the match fails.
18701 #
18702 # For example for a range [-5, 0]
18703 #
18704 #
18705 # - -3 will match.
18706 # - 0 will not match.
18707 # - 0.25 will not match.
18708 # - -3someString will not match.
18709 #
18710 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
18711 #
18712 # rangeMatch is not supported for load balancers
18713 # that have loadBalancingScheme set to EXTERNAL.
18714 # within the specified integer range.
18715 &quot;rangeEnd&quot;: &quot;A String&quot;, # The end of the range (exclusive) in signed long integer format.
18716 &quot;rangeStart&quot;: &quot;A String&quot;, # The start of the range (inclusive) in signed long integer format.
18717 },
18718 &quot;regexMatch&quot;: &quot;A String&quot;, # The value of the header must match the regular expression specified inregexMatch.
18719 # For more information about regular expression syntax, see Syntax.
18720 #
18721 # For matching against a port specified in the HTTP request, use a
18722 # headerMatch with headerName set to PORT and a regular expression that
18723 # satisfies the RFC2616 Host header&#x27;s port specifier.
18724 #
18725 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
18726 #
18727 # Regular expressions can only be used when the loadBalancingScheme is
18728 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
18729 # (regional scope) or INTERNAL_MANAGED.
18730 &quot;suffixMatch&quot;: &quot;A String&quot;, # The value of the header must end with the contents ofsuffixMatch.
18731 #
18732 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
18733 },
18734 ],
18735 &quot;ignoreCase&quot;: True or False, # Specifies that prefixMatch and fullPathMatch
18736 # matches are case sensitive.
18737 #
18738 # The default value is false.
18739 #
18740 # ignoreCase must not be used with regexMatch.
18741 #
18742 # Not supported when the URL map is bound to a target gRPC proxy.
18743 &quot;metadataFilters&quot;: [ # Opaque filter criteria used by the load balancer to restrict routing
18744 # configuration to a limited set of xDS
18745 # compliant clients. In their xDS requests to the load balancer, xDS clients
18746 # present node
18747 # metadata. When there is a match, the relevant routing configuration
18748 # is made available to those proxies.
18749 #
18750 # 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
18751 # the metadata. If its filterMatchCriteria is set to
18752 # MATCH_ALL, then all of its filterLabels must match with
18753 # corresponding labels provided in the metadata. If multiple
18754 # metadata filters are specified, all of them need to be
18755 # satisfied in order to be considered a match.
18756 #
18757 # metadataFilters specified here is applied after those
18758 # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
18759 #
18760 # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
18761 #
18762 # Not supported when the URL map is bound to a target gRPC proxy that
18763 # has validateForProxyless field set to true.
18764 { # Opaque filter criteria used by load balancers to restrict routing
18765 # configuration to a limited set of load balancing proxies. Proxies and
18766 # sidecars involved in load balancing would typically present metadata to the
18767 # load balancers that need to match criteria specified here. If a match takes
18768 # place, the relevant configuration is made available to those
18769 # proxies.
18770 #
18771 # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
18772 # one of thefilterLabels must match the corresponding label provided in
18773 # the metadata. If its filterMatchCriteria is set to
18774 # MATCH_ALL, then all of its filterLabels must match with
18775 # corresponding labels provided in the metadata.
18776 #
18777 # An example for using metadataFilters would be: if
18778 # load balancing involves
18779 # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in of their XDS requests to loadbalancers.
18780 &quot;filterLabels&quot;: [ # The list of label value pairs that must match labels in the provided
18781 # metadata based on filterMatchCriteria
18782 #
18783 # This list must not be empty and can have at the most 64 entries.
18784 { # MetadataFilter label name value pairs that are expected
18785 # to match corresponding labels presented as metadata to the load balancer.
18786 &quot;name&quot;: &quot;A String&quot;, # Name of metadata label.
18787 #
18788 # The name can have a maximum length of 1024 characters and must be at
18789 # least 1 character long.
18790 &quot;value&quot;: &quot;A String&quot;, # The value of the label must match the specified value.
18791 #
18792 # value can have a maximum length of 1024 characters.
18793 },
18794 ],
18795 &quot;filterMatchCriteria&quot;: &quot;A String&quot;, # Specifies how individual filter label matches
18796 # within the list of filterLabels and contributes toward the
18797 # overall metadataFilter match.
18798 #
18799 # Supported values are:
18800 #
18801 # - MATCH_ANY: at least one of the filterLabels
18802 # must have a matching label in the provided metadata.
18803 # - MATCH_ALL: all filterLabels must have
18804 # matching labels in the provided metadata.
18805 },
18806 ],
18807 &quot;pathTemplateMatch&quot;: &quot;A String&quot;, # If specified, this field defines a path template pattern that must match
18808 # the :path header after the query string is removed.
18809 #
18810 # A path template pattern can include variables and wildcards.
18811 # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
18812 # matches a single path segment, and ** that matches zero or
18813 # more path segments. The pattern must follow these rules:
18814 #
18815 #
18816 # - The value must be between 1 and 1024 characters.
18817 # - The pattern must start with a leading slash (&quot;/&quot;).
18818 # - No more than 5 operators (variables or wildcards) may appear in
18819 # the pattern.
18820 #
18821 # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
18822 # set.
18823 &quot;prefixMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the request&#x27;s
18824 # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
18825 #
18826 # The value must be from 1 to 1024 characters.
18827 #
18828 # The * character inside a prefix match is
18829 # treated as a literal character, not as a wildcard.
18830 #
18831 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
18832 # used within a matchRule.
18833 &quot;queryParameterMatches&quot;: [ # Specifies a list of query parameter match criteria, all of which must
18834 # match corresponding query parameters in the request.
18835 #
18836 # Not supported when the URL map is bound to a target gRPC proxy.
18837 { # HttpRouteRuleMatch criteria for a request&#x27;s query parameter.
18838 &quot;exactMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
18839 # parameter exactly matches the contents of exactMatch.
18840 #
18841 # Only one of presentMatch, exactMatch, orregexMatch must be set.
18842 &quot;name&quot;: &quot;A String&quot;, # The name of the query parameter to match. The query parameter must exist in
18843 # the request, in the absence of which the request match fails.
18844 &quot;presentMatch&quot;: True or False, # Specifies that the queryParameterMatch matches if the
18845 # request contains the query parameter, irrespective of whether the
18846 # parameter has a value or not.
18847 #
18848 # Only one of presentMatch, exactMatch, orregexMatch must be set.
18849 &quot;regexMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
18850 # parameter matches the regular expression specified byregexMatch. For
18851 # more information about regular expression syntax, see Syntax.
18852 #
18853 # Only one of presentMatch, exactMatch, orregexMatch must be set.
18854 #
18855 # Regular expressions can only be used when the loadBalancingScheme is
18856 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
18857 # (regional scope) or INTERNAL_MANAGED.
18858 },
18859 ],
18860 &quot;regexMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
18861 # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
18862 # supplied with the original URL. For
18863 # more information about regular expression syntax, see Syntax.
18864 #
18865 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
18866 # specified.
18867 #
18868 # Regular expressions can only be used when the loadBalancingScheme is
18869 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
18870 # (regional scope) or INTERNAL_MANAGED.
18871 },
18872 ],
18873 &quot;priority&quot;: 42, # For routeRules within a given pathMatcher,
18874 # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
18875 # of priority, from the lowest to highest number. The priority of a
18876 # rule decreases as its number increases (1, 2, 3, N+1). The first rule
18877 # that matches the request is applied.
18878 #
18879 #
18880 # You cannot configure two or more routeRules with the same priority.
18881 # Priority for each rule must be set to a number from 0 to 2147483647
18882 # inclusive.
18883 #
18884 #
18885 # Priority numbers can have gaps, which enable you to add or remove rules
18886 # in the future without affecting the rest of the rules. For example, 1, 2,
18887 # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
18888 # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
18889 # without any impact on existing rules.
18890 &quot;routeAction&quot;: { # In response to a matching matchRule, the load balancer
18891 # performs advanced routing actions, such as URL rewrites and header
18892 # transformations, before forwarding the request to the selected backend.
18893 #
18894 #
18895 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
18896 #
18897 #
18898 # URL maps for classic Application Load Balancers only support
18899 # the urlRewrite action within a route rule&#x27;srouteAction.
18900 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
18901 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
18902 # property must be specified. This policy cannot be specified if any target
18903 # backend has Identity-Aware Proxy enabled.
18904 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
18905 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
18906 # header names can be specified. The cache is bypassed for all `cacheMode`
18907 # values.
18908 &quot;A String&quot;,
18909 ],
18910 &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
18911 # on the backend type: for Backend Services, the complete request URI is
18912 # used; for Backend Buckets, the request URI is used without the protocol or
18913 # host, and only query parameters known to Cloud Storage are included.
18914 # Policy defined on Route Action.
18915 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
18916 # parameters will be included. Either specify `excludedQueryParameters`
18917 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
18918 # encoded and not treated as delimiters.
18919 #
18920 # Note: This field applies to routes that use backend services. Attempting
18921 # to set it on a route that points exclusively to Backend Buckets will
18922 # result in a configuration error. For routes that point to a Backend
18923 # Bucket, use `includedQueryParameters` to define which parameters should
18924 # be part of the cache key.
18925 &quot;A String&quot;,
18926 ],
18927 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
18928 #
18929 # Note: This setting is only applicable to routes that use a Backend
18930 # Service. It does not affect requests served by a Backend Bucket, as the
18931 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
18932 # it on a route that points exclusively to Backend Buckets will result in a
18933 # configuration error.
18934 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
18935 #
18936 # Note: This setting is only applicable to routes that use a Backend
18937 # Service. It does not affect requests served by a Backend Bucket, as the
18938 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
18939 # set on a route that points exclusively to Backend Buckets will result in
18940 # a configuration error.
18941 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
18942 # `includedQueryParameters` and `excludedQueryParameters`. If neither
18943 # is set, the entire query string will be included. If false, the query
18944 # string will be excluded from the cache key entirely.
18945 #
18946 # Note: This field applies to routes that use backend services. Attempting
18947 # to set it on a route that points exclusively to Backend Buckets will
18948 # result in a configuration error. For routes that point to a Backend
18949 # Bucket, use `includedQueryParameters` to define which parameters should
18950 # be part of the cache key.
18951 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
18952 # The name=value pair will be used in the cache key Cloud CDN generates.
18953 #
18954 # Note: This setting is only applicable to routes that use a Backend
18955 # Service. It does not affect requests served by a Backend Bucket.
18956 # Attempting to set it on a route that points exclusively to Backend
18957 # Buckets will result in a configuration error. Up to 5 cookie names can be
18958 # specified.
18959 &quot;A String&quot;,
18960 ],
18961 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
18962 &quot;A String&quot;,
18963 ],
18964 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
18965 # parameters will be excluded. Either specify `includedQueryParameters`
18966 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
18967 # encoded and not treated as delimiters.
18968 &quot;A String&quot;,
18969 ],
18970 },
18971 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
18972 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
18973 &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
18974 # content. This is used to clamp the max-age (or Expires) value sent to the
18975 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
18976 # is used for the response max-age directive, along with a &quot;public&quot;
18977 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
18978 # clamps the max-age from the origin (if specified), or else sets the
18979 # response max-age directive to the lesser of the `clientTtl` and
18980 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
18981 # present. The maximum allowed value is 31,622,400s (1 year). If not
18982 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
18983 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
18984 # `USE_ORIGIN_HEADERS`.
18985 # as a count of seconds and fractions of seconds at nanosecond
18986 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18987 # or &quot;month&quot;. Range is approximately 10,000 years.
18988 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18989 # Durations less than one second are represented with a 0
18990 # `seconds` field and a positive `nanos` field. Must be from 0
18991 # to 999,999,999 inclusive.
18992 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18993 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18994 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18995 },
18996 &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
18997 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
18998 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
18999 # greater than that of `maxTtl`. When the `cacheMode` is set to
19000 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
19001 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
19002 # accessed objects may be evicted from the cache before the defined TTL. If
19003 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
19004 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
19005 # `USE_ORIGIN_HEADERS`.
19006 # as a count of seconds and fractions of seconds at nanosecond
19007 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19008 # or &quot;month&quot;. Range is approximately 10,000 years.
19009 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19010 # Durations less than one second are represented with a 0
19011 # `seconds` field and a positive `nanos` field. Must be from 0
19012 # to 999,999,999 inclusive.
19013 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19014 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19015 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19016 },
19017 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
19018 # attempt to set a max-age or s-maxage higher than this, or an Expires header
19019 # more than `maxTtl` seconds in the future will be capped at the value of
19020 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
19021 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
19022 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
19023 # Infrequently accessed objects may be evicted from the cache before the
19024 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
19025 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
19026 # mode.
19027 # as a count of seconds and fractions of seconds at nanosecond
19028 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19029 # or &quot;month&quot;. Range is approximately 10,000 years.
19030 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19031 # Durations less than one second are represented with a 0
19032 # `seconds` field and a positive `nanos` field. Must be from 0
19033 # to 999,999,999 inclusive.
19034 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19035 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19036 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19037 },
19038 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
19039 # to apply fine-grained caching for common errors or redirects.
19040 # This can reduce the load on your origin and improve end-user
19041 # experience by reducing response latency.
19042 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
19043 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
19044 # the specified response code that lack any Cache-Control, Expires, or
19045 # Pragma: no-cache directives. When the `cacheMode` is set to
19046 # `FORCE_CACHE_ALL`, negative caching applies to all responses
19047 # with the specified response code, and overrides any caching headers. By
19048 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
19049 #
19050 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
19051 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
19052 # * 405 (Method Not Found), 501 (Not Implemented): 60s
19053 #
19054 # These defaults can be overridden in `negativeCachingPolicy`.
19055 # If not specified, Cloud CDN applies negative caching by default.
19056 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
19057 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
19058 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
19059 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
19060 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
19061 # all response codes that you wish to cache. Cloud CDN will not apply any
19062 # default negative caching when a policy exists.
19063 { # Specify CDN TTLs for response error codes.
19064 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
19065 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
19066 # specified as values, and you cannot specify a status code more than
19067 # once.
19068 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
19069 # corresponding status code.
19070 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
19071 # objects may be evicted from the cache before the defined TTL.
19072 # as a count of seconds and fractions of seconds at nanosecond
19073 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19074 # or &quot;month&quot;. Range is approximately 10,000 years.
19075 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19076 # Durations less than one second are represented with a 0
19077 # `seconds` field and a positive `nanos` field. Must be from 0
19078 # to 999,999,999 inclusive.
19079 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19080 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19081 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19082 },
19083 },
19084 ],
19085 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
19086 # requests into a small number of requests to the origin. If not specified,
19087 # Cloud CDN applies request coalescing by default.
19088 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
19089 # content with the origin, or when an error is encountered when refreshing
19090 # the cache.
19091 # This setting defines the default &quot;max-stale&quot; duration for any cached
19092 # responses that do not specify a max-stale directive. Stale responses that
19093 # exceed the TTL configured here will not be served. The default limit
19094 # (max-stale) is 86400s (1 day), which will allow stale content to be
19095 # served up to this limit beyond the max-age (or s-maxage) of a cached
19096 # response.
19097 # The maximum allowed value is 604800 (1 week).
19098 # Set this to zero (0) to disable serve-while-stale.
19099 # as a count of seconds and fractions of seconds at nanosecond
19100 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19101 # or &quot;month&quot;. Range is approximately 10,000 years.
19102 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19103 # Durations less than one second are represented with a 0
19104 # `seconds` field and a positive `nanos` field. Must be from 0
19105 # to 999,999,999 inclusive.
19106 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19107 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19108 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19109 },
19110 },
19111 &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
19112 # information about the W3C recommendation for cross-origin resource sharing
19113 # (CORS), see Fetch API Living
19114 # Standard.
19115 #
19116 # Not supported when the URL map is bound to a target gRPC proxy.
19117 # information about the W3C recommendation for cross-origin resource sharing
19118 # (CORS), see Fetch API Living
19119 # Standard.
19120 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
19121 # indicates that
19122 # the actual request can include user credentials. This field translates to
19123 # the Access-Control-Allow-Credentials header.
19124 #
19125 # Default is false.
19126 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
19127 # header.
19128 &quot;A String&quot;,
19129 ],
19130 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
19131 # header.
19132 &quot;A String&quot;,
19133 ],
19134 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
19135 # more information, see regular expression syntax.
19136 #
19137 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
19138 #
19139 # Regular expressions can only be used when the loadBalancingScheme is
19140 # set to INTERNAL_SELF_MANAGED.
19141 &quot;A String&quot;,
19142 ],
19143 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
19144 #
19145 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
19146 &quot;A String&quot;,
19147 ],
19148 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
19149 # The default value is false, which indicates that the CORS
19150 # policy is in effect.
19151 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
19152 # header.
19153 &quot;A String&quot;,
19154 ],
19155 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
19156 # seconds. This field translates to the Access-Control-Max-Age
19157 # header.
19158 },
19159 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
19160 # the resiliency of clients to backend service failure. As part of fault
19161 # injection, when clients send requests to a backend service, delays can be
19162 # introduced by a load balancer on a percentage of requests before sending
19163 # those requests to the backend service. Similarly requests from clients can
19164 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
19165 # that are configured with a fault_injection_policy if:
19166 # 1. The traffic is generated by fault injection AND
19167 # 2. The fault injection is not a delay fault injection.
19168 # Fault injection is not supported with the classic Application Load Balancer
19169 # . To see which load balancers support fault injection,
19170 # see Load
19171 # balancing: Routing and traffic management features.
19172 # the resiliency of clients to backend service failure. As part of fault
19173 # injection, when clients send requests to a backend service, delays can be
19174 # introduced by the load balancer on a percentage of requests before sending
19175 # those request to the backend service. Similarly requests from clients can be
19176 # aborted by the load balancer for a percentage of requests.
19177 &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
19178 # injection.
19179 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
19180 #
19181 # The value must be from 200 to 599 inclusive.
19182 #
19183 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
19184 # according to this
19185 # mapping table. HTTP status 200 is mapped to gRPC status
19186 # UNKNOWN. Injecting an OK status is currently not supported by
19187 # Traffic Director.
19188 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
19189 # that is aborted as part of fault injection.
19190 #
19191 # The value must be from 0.0 to 100.0 inclusive.
19192 },
19193 &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
19194 # injection, before being sent to a backend service.
19195 # request to the backend service as part of fault injection.
19196 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
19197 # as a count of seconds and fractions of seconds at nanosecond
19198 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19199 # or &quot;month&quot;. Range is approximately 10,000 years.
19200 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19201 # Durations less than one second are represented with a 0
19202 # `seconds` field and a positive `nanos` field. Must be from 0
19203 # to 999,999,999 inclusive.
19204 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19205 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19206 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19207 },
19208 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
19209 # which a delay is introduced as part of fault injection.
19210 #
19211 # The value must be from 0.0 to 100.0 inclusive.
19212 },
19213 },
19214 &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
19215 # Global EXTERNAL_MANAGED load balancer schemes.
19216 # Either Cloud CDN must be enabled on the backend service or backend bucket
19217 # serving the route, or cache policy must be configured on the same route
19218 # dynamically processes and delivers images from the network edge.
19219 # Image Optimization is only available for Global External Application Load
19220 # Balancers.
19221 # Either Cloud CDN must be enabled on the backend service or backend bucket
19222 # serving the route, or cache policy must be configured on the same route.
19223 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
19224 },
19225 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
19226 # Unlike the timeout field where the timeout duration starts
19227 # from the time the request has been fully processed (known as*end-of-stream*),
19228 # the duration in this field is computed from the beginning of the stream
19229 # until the response has been processed, including all retries. A
19230 # stream that does not complete in this duration is closed.
19231 #
19232 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
19233 # with the route.
19234 #
19235 # This field is only allowed if the Url map is used with backend services
19236 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
19237 # as a count of seconds and fractions of seconds at nanosecond
19238 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19239 # or &quot;month&quot;. Range is approximately 10,000 years.
19240 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19241 # Durations less than one second are represented with a 0
19242 # `seconds` field and a positive `nanos` field. Must be from 0
19243 # to 999,999,999 inclusive.
19244 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19245 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19246 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19247 },
19248 &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
19249 # are shadowed to a separate mirrored backend service. The load balancer does
19250 # not wait for responses from the shadow service. Before sending traffic
19251 # to the shadow service, the host / authority header is suffixed with-shadow.
19252 #
19253 # Not supported when the URL map is bound to a target gRPC proxy that
19254 # has the validateForProxyless field set to true.
19255 # are shadowed to a separate mirrored backend service. The load balancer
19256 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
19257 # to the shadow service, the host or authority header is suffixed with-shadow.
19258 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
19259 # mirrored to.
19260 #
19261 # The backend service configured for a mirroring
19262 # policy must reference backends that are of the same type as the original
19263 # backend service matched in the URL map.
19264 #
19265 # Serverless NEG backends are not currently supported as a mirrored
19266 # backend service.
19267 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
19268 },
19269 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
19270 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
19271 # If not specified, defaults to 1.
19272 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
19273 #
19274 # If not specified, will use the timeout set in theHttpRouteAction field.
19275 # If timeout in the HttpRouteAction field is not set, this field
19276 # uses the largest timeout
19277 # among all backend services associated with the route.
19278 #
19279 # Not supported when the URL map is bound to a target gRPC proxy that
19280 # has the validateForProxyless field set to true.
19281 # as a count of seconds and fractions of seconds at nanosecond
19282 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19283 # or &quot;month&quot;. Range is approximately 10,000 years.
19284 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19285 # Durations less than one second are represented with a 0
19286 # `seconds` field and a positive `nanos` field. Must be from 0
19287 # to 999,999,999 inclusive.
19288 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19289 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19290 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19291 },
19292 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
19293 # values are:
19294 #
19295 # - 5xx: retry is attempted if the instance or endpoint
19296 # responds with any 5xx response code, or if the instance or
19297 # endpoint does not respond at all. For example, disconnects, reset, read
19298 # timeout, connection failure, and refused streams.
19299 # - gateway-error: Similar to 5xx, but only
19300 # applies to response codes 502, 503 or504.
19301 # - connect-failure: a retry is attempted on failures
19302 # connecting to the instance or endpoint. For example, connection
19303 # timeouts.
19304 # - retriable-4xx: a retry is attempted if the instance
19305 # or endpoint responds with a 4xx response code.
19306 # The only error that you can retry is error code 409.
19307 # - refused-stream: a retry is attempted if the instance
19308 # or endpoint resets the stream with a REFUSED_STREAM error
19309 # code. This reset type indicates that it is safe to retry.
19310 # - cancelled: a retry is attempted if the gRPC status
19311 # code in the response header is set to cancelled.
19312 # - deadline-exceeded: a retry is attempted if the gRPC
19313 # status code in the response header is set todeadline-exceeded.
19314 # - internal: a retry is attempted if the gRPC
19315 # status code in the response header is set tointernal.
19316 # - resource-exhausted: a retry is attempted if the gRPC
19317 # status code in the response header is set toresource-exhausted.
19318 # - unavailable: a retry is attempted if the gRPC
19319 # status code in the response header is set tounavailable.
19320 #
19321 # Only the following codes are supported when the URL map is bound to
19322 # target gRPC proxy that has validateForProxyless field set to true.
19323 #
19324 # - cancelled
19325 # - deadline-exceeded
19326 # - internal
19327 # - resource-exhausted
19328 # - unavailable
19329 &quot;A String&quot;,
19330 ],
19331 },
19332 &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
19333 # time the request has been fully processed (known as *end-of-stream*)
19334 # up until the response has been processed. Timeout includes
19335 # all retries.
19336 #
19337 # If not specified, this field uses the largest timeout among all backend
19338 # services associated with the route.
19339 #
19340 # Not supported when the URL map is bound to a target gRPC proxy that
19341 # has validateForProxyless field set to true.
19342 # as a count of seconds and fractions of seconds at nanosecond
19343 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19344 # or &quot;month&quot;. Range is approximately 10,000 years.
19345 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19346 # Durations less than one second are represented with a 0
19347 # `seconds` field and a positive `nanos` field. Must be from 0
19348 # to 999,999,999 inclusive.
19349 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19350 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19351 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19352 },
19353 &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
19354 # to the matched service.
19355 #
19356 # urlRewrite is the only action supported in UrlMaps
19357 # for classic Application Load Balancers.
19358 #
19359 # Not supported when the URL map is bound to a target gRPC proxy that
19360 # has the validateForProxyless field set to true.
19361 # backend service.
19362 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
19363 # host header is replaced with contents of hostRewrite.
19364 #
19365 # The value must be from 1 to 255 characters.
19366 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
19367 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
19368 #
19369 # The value must be from 1 to 1024 characters.
19370 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
19371 # header) using the HTTP template syntax.
19372 #
19373 # A corresponding
19374 # path_template_match must be specified. Any template variables must exist in
19375 # the path_template_match field.
19376 #
19377 #
19378 # - -At least one variable must be specified in the path_template_match
19379 # field
19380 # - You can omit variables from the rewritten URL
19381 # - The * and ** operators cannot be matched
19382 # unless they have a corresponding variable name - e.g.
19383 # {format=*} or {var=**}.
19384 #
19385 # For example, a path_template_match of /static/{format=**}
19386 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
19387 # rewrite, so that /{country}/{format}/{suffix=**} can be
19388 # rewritten as /content/{format}/{country}/{suffix}.
19389 #
19390 # At least
19391 # one non-empty routeRules[].matchRules[].path_template_match is
19392 # required.
19393 #
19394 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
19395 },
19396 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
19397 # occurs. The weights determine the fraction of traffic that flows to
19398 # their corresponding backend service. If all traffic needs to
19399 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
19400 #
19401 # After a backend service is identified and before forwarding
19402 # the request to
19403 # the backend service, advanced routing actions such as URL rewrites and
19404 # header transformations are applied depending on additional settings
19405 # specified in this HttpRouteAction.
19406 { # In contrast to a single BackendService in
19407 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
19408 # multiple backend services. The volume of traffic for each
19409 # backend service is proportional to the weight specified
19410 # in each WeightedBackendService
19411 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
19412 # resource. Before
19413 # forwarding the request to backendService, the load balancer
19414 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
19415 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
19416 # effect for the selected backendService.
19417 #
19418 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
19419 #
19420 # headerAction is not supported for load balancers that have
19421 # their loadBalancingScheme set to EXTERNAL.
19422 #
19423 # Not supported when the URL map is bound to a target gRPC proxy that
19424 # has validateForProxyless field set to true.
19425 # the request is passed along to the selected backendService.
19426 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
19427 { # Specification determining how headers are added to requests or responses.
19428 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
19429 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
19430 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
19431 # that already
19432 # exist for the header. If true, headerValue is set for the
19433 # header, discarding any values that were set for that header.
19434 #
19435 # The default value is true,
19436 # unless a variable is present in headerValue,
19437 # in which case the default value is false.
19438 # .
19439 },
19440 ],
19441 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
19442 # request before forwarding the request to the backendService.
19443 &quot;A String&quot;,
19444 ],
19445 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
19446 # client.
19447 { # Specification determining how headers are added to requests or responses.
19448 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
19449 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
19450 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
19451 # that already
19452 # exist for the header. If true, headerValue is set for the
19453 # header, discarding any values that were set for that header.
19454 #
19455 # The default value is true,
19456 # unless a variable is present in headerValue,
19457 # in which case the default value is false.
19458 # .
19459 },
19460 ],
19461 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
19462 # response before sending the response back to the client.
19463 &quot;A String&quot;,
19464 ],
19465 },
19466 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
19467 # computed asweight / (sum of all weightedBackendService weights in routeAction).
19468 #
19469 # The selection of a backend service is determined only for new traffic.
19470 # Once a user&#x27;s request has been directed to a backend service,
19471 # subsequent requests are sent to the same backend service as
19472 # determined by the backend service&#x27;s session affinity policy.
19473 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
19474 # splitting. If you do, the weighted traffic splitting configuration takes
19475 # precedence.
19476 #
19477 # The value must be from 0 to 1000.
19478 },
19479 ],
19480 },
19481 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
19482 # is directed if this rule is matched. If routeAction is
19483 # also specified, advanced routing actions, such as URL rewrites,
19484 # take effect before sending the request to the backend.
19485 #
19486 #
19487 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
19488 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
19489 # specified by urlRedirect.
19490 #
19491 #
19492 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
19493 #
19494 #
19495 # Not supported when the URL map is bound to a target gRPC proxy.
19496 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
19497 # was supplied in the request.
19498 #
19499 # The value must be from 1 to 255
19500 # characters.
19501 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
19502 # set to HTTPS.
19503 # If set to false, the URL scheme of the redirected request
19504 # remains the same as that of the request.
19505 #
19506 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
19507 #
19508 # The default is set to false.
19509 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
19510 # that was supplied in the request.
19511 #
19512 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
19513 # supplied, the path of the original request is used for the redirect.
19514 #
19515 # The value must be from 1 to 1024 characters.
19516 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
19517 # the HttpRouteRuleMatch, retaining the remaining portion
19518 # of the URL before redirecting the request.
19519 #
19520 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
19521 # supplied, the path of the original request is used for the redirect.
19522 #
19523 # The value must be from 1 to 1024 characters.
19524 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
19525 #
19526 # Supported values are:
19527 #
19528 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
19529 # to 301.
19530 # - FOUND, which corresponds to 302.
19531 # - SEE_OTHER which corresponds to 303.
19532 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
19533 # method is retained.
19534 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
19535 # method is retained.
19536 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
19537 # URL is
19538 # removed before redirecting the request. If set to false, the
19539 # query portion of the original URL is retained.
19540 #
19541 # The default is set to false.
19542 },
19543 },
19544 ],
19545 },
19546 ],
19547 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the regional URL map resides.
19548 # This field is not applicable to global URL maps.
19549 # You must specify this field as part of the HTTP request URL. It is
19550 # not settable as a field in the request body.
19551 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
19552 &quot;status&quot;: { # [Output Only] The status of the URL map. # Output only. [Output Only] The status of the URL map.
19553 &quot;quotaUsage&quot;: { # Message representing the quota usage for a UrlMap. # Output only. Summary of quota usage for given UrlMap.
19554 &quot;forwardingRules&quot;: 42, # Output only. The number of forwarding rules that uses this UrlMap.
19555 &quot;units&quot;: &quot;A String&quot;, # Output only. The number of quota units calculated for this UrlMap.
19556 },
19557 },
19558 &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
19559 # maximum of 100 tests per UrlMap.
19560 #
19561 # Not supported when the URL map is bound to a target gRPC proxy that
19562 # has validateForProxyless field set to true.
19563 { # Message for the expected URL mappings.
19564 &quot;description&quot;: &quot;A String&quot;, # Description of this test case.
19565 &quot;expectedOutputUrl&quot;: &quot;A String&quot;, # The expected output URL evaluated by the load balancer
19566 # containing the scheme, host, path and query parameters.
19567 #
19568 # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
19569 # the load balancer to backends. For rules with urlRewrite,
19570 # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
19571 #
19572 # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer&#x27;s
19573 # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
19574 # If urlRedirect specifies strip_query, the test
19575 # passes only if expectedOutputUrl does not contain any query
19576 # parameters.
19577 #
19578 # expectedOutputUrl is optional whenservice is specified.
19579 &quot;expectedRedirectResponseCode&quot;: 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
19580 # load balancer&#x27;s redirect response.
19581 #
19582 # expectedRedirectResponseCode cannot be set whenservice is set.
19583 &quot;headers&quot;: [ # HTTP headers for this request. If headers contains
19584 # a host header, then host must also match the header value.
19585 { # HTTP headers used in UrlMapTests.
19586 &quot;name&quot;: &quot;A String&quot;, # Header name.
19587 &quot;value&quot;: &quot;A String&quot;, # Header value.
19588 },
19589 ],
19590 &quot;host&quot;: &quot;A String&quot;, # Host portion of the URL. If headers contains a host header,
19591 # then host must also match the header value.
19592 &quot;path&quot;: &quot;A String&quot;, # Path portion of the URL.
19593 &quot;service&quot;: &quot;A String&quot;, # Expected BackendService or BackendBucket resource
19594 # the given URL should be mapped to.
19595 #
19596 # The service field cannot
19597 # be set if expectedRedirectResponseCode is set.
19598 },
19599 ],
19600 }
19601
19602 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
19603 that if you must retry your request, the server will know to ignore the
19604 request if it has already been completed.
19605
19606 For example, consider a situation where you make an initial request and
19607 the request times out. If you make the request again with the same
19608 request ID, the server can check if original operation with the same
19609 request ID was received, and if so, will ignore the second request. This
19610 prevents clients from accidentally creating duplicate commitments.
19611
19612 The request ID must be
19613 a valid UUID with the exception that zero UUID is not supported
19614 (00000000-0000-0000-0000-000000000000).
19615 x__xgafv: string, V1 error format.
19616 Allowed values
19617 1 - v1 error format
19618 2 - v2 error format
19619
19620 Returns:
19621 An object of the form:
19622
19623 { # Represents an Operation resource.
19624 #
19625 # Google Compute Engine has three Operation resources:
19626 #
19627 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
19628 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
19629 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
19630 #
19631 # You can use an operation resource to manage asynchronous API requests.
19632 # For more information, readHandling
19633 # API responses.
19634 #
19635 # Operations can be global, regional or zonal.
19636 #
19637 # - For global operations, use the `globalOperations`
19638 # resource.
19639 # - For regional operations, use the
19640 # `regionOperations` resource.
19641 # - For zonal operations, use
19642 # the `zoneOperations` resource.
19643 #
19644 #
19645 #
19646 # For more information, read
19647 # Global, Regional, and Zonal Resources.
19648 #
19649 # Note that completed Operation resources have a limited
19650 # retention period.
19651 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
19652 # Not present otherwise.
19653 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
19654 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
19655 # set when the operation is created.
19656 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
19657 # text format.
19658 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
19659 # this field will be populated.
19660 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
19661 # operation.
19662 {
19663 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
19664 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
19665 # details. There is a set of defined message types to use for providing
19666 # details.The syntax depends on the error code. For example,
19667 # QuotaExceededInfo will have details when the error code is
19668 # QUOTA_EXCEEDED.
19669 {
19670 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
19671 #
19672 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
19673 # is not enabled:
19674 #
19675 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
19676 # &quot;domain&quot;: &quot;googleapis.com&quot;
19677 # &quot;metadata&quot;: {
19678 # &quot;resource&quot;: &quot;projects/123&quot;,
19679 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
19680 # }
19681 # }
19682 #
19683 # This response indicates that the pubsub.googleapis.com API is not enabled.
19684 #
19685 # Example of an error that is returned when attempting to create a Spanner
19686 # instance in a region that is out of stock:
19687 #
19688 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
19689 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
19690 # &quot;metadata&quot;: {
19691 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
19692 # }
19693 # }
19694 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
19695 # is typically the registered service name of the tool or product that
19696 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
19697 # generated by some common infrastructure, the error domain must be a
19698 # globally unique value that identifies the infrastructure. For Google API
19699 # infrastructure, the error domain is &quot;googleapis.com&quot;.
19700 &quot;metadatas&quot;: { # Additional structured details about this error.
19701 #
19702 # Keys must match a regular expression of `a-z+` but should
19703 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
19704 # length. When identifying the current value of an exceeded limit, the units
19705 # should be contained in the key, not the value. For example, rather than
19706 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
19707 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
19708 # instances that can be created in a single (batch) request.
19709 &quot;a_key&quot;: &quot;A String&quot;,
19710 },
19711 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
19712 # proximate cause of the error. Error reasons are unique within a particular
19713 # domain of errors. This should be at most 63 characters and match a
19714 # regular expression of `A-Z+[A-Z0-9]`, which represents
19715 # UPPER_SNAKE_CASE.
19716 },
19717 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
19718 #
19719 # For example, if a quota check failed with an error indicating the calling
19720 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
19721 # directly to the right place in the developer console to flip the bit.
19722 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
19723 { # Describes a URL link.
19724 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
19725 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
19726 },
19727 ],
19728 },
19729 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
19730 # which can be attached to an RPC error.
19731 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
19732 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
19733 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
19734 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
19735 },
19736 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
19737 &quot;dimensions&quot;: { # The map holding related quota dimensions.
19738 &quot;a_key&quot;: &quot;A String&quot;,
19739 },
19740 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
19741 # type or metric.
19742 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
19743 # or metric.
19744 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
19745 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
19746 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
19747 },
19748 },
19749 ],
19750 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
19751 # This property is optional.
19752 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
19753 },
19754 ],
19755 },
19756 &quot;getVersionOperationMetadata&quot;: {
19757 &quot;inlineSbomInfo&quot;: {
19758 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
19759 # appropriate identifiers.
19760 &quot;a_key&quot;: &quot;A String&quot;,
19761 },
19762 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
19763 # identifiers.
19764 &quot;a_key&quot;: &quot;A String&quot;,
19765 },
19766 },
19767 },
19768 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
19769 # message that was returned, such as `NOT FOUND`.
19770 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
19771 # status code that was returned. For example, a `404` means the
19772 # resource was not found.
19773 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
19774 # defined by the server.
19775 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
19776 # This value is inRFC3339
19777 # text format.
19778 &quot;instancesBulkInsertOperationMetadata&quot;: {
19779 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
19780 # Example key: zones/us-central1-a
19781 &quot;a_key&quot;: {
19782 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
19783 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
19784 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
19785 # error.
19786 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
19787 # if the flow is rolling forward or rolling back.
19788 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
19789 },
19790 },
19791 },
19792 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
19793 # Operation resources.
19794 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
19795 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
19796 # group of operations results from a `bulkInsert` API request.
19797 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
19798 # `update`, or `delete`, and so on.
19799 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
19800 # There is no requirement that this be linear or support any granularity of
19801 # operations. This should not be used to guess when the operation will be
19802 # complete. This number should monotonically increase as the operation
19803 # progresses.
19804 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
19805 # applicable when performing regional operations.
19806 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
19807 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
19808 # this field will contain information on all underlying zonal actions and
19809 # their state.
19810 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
19811 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
19812 # Example key: zones/us-central1-a
19813 &quot;a_key&quot;: {
19814 &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
19815 # populated.
19816 # different programming environments, including REST APIs and RPC APIs. It is
19817 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
19818 # three pieces of data: error code, error message, and error details.
19819 #
19820 # You can find out more about this error model and how to work with it in the
19821 # [API Design Guide](https://cloud.google.com/apis/design/errors).
19822 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
19823 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
19824 # message types for APIs to use.
19825 {
19826 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
19827 },
19828 ],
19829 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
19830 # user-facing error message should be localized and sent in the
19831 # google.rpc.Status.details field, or localized by the client.
19832 },
19833 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
19834 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
19835 },
19836 },
19837 },
19838 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
19839 # This value is inRFC3339
19840 # text format.
19841 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
19842 # following:
19843 # `PENDING`, `RUNNING`, or `DONE`.
19844 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
19845 # operation.
19846 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
19847 # of the target resource.
19848 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
19849 # operations related to creating a snapshot, this points to the disk
19850 # that the snapshot was created from.
19851 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
19852 # `[email protected]` or
19853 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
19854 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
19855 # operation, this field will be populated.
19856 {
19857 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
19858 # Engine returns NO_RESULTS_ON_PAGE if there
19859 # are no results in the response.
19860 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
19861 # value format. For example:
19862 #
19863 # &quot;data&quot;: [
19864 # {
19865 # &quot;key&quot;: &quot;scope&quot;,
19866 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
19867 # }
19868 {
19869 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
19870 # returned. For example, for warnings where there are no results in a list
19871 # request for a particular zone, this key might be scope and
19872 # the key value might be the zone name. Other examples might be a key
19873 # indicating a deprecated resource and a suggested replacement, or a
19874 # warning about invalid network settings (for example, if an instance
19875 # attempts to perform IP forwarding but is not enabled for IP forwarding).
19876 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
19877 },
19878 ],
19879 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
19880 },
19881 ],
19882 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
19883 # applicable when performing per-zone operations.
19884 }</pre>
19885 </div>
19886
19887 <div class="method">
19888 <code class="details" id="testIamPermissions">testIamPermissions(project, resource, body=None, x__xgafv=None)</code>
19889 <pre>Returns permissions that a caller has on the specified resource.
19890
19891 Args:
19892 project: string, Project ID for this request. (required)
19893 resource: string, Name or id of the resource for this request. (required)
19894 body: object, The request body.
19895 The object takes the form of:
19896
19897 {
19898 &quot;permissions&quot;: [ # The set of permissions to check for the &#x27;resource&#x27;. Permissions with
19899 # wildcards (such as &#x27;*&#x27; or &#x27;storage.*&#x27;) are not allowed.
19900 &quot;A String&quot;,
19901 ],
19902 }
19903
19904 x__xgafv: string, V1 error format.
19905 Allowed values
19906 1 - v1 error format
19907 2 - v2 error format
19908
19909 Returns:
19910 An object of the form:
19911
19912 {
19913 &quot;permissions&quot;: [ # A subset of `TestPermissionsRequest.permissions` that the caller is
19914 # allowed.
19915 &quot;A String&quot;,
19916 ],
19917 }</pre>
19918 </div>
19919
19920 <div class="method">
19921 <code class="details" id="update">update(project, urlMap, body=None, requestId=None, x__xgafv=None)</code>
19922 <pre>Updates the specified UrlMap resource with the data included in the
19923 request.
19924
19925 Args:
19926 project: string, Project ID for this request. (required)
19927 urlMap: string, Name of the UrlMap resource to update. (required)
19928 body: object, The request body.
19929 The object takes the form of:
19930
19931 { # Represents a URL Map resource.
19932 #
19933 # Compute Engine has two URL Map resources:
19934 #
19935 # * [Global](/compute/docs/reference/rest/beta/urlMaps)
19936 # * [Regional](/compute/docs/reference/rest/beta/regionUrlMaps)
19937 #
19938 # A URL map resource is a component of certain types of cloud load balancers
19939 # and Traffic Director:
19940 #
19941 # * urlMaps are used by global external Application Load
19942 # Balancers, classic Application Load Balancers, and cross-region internal
19943 # Application Load Balancers.
19944 # * regionUrlMaps are used by internal Application Load Balancers,
19945 # regional external Application Load Balancers and regional internal
19946 # Application Load Balancers.
19947 #
19948 # For a list of supported URL map features by the load balancer type, see the
19949 # Load balancing features: Routing and traffic management table.
19950 #
19951 # For a list of supported URL map features for Traffic Director, see the
19952 # Traffic Director features: Routing and traffic management table.
19953 #
19954 # This resource defines mappings from hostnames and URL paths to either a
19955 # backend service or a backend bucket.
19956 #
19957 # To use the global urlMaps resource, the backend service must
19958 # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
19959 # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
19960 # information, read URL
19961 # Map Concepts.
19962 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
19963 # text format.
19964 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
19965 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
19966 #
19967 # This policy takes
19968 # effect at the load balancer level and applies only when no policy has been
19969 # defined for the error code at lower levels like PathMatcher, RouteRule and
19970 # PathRule within this UrlMap.
19971 #
19972 # For example, consider a UrlMap with the
19973 # following configuration:
19974 #
19975 #
19976 # - defaultCustomErrorResponsePolicy containing policies for
19977 # responding to 5xx and 4xx errors
19978 # - A PathMatcher configured for *.example.com has
19979 # defaultCustomErrorResponsePolicy for 4xx.
19980 #
19981 # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
19982 # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
19983 # a request that does not match any host in *.example.com such
19984 # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
19985 # takes effect.
19986 #
19987 # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
19988 # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
19989 # a retry, if load balancer is successful in reaching the
19990 # service, the defaultCustomErrorResponsePolicy is ignored and
19991 # the response from the service is returned to the client.
19992 #
19993 # defaultCustomErrorResponsePolicy is supported only for
19994 # global external Application Load Balancers.
19995 # backend service or backend bucket responds with an error.
19996 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
19997 #
19998 # In a given policy, if you specify rules for both a range of error codes
19999 # as well as rules for specific error codes then rules with specific error
20000 # codes have a higher priority. For example, assume that you configure a rule
20001 # for 401 (Un-authorized) code, and another for all 4 series
20002 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
20003 # However if the backend service returns a 403, the rule for4xx takes effect.
20004 { # Specifies the mapping between the response code that will be returned along
20005 # with the custom error content and the response code returned by the backend
20006 # service.
20007 &quot;matchResponseCodes&quot;: [ # Valid values include:
20008 #
20009 #
20010 # - A number between 400 and 599: For example
20011 # 401 or 503, in which case the load balancer
20012 # applies the policy if the error code exactly matches this value.
20013 # - 5xx: Load Balancer will apply the policy if the
20014 # backend service responds with any response code in the range of
20015 # 500 to 599.
20016 # - 4xx: Load
20017 # Balancer will apply the policy if the backend service responds with any
20018 # response code in the range of 400 to
20019 # 499.
20020 #
20021 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
20022 &quot;A String&quot;,
20023 ],
20024 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
20025 # error content. If overrideResponseCode is not supplied, the
20026 # same response code returned by the original backend bucket or backend
20027 # service is returned to the client.
20028 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
20029 #
20030 # path must start
20031 # with a leading slash. path cannot have trailing slashes.
20032 #
20033 # If the file is not available in backendBucket or the
20034 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
20035 #
20036 # The value must
20037 # be from 1 to 1024 characters
20038 },
20039 ],
20040 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
20041 # contains the custom error content. Examples are:
20042 #
20043 #
20044 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
20045 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
20046 # - global/backendBuckets/myBackendBucket
20047 #
20048 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
20049 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
20050 #
20051 # If load balancer cannot reach
20052 # the backendBucket, a simple Not Found Error will
20053 # be returned, with the original response code (oroverrideResponseCode if configured).
20054 #
20055 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
20056 },
20057 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
20058 # hostRules match. The load balancer performs advanced routing
20059 # actions, such as URL rewrites and header transformations, before forwarding
20060 # the request to the selected backend.
20061 #
20062 #
20063 # Only one of defaultUrlRedirect, defaultService
20064 # or defaultRouteAction.weightedBackendService can be set.
20065 #
20066 #
20067 # URL maps for classic Application Load Balancers only support
20068 # the urlRewrite action within defaultRouteAction.
20069 #
20070 #
20071 # defaultRouteAction has no effect when the URL map is bound
20072 # to a target gRPC proxy that has the validateForProxyless field
20073 # set to true.
20074 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
20075 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
20076 # property must be specified. This policy cannot be specified if any target
20077 # backend has Identity-Aware Proxy enabled.
20078 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
20079 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
20080 # header names can be specified. The cache is bypassed for all `cacheMode`
20081 # values.
20082 &quot;A String&quot;,
20083 ],
20084 &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
20085 # on the backend type: for Backend Services, the complete request URI is
20086 # used; for Backend Buckets, the request URI is used without the protocol or
20087 # host, and only query parameters known to Cloud Storage are included.
20088 # Policy defined on Route Action.
20089 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
20090 # parameters will be included. Either specify `excludedQueryParameters`
20091 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
20092 # encoded and not treated as delimiters.
20093 #
20094 # Note: This field applies to routes that use backend services. Attempting
20095 # to set it on a route that points exclusively to Backend Buckets will
20096 # result in a configuration error. For routes that point to a Backend
20097 # Bucket, use `includedQueryParameters` to define which parameters should
20098 # be part of the cache key.
20099 &quot;A String&quot;,
20100 ],
20101 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
20102 #
20103 # Note: This setting is only applicable to routes that use a Backend
20104 # Service. It does not affect requests served by a Backend Bucket, as the
20105 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
20106 # it on a route that points exclusively to Backend Buckets will result in a
20107 # configuration error.
20108 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
20109 #
20110 # Note: This setting is only applicable to routes that use a Backend
20111 # Service. It does not affect requests served by a Backend Bucket, as the
20112 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
20113 # set on a route that points exclusively to Backend Buckets will result in
20114 # a configuration error.
20115 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
20116 # `includedQueryParameters` and `excludedQueryParameters`. If neither
20117 # is set, the entire query string will be included. If false, the query
20118 # string will be excluded from the cache key entirely.
20119 #
20120 # Note: This field applies to routes that use backend services. Attempting
20121 # to set it on a route that points exclusively to Backend Buckets will
20122 # result in a configuration error. For routes that point to a Backend
20123 # Bucket, use `includedQueryParameters` to define which parameters should
20124 # be part of the cache key.
20125 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
20126 # The name=value pair will be used in the cache key Cloud CDN generates.
20127 #
20128 # Note: This setting is only applicable to routes that use a Backend
20129 # Service. It does not affect requests served by a Backend Bucket.
20130 # Attempting to set it on a route that points exclusively to Backend
20131 # Buckets will result in a configuration error. Up to 5 cookie names can be
20132 # specified.
20133 &quot;A String&quot;,
20134 ],
20135 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
20136 &quot;A String&quot;,
20137 ],
20138 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
20139 # parameters will be excluded. Either specify `includedQueryParameters`
20140 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
20141 # encoded and not treated as delimiters.
20142 &quot;A String&quot;,
20143 ],
20144 },
20145 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
20146 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
20147 &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
20148 # content. This is used to clamp the max-age (or Expires) value sent to the
20149 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
20150 # is used for the response max-age directive, along with a &quot;public&quot;
20151 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
20152 # clamps the max-age from the origin (if specified), or else sets the
20153 # response max-age directive to the lesser of the `clientTtl` and
20154 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
20155 # present. The maximum allowed value is 31,622,400s (1 year). If not
20156 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
20157 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
20158 # `USE_ORIGIN_HEADERS`.
20159 # as a count of seconds and fractions of seconds at nanosecond
20160 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
20161 # or &quot;month&quot;. Range is approximately 10,000 years.
20162 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
20163 # Durations less than one second are represented with a 0
20164 # `seconds` field and a positive `nanos` field. Must be from 0
20165 # to 999,999,999 inclusive.
20166 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
20167 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
20168 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
20169 },
20170 &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
20171 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
20172 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
20173 # greater than that of `maxTtl`. When the `cacheMode` is set to
20174 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
20175 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
20176 # accessed objects may be evicted from the cache before the defined TTL. If
20177 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
20178 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
20179 # `USE_ORIGIN_HEADERS`.
20180 # as a count of seconds and fractions of seconds at nanosecond
20181 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
20182 # or &quot;month&quot;. Range is approximately 10,000 years.
20183 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
20184 # Durations less than one second are represented with a 0
20185 # `seconds` field and a positive `nanos` field. Must be from 0
20186 # to 999,999,999 inclusive.
20187 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
20188 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
20189 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
20190 },
20191 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
20192 # attempt to set a max-age or s-maxage higher than this, or an Expires header
20193 # more than `maxTtl` seconds in the future will be capped at the value of
20194 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
20195 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
20196 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
20197 # Infrequently accessed objects may be evicted from the cache before the
20198 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
20199 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
20200 # mode.
20201 # as a count of seconds and fractions of seconds at nanosecond
20202 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
20203 # or &quot;month&quot;. Range is approximately 10,000 years.
20204 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
20205 # Durations less than one second are represented with a 0
20206 # `seconds` field and a positive `nanos` field. Must be from 0
20207 # to 999,999,999 inclusive.
20208 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
20209 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
20210 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
20211 },
20212 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
20213 # to apply fine-grained caching for common errors or redirects.
20214 # This can reduce the load on your origin and improve end-user
20215 # experience by reducing response latency.
20216 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
20217 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
20218 # the specified response code that lack any Cache-Control, Expires, or
20219 # Pragma: no-cache directives. When the `cacheMode` is set to
20220 # `FORCE_CACHE_ALL`, negative caching applies to all responses
20221 # with the specified response code, and overrides any caching headers. By
20222 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
20223 #
20224 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
20225 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
20226 # * 405 (Method Not Found), 501 (Not Implemented): 60s
20227 #
20228 # These defaults can be overridden in `negativeCachingPolicy`.
20229 # If not specified, Cloud CDN applies negative caching by default.
20230 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
20231 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
20232 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
20233 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
20234 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
20235 # all response codes that you wish to cache. Cloud CDN will not apply any
20236 # default negative caching when a policy exists.
20237 { # Specify CDN TTLs for response error codes.
20238 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
20239 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
20240 # specified as values, and you cannot specify a status code more than
20241 # once.
20242 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
20243 # corresponding status code.
20244 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
20245 # objects may be evicted from the cache before the defined TTL.
20246 # as a count of seconds and fractions of seconds at nanosecond
20247 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
20248 # or &quot;month&quot;. Range is approximately 10,000 years.
20249 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
20250 # Durations less than one second are represented with a 0
20251 # `seconds` field and a positive `nanos` field. Must be from 0
20252 # to 999,999,999 inclusive.
20253 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
20254 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
20255 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
20256 },
20257 },
20258 ],
20259 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
20260 # requests into a small number of requests to the origin. If not specified,
20261 # Cloud CDN applies request coalescing by default.
20262 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
20263 # content with the origin, or when an error is encountered when refreshing
20264 # the cache.
20265 # This setting defines the default &quot;max-stale&quot; duration for any cached
20266 # responses that do not specify a max-stale directive. Stale responses that
20267 # exceed the TTL configured here will not be served. The default limit
20268 # (max-stale) is 86400s (1 day), which will allow stale content to be
20269 # served up to this limit beyond the max-age (or s-maxage) of a cached
20270 # response.
20271 # The maximum allowed value is 604800 (1 week).
20272 # Set this to zero (0) to disable serve-while-stale.
20273 # as a count of seconds and fractions of seconds at nanosecond
20274 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
20275 # or &quot;month&quot;. Range is approximately 10,000 years.
20276 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
20277 # Durations less than one second are represented with a 0
20278 # `seconds` field and a positive `nanos` field. Must be from 0
20279 # to 999,999,999 inclusive.
20280 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
20281 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
20282 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
20283 },
20284 },
20285 &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
20286 # information about the W3C recommendation for cross-origin resource sharing
20287 # (CORS), see Fetch API Living
20288 # Standard.
20289 #
20290 # Not supported when the URL map is bound to a target gRPC proxy.
20291 # information about the W3C recommendation for cross-origin resource sharing
20292 # (CORS), see Fetch API Living
20293 # Standard.
20294 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
20295 # indicates that
20296 # the actual request can include user credentials. This field translates to
20297 # the Access-Control-Allow-Credentials header.
20298 #
20299 # Default is false.
20300 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
20301 # header.
20302 &quot;A String&quot;,
20303 ],
20304 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
20305 # header.
20306 &quot;A String&quot;,
20307 ],
20308 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
20309 # more information, see regular expression syntax.
20310 #
20311 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
20312 #
20313 # Regular expressions can only be used when the loadBalancingScheme is
20314 # set to INTERNAL_SELF_MANAGED.
20315 &quot;A String&quot;,
20316 ],
20317 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
20318 #
20319 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
20320 &quot;A String&quot;,
20321 ],
20322 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
20323 # The default value is false, which indicates that the CORS
20324 # policy is in effect.
20325 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
20326 # header.
20327 &quot;A String&quot;,
20328 ],
20329 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
20330 # seconds. This field translates to the Access-Control-Max-Age
20331 # header.
20332 },
20333 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
20334 # the resiliency of clients to backend service failure. As part of fault
20335 # injection, when clients send requests to a backend service, delays can be
20336 # introduced by a load balancer on a percentage of requests before sending
20337 # those requests to the backend service. Similarly requests from clients can
20338 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
20339 # that are configured with a fault_injection_policy if:
20340 # 1. The traffic is generated by fault injection AND
20341 # 2. The fault injection is not a delay fault injection.
20342 # Fault injection is not supported with the classic Application Load Balancer
20343 # . To see which load balancers support fault injection,
20344 # see Load
20345 # balancing: Routing and traffic management features.
20346 # the resiliency of clients to backend service failure. As part of fault
20347 # injection, when clients send requests to a backend service, delays can be
20348 # introduced by the load balancer on a percentage of requests before sending
20349 # those request to the backend service. Similarly requests from clients can be
20350 # aborted by the load balancer for a percentage of requests.
20351 &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
20352 # injection.
20353 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
20354 #
20355 # The value must be from 200 to 599 inclusive.
20356 #
20357 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
20358 # according to this
20359 # mapping table. HTTP status 200 is mapped to gRPC status
20360 # UNKNOWN. Injecting an OK status is currently not supported by
20361 # Traffic Director.
20362 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
20363 # that is aborted as part of fault injection.
20364 #
20365 # The value must be from 0.0 to 100.0 inclusive.
20366 },
20367 &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
20368 # injection, before being sent to a backend service.
20369 # request to the backend service as part of fault injection.
20370 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
20371 # as a count of seconds and fractions of seconds at nanosecond
20372 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
20373 # or &quot;month&quot;. Range is approximately 10,000 years.
20374 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
20375 # Durations less than one second are represented with a 0
20376 # `seconds` field and a positive `nanos` field. Must be from 0
20377 # to 999,999,999 inclusive.
20378 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
20379 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
20380 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
20381 },
20382 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
20383 # which a delay is introduced as part of fault injection.
20384 #
20385 # The value must be from 0.0 to 100.0 inclusive.
20386 },
20387 },
20388 &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
20389 # Global EXTERNAL_MANAGED load balancer schemes.
20390 # Either Cloud CDN must be enabled on the backend service or backend bucket
20391 # serving the route, or cache policy must be configured on the same route
20392 # dynamically processes and delivers images from the network edge.
20393 # Image Optimization is only available for Global External Application Load
20394 # Balancers.
20395 # Either Cloud CDN must be enabled on the backend service or backend bucket
20396 # serving the route, or cache policy must be configured on the same route.
20397 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
20398 },
20399 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
20400 # Unlike the timeout field where the timeout duration starts
20401 # from the time the request has been fully processed (known as*end-of-stream*),
20402 # the duration in this field is computed from the beginning of the stream
20403 # until the response has been processed, including all retries. A
20404 # stream that does not complete in this duration is closed.
20405 #
20406 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
20407 # with the route.
20408 #
20409 # This field is only allowed if the Url map is used with backend services
20410 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
20411 # as a count of seconds and fractions of seconds at nanosecond
20412 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
20413 # or &quot;month&quot;. Range is approximately 10,000 years.
20414 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
20415 # Durations less than one second are represented with a 0
20416 # `seconds` field and a positive `nanos` field. Must be from 0
20417 # to 999,999,999 inclusive.
20418 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
20419 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
20420 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
20421 },
20422 &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
20423 # are shadowed to a separate mirrored backend service. The load balancer does
20424 # not wait for responses from the shadow service. Before sending traffic
20425 # to the shadow service, the host / authority header is suffixed with-shadow.
20426 #
20427 # Not supported when the URL map is bound to a target gRPC proxy that
20428 # has the validateForProxyless field set to true.
20429 # are shadowed to a separate mirrored backend service. The load balancer
20430 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
20431 # to the shadow service, the host or authority header is suffixed with-shadow.
20432 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
20433 # mirrored to.
20434 #
20435 # The backend service configured for a mirroring
20436 # policy must reference backends that are of the same type as the original
20437 # backend service matched in the URL map.
20438 #
20439 # Serverless NEG backends are not currently supported as a mirrored
20440 # backend service.
20441 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
20442 },
20443 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
20444 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
20445 # If not specified, defaults to 1.
20446 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
20447 #
20448 # If not specified, will use the timeout set in theHttpRouteAction field.
20449 # If timeout in the HttpRouteAction field is not set, this field
20450 # uses the largest timeout
20451 # among all backend services associated with the route.
20452 #
20453 # Not supported when the URL map is bound to a target gRPC proxy that
20454 # has the validateForProxyless field set to true.
20455 # as a count of seconds and fractions of seconds at nanosecond
20456 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
20457 # or &quot;month&quot;. Range is approximately 10,000 years.
20458 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
20459 # Durations less than one second are represented with a 0
20460 # `seconds` field and a positive `nanos` field. Must be from 0
20461 # to 999,999,999 inclusive.
20462 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
20463 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
20464 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
20465 },
20466 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
20467 # values are:
20468 #
20469 # - 5xx: retry is attempted if the instance or endpoint
20470 # responds with any 5xx response code, or if the instance or
20471 # endpoint does not respond at all. For example, disconnects, reset, read
20472 # timeout, connection failure, and refused streams.
20473 # - gateway-error: Similar to 5xx, but only
20474 # applies to response codes 502, 503 or504.
20475 # - connect-failure: a retry is attempted on failures
20476 # connecting to the instance or endpoint. For example, connection
20477 # timeouts.
20478 # - retriable-4xx: a retry is attempted if the instance
20479 # or endpoint responds with a 4xx response code.
20480 # The only error that you can retry is error code 409.
20481 # - refused-stream: a retry is attempted if the instance
20482 # or endpoint resets the stream with a REFUSED_STREAM error
20483 # code. This reset type indicates that it is safe to retry.
20484 # - cancelled: a retry is attempted if the gRPC status
20485 # code in the response header is set to cancelled.
20486 # - deadline-exceeded: a retry is attempted if the gRPC
20487 # status code in the response header is set todeadline-exceeded.
20488 # - internal: a retry is attempted if the gRPC
20489 # status code in the response header is set tointernal.
20490 # - resource-exhausted: a retry is attempted if the gRPC
20491 # status code in the response header is set toresource-exhausted.
20492 # - unavailable: a retry is attempted if the gRPC
20493 # status code in the response header is set tounavailable.
20494 #
20495 # Only the following codes are supported when the URL map is bound to
20496 # target gRPC proxy that has validateForProxyless field set to true.
20497 #
20498 # - cancelled
20499 # - deadline-exceeded
20500 # - internal
20501 # - resource-exhausted
20502 # - unavailable
20503 &quot;A String&quot;,
20504 ],
20505 },
20506 &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
20507 # time the request has been fully processed (known as *end-of-stream*)
20508 # up until the response has been processed. Timeout includes
20509 # all retries.
20510 #
20511 # If not specified, this field uses the largest timeout among all backend
20512 # services associated with the route.
20513 #
20514 # Not supported when the URL map is bound to a target gRPC proxy that
20515 # has validateForProxyless field set to true.
20516 # as a count of seconds and fractions of seconds at nanosecond
20517 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
20518 # or &quot;month&quot;. Range is approximately 10,000 years.
20519 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
20520 # Durations less than one second are represented with a 0
20521 # `seconds` field and a positive `nanos` field. Must be from 0
20522 # to 999,999,999 inclusive.
20523 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
20524 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
20525 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
20526 },
20527 &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
20528 # to the matched service.
20529 #
20530 # urlRewrite is the only action supported in UrlMaps
20531 # for classic Application Load Balancers.
20532 #
20533 # Not supported when the URL map is bound to a target gRPC proxy that
20534 # has the validateForProxyless field set to true.
20535 # backend service.
20536 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
20537 # host header is replaced with contents of hostRewrite.
20538 #
20539 # The value must be from 1 to 255 characters.
20540 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
20541 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
20542 #
20543 # The value must be from 1 to 1024 characters.
20544 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
20545 # header) using the HTTP template syntax.
20546 #
20547 # A corresponding
20548 # path_template_match must be specified. Any template variables must exist in
20549 # the path_template_match field.
20550 #
20551 #
20552 # - -At least one variable must be specified in the path_template_match
20553 # field
20554 # - You can omit variables from the rewritten URL
20555 # - The * and ** operators cannot be matched
20556 # unless they have a corresponding variable name - e.g.
20557 # {format=*} or {var=**}.
20558 #
20559 # For example, a path_template_match of /static/{format=**}
20560 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
20561 # rewrite, so that /{country}/{format}/{suffix=**} can be
20562 # rewritten as /content/{format}/{country}/{suffix}.
20563 #
20564 # At least
20565 # one non-empty routeRules[].matchRules[].path_template_match is
20566 # required.
20567 #
20568 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
20569 },
20570 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
20571 # occurs. The weights determine the fraction of traffic that flows to
20572 # their corresponding backend service. If all traffic needs to
20573 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
20574 #
20575 # After a backend service is identified and before forwarding
20576 # the request to
20577 # the backend service, advanced routing actions such as URL rewrites and
20578 # header transformations are applied depending on additional settings
20579 # specified in this HttpRouteAction.
20580 { # In contrast to a single BackendService in
20581 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
20582 # multiple backend services. The volume of traffic for each
20583 # backend service is proportional to the weight specified
20584 # in each WeightedBackendService
20585 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
20586 # resource. Before
20587 # forwarding the request to backendService, the load balancer
20588 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
20589 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
20590 # effect for the selected backendService.
20591 #
20592 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
20593 #
20594 # headerAction is not supported for load balancers that have
20595 # their loadBalancingScheme set to EXTERNAL.
20596 #
20597 # Not supported when the URL map is bound to a target gRPC proxy that
20598 # has validateForProxyless field set to true.
20599 # the request is passed along to the selected backendService.
20600 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
20601 { # Specification determining how headers are added to requests or responses.
20602 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
20603 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
20604 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
20605 # that already
20606 # exist for the header. If true, headerValue is set for the
20607 # header, discarding any values that were set for that header.
20608 #
20609 # The default value is true,
20610 # unless a variable is present in headerValue,
20611 # in which case the default value is false.
20612 # .
20613 },
20614 ],
20615 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
20616 # request before forwarding the request to the backendService.
20617 &quot;A String&quot;,
20618 ],
20619 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
20620 # client.
20621 { # Specification determining how headers are added to requests or responses.
20622 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
20623 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
20624 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
20625 # that already
20626 # exist for the header. If true, headerValue is set for the
20627 # header, discarding any values that were set for that header.
20628 #
20629 # The default value is true,
20630 # unless a variable is present in headerValue,
20631 # in which case the default value is false.
20632 # .
20633 },
20634 ],
20635 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
20636 # response before sending the response back to the client.
20637 &quot;A String&quot;,
20638 ],
20639 },
20640 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
20641 # computed asweight / (sum of all weightedBackendService weights in routeAction).
20642 #
20643 # The selection of a backend service is determined only for new traffic.
20644 # Once a user&#x27;s request has been directed to a backend service,
20645 # subsequent requests are sent to the same backend service as
20646 # determined by the backend service&#x27;s session affinity policy.
20647 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
20648 # splitting. If you do, the weighted traffic splitting configuration takes
20649 # precedence.
20650 #
20651 # The value must be from 0 to 1000.
20652 },
20653 ],
20654 },
20655 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL of the defaultService resource to
20656 # which traffic is directed if none of the hostRules match.
20657 # If defaultRouteAction is also specified, advanced
20658 # routing actions, such as URL rewrites, take effect before sending the
20659 # request to the backend.
20660 #
20661 #
20662 # Only one of defaultUrlRedirect, defaultService
20663 # or defaultRouteAction.weightedBackendService can be set.
20664 #
20665 #
20666 # defaultService has no effect when the URL map is bound
20667 # to a target gRPC proxy that has the validateForProxyless field
20668 # set to true.
20669 &quot;defaultUrlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
20670 # is redirected to a URL specified by defaultUrlRedirect.
20671 #
20672 #
20673 # Only one of defaultUrlRedirect, defaultService
20674 # or defaultRouteAction.weightedBackendService can be set.
20675 #
20676 #
20677 # Not supported when the URL map is bound to a target gRPC proxy.
20678 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
20679 # was supplied in the request.
20680 #
20681 # The value must be from 1 to 255
20682 # characters.
20683 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
20684 # set to HTTPS.
20685 # If set to false, the URL scheme of the redirected request
20686 # remains the same as that of the request.
20687 #
20688 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
20689 #
20690 # The default is set to false.
20691 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
20692 # that was supplied in the request.
20693 #
20694 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
20695 # supplied, the path of the original request is used for the redirect.
20696 #
20697 # The value must be from 1 to 1024 characters.
20698 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
20699 # the HttpRouteRuleMatch, retaining the remaining portion
20700 # of the URL before redirecting the request.
20701 #
20702 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
20703 # supplied, the path of the original request is used for the redirect.
20704 #
20705 # The value must be from 1 to 1024 characters.
20706 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
20707 #
20708 # Supported values are:
20709 #
20710 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
20711 # to 301.
20712 # - FOUND, which corresponds to 302.
20713 # - SEE_OTHER which corresponds to 303.
20714 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
20715 # method is retained.
20716 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
20717 # method is retained.
20718 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
20719 # URL is
20720 # removed before redirecting the request. If set to false, the
20721 # query portion of the original URL is retained.
20722 #
20723 # The default is set to false.
20724 },
20725 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
20726 # create the resource.
20727 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. A hash of the contents stored in this object.
20728 # This field is used in optimistic locking. This field is ignored when
20729 # inserting a UrlMap. An up-to-date fingerprint must be provided
20730 # in order to update the UrlMap, otherwise the request will
20731 # fail with error 412 conditionNotMet.
20732 #
20733 # To see the latest fingerprint, make a get() request to
20734 # retrieve a UrlMap.
20735 &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
20736 # for the selected backendService.
20737 #
20738 # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
20739 #
20740 # headerAction is not supported for load balancers
20741 # that have
20742 # their loadBalancingScheme set to EXTERNAL.
20743 #
20744 # Not supported when the URL map is bound to a target gRPC proxy that
20745 # has validateForProxyless field set to true.
20746 # the request is passed along to the selected backendService.
20747 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
20748 { # Specification determining how headers are added to requests or responses.
20749 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
20750 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
20751 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
20752 # that already
20753 # exist for the header. If true, headerValue is set for the
20754 # header, discarding any values that were set for that header.
20755 #
20756 # The default value is true,
20757 # unless a variable is present in headerValue,
20758 # in which case the default value is false.
20759 # .
20760 },
20761 ],
20762 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
20763 # request before forwarding the request to the backendService.
20764 &quot;A String&quot;,
20765 ],
20766 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
20767 # client.
20768 { # Specification determining how headers are added to requests or responses.
20769 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
20770 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
20771 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
20772 # that already
20773 # exist for the header. If true, headerValue is set for the
20774 # header, discarding any values that were set for that header.
20775 #
20776 # The default value is true,
20777 # unless a variable is present in headerValue,
20778 # in which case the default value is false.
20779 # .
20780 },
20781 ],
20782 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
20783 # response before sending the response back to the client.
20784 &quot;A String&quot;,
20785 ],
20786 },
20787 &quot;hostRules&quot;: [ # The list of host rules to use against the URL.
20788 { # UrlMaps
20789 # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
20790 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
20791 # create the resource.
20792 &quot;hosts&quot;: [ # The list of host patterns to match. They must be valid hostnames with
20793 # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
20794 # that case, * must be the first character, and if followed by
20795 # anything, the immediate following character must be either -
20796 # or ..
20797 #
20798 # * based matching is not supported when the URL map is bound
20799 # to a target gRPC proxy that has the validateForProxyless field
20800 # set to true.
20801 &quot;A String&quot;,
20802 ],
20803 &quot;pathMatcher&quot;: &quot;A String&quot;, # The name of the PathMatcher to use to match the path portion
20804 # of the URL if the hostRule matches the URL&#x27;s host portion.
20805 },
20806 ],
20807 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the resource. This identifier is
20808 # defined by the server.
20809 &quot;kind&quot;: &quot;compute#urlMap&quot;, # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
20810 # url maps.
20811 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
20812 # The name must be 1-63 characters long, and comply withRFC1035.
20813 # Specifically, the name must be 1-63 characters long and match the regular
20814 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
20815 # character must be a lowercase letter, and all following characters must
20816 # be a dash, lowercase letter, or digit, except the last character, which
20817 # cannot be a dash.
20818 &quot;pathMatchers&quot;: [ # The list of named PathMatchers to use against the URL.
20819 { # A matcher for the path portion of the URL. The BackendService
20820 # from the longest-matched rule will serve the URL. If no rule was matched, the
20821 # default service is used.
20822 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
20823 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
20824 #
20825 # This policy takes
20826 # effect at the PathMatcher level and applies only when no
20827 # 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
20828 # in defaultCustomErrorResponsePolicy, then a policy defined for
20829 # the error code in UrlMap.defaultCustomErrorResponsePolicy
20830 # takes effect.
20831 #
20832 # For example, consider a UrlMap with the following
20833 # configuration:
20834 #
20835 #
20836 # - UrlMap.defaultCustomErrorResponsePolicy is configured
20837 # with policies for 5xx and 4xx errors
20838 # - A RouteRule for /coming_soon/ is configured for the
20839 # error code 404.
20840 #
20841 # 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
20842 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
20843 # the policy in RouteRule.customErrorResponsePolicy takes
20844 # effect. If any of the requests in this example encounter a 500
20845 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
20846 #
20847 # When
20848 # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
20849 # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
20850 # a retry, if load balancer is successful in reaching the
20851 # service, the defaultCustomErrorResponsePolicy is ignored and
20852 # the response from the service is returned to the client.
20853 #
20854 # defaultCustomErrorResponsePolicy is supported only for
20855 # global external Application Load Balancers.
20856 # backend service or backend bucket responds with an error.
20857 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
20858 #
20859 # In a given policy, if you specify rules for both a range of error codes
20860 # as well as rules for specific error codes then rules with specific error
20861 # codes have a higher priority. For example, assume that you configure a rule
20862 # for 401 (Un-authorized) code, and another for all 4 series
20863 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
20864 # However if the backend service returns a 403, the rule for4xx takes effect.
20865 { # Specifies the mapping between the response code that will be returned along
20866 # with the custom error content and the response code returned by the backend
20867 # service.
20868 &quot;matchResponseCodes&quot;: [ # Valid values include:
20869 #
20870 #
20871 # - A number between 400 and 599: For example
20872 # 401 or 503, in which case the load balancer
20873 # applies the policy if the error code exactly matches this value.
20874 # - 5xx: Load Balancer will apply the policy if the
20875 # backend service responds with any response code in the range of
20876 # 500 to 599.
20877 # - 4xx: Load
20878 # Balancer will apply the policy if the backend service responds with any
20879 # response code in the range of 400 to
20880 # 499.
20881 #
20882 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
20883 &quot;A String&quot;,
20884 ],
20885 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
20886 # error content. If overrideResponseCode is not supplied, the
20887 # same response code returned by the original backend bucket or backend
20888 # service is returned to the client.
20889 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
20890 #
20891 # path must start
20892 # with a leading slash. path cannot have trailing slashes.
20893 #
20894 # If the file is not available in backendBucket or the
20895 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
20896 #
20897 # The value must
20898 # be from 1 to 1024 characters
20899 },
20900 ],
20901 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
20902 # contains the custom error content. Examples are:
20903 #
20904 #
20905 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
20906 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
20907 # - global/backendBuckets/myBackendBucket
20908 #
20909 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
20910 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
20911 #
20912 # If load balancer cannot reach
20913 # the backendBucket, a simple Not Found Error will
20914 # be returned, with the original response code (oroverrideResponseCode if configured).
20915 #
20916 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
20917 },
20918 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
20919 # pathRules or routeRules match. The load balancer
20920 # performs advanced routing actions, such as URL rewrites and
20921 # header transformations, before forwarding the request to the
20922 # selected backend.
20923 #
20924 #
20925 # Only one of defaultUrlRedirect, defaultService
20926 # or defaultRouteAction.weightedBackendService can be set.
20927 #
20928 #
20929 # URL maps for classic Application Load Balancers only support
20930 # the urlRewrite action within a path matcher&#x27;sdefaultRouteAction.
20931 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
20932 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
20933 # property must be specified. This policy cannot be specified if any target
20934 # backend has Identity-Aware Proxy enabled.
20935 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
20936 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
20937 # header names can be specified. The cache is bypassed for all `cacheMode`
20938 # values.
20939 &quot;A String&quot;,
20940 ],
20941 &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
20942 # on the backend type: for Backend Services, the complete request URI is
20943 # used; for Backend Buckets, the request URI is used without the protocol or
20944 # host, and only query parameters known to Cloud Storage are included.
20945 # Policy defined on Route Action.
20946 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
20947 # parameters will be included. Either specify `excludedQueryParameters`
20948 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
20949 # encoded and not treated as delimiters.
20950 #
20951 # Note: This field applies to routes that use backend services. Attempting
20952 # to set it on a route that points exclusively to Backend Buckets will
20953 # result in a configuration error. For routes that point to a Backend
20954 # Bucket, use `includedQueryParameters` to define which parameters should
20955 # be part of the cache key.
20956 &quot;A String&quot;,
20957 ],
20958 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
20959 #
20960 # Note: This setting is only applicable to routes that use a Backend
20961 # Service. It does not affect requests served by a Backend Bucket, as the
20962 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
20963 # it on a route that points exclusively to Backend Buckets will result in a
20964 # configuration error.
20965 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
20966 #
20967 # Note: This setting is only applicable to routes that use a Backend
20968 # Service. It does not affect requests served by a Backend Bucket, as the
20969 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
20970 # set on a route that points exclusively to Backend Buckets will result in
20971 # a configuration error.
20972 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
20973 # `includedQueryParameters` and `excludedQueryParameters`. If neither
20974 # is set, the entire query string will be included. If false, the query
20975 # string will be excluded from the cache key entirely.
20976 #
20977 # Note: This field applies to routes that use backend services. Attempting
20978 # to set it on a route that points exclusively to Backend Buckets will
20979 # result in a configuration error. For routes that point to a Backend
20980 # Bucket, use `includedQueryParameters` to define which parameters should
20981 # be part of the cache key.
20982 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
20983 # The name=value pair will be used in the cache key Cloud CDN generates.
20984 #
20985 # Note: This setting is only applicable to routes that use a Backend
20986 # Service. It does not affect requests served by a Backend Bucket.
20987 # Attempting to set it on a route that points exclusively to Backend
20988 # Buckets will result in a configuration error. Up to 5 cookie names can be
20989 # specified.
20990 &quot;A String&quot;,
20991 ],
20992 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
20993 &quot;A String&quot;,
20994 ],
20995 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
20996 # parameters will be excluded. Either specify `includedQueryParameters`
20997 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
20998 # encoded and not treated as delimiters.
20999 &quot;A String&quot;,
21000 ],
21001 },
21002 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
21003 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
21004 &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
21005 # content. This is used to clamp the max-age (or Expires) value sent to the
21006 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
21007 # is used for the response max-age directive, along with a &quot;public&quot;
21008 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
21009 # clamps the max-age from the origin (if specified), or else sets the
21010 # response max-age directive to the lesser of the `clientTtl` and
21011 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
21012 # present. The maximum allowed value is 31,622,400s (1 year). If not
21013 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
21014 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
21015 # `USE_ORIGIN_HEADERS`.
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;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
21028 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
21029 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
21030 # greater than that of `maxTtl`. When the `cacheMode` is set to
21031 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
21032 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
21033 # accessed objects may be evicted from the cache before the defined TTL. If
21034 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
21035 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
21036 # `USE_ORIGIN_HEADERS`.
21037 # as a count of seconds and fractions of seconds at nanosecond
21038 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21039 # or &quot;month&quot;. Range is approximately 10,000 years.
21040 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21041 # Durations less than one second are represented with a 0
21042 # `seconds` field and a positive `nanos` field. Must be from 0
21043 # to 999,999,999 inclusive.
21044 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21045 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21046 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21047 },
21048 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
21049 # attempt to set a max-age or s-maxage higher than this, or an Expires header
21050 # more than `maxTtl` seconds in the future will be capped at the value of
21051 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
21052 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
21053 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
21054 # Infrequently accessed objects may be evicted from the cache before the
21055 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
21056 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
21057 # mode.
21058 # as a count of seconds and fractions of seconds at nanosecond
21059 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21060 # or &quot;month&quot;. Range is approximately 10,000 years.
21061 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21062 # Durations less than one second are represented with a 0
21063 # `seconds` field and a positive `nanos` field. Must be from 0
21064 # to 999,999,999 inclusive.
21065 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21066 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21067 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21068 },
21069 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
21070 # to apply fine-grained caching for common errors or redirects.
21071 # This can reduce the load on your origin and improve end-user
21072 # experience by reducing response latency.
21073 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
21074 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
21075 # the specified response code that lack any Cache-Control, Expires, or
21076 # Pragma: no-cache directives. When the `cacheMode` is set to
21077 # `FORCE_CACHE_ALL`, negative caching applies to all responses
21078 # with the specified response code, and overrides any caching headers. By
21079 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
21080 #
21081 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
21082 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
21083 # * 405 (Method Not Found), 501 (Not Implemented): 60s
21084 #
21085 # These defaults can be overridden in `negativeCachingPolicy`.
21086 # If not specified, Cloud CDN applies negative caching by default.
21087 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
21088 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
21089 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
21090 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
21091 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
21092 # all response codes that you wish to cache. Cloud CDN will not apply any
21093 # default negative caching when a policy exists.
21094 { # Specify CDN TTLs for response error codes.
21095 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
21096 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
21097 # specified as values, and you cannot specify a status code more than
21098 # once.
21099 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
21100 # corresponding status code.
21101 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
21102 # objects may be evicted from the cache before the defined TTL.
21103 # as a count of seconds and fractions of seconds at nanosecond
21104 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21105 # or &quot;month&quot;. Range is approximately 10,000 years.
21106 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21107 # Durations less than one second are represented with a 0
21108 # `seconds` field and a positive `nanos` field. Must be from 0
21109 # to 999,999,999 inclusive.
21110 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21111 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21112 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21113 },
21114 },
21115 ],
21116 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
21117 # requests into a small number of requests to the origin. If not specified,
21118 # Cloud CDN applies request coalescing by default.
21119 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
21120 # content with the origin, or when an error is encountered when refreshing
21121 # the cache.
21122 # This setting defines the default &quot;max-stale&quot; duration for any cached
21123 # responses that do not specify a max-stale directive. Stale responses that
21124 # exceed the TTL configured here will not be served. The default limit
21125 # (max-stale) is 86400s (1 day), which will allow stale content to be
21126 # served up to this limit beyond the max-age (or s-maxage) of a cached
21127 # response.
21128 # The maximum allowed value is 604800 (1 week).
21129 # Set this to zero (0) to disable serve-while-stale.
21130 # as a count of seconds and fractions of seconds at nanosecond
21131 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21132 # or &quot;month&quot;. Range is approximately 10,000 years.
21133 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21134 # Durations less than one second are represented with a 0
21135 # `seconds` field and a positive `nanos` field. Must be from 0
21136 # to 999,999,999 inclusive.
21137 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21138 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21139 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21140 },
21141 },
21142 &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
21143 # information about the W3C recommendation for cross-origin resource sharing
21144 # (CORS), see Fetch API Living
21145 # Standard.
21146 #
21147 # Not supported when the URL map is bound to a target gRPC proxy.
21148 # information about the W3C recommendation for cross-origin resource sharing
21149 # (CORS), see Fetch API Living
21150 # Standard.
21151 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
21152 # indicates that
21153 # the actual request can include user credentials. This field translates to
21154 # the Access-Control-Allow-Credentials header.
21155 #
21156 # Default is false.
21157 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
21158 # header.
21159 &quot;A String&quot;,
21160 ],
21161 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
21162 # header.
21163 &quot;A String&quot;,
21164 ],
21165 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
21166 # more information, see regular expression syntax.
21167 #
21168 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
21169 #
21170 # Regular expressions can only be used when the loadBalancingScheme is
21171 # set to INTERNAL_SELF_MANAGED.
21172 &quot;A String&quot;,
21173 ],
21174 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
21175 #
21176 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
21177 &quot;A String&quot;,
21178 ],
21179 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
21180 # The default value is false, which indicates that the CORS
21181 # policy is in effect.
21182 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
21183 # header.
21184 &quot;A String&quot;,
21185 ],
21186 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
21187 # seconds. This field translates to the Access-Control-Max-Age
21188 # header.
21189 },
21190 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
21191 # the resiliency of clients to backend service failure. As part of fault
21192 # injection, when clients send requests to a backend service, delays can be
21193 # introduced by a load balancer on a percentage of requests before sending
21194 # those requests to the backend service. Similarly requests from clients can
21195 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
21196 # that are configured with a fault_injection_policy if:
21197 # 1. The traffic is generated by fault injection AND
21198 # 2. The fault injection is not a delay fault injection.
21199 # Fault injection is not supported with the classic Application Load Balancer
21200 # . To see which load balancers support fault injection,
21201 # see Load
21202 # balancing: Routing and traffic management features.
21203 # the resiliency of clients to backend service failure. As part of fault
21204 # injection, when clients send requests to a backend service, delays can be
21205 # introduced by the load balancer on a percentage of requests before sending
21206 # those request to the backend service. Similarly requests from clients can be
21207 # aborted by the load balancer for a percentage of requests.
21208 &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
21209 # injection.
21210 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
21211 #
21212 # The value must be from 200 to 599 inclusive.
21213 #
21214 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
21215 # according to this
21216 # mapping table. HTTP status 200 is mapped to gRPC status
21217 # UNKNOWN. Injecting an OK status is currently not supported by
21218 # Traffic Director.
21219 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
21220 # that is aborted as part of fault injection.
21221 #
21222 # The value must be from 0.0 to 100.0 inclusive.
21223 },
21224 &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
21225 # injection, before being sent to a backend service.
21226 # request to the backend service as part of fault injection.
21227 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
21228 # as a count of seconds and fractions of seconds at nanosecond
21229 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21230 # or &quot;month&quot;. Range is approximately 10,000 years.
21231 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21232 # Durations less than one second are represented with a 0
21233 # `seconds` field and a positive `nanos` field. Must be from 0
21234 # to 999,999,999 inclusive.
21235 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21236 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21237 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21238 },
21239 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
21240 # which a delay is introduced as part of fault injection.
21241 #
21242 # The value must be from 0.0 to 100.0 inclusive.
21243 },
21244 },
21245 &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
21246 # Global EXTERNAL_MANAGED load balancer schemes.
21247 # Either Cloud CDN must be enabled on the backend service or backend bucket
21248 # serving the route, or cache policy must be configured on the same route
21249 # dynamically processes and delivers images from the network edge.
21250 # Image Optimization is only available for Global External Application Load
21251 # Balancers.
21252 # Either Cloud CDN must be enabled on the backend service or backend bucket
21253 # serving the route, or cache policy must be configured on the same route.
21254 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
21255 },
21256 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
21257 # Unlike the timeout field where the timeout duration starts
21258 # from the time the request has been fully processed (known as*end-of-stream*),
21259 # the duration in this field is computed from the beginning of the stream
21260 # until the response has been processed, including all retries. A
21261 # stream that does not complete in this duration is closed.
21262 #
21263 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
21264 # with the route.
21265 #
21266 # This field is only allowed if the Url map is used with backend services
21267 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
21268 # as a count of seconds and fractions of seconds at nanosecond
21269 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21270 # or &quot;month&quot;. Range is approximately 10,000 years.
21271 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21272 # Durations less than one second are represented with a 0
21273 # `seconds` field and a positive `nanos` field. Must be from 0
21274 # to 999,999,999 inclusive.
21275 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21276 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21277 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21278 },
21279 &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
21280 # are shadowed to a separate mirrored backend service. The load balancer does
21281 # not wait for responses from the shadow service. Before sending traffic
21282 # to the shadow service, the host / authority header is suffixed with-shadow.
21283 #
21284 # Not supported when the URL map is bound to a target gRPC proxy that
21285 # has the validateForProxyless field set to true.
21286 # are shadowed to a separate mirrored backend service. The load balancer
21287 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
21288 # to the shadow service, the host or authority header is suffixed with-shadow.
21289 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
21290 # mirrored to.
21291 #
21292 # The backend service configured for a mirroring
21293 # policy must reference backends that are of the same type as the original
21294 # backend service matched in the URL map.
21295 #
21296 # Serverless NEG backends are not currently supported as a mirrored
21297 # backend service.
21298 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
21299 },
21300 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
21301 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
21302 # If not specified, defaults to 1.
21303 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
21304 #
21305 # If not specified, will use the timeout set in theHttpRouteAction field.
21306 # If timeout in the HttpRouteAction field is not set, this field
21307 # uses the largest timeout
21308 # among all backend services associated with the route.
21309 #
21310 # Not supported when the URL map is bound to a target gRPC proxy that
21311 # has the validateForProxyless field set to true.
21312 # as a count of seconds and fractions of seconds at nanosecond
21313 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21314 # or &quot;month&quot;. Range is approximately 10,000 years.
21315 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21316 # Durations less than one second are represented with a 0
21317 # `seconds` field and a positive `nanos` field. Must be from 0
21318 # to 999,999,999 inclusive.
21319 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21320 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21321 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21322 },
21323 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
21324 # values are:
21325 #
21326 # - 5xx: retry is attempted if the instance or endpoint
21327 # responds with any 5xx response code, or if the instance or
21328 # endpoint does not respond at all. For example, disconnects, reset, read
21329 # timeout, connection failure, and refused streams.
21330 # - gateway-error: Similar to 5xx, but only
21331 # applies to response codes 502, 503 or504.
21332 # - connect-failure: a retry is attempted on failures
21333 # connecting to the instance or endpoint. For example, connection
21334 # timeouts.
21335 # - retriable-4xx: a retry is attempted if the instance
21336 # or endpoint responds with a 4xx response code.
21337 # The only error that you can retry is error code 409.
21338 # - refused-stream: a retry is attempted if the instance
21339 # or endpoint resets the stream with a REFUSED_STREAM error
21340 # code. This reset type indicates that it is safe to retry.
21341 # - cancelled: a retry is attempted if the gRPC status
21342 # code in the response header is set to cancelled.
21343 # - deadline-exceeded: a retry is attempted if the gRPC
21344 # status code in the response header is set todeadline-exceeded.
21345 # - internal: a retry is attempted if the gRPC
21346 # status code in the response header is set tointernal.
21347 # - resource-exhausted: a retry is attempted if the gRPC
21348 # status code in the response header is set toresource-exhausted.
21349 # - unavailable: a retry is attempted if the gRPC
21350 # status code in the response header is set tounavailable.
21351 #
21352 # Only the following codes are supported when the URL map is bound to
21353 # target gRPC proxy that has validateForProxyless field set to true.
21354 #
21355 # - cancelled
21356 # - deadline-exceeded
21357 # - internal
21358 # - resource-exhausted
21359 # - unavailable
21360 &quot;A String&quot;,
21361 ],
21362 },
21363 &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
21364 # time the request has been fully processed (known as *end-of-stream*)
21365 # up until the response has been processed. Timeout includes
21366 # all retries.
21367 #
21368 # If not specified, this field uses the largest timeout among all backend
21369 # services associated with the route.
21370 #
21371 # Not supported when the URL map is bound to a target gRPC proxy that
21372 # has validateForProxyless field set to true.
21373 # as a count of seconds and fractions of seconds at nanosecond
21374 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21375 # or &quot;month&quot;. Range is approximately 10,000 years.
21376 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21377 # Durations less than one second are represented with a 0
21378 # `seconds` field and a positive `nanos` field. Must be from 0
21379 # to 999,999,999 inclusive.
21380 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21381 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21382 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21383 },
21384 &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
21385 # to the matched service.
21386 #
21387 # urlRewrite is the only action supported in UrlMaps
21388 # for classic Application Load Balancers.
21389 #
21390 # Not supported when the URL map is bound to a target gRPC proxy that
21391 # has the validateForProxyless field set to true.
21392 # backend service.
21393 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
21394 # host header is replaced with contents of hostRewrite.
21395 #
21396 # The value must be from 1 to 255 characters.
21397 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
21398 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
21399 #
21400 # The value must be from 1 to 1024 characters.
21401 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
21402 # header) using the HTTP template syntax.
21403 #
21404 # A corresponding
21405 # path_template_match must be specified. Any template variables must exist in
21406 # the path_template_match field.
21407 #
21408 #
21409 # - -At least one variable must be specified in the path_template_match
21410 # field
21411 # - You can omit variables from the rewritten URL
21412 # - The * and ** operators cannot be matched
21413 # unless they have a corresponding variable name - e.g.
21414 # {format=*} or {var=**}.
21415 #
21416 # For example, a path_template_match of /static/{format=**}
21417 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
21418 # rewrite, so that /{country}/{format}/{suffix=**} can be
21419 # rewritten as /content/{format}/{country}/{suffix}.
21420 #
21421 # At least
21422 # one non-empty routeRules[].matchRules[].path_template_match is
21423 # required.
21424 #
21425 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
21426 },
21427 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
21428 # occurs. The weights determine the fraction of traffic that flows to
21429 # their corresponding backend service. If all traffic needs to
21430 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
21431 #
21432 # After a backend service is identified and before forwarding
21433 # the request to
21434 # the backend service, advanced routing actions such as URL rewrites and
21435 # header transformations are applied depending on additional settings
21436 # specified in this HttpRouteAction.
21437 { # In contrast to a single BackendService in
21438 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
21439 # multiple backend services. The volume of traffic for each
21440 # backend service is proportional to the weight specified
21441 # in each WeightedBackendService
21442 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
21443 # resource. Before
21444 # forwarding the request to backendService, the load balancer
21445 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
21446 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
21447 # effect for the selected backendService.
21448 #
21449 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
21450 #
21451 # headerAction is not supported for load balancers that have
21452 # their loadBalancingScheme set to EXTERNAL.
21453 #
21454 # Not supported when the URL map is bound to a target gRPC proxy that
21455 # has validateForProxyless field set to true.
21456 # the request is passed along to the selected backendService.
21457 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
21458 { # Specification determining how headers are added to requests or responses.
21459 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
21460 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
21461 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
21462 # that already
21463 # exist for the header. If true, headerValue is set for the
21464 # header, discarding any values that were set for that header.
21465 #
21466 # The default value is true,
21467 # unless a variable is present in headerValue,
21468 # in which case the default value is false.
21469 # .
21470 },
21471 ],
21472 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
21473 # request before forwarding the request to the backendService.
21474 &quot;A String&quot;,
21475 ],
21476 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
21477 # client.
21478 { # Specification determining how headers are added to requests or responses.
21479 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
21480 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
21481 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
21482 # that already
21483 # exist for the header. If true, headerValue is set for the
21484 # header, discarding any values that were set for that header.
21485 #
21486 # The default value is true,
21487 # unless a variable is present in headerValue,
21488 # in which case the default value is false.
21489 # .
21490 },
21491 ],
21492 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
21493 # response before sending the response back to the client.
21494 &quot;A String&quot;,
21495 ],
21496 },
21497 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
21498 # computed asweight / (sum of all weightedBackendService weights in routeAction).
21499 #
21500 # The selection of a backend service is determined only for new traffic.
21501 # Once a user&#x27;s request has been directed to a backend service,
21502 # subsequent requests are sent to the same backend service as
21503 # determined by the backend service&#x27;s session affinity policy.
21504 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
21505 # splitting. If you do, the weighted traffic splitting configuration takes
21506 # precedence.
21507 #
21508 # The value must be from 0 to 1000.
21509 },
21510 ],
21511 },
21512 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource. This
21513 # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
21514 # matched. For example, the
21515 # following are all valid URLs to a BackendService resource:
21516 #
21517 #
21518 # - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
21519 # - compute/v1/projects/project/global/backendServices/backendService
21520 # - global/backendServices/backendService
21521 #
21522 #
21523 # If defaultRouteAction is also specified, advanced
21524 # routing actions, such as URL rewrites, take effect before sending the
21525 # request to the backend.
21526 #
21527 #
21528 # Only one of defaultUrlRedirect, defaultService
21529 # or defaultRouteAction.weightedBackendService can be set.
21530 #
21531 #
21532 # Authorization requires one or more of the following Google IAM permissions on the
21533 # specified resource default_service:
21534 #
21535 #
21536 # - compute.backendBuckets.use
21537 # - compute.backendServices.use
21538 &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
21539 # by defaultUrlRedirect.
21540 #
21541 #
21542 # Only one of defaultUrlRedirect, defaultService
21543 # or defaultRouteAction.weightedBackendService can be set.
21544 #
21545 #
21546 # Not supported when the URL map is bound to a target gRPC proxy.
21547 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
21548 # was supplied in the request.
21549 #
21550 # The value must be from 1 to 255
21551 # characters.
21552 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
21553 # set to HTTPS.
21554 # If set to false, the URL scheme of the redirected request
21555 # remains the same as that of the request.
21556 #
21557 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
21558 #
21559 # The default is set to false.
21560 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
21561 # that was supplied in the request.
21562 #
21563 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
21564 # supplied, the path of the original request is used for the redirect.
21565 #
21566 # The value must be from 1 to 1024 characters.
21567 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
21568 # the HttpRouteRuleMatch, retaining the remaining portion
21569 # of the URL before redirecting the request.
21570 #
21571 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
21572 # supplied, the path of the original request is used for the redirect.
21573 #
21574 # The value must be from 1 to 1024 characters.
21575 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
21576 #
21577 # Supported values are:
21578 #
21579 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
21580 # to 301.
21581 # - FOUND, which corresponds to 302.
21582 # - SEE_OTHER which corresponds to 303.
21583 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
21584 # method is retained.
21585 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
21586 # method is retained.
21587 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
21588 # URL is
21589 # removed before redirecting the request. If set to false, the
21590 # query portion of the original URL is retained.
21591 #
21592 # The default is set to false.
21593 },
21594 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
21595 # create the resource.
21596 &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
21597 # for the selected backend service.
21598 #
21599 # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
21600 #
21601 # HeaderAction is not supported for load balancers
21602 # that have
21603 # their loadBalancingScheme set to EXTERNAL.
21604 #
21605 # Not supported when the URL map is bound to a target gRPC proxy that
21606 # has validateForProxyless field set to true.
21607 # the request is passed along to the selected backendService.
21608 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
21609 { # Specification determining how headers are added to requests or responses.
21610 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
21611 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
21612 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
21613 # that already
21614 # exist for the header. If true, headerValue is set for the
21615 # header, discarding any values that were set for that header.
21616 #
21617 # The default value is true,
21618 # unless a variable is present in headerValue,
21619 # in which case the default value is false.
21620 # .
21621 },
21622 ],
21623 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
21624 # request before forwarding the request to the backendService.
21625 &quot;A String&quot;,
21626 ],
21627 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
21628 # client.
21629 { # Specification determining how headers are added to requests or responses.
21630 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
21631 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
21632 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
21633 # that already
21634 # exist for the header. If true, headerValue is set for the
21635 # header, discarding any values that were set for that header.
21636 #
21637 # The default value is true,
21638 # unless a variable is present in headerValue,
21639 # in which case the default value is false.
21640 # .
21641 },
21642 ],
21643 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
21644 # response before sending the response back to the client.
21645 &quot;A String&quot;,
21646 ],
21647 },
21648 &quot;name&quot;: &quot;A String&quot;, # The name to which this PathMatcher is referred by theHostRule.
21649 &quot;pathRules&quot;: [ # The list of path rules. Use this list instead of routeRules
21650 # when routing based on simple path matching is all that&#x27;s required. A path
21651 # rule can only include a wildcard character (*) after a
21652 # forward slash character (&quot;/&quot;).
21653 #
21654 # The order by which path rules are specified does not matter.
21655 # Matches are always done on the longest-path-first basis.
21656 #
21657 # For example: a pathRule with a path /a/b/c/* will match
21658 # before /a/b/* irrespective of the order in which those paths appear in this
21659 # list.
21660 #
21661 # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
21662 { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
21663 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
21664 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
21665 #
21666 # If a policy for an
21667 # error code is not configured for the PathRule, a policy for
21668 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
21669 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
21670 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
21671 # effect.
21672 #
21673 # For example, consider a UrlMap with the following configuration:
21674 #
21675 #
21676 # - UrlMap.defaultCustomErrorResponsePolicy are configured
21677 # with policies for 5xx and 4xx errors
21678 # - A PathRule for /coming_soon/ is configured for the error
21679 # code 404.
21680 #
21681 # 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
21682 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
21683 # the policy in PathRule.customErrorResponsePolicy takes
21684 # effect. If any of the requests in this example encounter a 500
21685 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
21686 #
21687 # customErrorResponsePolicy is supported only for
21688 # global external Application Load Balancers.
21689 # backend service or backend bucket responds with an error.
21690 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
21691 #
21692 # In a given policy, if you specify rules for both a range of error codes
21693 # as well as rules for specific error codes then rules with specific error
21694 # codes have a higher priority. For example, assume that you configure a rule
21695 # for 401 (Un-authorized) code, and another for all 4 series
21696 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
21697 # However if the backend service returns a 403, the rule for4xx takes effect.
21698 { # Specifies the mapping between the response code that will be returned along
21699 # with the custom error content and the response code returned by the backend
21700 # service.
21701 &quot;matchResponseCodes&quot;: [ # Valid values include:
21702 #
21703 #
21704 # - A number between 400 and 599: For example
21705 # 401 or 503, in which case the load balancer
21706 # applies the policy if the error code exactly matches this value.
21707 # - 5xx: Load Balancer will apply the policy if the
21708 # backend service responds with any response code in the range of
21709 # 500 to 599.
21710 # - 4xx: Load
21711 # Balancer will apply the policy if the backend service responds with any
21712 # response code in the range of 400 to
21713 # 499.
21714 #
21715 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
21716 &quot;A String&quot;,
21717 ],
21718 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
21719 # error content. If overrideResponseCode is not supplied, the
21720 # same response code returned by the original backend bucket or backend
21721 # service is returned to the client.
21722 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
21723 #
21724 # path must start
21725 # with a leading slash. path cannot have trailing slashes.
21726 #
21727 # If the file is not available in backendBucket or the
21728 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
21729 #
21730 # The value must
21731 # be from 1 to 1024 characters
21732 },
21733 ],
21734 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
21735 # contains the custom error content. Examples are:
21736 #
21737 #
21738 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
21739 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
21740 # - global/backendBuckets/myBackendBucket
21741 #
21742 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
21743 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
21744 #
21745 # If load balancer cannot reach
21746 # the backendBucket, a simple Not Found Error will
21747 # be returned, with the original response code (oroverrideResponseCode if configured).
21748 #
21749 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
21750 },
21751 &quot;paths&quot;: [ # The list of path patterns to match. Each must start with /
21752 # and the only place a * is allowed is at the end following
21753 # a /. The string fed to the path matcher does not include
21754 # any text after the first ? or #, and
21755 # those chars are not allowed here.
21756 &quot;A String&quot;,
21757 ],
21758 &quot;routeAction&quot;: { # In response to a matching path, the load balancer
21759 # performs advanced routing actions, such as URL rewrites and header
21760 # transformations, before forwarding the request to the selected
21761 # backend.
21762 #
21763 #
21764 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
21765 #
21766 #
21767 # URL maps for classic Application Load Balancers only support
21768 # the urlRewrite action within a path rule&#x27;srouteAction.
21769 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
21770 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
21771 # property must be specified. This policy cannot be specified if any target
21772 # backend has Identity-Aware Proxy enabled.
21773 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
21774 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
21775 # header names can be specified. The cache is bypassed for all `cacheMode`
21776 # values.
21777 &quot;A String&quot;,
21778 ],
21779 &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
21780 # on the backend type: for Backend Services, the complete request URI is
21781 # used; for Backend Buckets, the request URI is used without the protocol or
21782 # host, and only query parameters known to Cloud Storage are included.
21783 # Policy defined on Route Action.
21784 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
21785 # parameters will be included. Either specify `excludedQueryParameters`
21786 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
21787 # encoded and not treated as delimiters.
21788 #
21789 # Note: This field applies to routes that use backend services. Attempting
21790 # to set it on a route that points exclusively to Backend Buckets will
21791 # result in a configuration error. For routes that point to a Backend
21792 # Bucket, use `includedQueryParameters` to define which parameters should
21793 # be part of the cache key.
21794 &quot;A String&quot;,
21795 ],
21796 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
21797 #
21798 # Note: This setting is only applicable to routes that use a Backend
21799 # Service. It does not affect requests served by a Backend Bucket, as the
21800 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
21801 # it on a route that points exclusively to Backend Buckets will result in a
21802 # configuration error.
21803 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
21804 #
21805 # Note: This setting is only applicable to routes that use a Backend
21806 # Service. It does not affect requests served by a Backend Bucket, as the
21807 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
21808 # set on a route that points exclusively to Backend Buckets will result in
21809 # a configuration error.
21810 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
21811 # `includedQueryParameters` and `excludedQueryParameters`. If neither
21812 # is set, the entire query string will be included. If false, the query
21813 # string will be excluded from the cache key entirely.
21814 #
21815 # Note: This field applies to routes that use backend services. Attempting
21816 # to set it on a route that points exclusively to Backend Buckets will
21817 # result in a configuration error. For routes that point to a Backend
21818 # Bucket, use `includedQueryParameters` to define which parameters should
21819 # be part of the cache key.
21820 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
21821 # The name=value pair will be used in the cache key Cloud CDN generates.
21822 #
21823 # Note: This setting is only applicable to routes that use a Backend
21824 # Service. It does not affect requests served by a Backend Bucket.
21825 # Attempting to set it on a route that points exclusively to Backend
21826 # Buckets will result in a configuration error. Up to 5 cookie names can be
21827 # specified.
21828 &quot;A String&quot;,
21829 ],
21830 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
21831 &quot;A String&quot;,
21832 ],
21833 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
21834 # parameters will be excluded. Either specify `includedQueryParameters`
21835 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
21836 # encoded and not treated as delimiters.
21837 &quot;A String&quot;,
21838 ],
21839 },
21840 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
21841 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
21842 &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
21843 # content. This is used to clamp the max-age (or Expires) value sent to the
21844 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
21845 # is used for the response max-age directive, along with a &quot;public&quot;
21846 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
21847 # clamps the max-age from the origin (if specified), or else sets the
21848 # response max-age directive to the lesser of the `clientTtl` and
21849 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
21850 # present. The maximum allowed value is 31,622,400s (1 year). If not
21851 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
21852 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
21853 # `USE_ORIGIN_HEADERS`.
21854 # as a count of seconds and fractions of seconds at nanosecond
21855 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21856 # or &quot;month&quot;. Range is approximately 10,000 years.
21857 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21858 # Durations less than one second are represented with a 0
21859 # `seconds` field and a positive `nanos` field. Must be from 0
21860 # to 999,999,999 inclusive.
21861 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21862 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21863 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21864 },
21865 &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
21866 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
21867 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
21868 # greater than that of `maxTtl`. When the `cacheMode` is set to
21869 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
21870 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
21871 # accessed objects may be evicted from the cache before the defined TTL. If
21872 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
21873 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
21874 # `USE_ORIGIN_HEADERS`.
21875 # as a count of seconds and fractions of seconds at nanosecond
21876 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21877 # or &quot;month&quot;. Range is approximately 10,000 years.
21878 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21879 # Durations less than one second are represented with a 0
21880 # `seconds` field and a positive `nanos` field. Must be from 0
21881 # to 999,999,999 inclusive.
21882 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21883 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21884 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21885 },
21886 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
21887 # attempt to set a max-age or s-maxage higher than this, or an Expires header
21888 # more than `maxTtl` seconds in the future will be capped at the value of
21889 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
21890 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
21891 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
21892 # Infrequently accessed objects may be evicted from the cache before the
21893 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
21894 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
21895 # mode.
21896 # as a count of seconds and fractions of seconds at nanosecond
21897 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21898 # or &quot;month&quot;. Range is approximately 10,000 years.
21899 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21900 # Durations less than one second are represented with a 0
21901 # `seconds` field and a positive `nanos` field. Must be from 0
21902 # to 999,999,999 inclusive.
21903 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21904 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21905 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21906 },
21907 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
21908 # to apply fine-grained caching for common errors or redirects.
21909 # This can reduce the load on your origin and improve end-user
21910 # experience by reducing response latency.
21911 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
21912 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
21913 # the specified response code that lack any Cache-Control, Expires, or
21914 # Pragma: no-cache directives. When the `cacheMode` is set to
21915 # `FORCE_CACHE_ALL`, negative caching applies to all responses
21916 # with the specified response code, and overrides any caching headers. By
21917 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
21918 #
21919 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
21920 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
21921 # * 405 (Method Not Found), 501 (Not Implemented): 60s
21922 #
21923 # These defaults can be overridden in `negativeCachingPolicy`.
21924 # If not specified, Cloud CDN applies negative caching by default.
21925 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
21926 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
21927 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
21928 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
21929 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
21930 # all response codes that you wish to cache. Cloud CDN will not apply any
21931 # default negative caching when a policy exists.
21932 { # Specify CDN TTLs for response error codes.
21933 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
21934 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
21935 # specified as values, and you cannot specify a status code more than
21936 # once.
21937 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
21938 # corresponding status code.
21939 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
21940 # objects may be evicted from the cache before the defined TTL.
21941 # as a count of seconds and fractions of seconds at nanosecond
21942 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21943 # or &quot;month&quot;. Range is approximately 10,000 years.
21944 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21945 # Durations less than one second are represented with a 0
21946 # `seconds` field and a positive `nanos` field. Must be from 0
21947 # to 999,999,999 inclusive.
21948 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21949 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21950 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21951 },
21952 },
21953 ],
21954 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
21955 # requests into a small number of requests to the origin. If not specified,
21956 # Cloud CDN applies request coalescing by default.
21957 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
21958 # content with the origin, or when an error is encountered when refreshing
21959 # the cache.
21960 # This setting defines the default &quot;max-stale&quot; duration for any cached
21961 # responses that do not specify a max-stale directive. Stale responses that
21962 # exceed the TTL configured here will not be served. The default limit
21963 # (max-stale) is 86400s (1 day), which will allow stale content to be
21964 # served up to this limit beyond the max-age (or s-maxage) of a cached
21965 # response.
21966 # The maximum allowed value is 604800 (1 week).
21967 # Set this to zero (0) to disable serve-while-stale.
21968 # as a count of seconds and fractions of seconds at nanosecond
21969 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21970 # or &quot;month&quot;. Range is approximately 10,000 years.
21971 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21972 # Durations less than one second are represented with a 0
21973 # `seconds` field and a positive `nanos` field. Must be from 0
21974 # to 999,999,999 inclusive.
21975 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21976 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21977 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21978 },
21979 },
21980 &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
21981 # information about the W3C recommendation for cross-origin resource sharing
21982 # (CORS), see Fetch API Living
21983 # Standard.
21984 #
21985 # Not supported when the URL map is bound to a target gRPC proxy.
21986 # information about the W3C recommendation for cross-origin resource sharing
21987 # (CORS), see Fetch API Living
21988 # Standard.
21989 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
21990 # indicates that
21991 # the actual request can include user credentials. This field translates to
21992 # the Access-Control-Allow-Credentials header.
21993 #
21994 # Default is false.
21995 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
21996 # header.
21997 &quot;A String&quot;,
21998 ],
21999 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
22000 # header.
22001 &quot;A String&quot;,
22002 ],
22003 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
22004 # more information, see regular expression syntax.
22005 #
22006 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
22007 #
22008 # Regular expressions can only be used when the loadBalancingScheme is
22009 # set to INTERNAL_SELF_MANAGED.
22010 &quot;A String&quot;,
22011 ],
22012 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
22013 #
22014 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
22015 &quot;A String&quot;,
22016 ],
22017 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
22018 # The default value is false, which indicates that the CORS
22019 # policy is in effect.
22020 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
22021 # header.
22022 &quot;A String&quot;,
22023 ],
22024 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
22025 # seconds. This field translates to the Access-Control-Max-Age
22026 # header.
22027 },
22028 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
22029 # the resiliency of clients to backend service failure. As part of fault
22030 # injection, when clients send requests to a backend service, delays can be
22031 # introduced by a load balancer on a percentage of requests before sending
22032 # those requests to the backend service. Similarly requests from clients can
22033 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
22034 # that are configured with a fault_injection_policy if:
22035 # 1. The traffic is generated by fault injection AND
22036 # 2. The fault injection is not a delay fault injection.
22037 # Fault injection is not supported with the classic Application Load Balancer
22038 # . To see which load balancers support fault injection,
22039 # see Load
22040 # balancing: Routing and traffic management features.
22041 # the resiliency of clients to backend service failure. As part of fault
22042 # injection, when clients send requests to a backend service, delays can be
22043 # introduced by the load balancer on a percentage of requests before sending
22044 # those request to the backend service. Similarly requests from clients can be
22045 # aborted by the load balancer for a percentage of requests.
22046 &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
22047 # injection.
22048 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
22049 #
22050 # The value must be from 200 to 599 inclusive.
22051 #
22052 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
22053 # according to this
22054 # mapping table. HTTP status 200 is mapped to gRPC status
22055 # UNKNOWN. Injecting an OK status is currently not supported by
22056 # Traffic Director.
22057 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
22058 # that is aborted as part of fault injection.
22059 #
22060 # The value must be from 0.0 to 100.0 inclusive.
22061 },
22062 &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
22063 # injection, before being sent to a backend service.
22064 # request to the backend service as part of fault injection.
22065 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
22066 # as a count of seconds and fractions of seconds at nanosecond
22067 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
22068 # or &quot;month&quot;. Range is approximately 10,000 years.
22069 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
22070 # Durations less than one second are represented with a 0
22071 # `seconds` field and a positive `nanos` field. Must be from 0
22072 # to 999,999,999 inclusive.
22073 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22074 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22075 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22076 },
22077 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
22078 # which a delay is introduced as part of fault injection.
22079 #
22080 # The value must be from 0.0 to 100.0 inclusive.
22081 },
22082 },
22083 &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
22084 # Global EXTERNAL_MANAGED load balancer schemes.
22085 # Either Cloud CDN must be enabled on the backend service or backend bucket
22086 # serving the route, or cache policy must be configured on the same route
22087 # dynamically processes and delivers images from the network edge.
22088 # Image Optimization is only available for Global External Application Load
22089 # Balancers.
22090 # Either Cloud CDN must be enabled on the backend service or backend bucket
22091 # serving the route, or cache policy must be configured on the same route.
22092 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
22093 },
22094 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
22095 # Unlike the timeout field where the timeout duration starts
22096 # from the time the request has been fully processed (known as*end-of-stream*),
22097 # the duration in this field is computed from the beginning of the stream
22098 # until the response has been processed, including all retries. A
22099 # stream that does not complete in this duration is closed.
22100 #
22101 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
22102 # with the route.
22103 #
22104 # This field is only allowed if the Url map is used with backend services
22105 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
22106 # as a count of seconds and fractions of seconds at nanosecond
22107 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
22108 # or &quot;month&quot;. Range is approximately 10,000 years.
22109 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
22110 # Durations less than one second are represented with a 0
22111 # `seconds` field and a positive `nanos` field. Must be from 0
22112 # to 999,999,999 inclusive.
22113 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22114 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22115 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22116 },
22117 &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
22118 # are shadowed to a separate mirrored backend service. The load balancer does
22119 # not wait for responses from the shadow service. Before sending traffic
22120 # to the shadow service, the host / authority header is suffixed with-shadow.
22121 #
22122 # Not supported when the URL map is bound to a target gRPC proxy that
22123 # has the validateForProxyless field set to true.
22124 # are shadowed to a separate mirrored backend service. The load balancer
22125 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
22126 # to the shadow service, the host or authority header is suffixed with-shadow.
22127 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
22128 # mirrored to.
22129 #
22130 # The backend service configured for a mirroring
22131 # policy must reference backends that are of the same type as the original
22132 # backend service matched in the URL map.
22133 #
22134 # Serverless NEG backends are not currently supported as a mirrored
22135 # backend service.
22136 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
22137 },
22138 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
22139 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
22140 # If not specified, defaults to 1.
22141 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
22142 #
22143 # If not specified, will use the timeout set in theHttpRouteAction field.
22144 # If timeout in the HttpRouteAction field is not set, this field
22145 # uses the largest timeout
22146 # among all backend services associated with the route.
22147 #
22148 # Not supported when the URL map is bound to a target gRPC proxy that
22149 # has the validateForProxyless field set to true.
22150 # as a count of seconds and fractions of seconds at nanosecond
22151 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
22152 # or &quot;month&quot;. Range is approximately 10,000 years.
22153 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
22154 # Durations less than one second are represented with a 0
22155 # `seconds` field and a positive `nanos` field. Must be from 0
22156 # to 999,999,999 inclusive.
22157 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22158 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22159 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22160 },
22161 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
22162 # values are:
22163 #
22164 # - 5xx: retry is attempted if the instance or endpoint
22165 # responds with any 5xx response code, or if the instance or
22166 # endpoint does not respond at all. For example, disconnects, reset, read
22167 # timeout, connection failure, and refused streams.
22168 # - gateway-error: Similar to 5xx, but only
22169 # applies to response codes 502, 503 or504.
22170 # - connect-failure: a retry is attempted on failures
22171 # connecting to the instance or endpoint. For example, connection
22172 # timeouts.
22173 # - retriable-4xx: a retry is attempted if the instance
22174 # or endpoint responds with a 4xx response code.
22175 # The only error that you can retry is error code 409.
22176 # - refused-stream: a retry is attempted if the instance
22177 # or endpoint resets the stream with a REFUSED_STREAM error
22178 # code. This reset type indicates that it is safe to retry.
22179 # - cancelled: a retry is attempted if the gRPC status
22180 # code in the response header is set to cancelled.
22181 # - deadline-exceeded: a retry is attempted if the gRPC
22182 # status code in the response header is set todeadline-exceeded.
22183 # - internal: a retry is attempted if the gRPC
22184 # status code in the response header is set tointernal.
22185 # - resource-exhausted: a retry is attempted if the gRPC
22186 # status code in the response header is set toresource-exhausted.
22187 # - unavailable: a retry is attempted if the gRPC
22188 # status code in the response header is set tounavailable.
22189 #
22190 # Only the following codes are supported when the URL map is bound to
22191 # target gRPC proxy that has validateForProxyless field set to true.
22192 #
22193 # - cancelled
22194 # - deadline-exceeded
22195 # - internal
22196 # - resource-exhausted
22197 # - unavailable
22198 &quot;A String&quot;,
22199 ],
22200 },
22201 &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
22202 # time the request has been fully processed (known as *end-of-stream*)
22203 # up until the response has been processed. Timeout includes
22204 # all retries.
22205 #
22206 # If not specified, this field uses the largest timeout among all backend
22207 # services associated with the route.
22208 #
22209 # Not supported when the URL map is bound to a target gRPC proxy that
22210 # has validateForProxyless field set to true.
22211 # as a count of seconds and fractions of seconds at nanosecond
22212 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
22213 # or &quot;month&quot;. Range is approximately 10,000 years.
22214 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
22215 # Durations less than one second are represented with a 0
22216 # `seconds` field and a positive `nanos` field. Must be from 0
22217 # to 999,999,999 inclusive.
22218 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22219 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22220 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22221 },
22222 &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
22223 # to the matched service.
22224 #
22225 # urlRewrite is the only action supported in UrlMaps
22226 # for classic Application Load Balancers.
22227 #
22228 # Not supported when the URL map is bound to a target gRPC proxy that
22229 # has the validateForProxyless field set to true.
22230 # backend service.
22231 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
22232 # host header is replaced with contents of hostRewrite.
22233 #
22234 # The value must be from 1 to 255 characters.
22235 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
22236 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
22237 #
22238 # The value must be from 1 to 1024 characters.
22239 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
22240 # header) using the HTTP template syntax.
22241 #
22242 # A corresponding
22243 # path_template_match must be specified. Any template variables must exist in
22244 # the path_template_match field.
22245 #
22246 #
22247 # - -At least one variable must be specified in the path_template_match
22248 # field
22249 # - You can omit variables from the rewritten URL
22250 # - The * and ** operators cannot be matched
22251 # unless they have a corresponding variable name - e.g.
22252 # {format=*} or {var=**}.
22253 #
22254 # For example, a path_template_match of /static/{format=**}
22255 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
22256 # rewrite, so that /{country}/{format}/{suffix=**} can be
22257 # rewritten as /content/{format}/{country}/{suffix}.
22258 #
22259 # At least
22260 # one non-empty routeRules[].matchRules[].path_template_match is
22261 # required.
22262 #
22263 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
22264 },
22265 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
22266 # occurs. The weights determine the fraction of traffic that flows to
22267 # their corresponding backend service. If all traffic needs to
22268 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
22269 #
22270 # After a backend service is identified and before forwarding
22271 # the request to
22272 # the backend service, advanced routing actions such as URL rewrites and
22273 # header transformations are applied depending on additional settings
22274 # specified in this HttpRouteAction.
22275 { # In contrast to a single BackendService in
22276 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
22277 # multiple backend services. The volume of traffic for each
22278 # backend service is proportional to the weight specified
22279 # in each WeightedBackendService
22280 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
22281 # resource. Before
22282 # forwarding the request to backendService, the load balancer
22283 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
22284 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
22285 # effect for the selected backendService.
22286 #
22287 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
22288 #
22289 # headerAction is not supported for load balancers that have
22290 # their loadBalancingScheme set to EXTERNAL.
22291 #
22292 # Not supported when the URL map is bound to a target gRPC proxy that
22293 # has validateForProxyless field set to true.
22294 # the request is passed along to the selected backendService.
22295 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
22296 { # Specification determining how headers are added to requests or responses.
22297 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
22298 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
22299 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
22300 # that already
22301 # exist for the header. If true, headerValue is set for the
22302 # header, discarding any values that were set for that header.
22303 #
22304 # The default value is true,
22305 # unless a variable is present in headerValue,
22306 # in which case the default value is false.
22307 # .
22308 },
22309 ],
22310 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
22311 # request before forwarding the request to the backendService.
22312 &quot;A String&quot;,
22313 ],
22314 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
22315 # client.
22316 { # Specification determining how headers are added to requests or responses.
22317 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
22318 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
22319 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
22320 # that already
22321 # exist for the header. If true, headerValue is set for the
22322 # header, discarding any values that were set for that header.
22323 #
22324 # The default value is true,
22325 # unless a variable is present in headerValue,
22326 # in which case the default value is false.
22327 # .
22328 },
22329 ],
22330 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
22331 # response before sending the response back to the client.
22332 &quot;A String&quot;,
22333 ],
22334 },
22335 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
22336 # computed asweight / (sum of all weightedBackendService weights in routeAction).
22337 #
22338 # The selection of a backend service is determined only for new traffic.
22339 # Once a user&#x27;s request has been directed to a backend service,
22340 # subsequent requests are sent to the same backend service as
22341 # determined by the backend service&#x27;s session affinity policy.
22342 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
22343 # splitting. If you do, the weighted traffic splitting configuration takes
22344 # precedence.
22345 #
22346 # The value must be from 0 to 1000.
22347 },
22348 ],
22349 },
22350 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
22351 # is directed if this rule is matched. If routeAction is
22352 # also specified, advanced routing actions, such as URL rewrites,
22353 # take effect before sending the request to the backend.
22354 #
22355 #
22356 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
22357 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
22358 # specified by urlRedirect.
22359 #
22360 #
22361 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
22362 #
22363 #
22364 # Not supported when the URL map is bound to a target gRPC proxy.
22365 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
22366 # was supplied in the request.
22367 #
22368 # The value must be from 1 to 255
22369 # characters.
22370 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
22371 # set to HTTPS.
22372 # If set to false, the URL scheme of the redirected request
22373 # remains the same as that of the request.
22374 #
22375 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
22376 #
22377 # The default is set to false.
22378 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
22379 # that was supplied in the request.
22380 #
22381 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
22382 # supplied, the path of the original request is used for the redirect.
22383 #
22384 # The value must be from 1 to 1024 characters.
22385 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
22386 # the HttpRouteRuleMatch, retaining the remaining portion
22387 # of the URL before redirecting the request.
22388 #
22389 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
22390 # supplied, the path of the original request is used for the redirect.
22391 #
22392 # The value must be from 1 to 1024 characters.
22393 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
22394 #
22395 # Supported values are:
22396 #
22397 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
22398 # to 301.
22399 # - FOUND, which corresponds to 302.
22400 # - SEE_OTHER which corresponds to 303.
22401 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
22402 # method is retained.
22403 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
22404 # method is retained.
22405 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
22406 # URL is
22407 # removed before redirecting the request. If set to false, the
22408 # query portion of the original URL is retained.
22409 #
22410 # The default is set to false.
22411 },
22412 },
22413 ],
22414 &quot;routeRules&quot;: [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
22415 # desired. routeRules are evaluated in order of priority, from
22416 # the lowest to highest number.
22417 #
22418 # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
22419 { # The HttpRouteRule setting specifies how to match an HTTP request
22420 # and the corresponding routing action that load balancing proxies perform.
22421 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
22422 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
22423 #
22424 # If a policy for an
22425 # error code is not configured for the RouteRule, a policy for
22426 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
22427 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
22428 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
22429 # effect.
22430 #
22431 # For example, consider a UrlMap with the following configuration:
22432 #
22433 #
22434 # - UrlMap.defaultCustomErrorResponsePolicy are configured
22435 # with policies for 5xx and 4xx errors
22436 # - A RouteRule for /coming_soon/ is configured for the
22437 # error code 404.
22438 #
22439 # 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
22440 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
22441 # the policy in RouteRule.customErrorResponsePolicy takes
22442 # effect. If any of the requests in this example encounter a 500
22443 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
22444 #
22445 # When
22446 # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
22447 # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
22448 # a retry, if load balancer is successful in reaching the
22449 # service, the customErrorResponsePolicy is ignored and
22450 # the response from the service is returned to the client.
22451 #
22452 # customErrorResponsePolicy is supported only for
22453 # global external Application Load Balancers.
22454 # backend service or backend bucket responds with an error.
22455 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
22456 #
22457 # In a given policy, if you specify rules for both a range of error codes
22458 # as well as rules for specific error codes then rules with specific error
22459 # codes have a higher priority. For example, assume that you configure a rule
22460 # for 401 (Un-authorized) code, and another for all 4 series
22461 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
22462 # However if the backend service returns a 403, the rule for4xx takes effect.
22463 { # Specifies the mapping between the response code that will be returned along
22464 # with the custom error content and the response code returned by the backend
22465 # service.
22466 &quot;matchResponseCodes&quot;: [ # Valid values include:
22467 #
22468 #
22469 # - A number between 400 and 599: For example
22470 # 401 or 503, in which case the load balancer
22471 # applies the policy if the error code exactly matches this value.
22472 # - 5xx: Load Balancer will apply the policy if the
22473 # backend service responds with any response code in the range of
22474 # 500 to 599.
22475 # - 4xx: Load
22476 # Balancer will apply the policy if the backend service responds with any
22477 # response code in the range of 400 to
22478 # 499.
22479 #
22480 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
22481 &quot;A String&quot;,
22482 ],
22483 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
22484 # error content. If overrideResponseCode is not supplied, the
22485 # same response code returned by the original backend bucket or backend
22486 # service is returned to the client.
22487 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
22488 #
22489 # path must start
22490 # with a leading slash. path cannot have trailing slashes.
22491 #
22492 # If the file is not available in backendBucket or the
22493 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
22494 #
22495 # The value must
22496 # be from 1 to 1024 characters
22497 },
22498 ],
22499 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
22500 # contains the custom error content. Examples are:
22501 #
22502 #
22503 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
22504 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
22505 # - global/backendBuckets/myBackendBucket
22506 #
22507 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
22508 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
22509 #
22510 # If load balancer cannot reach
22511 # the backendBucket, a simple Not Found Error will
22512 # be returned, with the original response code (oroverrideResponseCode if configured).
22513 #
22514 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
22515 },
22516 &quot;description&quot;: &quot;A String&quot;, # The short description conveying the intent of this routeRule.
22517 #
22518 #
22519 # The description can have a maximum length of 1024 characters.
22520 &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
22521 # for the selected backendService.
22522 #
22523 # The headerAction value specified here is applied before the
22524 # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
22525 #
22526 # HeaderAction is not supported for load balancers
22527 # that have
22528 # their loadBalancingScheme set to EXTERNAL.
22529 #
22530 # Not supported when the URL map is bound to a target gRPC proxy that
22531 # has validateForProxyless field set to true.
22532 # the request is passed along to the selected backendService.
22533 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
22534 { # Specification determining how headers are added to requests or responses.
22535 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
22536 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
22537 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
22538 # that already
22539 # exist for the header. If true, headerValue is set for the
22540 # header, discarding any values that were set for that header.
22541 #
22542 # The default value is true,
22543 # unless a variable is present in headerValue,
22544 # in which case the default value is false.
22545 # .
22546 },
22547 ],
22548 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
22549 # request before forwarding the request to the backendService.
22550 &quot;A String&quot;,
22551 ],
22552 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
22553 # client.
22554 { # Specification determining how headers are added to requests or responses.
22555 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
22556 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
22557 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
22558 # that already
22559 # exist for the header. If true, headerValue is set for the
22560 # header, discarding any values that were set for that header.
22561 #
22562 # The default value is true,
22563 # unless a variable is present in headerValue,
22564 # in which case the default value is false.
22565 # .
22566 },
22567 ],
22568 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
22569 # response before sending the response back to the client.
22570 &quot;A String&quot;,
22571 ],
22572 },
22573 &quot;httpFilterConfigs&quot;: [ # Outbound route specific configuration fornetworkservices.HttpFilter resources enabled by Traffic
22574 # Director. httpFilterConfigs only applies for load balancers
22575 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
22576 # more details.
22577 #
22578 # Not supported when the URL map is bound to a target gRPC proxy that
22579 # has validateForProxyless field set to true.
22580 { # HttpFilterConfiguration supplies additional contextual settings
22581 # for networkservices.HttpFilter resources enabled by Traffic
22582 # Director.
22583 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
22584 # YAML formatted and only contain fields defined in the protobuf identified
22585 # in configTypeUrl
22586 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
22587 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
22588 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
22589 # configuration belongs to. This name must be known to the xDS client.
22590 # Example: envoy.wasm
22591 },
22592 ],
22593 &quot;httpFilterMetadata&quot;: [ # Outbound route specific metadata supplied tonetworkservices.HttpFilter resources enabled by Traffic
22594 # Director. httpFilterMetadata only applies for load balancers
22595 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
22596 # more details.
22597 #
22598 # The only configTypeUrl supported istype.googleapis.com/google.protobuf.Struct
22599 #
22600 # Not supported when the URL map is bound to a target gRPC proxy that
22601 # has validateForProxyless field set to true.
22602 { # HttpFilterConfiguration supplies additional contextual settings
22603 # for networkservices.HttpFilter resources enabled by Traffic
22604 # Director.
22605 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
22606 # YAML formatted and only contain fields defined in the protobuf identified
22607 # in configTypeUrl
22608 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
22609 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
22610 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
22611 # configuration belongs to. This name must be known to the xDS client.
22612 # Example: envoy.wasm
22613 },
22614 ],
22615 &quot;matchRules&quot;: [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
22616 # this routeRule when any of thematchRules are satisfied. However predicates within
22617 # a given matchRule have AND semantics. All predicates
22618 # within a matchRule must match for the request to
22619 # match the rule.
22620 { # HttpRouteRuleMatch specifies a set of criteria for matching
22621 # requests to an HttpRouteRule. All specified criteria must
22622 # be satisfied for a match to occur.
22623 &quot;fullPathMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
22624 # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
22625 # that may be part of the original URL.
22626 #
22627 # fullPathMatch must be from 1 to 1024 characters.
22628 #
22629 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
22630 # specified.
22631 &quot;headerMatches&quot;: [ # Specifies a list of header match criteria, all of which must match
22632 # corresponding headers in the request.
22633 { # matchRule criteria for request header matches.
22634 &quot;exactMatch&quot;: &quot;A String&quot;, # The value should exactly match contents of exactMatch.
22635 #
22636 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
22637 &quot;headerName&quot;: &quot;A String&quot;, # The name of the HTTP header to match.
22638 #
22639 # For matching against the HTTP request&#x27;s authority, use a headerMatch
22640 # with the header name &quot;:authority&quot;.
22641 #
22642 # For matching a request&#x27;s method, use the headerName &quot;:method&quot;.
22643 #
22644 # When the URL map is bound to a target gRPC proxy that has
22645 # the validateForProxyless field set to true, only
22646 # non-binary
22647 # user-specified custom metadata and the `content-type` header are supported.
22648 # The following transport-level headers cannot be used in header matching
22649 # rules:
22650 # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
22651 # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
22652 # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
22653 # `grpc-timeout` and `grpc-trace-bin`.
22654 &quot;invertMatch&quot;: True or False, # If set to false, the headerMatch is considered a
22655 # match if the preceding match criteria are met. If set to true,
22656 # the headerMatch is considered a match if the preceding
22657 # match criteria are NOT met.
22658 #
22659 # The default setting is false.
22660 &quot;prefixMatch&quot;: &quot;A String&quot;, # The value of the header must start with the contents ofprefixMatch.
22661 #
22662 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
22663 &quot;presentMatch&quot;: True or False, # A header with the contents of headerName must exist. The
22664 # match takes place whether or not the request&#x27;s header has a value.
22665 #
22666 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
22667 &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
22668 # specified in rangeMatch. If the header does not contain an
22669 # integer, number or is empty, the match fails.
22670 #
22671 # For example for a range [-5, 0]
22672 #
22673 #
22674 # - -3 will match.
22675 # - 0 will not match.
22676 # - 0.25 will not match.
22677 # - -3someString will not match.
22678 #
22679 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
22680 #
22681 # rangeMatch is not supported for load balancers
22682 # that have loadBalancingScheme set to EXTERNAL.
22683 # within the specified integer range.
22684 &quot;rangeEnd&quot;: &quot;A String&quot;, # The end of the range (exclusive) in signed long integer format.
22685 &quot;rangeStart&quot;: &quot;A String&quot;, # The start of the range (inclusive) in signed long integer format.
22686 },
22687 &quot;regexMatch&quot;: &quot;A String&quot;, # The value of the header must match the regular expression specified inregexMatch.
22688 # For more information about regular expression syntax, see Syntax.
22689 #
22690 # For matching against a port specified in the HTTP request, use a
22691 # headerMatch with headerName set to PORT and a regular expression that
22692 # satisfies the RFC2616 Host header&#x27;s port specifier.
22693 #
22694 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
22695 #
22696 # Regular expressions can only be used when the loadBalancingScheme is
22697 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
22698 # (regional scope) or INTERNAL_MANAGED.
22699 &quot;suffixMatch&quot;: &quot;A String&quot;, # The value of the header must end with the contents ofsuffixMatch.
22700 #
22701 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
22702 },
22703 ],
22704 &quot;ignoreCase&quot;: True or False, # Specifies that prefixMatch and fullPathMatch
22705 # matches are case sensitive.
22706 #
22707 # The default value is false.
22708 #
22709 # ignoreCase must not be used with regexMatch.
22710 #
22711 # Not supported when the URL map is bound to a target gRPC proxy.
22712 &quot;metadataFilters&quot;: [ # Opaque filter criteria used by the load balancer to restrict routing
22713 # configuration to a limited set of xDS
22714 # compliant clients. In their xDS requests to the load balancer, xDS clients
22715 # present node
22716 # metadata. When there is a match, the relevant routing configuration
22717 # is made available to those proxies.
22718 #
22719 # 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
22720 # the metadata. If its filterMatchCriteria is set to
22721 # MATCH_ALL, then all of its filterLabels must match with
22722 # corresponding labels provided in the metadata. If multiple
22723 # metadata filters are specified, all of them need to be
22724 # satisfied in order to be considered a match.
22725 #
22726 # metadataFilters specified here is applied after those
22727 # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
22728 #
22729 # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
22730 #
22731 # Not supported when the URL map is bound to a target gRPC proxy that
22732 # has validateForProxyless field set to true.
22733 { # Opaque filter criteria used by load balancers to restrict routing
22734 # configuration to a limited set of load balancing proxies. Proxies and
22735 # sidecars involved in load balancing would typically present metadata to the
22736 # load balancers that need to match criteria specified here. If a match takes
22737 # place, the relevant configuration is made available to those
22738 # proxies.
22739 #
22740 # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
22741 # one of thefilterLabels must match the corresponding label provided in
22742 # the metadata. If its filterMatchCriteria is set to
22743 # MATCH_ALL, then all of its filterLabels must match with
22744 # corresponding labels provided in the metadata.
22745 #
22746 # An example for using metadataFilters would be: if
22747 # load balancing involves
22748 # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in of their XDS requests to loadbalancers.
22749 &quot;filterLabels&quot;: [ # The list of label value pairs that must match labels in the provided
22750 # metadata based on filterMatchCriteria
22751 #
22752 # This list must not be empty and can have at the most 64 entries.
22753 { # MetadataFilter label name value pairs that are expected
22754 # to match corresponding labels presented as metadata to the load balancer.
22755 &quot;name&quot;: &quot;A String&quot;, # Name of metadata label.
22756 #
22757 # The name can have a maximum length of 1024 characters and must be at
22758 # least 1 character long.
22759 &quot;value&quot;: &quot;A String&quot;, # The value of the label must match the specified value.
22760 #
22761 # value can have a maximum length of 1024 characters.
22762 },
22763 ],
22764 &quot;filterMatchCriteria&quot;: &quot;A String&quot;, # Specifies how individual filter label matches
22765 # within the list of filterLabels and contributes toward the
22766 # overall metadataFilter match.
22767 #
22768 # Supported values are:
22769 #
22770 # - MATCH_ANY: at least one of the filterLabels
22771 # must have a matching label in the provided metadata.
22772 # - MATCH_ALL: all filterLabels must have
22773 # matching labels in the provided metadata.
22774 },
22775 ],
22776 &quot;pathTemplateMatch&quot;: &quot;A String&quot;, # If specified, this field defines a path template pattern that must match
22777 # the :path header after the query string is removed.
22778 #
22779 # A path template pattern can include variables and wildcards.
22780 # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
22781 # matches a single path segment, and ** that matches zero or
22782 # more path segments. The pattern must follow these rules:
22783 #
22784 #
22785 # - The value must be between 1 and 1024 characters.
22786 # - The pattern must start with a leading slash (&quot;/&quot;).
22787 # - No more than 5 operators (variables or wildcards) may appear in
22788 # the pattern.
22789 #
22790 # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
22791 # set.
22792 &quot;prefixMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the request&#x27;s
22793 # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
22794 #
22795 # The value must be from 1 to 1024 characters.
22796 #
22797 # The * character inside a prefix match is
22798 # treated as a literal character, not as a wildcard.
22799 #
22800 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
22801 # used within a matchRule.
22802 &quot;queryParameterMatches&quot;: [ # Specifies a list of query parameter match criteria, all of which must
22803 # match corresponding query parameters in the request.
22804 #
22805 # Not supported when the URL map is bound to a target gRPC proxy.
22806 { # HttpRouteRuleMatch criteria for a request&#x27;s query parameter.
22807 &quot;exactMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
22808 # parameter exactly matches the contents of exactMatch.
22809 #
22810 # Only one of presentMatch, exactMatch, orregexMatch must be set.
22811 &quot;name&quot;: &quot;A String&quot;, # The name of the query parameter to match. The query parameter must exist in
22812 # the request, in the absence of which the request match fails.
22813 &quot;presentMatch&quot;: True or False, # Specifies that the queryParameterMatch matches if the
22814 # request contains the query parameter, irrespective of whether the
22815 # parameter has a value or not.
22816 #
22817 # Only one of presentMatch, exactMatch, orregexMatch must be set.
22818 &quot;regexMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
22819 # parameter matches the regular expression specified byregexMatch. For
22820 # more information about regular expression syntax, see Syntax.
22821 #
22822 # Only one of presentMatch, exactMatch, orregexMatch must be set.
22823 #
22824 # Regular expressions can only be used when the loadBalancingScheme is
22825 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
22826 # (regional scope) or INTERNAL_MANAGED.
22827 },
22828 ],
22829 &quot;regexMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
22830 # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
22831 # supplied with the original URL. For
22832 # more information about regular expression syntax, see Syntax.
22833 #
22834 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
22835 # specified.
22836 #
22837 # Regular expressions can only be used when the loadBalancingScheme is
22838 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
22839 # (regional scope) or INTERNAL_MANAGED.
22840 },
22841 ],
22842 &quot;priority&quot;: 42, # For routeRules within a given pathMatcher,
22843 # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
22844 # of priority, from the lowest to highest number. The priority of a
22845 # rule decreases as its number increases (1, 2, 3, N+1). The first rule
22846 # that matches the request is applied.
22847 #
22848 #
22849 # You cannot configure two or more routeRules with the same priority.
22850 # Priority for each rule must be set to a number from 0 to 2147483647
22851 # inclusive.
22852 #
22853 #
22854 # Priority numbers can have gaps, which enable you to add or remove rules
22855 # in the future without affecting the rest of the rules. For example, 1, 2,
22856 # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
22857 # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
22858 # without any impact on existing rules.
22859 &quot;routeAction&quot;: { # In response to a matching matchRule, the load balancer
22860 # performs advanced routing actions, such as URL rewrites and header
22861 # transformations, before forwarding the request to the selected backend.
22862 #
22863 #
22864 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
22865 #
22866 #
22867 # URL maps for classic Application Load Balancers only support
22868 # the urlRewrite action within a route rule&#x27;srouteAction.
22869 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
22870 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
22871 # property must be specified. This policy cannot be specified if any target
22872 # backend has Identity-Aware Proxy enabled.
22873 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
22874 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
22875 # header names can be specified. The cache is bypassed for all `cacheMode`
22876 # values.
22877 &quot;A String&quot;,
22878 ],
22879 &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
22880 # on the backend type: for Backend Services, the complete request URI is
22881 # used; for Backend Buckets, the request URI is used without the protocol or
22882 # host, and only query parameters known to Cloud Storage are included.
22883 # Policy defined on Route Action.
22884 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
22885 # parameters will be included. Either specify `excludedQueryParameters`
22886 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
22887 # encoded and not treated as delimiters.
22888 #
22889 # Note: This field applies to routes that use backend services. Attempting
22890 # to set it on a route that points exclusively to Backend Buckets will
22891 # result in a configuration error. For routes that point to a Backend
22892 # Bucket, use `includedQueryParameters` to define which parameters should
22893 # be part of the cache key.
22894 &quot;A String&quot;,
22895 ],
22896 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
22897 #
22898 # Note: This setting is only applicable to routes that use a Backend
22899 # Service. It does not affect requests served by a Backend Bucket, as the
22900 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
22901 # it on a route that points exclusively to Backend Buckets will result in a
22902 # configuration error.
22903 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
22904 #
22905 # Note: This setting is only applicable to routes that use a Backend
22906 # Service. It does not affect requests served by a Backend Bucket, as the
22907 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
22908 # set on a route that points exclusively to Backend Buckets will result in
22909 # a configuration error.
22910 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
22911 # `includedQueryParameters` and `excludedQueryParameters`. If neither
22912 # is set, the entire query string will be included. If false, the query
22913 # string will be excluded from the cache key entirely.
22914 #
22915 # Note: This field applies to routes that use backend services. Attempting
22916 # to set it on a route that points exclusively to Backend Buckets will
22917 # result in a configuration error. For routes that point to a Backend
22918 # Bucket, use `includedQueryParameters` to define which parameters should
22919 # be part of the cache key.
22920 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
22921 # The name=value pair will be used in the cache key Cloud CDN generates.
22922 #
22923 # Note: This setting is only applicable to routes that use a Backend
22924 # Service. It does not affect requests served by a Backend Bucket.
22925 # Attempting to set it on a route that points exclusively to Backend
22926 # Buckets will result in a configuration error. Up to 5 cookie names can be
22927 # specified.
22928 &quot;A String&quot;,
22929 ],
22930 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
22931 &quot;A String&quot;,
22932 ],
22933 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
22934 # parameters will be excluded. Either specify `includedQueryParameters`
22935 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
22936 # encoded and not treated as delimiters.
22937 &quot;A String&quot;,
22938 ],
22939 },
22940 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
22941 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
22942 &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
22943 # content. This is used to clamp the max-age (or Expires) value sent to the
22944 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
22945 # is used for the response max-age directive, along with a &quot;public&quot;
22946 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
22947 # clamps the max-age from the origin (if specified), or else sets the
22948 # response max-age directive to the lesser of the `clientTtl` and
22949 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
22950 # present. The maximum allowed value is 31,622,400s (1 year). If not
22951 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
22952 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
22953 # `USE_ORIGIN_HEADERS`.
22954 # as a count of seconds and fractions of seconds at nanosecond
22955 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
22956 # or &quot;month&quot;. Range is approximately 10,000 years.
22957 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
22958 # Durations less than one second are represented with a 0
22959 # `seconds` field and a positive `nanos` field. Must be from 0
22960 # to 999,999,999 inclusive.
22961 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22962 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22963 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22964 },
22965 &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
22966 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
22967 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
22968 # greater than that of `maxTtl`. When the `cacheMode` is set to
22969 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
22970 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
22971 # accessed objects may be evicted from the cache before the defined TTL. If
22972 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
22973 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
22974 # `USE_ORIGIN_HEADERS`.
22975 # as a count of seconds and fractions of seconds at nanosecond
22976 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
22977 # or &quot;month&quot;. Range is approximately 10,000 years.
22978 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
22979 # Durations less than one second are represented with a 0
22980 # `seconds` field and a positive `nanos` field. Must be from 0
22981 # to 999,999,999 inclusive.
22982 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22983 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22984 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22985 },
22986 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
22987 # attempt to set a max-age or s-maxage higher than this, or an Expires header
22988 # more than `maxTtl` seconds in the future will be capped at the value of
22989 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
22990 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
22991 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
22992 # Infrequently accessed objects may be evicted from the cache before the
22993 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
22994 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
22995 # mode.
22996 # as a count of seconds and fractions of seconds at nanosecond
22997 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
22998 # or &quot;month&quot;. Range is approximately 10,000 years.
22999 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
23000 # Durations less than one second are represented with a 0
23001 # `seconds` field and a positive `nanos` field. Must be from 0
23002 # to 999,999,999 inclusive.
23003 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
23004 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
23005 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
23006 },
23007 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
23008 # to apply fine-grained caching for common errors or redirects.
23009 # This can reduce the load on your origin and improve end-user
23010 # experience by reducing response latency.
23011 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
23012 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
23013 # the specified response code that lack any Cache-Control, Expires, or
23014 # Pragma: no-cache directives. When the `cacheMode` is set to
23015 # `FORCE_CACHE_ALL`, negative caching applies to all responses
23016 # with the specified response code, and overrides any caching headers. By
23017 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
23018 #
23019 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
23020 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
23021 # * 405 (Method Not Found), 501 (Not Implemented): 60s
23022 #
23023 # These defaults can be overridden in `negativeCachingPolicy`.
23024 # If not specified, Cloud CDN applies negative caching by default.
23025 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
23026 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
23027 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
23028 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
23029 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
23030 # all response codes that you wish to cache. Cloud CDN will not apply any
23031 # default negative caching when a policy exists.
23032 { # Specify CDN TTLs for response error codes.
23033 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
23034 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
23035 # specified as values, and you cannot specify a status code more than
23036 # once.
23037 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
23038 # corresponding status code.
23039 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
23040 # objects may be evicted from the cache before the defined TTL.
23041 # as a count of seconds and fractions of seconds at nanosecond
23042 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
23043 # or &quot;month&quot;. Range is approximately 10,000 years.
23044 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
23045 # Durations less than one second are represented with a 0
23046 # `seconds` field and a positive `nanos` field. Must be from 0
23047 # to 999,999,999 inclusive.
23048 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
23049 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
23050 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
23051 },
23052 },
23053 ],
23054 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
23055 # requests into a small number of requests to the origin. If not specified,
23056 # Cloud CDN applies request coalescing by default.
23057 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
23058 # content with the origin, or when an error is encountered when refreshing
23059 # the cache.
23060 # This setting defines the default &quot;max-stale&quot; duration for any cached
23061 # responses that do not specify a max-stale directive. Stale responses that
23062 # exceed the TTL configured here will not be served. The default limit
23063 # (max-stale) is 86400s (1 day), which will allow stale content to be
23064 # served up to this limit beyond the max-age (or s-maxage) of a cached
23065 # response.
23066 # The maximum allowed value is 604800 (1 week).
23067 # Set this to zero (0) to disable serve-while-stale.
23068 # as a count of seconds and fractions of seconds at nanosecond
23069 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
23070 # or &quot;month&quot;. Range is approximately 10,000 years.
23071 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
23072 # Durations less than one second are represented with a 0
23073 # `seconds` field and a positive `nanos` field. Must be from 0
23074 # to 999,999,999 inclusive.
23075 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
23076 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
23077 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
23078 },
23079 },
23080 &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
23081 # information about the W3C recommendation for cross-origin resource sharing
23082 # (CORS), see Fetch API Living
23083 # Standard.
23084 #
23085 # Not supported when the URL map is bound to a target gRPC proxy.
23086 # information about the W3C recommendation for cross-origin resource sharing
23087 # (CORS), see Fetch API Living
23088 # Standard.
23089 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
23090 # indicates that
23091 # the actual request can include user credentials. This field translates to
23092 # the Access-Control-Allow-Credentials header.
23093 #
23094 # Default is false.
23095 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
23096 # header.
23097 &quot;A String&quot;,
23098 ],
23099 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
23100 # header.
23101 &quot;A String&quot;,
23102 ],
23103 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
23104 # more information, see regular expression syntax.
23105 #
23106 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
23107 #
23108 # Regular expressions can only be used when the loadBalancingScheme is
23109 # set to INTERNAL_SELF_MANAGED.
23110 &quot;A String&quot;,
23111 ],
23112 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
23113 #
23114 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
23115 &quot;A String&quot;,
23116 ],
23117 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
23118 # The default value is false, which indicates that the CORS
23119 # policy is in effect.
23120 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
23121 # header.
23122 &quot;A String&quot;,
23123 ],
23124 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
23125 # seconds. This field translates to the Access-Control-Max-Age
23126 # header.
23127 },
23128 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
23129 # the resiliency of clients to backend service failure. As part of fault
23130 # injection, when clients send requests to a backend service, delays can be
23131 # introduced by a load balancer on a percentage of requests before sending
23132 # those requests to the backend service. Similarly requests from clients can
23133 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
23134 # that are configured with a fault_injection_policy if:
23135 # 1. The traffic is generated by fault injection AND
23136 # 2. The fault injection is not a delay fault injection.
23137 # Fault injection is not supported with the classic Application Load Balancer
23138 # . To see which load balancers support fault injection,
23139 # see Load
23140 # balancing: Routing and traffic management features.
23141 # the resiliency of clients to backend service failure. As part of fault
23142 # injection, when clients send requests to a backend service, delays can be
23143 # introduced by the load balancer on a percentage of requests before sending
23144 # those request to the backend service. Similarly requests from clients can be
23145 # aborted by the load balancer for a percentage of requests.
23146 &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
23147 # injection.
23148 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
23149 #
23150 # The value must be from 200 to 599 inclusive.
23151 #
23152 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
23153 # according to this
23154 # mapping table. HTTP status 200 is mapped to gRPC status
23155 # UNKNOWN. Injecting an OK status is currently not supported by
23156 # Traffic Director.
23157 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
23158 # that is aborted as part of fault injection.
23159 #
23160 # The value must be from 0.0 to 100.0 inclusive.
23161 },
23162 &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
23163 # injection, before being sent to a backend service.
23164 # request to the backend service as part of fault injection.
23165 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
23166 # as a count of seconds and fractions of seconds at nanosecond
23167 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
23168 # or &quot;month&quot;. Range is approximately 10,000 years.
23169 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
23170 # Durations less than one second are represented with a 0
23171 # `seconds` field and a positive `nanos` field. Must be from 0
23172 # to 999,999,999 inclusive.
23173 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
23174 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
23175 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
23176 },
23177 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
23178 # which a delay is introduced as part of fault injection.
23179 #
23180 # The value must be from 0.0 to 100.0 inclusive.
23181 },
23182 },
23183 &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
23184 # Global EXTERNAL_MANAGED load balancer schemes.
23185 # Either Cloud CDN must be enabled on the backend service or backend bucket
23186 # serving the route, or cache policy must be configured on the same route
23187 # dynamically processes and delivers images from the network edge.
23188 # Image Optimization is only available for Global External Application Load
23189 # Balancers.
23190 # Either Cloud CDN must be enabled on the backend service or backend bucket
23191 # serving the route, or cache policy must be configured on the same route.
23192 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
23193 },
23194 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
23195 # Unlike the timeout field where the timeout duration starts
23196 # from the time the request has been fully processed (known as*end-of-stream*),
23197 # the duration in this field is computed from the beginning of the stream
23198 # until the response has been processed, including all retries. A
23199 # stream that does not complete in this duration is closed.
23200 #
23201 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
23202 # with the route.
23203 #
23204 # This field is only allowed if the Url map is used with backend services
23205 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
23206 # as a count of seconds and fractions of seconds at nanosecond
23207 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
23208 # or &quot;month&quot;. Range is approximately 10,000 years.
23209 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
23210 # Durations less than one second are represented with a 0
23211 # `seconds` field and a positive `nanos` field. Must be from 0
23212 # to 999,999,999 inclusive.
23213 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
23214 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
23215 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
23216 },
23217 &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
23218 # are shadowed to a separate mirrored backend service. The load balancer does
23219 # not wait for responses from the shadow service. Before sending traffic
23220 # to the shadow service, the host / authority header is suffixed with-shadow.
23221 #
23222 # Not supported when the URL map is bound to a target gRPC proxy that
23223 # has the validateForProxyless field set to true.
23224 # are shadowed to a separate mirrored backend service. The load balancer
23225 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
23226 # to the shadow service, the host or authority header is suffixed with-shadow.
23227 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
23228 # mirrored to.
23229 #
23230 # The backend service configured for a mirroring
23231 # policy must reference backends that are of the same type as the original
23232 # backend service matched in the URL map.
23233 #
23234 # Serverless NEG backends are not currently supported as a mirrored
23235 # backend service.
23236 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
23237 },
23238 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
23239 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
23240 # If not specified, defaults to 1.
23241 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
23242 #
23243 # If not specified, will use the timeout set in theHttpRouteAction field.
23244 # If timeout in the HttpRouteAction field is not set, this field
23245 # uses the largest timeout
23246 # among all backend services associated with the route.
23247 #
23248 # Not supported when the URL map is bound to a target gRPC proxy that
23249 # has the validateForProxyless field set to true.
23250 # as a count of seconds and fractions of seconds at nanosecond
23251 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
23252 # or &quot;month&quot;. Range is approximately 10,000 years.
23253 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
23254 # Durations less than one second are represented with a 0
23255 # `seconds` field and a positive `nanos` field. Must be from 0
23256 # to 999,999,999 inclusive.
23257 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
23258 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
23259 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
23260 },
23261 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
23262 # values are:
23263 #
23264 # - 5xx: retry is attempted if the instance or endpoint
23265 # responds with any 5xx response code, or if the instance or
23266 # endpoint does not respond at all. For example, disconnects, reset, read
23267 # timeout, connection failure, and refused streams.
23268 # - gateway-error: Similar to 5xx, but only
23269 # applies to response codes 502, 503 or504.
23270 # - connect-failure: a retry is attempted on failures
23271 # connecting to the instance or endpoint. For example, connection
23272 # timeouts.
23273 # - retriable-4xx: a retry is attempted if the instance
23274 # or endpoint responds with a 4xx response code.
23275 # The only error that you can retry is error code 409.
23276 # - refused-stream: a retry is attempted if the instance
23277 # or endpoint resets the stream with a REFUSED_STREAM error
23278 # code. This reset type indicates that it is safe to retry.
23279 # - cancelled: a retry is attempted if the gRPC status
23280 # code in the response header is set to cancelled.
23281 # - deadline-exceeded: a retry is attempted if the gRPC
23282 # status code in the response header is set todeadline-exceeded.
23283 # - internal: a retry is attempted if the gRPC
23284 # status code in the response header is set tointernal.
23285 # - resource-exhausted: a retry is attempted if the gRPC
23286 # status code in the response header is set toresource-exhausted.
23287 # - unavailable: a retry is attempted if the gRPC
23288 # status code in the response header is set tounavailable.
23289 #
23290 # Only the following codes are supported when the URL map is bound to
23291 # target gRPC proxy that has validateForProxyless field set to true.
23292 #
23293 # - cancelled
23294 # - deadline-exceeded
23295 # - internal
23296 # - resource-exhausted
23297 # - unavailable
23298 &quot;A String&quot;,
23299 ],
23300 },
23301 &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
23302 # time the request has been fully processed (known as *end-of-stream*)
23303 # up until the response has been processed. Timeout includes
23304 # all retries.
23305 #
23306 # If not specified, this field uses the largest timeout among all backend
23307 # services associated with the route.
23308 #
23309 # Not supported when the URL map is bound to a target gRPC proxy that
23310 # has validateForProxyless field set to true.
23311 # as a count of seconds and fractions of seconds at nanosecond
23312 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
23313 # or &quot;month&quot;. Range is approximately 10,000 years.
23314 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
23315 # Durations less than one second are represented with a 0
23316 # `seconds` field and a positive `nanos` field. Must be from 0
23317 # to 999,999,999 inclusive.
23318 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
23319 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
23320 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
23321 },
23322 &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
23323 # to the matched service.
23324 #
23325 # urlRewrite is the only action supported in UrlMaps
23326 # for classic Application Load Balancers.
23327 #
23328 # Not supported when the URL map is bound to a target gRPC proxy that
23329 # has the validateForProxyless field set to true.
23330 # backend service.
23331 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
23332 # host header is replaced with contents of hostRewrite.
23333 #
23334 # The value must be from 1 to 255 characters.
23335 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
23336 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
23337 #
23338 # The value must be from 1 to 1024 characters.
23339 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
23340 # header) using the HTTP template syntax.
23341 #
23342 # A corresponding
23343 # path_template_match must be specified. Any template variables must exist in
23344 # the path_template_match field.
23345 #
23346 #
23347 # - -At least one variable must be specified in the path_template_match
23348 # field
23349 # - You can omit variables from the rewritten URL
23350 # - The * and ** operators cannot be matched
23351 # unless they have a corresponding variable name - e.g.
23352 # {format=*} or {var=**}.
23353 #
23354 # For example, a path_template_match of /static/{format=**}
23355 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
23356 # rewrite, so that /{country}/{format}/{suffix=**} can be
23357 # rewritten as /content/{format}/{country}/{suffix}.
23358 #
23359 # At least
23360 # one non-empty routeRules[].matchRules[].path_template_match is
23361 # required.
23362 #
23363 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
23364 },
23365 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
23366 # occurs. The weights determine the fraction of traffic that flows to
23367 # their corresponding backend service. If all traffic needs to
23368 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
23369 #
23370 # After a backend service is identified and before forwarding
23371 # the request to
23372 # the backend service, advanced routing actions such as URL rewrites and
23373 # header transformations are applied depending on additional settings
23374 # specified in this HttpRouteAction.
23375 { # In contrast to a single BackendService in
23376 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
23377 # multiple backend services. The volume of traffic for each
23378 # backend service is proportional to the weight specified
23379 # in each WeightedBackendService
23380 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
23381 # resource. Before
23382 # forwarding the request to backendService, the load balancer
23383 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
23384 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
23385 # effect for the selected backendService.
23386 #
23387 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
23388 #
23389 # headerAction is not supported for load balancers that have
23390 # their loadBalancingScheme set to EXTERNAL.
23391 #
23392 # Not supported when the URL map is bound to a target gRPC proxy that
23393 # has validateForProxyless field set to true.
23394 # the request is passed along to the selected backendService.
23395 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
23396 { # Specification determining how headers are added to requests or responses.
23397 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
23398 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
23399 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
23400 # that already
23401 # exist for the header. If true, headerValue is set for the
23402 # header, discarding any values that were set for that header.
23403 #
23404 # The default value is true,
23405 # unless a variable is present in headerValue,
23406 # in which case the default value is false.
23407 # .
23408 },
23409 ],
23410 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
23411 # request before forwarding the request to the backendService.
23412 &quot;A String&quot;,
23413 ],
23414 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
23415 # client.
23416 { # Specification determining how headers are added to requests or responses.
23417 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
23418 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
23419 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
23420 # that already
23421 # exist for the header. If true, headerValue is set for the
23422 # header, discarding any values that were set for that header.
23423 #
23424 # The default value is true,
23425 # unless a variable is present in headerValue,
23426 # in which case the default value is false.
23427 # .
23428 },
23429 ],
23430 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
23431 # response before sending the response back to the client.
23432 &quot;A String&quot;,
23433 ],
23434 },
23435 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
23436 # computed asweight / (sum of all weightedBackendService weights in routeAction).
23437 #
23438 # The selection of a backend service is determined only for new traffic.
23439 # Once a user&#x27;s request has been directed to a backend service,
23440 # subsequent requests are sent to the same backend service as
23441 # determined by the backend service&#x27;s session affinity policy.
23442 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
23443 # splitting. If you do, the weighted traffic splitting configuration takes
23444 # precedence.
23445 #
23446 # The value must be from 0 to 1000.
23447 },
23448 ],
23449 },
23450 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
23451 # is directed if this rule is matched. If routeAction is
23452 # also specified, advanced routing actions, such as URL rewrites,
23453 # take effect before sending the request to the backend.
23454 #
23455 #
23456 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
23457 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
23458 # specified by urlRedirect.
23459 #
23460 #
23461 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
23462 #
23463 #
23464 # Not supported when the URL map is bound to a target gRPC proxy.
23465 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
23466 # was supplied in the request.
23467 #
23468 # The value must be from 1 to 255
23469 # characters.
23470 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
23471 # set to HTTPS.
23472 # If set to false, the URL scheme of the redirected request
23473 # remains the same as that of the request.
23474 #
23475 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
23476 #
23477 # The default is set to false.
23478 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
23479 # that was supplied in the request.
23480 #
23481 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
23482 # supplied, the path of the original request is used for the redirect.
23483 #
23484 # The value must be from 1 to 1024 characters.
23485 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
23486 # the HttpRouteRuleMatch, retaining the remaining portion
23487 # of the URL before redirecting the request.
23488 #
23489 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
23490 # supplied, the path of the original request is used for the redirect.
23491 #
23492 # The value must be from 1 to 1024 characters.
23493 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
23494 #
23495 # Supported values are:
23496 #
23497 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
23498 # to 301.
23499 # - FOUND, which corresponds to 302.
23500 # - SEE_OTHER which corresponds to 303.
23501 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
23502 # method is retained.
23503 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
23504 # method is retained.
23505 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
23506 # URL is
23507 # removed before redirecting the request. If set to false, the
23508 # query portion of the original URL is retained.
23509 #
23510 # The default is set to false.
23511 },
23512 },
23513 ],
23514 },
23515 ],
23516 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the regional URL map resides.
23517 # This field is not applicable to global URL maps.
23518 # You must specify this field as part of the HTTP request URL. It is
23519 # not settable as a field in the request body.
23520 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
23521 &quot;status&quot;: { # [Output Only] The status of the URL map. # Output only. [Output Only] The status of the URL map.
23522 &quot;quotaUsage&quot;: { # Message representing the quota usage for a UrlMap. # Output only. Summary of quota usage for given UrlMap.
23523 &quot;forwardingRules&quot;: 42, # Output only. The number of forwarding rules that uses this UrlMap.
23524 &quot;units&quot;: &quot;A String&quot;, # Output only. The number of quota units calculated for this UrlMap.
23525 },
23526 },
23527 &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
23528 # maximum of 100 tests per UrlMap.
23529 #
23530 # Not supported when the URL map is bound to a target gRPC proxy that
23531 # has validateForProxyless field set to true.
23532 { # Message for the expected URL mappings.
23533 &quot;description&quot;: &quot;A String&quot;, # Description of this test case.
23534 &quot;expectedOutputUrl&quot;: &quot;A String&quot;, # The expected output URL evaluated by the load balancer
23535 # containing the scheme, host, path and query parameters.
23536 #
23537 # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
23538 # the load balancer to backends. For rules with urlRewrite,
23539 # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
23540 #
23541 # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer&#x27;s
23542 # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
23543 # If urlRedirect specifies strip_query, the test
23544 # passes only if expectedOutputUrl does not contain any query
23545 # parameters.
23546 #
23547 # expectedOutputUrl is optional whenservice is specified.
23548 &quot;expectedRedirectResponseCode&quot;: 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
23549 # load balancer&#x27;s redirect response.
23550 #
23551 # expectedRedirectResponseCode cannot be set whenservice is set.
23552 &quot;headers&quot;: [ # HTTP headers for this request. If headers contains
23553 # a host header, then host must also match the header value.
23554 { # HTTP headers used in UrlMapTests.
23555 &quot;name&quot;: &quot;A String&quot;, # Header name.
23556 &quot;value&quot;: &quot;A String&quot;, # Header value.
23557 },
23558 ],
23559 &quot;host&quot;: &quot;A String&quot;, # Host portion of the URL. If headers contains a host header,
23560 # then host must also match the header value.
23561 &quot;path&quot;: &quot;A String&quot;, # Path portion of the URL.
23562 &quot;service&quot;: &quot;A String&quot;, # Expected BackendService or BackendBucket resource
23563 # the given URL should be mapped to.
23564 #
23565 # The service field cannot
23566 # be set if expectedRedirectResponseCode is set.
23567 },
23568 ],
23569 }
23570
23571 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
23572 that if you must retry your request, the server will know to ignore the
23573 request if it has already been completed.
23574
23575 For example, consider a situation where you make an initial request and
23576 the request times out. If you make the request again with the same
23577 request ID, the server can check if original operation with the same
23578 request ID was received, and if so, will ignore the second request. This
23579 prevents clients from accidentally creating duplicate commitments.
23580
23581 The request ID must be
23582 a valid UUID with the exception that zero UUID is not supported
23583 (00000000-0000-0000-0000-000000000000).
23584 x__xgafv: string, V1 error format.
23585 Allowed values
23586 1 - v1 error format
23587 2 - v2 error format
23588
23589 Returns:
23590 An object of the form:
23591
23592 { # Represents an Operation resource.
23593 #
23594 # Google Compute Engine has three Operation resources:
23595 #
23596 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
23597 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
23598 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
23599 #
23600 # You can use an operation resource to manage asynchronous API requests.
23601 # For more information, readHandling
23602 # API responses.
23603 #
23604 # Operations can be global, regional or zonal.
23605 #
23606 # - For global operations, use the `globalOperations`
23607 # resource.
23608 # - For regional operations, use the
23609 # `regionOperations` resource.
23610 # - For zonal operations, use
23611 # the `zoneOperations` resource.
23612 #
23613 #
23614 #
23615 # For more information, read
23616 # Global, Regional, and Zonal Resources.
23617 #
23618 # Note that completed Operation resources have a limited
23619 # retention period.
23620 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
23621 # Not present otherwise.
23622 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
23623 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
23624 # set when the operation is created.
23625 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
23626 # text format.
23627 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
23628 # this field will be populated.
23629 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
23630 # operation.
23631 {
23632 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
23633 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
23634 # details. There is a set of defined message types to use for providing
23635 # details.The syntax depends on the error code. For example,
23636 # QuotaExceededInfo will have details when the error code is
23637 # QUOTA_EXCEEDED.
23638 {
23639 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
23640 #
23641 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
23642 # is not enabled:
23643 #
23644 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
23645 # &quot;domain&quot;: &quot;googleapis.com&quot;
23646 # &quot;metadata&quot;: {
23647 # &quot;resource&quot;: &quot;projects/123&quot;,
23648 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
23649 # }
23650 # }
23651 #
23652 # This response indicates that the pubsub.googleapis.com API is not enabled.
23653 #
23654 # Example of an error that is returned when attempting to create a Spanner
23655 # instance in a region that is out of stock:
23656 #
23657 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
23658 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
23659 # &quot;metadata&quot;: {
23660 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
23661 # }
23662 # }
23663 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
23664 # is typically the registered service name of the tool or product that
23665 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
23666 # generated by some common infrastructure, the error domain must be a
23667 # globally unique value that identifies the infrastructure. For Google API
23668 # infrastructure, the error domain is &quot;googleapis.com&quot;.
23669 &quot;metadatas&quot;: { # Additional structured details about this error.
23670 #
23671 # Keys must match a regular expression of `a-z+` but should
23672 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
23673 # length. When identifying the current value of an exceeded limit, the units
23674 # should be contained in the key, not the value. For example, rather than
23675 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
23676 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
23677 # instances that can be created in a single (batch) request.
23678 &quot;a_key&quot;: &quot;A String&quot;,
23679 },
23680 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
23681 # proximate cause of the error. Error reasons are unique within a particular
23682 # domain of errors. This should be at most 63 characters and match a
23683 # regular expression of `A-Z+[A-Z0-9]`, which represents
23684 # UPPER_SNAKE_CASE.
23685 },
23686 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
23687 #
23688 # For example, if a quota check failed with an error indicating the calling
23689 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
23690 # directly to the right place in the developer console to flip the bit.
23691 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
23692 { # Describes a URL link.
23693 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
23694 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
23695 },
23696 ],
23697 },
23698 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
23699 # which can be attached to an RPC error.
23700 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
23701 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
23702 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
23703 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
23704 },
23705 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
23706 &quot;dimensions&quot;: { # The map holding related quota dimensions.
23707 &quot;a_key&quot;: &quot;A String&quot;,
23708 },
23709 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
23710 # type or metric.
23711 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
23712 # or metric.
23713 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
23714 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
23715 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
23716 },
23717 },
23718 ],
23719 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
23720 # This property is optional.
23721 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
23722 },
23723 ],
23724 },
23725 &quot;getVersionOperationMetadata&quot;: {
23726 &quot;inlineSbomInfo&quot;: {
23727 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
23728 # appropriate identifiers.
23729 &quot;a_key&quot;: &quot;A String&quot;,
23730 },
23731 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
23732 # identifiers.
23733 &quot;a_key&quot;: &quot;A String&quot;,
23734 },
23735 },
23736 },
23737 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
23738 # message that was returned, such as `NOT FOUND`.
23739 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
23740 # status code that was returned. For example, a `404` means the
23741 # resource was not found.
23742 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
23743 # defined by the server.
23744 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
23745 # This value is inRFC3339
23746 # text format.
23747 &quot;instancesBulkInsertOperationMetadata&quot;: {
23748 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
23749 # Example key: zones/us-central1-a
23750 &quot;a_key&quot;: {
23751 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
23752 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
23753 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
23754 # error.
23755 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
23756 # if the flow is rolling forward or rolling back.
23757 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
23758 },
23759 },
23760 },
23761 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
23762 # Operation resources.
23763 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
23764 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
23765 # group of operations results from a `bulkInsert` API request.
23766 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
23767 # `update`, or `delete`, and so on.
23768 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
23769 # There is no requirement that this be linear or support any granularity of
23770 # operations. This should not be used to guess when the operation will be
23771 # complete. This number should monotonically increase as the operation
23772 # progresses.
23773 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
23774 # applicable when performing regional operations.
23775 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
23776 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
23777 # this field will contain information on all underlying zonal actions and
23778 # their state.
23779 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
23780 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
23781 # Example key: zones/us-central1-a
23782 &quot;a_key&quot;: {
23783 &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
23784 # populated.
23785 # different programming environments, including REST APIs and RPC APIs. It is
23786 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
23787 # three pieces of data: error code, error message, and error details.
23788 #
23789 # You can find out more about this error model and how to work with it in the
23790 # [API Design Guide](https://cloud.google.com/apis/design/errors).
23791 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
23792 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
23793 # message types for APIs to use.
23794 {
23795 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
23796 },
23797 ],
23798 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
23799 # user-facing error message should be localized and sent in the
23800 # google.rpc.Status.details field, or localized by the client.
23801 },
23802 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
23803 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
23804 },
23805 },
23806 },
23807 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
23808 # This value is inRFC3339
23809 # text format.
23810 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
23811 # following:
23812 # `PENDING`, `RUNNING`, or `DONE`.
23813 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
23814 # operation.
23815 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
23816 # of the target resource.
23817 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
23818 # operations related to creating a snapshot, this points to the disk
23819 # that the snapshot was created from.
23820 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
23821 # `[email protected]` or
23822 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
23823 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
23824 # operation, this field will be populated.
23825 {
23826 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
23827 # Engine returns NO_RESULTS_ON_PAGE if there
23828 # are no results in the response.
23829 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
23830 # value format. For example:
23831 #
23832 # &quot;data&quot;: [
23833 # {
23834 # &quot;key&quot;: &quot;scope&quot;,
23835 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
23836 # }
23837 {
23838 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
23839 # returned. For example, for warnings where there are no results in a list
23840 # request for a particular zone, this key might be scope and
23841 # the key value might be the zone name. Other examples might be a key
23842 # indicating a deprecated resource and a suggested replacement, or a
23843 # warning about invalid network settings (for example, if an instance
23844 # attempts to perform IP forwarding but is not enabled for IP forwarding).
23845 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
23846 },
23847 ],
23848 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
23849 },
23850 ],
23851 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
23852 # applicable when performing per-zone operations.
23853 }</pre>
23854 </div>
23855
23856 <div class="method">
23857 <code class="details" id="validate">validate(project, urlMap, body=None, x__xgafv=None)</code>
23858 <pre>Runs static validation for the UrlMap. In particular, the tests of the
23859 provided UrlMap will be run. Calling this method does NOT create the
23860 UrlMap.
23861
23862 Args:
23863 project: string, Project ID for this request. (required)
23864 urlMap: string, Name of the UrlMap resource to be validated as. (required)
23865 body: object, The request body.
23866 The object takes the form of:
23867
23868 {
23869 &quot;loadBalancingSchemes&quot;: [ # Specifies the load balancer type(s) this validation request is for. UseEXTERNAL_MANAGED for global external Application Load
23870 # Balancers and regional external Application Load Balancers.
23871 # Use EXTERNAL for classic Application Load Balancers.
23872 #
23873 # Use INTERNAL_MANAGED for internal Application Load Balancers. For more
23874 # information, refer to Choosing
23875 # a load balancer.
23876 #
23877 # If unspecified, the load balancing scheme will be inferred from the backend
23878 # service resources this URL map references. If that can not be inferred (for
23879 # example, this URL map only references backend buckets, or this Url map is
23880 # for rewrites and redirects only and doesn&#x27;t reference any backends),EXTERNAL will be used as the default type.
23881 #
23882 # If specified, the scheme(s) must not conflict with the load balancing
23883 # scheme of the backend service resources this Url map references.
23884 &quot;A String&quot;,
23885 ],
23886 &quot;resource&quot;: { # Represents a URL Map resource. # Content of the UrlMap to be validated.
23887 #
23888 # Compute Engine has two URL Map resources:
23889 #
23890 # * [Global](/compute/docs/reference/rest/beta/urlMaps)
23891 # * [Regional](/compute/docs/reference/rest/beta/regionUrlMaps)
23892 #
23893 # A URL map resource is a component of certain types of cloud load balancers
23894 # and Traffic Director:
23895 #
23896 # * urlMaps are used by global external Application Load
23897 # Balancers, classic Application Load Balancers, and cross-region internal
23898 # Application Load Balancers.
23899 # * regionUrlMaps are used by internal Application Load Balancers,
23900 # regional external Application Load Balancers and regional internal
23901 # Application Load Balancers.
23902 #
23903 # For a list of supported URL map features by the load balancer type, see the
23904 # Load balancing features: Routing and traffic management table.
23905 #
23906 # For a list of supported URL map features for Traffic Director, see the
23907 # Traffic Director features: Routing and traffic management table.
23908 #
23909 # This resource defines mappings from hostnames and URL paths to either a
23910 # backend service or a backend bucket.
23911 #
23912 # To use the global urlMaps resource, the backend service must
23913 # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
23914 # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
23915 # information, read URL
23916 # Map Concepts.
23917 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
23918 # text format.
23919 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
23920 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
23921 #
23922 # This policy takes
23923 # effect at the load balancer level and applies only when no policy has been
23924 # defined for the error code at lower levels like PathMatcher, RouteRule and
23925 # PathRule within this UrlMap.
23926 #
23927 # For example, consider a UrlMap with the
23928 # following configuration:
23929 #
23930 #
23931 # - defaultCustomErrorResponsePolicy containing policies for
23932 # responding to 5xx and 4xx errors
23933 # - A PathMatcher configured for *.example.com has
23934 # defaultCustomErrorResponsePolicy for 4xx.
23935 #
23936 # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
23937 # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
23938 # a request that does not match any host in *.example.com such
23939 # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
23940 # takes effect.
23941 #
23942 # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
23943 # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
23944 # a retry, if load balancer is successful in reaching the
23945 # service, the defaultCustomErrorResponsePolicy is ignored and
23946 # the response from the service is returned to the client.
23947 #
23948 # defaultCustomErrorResponsePolicy is supported only for
23949 # global external Application Load Balancers.
23950 # backend service or backend bucket responds with an error.
23951 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
23952 #
23953 # In a given policy, if you specify rules for both a range of error codes
23954 # as well as rules for specific error codes then rules with specific error
23955 # codes have a higher priority. For example, assume that you configure a rule
23956 # for 401 (Un-authorized) code, and another for all 4 series
23957 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
23958 # However if the backend service returns a 403, the rule for4xx takes effect.
23959 { # Specifies the mapping between the response code that will be returned along
23960 # with the custom error content and the response code returned by the backend
23961 # service.
23962 &quot;matchResponseCodes&quot;: [ # Valid values include:
23963 #
23964 #
23965 # - A number between 400 and 599: For example
23966 # 401 or 503, in which case the load balancer
23967 # applies the policy if the error code exactly matches this value.
23968 # - 5xx: Load Balancer will apply the policy if the
23969 # backend service responds with any response code in the range of
23970 # 500 to 599.
23971 # - 4xx: Load
23972 # Balancer will apply the policy if the backend service responds with any
23973 # response code in the range of 400 to
23974 # 499.
23975 #
23976 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
23977 &quot;A String&quot;,
23978 ],
23979 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
23980 # error content. If overrideResponseCode is not supplied, the
23981 # same response code returned by the original backend bucket or backend
23982 # service is returned to the client.
23983 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
23984 #
23985 # path must start
23986 # with a leading slash. path cannot have trailing slashes.
23987 #
23988 # If the file is not available in backendBucket or the
23989 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
23990 #
23991 # The value must
23992 # be from 1 to 1024 characters
23993 },
23994 ],
23995 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
23996 # contains the custom error content. Examples are:
23997 #
23998 #
23999 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
24000 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
24001 # - global/backendBuckets/myBackendBucket
24002 #
24003 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
24004 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
24005 #
24006 # If load balancer cannot reach
24007 # the backendBucket, a simple Not Found Error will
24008 # be returned, with the original response code (oroverrideResponseCode if configured).
24009 #
24010 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
24011 },
24012 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
24013 # hostRules match. The load balancer performs advanced routing
24014 # actions, such as URL rewrites and header transformations, before forwarding
24015 # the request to the selected backend.
24016 #
24017 #
24018 # Only one of defaultUrlRedirect, defaultService
24019 # or defaultRouteAction.weightedBackendService can be set.
24020 #
24021 #
24022 # URL maps for classic Application Load Balancers only support
24023 # the urlRewrite action within defaultRouteAction.
24024 #
24025 #
24026 # defaultRouteAction has no effect when the URL map is bound
24027 # to a target gRPC proxy that has the validateForProxyless field
24028 # set to true.
24029 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
24030 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
24031 # property must be specified. This policy cannot be specified if any target
24032 # backend has Identity-Aware Proxy enabled.
24033 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
24034 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
24035 # header names can be specified. The cache is bypassed for all `cacheMode`
24036 # values.
24037 &quot;A String&quot;,
24038 ],
24039 &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
24040 # on the backend type: for Backend Services, the complete request URI is
24041 # used; for Backend Buckets, the request URI is used without the protocol or
24042 # host, and only query parameters known to Cloud Storage are included.
24043 # Policy defined on Route Action.
24044 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
24045 # parameters will be included. Either specify `excludedQueryParameters`
24046 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
24047 # encoded and not treated as delimiters.
24048 #
24049 # Note: This field applies to routes that use backend services. Attempting
24050 # to set it on a route that points exclusively to Backend Buckets will
24051 # result in a configuration error. For routes that point to a Backend
24052 # Bucket, use `includedQueryParameters` to define which parameters should
24053 # be part of the cache key.
24054 &quot;A String&quot;,
24055 ],
24056 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
24057 #
24058 # Note: This setting is only applicable to routes that use a Backend
24059 # Service. It does not affect requests served by a Backend Bucket, as the
24060 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
24061 # it on a route that points exclusively to Backend Buckets will result in a
24062 # configuration error.
24063 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
24064 #
24065 # Note: This setting is only applicable to routes that use a Backend
24066 # Service. It does not affect requests served by a Backend Bucket, as the
24067 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
24068 # set on a route that points exclusively to Backend Buckets will result in
24069 # a configuration error.
24070 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
24071 # `includedQueryParameters` and `excludedQueryParameters`. If neither
24072 # is set, the entire query string will be included. If false, the query
24073 # string will be excluded from the cache key entirely.
24074 #
24075 # Note: This field applies to routes that use backend services. Attempting
24076 # to set it on a route that points exclusively to Backend Buckets will
24077 # result in a configuration error. For routes that point to a Backend
24078 # Bucket, use `includedQueryParameters` to define which parameters should
24079 # be part of the cache key.
24080 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
24081 # The name=value pair will be used in the cache key Cloud CDN generates.
24082 #
24083 # Note: This setting is only applicable to routes that use a Backend
24084 # Service. It does not affect requests served by a Backend Bucket.
24085 # Attempting to set it on a route that points exclusively to Backend
24086 # Buckets will result in a configuration error. Up to 5 cookie names can be
24087 # specified.
24088 &quot;A String&quot;,
24089 ],
24090 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
24091 &quot;A String&quot;,
24092 ],
24093 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
24094 # parameters will be excluded. Either specify `includedQueryParameters`
24095 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
24096 # encoded and not treated as delimiters.
24097 &quot;A String&quot;,
24098 ],
24099 },
24100 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
24101 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
24102 &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
24103 # content. This is used to clamp the max-age (or Expires) value sent to the
24104 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
24105 # is used for the response max-age directive, along with a &quot;public&quot;
24106 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
24107 # clamps the max-age from the origin (if specified), or else sets the
24108 # response max-age directive to the lesser of the `clientTtl` and
24109 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
24110 # present. The maximum allowed value is 31,622,400s (1 year). If not
24111 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
24112 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
24113 # `USE_ORIGIN_HEADERS`.
24114 # as a count of seconds and fractions of seconds at nanosecond
24115 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
24116 # or &quot;month&quot;. Range is approximately 10,000 years.
24117 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
24118 # Durations less than one second are represented with a 0
24119 # `seconds` field and a positive `nanos` field. Must be from 0
24120 # to 999,999,999 inclusive.
24121 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
24122 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
24123 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
24124 },
24125 &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
24126 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
24127 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
24128 # greater than that of `maxTtl`. When the `cacheMode` is set to
24129 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
24130 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
24131 # accessed objects may be evicted from the cache before the defined TTL. If
24132 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
24133 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
24134 # `USE_ORIGIN_HEADERS`.
24135 # as a count of seconds and fractions of seconds at nanosecond
24136 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
24137 # or &quot;month&quot;. Range is approximately 10,000 years.
24138 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
24139 # Durations less than one second are represented with a 0
24140 # `seconds` field and a positive `nanos` field. Must be from 0
24141 # to 999,999,999 inclusive.
24142 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
24143 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
24144 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
24145 },
24146 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
24147 # attempt to set a max-age or s-maxage higher than this, or an Expires header
24148 # more than `maxTtl` seconds in the future will be capped at the value of
24149 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
24150 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
24151 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
24152 # Infrequently accessed objects may be evicted from the cache before the
24153 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
24154 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
24155 # mode.
24156 # as a count of seconds and fractions of seconds at nanosecond
24157 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
24158 # or &quot;month&quot;. Range is approximately 10,000 years.
24159 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
24160 # Durations less than one second are represented with a 0
24161 # `seconds` field and a positive `nanos` field. Must be from 0
24162 # to 999,999,999 inclusive.
24163 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
24164 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
24165 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
24166 },
24167 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
24168 # to apply fine-grained caching for common errors or redirects.
24169 # This can reduce the load on your origin and improve end-user
24170 # experience by reducing response latency.
24171 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
24172 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
24173 # the specified response code that lack any Cache-Control, Expires, or
24174 # Pragma: no-cache directives. When the `cacheMode` is set to
24175 # `FORCE_CACHE_ALL`, negative caching applies to all responses
24176 # with the specified response code, and overrides any caching headers. By
24177 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
24178 #
24179 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
24180 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
24181 # * 405 (Method Not Found), 501 (Not Implemented): 60s
24182 #
24183 # These defaults can be overridden in `negativeCachingPolicy`.
24184 # If not specified, Cloud CDN applies negative caching by default.
24185 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
24186 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
24187 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
24188 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
24189 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
24190 # all response codes that you wish to cache. Cloud CDN will not apply any
24191 # default negative caching when a policy exists.
24192 { # Specify CDN TTLs for response error codes.
24193 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
24194 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
24195 # specified as values, and you cannot specify a status code more than
24196 # once.
24197 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
24198 # corresponding status code.
24199 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
24200 # objects may be evicted from the cache before the defined TTL.
24201 # as a count of seconds and fractions of seconds at nanosecond
24202 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
24203 # or &quot;month&quot;. Range is approximately 10,000 years.
24204 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
24205 # Durations less than one second are represented with a 0
24206 # `seconds` field and a positive `nanos` field. Must be from 0
24207 # to 999,999,999 inclusive.
24208 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
24209 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
24210 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
24211 },
24212 },
24213 ],
24214 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
24215 # requests into a small number of requests to the origin. If not specified,
24216 # Cloud CDN applies request coalescing by default.
24217 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
24218 # content with the origin, or when an error is encountered when refreshing
24219 # the cache.
24220 # This setting defines the default &quot;max-stale&quot; duration for any cached
24221 # responses that do not specify a max-stale directive. Stale responses that
24222 # exceed the TTL configured here will not be served. The default limit
24223 # (max-stale) is 86400s (1 day), which will allow stale content to be
24224 # served up to this limit beyond the max-age (or s-maxage) of a cached
24225 # response.
24226 # The maximum allowed value is 604800 (1 week).
24227 # Set this to zero (0) to disable serve-while-stale.
24228 # as a count of seconds and fractions of seconds at nanosecond
24229 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
24230 # or &quot;month&quot;. Range is approximately 10,000 years.
24231 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
24232 # Durations less than one second are represented with a 0
24233 # `seconds` field and a positive `nanos` field. Must be from 0
24234 # to 999,999,999 inclusive.
24235 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
24236 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
24237 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
24238 },
24239 },
24240 &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
24241 # information about the W3C recommendation for cross-origin resource sharing
24242 # (CORS), see Fetch API Living
24243 # Standard.
24244 #
24245 # Not supported when the URL map is bound to a target gRPC proxy.
24246 # information about the W3C recommendation for cross-origin resource sharing
24247 # (CORS), see Fetch API Living
24248 # Standard.
24249 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
24250 # indicates that
24251 # the actual request can include user credentials. This field translates to
24252 # the Access-Control-Allow-Credentials header.
24253 #
24254 # Default is false.
24255 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
24256 # header.
24257 &quot;A String&quot;,
24258 ],
24259 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
24260 # header.
24261 &quot;A String&quot;,
24262 ],
24263 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
24264 # more information, see regular expression syntax.
24265 #
24266 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
24267 #
24268 # Regular expressions can only be used when the loadBalancingScheme is
24269 # set to INTERNAL_SELF_MANAGED.
24270 &quot;A String&quot;,
24271 ],
24272 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
24273 #
24274 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
24275 &quot;A String&quot;,
24276 ],
24277 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
24278 # The default value is false, which indicates that the CORS
24279 # policy is in effect.
24280 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
24281 # header.
24282 &quot;A String&quot;,
24283 ],
24284 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
24285 # seconds. This field translates to the Access-Control-Max-Age
24286 # header.
24287 },
24288 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
24289 # the resiliency of clients to backend service failure. As part of fault
24290 # injection, when clients send requests to a backend service, delays can be
24291 # introduced by a load balancer on a percentage of requests before sending
24292 # those requests to the backend service. Similarly requests from clients can
24293 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
24294 # that are configured with a fault_injection_policy if:
24295 # 1. The traffic is generated by fault injection AND
24296 # 2. The fault injection is not a delay fault injection.
24297 # Fault injection is not supported with the classic Application Load Balancer
24298 # . To see which load balancers support fault injection,
24299 # see Load
24300 # balancing: Routing and traffic management features.
24301 # the resiliency of clients to backend service failure. As part of fault
24302 # injection, when clients send requests to a backend service, delays can be
24303 # introduced by the load balancer on a percentage of requests before sending
24304 # those request to the backend service. Similarly requests from clients can be
24305 # aborted by the load balancer for a percentage of requests.
24306 &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
24307 # injection.
24308 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
24309 #
24310 # The value must be from 200 to 599 inclusive.
24311 #
24312 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
24313 # according to this
24314 # mapping table. HTTP status 200 is mapped to gRPC status
24315 # UNKNOWN. Injecting an OK status is currently not supported by
24316 # Traffic Director.
24317 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
24318 # that is aborted as part of fault injection.
24319 #
24320 # The value must be from 0.0 to 100.0 inclusive.
24321 },
24322 &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
24323 # injection, before being sent to a backend service.
24324 # request to the backend service as part of fault injection.
24325 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
24326 # as a count of seconds and fractions of seconds at nanosecond
24327 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
24328 # or &quot;month&quot;. Range is approximately 10,000 years.
24329 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
24330 # Durations less than one second are represented with a 0
24331 # `seconds` field and a positive `nanos` field. Must be from 0
24332 # to 999,999,999 inclusive.
24333 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
24334 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
24335 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
24336 },
24337 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
24338 # which a delay is introduced as part of fault injection.
24339 #
24340 # The value must be from 0.0 to 100.0 inclusive.
24341 },
24342 },
24343 &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
24344 # Global EXTERNAL_MANAGED load balancer schemes.
24345 # Either Cloud CDN must be enabled on the backend service or backend bucket
24346 # serving the route, or cache policy must be configured on the same route
24347 # dynamically processes and delivers images from the network edge.
24348 # Image Optimization is only available for Global External Application Load
24349 # Balancers.
24350 # Either Cloud CDN must be enabled on the backend service or backend bucket
24351 # serving the route, or cache policy must be configured on the same route.
24352 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
24353 },
24354 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
24355 # Unlike the timeout field where the timeout duration starts
24356 # from the time the request has been fully processed (known as*end-of-stream*),
24357 # the duration in this field is computed from the beginning of the stream
24358 # until the response has been processed, including all retries. A
24359 # stream that does not complete in this duration is closed.
24360 #
24361 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
24362 # with the route.
24363 #
24364 # This field is only allowed if the Url map is used with backend services
24365 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
24366 # as a count of seconds and fractions of seconds at nanosecond
24367 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
24368 # or &quot;month&quot;. Range is approximately 10,000 years.
24369 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
24370 # Durations less than one second are represented with a 0
24371 # `seconds` field and a positive `nanos` field. Must be from 0
24372 # to 999,999,999 inclusive.
24373 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
24374 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
24375 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
24376 },
24377 &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
24378 # are shadowed to a separate mirrored backend service. The load balancer does
24379 # not wait for responses from the shadow service. Before sending traffic
24380 # to the shadow service, the host / authority header is suffixed with-shadow.
24381 #
24382 # Not supported when the URL map is bound to a target gRPC proxy that
24383 # has the validateForProxyless field set to true.
24384 # are shadowed to a separate mirrored backend service. The load balancer
24385 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
24386 # to the shadow service, the host or authority header is suffixed with-shadow.
24387 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
24388 # mirrored to.
24389 #
24390 # The backend service configured for a mirroring
24391 # policy must reference backends that are of the same type as the original
24392 # backend service matched in the URL map.
24393 #
24394 # Serverless NEG backends are not currently supported as a mirrored
24395 # backend service.
24396 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
24397 },
24398 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
24399 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
24400 # If not specified, defaults to 1.
24401 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
24402 #
24403 # If not specified, will use the timeout set in theHttpRouteAction field.
24404 # If timeout in the HttpRouteAction field is not set, this field
24405 # uses the largest timeout
24406 # among all backend services associated with the route.
24407 #
24408 # Not supported when the URL map is bound to a target gRPC proxy that
24409 # has the validateForProxyless field set to true.
24410 # as a count of seconds and fractions of seconds at nanosecond
24411 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
24412 # or &quot;month&quot;. Range is approximately 10,000 years.
24413 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
24414 # Durations less than one second are represented with a 0
24415 # `seconds` field and a positive `nanos` field. Must be from 0
24416 # to 999,999,999 inclusive.
24417 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
24418 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
24419 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
24420 },
24421 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
24422 # values are:
24423 #
24424 # - 5xx: retry is attempted if the instance or endpoint
24425 # responds with any 5xx response code, or if the instance or
24426 # endpoint does not respond at all. For example, disconnects, reset, read
24427 # timeout, connection failure, and refused streams.
24428 # - gateway-error: Similar to 5xx, but only
24429 # applies to response codes 502, 503 or504.
24430 # - connect-failure: a retry is attempted on failures
24431 # connecting to the instance or endpoint. For example, connection
24432 # timeouts.
24433 # - retriable-4xx: a retry is attempted if the instance
24434 # or endpoint responds with a 4xx response code.
24435 # The only error that you can retry is error code 409.
24436 # - refused-stream: a retry is attempted if the instance
24437 # or endpoint resets the stream with a REFUSED_STREAM error
24438 # code. This reset type indicates that it is safe to retry.
24439 # - cancelled: a retry is attempted if the gRPC status
24440 # code in the response header is set to cancelled.
24441 # - deadline-exceeded: a retry is attempted if the gRPC
24442 # status code in the response header is set todeadline-exceeded.
24443 # - internal: a retry is attempted if the gRPC
24444 # status code in the response header is set tointernal.
24445 # - resource-exhausted: a retry is attempted if the gRPC
24446 # status code in the response header is set toresource-exhausted.
24447 # - unavailable: a retry is attempted if the gRPC
24448 # status code in the response header is set tounavailable.
24449 #
24450 # Only the following codes are supported when the URL map is bound to
24451 # target gRPC proxy that has validateForProxyless field set to true.
24452 #
24453 # - cancelled
24454 # - deadline-exceeded
24455 # - internal
24456 # - resource-exhausted
24457 # - unavailable
24458 &quot;A String&quot;,
24459 ],
24460 },
24461 &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
24462 # time the request has been fully processed (known as *end-of-stream*)
24463 # up until the response has been processed. Timeout includes
24464 # all retries.
24465 #
24466 # If not specified, this field uses the largest timeout among all backend
24467 # services associated with the route.
24468 #
24469 # Not supported when the URL map is bound to a target gRPC proxy that
24470 # has validateForProxyless field set to true.
24471 # as a count of seconds and fractions of seconds at nanosecond
24472 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
24473 # or &quot;month&quot;. Range is approximately 10,000 years.
24474 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
24475 # Durations less than one second are represented with a 0
24476 # `seconds` field and a positive `nanos` field. Must be from 0
24477 # to 999,999,999 inclusive.
24478 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
24479 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
24480 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
24481 },
24482 &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
24483 # to the matched service.
24484 #
24485 # urlRewrite is the only action supported in UrlMaps
24486 # for classic Application Load Balancers.
24487 #
24488 # Not supported when the URL map is bound to a target gRPC proxy that
24489 # has the validateForProxyless field set to true.
24490 # backend service.
24491 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
24492 # host header is replaced with contents of hostRewrite.
24493 #
24494 # The value must be from 1 to 255 characters.
24495 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
24496 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
24497 #
24498 # The value must be from 1 to 1024 characters.
24499 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
24500 # header) using the HTTP template syntax.
24501 #
24502 # A corresponding
24503 # path_template_match must be specified. Any template variables must exist in
24504 # the path_template_match field.
24505 #
24506 #
24507 # - -At least one variable must be specified in the path_template_match
24508 # field
24509 # - You can omit variables from the rewritten URL
24510 # - The * and ** operators cannot be matched
24511 # unless they have a corresponding variable name - e.g.
24512 # {format=*} or {var=**}.
24513 #
24514 # For example, a path_template_match of /static/{format=**}
24515 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
24516 # rewrite, so that /{country}/{format}/{suffix=**} can be
24517 # rewritten as /content/{format}/{country}/{suffix}.
24518 #
24519 # At least
24520 # one non-empty routeRules[].matchRules[].path_template_match is
24521 # required.
24522 #
24523 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
24524 },
24525 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
24526 # occurs. The weights determine the fraction of traffic that flows to
24527 # their corresponding backend service. If all traffic needs to
24528 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
24529 #
24530 # After a backend service is identified and before forwarding
24531 # the request to
24532 # the backend service, advanced routing actions such as URL rewrites and
24533 # header transformations are applied depending on additional settings
24534 # specified in this HttpRouteAction.
24535 { # In contrast to a single BackendService in
24536 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
24537 # multiple backend services. The volume of traffic for each
24538 # backend service is proportional to the weight specified
24539 # in each WeightedBackendService
24540 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
24541 # resource. Before
24542 # forwarding the request to backendService, the load balancer
24543 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
24544 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
24545 # effect for the selected backendService.
24546 #
24547 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
24548 #
24549 # headerAction is not supported for load balancers that have
24550 # their loadBalancingScheme set to EXTERNAL.
24551 #
24552 # Not supported when the URL map is bound to a target gRPC proxy that
24553 # has validateForProxyless field set to true.
24554 # the request is passed along to the selected backendService.
24555 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
24556 { # Specification determining how headers are added to requests or responses.
24557 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
24558 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
24559 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
24560 # that already
24561 # exist for the header. If true, headerValue is set for the
24562 # header, discarding any values that were set for that header.
24563 #
24564 # The default value is true,
24565 # unless a variable is present in headerValue,
24566 # in which case the default value is false.
24567 # .
24568 },
24569 ],
24570 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
24571 # request before forwarding the request to the backendService.
24572 &quot;A String&quot;,
24573 ],
24574 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
24575 # client.
24576 { # Specification determining how headers are added to requests or responses.
24577 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
24578 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
24579 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
24580 # that already
24581 # exist for the header. If true, headerValue is set for the
24582 # header, discarding any values that were set for that header.
24583 #
24584 # The default value is true,
24585 # unless a variable is present in headerValue,
24586 # in which case the default value is false.
24587 # .
24588 },
24589 ],
24590 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
24591 # response before sending the response back to the client.
24592 &quot;A String&quot;,
24593 ],
24594 },
24595 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
24596 # computed asweight / (sum of all weightedBackendService weights in routeAction).
24597 #
24598 # The selection of a backend service is determined only for new traffic.
24599 # Once a user&#x27;s request has been directed to a backend service,
24600 # subsequent requests are sent to the same backend service as
24601 # determined by the backend service&#x27;s session affinity policy.
24602 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
24603 # splitting. If you do, the weighted traffic splitting configuration takes
24604 # precedence.
24605 #
24606 # The value must be from 0 to 1000.
24607 },
24608 ],
24609 },
24610 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL of the defaultService resource to
24611 # which traffic is directed if none of the hostRules match.
24612 # If defaultRouteAction is also specified, advanced
24613 # routing actions, such as URL rewrites, take effect before sending the
24614 # request to the backend.
24615 #
24616 #
24617 # Only one of defaultUrlRedirect, defaultService
24618 # or defaultRouteAction.weightedBackendService can be set.
24619 #
24620 #
24621 # defaultService has no effect when the URL map is bound
24622 # to a target gRPC proxy that has the validateForProxyless field
24623 # set to true.
24624 &quot;defaultUrlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
24625 # is redirected to a URL specified by defaultUrlRedirect.
24626 #
24627 #
24628 # Only one of defaultUrlRedirect, defaultService
24629 # or defaultRouteAction.weightedBackendService can be set.
24630 #
24631 #
24632 # Not supported when the URL map is bound to a target gRPC proxy.
24633 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
24634 # was supplied in the request.
24635 #
24636 # The value must be from 1 to 255
24637 # characters.
24638 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
24639 # set to HTTPS.
24640 # If set to false, the URL scheme of the redirected request
24641 # remains the same as that of the request.
24642 #
24643 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
24644 #
24645 # The default is set to false.
24646 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
24647 # that was supplied in the request.
24648 #
24649 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
24650 # supplied, the path of the original request is used for the redirect.
24651 #
24652 # The value must be from 1 to 1024 characters.
24653 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
24654 # the HttpRouteRuleMatch, retaining the remaining portion
24655 # of the URL before redirecting the request.
24656 #
24657 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
24658 # supplied, the path of the original request is used for the redirect.
24659 #
24660 # The value must be from 1 to 1024 characters.
24661 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
24662 #
24663 # Supported values are:
24664 #
24665 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
24666 # to 301.
24667 # - FOUND, which corresponds to 302.
24668 # - SEE_OTHER which corresponds to 303.
24669 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
24670 # method is retained.
24671 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
24672 # method is retained.
24673 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
24674 # URL is
24675 # removed before redirecting the request. If set to false, the
24676 # query portion of the original URL is retained.
24677 #
24678 # The default is set to false.
24679 },
24680 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
24681 # create the resource.
24682 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. A hash of the contents stored in this object.
24683 # This field is used in optimistic locking. This field is ignored when
24684 # inserting a UrlMap. An up-to-date fingerprint must be provided
24685 # in order to update the UrlMap, otherwise the request will
24686 # fail with error 412 conditionNotMet.
24687 #
24688 # To see the latest fingerprint, make a get() request to
24689 # retrieve a UrlMap.
24690 &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
24691 # for the selected backendService.
24692 #
24693 # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
24694 #
24695 # headerAction is not supported for load balancers
24696 # that have
24697 # their loadBalancingScheme set to EXTERNAL.
24698 #
24699 # Not supported when the URL map is bound to a target gRPC proxy that
24700 # has validateForProxyless field set to true.
24701 # the request is passed along to the selected backendService.
24702 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
24703 { # Specification determining how headers are added to requests or responses.
24704 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
24705 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
24706 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
24707 # that already
24708 # exist for the header. If true, headerValue is set for the
24709 # header, discarding any values that were set for that header.
24710 #
24711 # The default value is true,
24712 # unless a variable is present in headerValue,
24713 # in which case the default value is false.
24714 # .
24715 },
24716 ],
24717 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
24718 # request before forwarding the request to the backendService.
24719 &quot;A String&quot;,
24720 ],
24721 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
24722 # client.
24723 { # Specification determining how headers are added to requests or responses.
24724 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
24725 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
24726 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
24727 # that already
24728 # exist for the header. If true, headerValue is set for the
24729 # header, discarding any values that were set for that header.
24730 #
24731 # The default value is true,
24732 # unless a variable is present in headerValue,
24733 # in which case the default value is false.
24734 # .
24735 },
24736 ],
24737 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
24738 # response before sending the response back to the client.
24739 &quot;A String&quot;,
24740 ],
24741 },
24742 &quot;hostRules&quot;: [ # The list of host rules to use against the URL.
24743 { # UrlMaps
24744 # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
24745 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
24746 # create the resource.
24747 &quot;hosts&quot;: [ # The list of host patterns to match. They must be valid hostnames with
24748 # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
24749 # that case, * must be the first character, and if followed by
24750 # anything, the immediate following character must be either -
24751 # or ..
24752 #
24753 # * based matching is not supported when the URL map is bound
24754 # to a target gRPC proxy that has the validateForProxyless field
24755 # set to true.
24756 &quot;A String&quot;,
24757 ],
24758 &quot;pathMatcher&quot;: &quot;A String&quot;, # The name of the PathMatcher to use to match the path portion
24759 # of the URL if the hostRule matches the URL&#x27;s host portion.
24760 },
24761 ],
24762 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the resource. This identifier is
24763 # defined by the server.
24764 &quot;kind&quot;: &quot;compute#urlMap&quot;, # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
24765 # url maps.
24766 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
24767 # The name must be 1-63 characters long, and comply withRFC1035.
24768 # Specifically, the name must be 1-63 characters long and match the regular
24769 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
24770 # character must be a lowercase letter, and all following characters must
24771 # be a dash, lowercase letter, or digit, except the last character, which
24772 # cannot be a dash.
24773 &quot;pathMatchers&quot;: [ # The list of named PathMatchers to use against the URL.
24774 { # A matcher for the path portion of the URL. The BackendService
24775 # from the longest-matched rule will serve the URL. If no rule was matched, the
24776 # default service is used.
24777 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
24778 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
24779 #
24780 # This policy takes
24781 # effect at the PathMatcher level and applies only when no
24782 # 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
24783 # in defaultCustomErrorResponsePolicy, then a policy defined for
24784 # the error code in UrlMap.defaultCustomErrorResponsePolicy
24785 # takes effect.
24786 #
24787 # For example, consider a UrlMap with the following
24788 # configuration:
24789 #
24790 #
24791 # - UrlMap.defaultCustomErrorResponsePolicy is configured
24792 # with policies for 5xx and 4xx errors
24793 # - A RouteRule for /coming_soon/ is configured for the
24794 # error code 404.
24795 #
24796 # 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
24797 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
24798 # the policy in RouteRule.customErrorResponsePolicy takes
24799 # effect. If any of the requests in this example encounter a 500
24800 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
24801 #
24802 # When
24803 # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
24804 # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
24805 # a retry, if load balancer is successful in reaching the
24806 # service, the defaultCustomErrorResponsePolicy is ignored and
24807 # the response from the service is returned to the client.
24808 #
24809 # defaultCustomErrorResponsePolicy is supported only for
24810 # global external Application Load Balancers.
24811 # backend service or backend bucket responds with an error.
24812 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
24813 #
24814 # In a given policy, if you specify rules for both a range of error codes
24815 # as well as rules for specific error codes then rules with specific error
24816 # codes have a higher priority. For example, assume that you configure a rule
24817 # for 401 (Un-authorized) code, and another for all 4 series
24818 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
24819 # However if the backend service returns a 403, the rule for4xx takes effect.
24820 { # Specifies the mapping between the response code that will be returned along
24821 # with the custom error content and the response code returned by the backend
24822 # service.
24823 &quot;matchResponseCodes&quot;: [ # Valid values include:
24824 #
24825 #
24826 # - A number between 400 and 599: For example
24827 # 401 or 503, in which case the load balancer
24828 # applies the policy if the error code exactly matches this value.
24829 # - 5xx: Load Balancer will apply the policy if the
24830 # backend service responds with any response code in the range of
24831 # 500 to 599.
24832 # - 4xx: Load
24833 # Balancer will apply the policy if the backend service responds with any
24834 # response code in the range of 400 to
24835 # 499.
24836 #
24837 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
24838 &quot;A String&quot;,
24839 ],
24840 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
24841 # error content. If overrideResponseCode is not supplied, the
24842 # same response code returned by the original backend bucket or backend
24843 # service is returned to the client.
24844 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
24845 #
24846 # path must start
24847 # with a leading slash. path cannot have trailing slashes.
24848 #
24849 # If the file is not available in backendBucket or the
24850 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
24851 #
24852 # The value must
24853 # be from 1 to 1024 characters
24854 },
24855 ],
24856 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
24857 # contains the custom error content. Examples are:
24858 #
24859 #
24860 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
24861 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
24862 # - global/backendBuckets/myBackendBucket
24863 #
24864 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
24865 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
24866 #
24867 # If load balancer cannot reach
24868 # the backendBucket, a simple Not Found Error will
24869 # be returned, with the original response code (oroverrideResponseCode if configured).
24870 #
24871 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
24872 },
24873 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
24874 # pathRules or routeRules match. The load balancer
24875 # performs advanced routing actions, such as URL rewrites and
24876 # header transformations, before forwarding the request to the
24877 # selected backend.
24878 #
24879 #
24880 # Only one of defaultUrlRedirect, defaultService
24881 # or defaultRouteAction.weightedBackendService can be set.
24882 #
24883 #
24884 # URL maps for classic Application Load Balancers only support
24885 # the urlRewrite action within a path matcher&#x27;sdefaultRouteAction.
24886 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
24887 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
24888 # property must be specified. This policy cannot be specified if any target
24889 # backend has Identity-Aware Proxy enabled.
24890 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
24891 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
24892 # header names can be specified. The cache is bypassed for all `cacheMode`
24893 # values.
24894 &quot;A String&quot;,
24895 ],
24896 &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
24897 # on the backend type: for Backend Services, the complete request URI is
24898 # used; for Backend Buckets, the request URI is used without the protocol or
24899 # host, and only query parameters known to Cloud Storage are included.
24900 # Policy defined on Route Action.
24901 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
24902 # parameters will be included. Either specify `excludedQueryParameters`
24903 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
24904 # encoded and not treated as delimiters.
24905 #
24906 # Note: This field applies to routes that use backend services. Attempting
24907 # to set it on a route that points exclusively to Backend Buckets will
24908 # result in a configuration error. For routes that point to a Backend
24909 # Bucket, use `includedQueryParameters` to define which parameters should
24910 # be part of the cache key.
24911 &quot;A String&quot;,
24912 ],
24913 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
24914 #
24915 # Note: This setting is only applicable to routes that use a Backend
24916 # Service. It does not affect requests served by a Backend Bucket, as the
24917 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
24918 # it on a route that points exclusively to Backend Buckets will result in a
24919 # configuration error.
24920 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
24921 #
24922 # Note: This setting is only applicable to routes that use a Backend
24923 # Service. It does not affect requests served by a Backend Bucket, as the
24924 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
24925 # set on a route that points exclusively to Backend Buckets will result in
24926 # a configuration error.
24927 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
24928 # `includedQueryParameters` and `excludedQueryParameters`. If neither
24929 # is set, the entire query string will be included. If false, the query
24930 # string will be excluded from the cache key entirely.
24931 #
24932 # Note: This field applies to routes that use backend services. Attempting
24933 # to set it on a route that points exclusively to Backend Buckets will
24934 # result in a configuration error. For routes that point to a Backend
24935 # Bucket, use `includedQueryParameters` to define which parameters should
24936 # be part of the cache key.
24937 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
24938 # The name=value pair will be used in the cache key Cloud CDN generates.
24939 #
24940 # Note: This setting is only applicable to routes that use a Backend
24941 # Service. It does not affect requests served by a Backend Bucket.
24942 # Attempting to set it on a route that points exclusively to Backend
24943 # Buckets will result in a configuration error. Up to 5 cookie names can be
24944 # specified.
24945 &quot;A String&quot;,
24946 ],
24947 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
24948 &quot;A String&quot;,
24949 ],
24950 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
24951 # parameters will be excluded. Either specify `includedQueryParameters`
24952 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
24953 # encoded and not treated as delimiters.
24954 &quot;A String&quot;,
24955 ],
24956 },
24957 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
24958 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
24959 &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
24960 # content. This is used to clamp the max-age (or Expires) value sent to the
24961 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
24962 # is used for the response max-age directive, along with a &quot;public&quot;
24963 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
24964 # clamps the max-age from the origin (if specified), or else sets the
24965 # response max-age directive to the lesser of the `clientTtl` and
24966 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
24967 # present. The maximum allowed value is 31,622,400s (1 year). If not
24968 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
24969 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
24970 # `USE_ORIGIN_HEADERS`.
24971 # as a count of seconds and fractions of seconds at nanosecond
24972 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
24973 # or &quot;month&quot;. Range is approximately 10,000 years.
24974 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
24975 # Durations less than one second are represented with a 0
24976 # `seconds` field and a positive `nanos` field. Must be from 0
24977 # to 999,999,999 inclusive.
24978 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
24979 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
24980 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
24981 },
24982 &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
24983 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
24984 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
24985 # greater than that of `maxTtl`. When the `cacheMode` is set to
24986 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
24987 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
24988 # accessed objects may be evicted from the cache before the defined TTL. If
24989 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
24990 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
24991 # `USE_ORIGIN_HEADERS`.
24992 # as a count of seconds and fractions of seconds at nanosecond
24993 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
24994 # or &quot;month&quot;. Range is approximately 10,000 years.
24995 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
24996 # Durations less than one second are represented with a 0
24997 # `seconds` field and a positive `nanos` field. Must be from 0
24998 # to 999,999,999 inclusive.
24999 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
25000 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
25001 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
25002 },
25003 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
25004 # attempt to set a max-age or s-maxage higher than this, or an Expires header
25005 # more than `maxTtl` seconds in the future will be capped at the value of
25006 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
25007 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
25008 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
25009 # Infrequently accessed objects may be evicted from the cache before the
25010 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
25011 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
25012 # mode.
25013 # as a count of seconds and fractions of seconds at nanosecond
25014 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
25015 # or &quot;month&quot;. Range is approximately 10,000 years.
25016 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
25017 # Durations less than one second are represented with a 0
25018 # `seconds` field and a positive `nanos` field. Must be from 0
25019 # to 999,999,999 inclusive.
25020 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
25021 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
25022 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
25023 },
25024 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
25025 # to apply fine-grained caching for common errors or redirects.
25026 # This can reduce the load on your origin and improve end-user
25027 # experience by reducing response latency.
25028 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
25029 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
25030 # the specified response code that lack any Cache-Control, Expires, or
25031 # Pragma: no-cache directives. When the `cacheMode` is set to
25032 # `FORCE_CACHE_ALL`, negative caching applies to all responses
25033 # with the specified response code, and overrides any caching headers. By
25034 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
25035 #
25036 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
25037 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
25038 # * 405 (Method Not Found), 501 (Not Implemented): 60s
25039 #
25040 # These defaults can be overridden in `negativeCachingPolicy`.
25041 # If not specified, Cloud CDN applies negative caching by default.
25042 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
25043 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
25044 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
25045 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
25046 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
25047 # all response codes that you wish to cache. Cloud CDN will not apply any
25048 # default negative caching when a policy exists.
25049 { # Specify CDN TTLs for response error codes.
25050 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
25051 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
25052 # specified as values, and you cannot specify a status code more than
25053 # once.
25054 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
25055 # corresponding status code.
25056 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
25057 # objects may be evicted from the cache before the defined TTL.
25058 # as a count of seconds and fractions of seconds at nanosecond
25059 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
25060 # or &quot;month&quot;. Range is approximately 10,000 years.
25061 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
25062 # Durations less than one second are represented with a 0
25063 # `seconds` field and a positive `nanos` field. Must be from 0
25064 # to 999,999,999 inclusive.
25065 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
25066 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
25067 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
25068 },
25069 },
25070 ],
25071 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
25072 # requests into a small number of requests to the origin. If not specified,
25073 # Cloud CDN applies request coalescing by default.
25074 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
25075 # content with the origin, or when an error is encountered when refreshing
25076 # the cache.
25077 # This setting defines the default &quot;max-stale&quot; duration for any cached
25078 # responses that do not specify a max-stale directive. Stale responses that
25079 # exceed the TTL configured here will not be served. The default limit
25080 # (max-stale) is 86400s (1 day), which will allow stale content to be
25081 # served up to this limit beyond the max-age (or s-maxage) of a cached
25082 # response.
25083 # The maximum allowed value is 604800 (1 week).
25084 # Set this to zero (0) to disable serve-while-stale.
25085 # as a count of seconds and fractions of seconds at nanosecond
25086 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
25087 # or &quot;month&quot;. Range is approximately 10,000 years.
25088 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
25089 # Durations less than one second are represented with a 0
25090 # `seconds` field and a positive `nanos` field. Must be from 0
25091 # to 999,999,999 inclusive.
25092 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
25093 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
25094 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
25095 },
25096 },
25097 &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
25098 # information about the W3C recommendation for cross-origin resource sharing
25099 # (CORS), see Fetch API Living
25100 # Standard.
25101 #
25102 # Not supported when the URL map is bound to a target gRPC proxy.
25103 # information about the W3C recommendation for cross-origin resource sharing
25104 # (CORS), see Fetch API Living
25105 # Standard.
25106 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
25107 # indicates that
25108 # the actual request can include user credentials. This field translates to
25109 # the Access-Control-Allow-Credentials header.
25110 #
25111 # Default is false.
25112 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
25113 # header.
25114 &quot;A String&quot;,
25115 ],
25116 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
25117 # header.
25118 &quot;A String&quot;,
25119 ],
25120 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
25121 # more information, see regular expression syntax.
25122 #
25123 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
25124 #
25125 # Regular expressions can only be used when the loadBalancingScheme is
25126 # set to INTERNAL_SELF_MANAGED.
25127 &quot;A String&quot;,
25128 ],
25129 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
25130 #
25131 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
25132 &quot;A String&quot;,
25133 ],
25134 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
25135 # The default value is false, which indicates that the CORS
25136 # policy is in effect.
25137 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
25138 # header.
25139 &quot;A String&quot;,
25140 ],
25141 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
25142 # seconds. This field translates to the Access-Control-Max-Age
25143 # header.
25144 },
25145 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
25146 # the resiliency of clients to backend service failure. As part of fault
25147 # injection, when clients send requests to a backend service, delays can be
25148 # introduced by a load balancer on a percentage of requests before sending
25149 # those requests to the backend service. Similarly requests from clients can
25150 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
25151 # that are configured with a fault_injection_policy if:
25152 # 1. The traffic is generated by fault injection AND
25153 # 2. The fault injection is not a delay fault injection.
25154 # Fault injection is not supported with the classic Application Load Balancer
25155 # . To see which load balancers support fault injection,
25156 # see Load
25157 # balancing: Routing and traffic management features.
25158 # the resiliency of clients to backend service failure. As part of fault
25159 # injection, when clients send requests to a backend service, delays can be
25160 # introduced by the load balancer on a percentage of requests before sending
25161 # those request to the backend service. Similarly requests from clients can be
25162 # aborted by the load balancer for a percentage of requests.
25163 &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
25164 # injection.
25165 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
25166 #
25167 # The value must be from 200 to 599 inclusive.
25168 #
25169 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
25170 # according to this
25171 # mapping table. HTTP status 200 is mapped to gRPC status
25172 # UNKNOWN. Injecting an OK status is currently not supported by
25173 # Traffic Director.
25174 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
25175 # that is aborted as part of fault injection.
25176 #
25177 # The value must be from 0.0 to 100.0 inclusive.
25178 },
25179 &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
25180 # injection, before being sent to a backend service.
25181 # request to the backend service as part of fault injection.
25182 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
25183 # as a count of seconds and fractions of seconds at nanosecond
25184 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
25185 # or &quot;month&quot;. Range is approximately 10,000 years.
25186 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
25187 # Durations less than one second are represented with a 0
25188 # `seconds` field and a positive `nanos` field. Must be from 0
25189 # to 999,999,999 inclusive.
25190 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
25191 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
25192 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
25193 },
25194 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
25195 # which a delay is introduced as part of fault injection.
25196 #
25197 # The value must be from 0.0 to 100.0 inclusive.
25198 },
25199 },
25200 &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
25201 # Global EXTERNAL_MANAGED load balancer schemes.
25202 # Either Cloud CDN must be enabled on the backend service or backend bucket
25203 # serving the route, or cache policy must be configured on the same route
25204 # dynamically processes and delivers images from the network edge.
25205 # Image Optimization is only available for Global External Application Load
25206 # Balancers.
25207 # Either Cloud CDN must be enabled on the backend service or backend bucket
25208 # serving the route, or cache policy must be configured on the same route.
25209 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
25210 },
25211 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
25212 # Unlike the timeout field where the timeout duration starts
25213 # from the time the request has been fully processed (known as*end-of-stream*),
25214 # the duration in this field is computed from the beginning of the stream
25215 # until the response has been processed, including all retries. A
25216 # stream that does not complete in this duration is closed.
25217 #
25218 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
25219 # with the route.
25220 #
25221 # This field is only allowed if the Url map is used with backend services
25222 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
25223 # as a count of seconds and fractions of seconds at nanosecond
25224 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
25225 # or &quot;month&quot;. Range is approximately 10,000 years.
25226 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
25227 # Durations less than one second are represented with a 0
25228 # `seconds` field and a positive `nanos` field. Must be from 0
25229 # to 999,999,999 inclusive.
25230 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
25231 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
25232 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
25233 },
25234 &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
25235 # are shadowed to a separate mirrored backend service. The load balancer does
25236 # not wait for responses from the shadow service. Before sending traffic
25237 # to the shadow service, the host / authority header is suffixed with-shadow.
25238 #
25239 # Not supported when the URL map is bound to a target gRPC proxy that
25240 # has the validateForProxyless field set to true.
25241 # are shadowed to a separate mirrored backend service. The load balancer
25242 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
25243 # to the shadow service, the host or authority header is suffixed with-shadow.
25244 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
25245 # mirrored to.
25246 #
25247 # The backend service configured for a mirroring
25248 # policy must reference backends that are of the same type as the original
25249 # backend service matched in the URL map.
25250 #
25251 # Serverless NEG backends are not currently supported as a mirrored
25252 # backend service.
25253 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
25254 },
25255 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
25256 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
25257 # If not specified, defaults to 1.
25258 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
25259 #
25260 # If not specified, will use the timeout set in theHttpRouteAction field.
25261 # If timeout in the HttpRouteAction field is not set, this field
25262 # uses the largest timeout
25263 # among all backend services associated with the route.
25264 #
25265 # Not supported when the URL map is bound to a target gRPC proxy that
25266 # has the validateForProxyless field set to true.
25267 # as a count of seconds and fractions of seconds at nanosecond
25268 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
25269 # or &quot;month&quot;. Range is approximately 10,000 years.
25270 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
25271 # Durations less than one second are represented with a 0
25272 # `seconds` field and a positive `nanos` field. Must be from 0
25273 # to 999,999,999 inclusive.
25274 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
25275 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
25276 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
25277 },
25278 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
25279 # values are:
25280 #
25281 # - 5xx: retry is attempted if the instance or endpoint
25282 # responds with any 5xx response code, or if the instance or
25283 # endpoint does not respond at all. For example, disconnects, reset, read
25284 # timeout, connection failure, and refused streams.
25285 # - gateway-error: Similar to 5xx, but only
25286 # applies to response codes 502, 503 or504.
25287 # - connect-failure: a retry is attempted on failures
25288 # connecting to the instance or endpoint. For example, connection
25289 # timeouts.
25290 # - retriable-4xx: a retry is attempted if the instance
25291 # or endpoint responds with a 4xx response code.
25292 # The only error that you can retry is error code 409.
25293 # - refused-stream: a retry is attempted if the instance
25294 # or endpoint resets the stream with a REFUSED_STREAM error
25295 # code. This reset type indicates that it is safe to retry.
25296 # - cancelled: a retry is attempted if the gRPC status
25297 # code in the response header is set to cancelled.
25298 # - deadline-exceeded: a retry is attempted if the gRPC
25299 # status code in the response header is set todeadline-exceeded.
25300 # - internal: a retry is attempted if the gRPC
25301 # status code in the response header is set tointernal.
25302 # - resource-exhausted: a retry is attempted if the gRPC
25303 # status code in the response header is set toresource-exhausted.
25304 # - unavailable: a retry is attempted if the gRPC
25305 # status code in the response header is set tounavailable.
25306 #
25307 # Only the following codes are supported when the URL map is bound to
25308 # target gRPC proxy that has validateForProxyless field set to true.
25309 #
25310 # - cancelled
25311 # - deadline-exceeded
25312 # - internal
25313 # - resource-exhausted
25314 # - unavailable
25315 &quot;A String&quot;,
25316 ],
25317 },
25318 &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
25319 # time the request has been fully processed (known as *end-of-stream*)
25320 # up until the response has been processed. Timeout includes
25321 # all retries.
25322 #
25323 # If not specified, this field uses the largest timeout among all backend
25324 # services associated with the route.
25325 #
25326 # Not supported when the URL map is bound to a target gRPC proxy that
25327 # has validateForProxyless field set to true.
25328 # as a count of seconds and fractions of seconds at nanosecond
25329 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
25330 # or &quot;month&quot;. Range is approximately 10,000 years.
25331 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
25332 # Durations less than one second are represented with a 0
25333 # `seconds` field and a positive `nanos` field. Must be from 0
25334 # to 999,999,999 inclusive.
25335 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
25336 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
25337 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
25338 },
25339 &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
25340 # to the matched service.
25341 #
25342 # urlRewrite is the only action supported in UrlMaps
25343 # for classic Application Load Balancers.
25344 #
25345 # Not supported when the URL map is bound to a target gRPC proxy that
25346 # has the validateForProxyless field set to true.
25347 # backend service.
25348 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
25349 # host header is replaced with contents of hostRewrite.
25350 #
25351 # The value must be from 1 to 255 characters.
25352 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
25353 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
25354 #
25355 # The value must be from 1 to 1024 characters.
25356 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
25357 # header) using the HTTP template syntax.
25358 #
25359 # A corresponding
25360 # path_template_match must be specified. Any template variables must exist in
25361 # the path_template_match field.
25362 #
25363 #
25364 # - -At least one variable must be specified in the path_template_match
25365 # field
25366 # - You can omit variables from the rewritten URL
25367 # - The * and ** operators cannot be matched
25368 # unless they have a corresponding variable name - e.g.
25369 # {format=*} or {var=**}.
25370 #
25371 # For example, a path_template_match of /static/{format=**}
25372 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
25373 # rewrite, so that /{country}/{format}/{suffix=**} can be
25374 # rewritten as /content/{format}/{country}/{suffix}.
25375 #
25376 # At least
25377 # one non-empty routeRules[].matchRules[].path_template_match is
25378 # required.
25379 #
25380 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
25381 },
25382 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
25383 # occurs. The weights determine the fraction of traffic that flows to
25384 # their corresponding backend service. If all traffic needs to
25385 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
25386 #
25387 # After a backend service is identified and before forwarding
25388 # the request to
25389 # the backend service, advanced routing actions such as URL rewrites and
25390 # header transformations are applied depending on additional settings
25391 # specified in this HttpRouteAction.
25392 { # In contrast to a single BackendService in
25393 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
25394 # multiple backend services. The volume of traffic for each
25395 # backend service is proportional to the weight specified
25396 # in each WeightedBackendService
25397 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
25398 # resource. Before
25399 # forwarding the request to backendService, the load balancer
25400 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
25401 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
25402 # effect for the selected backendService.
25403 #
25404 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
25405 #
25406 # headerAction is not supported for load balancers that have
25407 # their loadBalancingScheme set to EXTERNAL.
25408 #
25409 # Not supported when the URL map is bound to a target gRPC proxy that
25410 # has validateForProxyless field set to true.
25411 # the request is passed along to the selected backendService.
25412 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
25413 { # Specification determining how headers are added to requests or responses.
25414 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
25415 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
25416 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
25417 # that already
25418 # exist for the header. If true, headerValue is set for the
25419 # header, discarding any values that were set for that header.
25420 #
25421 # The default value is true,
25422 # unless a variable is present in headerValue,
25423 # in which case the default value is false.
25424 # .
25425 },
25426 ],
25427 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
25428 # request before forwarding the request to the backendService.
25429 &quot;A String&quot;,
25430 ],
25431 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
25432 # client.
25433 { # Specification determining how headers are added to requests or responses.
25434 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
25435 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
25436 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
25437 # that already
25438 # exist for the header. If true, headerValue is set for the
25439 # header, discarding any values that were set for that header.
25440 #
25441 # The default value is true,
25442 # unless a variable is present in headerValue,
25443 # in which case the default value is false.
25444 # .
25445 },
25446 ],
25447 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
25448 # response before sending the response back to the client.
25449 &quot;A String&quot;,
25450 ],
25451 },
25452 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
25453 # computed asweight / (sum of all weightedBackendService weights in routeAction).
25454 #
25455 # The selection of a backend service is determined only for new traffic.
25456 # Once a user&#x27;s request has been directed to a backend service,
25457 # subsequent requests are sent to the same backend service as
25458 # determined by the backend service&#x27;s session affinity policy.
25459 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
25460 # splitting. If you do, the weighted traffic splitting configuration takes
25461 # precedence.
25462 #
25463 # The value must be from 0 to 1000.
25464 },
25465 ],
25466 },
25467 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource. This
25468 # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
25469 # matched. For example, the
25470 # following are all valid URLs to a BackendService resource:
25471 #
25472 #
25473 # - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
25474 # - compute/v1/projects/project/global/backendServices/backendService
25475 # - global/backendServices/backendService
25476 #
25477 #
25478 # If defaultRouteAction is also specified, advanced
25479 # routing actions, such as URL rewrites, take effect before sending the
25480 # request to the backend.
25481 #
25482 #
25483 # Only one of defaultUrlRedirect, defaultService
25484 # or defaultRouteAction.weightedBackendService can be set.
25485 #
25486 #
25487 # Authorization requires one or more of the following Google IAM permissions on the
25488 # specified resource default_service:
25489 #
25490 #
25491 # - compute.backendBuckets.use
25492 # - compute.backendServices.use
25493 &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
25494 # by defaultUrlRedirect.
25495 #
25496 #
25497 # Only one of defaultUrlRedirect, defaultService
25498 # or defaultRouteAction.weightedBackendService can be set.
25499 #
25500 #
25501 # Not supported when the URL map is bound to a target gRPC proxy.
25502 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
25503 # was supplied in the request.
25504 #
25505 # The value must be from 1 to 255
25506 # characters.
25507 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
25508 # set to HTTPS.
25509 # If set to false, the URL scheme of the redirected request
25510 # remains the same as that of the request.
25511 #
25512 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
25513 #
25514 # The default is set to false.
25515 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
25516 # that was supplied in the request.
25517 #
25518 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
25519 # supplied, the path of the original request is used for the redirect.
25520 #
25521 # The value must be from 1 to 1024 characters.
25522 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
25523 # the HttpRouteRuleMatch, retaining the remaining portion
25524 # of the URL before redirecting the request.
25525 #
25526 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
25527 # supplied, the path of the original request is used for the redirect.
25528 #
25529 # The value must be from 1 to 1024 characters.
25530 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
25531 #
25532 # Supported values are:
25533 #
25534 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
25535 # to 301.
25536 # - FOUND, which corresponds to 302.
25537 # - SEE_OTHER which corresponds to 303.
25538 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
25539 # method is retained.
25540 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
25541 # method is retained.
25542 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
25543 # URL is
25544 # removed before redirecting the request. If set to false, the
25545 # query portion of the original URL is retained.
25546 #
25547 # The default is set to false.
25548 },
25549 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
25550 # create the resource.
25551 &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
25552 # for the selected backend service.
25553 #
25554 # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
25555 #
25556 # HeaderAction is not supported for load balancers
25557 # that have
25558 # their loadBalancingScheme set to EXTERNAL.
25559 #
25560 # Not supported when the URL map is bound to a target gRPC proxy that
25561 # has validateForProxyless field set to true.
25562 # the request is passed along to the selected backendService.
25563 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
25564 { # Specification determining how headers are added to requests or responses.
25565 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
25566 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
25567 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
25568 # that already
25569 # exist for the header. If true, headerValue is set for the
25570 # header, discarding any values that were set for that header.
25571 #
25572 # The default value is true,
25573 # unless a variable is present in headerValue,
25574 # in which case the default value is false.
25575 # .
25576 },
25577 ],
25578 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
25579 # request before forwarding the request to the backendService.
25580 &quot;A String&quot;,
25581 ],
25582 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
25583 # client.
25584 { # Specification determining how headers are added to requests or responses.
25585 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
25586 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
25587 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
25588 # that already
25589 # exist for the header. If true, headerValue is set for the
25590 # header, discarding any values that were set for that header.
25591 #
25592 # The default value is true,
25593 # unless a variable is present in headerValue,
25594 # in which case the default value is false.
25595 # .
25596 },
25597 ],
25598 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
25599 # response before sending the response back to the client.
25600 &quot;A String&quot;,
25601 ],
25602 },
25603 &quot;name&quot;: &quot;A String&quot;, # The name to which this PathMatcher is referred by theHostRule.
25604 &quot;pathRules&quot;: [ # The list of path rules. Use this list instead of routeRules
25605 # when routing based on simple path matching is all that&#x27;s required. A path
25606 # rule can only include a wildcard character (*) after a
25607 # forward slash character (&quot;/&quot;).
25608 #
25609 # The order by which path rules are specified does not matter.
25610 # Matches are always done on the longest-path-first basis.
25611 #
25612 # For example: a pathRule with a path /a/b/c/* will match
25613 # before /a/b/* irrespective of the order in which those paths appear in this
25614 # list.
25615 #
25616 # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
25617 { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
25618 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
25619 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
25620 #
25621 # If a policy for an
25622 # error code is not configured for the PathRule, a policy for
25623 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
25624 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
25625 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
25626 # effect.
25627 #
25628 # For example, consider a UrlMap with the following configuration:
25629 #
25630 #
25631 # - UrlMap.defaultCustomErrorResponsePolicy are configured
25632 # with policies for 5xx and 4xx errors
25633 # - A PathRule for /coming_soon/ is configured for the error
25634 # code 404.
25635 #
25636 # 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
25637 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
25638 # the policy in PathRule.customErrorResponsePolicy takes
25639 # effect. If any of the requests in this example encounter a 500
25640 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
25641 #
25642 # customErrorResponsePolicy is supported only for
25643 # global external Application Load Balancers.
25644 # backend service or backend bucket responds with an error.
25645 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
25646 #
25647 # In a given policy, if you specify rules for both a range of error codes
25648 # as well as rules for specific error codes then rules with specific error
25649 # codes have a higher priority. For example, assume that you configure a rule
25650 # for 401 (Un-authorized) code, and another for all 4 series
25651 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
25652 # However if the backend service returns a 403, the rule for4xx takes effect.
25653 { # Specifies the mapping between the response code that will be returned along
25654 # with the custom error content and the response code returned by the backend
25655 # service.
25656 &quot;matchResponseCodes&quot;: [ # Valid values include:
25657 #
25658 #
25659 # - A number between 400 and 599: For example
25660 # 401 or 503, in which case the load balancer
25661 # applies the policy if the error code exactly matches this value.
25662 # - 5xx: Load Balancer will apply the policy if the
25663 # backend service responds with any response code in the range of
25664 # 500 to 599.
25665 # - 4xx: Load
25666 # Balancer will apply the policy if the backend service responds with any
25667 # response code in the range of 400 to
25668 # 499.
25669 #
25670 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
25671 &quot;A String&quot;,
25672 ],
25673 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
25674 # error content. If overrideResponseCode is not supplied, the
25675 # same response code returned by the original backend bucket or backend
25676 # service is returned to the client.
25677 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
25678 #
25679 # path must start
25680 # with a leading slash. path cannot have trailing slashes.
25681 #
25682 # If the file is not available in backendBucket or the
25683 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
25684 #
25685 # The value must
25686 # be from 1 to 1024 characters
25687 },
25688 ],
25689 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
25690 # contains the custom error content. Examples are:
25691 #
25692 #
25693 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
25694 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
25695 # - global/backendBuckets/myBackendBucket
25696 #
25697 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
25698 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
25699 #
25700 # If load balancer cannot reach
25701 # the backendBucket, a simple Not Found Error will
25702 # be returned, with the original response code (oroverrideResponseCode if configured).
25703 #
25704 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
25705 },
25706 &quot;paths&quot;: [ # The list of path patterns to match. Each must start with /
25707 # and the only place a * is allowed is at the end following
25708 # a /. The string fed to the path matcher does not include
25709 # any text after the first ? or #, and
25710 # those chars are not allowed here.
25711 &quot;A String&quot;,
25712 ],
25713 &quot;routeAction&quot;: { # In response to a matching path, the load balancer
25714 # performs advanced routing actions, such as URL rewrites and header
25715 # transformations, before forwarding the request to the selected
25716 # backend.
25717 #
25718 #
25719 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
25720 #
25721 #
25722 # URL maps for classic Application Load Balancers only support
25723 # the urlRewrite action within a path rule&#x27;srouteAction.
25724 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
25725 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
25726 # property must be specified. This policy cannot be specified if any target
25727 # backend has Identity-Aware Proxy enabled.
25728 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
25729 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
25730 # header names can be specified. The cache is bypassed for all `cacheMode`
25731 # values.
25732 &quot;A String&quot;,
25733 ],
25734 &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
25735 # on the backend type: for Backend Services, the complete request URI is
25736 # used; for Backend Buckets, the request URI is used without the protocol or
25737 # host, and only query parameters known to Cloud Storage are included.
25738 # Policy defined on Route Action.
25739 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
25740 # parameters will be included. Either specify `excludedQueryParameters`
25741 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
25742 # encoded and not treated as delimiters.
25743 #
25744 # Note: This field applies to routes that use backend services. Attempting
25745 # to set it on a route that points exclusively to Backend Buckets will
25746 # result in a configuration error. For routes that point to a Backend
25747 # Bucket, use `includedQueryParameters` to define which parameters should
25748 # be part of the cache key.
25749 &quot;A String&quot;,
25750 ],
25751 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
25752 #
25753 # Note: This setting is only applicable to routes that use a Backend
25754 # Service. It does not affect requests served by a Backend Bucket, as the
25755 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
25756 # it on a route that points exclusively to Backend Buckets will result in a
25757 # configuration error.
25758 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
25759 #
25760 # Note: This setting is only applicable to routes that use a Backend
25761 # Service. It does not affect requests served by a Backend Bucket, as the
25762 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
25763 # set on a route that points exclusively to Backend Buckets will result in
25764 # a configuration error.
25765 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
25766 # `includedQueryParameters` and `excludedQueryParameters`. If neither
25767 # is set, the entire query string will be included. If false, the query
25768 # string will be excluded from the cache key entirely.
25769 #
25770 # Note: This field applies to routes that use backend services. Attempting
25771 # to set it on a route that points exclusively to Backend Buckets will
25772 # result in a configuration error. For routes that point to a Backend
25773 # Bucket, use `includedQueryParameters` to define which parameters should
25774 # be part of the cache key.
25775 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
25776 # The name=value pair will be used in the cache key Cloud CDN generates.
25777 #
25778 # Note: This setting is only applicable to routes that use a Backend
25779 # Service. It does not affect requests served by a Backend Bucket.
25780 # Attempting to set it on a route that points exclusively to Backend
25781 # Buckets will result in a configuration error. Up to 5 cookie names can be
25782 # specified.
25783 &quot;A String&quot;,
25784 ],
25785 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
25786 &quot;A String&quot;,
25787 ],
25788 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
25789 # parameters will be excluded. Either specify `includedQueryParameters`
25790 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
25791 # encoded and not treated as delimiters.
25792 &quot;A String&quot;,
25793 ],
25794 },
25795 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
25796 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
25797 &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
25798 # content. This is used to clamp the max-age (or Expires) value sent to the
25799 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
25800 # is used for the response max-age directive, along with a &quot;public&quot;
25801 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
25802 # clamps the max-age from the origin (if specified), or else sets the
25803 # response max-age directive to the lesser of the `clientTtl` and
25804 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
25805 # present. The maximum allowed value is 31,622,400s (1 year). If not
25806 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
25807 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
25808 # `USE_ORIGIN_HEADERS`.
25809 # as a count of seconds and fractions of seconds at nanosecond
25810 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
25811 # or &quot;month&quot;. Range is approximately 10,000 years.
25812 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
25813 # Durations less than one second are represented with a 0
25814 # `seconds` field and a positive `nanos` field. Must be from 0
25815 # to 999,999,999 inclusive.
25816 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
25817 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
25818 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
25819 },
25820 &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
25821 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
25822 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
25823 # greater than that of `maxTtl`. When the `cacheMode` is set to
25824 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
25825 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
25826 # accessed objects may be evicted from the cache before the defined TTL. If
25827 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
25828 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
25829 # `USE_ORIGIN_HEADERS`.
25830 # as a count of seconds and fractions of seconds at nanosecond
25831 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
25832 # or &quot;month&quot;. Range is approximately 10,000 years.
25833 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
25834 # Durations less than one second are represented with a 0
25835 # `seconds` field and a positive `nanos` field. Must be from 0
25836 # to 999,999,999 inclusive.
25837 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
25838 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
25839 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
25840 },
25841 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
25842 # attempt to set a max-age or s-maxage higher than this, or an Expires header
25843 # more than `maxTtl` seconds in the future will be capped at the value of
25844 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
25845 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
25846 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
25847 # Infrequently accessed objects may be evicted from the cache before the
25848 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
25849 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
25850 # mode.
25851 # as a count of seconds and fractions of seconds at nanosecond
25852 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
25853 # or &quot;month&quot;. Range is approximately 10,000 years.
25854 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
25855 # Durations less than one second are represented with a 0
25856 # `seconds` field and a positive `nanos` field. Must be from 0
25857 # to 999,999,999 inclusive.
25858 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
25859 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
25860 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
25861 },
25862 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
25863 # to apply fine-grained caching for common errors or redirects.
25864 # This can reduce the load on your origin and improve end-user
25865 # experience by reducing response latency.
25866 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
25867 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
25868 # the specified response code that lack any Cache-Control, Expires, or
25869 # Pragma: no-cache directives. When the `cacheMode` is set to
25870 # `FORCE_CACHE_ALL`, negative caching applies to all responses
25871 # with the specified response code, and overrides any caching headers. By
25872 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
25873 #
25874 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
25875 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
25876 # * 405 (Method Not Found), 501 (Not Implemented): 60s
25877 #
25878 # These defaults can be overridden in `negativeCachingPolicy`.
25879 # If not specified, Cloud CDN applies negative caching by default.
25880 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
25881 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
25882 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
25883 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
25884 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
25885 # all response codes that you wish to cache. Cloud CDN will not apply any
25886 # default negative caching when a policy exists.
25887 { # Specify CDN TTLs for response error codes.
25888 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
25889 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
25890 # specified as values, and you cannot specify a status code more than
25891 # once.
25892 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
25893 # corresponding status code.
25894 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
25895 # objects may be evicted from the cache before the defined TTL.
25896 # as a count of seconds and fractions of seconds at nanosecond
25897 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
25898 # or &quot;month&quot;. Range is approximately 10,000 years.
25899 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
25900 # Durations less than one second are represented with a 0
25901 # `seconds` field and a positive `nanos` field. Must be from 0
25902 # to 999,999,999 inclusive.
25903 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
25904 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
25905 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
25906 },
25907 },
25908 ],
25909 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
25910 # requests into a small number of requests to the origin. If not specified,
25911 # Cloud CDN applies request coalescing by default.
25912 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
25913 # content with the origin, or when an error is encountered when refreshing
25914 # the cache.
25915 # This setting defines the default &quot;max-stale&quot; duration for any cached
25916 # responses that do not specify a max-stale directive. Stale responses that
25917 # exceed the TTL configured here will not be served. The default limit
25918 # (max-stale) is 86400s (1 day), which will allow stale content to be
25919 # served up to this limit beyond the max-age (or s-maxage) of a cached
25920 # response.
25921 # The maximum allowed value is 604800 (1 week).
25922 # Set this to zero (0) to disable serve-while-stale.
25923 # as a count of seconds and fractions of seconds at nanosecond
25924 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
25925 # or &quot;month&quot;. Range is approximately 10,000 years.
25926 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
25927 # Durations less than one second are represented with a 0
25928 # `seconds` field and a positive `nanos` field. Must be from 0
25929 # to 999,999,999 inclusive.
25930 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
25931 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
25932 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
25933 },
25934 },
25935 &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
25936 # information about the W3C recommendation for cross-origin resource sharing
25937 # (CORS), see Fetch API Living
25938 # Standard.
25939 #
25940 # Not supported when the URL map is bound to a target gRPC proxy.
25941 # information about the W3C recommendation for cross-origin resource sharing
25942 # (CORS), see Fetch API Living
25943 # Standard.
25944 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
25945 # indicates that
25946 # the actual request can include user credentials. This field translates to
25947 # the Access-Control-Allow-Credentials header.
25948 #
25949 # Default is false.
25950 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
25951 # header.
25952 &quot;A String&quot;,
25953 ],
25954 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
25955 # header.
25956 &quot;A String&quot;,
25957 ],
25958 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
25959 # more information, see regular expression syntax.
25960 #
25961 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
25962 #
25963 # Regular expressions can only be used when the loadBalancingScheme is
25964 # set to INTERNAL_SELF_MANAGED.
25965 &quot;A String&quot;,
25966 ],
25967 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
25968 #
25969 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
25970 &quot;A String&quot;,
25971 ],
25972 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
25973 # The default value is false, which indicates that the CORS
25974 # policy is in effect.
25975 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
25976 # header.
25977 &quot;A String&quot;,
25978 ],
25979 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
25980 # seconds. This field translates to the Access-Control-Max-Age
25981 # header.
25982 },
25983 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
25984 # the resiliency of clients to backend service failure. As part of fault
25985 # injection, when clients send requests to a backend service, delays can be
25986 # introduced by a load balancer on a percentage of requests before sending
25987 # those requests to the backend service. Similarly requests from clients can
25988 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
25989 # that are configured with a fault_injection_policy if:
25990 # 1. The traffic is generated by fault injection AND
25991 # 2. The fault injection is not a delay fault injection.
25992 # Fault injection is not supported with the classic Application Load Balancer
25993 # . To see which load balancers support fault injection,
25994 # see Load
25995 # balancing: Routing and traffic management features.
25996 # the resiliency of clients to backend service failure. As part of fault
25997 # injection, when clients send requests to a backend service, delays can be
25998 # introduced by the load balancer on a percentage of requests before sending
25999 # those request to the backend service. Similarly requests from clients can be
26000 # aborted by the load balancer for a percentage of requests.
26001 &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
26002 # injection.
26003 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
26004 #
26005 # The value must be from 200 to 599 inclusive.
26006 #
26007 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
26008 # according to this
26009 # mapping table. HTTP status 200 is mapped to gRPC status
26010 # UNKNOWN. Injecting an OK status is currently not supported by
26011 # Traffic Director.
26012 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
26013 # that is aborted as part of fault injection.
26014 #
26015 # The value must be from 0.0 to 100.0 inclusive.
26016 },
26017 &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
26018 # injection, before being sent to a backend service.
26019 # request to the backend service as part of fault injection.
26020 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
26021 # as a count of seconds and fractions of seconds at nanosecond
26022 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
26023 # or &quot;month&quot;. Range is approximately 10,000 years.
26024 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
26025 # Durations less than one second are represented with a 0
26026 # `seconds` field and a positive `nanos` field. Must be from 0
26027 # to 999,999,999 inclusive.
26028 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
26029 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
26030 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
26031 },
26032 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
26033 # which a delay is introduced as part of fault injection.
26034 #
26035 # The value must be from 0.0 to 100.0 inclusive.
26036 },
26037 },
26038 &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
26039 # Global EXTERNAL_MANAGED load balancer schemes.
26040 # Either Cloud CDN must be enabled on the backend service or backend bucket
26041 # serving the route, or cache policy must be configured on the same route
26042 # dynamically processes and delivers images from the network edge.
26043 # Image Optimization is only available for Global External Application Load
26044 # Balancers.
26045 # Either Cloud CDN must be enabled on the backend service or backend bucket
26046 # serving the route, or cache policy must be configured on the same route.
26047 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
26048 },
26049 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
26050 # Unlike the timeout field where the timeout duration starts
26051 # from the time the request has been fully processed (known as*end-of-stream*),
26052 # the duration in this field is computed from the beginning of the stream
26053 # until the response has been processed, including all retries. A
26054 # stream that does not complete in this duration is closed.
26055 #
26056 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
26057 # with the route.
26058 #
26059 # This field is only allowed if the Url map is used with backend services
26060 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
26061 # as a count of seconds and fractions of seconds at nanosecond
26062 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
26063 # or &quot;month&quot;. Range is approximately 10,000 years.
26064 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
26065 # Durations less than one second are represented with a 0
26066 # `seconds` field and a positive `nanos` field. Must be from 0
26067 # to 999,999,999 inclusive.
26068 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
26069 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
26070 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
26071 },
26072 &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
26073 # are shadowed to a separate mirrored backend service. The load balancer does
26074 # not wait for responses from the shadow service. Before sending traffic
26075 # to the shadow service, the host / authority header is suffixed with-shadow.
26076 #
26077 # Not supported when the URL map is bound to a target gRPC proxy that
26078 # has the validateForProxyless field set to true.
26079 # are shadowed to a separate mirrored backend service. The load balancer
26080 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
26081 # to the shadow service, the host or authority header is suffixed with-shadow.
26082 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
26083 # mirrored to.
26084 #
26085 # The backend service configured for a mirroring
26086 # policy must reference backends that are of the same type as the original
26087 # backend service matched in the URL map.
26088 #
26089 # Serverless NEG backends are not currently supported as a mirrored
26090 # backend service.
26091 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
26092 },
26093 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
26094 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
26095 # If not specified, defaults to 1.
26096 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
26097 #
26098 # If not specified, will use the timeout set in theHttpRouteAction field.
26099 # If timeout in the HttpRouteAction field is not set, this field
26100 # uses the largest timeout
26101 # among all backend services associated with the route.
26102 #
26103 # Not supported when the URL map is bound to a target gRPC proxy that
26104 # has the validateForProxyless field set to true.
26105 # as a count of seconds and fractions of seconds at nanosecond
26106 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
26107 # or &quot;month&quot;. Range is approximately 10,000 years.
26108 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
26109 # Durations less than one second are represented with a 0
26110 # `seconds` field and a positive `nanos` field. Must be from 0
26111 # to 999,999,999 inclusive.
26112 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
26113 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
26114 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
26115 },
26116 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
26117 # values are:
26118 #
26119 # - 5xx: retry is attempted if the instance or endpoint
26120 # responds with any 5xx response code, or if the instance or
26121 # endpoint does not respond at all. For example, disconnects, reset, read
26122 # timeout, connection failure, and refused streams.
26123 # - gateway-error: Similar to 5xx, but only
26124 # applies to response codes 502, 503 or504.
26125 # - connect-failure: a retry is attempted on failures
26126 # connecting to the instance or endpoint. For example, connection
26127 # timeouts.
26128 # - retriable-4xx: a retry is attempted if the instance
26129 # or endpoint responds with a 4xx response code.
26130 # The only error that you can retry is error code 409.
26131 # - refused-stream: a retry is attempted if the instance
26132 # or endpoint resets the stream with a REFUSED_STREAM error
26133 # code. This reset type indicates that it is safe to retry.
26134 # - cancelled: a retry is attempted if the gRPC status
26135 # code in the response header is set to cancelled.
26136 # - deadline-exceeded: a retry is attempted if the gRPC
26137 # status code in the response header is set todeadline-exceeded.
26138 # - internal: a retry is attempted if the gRPC
26139 # status code in the response header is set tointernal.
26140 # - resource-exhausted: a retry is attempted if the gRPC
26141 # status code in the response header is set toresource-exhausted.
26142 # - unavailable: a retry is attempted if the gRPC
26143 # status code in the response header is set tounavailable.
26144 #
26145 # Only the following codes are supported when the URL map is bound to
26146 # target gRPC proxy that has validateForProxyless field set to true.
26147 #
26148 # - cancelled
26149 # - deadline-exceeded
26150 # - internal
26151 # - resource-exhausted
26152 # - unavailable
26153 &quot;A String&quot;,
26154 ],
26155 },
26156 &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
26157 # time the request has been fully processed (known as *end-of-stream*)
26158 # up until the response has been processed. Timeout includes
26159 # all retries.
26160 #
26161 # If not specified, this field uses the largest timeout among all backend
26162 # services associated with the route.
26163 #
26164 # Not supported when the URL map is bound to a target gRPC proxy that
26165 # has validateForProxyless field set to true.
26166 # as a count of seconds and fractions of seconds at nanosecond
26167 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
26168 # or &quot;month&quot;. Range is approximately 10,000 years.
26169 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
26170 # Durations less than one second are represented with a 0
26171 # `seconds` field and a positive `nanos` field. Must be from 0
26172 # to 999,999,999 inclusive.
26173 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
26174 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
26175 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
26176 },
26177 &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
26178 # to the matched service.
26179 #
26180 # urlRewrite is the only action supported in UrlMaps
26181 # for classic Application Load Balancers.
26182 #
26183 # Not supported when the URL map is bound to a target gRPC proxy that
26184 # has the validateForProxyless field set to true.
26185 # backend service.
26186 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
26187 # host header is replaced with contents of hostRewrite.
26188 #
26189 # The value must be from 1 to 255 characters.
26190 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
26191 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
26192 #
26193 # The value must be from 1 to 1024 characters.
26194 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
26195 # header) using the HTTP template syntax.
26196 #
26197 # A corresponding
26198 # path_template_match must be specified. Any template variables must exist in
26199 # the path_template_match field.
26200 #
26201 #
26202 # - -At least one variable must be specified in the path_template_match
26203 # field
26204 # - You can omit variables from the rewritten URL
26205 # - The * and ** operators cannot be matched
26206 # unless they have a corresponding variable name - e.g.
26207 # {format=*} or {var=**}.
26208 #
26209 # For example, a path_template_match of /static/{format=**}
26210 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
26211 # rewrite, so that /{country}/{format}/{suffix=**} can be
26212 # rewritten as /content/{format}/{country}/{suffix}.
26213 #
26214 # At least
26215 # one non-empty routeRules[].matchRules[].path_template_match is
26216 # required.
26217 #
26218 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
26219 },
26220 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
26221 # occurs. The weights determine the fraction of traffic that flows to
26222 # their corresponding backend service. If all traffic needs to
26223 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
26224 #
26225 # After a backend service is identified and before forwarding
26226 # the request to
26227 # the backend service, advanced routing actions such as URL rewrites and
26228 # header transformations are applied depending on additional settings
26229 # specified in this HttpRouteAction.
26230 { # In contrast to a single BackendService in
26231 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
26232 # multiple backend services. The volume of traffic for each
26233 # backend service is proportional to the weight specified
26234 # in each WeightedBackendService
26235 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
26236 # resource. Before
26237 # forwarding the request to backendService, the load balancer
26238 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
26239 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
26240 # effect for the selected backendService.
26241 #
26242 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
26243 #
26244 # headerAction is not supported for load balancers that have
26245 # their loadBalancingScheme set to EXTERNAL.
26246 #
26247 # Not supported when the URL map is bound to a target gRPC proxy that
26248 # has validateForProxyless field set to true.
26249 # the request is passed along to the selected backendService.
26250 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
26251 { # Specification determining how headers are added to requests or responses.
26252 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
26253 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
26254 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
26255 # that already
26256 # exist for the header. If true, headerValue is set for the
26257 # header, discarding any values that were set for that header.
26258 #
26259 # The default value is true,
26260 # unless a variable is present in headerValue,
26261 # in which case the default value is false.
26262 # .
26263 },
26264 ],
26265 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
26266 # request before forwarding the request to the backendService.
26267 &quot;A String&quot;,
26268 ],
26269 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
26270 # client.
26271 { # Specification determining how headers are added to requests or responses.
26272 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
26273 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
26274 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
26275 # that already
26276 # exist for the header. If true, headerValue is set for the
26277 # header, discarding any values that were set for that header.
26278 #
26279 # The default value is true,
26280 # unless a variable is present in headerValue,
26281 # in which case the default value is false.
26282 # .
26283 },
26284 ],
26285 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
26286 # response before sending the response back to the client.
26287 &quot;A String&quot;,
26288 ],
26289 },
26290 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
26291 # computed asweight / (sum of all weightedBackendService weights in routeAction).
26292 #
26293 # The selection of a backend service is determined only for new traffic.
26294 # Once a user&#x27;s request has been directed to a backend service,
26295 # subsequent requests are sent to the same backend service as
26296 # determined by the backend service&#x27;s session affinity policy.
26297 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
26298 # splitting. If you do, the weighted traffic splitting configuration takes
26299 # precedence.
26300 #
26301 # The value must be from 0 to 1000.
26302 },
26303 ],
26304 },
26305 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
26306 # is directed if this rule is matched. If routeAction is
26307 # also specified, advanced routing actions, such as URL rewrites,
26308 # take effect before sending the request to the backend.
26309 #
26310 #
26311 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
26312 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
26313 # specified by urlRedirect.
26314 #
26315 #
26316 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
26317 #
26318 #
26319 # Not supported when the URL map is bound to a target gRPC proxy.
26320 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
26321 # was supplied in the request.
26322 #
26323 # The value must be from 1 to 255
26324 # characters.
26325 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
26326 # set to HTTPS.
26327 # If set to false, the URL scheme of the redirected request
26328 # remains the same as that of the request.
26329 #
26330 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
26331 #
26332 # The default is set to false.
26333 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
26334 # that was supplied in the request.
26335 #
26336 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
26337 # supplied, the path of the original request is used for the redirect.
26338 #
26339 # The value must be from 1 to 1024 characters.
26340 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
26341 # the HttpRouteRuleMatch, retaining the remaining portion
26342 # of the URL before redirecting the request.
26343 #
26344 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
26345 # supplied, the path of the original request is used for the redirect.
26346 #
26347 # The value must be from 1 to 1024 characters.
26348 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
26349 #
26350 # Supported values are:
26351 #
26352 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
26353 # to 301.
26354 # - FOUND, which corresponds to 302.
26355 # - SEE_OTHER which corresponds to 303.
26356 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
26357 # method is retained.
26358 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
26359 # method is retained.
26360 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
26361 # URL is
26362 # removed before redirecting the request. If set to false, the
26363 # query portion of the original URL is retained.
26364 #
26365 # The default is set to false.
26366 },
26367 },
26368 ],
26369 &quot;routeRules&quot;: [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
26370 # desired. routeRules are evaluated in order of priority, from
26371 # the lowest to highest number.
26372 #
26373 # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
26374 { # The HttpRouteRule setting specifies how to match an HTTP request
26375 # and the corresponding routing action that load balancing proxies perform.
26376 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
26377 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
26378 #
26379 # If a policy for an
26380 # error code is not configured for the RouteRule, a policy for
26381 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
26382 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
26383 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
26384 # effect.
26385 #
26386 # For example, consider a UrlMap with the following configuration:
26387 #
26388 #
26389 # - UrlMap.defaultCustomErrorResponsePolicy are configured
26390 # with policies for 5xx and 4xx errors
26391 # - A RouteRule for /coming_soon/ is configured for the
26392 # error code 404.
26393 #
26394 # 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
26395 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
26396 # the policy in RouteRule.customErrorResponsePolicy takes
26397 # effect. If any of the requests in this example encounter a 500
26398 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
26399 #
26400 # When
26401 # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
26402 # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
26403 # a retry, if load balancer is successful in reaching the
26404 # service, the customErrorResponsePolicy is ignored and
26405 # the response from the service is returned to the client.
26406 #
26407 # customErrorResponsePolicy is supported only for
26408 # global external Application Load Balancers.
26409 # backend service or backend bucket responds with an error.
26410 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
26411 #
26412 # In a given policy, if you specify rules for both a range of error codes
26413 # as well as rules for specific error codes then rules with specific error
26414 # codes have a higher priority. For example, assume that you configure a rule
26415 # for 401 (Un-authorized) code, and another for all 4 series
26416 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
26417 # However if the backend service returns a 403, the rule for4xx takes effect.
26418 { # Specifies the mapping between the response code that will be returned along
26419 # with the custom error content and the response code returned by the backend
26420 # service.
26421 &quot;matchResponseCodes&quot;: [ # Valid values include:
26422 #
26423 #
26424 # - A number between 400 and 599: For example
26425 # 401 or 503, in which case the load balancer
26426 # applies the policy if the error code exactly matches this value.
26427 # - 5xx: Load Balancer will apply the policy if the
26428 # backend service responds with any response code in the range of
26429 # 500 to 599.
26430 # - 4xx: Load
26431 # Balancer will apply the policy if the backend service responds with any
26432 # response code in the range of 400 to
26433 # 499.
26434 #
26435 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
26436 &quot;A String&quot;,
26437 ],
26438 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
26439 # error content. If overrideResponseCode is not supplied, the
26440 # same response code returned by the original backend bucket or backend
26441 # service is returned to the client.
26442 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
26443 #
26444 # path must start
26445 # with a leading slash. path cannot have trailing slashes.
26446 #
26447 # If the file is not available in backendBucket or the
26448 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
26449 #
26450 # The value must
26451 # be from 1 to 1024 characters
26452 },
26453 ],
26454 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
26455 # contains the custom error content. Examples are:
26456 #
26457 #
26458 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
26459 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
26460 # - global/backendBuckets/myBackendBucket
26461 #
26462 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
26463 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
26464 #
26465 # If load balancer cannot reach
26466 # the backendBucket, a simple Not Found Error will
26467 # be returned, with the original response code (oroverrideResponseCode if configured).
26468 #
26469 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
26470 },
26471 &quot;description&quot;: &quot;A String&quot;, # The short description conveying the intent of this routeRule.
26472 #
26473 #
26474 # The description can have a maximum length of 1024 characters.
26475 &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
26476 # for the selected backendService.
26477 #
26478 # The headerAction value specified here is applied before the
26479 # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
26480 #
26481 # HeaderAction is not supported for load balancers
26482 # that have
26483 # their loadBalancingScheme set to EXTERNAL.
26484 #
26485 # Not supported when the URL map is bound to a target gRPC proxy that
26486 # has validateForProxyless field set to true.
26487 # the request is passed along to the selected backendService.
26488 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
26489 { # Specification determining how headers are added to requests or responses.
26490 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
26491 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
26492 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
26493 # that already
26494 # exist for the header. If true, headerValue is set for the
26495 # header, discarding any values that were set for that header.
26496 #
26497 # The default value is true,
26498 # unless a variable is present in headerValue,
26499 # in which case the default value is false.
26500 # .
26501 },
26502 ],
26503 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
26504 # request before forwarding the request to the backendService.
26505 &quot;A String&quot;,
26506 ],
26507 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
26508 # client.
26509 { # Specification determining how headers are added to requests or responses.
26510 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
26511 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
26512 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
26513 # that already
26514 # exist for the header. If true, headerValue is set for the
26515 # header, discarding any values that were set for that header.
26516 #
26517 # The default value is true,
26518 # unless a variable is present in headerValue,
26519 # in which case the default value is false.
26520 # .
26521 },
26522 ],
26523 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
26524 # response before sending the response back to the client.
26525 &quot;A String&quot;,
26526 ],
26527 },
26528 &quot;httpFilterConfigs&quot;: [ # Outbound route specific configuration fornetworkservices.HttpFilter resources enabled by Traffic
26529 # Director. httpFilterConfigs only applies for load balancers
26530 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
26531 # more details.
26532 #
26533 # Not supported when the URL map is bound to a target gRPC proxy that
26534 # has validateForProxyless field set to true.
26535 { # HttpFilterConfiguration supplies additional contextual settings
26536 # for networkservices.HttpFilter resources enabled by Traffic
26537 # Director.
26538 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
26539 # YAML formatted and only contain fields defined in the protobuf identified
26540 # in configTypeUrl
26541 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
26542 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
26543 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
26544 # configuration belongs to. This name must be known to the xDS client.
26545 # Example: envoy.wasm
26546 },
26547 ],
26548 &quot;httpFilterMetadata&quot;: [ # Outbound route specific metadata supplied tonetworkservices.HttpFilter resources enabled by Traffic
26549 # Director. httpFilterMetadata only applies for load balancers
26550 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
26551 # more details.
26552 #
26553 # The only configTypeUrl supported istype.googleapis.com/google.protobuf.Struct
26554 #
26555 # Not supported when the URL map is bound to a target gRPC proxy that
26556 # has validateForProxyless field set to true.
26557 { # HttpFilterConfiguration supplies additional contextual settings
26558 # for networkservices.HttpFilter resources enabled by Traffic
26559 # Director.
26560 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
26561 # YAML formatted and only contain fields defined in the protobuf identified
26562 # in configTypeUrl
26563 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
26564 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
26565 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
26566 # configuration belongs to. This name must be known to the xDS client.
26567 # Example: envoy.wasm
26568 },
26569 ],
26570 &quot;matchRules&quot;: [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
26571 # this routeRule when any of thematchRules are satisfied. However predicates within
26572 # a given matchRule have AND semantics. All predicates
26573 # within a matchRule must match for the request to
26574 # match the rule.
26575 { # HttpRouteRuleMatch specifies a set of criteria for matching
26576 # requests to an HttpRouteRule. All specified criteria must
26577 # be satisfied for a match to occur.
26578 &quot;fullPathMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
26579 # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
26580 # that may be part of the original URL.
26581 #
26582 # fullPathMatch must be from 1 to 1024 characters.
26583 #
26584 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
26585 # specified.
26586 &quot;headerMatches&quot;: [ # Specifies a list of header match criteria, all of which must match
26587 # corresponding headers in the request.
26588 { # matchRule criteria for request header matches.
26589 &quot;exactMatch&quot;: &quot;A String&quot;, # The value should exactly match contents of exactMatch.
26590 #
26591 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
26592 &quot;headerName&quot;: &quot;A String&quot;, # The name of the HTTP header to match.
26593 #
26594 # For matching against the HTTP request&#x27;s authority, use a headerMatch
26595 # with the header name &quot;:authority&quot;.
26596 #
26597 # For matching a request&#x27;s method, use the headerName &quot;:method&quot;.
26598 #
26599 # When the URL map is bound to a target gRPC proxy that has
26600 # the validateForProxyless field set to true, only
26601 # non-binary
26602 # user-specified custom metadata and the `content-type` header are supported.
26603 # The following transport-level headers cannot be used in header matching
26604 # rules:
26605 # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
26606 # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
26607 # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
26608 # `grpc-timeout` and `grpc-trace-bin`.
26609 &quot;invertMatch&quot;: True or False, # If set to false, the headerMatch is considered a
26610 # match if the preceding match criteria are met. If set to true,
26611 # the headerMatch is considered a match if the preceding
26612 # match criteria are NOT met.
26613 #
26614 # The default setting is false.
26615 &quot;prefixMatch&quot;: &quot;A String&quot;, # The value of the header must start with the contents ofprefixMatch.
26616 #
26617 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
26618 &quot;presentMatch&quot;: True or False, # A header with the contents of headerName must exist. The
26619 # match takes place whether or not the request&#x27;s header has a value.
26620 #
26621 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
26622 &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
26623 # specified in rangeMatch. If the header does not contain an
26624 # integer, number or is empty, the match fails.
26625 #
26626 # For example for a range [-5, 0]
26627 #
26628 #
26629 # - -3 will match.
26630 # - 0 will not match.
26631 # - 0.25 will not match.
26632 # - -3someString will not match.
26633 #
26634 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
26635 #
26636 # rangeMatch is not supported for load balancers
26637 # that have loadBalancingScheme set to EXTERNAL.
26638 # within the specified integer range.
26639 &quot;rangeEnd&quot;: &quot;A String&quot;, # The end of the range (exclusive) in signed long integer format.
26640 &quot;rangeStart&quot;: &quot;A String&quot;, # The start of the range (inclusive) in signed long integer format.
26641 },
26642 &quot;regexMatch&quot;: &quot;A String&quot;, # The value of the header must match the regular expression specified inregexMatch.
26643 # For more information about regular expression syntax, see Syntax.
26644 #
26645 # For matching against a port specified in the HTTP request, use a
26646 # headerMatch with headerName set to PORT and a regular expression that
26647 # satisfies the RFC2616 Host header&#x27;s port specifier.
26648 #
26649 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
26650 #
26651 # Regular expressions can only be used when the loadBalancingScheme is
26652 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
26653 # (regional scope) or INTERNAL_MANAGED.
26654 &quot;suffixMatch&quot;: &quot;A String&quot;, # The value of the header must end with the contents ofsuffixMatch.
26655 #
26656 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
26657 },
26658 ],
26659 &quot;ignoreCase&quot;: True or False, # Specifies that prefixMatch and fullPathMatch
26660 # matches are case sensitive.
26661 #
26662 # The default value is false.
26663 #
26664 # ignoreCase must not be used with regexMatch.
26665 #
26666 # Not supported when the URL map is bound to a target gRPC proxy.
26667 &quot;metadataFilters&quot;: [ # Opaque filter criteria used by the load balancer to restrict routing
26668 # configuration to a limited set of xDS
26669 # compliant clients. In their xDS requests to the load balancer, xDS clients
26670 # present node
26671 # metadata. When there is a match, the relevant routing configuration
26672 # is made available to those proxies.
26673 #
26674 # 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
26675 # the metadata. If its filterMatchCriteria is set to
26676 # MATCH_ALL, then all of its filterLabels must match with
26677 # corresponding labels provided in the metadata. If multiple
26678 # metadata filters are specified, all of them need to be
26679 # satisfied in order to be considered a match.
26680 #
26681 # metadataFilters specified here is applied after those
26682 # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
26683 #
26684 # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
26685 #
26686 # Not supported when the URL map is bound to a target gRPC proxy that
26687 # has validateForProxyless field set to true.
26688 { # Opaque filter criteria used by load balancers to restrict routing
26689 # configuration to a limited set of load balancing proxies. Proxies and
26690 # sidecars involved in load balancing would typically present metadata to the
26691 # load balancers that need to match criteria specified here. If a match takes
26692 # place, the relevant configuration is made available to those
26693 # proxies.
26694 #
26695 # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
26696 # one of thefilterLabels must match the corresponding label provided in
26697 # the metadata. If its filterMatchCriteria is set to
26698 # MATCH_ALL, then all of its filterLabels must match with
26699 # corresponding labels provided in the metadata.
26700 #
26701 # An example for using metadataFilters would be: if
26702 # load balancing involves
26703 # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in of their XDS requests to loadbalancers.
26704 &quot;filterLabels&quot;: [ # The list of label value pairs that must match labels in the provided
26705 # metadata based on filterMatchCriteria
26706 #
26707 # This list must not be empty and can have at the most 64 entries.
26708 { # MetadataFilter label name value pairs that are expected
26709 # to match corresponding labels presented as metadata to the load balancer.
26710 &quot;name&quot;: &quot;A String&quot;, # Name of metadata label.
26711 #
26712 # The name can have a maximum length of 1024 characters and must be at
26713 # least 1 character long.
26714 &quot;value&quot;: &quot;A String&quot;, # The value of the label must match the specified value.
26715 #
26716 # value can have a maximum length of 1024 characters.
26717 },
26718 ],
26719 &quot;filterMatchCriteria&quot;: &quot;A String&quot;, # Specifies how individual filter label matches
26720 # within the list of filterLabels and contributes toward the
26721 # overall metadataFilter match.
26722 #
26723 # Supported values are:
26724 #
26725 # - MATCH_ANY: at least one of the filterLabels
26726 # must have a matching label in the provided metadata.
26727 # - MATCH_ALL: all filterLabels must have
26728 # matching labels in the provided metadata.
26729 },
26730 ],
26731 &quot;pathTemplateMatch&quot;: &quot;A String&quot;, # If specified, this field defines a path template pattern that must match
26732 # the :path header after the query string is removed.
26733 #
26734 # A path template pattern can include variables and wildcards.
26735 # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
26736 # matches a single path segment, and ** that matches zero or
26737 # more path segments. The pattern must follow these rules:
26738 #
26739 #
26740 # - The value must be between 1 and 1024 characters.
26741 # - The pattern must start with a leading slash (&quot;/&quot;).
26742 # - No more than 5 operators (variables or wildcards) may appear in
26743 # the pattern.
26744 #
26745 # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
26746 # set.
26747 &quot;prefixMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the request&#x27;s
26748 # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
26749 #
26750 # The value must be from 1 to 1024 characters.
26751 #
26752 # The * character inside a prefix match is
26753 # treated as a literal character, not as a wildcard.
26754 #
26755 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
26756 # used within a matchRule.
26757 &quot;queryParameterMatches&quot;: [ # Specifies a list of query parameter match criteria, all of which must
26758 # match corresponding query parameters in the request.
26759 #
26760 # Not supported when the URL map is bound to a target gRPC proxy.
26761 { # HttpRouteRuleMatch criteria for a request&#x27;s query parameter.
26762 &quot;exactMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
26763 # parameter exactly matches the contents of exactMatch.
26764 #
26765 # Only one of presentMatch, exactMatch, orregexMatch must be set.
26766 &quot;name&quot;: &quot;A String&quot;, # The name of the query parameter to match. The query parameter must exist in
26767 # the request, in the absence of which the request match fails.
26768 &quot;presentMatch&quot;: True or False, # Specifies that the queryParameterMatch matches if the
26769 # request contains the query parameter, irrespective of whether the
26770 # parameter has a value or not.
26771 #
26772 # Only one of presentMatch, exactMatch, orregexMatch must be set.
26773 &quot;regexMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
26774 # parameter matches the regular expression specified byregexMatch. For
26775 # more information about regular expression syntax, see Syntax.
26776 #
26777 # Only one of presentMatch, exactMatch, orregexMatch must be set.
26778 #
26779 # Regular expressions can only be used when the loadBalancingScheme is
26780 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
26781 # (regional scope) or INTERNAL_MANAGED.
26782 },
26783 ],
26784 &quot;regexMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
26785 # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
26786 # supplied with the original URL. For
26787 # more information about regular expression syntax, see Syntax.
26788 #
26789 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
26790 # specified.
26791 #
26792 # Regular expressions can only be used when the loadBalancingScheme is
26793 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
26794 # (regional scope) or INTERNAL_MANAGED.
26795 },
26796 ],
26797 &quot;priority&quot;: 42, # For routeRules within a given pathMatcher,
26798 # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
26799 # of priority, from the lowest to highest number. The priority of a
26800 # rule decreases as its number increases (1, 2, 3, N+1). The first rule
26801 # that matches the request is applied.
26802 #
26803 #
26804 # You cannot configure two or more routeRules with the same priority.
26805 # Priority for each rule must be set to a number from 0 to 2147483647
26806 # inclusive.
26807 #
26808 #
26809 # Priority numbers can have gaps, which enable you to add or remove rules
26810 # in the future without affecting the rest of the rules. For example, 1, 2,
26811 # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
26812 # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
26813 # without any impact on existing rules.
26814 &quot;routeAction&quot;: { # In response to a matching matchRule, the load balancer
26815 # performs advanced routing actions, such as URL rewrites and header
26816 # transformations, before forwarding the request to the selected backend.
26817 #
26818 #
26819 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
26820 #
26821 #
26822 # URL maps for classic Application Load Balancers only support
26823 # the urlRewrite action within a route rule&#x27;srouteAction.
26824 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
26825 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
26826 # property must be specified. This policy cannot be specified if any target
26827 # backend has Identity-Aware Proxy enabled.
26828 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
26829 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
26830 # header names can be specified. The cache is bypassed for all `cacheMode`
26831 # values.
26832 &quot;A String&quot;,
26833 ],
26834 &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
26835 # on the backend type: for Backend Services, the complete request URI is
26836 # used; for Backend Buckets, the request URI is used without the protocol or
26837 # host, and only query parameters known to Cloud Storage are included.
26838 # Policy defined on Route Action.
26839 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
26840 # parameters will be included. Either specify `excludedQueryParameters`
26841 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
26842 # encoded and not treated as delimiters.
26843 #
26844 # Note: This field applies to routes that use backend services. Attempting
26845 # to set it on a route that points exclusively to Backend Buckets will
26846 # result in a configuration error. For routes that point to a Backend
26847 # Bucket, use `includedQueryParameters` to define which parameters should
26848 # be part of the cache key.
26849 &quot;A String&quot;,
26850 ],
26851 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
26852 #
26853 # Note: This setting is only applicable to routes that use a Backend
26854 # Service. It does not affect requests served by a Backend Bucket, as the
26855 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
26856 # it on a route that points exclusively to Backend Buckets will result in a
26857 # configuration error.
26858 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
26859 #
26860 # Note: This setting is only applicable to routes that use a Backend
26861 # Service. It does not affect requests served by a Backend Bucket, as the
26862 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
26863 # set on a route that points exclusively to Backend Buckets will result in
26864 # a configuration error.
26865 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
26866 # `includedQueryParameters` and `excludedQueryParameters`. If neither
26867 # is set, the entire query string will be included. If false, the query
26868 # string will be excluded from the cache key entirely.
26869 #
26870 # Note: This field applies to routes that use backend services. Attempting
26871 # to set it on a route that points exclusively to Backend Buckets will
26872 # result in a configuration error. For routes that point to a Backend
26873 # Bucket, use `includedQueryParameters` to define which parameters should
26874 # be part of the cache key.
26875 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
26876 # The name=value pair will be used in the cache key Cloud CDN generates.
26877 #
26878 # Note: This setting is only applicable to routes that use a Backend
26879 # Service. It does not affect requests served by a Backend Bucket.
26880 # Attempting to set it on a route that points exclusively to Backend
26881 # Buckets will result in a configuration error. Up to 5 cookie names can be
26882 # specified.
26883 &quot;A String&quot;,
26884 ],
26885 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
26886 &quot;A String&quot;,
26887 ],
26888 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
26889 # parameters will be excluded. Either specify `includedQueryParameters`
26890 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
26891 # encoded and not treated as delimiters.
26892 &quot;A String&quot;,
26893 ],
26894 },
26895 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
26896 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
26897 &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
26898 # content. This is used to clamp the max-age (or Expires) value sent to the
26899 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
26900 # is used for the response max-age directive, along with a &quot;public&quot;
26901 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
26902 # clamps the max-age from the origin (if specified), or else sets the
26903 # response max-age directive to the lesser of the `clientTtl` and
26904 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
26905 # present. The maximum allowed value is 31,622,400s (1 year). If not
26906 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
26907 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
26908 # `USE_ORIGIN_HEADERS`.
26909 # as a count of seconds and fractions of seconds at nanosecond
26910 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
26911 # or &quot;month&quot;. Range is approximately 10,000 years.
26912 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
26913 # Durations less than one second are represented with a 0
26914 # `seconds` field and a positive `nanos` field. Must be from 0
26915 # to 999,999,999 inclusive.
26916 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
26917 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
26918 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
26919 },
26920 &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
26921 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
26922 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
26923 # greater than that of `maxTtl`. When the `cacheMode` is set to
26924 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
26925 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
26926 # accessed objects may be evicted from the cache before the defined TTL. If
26927 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
26928 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
26929 # `USE_ORIGIN_HEADERS`.
26930 # as a count of seconds and fractions of seconds at nanosecond
26931 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
26932 # or &quot;month&quot;. Range is approximately 10,000 years.
26933 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
26934 # Durations less than one second are represented with a 0
26935 # `seconds` field and a positive `nanos` field. Must be from 0
26936 # to 999,999,999 inclusive.
26937 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
26938 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
26939 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
26940 },
26941 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
26942 # attempt to set a max-age or s-maxage higher than this, or an Expires header
26943 # more than `maxTtl` seconds in the future will be capped at the value of
26944 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
26945 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
26946 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
26947 # Infrequently accessed objects may be evicted from the cache before the
26948 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
26949 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
26950 # mode.
26951 # as a count of seconds and fractions of seconds at nanosecond
26952 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
26953 # or &quot;month&quot;. Range is approximately 10,000 years.
26954 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
26955 # Durations less than one second are represented with a 0
26956 # `seconds` field and a positive `nanos` field. Must be from 0
26957 # to 999,999,999 inclusive.
26958 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
26959 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
26960 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
26961 },
26962 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
26963 # to apply fine-grained caching for common errors or redirects.
26964 # This can reduce the load on your origin and improve end-user
26965 # experience by reducing response latency.
26966 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
26967 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
26968 # the specified response code that lack any Cache-Control, Expires, or
26969 # Pragma: no-cache directives. When the `cacheMode` is set to
26970 # `FORCE_CACHE_ALL`, negative caching applies to all responses
26971 # with the specified response code, and overrides any caching headers. By
26972 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
26973 #
26974 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
26975 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
26976 # * 405 (Method Not Found), 501 (Not Implemented): 60s
26977 #
26978 # These defaults can be overridden in `negativeCachingPolicy`.
26979 # If not specified, Cloud CDN applies negative caching by default.
26980 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
26981 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
26982 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
26983 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
26984 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
26985 # all response codes that you wish to cache. Cloud CDN will not apply any
26986 # default negative caching when a policy exists.
26987 { # Specify CDN TTLs for response error codes.
26988 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
26989 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
26990 # specified as values, and you cannot specify a status code more than
26991 # once.
26992 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
26993 # corresponding status code.
26994 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
26995 # objects may be evicted from the cache before the defined TTL.
26996 # as a count of seconds and fractions of seconds at nanosecond
26997 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
26998 # or &quot;month&quot;. Range is approximately 10,000 years.
26999 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
27000 # Durations less than one second are represented with a 0
27001 # `seconds` field and a positive `nanos` field. Must be from 0
27002 # to 999,999,999 inclusive.
27003 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
27004 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
27005 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
27006 },
27007 },
27008 ],
27009 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
27010 # requests into a small number of requests to the origin. If not specified,
27011 # Cloud CDN applies request coalescing by default.
27012 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
27013 # content with the origin, or when an error is encountered when refreshing
27014 # the cache.
27015 # This setting defines the default &quot;max-stale&quot; duration for any cached
27016 # responses that do not specify a max-stale directive. Stale responses that
27017 # exceed the TTL configured here will not be served. The default limit
27018 # (max-stale) is 86400s (1 day), which will allow stale content to be
27019 # served up to this limit beyond the max-age (or s-maxage) of a cached
27020 # response.
27021 # The maximum allowed value is 604800 (1 week).
27022 # Set this to zero (0) to disable serve-while-stale.
27023 # as a count of seconds and fractions of seconds at nanosecond
27024 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
27025 # or &quot;month&quot;. Range is approximately 10,000 years.
27026 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
27027 # Durations less than one second are represented with a 0
27028 # `seconds` field and a positive `nanos` field. Must be from 0
27029 # to 999,999,999 inclusive.
27030 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
27031 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
27032 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
27033 },
27034 },
27035 &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
27036 # information about the W3C recommendation for cross-origin resource sharing
27037 # (CORS), see Fetch API Living
27038 # Standard.
27039 #
27040 # Not supported when the URL map is bound to a target gRPC proxy.
27041 # information about the W3C recommendation for cross-origin resource sharing
27042 # (CORS), see Fetch API Living
27043 # Standard.
27044 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
27045 # indicates that
27046 # the actual request can include user credentials. This field translates to
27047 # the Access-Control-Allow-Credentials header.
27048 #
27049 # Default is false.
27050 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
27051 # header.
27052 &quot;A String&quot;,
27053 ],
27054 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
27055 # header.
27056 &quot;A String&quot;,
27057 ],
27058 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
27059 # more information, see regular expression syntax.
27060 #
27061 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
27062 #
27063 # Regular expressions can only be used when the loadBalancingScheme is
27064 # set to INTERNAL_SELF_MANAGED.
27065 &quot;A String&quot;,
27066 ],
27067 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
27068 #
27069 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
27070 &quot;A String&quot;,
27071 ],
27072 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
27073 # The default value is false, which indicates that the CORS
27074 # policy is in effect.
27075 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
27076 # header.
27077 &quot;A String&quot;,
27078 ],
27079 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
27080 # seconds. This field translates to the Access-Control-Max-Age
27081 # header.
27082 },
27083 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
27084 # the resiliency of clients to backend service failure. As part of fault
27085 # injection, when clients send requests to a backend service, delays can be
27086 # introduced by a load balancer on a percentage of requests before sending
27087 # those requests to the backend service. Similarly requests from clients can
27088 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
27089 # that are configured with a fault_injection_policy if:
27090 # 1. The traffic is generated by fault injection AND
27091 # 2. The fault injection is not a delay fault injection.
27092 # Fault injection is not supported with the classic Application Load Balancer
27093 # . To see which load balancers support fault injection,
27094 # see Load
27095 # balancing: Routing and traffic management features.
27096 # the resiliency of clients to backend service failure. As part of fault
27097 # injection, when clients send requests to a backend service, delays can be
27098 # introduced by the load balancer on a percentage of requests before sending
27099 # those request to the backend service. Similarly requests from clients can be
27100 # aborted by the load balancer for a percentage of requests.
27101 &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
27102 # injection.
27103 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
27104 #
27105 # The value must be from 200 to 599 inclusive.
27106 #
27107 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
27108 # according to this
27109 # mapping table. HTTP status 200 is mapped to gRPC status
27110 # UNKNOWN. Injecting an OK status is currently not supported by
27111 # Traffic Director.
27112 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
27113 # that is aborted as part of fault injection.
27114 #
27115 # The value must be from 0.0 to 100.0 inclusive.
27116 },
27117 &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
27118 # injection, before being sent to a backend service.
27119 # request to the backend service as part of fault injection.
27120 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
27121 # as a count of seconds and fractions of seconds at nanosecond
27122 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
27123 # or &quot;month&quot;. Range is approximately 10,000 years.
27124 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
27125 # Durations less than one second are represented with a 0
27126 # `seconds` field and a positive `nanos` field. Must be from 0
27127 # to 999,999,999 inclusive.
27128 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
27129 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
27130 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
27131 },
27132 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
27133 # which a delay is introduced as part of fault injection.
27134 #
27135 # The value must be from 0.0 to 100.0 inclusive.
27136 },
27137 },
27138 &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
27139 # Global EXTERNAL_MANAGED load balancer schemes.
27140 # Either Cloud CDN must be enabled on the backend service or backend bucket
27141 # serving the route, or cache policy must be configured on the same route
27142 # dynamically processes and delivers images from the network edge.
27143 # Image Optimization is only available for Global External Application Load
27144 # Balancers.
27145 # Either Cloud CDN must be enabled on the backend service or backend bucket
27146 # serving the route, or cache policy must be configured on the same route.
27147 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
27148 },
27149 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
27150 # Unlike the timeout field where the timeout duration starts
27151 # from the time the request has been fully processed (known as*end-of-stream*),
27152 # the duration in this field is computed from the beginning of the stream
27153 # until the response has been processed, including all retries. A
27154 # stream that does not complete in this duration is closed.
27155 #
27156 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
27157 # with the route.
27158 #
27159 # This field is only allowed if the Url map is used with backend services
27160 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
27161 # as a count of seconds and fractions of seconds at nanosecond
27162 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
27163 # or &quot;month&quot;. Range is approximately 10,000 years.
27164 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
27165 # Durations less than one second are represented with a 0
27166 # `seconds` field and a positive `nanos` field. Must be from 0
27167 # to 999,999,999 inclusive.
27168 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
27169 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
27170 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
27171 },
27172 &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
27173 # are shadowed to a separate mirrored backend service. The load balancer does
27174 # not wait for responses from the shadow service. Before sending traffic
27175 # to the shadow service, the host / authority header is suffixed with-shadow.
27176 #
27177 # Not supported when the URL map is bound to a target gRPC proxy that
27178 # has the validateForProxyless field set to true.
27179 # are shadowed to a separate mirrored backend service. The load balancer
27180 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
27181 # to the shadow service, the host or authority header is suffixed with-shadow.
27182 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
27183 # mirrored to.
27184 #
27185 # The backend service configured for a mirroring
27186 # policy must reference backends that are of the same type as the original
27187 # backend service matched in the URL map.
27188 #
27189 # Serverless NEG backends are not currently supported as a mirrored
27190 # backend service.
27191 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
27192 },
27193 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
27194 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
27195 # If not specified, defaults to 1.
27196 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
27197 #
27198 # If not specified, will use the timeout set in theHttpRouteAction field.
27199 # If timeout in the HttpRouteAction field is not set, this field
27200 # uses the largest timeout
27201 # among all backend services associated with the route.
27202 #
27203 # Not supported when the URL map is bound to a target gRPC proxy that
27204 # has the validateForProxyless field set to true.
27205 # as a count of seconds and fractions of seconds at nanosecond
27206 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
27207 # or &quot;month&quot;. Range is approximately 10,000 years.
27208 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
27209 # Durations less than one second are represented with a 0
27210 # `seconds` field and a positive `nanos` field. Must be from 0
27211 # to 999,999,999 inclusive.
27212 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
27213 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
27214 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
27215 },
27216 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
27217 # values are:
27218 #
27219 # - 5xx: retry is attempted if the instance or endpoint
27220 # responds with any 5xx response code, or if the instance or
27221 # endpoint does not respond at all. For example, disconnects, reset, read
27222 # timeout, connection failure, and refused streams.
27223 # - gateway-error: Similar to 5xx, but only
27224 # applies to response codes 502, 503 or504.
27225 # - connect-failure: a retry is attempted on failures
27226 # connecting to the instance or endpoint. For example, connection
27227 # timeouts.
27228 # - retriable-4xx: a retry is attempted if the instance
27229 # or endpoint responds with a 4xx response code.
27230 # The only error that you can retry is error code 409.
27231 # - refused-stream: a retry is attempted if the instance
27232 # or endpoint resets the stream with a REFUSED_STREAM error
27233 # code. This reset type indicates that it is safe to retry.
27234 # - cancelled: a retry is attempted if the gRPC status
27235 # code in the response header is set to cancelled.
27236 # - deadline-exceeded: a retry is attempted if the gRPC
27237 # status code in the response header is set todeadline-exceeded.
27238 # - internal: a retry is attempted if the gRPC
27239 # status code in the response header is set tointernal.
27240 # - resource-exhausted: a retry is attempted if the gRPC
27241 # status code in the response header is set toresource-exhausted.
27242 # - unavailable: a retry is attempted if the gRPC
27243 # status code in the response header is set tounavailable.
27244 #
27245 # Only the following codes are supported when the URL map is bound to
27246 # target gRPC proxy that has validateForProxyless field set to true.
27247 #
27248 # - cancelled
27249 # - deadline-exceeded
27250 # - internal
27251 # - resource-exhausted
27252 # - unavailable
27253 &quot;A String&quot;,
27254 ],
27255 },
27256 &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
27257 # time the request has been fully processed (known as *end-of-stream*)
27258 # up until the response has been processed. Timeout includes
27259 # all retries.
27260 #
27261 # If not specified, this field uses the largest timeout among all backend
27262 # services associated with the route.
27263 #
27264 # Not supported when the URL map is bound to a target gRPC proxy that
27265 # has validateForProxyless field set to true.
27266 # as a count of seconds and fractions of seconds at nanosecond
27267 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
27268 # or &quot;month&quot;. Range is approximately 10,000 years.
27269 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
27270 # Durations less than one second are represented with a 0
27271 # `seconds` field and a positive `nanos` field. Must be from 0
27272 # to 999,999,999 inclusive.
27273 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
27274 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
27275 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
27276 },
27277 &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
27278 # to the matched service.
27279 #
27280 # urlRewrite is the only action supported in UrlMaps
27281 # for classic Application Load Balancers.
27282 #
27283 # Not supported when the URL map is bound to a target gRPC proxy that
27284 # has the validateForProxyless field set to true.
27285 # backend service.
27286 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
27287 # host header is replaced with contents of hostRewrite.
27288 #
27289 # The value must be from 1 to 255 characters.
27290 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
27291 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
27292 #
27293 # The value must be from 1 to 1024 characters.
27294 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
27295 # header) using the HTTP template syntax.
27296 #
27297 # A corresponding
27298 # path_template_match must be specified. Any template variables must exist in
27299 # the path_template_match field.
27300 #
27301 #
27302 # - -At least one variable must be specified in the path_template_match
27303 # field
27304 # - You can omit variables from the rewritten URL
27305 # - The * and ** operators cannot be matched
27306 # unless they have a corresponding variable name - e.g.
27307 # {format=*} or {var=**}.
27308 #
27309 # For example, a path_template_match of /static/{format=**}
27310 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
27311 # rewrite, so that /{country}/{format}/{suffix=**} can be
27312 # rewritten as /content/{format}/{country}/{suffix}.
27313 #
27314 # At least
27315 # one non-empty routeRules[].matchRules[].path_template_match is
27316 # required.
27317 #
27318 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
27319 },
27320 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
27321 # occurs. The weights determine the fraction of traffic that flows to
27322 # their corresponding backend service. If all traffic needs to
27323 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
27324 #
27325 # After a backend service is identified and before forwarding
27326 # the request to
27327 # the backend service, advanced routing actions such as URL rewrites and
27328 # header transformations are applied depending on additional settings
27329 # specified in this HttpRouteAction.
27330 { # In contrast to a single BackendService in
27331 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
27332 # multiple backend services. The volume of traffic for each
27333 # backend service is proportional to the weight specified
27334 # in each WeightedBackendService
27335 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
27336 # resource. Before
27337 # forwarding the request to backendService, the load balancer
27338 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
27339 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
27340 # effect for the selected backendService.
27341 #
27342 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
27343 #
27344 # headerAction is not supported for load balancers that have
27345 # their loadBalancingScheme set to EXTERNAL.
27346 #
27347 # Not supported when the URL map is bound to a target gRPC proxy that
27348 # has validateForProxyless field set to true.
27349 # the request is passed along to the selected backendService.
27350 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
27351 { # Specification determining how headers are added to requests or responses.
27352 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
27353 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
27354 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
27355 # that already
27356 # exist for the header. If true, headerValue is set for the
27357 # header, discarding any values that were set for that header.
27358 #
27359 # The default value is true,
27360 # unless a variable is present in headerValue,
27361 # in which case the default value is false.
27362 # .
27363 },
27364 ],
27365 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
27366 # request before forwarding the request to the backendService.
27367 &quot;A String&quot;,
27368 ],
27369 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
27370 # client.
27371 { # Specification determining how headers are added to requests or responses.
27372 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
27373 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
27374 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
27375 # that already
27376 # exist for the header. If true, headerValue is set for the
27377 # header, discarding any values that were set for that header.
27378 #
27379 # The default value is true,
27380 # unless a variable is present in headerValue,
27381 # in which case the default value is false.
27382 # .
27383 },
27384 ],
27385 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
27386 # response before sending the response back to the client.
27387 &quot;A String&quot;,
27388 ],
27389 },
27390 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
27391 # computed asweight / (sum of all weightedBackendService weights in routeAction).
27392 #
27393 # The selection of a backend service is determined only for new traffic.
27394 # Once a user&#x27;s request has been directed to a backend service,
27395 # subsequent requests are sent to the same backend service as
27396 # determined by the backend service&#x27;s session affinity policy.
27397 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
27398 # splitting. If you do, the weighted traffic splitting configuration takes
27399 # precedence.
27400 #
27401 # The value must be from 0 to 1000.
27402 },
27403 ],
27404 },
27405 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
27406 # is directed if this rule is matched. If routeAction is
27407 # also specified, advanced routing actions, such as URL rewrites,
27408 # take effect before sending the request to the backend.
27409 #
27410 #
27411 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
27412 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
27413 # specified by urlRedirect.
27414 #
27415 #
27416 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
27417 #
27418 #
27419 # Not supported when the URL map is bound to a target gRPC proxy.
27420 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
27421 # was supplied in the request.
27422 #
27423 # The value must be from 1 to 255
27424 # characters.
27425 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
27426 # set to HTTPS.
27427 # If set to false, the URL scheme of the redirected request
27428 # remains the same as that of the request.
27429 #
27430 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
27431 #
27432 # The default is set to false.
27433 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
27434 # that was supplied in the request.
27435 #
27436 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
27437 # supplied, the path of the original request is used for the redirect.
27438 #
27439 # The value must be from 1 to 1024 characters.
27440 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
27441 # the HttpRouteRuleMatch, retaining the remaining portion
27442 # of the URL before redirecting the request.
27443 #
27444 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
27445 # supplied, the path of the original request is used for the redirect.
27446 #
27447 # The value must be from 1 to 1024 characters.
27448 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
27449 #
27450 # Supported values are:
27451 #
27452 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
27453 # to 301.
27454 # - FOUND, which corresponds to 302.
27455 # - SEE_OTHER which corresponds to 303.
27456 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
27457 # method is retained.
27458 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
27459 # method is retained.
27460 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
27461 # URL is
27462 # removed before redirecting the request. If set to false, the
27463 # query portion of the original URL is retained.
27464 #
27465 # The default is set to false.
27466 },
27467 },
27468 ],
27469 },
27470 ],
27471 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the regional URL map resides.
27472 # This field is not applicable to global URL maps.
27473 # You must specify this field as part of the HTTP request URL. It is
27474 # not settable as a field in the request body.
27475 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
27476 &quot;status&quot;: { # [Output Only] The status of the URL map. # Output only. [Output Only] The status of the URL map.
27477 &quot;quotaUsage&quot;: { # Message representing the quota usage for a UrlMap. # Output only. Summary of quota usage for given UrlMap.
27478 &quot;forwardingRules&quot;: 42, # Output only. The number of forwarding rules that uses this UrlMap.
27479 &quot;units&quot;: &quot;A String&quot;, # Output only. The number of quota units calculated for this UrlMap.
27480 },
27481 },
27482 &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
27483 # maximum of 100 tests per UrlMap.
27484 #
27485 # Not supported when the URL map is bound to a target gRPC proxy that
27486 # has validateForProxyless field set to true.
27487 { # Message for the expected URL mappings.
27488 &quot;description&quot;: &quot;A String&quot;, # Description of this test case.
27489 &quot;expectedOutputUrl&quot;: &quot;A String&quot;, # The expected output URL evaluated by the load balancer
27490 # containing the scheme, host, path and query parameters.
27491 #
27492 # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
27493 # the load balancer to backends. For rules with urlRewrite,
27494 # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
27495 #
27496 # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer&#x27;s
27497 # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
27498 # If urlRedirect specifies strip_query, the test
27499 # passes only if expectedOutputUrl does not contain any query
27500 # parameters.
27501 #
27502 # expectedOutputUrl is optional whenservice is specified.
27503 &quot;expectedRedirectResponseCode&quot;: 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
27504 # load balancer&#x27;s redirect response.
27505 #
27506 # expectedRedirectResponseCode cannot be set whenservice is set.
27507 &quot;headers&quot;: [ # HTTP headers for this request. If headers contains
27508 # a host header, then host must also match the header value.
27509 { # HTTP headers used in UrlMapTests.
27510 &quot;name&quot;: &quot;A String&quot;, # Header name.
27511 &quot;value&quot;: &quot;A String&quot;, # Header value.
27512 },
27513 ],
27514 &quot;host&quot;: &quot;A String&quot;, # Host portion of the URL. If headers contains a host header,
27515 # then host must also match the header value.
27516 &quot;path&quot;: &quot;A String&quot;, # Path portion of the URL.
27517 &quot;service&quot;: &quot;A String&quot;, # Expected BackendService or BackendBucket resource
27518 # the given URL should be mapped to.
27519 #
27520 # The service field cannot
27521 # be set if expectedRedirectResponseCode is set.
27522 },
27523 ],
27524 },
27525 }
27526
27527 x__xgafv: string, V1 error format.
27528 Allowed values
27529 1 - v1 error format
27530 2 - v2 error format
27531
27532 Returns:
27533 An object of the form:
27534
27535 {
27536 &quot;result&quot;: { # Message representing the validation result for a UrlMap.
27537 &quot;loadErrors&quot;: [
27538 &quot;A String&quot;,
27539 ],
27540 &quot;loadSucceeded&quot;: True or False, # Whether the given UrlMap can be successfully loaded.
27541 # If false, &#x27;loadErrors&#x27; indicates the reasons.
27542 &quot;quotaUsage&quot;: { # Message representing the quota usage for a UrlMap. # Output only. Summary of quota usage for given UrlMap.
27543 &quot;forwardingRules&quot;: 42, # Output only. The number of forwarding rules that uses this UrlMap.
27544 &quot;units&quot;: &quot;A String&quot;, # Output only. The number of quota units calculated for this UrlMap.
27545 },
27546 &quot;testFailures&quot;: [
27547 {
27548 &quot;actualOutputUrl&quot;: &quot;A String&quot;, # The actual output URL evaluated by a load balancer containing the scheme,
27549 # host, path and query parameters.
27550 &quot;actualRedirectResponseCode&quot;: 42, # Actual HTTP status code for rule with `urlRedirect`
27551 # calculated by load balancer
27552 &quot;actualService&quot;: &quot;A String&quot;, # BackendService or BackendBucket returned by load
27553 # balancer.
27554 &quot;expectedOutputUrl&quot;: &quot;A String&quot;, # The expected output URL evaluated by a load balancer containing the scheme,
27555 # host, path and query parameters.
27556 &quot;expectedRedirectResponseCode&quot;: 42, # Expected HTTP status code for rule with `urlRedirect`
27557 # calculated by load balancer
27558 &quot;expectedService&quot;: &quot;A String&quot;, # Expected BackendService or BackendBucket resource
27559 # the given URL should be mapped to.
27560 &quot;headers&quot;: [ # HTTP headers of the request.
27561 { # HTTP headers used in UrlMapTests.
27562 &quot;name&quot;: &quot;A String&quot;, # Header name.
27563 &quot;value&quot;: &quot;A String&quot;, # Header value.
27564 },
27565 ],
27566 &quot;host&quot;: &quot;A String&quot;, # Host portion of the URL.
27567 &quot;path&quot;: &quot;A String&quot;, # Path portion including query parameters in the URL.
27568 },
27569 ],
27570 &quot;testPassed&quot;: True or False, # If successfully loaded, this field indicates whether the test passed.
27571 # If false, &#x27;testFailures&#x27;s indicate the reason of failure.
27572 },
27573 }</pre>
27574 </div>
27575
27576 </body></html>