Debian Codegraph @

docs/dyn/compute_alpha.regionUrlMaps.html

raw
1 <html><body>
2 <style>
3
4 body, h1, h2, h3, div, span, p, pre, a {
5 margin: 0;
6 padding: 0;
7 border: 0;
8 font-weight: inherit;
9 font-style: inherit;
10 font-size: 100%;
11 font-family: inherit;
12 vertical-align: baseline;
13 }
14
15 body {
16 font-size: 13px;
17 padding: 1em;
18 }
19
20 h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23 }
24
25 h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28 }
29
30 h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34 }
35
36 pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39 }
40
41 pre {
42 margin-top: 0.5em;
43 }
44
45 h1, h2, h3, p {
46 font-family: Arial, sans serif;
47 }
48
49 h1, h2, h3 {
50 border-bottom: solid #CCC 1px;
51 }
52
53 .toc_element {
54 margin-top: 0.5em;
55 }
56
57 .firstline {
58 margin-left: 2 em;
59 }
60
61 .method {
62 margin-top: 1em;
63 border: solid 1px #CCC;
64 padding: 1em;
65 background: #EEE;
66 }
67
68 .details {
69 font-weight: bold;
70 font-size: 14px;
71 }
72
73 </style>
74
75 <h1><a href="compute_alpha.html">Compute Engine API</a> . <a href="compute_alpha.regionUrlMaps.html">regionUrlMaps</a></h1>
76 <h2>Instance Methods</h2>
77 <p class="toc_element">
78 <code><a href="#close">close()</a></code></p>
79 <p class="firstline">Close httplib2 connections.</p>
80 <p class="toc_element">
81 <code><a href="#delete">delete(project, region, urlMap, requestId=None, x__xgafv=None)</a></code></p>
82 <p class="firstline">Deletes the specified UrlMap resource.</p>
83 <p class="toc_element">
84 <code><a href="#get">get(project, region, urlMap, x__xgafv=None)</a></code></p>
85 <p class="firstline">Returns the specified UrlMap resource.</p>
86 <p class="toc_element">
87 <code><a href="#insert">insert(project, region, body=None, requestId=None, x__xgafv=None)</a></code></p>
88 <p class="firstline">Creates a UrlMap resource in the specified project using</p>
89 <p class="toc_element">
90 <code><a href="#invalidateCache">invalidateCache(project, region, urlMap, body=None, requestId=None, x__xgafv=None)</a></code></p>
91 <p class="firstline">Initiates a cache invalidation operation, invalidating the specified path,</p>
92 <p class="toc_element">
93 <code><a href="#list">list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</a></code></p>
94 <p class="firstline">Retrieves the list of UrlMap resources available to the specified</p>
95 <p class="toc_element">
96 <code><a href="#list_next">list_next()</a></code></p>
97 <p class="firstline">Retrieves the next page of results.</p>
98 <p class="toc_element">
99 <code><a href="#patch">patch(project, region, urlMap, body=None, requestId=None, x__xgafv=None)</a></code></p>
100 <p class="firstline">Patches the specified UrlMap resource with the data included in the</p>
101 <p class="toc_element">
102 <code><a href="#testIamPermissions">testIamPermissions(project, region, resource, body=None, x__xgafv=None)</a></code></p>
103 <p class="firstline">Returns permissions that a caller has on the specified resource.</p>
104 <p class="toc_element">
105 <code><a href="#update">update(project, region, urlMap, body=None, requestId=None, x__xgafv=None)</a></code></p>
106 <p class="firstline">Updates the specified UrlMap resource with the data included in the</p>
107 <p class="toc_element">
108 <code><a href="#validate">validate(project, region, urlMap, body=None, x__xgafv=None)</a></code></p>
109 <p class="firstline">Runs static validation for the UrlMap. In particular, the tests of the</p>
110 <h3>Method Details</h3>
111 <div class="method">
112 <code class="details" id="close">close()</code>
113 <pre>Close httplib2 connections.</pre>
114 </div>
115
116 <div class="method">
117 <code class="details" id="delete">delete(project, region, urlMap, requestId=None, x__xgafv=None)</code>
118 <pre>Deletes the specified UrlMap resource.
119
120 Args:
121 project: string, Project ID for this request. (required)
122 region: string, Name of the region scoping this request. (required)
123 urlMap: string, Name of the UrlMap resource to delete. (required)
124 requestId: string, begin_interface: MixerMutationRequestBuilder
125 Request ID to support idempotency.
126 x__xgafv: string, V1 error format.
127 Allowed values
128 1 - v1 error format
129 2 - v2 error format
130
131 Returns:
132 An object of the form:
133
134 { # Represents an Operation resource.
135 #
136 # Google Compute Engine has three Operation resources:
137 #
138 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
139 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
140 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
141 #
142 # You can use an operation resource to manage asynchronous API requests.
143 # For more information, readHandling
144 # API responses.
145 #
146 # Operations can be global, regional or zonal.
147 #
148 # - For global operations, use the `globalOperations`
149 # resource.
150 # - For regional operations, use the
151 # `regionOperations` resource.
152 # - For zonal operations, use
153 # the `zoneOperations` resource.
154 #
155 #
156 #
157 # For more information, read
158 # Global, Regional, and Zonal Resources.
159 #
160 # Note that completed Operation resources have a limited
161 # retention period.
162 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
163 # Not present otherwise.
164 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
165 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
166 # set when the operation is created.
167 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
168 # text format.
169 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
170 # this field will be populated.
171 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
172 # operation.
173 {
174 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
175 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
176 # details. There is a set of defined message types to use for providing
177 # details.The syntax depends on the error code. For example,
178 # QuotaExceededInfo will have details when the error code is
179 # QUOTA_EXCEEDED.
180 {
181 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
182 #
183 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
184 # is not enabled:
185 #
186 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
187 # &quot;domain&quot;: &quot;googleapis.com&quot;
188 # &quot;metadata&quot;: {
189 # &quot;resource&quot;: &quot;projects/123&quot;,
190 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
191 # }
192 # }
193 #
194 # This response indicates that the pubsub.googleapis.com API is not enabled.
195 #
196 # Example of an error that is returned when attempting to create a Spanner
197 # instance in a region that is out of stock:
198 #
199 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
200 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
201 # &quot;metadata&quot;: {
202 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
203 # }
204 # }
205 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
206 # is typically the registered service name of the tool or product that
207 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
208 # generated by some common infrastructure, the error domain must be a
209 # globally unique value that identifies the infrastructure. For Google API
210 # infrastructure, the error domain is &quot;googleapis.com&quot;.
211 &quot;metadatas&quot;: { # Additional structured details about this error.
212 #
213 # Keys must match a regular expression of `a-z+` but should
214 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
215 # length. When identifying the current value of an exceeded limit, the units
216 # should be contained in the key, not the value. For example, rather than
217 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
218 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
219 # instances that can be created in a single (batch) request.
220 &quot;a_key&quot;: &quot;A String&quot;,
221 },
222 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
223 # proximate cause of the error. Error reasons are unique within a particular
224 # domain of errors. This should be at most 63 characters and match a
225 # regular expression of `A-Z+[A-Z0-9]`, which represents
226 # UPPER_SNAKE_CASE.
227 },
228 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
229 #
230 # For example, if a quota check failed with an error indicating the calling
231 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
232 # directly to the right place in the developer console to flip the bit.
233 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
234 { # Describes a URL link.
235 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
236 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
237 },
238 ],
239 },
240 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
241 # which can be attached to an RPC error.
242 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
243 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
244 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
245 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
246 },
247 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
248 &quot;dimensions&quot;: { # The map holding related quota dimensions.
249 &quot;a_key&quot;: &quot;A String&quot;,
250 },
251 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
252 # type or metric.
253 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
254 # or metric.
255 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
256 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
257 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
258 },
259 },
260 ],
261 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
262 # This property is optional.
263 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
264 },
265 ],
266 },
267 &quot;getVersionOperationMetadata&quot;: {
268 &quot;inlineSbomInfo&quot;: {
269 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
270 # appropriate identifiers.
271 &quot;a_key&quot;: &quot;A String&quot;,
272 },
273 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
274 # identifiers.
275 &quot;a_key&quot;: &quot;A String&quot;,
276 },
277 },
278 },
279 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
280 # message that was returned, such as `NOT FOUND`.
281 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
282 # status code that was returned. For example, a `404` means the
283 # resource was not found.
284 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
285 # defined by the server.
286 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
287 # This value is inRFC3339
288 # text format.
289 &quot;instancesBulkInsertOperationMetadata&quot;: {
290 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
291 # Example key: zones/us-central1-a
292 &quot;a_key&quot;: {
293 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
294 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
295 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
296 # error.
297 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
298 # if the flow is rolling forward or rolling back.
299 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
300 },
301 },
302 },
303 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
304 # Operation resources.
305 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
306 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
307 # group of operations results from a `bulkInsert` API request.
308 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
309 # `update`, or `delete`, and so on.
310 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
311 # There is no requirement that this be linear or support any granularity of
312 # operations. This should not be used to guess when the operation will be
313 # complete. This number should monotonically increase as the operation
314 # progresses.
315 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
316 # applicable when performing regional operations.
317 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
318 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
319 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
320 # this field will contain information on all underlying zonal actions and
321 # their state.
322 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
323 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
324 # Example key: zones/us-central1-a
325 &quot;a_key&quot;: {
326 &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
327 # populated.
328 # different programming environments, including REST APIs and RPC APIs. It is
329 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
330 # three pieces of data: error code, error message, and error details.
331 #
332 # You can find out more about this error model and how to work with it in the
333 # [API Design Guide](https://cloud.google.com/apis/design/errors).
334 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
335 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
336 # message types for APIs to use.
337 {
338 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
339 },
340 ],
341 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
342 # user-facing error message should be localized and sent in the
343 # google.rpc.Status.details field, or localized by the client.
344 },
345 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
346 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
347 },
348 },
349 },
350 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
351 # This value is inRFC3339
352 # text format.
353 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
354 # following:
355 # `PENDING`, `RUNNING`, or `DONE`.
356 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
357 # operation.
358 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
359 # of the target resource.
360 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
361 # operations related to creating a snapshot, this points to the disk
362 # that the snapshot was created from.
363 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
364 # `[email protected]` or
365 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
366 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
367 # operation, this field will be populated.
368 {
369 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
370 # Engine returns NO_RESULTS_ON_PAGE if there
371 # are no results in the response.
372 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
373 # value format. For example:
374 #
375 # &quot;data&quot;: [
376 # {
377 # &quot;key&quot;: &quot;scope&quot;,
378 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
379 # }
380 {
381 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
382 # returned. For example, for warnings where there are no results in a list
383 # request for a particular zone, this key might be scope and
384 # the key value might be the zone name. Other examples might be a key
385 # indicating a deprecated resource and a suggested replacement, or a
386 # warning about invalid network settings (for example, if an instance
387 # attempts to perform IP forwarding but is not enabled for IP forwarding).
388 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
389 },
390 ],
391 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
392 },
393 ],
394 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
395 # applicable when performing per-zone operations.
396 }</pre>
397 </div>
398
399 <div class="method">
400 <code class="details" id="get">get(project, region, urlMap, x__xgafv=None)</code>
401 <pre>Returns the specified UrlMap resource.
402
403 Args:
404 project: string, Project ID for this request. (required)
405 region: string, Name of the region scoping this request. (required)
406 urlMap: string, Name of the UrlMap resource to return. (required)
407 x__xgafv: string, V1 error format.
408 Allowed values
409 1 - v1 error format
410 2 - v2 error format
411
412 Returns:
413 An object of the form:
414
415 { # Represents a URL Map resource.
416 #
417 # Compute Engine has two URL Map resources:
418 #
419 # * [Global](/compute/docs/reference/rest/alpha/urlMaps)
420 # * [Regional](/compute/docs/reference/rest/alpha/regionUrlMaps)
421 #
422 # A URL map resource is a component of certain types of cloud load balancers
423 # and Traffic Director:
424 #
425 # * urlMaps are used by global external Application Load
426 # Balancers, classic Application Load Balancers, and cross-region internal
427 # Application Load Balancers.
428 # * regionUrlMaps are used by internal Application Load Balancers,
429 # regional external Application Load Balancers and regional internal
430 # Application Load Balancers.
431 #
432 # For a list of supported URL map features by the load balancer type, see the
433 # Load balancing features: Routing and traffic management table.
434 #
435 # For a list of supported URL map features for Traffic Director, see the
436 # Traffic Director features: Routing and traffic management table.
437 #
438 # This resource defines mappings from hostnames and URL paths to either a
439 # backend service or a backend bucket.
440 #
441 # To use the global urlMaps resource, the backend service must
442 # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
443 # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
444 # information, read URL
445 # Map Concepts.
446 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
447 # text format.
448 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
449 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
450 #
451 # This policy takes
452 # effect at the load balancer level and applies only when no policy has been
453 # defined for the error code at lower levels like PathMatcher, RouteRule and
454 # PathRule within this UrlMap.
455 #
456 # For example, consider a UrlMap with the
457 # following configuration:
458 #
459 #
460 # - defaultCustomErrorResponsePolicy containing policies for
461 # responding to 5xx and 4xx errors
462 # - A PathMatcher configured for *.example.com has
463 # defaultCustomErrorResponsePolicy for 4xx.
464 #
465 # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
466 # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
467 # a request that does not match any host in *.example.com such
468 # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
469 # takes effect.
470 #
471 # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
472 # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
473 # a retry, if load balancer is successful in reaching the
474 # service, the defaultCustomErrorResponsePolicy is ignored and
475 # the response from the service is returned to the client.
476 #
477 # defaultCustomErrorResponsePolicy is supported only for
478 # global external Application Load Balancers.
479 # backend service or backend bucket responds with an error.
480 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
481 #
482 # In a given policy, if you specify rules for both a range of error codes
483 # as well as rules for specific error codes then rules with specific error
484 # codes have a higher priority. For example, assume that you configure a rule
485 # for 401 (Un-authorized) code, and another for all 4 series
486 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
487 # However if the backend service returns a 403, the rule for4xx takes effect.
488 { # Specifies the mapping between the response code that will be returned along
489 # with the custom error content and the response code returned by the backend
490 # service.
491 &quot;matchResponseCodes&quot;: [ # Valid values include:
492 #
493 #
494 # - A number between 400 and 599: For example
495 # 401 or 503, in which case the load balancer
496 # applies the policy if the error code exactly matches this value.
497 # - 5xx: Load Balancer will apply the policy if the
498 # backend service responds with any response code in the range of
499 # 500 to 599.
500 # - 4xx: Load
501 # Balancer will apply the policy if the backend service responds with any
502 # response code in the range of 400 to
503 # 499.
504 #
505 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
506 &quot;A String&quot;,
507 ],
508 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
509 # error content. If overrideResponseCode is not supplied, the
510 # same response code returned by the original backend bucket or backend
511 # service is returned to the client.
512 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
513 #
514 # path must start
515 # with a leading slash. path cannot have trailing slashes.
516 #
517 # If the file is not available in backendBucket or the
518 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
519 #
520 # The value must
521 # be from 1 to 1024 characters
522 },
523 ],
524 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
525 # contains the custom error content. Examples are:
526 #
527 #
528 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
529 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
530 # - global/backendBuckets/myBackendBucket
531 #
532 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
533 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
534 #
535 # If load balancer cannot reach
536 # the backendBucket, a simple Not Found Error will
537 # be returned, with the original response code (oroverrideResponseCode if configured).
538 #
539 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
540 },
541 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
542 # hostRules match. The load balancer performs advanced routing
543 # actions, such as URL rewrites and header transformations, before forwarding
544 # the request to the selected backend.
545 #
546 #
547 # Only one of defaultUrlRedirect, defaultService
548 # or defaultRouteAction.weightedBackendService can be set.
549 #
550 #
551 # URL maps for classic Application Load Balancers only support
552 # the urlRewrite action within defaultRouteAction.
553 #
554 #
555 # defaultRouteAction has no effect when the URL map is bound
556 # to a target gRPC proxy that has the validateForProxyless field
557 # set to true.
558 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
559 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
560 # property must be specified. This policy cannot be specified if any target
561 # backend has Identity-Aware Proxy enabled.
562 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
563 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
564 # header names can be specified. The cache is bypassed for all `cacheMode`
565 # values.
566 &quot;A String&quot;,
567 ],
568 &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
569 # on the backend type: for Backend Services, the complete request URI is
570 # used; for Backend Buckets, the request URI is used without the protocol or
571 # host, and only query parameters known to Cloud Storage are included.
572 # Policy defined on Route Action.
573 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
574 # parameters will be included. Either specify `excludedQueryParameters`
575 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
576 # encoded and not treated as delimiters.
577 #
578 # Note: This field applies to routes that use backend services. Attempting
579 # to set it on a route that points exclusively to Backend Buckets will
580 # result in a configuration error. For routes that point to a Backend
581 # Bucket, use `includedQueryParameters` to define which parameters should
582 # be part of the cache key.
583 &quot;A String&quot;,
584 ],
585 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
586 #
587 # Note: This setting is only applicable to routes that use a Backend
588 # Service. It does not affect requests served by a Backend Bucket, as the
589 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
590 # it on a route that points exclusively to Backend Buckets will result in a
591 # configuration error.
592 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
593 #
594 # Note: This setting is only applicable to routes that use a Backend
595 # Service. It does not affect requests served by a Backend Bucket, as the
596 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
597 # set on a route that points exclusively to Backend Buckets will result in
598 # a configuration error.
599 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
600 # `includedQueryParameters` and `excludedQueryParameters`. If neither
601 # is set, the entire query string will be included. If false, the query
602 # string will be excluded from the cache key entirely.
603 #
604 # Note: This field applies to routes that use backend services. Attempting
605 # to set it on a route that points exclusively to Backend Buckets will
606 # result in a configuration error. For routes that point to a Backend
607 # Bucket, use `includedQueryParameters` to define which parameters should
608 # be part of the cache key.
609 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
610 # The name=value pair will be used in the cache key Cloud CDN generates.
611 #
612 # Note: This setting is only applicable to routes that use a Backend
613 # Service. It does not affect requests served by a Backend Bucket.
614 # Attempting to set it on a route that points exclusively to Backend
615 # Buckets will result in a configuration error. Up to 5 cookie names can be
616 # specified.
617 &quot;A String&quot;,
618 ],
619 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
620 &quot;A String&quot;,
621 ],
622 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
623 # parameters will be excluded. Either specify `includedQueryParameters`
624 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
625 # encoded and not treated as delimiters.
626 &quot;A String&quot;,
627 ],
628 },
629 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
630 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
631 &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
632 # content. This is used to clamp the max-age (or Expires) value sent to the
633 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
634 # is used for the response max-age directive, along with a &quot;public&quot;
635 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
636 # clamps the max-age from the origin (if specified), or else sets the
637 # response max-age directive to the lesser of the `clientTtl` and
638 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
639 # present. The maximum allowed value is 31,622,400s (1 year). If not
640 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
641 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
642 # `USE_ORIGIN_HEADERS`.
643 # as a count of seconds and fractions of seconds at nanosecond
644 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
645 # or &quot;month&quot;. Range is approximately 10,000 years.
646 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
647 # Durations less than one second are represented with a 0
648 # `seconds` field and a positive `nanos` field. Must be from 0
649 # to 999,999,999 inclusive.
650 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
651 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
652 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
653 },
654 &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
655 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
656 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
657 # greater than that of `maxTtl`. When the `cacheMode` is set to
658 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
659 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
660 # accessed objects may be evicted from the cache before the defined TTL. If
661 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
662 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
663 # `USE_ORIGIN_HEADERS`.
664 # as a count of seconds and fractions of seconds at nanosecond
665 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
666 # or &quot;month&quot;. Range is approximately 10,000 years.
667 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
668 # Durations less than one second are represented with a 0
669 # `seconds` field and a positive `nanos` field. Must be from 0
670 # to 999,999,999 inclusive.
671 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
672 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
673 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
674 },
675 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
676 # attempt to set a max-age or s-maxage higher than this, or an Expires header
677 # more than `maxTtl` seconds in the future will be capped at the value of
678 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
679 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
680 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
681 # Infrequently accessed objects may be evicted from the cache before the
682 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
683 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
684 # mode.
685 # as a count of seconds and fractions of seconds at nanosecond
686 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
687 # or &quot;month&quot;. Range is approximately 10,000 years.
688 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
689 # Durations less than one second are represented with a 0
690 # `seconds` field and a positive `nanos` field. Must be from 0
691 # to 999,999,999 inclusive.
692 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
693 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
694 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
695 },
696 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
697 # to apply fine-grained caching for common errors or redirects.
698 # This can reduce the load on your origin and improve end-user
699 # experience by reducing response latency.
700 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
701 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
702 # the specified response code that lack any Cache-Control, Expires, or
703 # Pragma: no-cache directives. When the `cacheMode` is set to
704 # `FORCE_CACHE_ALL`, negative caching applies to all responses
705 # with the specified response code, and overrides any caching headers. By
706 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
707 #
708 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
709 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
710 # * 405 (Method Not Found), 501 (Not Implemented): 60s
711 #
712 # These defaults can be overridden in `negativeCachingPolicy`.
713 # If not specified, Cloud CDN applies negative caching by default.
714 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
715 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
716 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
717 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
718 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
719 # all response codes that you wish to cache. Cloud CDN will not apply any
720 # default negative caching when a policy exists.
721 { # Specify CDN TTLs for response error codes.
722 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
723 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
724 # specified as values, and you cannot specify a status code more than
725 # once.
726 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
727 # corresponding status code.
728 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
729 # objects may be evicted from the cache before the defined TTL.
730 # as a count of seconds and fractions of seconds at nanosecond
731 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
732 # or &quot;month&quot;. Range is approximately 10,000 years.
733 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
734 # Durations less than one second are represented with a 0
735 # `seconds` field and a positive `nanos` field. Must be from 0
736 # to 999,999,999 inclusive.
737 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
738 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
739 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
740 },
741 },
742 ],
743 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
744 # requests into a small number of requests to the origin. If not specified,
745 # Cloud CDN applies request coalescing by default.
746 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
747 # content with the origin, or when an error is encountered when refreshing
748 # the cache.
749 # This setting defines the default &quot;max-stale&quot; duration for any cached
750 # responses that do not specify a max-stale directive. Stale responses that
751 # exceed the TTL configured here will not be served. The default limit
752 # (max-stale) is 86400s (1 day), which will allow stale content to be
753 # served up to this limit beyond the max-age (or s-maxage) of a cached
754 # response.
755 # The maximum allowed value is 604800 (1 week).
756 # Set this to zero (0) to disable serve-while-stale.
757 # as a count of seconds and fractions of seconds at nanosecond
758 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
759 # or &quot;month&quot;. Range is approximately 10,000 years.
760 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
761 # Durations less than one second are represented with a 0
762 # `seconds` field and a positive `nanos` field. Must be from 0
763 # to 999,999,999 inclusive.
764 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
765 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
766 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
767 },
768 },
769 &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
770 # information about the W3C recommendation for cross-origin resource sharing
771 # (CORS), see Fetch API Living
772 # Standard.
773 #
774 # Not supported when the URL map is bound to a target gRPC proxy.
775 # information about the W3C recommendation for cross-origin resource sharing
776 # (CORS), see Fetch API Living
777 # Standard.
778 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
779 # indicates that
780 # the actual request can include user credentials. This field translates to
781 # the Access-Control-Allow-Credentials header.
782 #
783 # Default is false.
784 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
785 # header.
786 &quot;A String&quot;,
787 ],
788 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
789 # header.
790 &quot;A String&quot;,
791 ],
792 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
793 # more information, see regular expression syntax.
794 #
795 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
796 #
797 # Regular expressions can only be used when the loadBalancingScheme is
798 # set to INTERNAL_SELF_MANAGED.
799 &quot;A String&quot;,
800 ],
801 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
802 #
803 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
804 &quot;A String&quot;,
805 ],
806 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
807 # The default value is false, which indicates that the CORS
808 # policy is in effect.
809 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
810 # header.
811 &quot;A String&quot;,
812 ],
813 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
814 # seconds. This field translates to the Access-Control-Max-Age
815 # header.
816 },
817 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
818 # the resiliency of clients to backend service failure. As part of fault
819 # injection, when clients send requests to a backend service, delays can be
820 # introduced by a load balancer on a percentage of requests before sending
821 # those requests to the backend service. Similarly requests from clients can
822 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
823 # that are configured with a fault_injection_policy if:
824 # 1. The traffic is generated by fault injection AND
825 # 2. The fault injection is not a delay fault injection.
826 # Fault injection is not supported with the classic Application Load Balancer
827 # . To see which load balancers support fault injection,
828 # see Load
829 # balancing: Routing and traffic management features.
830 # the resiliency of clients to backend service failure. As part of fault
831 # injection, when clients send requests to a backend service, delays can be
832 # introduced by the load balancer on a percentage of requests before sending
833 # those request to the backend service. Similarly requests from clients can be
834 # aborted by the load balancer for a percentage of requests.
835 &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
836 # injection.
837 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
838 #
839 # The value must be from 200 to 599 inclusive.
840 #
841 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
842 # according to this
843 # mapping table. HTTP status 200 is mapped to gRPC status
844 # UNKNOWN. Injecting an OK status is currently not supported by
845 # Traffic Director.
846 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
847 # that is aborted as part of fault injection.
848 #
849 # The value must be from 0.0 to 100.0 inclusive.
850 },
851 &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
852 # injection, before being sent to a backend service.
853 # request to the backend service as part of fault injection.
854 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
855 # as a count of seconds and fractions of seconds at nanosecond
856 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
857 # or &quot;month&quot;. Range is approximately 10,000 years.
858 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
859 # Durations less than one second are represented with a 0
860 # `seconds` field and a positive `nanos` field. Must be from 0
861 # to 999,999,999 inclusive.
862 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
863 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
864 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
865 },
866 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
867 # which a delay is introduced as part of fault injection.
868 #
869 # The value must be from 0.0 to 100.0 inclusive.
870 },
871 },
872 &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
873 # Global EXTERNAL_MANAGED load balancer schemes.
874 # Either Cloud CDN must be enabled on the backend service or backend bucket
875 # serving the route, or cache policy must be configured on the same route
876 # dynamically processes and delivers images from the network edge.
877 # Image Optimization is only available for Global External Application Load
878 # Balancers.
879 # Either Cloud CDN must be enabled on the backend service or backend bucket
880 # serving the route, or cache policy must be configured on the same route.
881 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
882 },
883 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
884 # Unlike the timeout field where the timeout duration starts
885 # from the time the request has been fully processed (known as*end-of-stream*),
886 # the duration in this field is computed from the beginning of the stream
887 # until the response has been processed, including all retries. A
888 # stream that does not complete in this duration is closed.
889 #
890 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
891 # with the route.
892 #
893 # This field is only allowed if the Url map is used with backend services
894 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
895 # as a count of seconds and fractions of seconds at nanosecond
896 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
897 # or &quot;month&quot;. Range is approximately 10,000 years.
898 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
899 # Durations less than one second are represented with a 0
900 # `seconds` field and a positive `nanos` field. Must be from 0
901 # to 999,999,999 inclusive.
902 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
903 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
904 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
905 },
906 &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
907 # are shadowed to a separate mirrored backend service. The load balancer does
908 # not wait for responses from the shadow service. Before sending traffic
909 # to the shadow service, the host / authority header is suffixed with-shadow.
910 #
911 # Not supported when the URL map is bound to a target gRPC proxy that
912 # has the validateForProxyless field set to true.
913 # are shadowed to a separate mirrored backend service. The load balancer
914 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
915 # to the shadow service, the host or authority header is suffixed with-shadow.
916 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
917 # mirrored to.
918 #
919 # The backend service configured for a mirroring
920 # policy must reference backends that are of the same type as the original
921 # backend service matched in the URL map.
922 #
923 # Serverless NEG backends are not currently supported as a mirrored
924 # backend service.
925 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
926 },
927 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
928 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
929 # If not specified, defaults to 1.
930 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
931 #
932 # If not specified, will use the timeout set in theHttpRouteAction field.
933 # If timeout in the HttpRouteAction field is not set, this field
934 # uses the largest timeout
935 # among all backend services associated with the route.
936 #
937 # Not supported when the URL map is bound to a target gRPC proxy that
938 # has the validateForProxyless field set to true.
939 # as a count of seconds and fractions of seconds at nanosecond
940 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
941 # or &quot;month&quot;. Range is approximately 10,000 years.
942 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
943 # Durations less than one second are represented with a 0
944 # `seconds` field and a positive `nanos` field. Must be from 0
945 # to 999,999,999 inclusive.
946 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
947 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
948 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
949 },
950 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
951 # values are:
952 #
953 # - 5xx: retry is attempted if the instance or endpoint
954 # responds with any 5xx response code, or if the instance or
955 # endpoint does not respond at all. For example, disconnects, reset, read
956 # timeout, connection failure, and refused streams.
957 # - gateway-error: Similar to 5xx, but only
958 # applies to response codes 502, 503 or504.
959 # - connect-failure: a retry is attempted on failures
960 # connecting to the instance or endpoint. For example, connection
961 # timeouts.
962 # - retriable-4xx: a retry is attempted if the instance
963 # or endpoint responds with a 4xx response code.
964 # The only error that you can retry is error code 409.
965 # - refused-stream: a retry is attempted if the instance
966 # or endpoint resets the stream with a REFUSED_STREAM error
967 # code. This reset type indicates that it is safe to retry.
968 # - cancelled: a retry is attempted if the gRPC status
969 # code in the response header is set to cancelled.
970 # - deadline-exceeded: a retry is attempted if the gRPC
971 # status code in the response header is set todeadline-exceeded.
972 # - internal: a retry is attempted if the gRPC
973 # status code in the response header is set tointernal.
974 # - resource-exhausted: a retry is attempted if the gRPC
975 # status code in the response header is set toresource-exhausted.
976 # - unavailable: a retry is attempted if the gRPC
977 # status code in the response header is set tounavailable.
978 #
979 # Only the following codes are supported when the URL map is bound to
980 # target gRPC proxy that has validateForProxyless field set to true.
981 #
982 # - cancelled
983 # - deadline-exceeded
984 # - internal
985 # - resource-exhausted
986 # - unavailable
987 &quot;A String&quot;,
988 ],
989 },
990 &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
991 # time the request has been fully processed (known as *end-of-stream*)
992 # up until the response has been processed. Timeout includes
993 # all retries.
994 #
995 # If not specified, this field uses the largest timeout among all backend
996 # services associated with the route.
997 #
998 # Not supported when the URL map is bound to a target gRPC proxy that
999 # has validateForProxyless field set to true.
1000 # as a count of seconds and fractions of seconds at nanosecond
1001 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1002 # or &quot;month&quot;. Range is approximately 10,000 years.
1003 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1004 # Durations less than one second are represented with a 0
1005 # `seconds` field and a positive `nanos` field. Must be from 0
1006 # to 999,999,999 inclusive.
1007 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1008 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1009 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1010 },
1011 &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
1012 # to the matched service.
1013 #
1014 # urlRewrite is the only action supported in UrlMaps
1015 # for classic Application Load Balancers.
1016 #
1017 # Not supported when the URL map is bound to a target gRPC proxy that
1018 # has the validateForProxyless field set to true.
1019 # backend service.
1020 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
1021 # host header is replaced with contents of hostRewrite.
1022 #
1023 # The value must be from 1 to 255 characters.
1024 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
1025 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
1026 #
1027 # The value must be from 1 to 1024 characters.
1028 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
1029 # header) using the HTTP template syntax.
1030 #
1031 # A corresponding
1032 # path_template_match must be specified. Any template variables must exist in
1033 # the path_template_match field.
1034 #
1035 #
1036 # - -At least one variable must be specified in the path_template_match
1037 # field
1038 # - You can omit variables from the rewritten URL
1039 # - The * and ** operators cannot be matched
1040 # unless they have a corresponding variable name - e.g.
1041 # {format=*} or {var=**}.
1042 #
1043 # For example, a path_template_match of /static/{format=**}
1044 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
1045 # rewrite, so that /{country}/{format}/{suffix=**} can be
1046 # rewritten as /content/{format}/{country}/{suffix}.
1047 #
1048 # At least
1049 # one non-empty routeRules[].matchRules[].path_template_match is
1050 # required.
1051 #
1052 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
1053 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
1054 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
1055 # It uses RE2 syntax with the following constraints:
1056 #
1057 #
1058 # - Any single character operators
1059 # - Groups are allowed to have only submatch operator inside
1060 # - Groups are allowed only without any char repetition, e.g.
1061 # .*
1062 # - Any char repetition, e.g. .*, is
1063 # only allowed to be used in a single regex together with:
1064 #
1065 #
1066 # - Empty string operators
1067 # - Other repetitions
1068 # - Ranges
1069 # - Repetitions of ranges
1070 #
1071 #
1072 # - Ranges are only allowed to have:
1073 #
1074 #
1075 # - Character range
1076 # - Digits range
1077 # - Symbols listed in characters allowed for ranges
1078 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
1079 # the path.
1080 },
1081 },
1082 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
1083 # occurs. The weights determine the fraction of traffic that flows to
1084 # their corresponding backend service. If all traffic needs to
1085 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
1086 #
1087 # After a backend service is identified and before forwarding
1088 # the request to
1089 # the backend service, advanced routing actions such as URL rewrites and
1090 # header transformations are applied depending on additional settings
1091 # specified in this HttpRouteAction.
1092 { # In contrast to a single BackendService in
1093 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
1094 # multiple backend services. The volume of traffic for each
1095 # backend service is proportional to the weight specified
1096 # in each WeightedBackendService
1097 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
1098 # resource. Before
1099 # forwarding the request to backendService, the load balancer
1100 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
1101 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
1102 # effect for the selected backendService.
1103 #
1104 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
1105 #
1106 # headerAction is not supported for load balancers that have
1107 # their loadBalancingScheme set to EXTERNAL.
1108 #
1109 # Not supported when the URL map is bound to a target gRPC proxy that
1110 # has validateForProxyless field set to true.
1111 # the request is passed along to the selected backendService.
1112 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
1113 { # Specification determining how headers are added to requests or responses.
1114 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
1115 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
1116 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
1117 # that already
1118 # exist for the header. If true, headerValue is set for the
1119 # header, discarding any values that were set for that header.
1120 #
1121 # The default value is true,
1122 # unless a variable is present in headerValue,
1123 # in which case the default value is false.
1124 # .
1125 },
1126 ],
1127 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
1128 # request before forwarding the request to the backendService.
1129 &quot;A String&quot;,
1130 ],
1131 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
1132 # client.
1133 { # Specification determining how headers are added to requests or responses.
1134 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
1135 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
1136 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
1137 # that already
1138 # exist for the header. If true, headerValue is set for the
1139 # header, discarding any values that were set for that header.
1140 #
1141 # The default value is true,
1142 # unless a variable is present in headerValue,
1143 # in which case the default value is false.
1144 # .
1145 },
1146 ],
1147 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
1148 # response before sending the response back to the client.
1149 &quot;A String&quot;,
1150 ],
1151 },
1152 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
1153 # computed asweight / (sum of all weightedBackendService weights in routeAction).
1154 #
1155 # The selection of a backend service is determined only for new traffic.
1156 # Once a user&#x27;s request has been directed to a backend service,
1157 # subsequent requests are sent to the same backend service as
1158 # determined by the backend service&#x27;s session affinity policy.
1159 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
1160 # splitting. If you do, the weighted traffic splitting configuration takes
1161 # precedence.
1162 #
1163 # The value must be from 0 to 1000.
1164 },
1165 ],
1166 },
1167 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL of the defaultService resource to
1168 # which traffic is directed if none of the hostRules match.
1169 # If defaultRouteAction is also specified, advanced
1170 # routing actions, such as URL rewrites, take effect before sending the
1171 # request to the backend.
1172 #
1173 #
1174 # Only one of defaultUrlRedirect, defaultService
1175 # or defaultRouteAction.weightedBackendService can be set.
1176 #
1177 #
1178 # defaultService has no effect when the URL map is bound
1179 # to a target gRPC proxy that has the validateForProxyless field
1180 # set to true.
1181 &quot;defaultUrlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
1182 # is redirected to a URL specified by defaultUrlRedirect.
1183 #
1184 #
1185 # Only one of defaultUrlRedirect, defaultService
1186 # or defaultRouteAction.weightedBackendService can be set.
1187 #
1188 #
1189 # Not supported when the URL map is bound to a target gRPC proxy.
1190 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
1191 # was supplied in the request.
1192 #
1193 # The value must be from 1 to 255
1194 # characters.
1195 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
1196 # set to HTTPS.
1197 # If set to false, the URL scheme of the redirected request
1198 # remains the same as that of the request.
1199 #
1200 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
1201 #
1202 # The default is set to false.
1203 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
1204 # that was supplied in the request.
1205 #
1206 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
1207 # supplied, the path of the original request is used for the redirect.
1208 #
1209 # The value must be from 1 to 1024 characters.
1210 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
1211 # the HttpRouteRuleMatch, retaining the remaining portion
1212 # of the URL before redirecting the request.
1213 #
1214 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
1215 # supplied, the path of the original request is used for the redirect.
1216 #
1217 # The value must be from 1 to 1024 characters.
1218 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
1219 #
1220 # Supported values are:
1221 #
1222 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
1223 # to 301.
1224 # - FOUND, which corresponds to 302.
1225 # - SEE_OTHER which corresponds to 303.
1226 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
1227 # method is retained.
1228 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
1229 # method is retained.
1230 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
1231 # URL is
1232 # removed before redirecting the request. If set to false, the
1233 # query portion of the original URL is retained.
1234 #
1235 # The default is set to false.
1236 },
1237 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
1238 # create the resource.
1239 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. A hash of the contents stored in this object.
1240 # This field is used in optimistic locking. This field is ignored when
1241 # inserting a UrlMap. An up-to-date fingerprint must be provided
1242 # in order to update the UrlMap, otherwise the request will
1243 # fail with error 412 conditionNotMet.
1244 #
1245 # To see the latest fingerprint, make a get() request to
1246 # retrieve a UrlMap.
1247 &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
1248 # for the selected backendService.
1249 #
1250 # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
1251 #
1252 # headerAction is not supported for load balancers
1253 # that have
1254 # their loadBalancingScheme set to EXTERNAL.
1255 #
1256 # Not supported when the URL map is bound to a target gRPC proxy that
1257 # has validateForProxyless field set to true.
1258 # the request is passed along to the selected backendService.
1259 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
1260 { # Specification determining how headers are added to requests or responses.
1261 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
1262 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
1263 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
1264 # that already
1265 # exist for the header. If true, headerValue is set for the
1266 # header, discarding any values that were set for that header.
1267 #
1268 # The default value is true,
1269 # unless a variable is present in headerValue,
1270 # in which case the default value is false.
1271 # .
1272 },
1273 ],
1274 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
1275 # request before forwarding the request to the backendService.
1276 &quot;A String&quot;,
1277 ],
1278 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
1279 # client.
1280 { # Specification determining how headers are added to requests or responses.
1281 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
1282 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
1283 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
1284 # that already
1285 # exist for the header. If true, headerValue is set for the
1286 # header, discarding any values that were set for that header.
1287 #
1288 # The default value is true,
1289 # unless a variable is present in headerValue,
1290 # in which case the default value is false.
1291 # .
1292 },
1293 ],
1294 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
1295 # response before sending the response back to the client.
1296 &quot;A String&quot;,
1297 ],
1298 },
1299 &quot;hostRules&quot;: [ # The list of host rules to use against the URL.
1300 { # UrlMaps
1301 # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
1302 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
1303 # create the resource.
1304 &quot;hosts&quot;: [ # The list of host patterns to match. They must be valid hostnames with
1305 # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
1306 # that case, * must be the first character, and if followed by
1307 # anything, the immediate following character must be either -
1308 # or ..
1309 #
1310 # * based matching is not supported when the URL map is bound
1311 # to a target gRPC proxy that has the validateForProxyless field
1312 # set to true.
1313 &quot;A String&quot;,
1314 ],
1315 &quot;pathMatcher&quot;: &quot;A String&quot;, # The name of the PathMatcher to use to match the path portion
1316 # of the URL if the hostRule matches the URL&#x27;s host portion.
1317 },
1318 ],
1319 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the resource. This identifier is
1320 # defined by the server.
1321 &quot;kind&quot;: &quot;compute#urlMap&quot;, # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
1322 # url maps.
1323 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
1324 # The name must be 1-63 characters long, and comply withRFC1035.
1325 # Specifically, the name must be 1-63 characters long and match the regular
1326 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
1327 # character must be a lowercase letter, and all following characters must
1328 # be a dash, lowercase letter, or digit, except the last character, which
1329 # cannot be a dash.
1330 &quot;pathMatchers&quot;: [ # The list of named PathMatchers to use against the URL.
1331 { # A matcher for the path portion of the URL. The BackendService
1332 # from the longest-matched rule will serve the URL. If no rule was matched, the
1333 # default service is used.
1334 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
1335 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
1336 #
1337 # This policy takes
1338 # effect at the PathMatcher level and applies only when no
1339 # 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
1340 # in defaultCustomErrorResponsePolicy, then a policy defined for
1341 # the error code in UrlMap.defaultCustomErrorResponsePolicy
1342 # takes effect.
1343 #
1344 # For example, consider a UrlMap with the following
1345 # configuration:
1346 #
1347 #
1348 # - UrlMap.defaultCustomErrorResponsePolicy is configured
1349 # with policies for 5xx and 4xx errors
1350 # - A RouteRule for /coming_soon/ is configured for the
1351 # error code 404.
1352 #
1353 # 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
1354 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
1355 # the policy in RouteRule.customErrorResponsePolicy takes
1356 # effect. If any of the requests in this example encounter a 500
1357 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
1358 #
1359 # When
1360 # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
1361 # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
1362 # a retry, if load balancer is successful in reaching the
1363 # service, the defaultCustomErrorResponsePolicy is ignored and
1364 # the response from the service is returned to the client.
1365 #
1366 # defaultCustomErrorResponsePolicy is supported only for
1367 # global external Application Load Balancers.
1368 # backend service or backend bucket responds with an error.
1369 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
1370 #
1371 # In a given policy, if you specify rules for both a range of error codes
1372 # as well as rules for specific error codes then rules with specific error
1373 # codes have a higher priority. For example, assume that you configure a rule
1374 # for 401 (Un-authorized) code, and another for all 4 series
1375 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
1376 # However if the backend service returns a 403, the rule for4xx takes effect.
1377 { # Specifies the mapping between the response code that will be returned along
1378 # with the custom error content and the response code returned by the backend
1379 # service.
1380 &quot;matchResponseCodes&quot;: [ # Valid values include:
1381 #
1382 #
1383 # - A number between 400 and 599: For example
1384 # 401 or 503, in which case the load balancer
1385 # applies the policy if the error code exactly matches this value.
1386 # - 5xx: Load Balancer will apply the policy if the
1387 # backend service responds with any response code in the range of
1388 # 500 to 599.
1389 # - 4xx: Load
1390 # Balancer will apply the policy if the backend service responds with any
1391 # response code in the range of 400 to
1392 # 499.
1393 #
1394 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
1395 &quot;A String&quot;,
1396 ],
1397 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
1398 # error content. If overrideResponseCode is not supplied, the
1399 # same response code returned by the original backend bucket or backend
1400 # service is returned to the client.
1401 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
1402 #
1403 # path must start
1404 # with a leading slash. path cannot have trailing slashes.
1405 #
1406 # If the file is not available in backendBucket or the
1407 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
1408 #
1409 # The value must
1410 # be from 1 to 1024 characters
1411 },
1412 ],
1413 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
1414 # contains the custom error content. Examples are:
1415 #
1416 #
1417 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
1418 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
1419 # - global/backendBuckets/myBackendBucket
1420 #
1421 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
1422 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
1423 #
1424 # If load balancer cannot reach
1425 # the backendBucket, a simple Not Found Error will
1426 # be returned, with the original response code (oroverrideResponseCode if configured).
1427 #
1428 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
1429 },
1430 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
1431 # pathRules or routeRules match. The load balancer
1432 # performs advanced routing actions, such as URL rewrites and
1433 # header transformations, before forwarding the request to the
1434 # selected backend.
1435 #
1436 #
1437 # Only one of defaultUrlRedirect, defaultService
1438 # or defaultRouteAction.weightedBackendService can be set.
1439 #
1440 #
1441 # URL maps for classic Application Load Balancers only support
1442 # the urlRewrite action within a path matcher&#x27;sdefaultRouteAction.
1443 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
1444 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
1445 # property must be specified. This policy cannot be specified if any target
1446 # backend has Identity-Aware Proxy enabled.
1447 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
1448 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
1449 # header names can be specified. The cache is bypassed for all `cacheMode`
1450 # values.
1451 &quot;A String&quot;,
1452 ],
1453 &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
1454 # on the backend type: for Backend Services, the complete request URI is
1455 # used; for Backend Buckets, the request URI is used without the protocol or
1456 # host, and only query parameters known to Cloud Storage are included.
1457 # Policy defined on Route Action.
1458 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
1459 # parameters will be included. Either specify `excludedQueryParameters`
1460 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
1461 # encoded and not treated as delimiters.
1462 #
1463 # Note: This field applies to routes that use backend services. Attempting
1464 # to set it on a route that points exclusively to Backend Buckets will
1465 # result in a configuration error. For routes that point to a Backend
1466 # Bucket, use `includedQueryParameters` to define which parameters should
1467 # be part of the cache key.
1468 &quot;A String&quot;,
1469 ],
1470 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
1471 #
1472 # Note: This setting is only applicable to routes that use a Backend
1473 # Service. It does not affect requests served by a Backend Bucket, as the
1474 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
1475 # it on a route that points exclusively to Backend Buckets will result in a
1476 # configuration error.
1477 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
1478 #
1479 # Note: This setting is only applicable to routes that use a Backend
1480 # Service. It does not affect requests served by a Backend Bucket, as the
1481 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
1482 # set on a route that points exclusively to Backend Buckets will result in
1483 # a configuration error.
1484 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
1485 # `includedQueryParameters` and `excludedQueryParameters`. If neither
1486 # is set, the entire query string will be included. If false, the query
1487 # string will be excluded from the cache key entirely.
1488 #
1489 # Note: This field applies to routes that use backend services. Attempting
1490 # to set it on a route that points exclusively to Backend Buckets will
1491 # result in a configuration error. For routes that point to a Backend
1492 # Bucket, use `includedQueryParameters` to define which parameters should
1493 # be part of the cache key.
1494 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
1495 # The name=value pair will be used in the cache key Cloud CDN generates.
1496 #
1497 # Note: This setting is only applicable to routes that use a Backend
1498 # Service. It does not affect requests served by a Backend Bucket.
1499 # Attempting to set it on a route that points exclusively to Backend
1500 # Buckets will result in a configuration error. Up to 5 cookie names can be
1501 # specified.
1502 &quot;A String&quot;,
1503 ],
1504 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
1505 &quot;A String&quot;,
1506 ],
1507 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
1508 # parameters will be excluded. Either specify `includedQueryParameters`
1509 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
1510 # encoded and not treated as delimiters.
1511 &quot;A String&quot;,
1512 ],
1513 },
1514 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
1515 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
1516 &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
1517 # content. This is used to clamp the max-age (or Expires) value sent to the
1518 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
1519 # is used for the response max-age directive, along with a &quot;public&quot;
1520 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
1521 # clamps the max-age from the origin (if specified), or else sets the
1522 # response max-age directive to the lesser of the `clientTtl` and
1523 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
1524 # present. The maximum allowed value is 31,622,400s (1 year). If not
1525 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
1526 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
1527 # `USE_ORIGIN_HEADERS`.
1528 # as a count of seconds and fractions of seconds at nanosecond
1529 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1530 # or &quot;month&quot;. Range is approximately 10,000 years.
1531 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1532 # Durations less than one second are represented with a 0
1533 # `seconds` field and a positive `nanos` field. Must be from 0
1534 # to 999,999,999 inclusive.
1535 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1536 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1537 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1538 },
1539 &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
1540 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
1541 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
1542 # greater than that of `maxTtl`. When the `cacheMode` is set to
1543 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
1544 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
1545 # accessed objects may be evicted from the cache before the defined TTL. If
1546 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
1547 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
1548 # `USE_ORIGIN_HEADERS`.
1549 # as a count of seconds and fractions of seconds at nanosecond
1550 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1551 # or &quot;month&quot;. Range is approximately 10,000 years.
1552 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1553 # Durations less than one second are represented with a 0
1554 # `seconds` field and a positive `nanos` field. Must be from 0
1555 # to 999,999,999 inclusive.
1556 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1557 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1558 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1559 },
1560 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
1561 # attempt to set a max-age or s-maxage higher than this, or an Expires header
1562 # more than `maxTtl` seconds in the future will be capped at the value of
1563 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
1564 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
1565 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
1566 # Infrequently accessed objects may be evicted from the cache before the
1567 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
1568 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
1569 # mode.
1570 # as a count of seconds and fractions of seconds at nanosecond
1571 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1572 # or &quot;month&quot;. Range is approximately 10,000 years.
1573 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1574 # Durations less than one second are represented with a 0
1575 # `seconds` field and a positive `nanos` field. Must be from 0
1576 # to 999,999,999 inclusive.
1577 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1578 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1579 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1580 },
1581 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
1582 # to apply fine-grained caching for common errors or redirects.
1583 # This can reduce the load on your origin and improve end-user
1584 # experience by reducing response latency.
1585 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
1586 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
1587 # the specified response code that lack any Cache-Control, Expires, or
1588 # Pragma: no-cache directives. When the `cacheMode` is set to
1589 # `FORCE_CACHE_ALL`, negative caching applies to all responses
1590 # with the specified response code, and overrides any caching headers. By
1591 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
1592 #
1593 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
1594 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
1595 # * 405 (Method Not Found), 501 (Not Implemented): 60s
1596 #
1597 # These defaults can be overridden in `negativeCachingPolicy`.
1598 # If not specified, Cloud CDN applies negative caching by default.
1599 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
1600 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
1601 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
1602 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
1603 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
1604 # all response codes that you wish to cache. Cloud CDN will not apply any
1605 # default negative caching when a policy exists.
1606 { # Specify CDN TTLs for response error codes.
1607 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
1608 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
1609 # specified as values, and you cannot specify a status code more than
1610 # once.
1611 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
1612 # corresponding status code.
1613 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
1614 # objects may be evicted from the cache before the defined TTL.
1615 # as a count of seconds and fractions of seconds at nanosecond
1616 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1617 # or &quot;month&quot;. Range is approximately 10,000 years.
1618 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1619 # Durations less than one second are represented with a 0
1620 # `seconds` field and a positive `nanos` field. Must be from 0
1621 # to 999,999,999 inclusive.
1622 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1623 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1624 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1625 },
1626 },
1627 ],
1628 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
1629 # requests into a small number of requests to the origin. If not specified,
1630 # Cloud CDN applies request coalescing by default.
1631 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
1632 # content with the origin, or when an error is encountered when refreshing
1633 # the cache.
1634 # This setting defines the default &quot;max-stale&quot; duration for any cached
1635 # responses that do not specify a max-stale directive. Stale responses that
1636 # exceed the TTL configured here will not be served. The default limit
1637 # (max-stale) is 86400s (1 day), which will allow stale content to be
1638 # served up to this limit beyond the max-age (or s-maxage) of a cached
1639 # response.
1640 # The maximum allowed value is 604800 (1 week).
1641 # Set this to zero (0) to disable serve-while-stale.
1642 # as a count of seconds and fractions of seconds at nanosecond
1643 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1644 # or &quot;month&quot;. Range is approximately 10,000 years.
1645 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1646 # Durations less than one second are represented with a 0
1647 # `seconds` field and a positive `nanos` field. Must be from 0
1648 # to 999,999,999 inclusive.
1649 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1650 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1651 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1652 },
1653 },
1654 &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
1655 # information about the W3C recommendation for cross-origin resource sharing
1656 # (CORS), see Fetch API Living
1657 # Standard.
1658 #
1659 # Not supported when the URL map is bound to a target gRPC proxy.
1660 # information about the W3C recommendation for cross-origin resource sharing
1661 # (CORS), see Fetch API Living
1662 # Standard.
1663 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
1664 # indicates that
1665 # the actual request can include user credentials. This field translates to
1666 # the Access-Control-Allow-Credentials header.
1667 #
1668 # Default is false.
1669 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
1670 # header.
1671 &quot;A String&quot;,
1672 ],
1673 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
1674 # header.
1675 &quot;A String&quot;,
1676 ],
1677 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
1678 # more information, see regular expression syntax.
1679 #
1680 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
1681 #
1682 # Regular expressions can only be used when the loadBalancingScheme is
1683 # set to INTERNAL_SELF_MANAGED.
1684 &quot;A String&quot;,
1685 ],
1686 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
1687 #
1688 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
1689 &quot;A String&quot;,
1690 ],
1691 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
1692 # The default value is false, which indicates that the CORS
1693 # policy is in effect.
1694 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
1695 # header.
1696 &quot;A String&quot;,
1697 ],
1698 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
1699 # seconds. This field translates to the Access-Control-Max-Age
1700 # header.
1701 },
1702 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
1703 # the resiliency of clients to backend service failure. As part of fault
1704 # injection, when clients send requests to a backend service, delays can be
1705 # introduced by a load balancer on a percentage of requests before sending
1706 # those requests to the backend service. Similarly requests from clients can
1707 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
1708 # that are configured with a fault_injection_policy if:
1709 # 1. The traffic is generated by fault injection AND
1710 # 2. The fault injection is not a delay fault injection.
1711 # Fault injection is not supported with the classic Application Load Balancer
1712 # . To see which load balancers support fault injection,
1713 # see Load
1714 # balancing: Routing and traffic management features.
1715 # the resiliency of clients to backend service failure. As part of fault
1716 # injection, when clients send requests to a backend service, delays can be
1717 # introduced by the load balancer on a percentage of requests before sending
1718 # those request to the backend service. Similarly requests from clients can be
1719 # aborted by the load balancer for a percentage of requests.
1720 &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
1721 # injection.
1722 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
1723 #
1724 # The value must be from 200 to 599 inclusive.
1725 #
1726 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
1727 # according to this
1728 # mapping table. HTTP status 200 is mapped to gRPC status
1729 # UNKNOWN. Injecting an OK status is currently not supported by
1730 # Traffic Director.
1731 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
1732 # that is aborted as part of fault injection.
1733 #
1734 # The value must be from 0.0 to 100.0 inclusive.
1735 },
1736 &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
1737 # injection, before being sent to a backend service.
1738 # request to the backend service as part of fault injection.
1739 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
1740 # as a count of seconds and fractions of seconds at nanosecond
1741 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1742 # or &quot;month&quot;. Range is approximately 10,000 years.
1743 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1744 # Durations less than one second are represented with a 0
1745 # `seconds` field and a positive `nanos` field. Must be from 0
1746 # to 999,999,999 inclusive.
1747 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1748 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1749 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1750 },
1751 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
1752 # which a delay is introduced as part of fault injection.
1753 #
1754 # The value must be from 0.0 to 100.0 inclusive.
1755 },
1756 },
1757 &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
1758 # Global EXTERNAL_MANAGED load balancer schemes.
1759 # Either Cloud CDN must be enabled on the backend service or backend bucket
1760 # serving the route, or cache policy must be configured on the same route
1761 # dynamically processes and delivers images from the network edge.
1762 # Image Optimization is only available for Global External Application Load
1763 # Balancers.
1764 # Either Cloud CDN must be enabled on the backend service or backend bucket
1765 # serving the route, or cache policy must be configured on the same route.
1766 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
1767 },
1768 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
1769 # Unlike the timeout field where the timeout duration starts
1770 # from the time the request has been fully processed (known as*end-of-stream*),
1771 # the duration in this field is computed from the beginning of the stream
1772 # until the response has been processed, including all retries. A
1773 # stream that does not complete in this duration is closed.
1774 #
1775 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
1776 # with the route.
1777 #
1778 # This field is only allowed if the Url map is used with backend services
1779 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
1780 # as a count of seconds and fractions of seconds at nanosecond
1781 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1782 # or &quot;month&quot;. Range is approximately 10,000 years.
1783 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1784 # Durations less than one second are represented with a 0
1785 # `seconds` field and a positive `nanos` field. Must be from 0
1786 # to 999,999,999 inclusive.
1787 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1788 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1789 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1790 },
1791 &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
1792 # are shadowed to a separate mirrored backend service. The load balancer does
1793 # not wait for responses from the shadow service. Before sending traffic
1794 # to the shadow service, the host / authority header is suffixed with-shadow.
1795 #
1796 # Not supported when the URL map is bound to a target gRPC proxy that
1797 # has the validateForProxyless field set to true.
1798 # are shadowed to a separate mirrored backend service. The load balancer
1799 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
1800 # to the shadow service, the host or authority header is suffixed with-shadow.
1801 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
1802 # mirrored to.
1803 #
1804 # The backend service configured for a mirroring
1805 # policy must reference backends that are of the same type as the original
1806 # backend service matched in the URL map.
1807 #
1808 # Serverless NEG backends are not currently supported as a mirrored
1809 # backend service.
1810 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
1811 },
1812 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
1813 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
1814 # If not specified, defaults to 1.
1815 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
1816 #
1817 # If not specified, will use the timeout set in theHttpRouteAction field.
1818 # If timeout in the HttpRouteAction field is not set, this field
1819 # uses the largest timeout
1820 # among all backend services associated with the route.
1821 #
1822 # Not supported when the URL map is bound to a target gRPC proxy that
1823 # has the validateForProxyless field set to true.
1824 # as a count of seconds and fractions of seconds at nanosecond
1825 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1826 # or &quot;month&quot;. Range is approximately 10,000 years.
1827 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1828 # Durations less than one second are represented with a 0
1829 # `seconds` field and a positive `nanos` field. Must be from 0
1830 # to 999,999,999 inclusive.
1831 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1832 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1833 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1834 },
1835 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
1836 # values are:
1837 #
1838 # - 5xx: retry is attempted if the instance or endpoint
1839 # responds with any 5xx response code, or if the instance or
1840 # endpoint does not respond at all. For example, disconnects, reset, read
1841 # timeout, connection failure, and refused streams.
1842 # - gateway-error: Similar to 5xx, but only
1843 # applies to response codes 502, 503 or504.
1844 # - connect-failure: a retry is attempted on failures
1845 # connecting to the instance or endpoint. For example, connection
1846 # timeouts.
1847 # - retriable-4xx: a retry is attempted if the instance
1848 # or endpoint responds with a 4xx response code.
1849 # The only error that you can retry is error code 409.
1850 # - refused-stream: a retry is attempted if the instance
1851 # or endpoint resets the stream with a REFUSED_STREAM error
1852 # code. This reset type indicates that it is safe to retry.
1853 # - cancelled: a retry is attempted if the gRPC status
1854 # code in the response header is set to cancelled.
1855 # - deadline-exceeded: a retry is attempted if the gRPC
1856 # status code in the response header is set todeadline-exceeded.
1857 # - internal: a retry is attempted if the gRPC
1858 # status code in the response header is set tointernal.
1859 # - resource-exhausted: a retry is attempted if the gRPC
1860 # status code in the response header is set toresource-exhausted.
1861 # - unavailable: a retry is attempted if the gRPC
1862 # status code in the response header is set tounavailable.
1863 #
1864 # Only the following codes are supported when the URL map is bound to
1865 # target gRPC proxy that has validateForProxyless field set to true.
1866 #
1867 # - cancelled
1868 # - deadline-exceeded
1869 # - internal
1870 # - resource-exhausted
1871 # - unavailable
1872 &quot;A String&quot;,
1873 ],
1874 },
1875 &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
1876 # time the request has been fully processed (known as *end-of-stream*)
1877 # up until the response has been processed. Timeout includes
1878 # all retries.
1879 #
1880 # If not specified, this field uses the largest timeout among all backend
1881 # services associated with the route.
1882 #
1883 # Not supported when the URL map is bound to a target gRPC proxy that
1884 # has validateForProxyless field set to true.
1885 # as a count of seconds and fractions of seconds at nanosecond
1886 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1887 # or &quot;month&quot;. Range is approximately 10,000 years.
1888 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1889 # Durations less than one second are represented with a 0
1890 # `seconds` field and a positive `nanos` field. Must be from 0
1891 # to 999,999,999 inclusive.
1892 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1893 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1894 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1895 },
1896 &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
1897 # to the matched service.
1898 #
1899 # urlRewrite is the only action supported in UrlMaps
1900 # for classic Application Load Balancers.
1901 #
1902 # Not supported when the URL map is bound to a target gRPC proxy that
1903 # has the validateForProxyless field set to true.
1904 # backend service.
1905 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
1906 # host header is replaced with contents of hostRewrite.
1907 #
1908 # The value must be from 1 to 255 characters.
1909 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
1910 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
1911 #
1912 # The value must be from 1 to 1024 characters.
1913 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
1914 # header) using the HTTP template syntax.
1915 #
1916 # A corresponding
1917 # path_template_match must be specified. Any template variables must exist in
1918 # the path_template_match field.
1919 #
1920 #
1921 # - -At least one variable must be specified in the path_template_match
1922 # field
1923 # - You can omit variables from the rewritten URL
1924 # - The * and ** operators cannot be matched
1925 # unless they have a corresponding variable name - e.g.
1926 # {format=*} or {var=**}.
1927 #
1928 # For example, a path_template_match of /static/{format=**}
1929 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
1930 # rewrite, so that /{country}/{format}/{suffix=**} can be
1931 # rewritten as /content/{format}/{country}/{suffix}.
1932 #
1933 # At least
1934 # one non-empty routeRules[].matchRules[].path_template_match is
1935 # required.
1936 #
1937 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
1938 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
1939 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
1940 # It uses RE2 syntax with the following constraints:
1941 #
1942 #
1943 # - Any single character operators
1944 # - Groups are allowed to have only submatch operator inside
1945 # - Groups are allowed only without any char repetition, e.g.
1946 # .*
1947 # - Any char repetition, e.g. .*, is
1948 # only allowed to be used in a single regex together with:
1949 #
1950 #
1951 # - Empty string operators
1952 # - Other repetitions
1953 # - Ranges
1954 # - Repetitions of ranges
1955 #
1956 #
1957 # - Ranges are only allowed to have:
1958 #
1959 #
1960 # - Character range
1961 # - Digits range
1962 # - Symbols listed in characters allowed for ranges
1963 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
1964 # the path.
1965 },
1966 },
1967 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
1968 # occurs. The weights determine the fraction of traffic that flows to
1969 # their corresponding backend service. If all traffic needs to
1970 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
1971 #
1972 # After a backend service is identified and before forwarding
1973 # the request to
1974 # the backend service, advanced routing actions such as URL rewrites and
1975 # header transformations are applied depending on additional settings
1976 # specified in this HttpRouteAction.
1977 { # In contrast to a single BackendService in
1978 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
1979 # multiple backend services. The volume of traffic for each
1980 # backend service is proportional to the weight specified
1981 # in each WeightedBackendService
1982 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
1983 # resource. Before
1984 # forwarding the request to backendService, the load balancer
1985 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
1986 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
1987 # effect for the selected backendService.
1988 #
1989 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
1990 #
1991 # headerAction is not supported for load balancers that have
1992 # their loadBalancingScheme set to EXTERNAL.
1993 #
1994 # Not supported when the URL map is bound to a target gRPC proxy that
1995 # has validateForProxyless field set to true.
1996 # the request is passed along to the selected backendService.
1997 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
1998 { # Specification determining how headers are added to requests or responses.
1999 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
2000 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
2001 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
2002 # that already
2003 # exist for the header. If true, headerValue is set for the
2004 # header, discarding any values that were set for that header.
2005 #
2006 # The default value is true,
2007 # unless a variable is present in headerValue,
2008 # in which case the default value is false.
2009 # .
2010 },
2011 ],
2012 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
2013 # request before forwarding the request to the backendService.
2014 &quot;A String&quot;,
2015 ],
2016 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
2017 # client.
2018 { # Specification determining how headers are added to requests or responses.
2019 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
2020 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
2021 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
2022 # that already
2023 # exist for the header. If true, headerValue is set for the
2024 # header, discarding any values that were set for that header.
2025 #
2026 # The default value is true,
2027 # unless a variable is present in headerValue,
2028 # in which case the default value is false.
2029 # .
2030 },
2031 ],
2032 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
2033 # response before sending the response back to the client.
2034 &quot;A String&quot;,
2035 ],
2036 },
2037 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
2038 # computed asweight / (sum of all weightedBackendService weights in routeAction).
2039 #
2040 # The selection of a backend service is determined only for new traffic.
2041 # Once a user&#x27;s request has been directed to a backend service,
2042 # subsequent requests are sent to the same backend service as
2043 # determined by the backend service&#x27;s session affinity policy.
2044 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
2045 # splitting. If you do, the weighted traffic splitting configuration takes
2046 # precedence.
2047 #
2048 # The value must be from 0 to 1000.
2049 },
2050 ],
2051 },
2052 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource. This
2053 # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
2054 # matched. For example, the
2055 # following are all valid URLs to a BackendService resource:
2056 #
2057 #
2058 # - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
2059 # - compute/v1/projects/project/global/backendServices/backendService
2060 # - global/backendServices/backendService
2061 #
2062 #
2063 # If defaultRouteAction is also specified, advanced
2064 # routing actions, such as URL rewrites, take effect before sending the
2065 # request to the backend.
2066 #
2067 #
2068 # Only one of defaultUrlRedirect, defaultService
2069 # or defaultRouteAction.weightedBackendService can be set.
2070 #
2071 #
2072 # Authorization requires one or more of the following Google IAM permissions on the
2073 # specified resource default_service:
2074 #
2075 #
2076 # - compute.backendBuckets.use
2077 # - compute.backendServices.use
2078 &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
2079 # by defaultUrlRedirect.
2080 #
2081 #
2082 # Only one of defaultUrlRedirect, defaultService
2083 # or defaultRouteAction.weightedBackendService can be set.
2084 #
2085 #
2086 # Not supported when the URL map is bound to a target gRPC proxy.
2087 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
2088 # was supplied in the request.
2089 #
2090 # The value must be from 1 to 255
2091 # characters.
2092 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
2093 # set to HTTPS.
2094 # If set to false, the URL scheme of the redirected request
2095 # remains the same as that of the request.
2096 #
2097 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
2098 #
2099 # The default is set to false.
2100 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
2101 # that was supplied in the request.
2102 #
2103 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
2104 # supplied, the path of the original request is used for the redirect.
2105 #
2106 # The value must be from 1 to 1024 characters.
2107 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
2108 # the HttpRouteRuleMatch, retaining the remaining portion
2109 # of the URL before redirecting the request.
2110 #
2111 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
2112 # supplied, the path of the original request is used for the redirect.
2113 #
2114 # The value must be from 1 to 1024 characters.
2115 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
2116 #
2117 # Supported values are:
2118 #
2119 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
2120 # to 301.
2121 # - FOUND, which corresponds to 302.
2122 # - SEE_OTHER which corresponds to 303.
2123 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
2124 # method is retained.
2125 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
2126 # method is retained.
2127 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
2128 # URL is
2129 # removed before redirecting the request. If set to false, the
2130 # query portion of the original URL is retained.
2131 #
2132 # The default is set to false.
2133 },
2134 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
2135 # create the resource.
2136 &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
2137 # for the selected backend service.
2138 #
2139 # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
2140 #
2141 # HeaderAction is not supported for load balancers
2142 # that have
2143 # their loadBalancingScheme set to EXTERNAL.
2144 #
2145 # Not supported when the URL map is bound to a target gRPC proxy that
2146 # has validateForProxyless field set to true.
2147 # the request is passed along to the selected backendService.
2148 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
2149 { # Specification determining how headers are added to requests or responses.
2150 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
2151 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
2152 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
2153 # that already
2154 # exist for the header. If true, headerValue is set for the
2155 # header, discarding any values that were set for that header.
2156 #
2157 # The default value is true,
2158 # unless a variable is present in headerValue,
2159 # in which case the default value is false.
2160 # .
2161 },
2162 ],
2163 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
2164 # request before forwarding the request to the backendService.
2165 &quot;A String&quot;,
2166 ],
2167 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
2168 # client.
2169 { # Specification determining how headers are added to requests or responses.
2170 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
2171 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
2172 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
2173 # that already
2174 # exist for the header. If true, headerValue is set for the
2175 # header, discarding any values that were set for that header.
2176 #
2177 # The default value is true,
2178 # unless a variable is present in headerValue,
2179 # in which case the default value is false.
2180 # .
2181 },
2182 ],
2183 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
2184 # response before sending the response back to the client.
2185 &quot;A String&quot;,
2186 ],
2187 },
2188 &quot;name&quot;: &quot;A String&quot;, # The name to which this PathMatcher is referred by theHostRule.
2189 &quot;pathRules&quot;: [ # The list of path rules. Use this list instead of routeRules
2190 # when routing based on simple path matching is all that&#x27;s required. A path
2191 # rule can only include a wildcard character (*) after a
2192 # forward slash character (&quot;/&quot;).
2193 #
2194 # The order by which path rules are specified does not matter.
2195 # Matches are always done on the longest-path-first basis.
2196 #
2197 # For example: a pathRule with a path /a/b/c/* will match
2198 # before /a/b/* irrespective of the order in which those paths appear in this
2199 # list.
2200 #
2201 # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
2202 { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
2203 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
2204 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
2205 #
2206 # If a policy for an
2207 # error code is not configured for the PathRule, a policy for
2208 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
2209 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
2210 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
2211 # effect.
2212 #
2213 # For example, consider a UrlMap with the following configuration:
2214 #
2215 #
2216 # - UrlMap.defaultCustomErrorResponsePolicy are configured
2217 # with policies for 5xx and 4xx errors
2218 # - A PathRule for /coming_soon/ is configured for the error
2219 # code 404.
2220 #
2221 # 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
2222 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
2223 # the policy in PathRule.customErrorResponsePolicy takes
2224 # effect. If any of the requests in this example encounter a 500
2225 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
2226 #
2227 # customErrorResponsePolicy is supported only for
2228 # global external Application Load Balancers.
2229 # backend service or backend bucket responds with an error.
2230 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
2231 #
2232 # In a given policy, if you specify rules for both a range of error codes
2233 # as well as rules for specific error codes then rules with specific error
2234 # codes have a higher priority. For example, assume that you configure a rule
2235 # for 401 (Un-authorized) code, and another for all 4 series
2236 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
2237 # However if the backend service returns a 403, the rule for4xx takes effect.
2238 { # Specifies the mapping between the response code that will be returned along
2239 # with the custom error content and the response code returned by the backend
2240 # service.
2241 &quot;matchResponseCodes&quot;: [ # Valid values include:
2242 #
2243 #
2244 # - A number between 400 and 599: For example
2245 # 401 or 503, in which case the load balancer
2246 # applies the policy if the error code exactly matches this value.
2247 # - 5xx: Load Balancer will apply the policy if the
2248 # backend service responds with any response code in the range of
2249 # 500 to 599.
2250 # - 4xx: Load
2251 # Balancer will apply the policy if the backend service responds with any
2252 # response code in the range of 400 to
2253 # 499.
2254 #
2255 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
2256 &quot;A String&quot;,
2257 ],
2258 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
2259 # error content. If overrideResponseCode is not supplied, the
2260 # same response code returned by the original backend bucket or backend
2261 # service is returned to the client.
2262 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
2263 #
2264 # path must start
2265 # with a leading slash. path cannot have trailing slashes.
2266 #
2267 # If the file is not available in backendBucket or the
2268 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
2269 #
2270 # The value must
2271 # be from 1 to 1024 characters
2272 },
2273 ],
2274 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
2275 # contains the custom error content. Examples are:
2276 #
2277 #
2278 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
2279 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
2280 # - global/backendBuckets/myBackendBucket
2281 #
2282 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
2283 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
2284 #
2285 # If load balancer cannot reach
2286 # the backendBucket, a simple Not Found Error will
2287 # be returned, with the original response code (oroverrideResponseCode if configured).
2288 #
2289 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
2290 },
2291 &quot;paths&quot;: [ # The list of path patterns to match. Each must start with /
2292 # and the only place a * is allowed is at the end following
2293 # a /. The string fed to the path matcher does not include
2294 # any text after the first ? or #, and
2295 # those chars are not allowed here.
2296 &quot;A String&quot;,
2297 ],
2298 &quot;routeAction&quot;: { # In response to a matching path, the load balancer
2299 # performs advanced routing actions, such as URL rewrites and header
2300 # transformations, before forwarding the request to the selected
2301 # backend.
2302 #
2303 #
2304 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
2305 #
2306 #
2307 # URL maps for classic Application Load Balancers only support
2308 # the urlRewrite action within a path rule&#x27;srouteAction.
2309 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
2310 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
2311 # property must be specified. This policy cannot be specified if any target
2312 # backend has Identity-Aware Proxy enabled.
2313 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
2314 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
2315 # header names can be specified. The cache is bypassed for all `cacheMode`
2316 # values.
2317 &quot;A String&quot;,
2318 ],
2319 &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
2320 # on the backend type: for Backend Services, the complete request URI is
2321 # used; for Backend Buckets, the request URI is used without the protocol or
2322 # host, and only query parameters known to Cloud Storage are included.
2323 # Policy defined on Route Action.
2324 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
2325 # parameters will be included. Either specify `excludedQueryParameters`
2326 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
2327 # encoded and not treated as delimiters.
2328 #
2329 # Note: This field applies to routes that use backend services. Attempting
2330 # to set it on a route that points exclusively to Backend Buckets will
2331 # result in a configuration error. For routes that point to a Backend
2332 # Bucket, use `includedQueryParameters` to define which parameters should
2333 # be part of the cache key.
2334 &quot;A String&quot;,
2335 ],
2336 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
2337 #
2338 # Note: This setting is only applicable to routes that use a Backend
2339 # Service. It does not affect requests served by a Backend Bucket, as the
2340 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
2341 # it on a route that points exclusively to Backend Buckets will result in a
2342 # configuration error.
2343 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
2344 #
2345 # Note: This setting is only applicable to routes that use a Backend
2346 # Service. It does not affect requests served by a Backend Bucket, as the
2347 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
2348 # set on a route that points exclusively to Backend Buckets will result in
2349 # a configuration error.
2350 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
2351 # `includedQueryParameters` and `excludedQueryParameters`. If neither
2352 # is set, the entire query string will be included. If false, the query
2353 # string will be excluded from the cache key entirely.
2354 #
2355 # Note: This field applies to routes that use backend services. Attempting
2356 # to set it on a route that points exclusively to Backend Buckets will
2357 # result in a configuration error. For routes that point to a Backend
2358 # Bucket, use `includedQueryParameters` to define which parameters should
2359 # be part of the cache key.
2360 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
2361 # The name=value pair will be used in the cache key Cloud CDN generates.
2362 #
2363 # Note: This setting is only applicable to routes that use a Backend
2364 # Service. It does not affect requests served by a Backend Bucket.
2365 # Attempting to set it on a route that points exclusively to Backend
2366 # Buckets will result in a configuration error. Up to 5 cookie names can be
2367 # specified.
2368 &quot;A String&quot;,
2369 ],
2370 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
2371 &quot;A String&quot;,
2372 ],
2373 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
2374 # parameters will be excluded. Either specify `includedQueryParameters`
2375 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
2376 # encoded and not treated as delimiters.
2377 &quot;A String&quot;,
2378 ],
2379 },
2380 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
2381 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
2382 &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
2383 # content. This is used to clamp the max-age (or Expires) value sent to the
2384 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
2385 # is used for the response max-age directive, along with a &quot;public&quot;
2386 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
2387 # clamps the max-age from the origin (if specified), or else sets the
2388 # response max-age directive to the lesser of the `clientTtl` and
2389 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
2390 # present. The maximum allowed value is 31,622,400s (1 year). If not
2391 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
2392 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
2393 # `USE_ORIGIN_HEADERS`.
2394 # as a count of seconds and fractions of seconds at nanosecond
2395 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2396 # or &quot;month&quot;. Range is approximately 10,000 years.
2397 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2398 # Durations less than one second are represented with a 0
2399 # `seconds` field and a positive `nanos` field. Must be from 0
2400 # to 999,999,999 inclusive.
2401 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2402 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2403 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2404 },
2405 &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
2406 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
2407 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
2408 # greater than that of `maxTtl`. When the `cacheMode` is set to
2409 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
2410 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
2411 # accessed objects may be evicted from the cache before the defined TTL. If
2412 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
2413 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
2414 # `USE_ORIGIN_HEADERS`.
2415 # as a count of seconds and fractions of seconds at nanosecond
2416 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2417 # or &quot;month&quot;. Range is approximately 10,000 years.
2418 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2419 # Durations less than one second are represented with a 0
2420 # `seconds` field and a positive `nanos` field. Must be from 0
2421 # to 999,999,999 inclusive.
2422 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2423 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2424 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2425 },
2426 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
2427 # attempt to set a max-age or s-maxage higher than this, or an Expires header
2428 # more than `maxTtl` seconds in the future will be capped at the value of
2429 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
2430 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
2431 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
2432 # Infrequently accessed objects may be evicted from the cache before the
2433 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
2434 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
2435 # mode.
2436 # as a count of seconds and fractions of seconds at nanosecond
2437 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2438 # or &quot;month&quot;. Range is approximately 10,000 years.
2439 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2440 # Durations less than one second are represented with a 0
2441 # `seconds` field and a positive `nanos` field. Must be from 0
2442 # to 999,999,999 inclusive.
2443 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2444 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2445 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2446 },
2447 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
2448 # to apply fine-grained caching for common errors or redirects.
2449 # This can reduce the load on your origin and improve end-user
2450 # experience by reducing response latency.
2451 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
2452 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
2453 # the specified response code that lack any Cache-Control, Expires, or
2454 # Pragma: no-cache directives. When the `cacheMode` is set to
2455 # `FORCE_CACHE_ALL`, negative caching applies to all responses
2456 # with the specified response code, and overrides any caching headers. By
2457 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
2458 #
2459 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
2460 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
2461 # * 405 (Method Not Found), 501 (Not Implemented): 60s
2462 #
2463 # These defaults can be overridden in `negativeCachingPolicy`.
2464 # If not specified, Cloud CDN applies negative caching by default.
2465 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
2466 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
2467 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
2468 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
2469 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
2470 # all response codes that you wish to cache. Cloud CDN will not apply any
2471 # default negative caching when a policy exists.
2472 { # Specify CDN TTLs for response error codes.
2473 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
2474 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
2475 # specified as values, and you cannot specify a status code more than
2476 # once.
2477 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
2478 # corresponding status code.
2479 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
2480 # objects may be evicted from the cache before the defined TTL.
2481 # as a count of seconds and fractions of seconds at nanosecond
2482 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2483 # or &quot;month&quot;. Range is approximately 10,000 years.
2484 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2485 # Durations less than one second are represented with a 0
2486 # `seconds` field and a positive `nanos` field. Must be from 0
2487 # to 999,999,999 inclusive.
2488 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2489 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2490 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2491 },
2492 },
2493 ],
2494 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
2495 # requests into a small number of requests to the origin. If not specified,
2496 # Cloud CDN applies request coalescing by default.
2497 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
2498 # content with the origin, or when an error is encountered when refreshing
2499 # the cache.
2500 # This setting defines the default &quot;max-stale&quot; duration for any cached
2501 # responses that do not specify a max-stale directive. Stale responses that
2502 # exceed the TTL configured here will not be served. The default limit
2503 # (max-stale) is 86400s (1 day), which will allow stale content to be
2504 # served up to this limit beyond the max-age (or s-maxage) of a cached
2505 # response.
2506 # The maximum allowed value is 604800 (1 week).
2507 # Set this to zero (0) to disable serve-while-stale.
2508 # as a count of seconds and fractions of seconds at nanosecond
2509 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2510 # or &quot;month&quot;. Range is approximately 10,000 years.
2511 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2512 # Durations less than one second are represented with a 0
2513 # `seconds` field and a positive `nanos` field. Must be from 0
2514 # to 999,999,999 inclusive.
2515 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2516 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2517 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2518 },
2519 },
2520 &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
2521 # information about the W3C recommendation for cross-origin resource sharing
2522 # (CORS), see Fetch API Living
2523 # Standard.
2524 #
2525 # Not supported when the URL map is bound to a target gRPC proxy.
2526 # information about the W3C recommendation for cross-origin resource sharing
2527 # (CORS), see Fetch API Living
2528 # Standard.
2529 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
2530 # indicates that
2531 # the actual request can include user credentials. This field translates to
2532 # the Access-Control-Allow-Credentials header.
2533 #
2534 # Default is false.
2535 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
2536 # header.
2537 &quot;A String&quot;,
2538 ],
2539 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
2540 # header.
2541 &quot;A String&quot;,
2542 ],
2543 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
2544 # more information, see regular expression syntax.
2545 #
2546 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
2547 #
2548 # Regular expressions can only be used when the loadBalancingScheme is
2549 # set to INTERNAL_SELF_MANAGED.
2550 &quot;A String&quot;,
2551 ],
2552 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
2553 #
2554 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
2555 &quot;A String&quot;,
2556 ],
2557 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
2558 # The default value is false, which indicates that the CORS
2559 # policy is in effect.
2560 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
2561 # header.
2562 &quot;A String&quot;,
2563 ],
2564 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
2565 # seconds. This field translates to the Access-Control-Max-Age
2566 # header.
2567 },
2568 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
2569 # the resiliency of clients to backend service failure. As part of fault
2570 # injection, when clients send requests to a backend service, delays can be
2571 # introduced by a load balancer on a percentage of requests before sending
2572 # those requests to the backend service. Similarly requests from clients can
2573 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
2574 # that are configured with a fault_injection_policy if:
2575 # 1. The traffic is generated by fault injection AND
2576 # 2. The fault injection is not a delay fault injection.
2577 # Fault injection is not supported with the classic Application Load Balancer
2578 # . To see which load balancers support fault injection,
2579 # see Load
2580 # balancing: Routing and traffic management features.
2581 # the resiliency of clients to backend service failure. As part of fault
2582 # injection, when clients send requests to a backend service, delays can be
2583 # introduced by the load balancer on a percentage of requests before sending
2584 # those request to the backend service. Similarly requests from clients can be
2585 # aborted by the load balancer for a percentage of requests.
2586 &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
2587 # injection.
2588 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
2589 #
2590 # The value must be from 200 to 599 inclusive.
2591 #
2592 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
2593 # according to this
2594 # mapping table. HTTP status 200 is mapped to gRPC status
2595 # UNKNOWN. Injecting an OK status is currently not supported by
2596 # Traffic Director.
2597 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
2598 # that is aborted as part of fault injection.
2599 #
2600 # The value must be from 0.0 to 100.0 inclusive.
2601 },
2602 &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
2603 # injection, before being sent to a backend service.
2604 # request to the backend service as part of fault injection.
2605 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
2606 # as a count of seconds and fractions of seconds at nanosecond
2607 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2608 # or &quot;month&quot;. Range is approximately 10,000 years.
2609 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2610 # Durations less than one second are represented with a 0
2611 # `seconds` field and a positive `nanos` field. Must be from 0
2612 # to 999,999,999 inclusive.
2613 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2614 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2615 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2616 },
2617 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
2618 # which a delay is introduced as part of fault injection.
2619 #
2620 # The value must be from 0.0 to 100.0 inclusive.
2621 },
2622 },
2623 &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
2624 # Global EXTERNAL_MANAGED load balancer schemes.
2625 # Either Cloud CDN must be enabled on the backend service or backend bucket
2626 # serving the route, or cache policy must be configured on the same route
2627 # dynamically processes and delivers images from the network edge.
2628 # Image Optimization is only available for Global External Application Load
2629 # Balancers.
2630 # Either Cloud CDN must be enabled on the backend service or backend bucket
2631 # serving the route, or cache policy must be configured on the same route.
2632 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
2633 },
2634 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
2635 # Unlike the timeout field where the timeout duration starts
2636 # from the time the request has been fully processed (known as*end-of-stream*),
2637 # the duration in this field is computed from the beginning of the stream
2638 # until the response has been processed, including all retries. A
2639 # stream that does not complete in this duration is closed.
2640 #
2641 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
2642 # with the route.
2643 #
2644 # This field is only allowed if the Url map is used with backend services
2645 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
2646 # as a count of seconds and fractions of seconds at nanosecond
2647 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2648 # or &quot;month&quot;. Range is approximately 10,000 years.
2649 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2650 # Durations less than one second are represented with a 0
2651 # `seconds` field and a positive `nanos` field. Must be from 0
2652 # to 999,999,999 inclusive.
2653 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2654 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2655 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2656 },
2657 &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
2658 # are shadowed to a separate mirrored backend service. The load balancer does
2659 # not wait for responses from the shadow service. Before sending traffic
2660 # to the shadow service, the host / authority header is suffixed with-shadow.
2661 #
2662 # Not supported when the URL map is bound to a target gRPC proxy that
2663 # has the validateForProxyless field set to true.
2664 # are shadowed to a separate mirrored backend service. The load balancer
2665 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
2666 # to the shadow service, the host or authority header is suffixed with-shadow.
2667 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
2668 # mirrored to.
2669 #
2670 # The backend service configured for a mirroring
2671 # policy must reference backends that are of the same type as the original
2672 # backend service matched in the URL map.
2673 #
2674 # Serverless NEG backends are not currently supported as a mirrored
2675 # backend service.
2676 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
2677 },
2678 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
2679 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
2680 # If not specified, defaults to 1.
2681 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
2682 #
2683 # If not specified, will use the timeout set in theHttpRouteAction field.
2684 # If timeout in the HttpRouteAction field is not set, this field
2685 # uses the largest timeout
2686 # among all backend services associated with the route.
2687 #
2688 # Not supported when the URL map is bound to a target gRPC proxy that
2689 # has the validateForProxyless field set to true.
2690 # as a count of seconds and fractions of seconds at nanosecond
2691 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2692 # or &quot;month&quot;. Range is approximately 10,000 years.
2693 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2694 # Durations less than one second are represented with a 0
2695 # `seconds` field and a positive `nanos` field. Must be from 0
2696 # to 999,999,999 inclusive.
2697 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2698 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2699 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2700 },
2701 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
2702 # values are:
2703 #
2704 # - 5xx: retry is attempted if the instance or endpoint
2705 # responds with any 5xx response code, or if the instance or
2706 # endpoint does not respond at all. For example, disconnects, reset, read
2707 # timeout, connection failure, and refused streams.
2708 # - gateway-error: Similar to 5xx, but only
2709 # applies to response codes 502, 503 or504.
2710 # - connect-failure: a retry is attempted on failures
2711 # connecting to the instance or endpoint. For example, connection
2712 # timeouts.
2713 # - retriable-4xx: a retry is attempted if the instance
2714 # or endpoint responds with a 4xx response code.
2715 # The only error that you can retry is error code 409.
2716 # - refused-stream: a retry is attempted if the instance
2717 # or endpoint resets the stream with a REFUSED_STREAM error
2718 # code. This reset type indicates that it is safe to retry.
2719 # - cancelled: a retry is attempted if the gRPC status
2720 # code in the response header is set to cancelled.
2721 # - deadline-exceeded: a retry is attempted if the gRPC
2722 # status code in the response header is set todeadline-exceeded.
2723 # - internal: a retry is attempted if the gRPC
2724 # status code in the response header is set tointernal.
2725 # - resource-exhausted: a retry is attempted if the gRPC
2726 # status code in the response header is set toresource-exhausted.
2727 # - unavailable: a retry is attempted if the gRPC
2728 # status code in the response header is set tounavailable.
2729 #
2730 # Only the following codes are supported when the URL map is bound to
2731 # target gRPC proxy that has validateForProxyless field set to true.
2732 #
2733 # - cancelled
2734 # - deadline-exceeded
2735 # - internal
2736 # - resource-exhausted
2737 # - unavailable
2738 &quot;A String&quot;,
2739 ],
2740 },
2741 &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
2742 # time the request has been fully processed (known as *end-of-stream*)
2743 # up until the response has been processed. Timeout includes
2744 # all retries.
2745 #
2746 # If not specified, this field uses the largest timeout among all backend
2747 # services associated with the route.
2748 #
2749 # Not supported when the URL map is bound to a target gRPC proxy that
2750 # has validateForProxyless field set to true.
2751 # as a count of seconds and fractions of seconds at nanosecond
2752 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2753 # or &quot;month&quot;. Range is approximately 10,000 years.
2754 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2755 # Durations less than one second are represented with a 0
2756 # `seconds` field and a positive `nanos` field. Must be from 0
2757 # to 999,999,999 inclusive.
2758 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2759 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2760 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2761 },
2762 &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
2763 # to the matched service.
2764 #
2765 # urlRewrite is the only action supported in UrlMaps
2766 # for classic Application Load Balancers.
2767 #
2768 # Not supported when the URL map is bound to a target gRPC proxy that
2769 # has the validateForProxyless field set to true.
2770 # backend service.
2771 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
2772 # host header is replaced with contents of hostRewrite.
2773 #
2774 # The value must be from 1 to 255 characters.
2775 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
2776 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
2777 #
2778 # The value must be from 1 to 1024 characters.
2779 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
2780 # header) using the HTTP template syntax.
2781 #
2782 # A corresponding
2783 # path_template_match must be specified. Any template variables must exist in
2784 # the path_template_match field.
2785 #
2786 #
2787 # - -At least one variable must be specified in the path_template_match
2788 # field
2789 # - You can omit variables from the rewritten URL
2790 # - The * and ** operators cannot be matched
2791 # unless they have a corresponding variable name - e.g.
2792 # {format=*} or {var=**}.
2793 #
2794 # For example, a path_template_match of /static/{format=**}
2795 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
2796 # rewrite, so that /{country}/{format}/{suffix=**} can be
2797 # rewritten as /content/{format}/{country}/{suffix}.
2798 #
2799 # At least
2800 # one non-empty routeRules[].matchRules[].path_template_match is
2801 # required.
2802 #
2803 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
2804 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
2805 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
2806 # It uses RE2 syntax with the following constraints:
2807 #
2808 #
2809 # - Any single character operators
2810 # - Groups are allowed to have only submatch operator inside
2811 # - Groups are allowed only without any char repetition, e.g.
2812 # .*
2813 # - Any char repetition, e.g. .*, is
2814 # only allowed to be used in a single regex together with:
2815 #
2816 #
2817 # - Empty string operators
2818 # - Other repetitions
2819 # - Ranges
2820 # - Repetitions of ranges
2821 #
2822 #
2823 # - Ranges are only allowed to have:
2824 #
2825 #
2826 # - Character range
2827 # - Digits range
2828 # - Symbols listed in characters allowed for ranges
2829 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
2830 # the path.
2831 },
2832 },
2833 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
2834 # occurs. The weights determine the fraction of traffic that flows to
2835 # their corresponding backend service. If all traffic needs to
2836 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
2837 #
2838 # After a backend service is identified and before forwarding
2839 # the request to
2840 # the backend service, advanced routing actions such as URL rewrites and
2841 # header transformations are applied depending on additional settings
2842 # specified in this HttpRouteAction.
2843 { # In contrast to a single BackendService in
2844 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
2845 # multiple backend services. The volume of traffic for each
2846 # backend service is proportional to the weight specified
2847 # in each WeightedBackendService
2848 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
2849 # resource. Before
2850 # forwarding the request to backendService, the load balancer
2851 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
2852 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
2853 # effect for the selected backendService.
2854 #
2855 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
2856 #
2857 # headerAction is not supported for load balancers that have
2858 # their loadBalancingScheme set to EXTERNAL.
2859 #
2860 # Not supported when the URL map is bound to a target gRPC proxy that
2861 # has validateForProxyless field set to true.
2862 # the request is passed along to the selected backendService.
2863 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
2864 { # Specification determining how headers are added to requests or responses.
2865 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
2866 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
2867 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
2868 # that already
2869 # exist for the header. If true, headerValue is set for the
2870 # header, discarding any values that were set for that header.
2871 #
2872 # The default value is true,
2873 # unless a variable is present in headerValue,
2874 # in which case the default value is false.
2875 # .
2876 },
2877 ],
2878 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
2879 # request before forwarding the request to the backendService.
2880 &quot;A String&quot;,
2881 ],
2882 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
2883 # client.
2884 { # Specification determining how headers are added to requests or responses.
2885 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
2886 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
2887 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
2888 # that already
2889 # exist for the header. If true, headerValue is set for the
2890 # header, discarding any values that were set for that header.
2891 #
2892 # The default value is true,
2893 # unless a variable is present in headerValue,
2894 # in which case the default value is false.
2895 # .
2896 },
2897 ],
2898 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
2899 # response before sending the response back to the client.
2900 &quot;A String&quot;,
2901 ],
2902 },
2903 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
2904 # computed asweight / (sum of all weightedBackendService weights in routeAction).
2905 #
2906 # The selection of a backend service is determined only for new traffic.
2907 # Once a user&#x27;s request has been directed to a backend service,
2908 # subsequent requests are sent to the same backend service as
2909 # determined by the backend service&#x27;s session affinity policy.
2910 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
2911 # splitting. If you do, the weighted traffic splitting configuration takes
2912 # precedence.
2913 #
2914 # The value must be from 0 to 1000.
2915 },
2916 ],
2917 },
2918 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
2919 # is directed if this rule is matched. If routeAction is
2920 # also specified, advanced routing actions, such as URL rewrites,
2921 # take effect before sending the request to the backend.
2922 #
2923 #
2924 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
2925 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
2926 # specified by urlRedirect.
2927 #
2928 #
2929 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
2930 #
2931 #
2932 # Not supported when the URL map is bound to a target gRPC proxy.
2933 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
2934 # was supplied in the request.
2935 #
2936 # The value must be from 1 to 255
2937 # characters.
2938 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
2939 # set to HTTPS.
2940 # If set to false, the URL scheme of the redirected request
2941 # remains the same as that of the request.
2942 #
2943 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
2944 #
2945 # The default is set to false.
2946 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
2947 # that was supplied in the request.
2948 #
2949 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
2950 # supplied, the path of the original request is used for the redirect.
2951 #
2952 # The value must be from 1 to 1024 characters.
2953 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
2954 # the HttpRouteRuleMatch, retaining the remaining portion
2955 # of the URL before redirecting the request.
2956 #
2957 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
2958 # supplied, the path of the original request is used for the redirect.
2959 #
2960 # The value must be from 1 to 1024 characters.
2961 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
2962 #
2963 # Supported values are:
2964 #
2965 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
2966 # to 301.
2967 # - FOUND, which corresponds to 302.
2968 # - SEE_OTHER which corresponds to 303.
2969 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
2970 # method is retained.
2971 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
2972 # method is retained.
2973 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
2974 # URL is
2975 # removed before redirecting the request. If set to false, the
2976 # query portion of the original URL is retained.
2977 #
2978 # The default is set to false.
2979 },
2980 },
2981 ],
2982 &quot;routeRules&quot;: [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
2983 # desired. routeRules are evaluated in order of priority, from
2984 # the lowest to highest number.
2985 #
2986 # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
2987 { # The HttpRouteRule setting specifies how to match an HTTP request
2988 # and the corresponding routing action that load balancing proxies perform.
2989 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
2990 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
2991 #
2992 # If a policy for an
2993 # error code is not configured for the RouteRule, a policy for
2994 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
2995 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
2996 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
2997 # effect.
2998 #
2999 # For example, consider a UrlMap with the following configuration:
3000 #
3001 #
3002 # - UrlMap.defaultCustomErrorResponsePolicy are configured
3003 # with policies for 5xx and 4xx errors
3004 # - A RouteRule for /coming_soon/ is configured for the
3005 # error code 404.
3006 #
3007 # 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
3008 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
3009 # the policy in RouteRule.customErrorResponsePolicy takes
3010 # effect. If any of the requests in this example encounter a 500
3011 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
3012 #
3013 # When
3014 # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
3015 # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
3016 # a retry, if load balancer is successful in reaching the
3017 # service, the customErrorResponsePolicy is ignored and
3018 # the response from the service is returned to the client.
3019 #
3020 # customErrorResponsePolicy is supported only for
3021 # global external Application Load Balancers.
3022 # backend service or backend bucket responds with an error.
3023 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
3024 #
3025 # In a given policy, if you specify rules for both a range of error codes
3026 # as well as rules for specific error codes then rules with specific error
3027 # codes have a higher priority. For example, assume that you configure a rule
3028 # for 401 (Un-authorized) code, and another for all 4 series
3029 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
3030 # However if the backend service returns a 403, the rule for4xx takes effect.
3031 { # Specifies the mapping between the response code that will be returned along
3032 # with the custom error content and the response code returned by the backend
3033 # service.
3034 &quot;matchResponseCodes&quot;: [ # Valid values include:
3035 #
3036 #
3037 # - A number between 400 and 599: For example
3038 # 401 or 503, in which case the load balancer
3039 # applies the policy if the error code exactly matches this value.
3040 # - 5xx: Load Balancer will apply the policy if the
3041 # backend service responds with any response code in the range of
3042 # 500 to 599.
3043 # - 4xx: Load
3044 # Balancer will apply the policy if the backend service responds with any
3045 # response code in the range of 400 to
3046 # 499.
3047 #
3048 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
3049 &quot;A String&quot;,
3050 ],
3051 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
3052 # error content. If overrideResponseCode is not supplied, the
3053 # same response code returned by the original backend bucket or backend
3054 # service is returned to the client.
3055 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
3056 #
3057 # path must start
3058 # with a leading slash. path cannot have trailing slashes.
3059 #
3060 # If the file is not available in backendBucket or the
3061 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
3062 #
3063 # The value must
3064 # be from 1 to 1024 characters
3065 },
3066 ],
3067 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
3068 # contains the custom error content. Examples are:
3069 #
3070 #
3071 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
3072 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
3073 # - global/backendBuckets/myBackendBucket
3074 #
3075 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
3076 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
3077 #
3078 # If load balancer cannot reach
3079 # the backendBucket, a simple Not Found Error will
3080 # be returned, with the original response code (oroverrideResponseCode if configured).
3081 #
3082 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
3083 },
3084 &quot;description&quot;: &quot;A String&quot;, # The short description conveying the intent of this routeRule.
3085 #
3086 #
3087 # The description can have a maximum length of 1024 characters.
3088 &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
3089 # for the selected backendService.
3090 #
3091 # The headerAction value specified here is applied before the
3092 # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
3093 #
3094 # HeaderAction is not supported for load balancers
3095 # that have
3096 # their loadBalancingScheme set to EXTERNAL.
3097 #
3098 # Not supported when the URL map is bound to a target gRPC proxy that
3099 # has validateForProxyless field set to true.
3100 # the request is passed along to the selected backendService.
3101 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
3102 { # Specification determining how headers are added to requests or responses.
3103 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
3104 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
3105 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
3106 # that already
3107 # exist for the header. If true, headerValue is set for the
3108 # header, discarding any values that were set for that header.
3109 #
3110 # The default value is true,
3111 # unless a variable is present in headerValue,
3112 # in which case the default value is false.
3113 # .
3114 },
3115 ],
3116 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
3117 # request before forwarding the request to the backendService.
3118 &quot;A String&quot;,
3119 ],
3120 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
3121 # client.
3122 { # Specification determining how headers are added to requests or responses.
3123 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
3124 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
3125 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
3126 # that already
3127 # exist for the header. If true, headerValue is set for the
3128 # header, discarding any values that were set for that header.
3129 #
3130 # The default value is true,
3131 # unless a variable is present in headerValue,
3132 # in which case the default value is false.
3133 # .
3134 },
3135 ],
3136 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
3137 # response before sending the response back to the client.
3138 &quot;A String&quot;,
3139 ],
3140 },
3141 &quot;httpFilterConfigs&quot;: [ # Outbound route specific configuration fornetworkservices.HttpFilter resources enabled by Traffic
3142 # Director. httpFilterConfigs only applies for load balancers
3143 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
3144 # more details.
3145 #
3146 # Not supported when the URL map is bound to a target gRPC proxy that
3147 # has validateForProxyless field set to true.
3148 { # HttpFilterConfiguration supplies additional contextual settings
3149 # for networkservices.HttpFilter resources enabled by Traffic
3150 # Director.
3151 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
3152 # YAML formatted and only contain fields defined in the protobuf identified
3153 # in configTypeUrl
3154 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
3155 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
3156 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
3157 # configuration belongs to. This name must be known to the xDS client.
3158 # Example: envoy.wasm
3159 },
3160 ],
3161 &quot;httpFilterMetadata&quot;: [ # Outbound route specific metadata supplied tonetworkservices.HttpFilter resources enabled by Traffic
3162 # Director. httpFilterMetadata only applies for load balancers
3163 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
3164 # more details.
3165 #
3166 # The only configTypeUrl supported istype.googleapis.com/google.protobuf.Struct
3167 #
3168 # Not supported when the URL map is bound to a target gRPC proxy that
3169 # has validateForProxyless field set to true.
3170 { # HttpFilterConfiguration supplies additional contextual settings
3171 # for networkservices.HttpFilter resources enabled by Traffic
3172 # Director.
3173 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
3174 # YAML formatted and only contain fields defined in the protobuf identified
3175 # in configTypeUrl
3176 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
3177 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
3178 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
3179 # configuration belongs to. This name must be known to the xDS client.
3180 # Example: envoy.wasm
3181 },
3182 ],
3183 &quot;matchRules&quot;: [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
3184 # this routeRule when any of thematchRules are satisfied. However predicates within
3185 # a given matchRule have AND semantics. All predicates
3186 # within a matchRule must match for the request to
3187 # match the rule.
3188 { # HttpRouteRuleMatch specifies a set of criteria for matching
3189 # requests to an HttpRouteRule. All specified criteria must
3190 # be satisfied for a match to occur.
3191 &quot;fullPathMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
3192 # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
3193 # that may be part of the original URL.
3194 #
3195 # fullPathMatch must be from 1 to 1024 characters.
3196 #
3197 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
3198 # specified.
3199 &quot;headerMatches&quot;: [ # Specifies a list of header match criteria, all of which must match
3200 # corresponding headers in the request.
3201 { # matchRule criteria for request header matches.
3202 &quot;exactMatch&quot;: &quot;A String&quot;, # The value should exactly match contents of exactMatch.
3203 #
3204 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
3205 &quot;headerName&quot;: &quot;A String&quot;, # The name of the HTTP header to match.
3206 #
3207 # For matching against the HTTP request&#x27;s authority, use a headerMatch
3208 # with the header name &quot;:authority&quot;.
3209 #
3210 # For matching a request&#x27;s method, use the headerName &quot;:method&quot;.
3211 #
3212 # When the URL map is bound to a target gRPC proxy that has
3213 # the validateForProxyless field set to true, only
3214 # non-binary
3215 # user-specified custom metadata and the `content-type` header are supported.
3216 # The following transport-level headers cannot be used in header matching
3217 # rules:
3218 # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
3219 # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
3220 # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
3221 # `grpc-timeout` and `grpc-trace-bin`.
3222 &quot;invertMatch&quot;: True or False, # If set to false, the headerMatch is considered a
3223 # match if the preceding match criteria are met. If set to true,
3224 # the headerMatch is considered a match if the preceding
3225 # match criteria are NOT met.
3226 #
3227 # The default setting is false.
3228 &quot;prefixMatch&quot;: &quot;A String&quot;, # The value of the header must start with the contents ofprefixMatch.
3229 #
3230 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
3231 &quot;presentMatch&quot;: True or False, # A header with the contents of headerName must exist. The
3232 # match takes place whether or not the request&#x27;s header has a value.
3233 #
3234 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
3235 &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
3236 # specified in rangeMatch. If the header does not contain an
3237 # integer, number or is empty, the match fails.
3238 #
3239 # For example for a range [-5, 0]
3240 #
3241 #
3242 # - -3 will match.
3243 # - 0 will not match.
3244 # - 0.25 will not match.
3245 # - -3someString will not match.
3246 #
3247 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
3248 #
3249 # rangeMatch is not supported for load balancers
3250 # that have loadBalancingScheme set to EXTERNAL.
3251 # within the specified integer range.
3252 &quot;rangeEnd&quot;: &quot;A String&quot;, # The end of the range (exclusive) in signed long integer format.
3253 &quot;rangeStart&quot;: &quot;A String&quot;, # The start of the range (inclusive) in signed long integer format.
3254 },
3255 &quot;regexMatch&quot;: &quot;A String&quot;, # The value of the header must match the regular expression specified inregexMatch.
3256 # For more information about regular expression syntax, see Syntax.
3257 #
3258 # For matching against a port specified in the HTTP request, use a
3259 # headerMatch with headerName set to PORT and a regular expression that
3260 # satisfies the RFC2616 Host header&#x27;s port specifier.
3261 #
3262 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
3263 #
3264 # Regular expressions can only be used when the loadBalancingScheme is
3265 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
3266 # (regional scope) or INTERNAL_MANAGED.
3267 &quot;suffixMatch&quot;: &quot;A String&quot;, # The value of the header must end with the contents ofsuffixMatch.
3268 #
3269 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
3270 },
3271 ],
3272 &quot;ignoreCase&quot;: True or False, # Specifies that prefixMatch and fullPathMatch
3273 # matches are case sensitive.
3274 #
3275 # The default value is false.
3276 #
3277 # ignoreCase must not be used with regexMatch.
3278 #
3279 # Not supported when the URL map is bound to a target gRPC proxy.
3280 &quot;metadataFilters&quot;: [ # Opaque filter criteria used by the load balancer to restrict routing
3281 # configuration to a limited set of xDS
3282 # compliant clients. In their xDS requests to the load balancer, xDS clients
3283 # present node
3284 # metadata. When there is a match, the relevant routing configuration
3285 # is made available to those proxies.
3286 #
3287 # 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
3288 # the metadata. If its filterMatchCriteria is set to
3289 # MATCH_ALL, then all of its filterLabels must match with
3290 # corresponding labels provided in the metadata. If multiple
3291 # metadata filters are specified, all of them need to be
3292 # satisfied in order to be considered a match.
3293 #
3294 # metadataFilters specified here is applied after those
3295 # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
3296 #
3297 # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
3298 #
3299 # Not supported when the URL map is bound to a target gRPC proxy that
3300 # has validateForProxyless field set to true.
3301 { # Opaque filter criteria used by load balancers to restrict routing
3302 # configuration to a limited set of load balancing proxies. Proxies and
3303 # sidecars involved in load balancing would typically present metadata to the
3304 # load balancers that need to match criteria specified here. If a match takes
3305 # place, the relevant configuration is made available to those
3306 # proxies.
3307 #
3308 # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
3309 # one of thefilterLabels must match the corresponding label provided in
3310 # the metadata. If its filterMatchCriteria is set to
3311 # MATCH_ALL, then all of its filterLabels must match with
3312 # corresponding labels provided in the metadata.
3313 #
3314 # An example for using metadataFilters would be: if
3315 # load balancing involves
3316 # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in of their XDS requests to loadbalancers.
3317 &quot;filterLabels&quot;: [ # The list of label value pairs that must match labels in the provided
3318 # metadata based on filterMatchCriteria
3319 #
3320 # This list must not be empty and can have at the most 64 entries.
3321 { # MetadataFilter label name value pairs that are expected
3322 # to match corresponding labels presented as metadata to the load balancer.
3323 &quot;name&quot;: &quot;A String&quot;, # Name of metadata label.
3324 #
3325 # The name can have a maximum length of 1024 characters and must be at
3326 # least 1 character long.
3327 &quot;value&quot;: &quot;A String&quot;, # The value of the label must match the specified value.
3328 #
3329 # value can have a maximum length of 1024 characters.
3330 },
3331 ],
3332 &quot;filterMatchCriteria&quot;: &quot;A String&quot;, # Specifies how individual filter label matches
3333 # within the list of filterLabels and contributes toward the
3334 # overall metadataFilter match.
3335 #
3336 # Supported values are:
3337 #
3338 # - MATCH_ANY: at least one of the filterLabels
3339 # must have a matching label in the provided metadata.
3340 # - MATCH_ALL: all filterLabels must have
3341 # matching labels in the provided metadata.
3342 },
3343 ],
3344 &quot;pathTemplateMatch&quot;: &quot;A String&quot;, # If specified, this field defines a path template pattern that must match
3345 # the :path header after the query string is removed.
3346 #
3347 # A path template pattern can include variables and wildcards.
3348 # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
3349 # matches a single path segment, and ** that matches zero or
3350 # more path segments. The pattern must follow these rules:
3351 #
3352 #
3353 # - The value must be between 1 and 1024 characters.
3354 # - The pattern must start with a leading slash (&quot;/&quot;).
3355 # - No more than 5 operators (variables or wildcards) may appear in
3356 # the pattern.
3357 #
3358 # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
3359 # set.
3360 &quot;prefixMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the request&#x27;s
3361 # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
3362 #
3363 # The value must be from 1 to 1024 characters.
3364 #
3365 # The * character inside a prefix match is
3366 # treated as a literal character, not as a wildcard.
3367 #
3368 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
3369 # used within a matchRule.
3370 &quot;queryParameterMatches&quot;: [ # Specifies a list of query parameter match criteria, all of which must
3371 # match corresponding query parameters in the request.
3372 #
3373 # Not supported when the URL map is bound to a target gRPC proxy.
3374 { # HttpRouteRuleMatch criteria for a request&#x27;s query parameter.
3375 &quot;exactMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
3376 # parameter exactly matches the contents of exactMatch.
3377 #
3378 # Only one of presentMatch, exactMatch, orregexMatch must be set.
3379 &quot;name&quot;: &quot;A String&quot;, # The name of the query parameter to match. The query parameter must exist in
3380 # the request, in the absence of which the request match fails.
3381 &quot;presentMatch&quot;: True or False, # Specifies that the queryParameterMatch matches if the
3382 # request contains the query parameter, irrespective of whether the
3383 # parameter has a value or not.
3384 #
3385 # Only one of presentMatch, exactMatch, orregexMatch must be set.
3386 &quot;regexMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
3387 # parameter matches the regular expression specified byregexMatch. For
3388 # more information about regular expression syntax, see Syntax.
3389 #
3390 # Only one of presentMatch, exactMatch, orregexMatch must be set.
3391 #
3392 # Regular expressions can only be used when the loadBalancingScheme is
3393 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
3394 # (regional scope) or INTERNAL_MANAGED.
3395 },
3396 ],
3397 &quot;regexMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
3398 # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
3399 # supplied with the original URL. For
3400 # more information about regular expression syntax, see Syntax.
3401 #
3402 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
3403 # specified.
3404 #
3405 # Regular expressions can only be used when the loadBalancingScheme is
3406 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
3407 # (regional scope) or INTERNAL_MANAGED.
3408 },
3409 ],
3410 &quot;priority&quot;: 42, # For routeRules within a given pathMatcher,
3411 # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
3412 # of priority, from the lowest to highest number. The priority of a
3413 # rule decreases as its number increases (1, 2, 3, N+1). The first rule
3414 # that matches the request is applied.
3415 #
3416 #
3417 # You cannot configure two or more routeRules with the same priority.
3418 # Priority for each rule must be set to a number from 0 to 2147483647
3419 # inclusive.
3420 #
3421 #
3422 # Priority numbers can have gaps, which enable you to add or remove rules
3423 # in the future without affecting the rest of the rules. For example, 1, 2,
3424 # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
3425 # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
3426 # without any impact on existing rules.
3427 &quot;routeAction&quot;: { # In response to a matching matchRule, the load balancer
3428 # performs advanced routing actions, such as URL rewrites and header
3429 # transformations, before forwarding the request to the selected backend.
3430 #
3431 #
3432 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
3433 #
3434 #
3435 # URL maps for classic Application Load Balancers only support
3436 # the urlRewrite action within a route rule&#x27;srouteAction.
3437 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
3438 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
3439 # property must be specified. This policy cannot be specified if any target
3440 # backend has Identity-Aware Proxy enabled.
3441 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
3442 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
3443 # header names can be specified. The cache is bypassed for all `cacheMode`
3444 # values.
3445 &quot;A String&quot;,
3446 ],
3447 &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
3448 # on the backend type: for Backend Services, the complete request URI is
3449 # used; for Backend Buckets, the request URI is used without the protocol or
3450 # host, and only query parameters known to Cloud Storage are included.
3451 # Policy defined on Route Action.
3452 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
3453 # parameters will be included. Either specify `excludedQueryParameters`
3454 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
3455 # encoded and not treated as delimiters.
3456 #
3457 # Note: This field applies to routes that use backend services. Attempting
3458 # to set it on a route that points exclusively to Backend Buckets will
3459 # result in a configuration error. For routes that point to a Backend
3460 # Bucket, use `includedQueryParameters` to define which parameters should
3461 # be part of the cache key.
3462 &quot;A String&quot;,
3463 ],
3464 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
3465 #
3466 # Note: This setting is only applicable to routes that use a Backend
3467 # Service. It does not affect requests served by a Backend Bucket, as the
3468 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
3469 # it on a route that points exclusively to Backend Buckets will result in a
3470 # configuration error.
3471 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
3472 #
3473 # Note: This setting is only applicable to routes that use a Backend
3474 # Service. It does not affect requests served by a Backend Bucket, as the
3475 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
3476 # set on a route that points exclusively to Backend Buckets will result in
3477 # a configuration error.
3478 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
3479 # `includedQueryParameters` and `excludedQueryParameters`. If neither
3480 # is set, the entire query string will be included. If false, the query
3481 # string will be excluded from the cache key entirely.
3482 #
3483 # Note: This field applies to routes that use backend services. Attempting
3484 # to set it on a route that points exclusively to Backend Buckets will
3485 # result in a configuration error. For routes that point to a Backend
3486 # Bucket, use `includedQueryParameters` to define which parameters should
3487 # be part of the cache key.
3488 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
3489 # The name=value pair will be used in the cache key Cloud CDN generates.
3490 #
3491 # Note: This setting is only applicable to routes that use a Backend
3492 # Service. It does not affect requests served by a Backend Bucket.
3493 # Attempting to set it on a route that points exclusively to Backend
3494 # Buckets will result in a configuration error. Up to 5 cookie names can be
3495 # specified.
3496 &quot;A String&quot;,
3497 ],
3498 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
3499 &quot;A String&quot;,
3500 ],
3501 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
3502 # parameters will be excluded. Either specify `includedQueryParameters`
3503 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
3504 # encoded and not treated as delimiters.
3505 &quot;A String&quot;,
3506 ],
3507 },
3508 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
3509 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
3510 &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
3511 # content. This is used to clamp the max-age (or Expires) value sent to the
3512 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
3513 # is used for the response max-age directive, along with a &quot;public&quot;
3514 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
3515 # clamps the max-age from the origin (if specified), or else sets the
3516 # response max-age directive to the lesser of the `clientTtl` and
3517 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
3518 # present. The maximum allowed value is 31,622,400s (1 year). If not
3519 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
3520 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
3521 # `USE_ORIGIN_HEADERS`.
3522 # as a count of seconds and fractions of seconds at nanosecond
3523 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3524 # or &quot;month&quot;. Range is approximately 10,000 years.
3525 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3526 # Durations less than one second are represented with a 0
3527 # `seconds` field and a positive `nanos` field. Must be from 0
3528 # to 999,999,999 inclusive.
3529 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3530 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3531 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3532 },
3533 &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
3534 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
3535 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
3536 # greater than that of `maxTtl`. When the `cacheMode` is set to
3537 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
3538 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
3539 # accessed objects may be evicted from the cache before the defined TTL. If
3540 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
3541 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
3542 # `USE_ORIGIN_HEADERS`.
3543 # as a count of seconds and fractions of seconds at nanosecond
3544 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3545 # or &quot;month&quot;. Range is approximately 10,000 years.
3546 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3547 # Durations less than one second are represented with a 0
3548 # `seconds` field and a positive `nanos` field. Must be from 0
3549 # to 999,999,999 inclusive.
3550 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3551 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3552 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3553 },
3554 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
3555 # attempt to set a max-age or s-maxage higher than this, or an Expires header
3556 # more than `maxTtl` seconds in the future will be capped at the value of
3557 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
3558 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
3559 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
3560 # Infrequently accessed objects may be evicted from the cache before the
3561 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
3562 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
3563 # mode.
3564 # as a count of seconds and fractions of seconds at nanosecond
3565 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3566 # or &quot;month&quot;. Range is approximately 10,000 years.
3567 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3568 # Durations less than one second are represented with a 0
3569 # `seconds` field and a positive `nanos` field. Must be from 0
3570 # to 999,999,999 inclusive.
3571 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3572 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3573 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3574 },
3575 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
3576 # to apply fine-grained caching for common errors or redirects.
3577 # This can reduce the load on your origin and improve end-user
3578 # experience by reducing response latency.
3579 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
3580 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
3581 # the specified response code that lack any Cache-Control, Expires, or
3582 # Pragma: no-cache directives. When the `cacheMode` is set to
3583 # `FORCE_CACHE_ALL`, negative caching applies to all responses
3584 # with the specified response code, and overrides any caching headers. By
3585 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
3586 #
3587 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
3588 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
3589 # * 405 (Method Not Found), 501 (Not Implemented): 60s
3590 #
3591 # These defaults can be overridden in `negativeCachingPolicy`.
3592 # If not specified, Cloud CDN applies negative caching by default.
3593 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
3594 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
3595 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
3596 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
3597 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
3598 # all response codes that you wish to cache. Cloud CDN will not apply any
3599 # default negative caching when a policy exists.
3600 { # Specify CDN TTLs for response error codes.
3601 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
3602 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
3603 # specified as values, and you cannot specify a status code more than
3604 # once.
3605 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
3606 # corresponding status code.
3607 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
3608 # objects may be evicted from the cache before the defined TTL.
3609 # as a count of seconds and fractions of seconds at nanosecond
3610 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3611 # or &quot;month&quot;. Range is approximately 10,000 years.
3612 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3613 # Durations less than one second are represented with a 0
3614 # `seconds` field and a positive `nanos` field. Must be from 0
3615 # to 999,999,999 inclusive.
3616 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3617 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3618 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3619 },
3620 },
3621 ],
3622 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
3623 # requests into a small number of requests to the origin. If not specified,
3624 # Cloud CDN applies request coalescing by default.
3625 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
3626 # content with the origin, or when an error is encountered when refreshing
3627 # the cache.
3628 # This setting defines the default &quot;max-stale&quot; duration for any cached
3629 # responses that do not specify a max-stale directive. Stale responses that
3630 # exceed the TTL configured here will not be served. The default limit
3631 # (max-stale) is 86400s (1 day), which will allow stale content to be
3632 # served up to this limit beyond the max-age (or s-maxage) of a cached
3633 # response.
3634 # The maximum allowed value is 604800 (1 week).
3635 # Set this to zero (0) to disable serve-while-stale.
3636 # as a count of seconds and fractions of seconds at nanosecond
3637 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3638 # or &quot;month&quot;. Range is approximately 10,000 years.
3639 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3640 # Durations less than one second are represented with a 0
3641 # `seconds` field and a positive `nanos` field. Must be from 0
3642 # to 999,999,999 inclusive.
3643 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3644 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3645 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3646 },
3647 },
3648 &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
3649 # information about the W3C recommendation for cross-origin resource sharing
3650 # (CORS), see Fetch API Living
3651 # Standard.
3652 #
3653 # Not supported when the URL map is bound to a target gRPC proxy.
3654 # information about the W3C recommendation for cross-origin resource sharing
3655 # (CORS), see Fetch API Living
3656 # Standard.
3657 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
3658 # indicates that
3659 # the actual request can include user credentials. This field translates to
3660 # the Access-Control-Allow-Credentials header.
3661 #
3662 # Default is false.
3663 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
3664 # header.
3665 &quot;A String&quot;,
3666 ],
3667 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
3668 # header.
3669 &quot;A String&quot;,
3670 ],
3671 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
3672 # more information, see regular expression syntax.
3673 #
3674 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
3675 #
3676 # Regular expressions can only be used when the loadBalancingScheme is
3677 # set to INTERNAL_SELF_MANAGED.
3678 &quot;A String&quot;,
3679 ],
3680 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
3681 #
3682 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
3683 &quot;A String&quot;,
3684 ],
3685 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
3686 # The default value is false, which indicates that the CORS
3687 # policy is in effect.
3688 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
3689 # header.
3690 &quot;A String&quot;,
3691 ],
3692 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
3693 # seconds. This field translates to the Access-Control-Max-Age
3694 # header.
3695 },
3696 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
3697 # the resiliency of clients to backend service failure. As part of fault
3698 # injection, when clients send requests to a backend service, delays can be
3699 # introduced by a load balancer on a percentage of requests before sending
3700 # those requests to the backend service. Similarly requests from clients can
3701 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
3702 # that are configured with a fault_injection_policy if:
3703 # 1. The traffic is generated by fault injection AND
3704 # 2. The fault injection is not a delay fault injection.
3705 # Fault injection is not supported with the classic Application Load Balancer
3706 # . To see which load balancers support fault injection,
3707 # see Load
3708 # balancing: Routing and traffic management features.
3709 # the resiliency of clients to backend service failure. As part of fault
3710 # injection, when clients send requests to a backend service, delays can be
3711 # introduced by the load balancer on a percentage of requests before sending
3712 # those request to the backend service. Similarly requests from clients can be
3713 # aborted by the load balancer for a percentage of requests.
3714 &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
3715 # injection.
3716 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
3717 #
3718 # The value must be from 200 to 599 inclusive.
3719 #
3720 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
3721 # according to this
3722 # mapping table. HTTP status 200 is mapped to gRPC status
3723 # UNKNOWN. Injecting an OK status is currently not supported by
3724 # Traffic Director.
3725 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
3726 # that is aborted as part of fault injection.
3727 #
3728 # The value must be from 0.0 to 100.0 inclusive.
3729 },
3730 &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
3731 # injection, before being sent to a backend service.
3732 # request to the backend service as part of fault injection.
3733 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
3734 # as a count of seconds and fractions of seconds at nanosecond
3735 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3736 # or &quot;month&quot;. Range is approximately 10,000 years.
3737 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3738 # Durations less than one second are represented with a 0
3739 # `seconds` field and a positive `nanos` field. Must be from 0
3740 # to 999,999,999 inclusive.
3741 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3742 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3743 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3744 },
3745 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
3746 # which a delay is introduced as part of fault injection.
3747 #
3748 # The value must be from 0.0 to 100.0 inclusive.
3749 },
3750 },
3751 &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
3752 # Global EXTERNAL_MANAGED load balancer schemes.
3753 # Either Cloud CDN must be enabled on the backend service or backend bucket
3754 # serving the route, or cache policy must be configured on the same route
3755 # dynamically processes and delivers images from the network edge.
3756 # Image Optimization is only available for Global External Application Load
3757 # Balancers.
3758 # Either Cloud CDN must be enabled on the backend service or backend bucket
3759 # serving the route, or cache policy must be configured on the same route.
3760 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
3761 },
3762 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
3763 # Unlike the timeout field where the timeout duration starts
3764 # from the time the request has been fully processed (known as*end-of-stream*),
3765 # the duration in this field is computed from the beginning of the stream
3766 # until the response has been processed, including all retries. A
3767 # stream that does not complete in this duration is closed.
3768 #
3769 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
3770 # with the route.
3771 #
3772 # This field is only allowed if the Url map is used with backend services
3773 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
3774 # as a count of seconds and fractions of seconds at nanosecond
3775 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3776 # or &quot;month&quot;. Range is approximately 10,000 years.
3777 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3778 # Durations less than one second are represented with a 0
3779 # `seconds` field and a positive `nanos` field. Must be from 0
3780 # to 999,999,999 inclusive.
3781 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3782 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3783 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3784 },
3785 &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
3786 # are shadowed to a separate mirrored backend service. The load balancer does
3787 # not wait for responses from the shadow service. Before sending traffic
3788 # to the shadow service, the host / authority header is suffixed with-shadow.
3789 #
3790 # Not supported when the URL map is bound to a target gRPC proxy that
3791 # has the validateForProxyless field set to true.
3792 # are shadowed to a separate mirrored backend service. The load balancer
3793 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
3794 # to the shadow service, the host or authority header is suffixed with-shadow.
3795 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
3796 # mirrored to.
3797 #
3798 # The backend service configured for a mirroring
3799 # policy must reference backends that are of the same type as the original
3800 # backend service matched in the URL map.
3801 #
3802 # Serverless NEG backends are not currently supported as a mirrored
3803 # backend service.
3804 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
3805 },
3806 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
3807 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
3808 # If not specified, defaults to 1.
3809 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
3810 #
3811 # If not specified, will use the timeout set in theHttpRouteAction field.
3812 # If timeout in the HttpRouteAction field is not set, this field
3813 # uses the largest timeout
3814 # among all backend services associated with the route.
3815 #
3816 # Not supported when the URL map is bound to a target gRPC proxy that
3817 # has the validateForProxyless field set to true.
3818 # as a count of seconds and fractions of seconds at nanosecond
3819 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3820 # or &quot;month&quot;. Range is approximately 10,000 years.
3821 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3822 # Durations less than one second are represented with a 0
3823 # `seconds` field and a positive `nanos` field. Must be from 0
3824 # to 999,999,999 inclusive.
3825 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3826 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3827 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3828 },
3829 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
3830 # values are:
3831 #
3832 # - 5xx: retry is attempted if the instance or endpoint
3833 # responds with any 5xx response code, or if the instance or
3834 # endpoint does not respond at all. For example, disconnects, reset, read
3835 # timeout, connection failure, and refused streams.
3836 # - gateway-error: Similar to 5xx, but only
3837 # applies to response codes 502, 503 or504.
3838 # - connect-failure: a retry is attempted on failures
3839 # connecting to the instance or endpoint. For example, connection
3840 # timeouts.
3841 # - retriable-4xx: a retry is attempted if the instance
3842 # or endpoint responds with a 4xx response code.
3843 # The only error that you can retry is error code 409.
3844 # - refused-stream: a retry is attempted if the instance
3845 # or endpoint resets the stream with a REFUSED_STREAM error
3846 # code. This reset type indicates that it is safe to retry.
3847 # - cancelled: a retry is attempted if the gRPC status
3848 # code in the response header is set to cancelled.
3849 # - deadline-exceeded: a retry is attempted if the gRPC
3850 # status code in the response header is set todeadline-exceeded.
3851 # - internal: a retry is attempted if the gRPC
3852 # status code in the response header is set tointernal.
3853 # - resource-exhausted: a retry is attempted if the gRPC
3854 # status code in the response header is set toresource-exhausted.
3855 # - unavailable: a retry is attempted if the gRPC
3856 # status code in the response header is set tounavailable.
3857 #
3858 # Only the following codes are supported when the URL map is bound to
3859 # target gRPC proxy that has validateForProxyless field set to true.
3860 #
3861 # - cancelled
3862 # - deadline-exceeded
3863 # - internal
3864 # - resource-exhausted
3865 # - unavailable
3866 &quot;A String&quot;,
3867 ],
3868 },
3869 &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
3870 # time the request has been fully processed (known as *end-of-stream*)
3871 # up until the response has been processed. Timeout includes
3872 # all retries.
3873 #
3874 # If not specified, this field uses the largest timeout among all backend
3875 # services associated with the route.
3876 #
3877 # Not supported when the URL map is bound to a target gRPC proxy that
3878 # has validateForProxyless field set to true.
3879 # as a count of seconds and fractions of seconds at nanosecond
3880 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3881 # or &quot;month&quot;. Range is approximately 10,000 years.
3882 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3883 # Durations less than one second are represented with a 0
3884 # `seconds` field and a positive `nanos` field. Must be from 0
3885 # to 999,999,999 inclusive.
3886 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3887 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3888 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3889 },
3890 &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
3891 # to the matched service.
3892 #
3893 # urlRewrite is the only action supported in UrlMaps
3894 # for classic Application Load Balancers.
3895 #
3896 # Not supported when the URL map is bound to a target gRPC proxy that
3897 # has the validateForProxyless field set to true.
3898 # backend service.
3899 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
3900 # host header is replaced with contents of hostRewrite.
3901 #
3902 # The value must be from 1 to 255 characters.
3903 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
3904 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
3905 #
3906 # The value must be from 1 to 1024 characters.
3907 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
3908 # header) using the HTTP template syntax.
3909 #
3910 # A corresponding
3911 # path_template_match must be specified. Any template variables must exist in
3912 # the path_template_match field.
3913 #
3914 #
3915 # - -At least one variable must be specified in the path_template_match
3916 # field
3917 # - You can omit variables from the rewritten URL
3918 # - The * and ** operators cannot be matched
3919 # unless they have a corresponding variable name - e.g.
3920 # {format=*} or {var=**}.
3921 #
3922 # For example, a path_template_match of /static/{format=**}
3923 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
3924 # rewrite, so that /{country}/{format}/{suffix=**} can be
3925 # rewritten as /content/{format}/{country}/{suffix}.
3926 #
3927 # At least
3928 # one non-empty routeRules[].matchRules[].path_template_match is
3929 # required.
3930 #
3931 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
3932 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
3933 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
3934 # It uses RE2 syntax with the following constraints:
3935 #
3936 #
3937 # - Any single character operators
3938 # - Groups are allowed to have only submatch operator inside
3939 # - Groups are allowed only without any char repetition, e.g.
3940 # .*
3941 # - Any char repetition, e.g. .*, is
3942 # only allowed to be used in a single regex together with:
3943 #
3944 #
3945 # - Empty string operators
3946 # - Other repetitions
3947 # - Ranges
3948 # - Repetitions of ranges
3949 #
3950 #
3951 # - Ranges are only allowed to have:
3952 #
3953 #
3954 # - Character range
3955 # - Digits range
3956 # - Symbols listed in characters allowed for ranges
3957 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
3958 # the path.
3959 },
3960 },
3961 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
3962 # occurs. The weights determine the fraction of traffic that flows to
3963 # their corresponding backend service. If all traffic needs to
3964 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
3965 #
3966 # After a backend service is identified and before forwarding
3967 # the request to
3968 # the backend service, advanced routing actions such as URL rewrites and
3969 # header transformations are applied depending on additional settings
3970 # specified in this HttpRouteAction.
3971 { # In contrast to a single BackendService in
3972 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
3973 # multiple backend services. The volume of traffic for each
3974 # backend service is proportional to the weight specified
3975 # in each WeightedBackendService
3976 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
3977 # resource. Before
3978 # forwarding the request to backendService, the load balancer
3979 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
3980 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
3981 # effect for the selected backendService.
3982 #
3983 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
3984 #
3985 # headerAction is not supported for load balancers that have
3986 # their loadBalancingScheme set to EXTERNAL.
3987 #
3988 # Not supported when the URL map is bound to a target gRPC proxy that
3989 # has validateForProxyless field set to true.
3990 # the request is passed along to the selected backendService.
3991 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
3992 { # Specification determining how headers are added to requests or responses.
3993 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
3994 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
3995 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
3996 # that already
3997 # exist for the header. If true, headerValue is set for the
3998 # header, discarding any values that were set for that header.
3999 #
4000 # The default value is true,
4001 # unless a variable is present in headerValue,
4002 # in which case the default value is false.
4003 # .
4004 },
4005 ],
4006 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
4007 # request before forwarding the request to the backendService.
4008 &quot;A String&quot;,
4009 ],
4010 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
4011 # client.
4012 { # Specification determining how headers are added to requests or responses.
4013 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
4014 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
4015 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
4016 # that already
4017 # exist for the header. If true, headerValue is set for the
4018 # header, discarding any values that were set for that header.
4019 #
4020 # The default value is true,
4021 # unless a variable is present in headerValue,
4022 # in which case the default value is false.
4023 # .
4024 },
4025 ],
4026 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
4027 # response before sending the response back to the client.
4028 &quot;A String&quot;,
4029 ],
4030 },
4031 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
4032 # computed asweight / (sum of all weightedBackendService weights in routeAction).
4033 #
4034 # The selection of a backend service is determined only for new traffic.
4035 # Once a user&#x27;s request has been directed to a backend service,
4036 # subsequent requests are sent to the same backend service as
4037 # determined by the backend service&#x27;s session affinity policy.
4038 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
4039 # splitting. If you do, the weighted traffic splitting configuration takes
4040 # precedence.
4041 #
4042 # The value must be from 0 to 1000.
4043 },
4044 ],
4045 },
4046 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
4047 # is directed if this rule is matched. If routeAction is
4048 # also specified, advanced routing actions, such as URL rewrites,
4049 # take effect before sending the request to the backend.
4050 #
4051 #
4052 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
4053 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
4054 # specified by urlRedirect.
4055 #
4056 #
4057 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
4058 #
4059 #
4060 # Not supported when the URL map is bound to a target gRPC proxy.
4061 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
4062 # was supplied in the request.
4063 #
4064 # The value must be from 1 to 255
4065 # characters.
4066 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
4067 # set to HTTPS.
4068 # If set to false, the URL scheme of the redirected request
4069 # remains the same as that of the request.
4070 #
4071 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
4072 #
4073 # The default is set to false.
4074 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
4075 # that was supplied in the request.
4076 #
4077 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
4078 # supplied, the path of the original request is used for the redirect.
4079 #
4080 # The value must be from 1 to 1024 characters.
4081 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
4082 # the HttpRouteRuleMatch, retaining the remaining portion
4083 # of the URL before redirecting the request.
4084 #
4085 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
4086 # supplied, the path of the original request is used for the redirect.
4087 #
4088 # The value must be from 1 to 1024 characters.
4089 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
4090 #
4091 # Supported values are:
4092 #
4093 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
4094 # to 301.
4095 # - FOUND, which corresponds to 302.
4096 # - SEE_OTHER which corresponds to 303.
4097 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
4098 # method is retained.
4099 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
4100 # method is retained.
4101 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
4102 # URL is
4103 # removed before redirecting the request. If set to false, the
4104 # query portion of the original URL is retained.
4105 #
4106 # The default is set to false.
4107 },
4108 },
4109 ],
4110 },
4111 ],
4112 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the regional URL map resides.
4113 # This field is not applicable to global URL maps.
4114 # You must specify this field as part of the HTTP request URL. It is
4115 # not settable as a field in the request body.
4116 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
4117 &quot;status&quot;: { # [Output Only] The status of the URL map. # Output only. [Output Only] The status of the URL map.
4118 &quot;quotaUsage&quot;: { # Message representing the quota usage for a UrlMap. # Output only. Summary of quota usage for given UrlMap.
4119 &quot;forwardingRules&quot;: 42, # Output only. The number of forwarding rules that uses this UrlMap.
4120 &quot;units&quot;: &quot;A String&quot;, # Output only. The number of quota units calculated for this UrlMap.
4121 },
4122 },
4123 &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
4124 # maximum of 100 tests per UrlMap.
4125 #
4126 # Not supported when the URL map is bound to a target gRPC proxy that
4127 # has validateForProxyless field set to true.
4128 { # Message for the expected URL mappings.
4129 &quot;backendServiceWeight&quot;: 42, # The weight to use for the supplied host and path when using advanced
4130 # routing rules that involve traffic splitting.
4131 &quot;description&quot;: &quot;A String&quot;, # Description of this test case.
4132 &quot;expectedOutputUrl&quot;: &quot;A String&quot;, # The expected output URL evaluated by the load balancer
4133 # containing the scheme, host, path and query parameters.
4134 #
4135 # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
4136 # the load balancer to backends. For rules with urlRewrite,
4137 # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
4138 #
4139 # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer&#x27;s
4140 # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
4141 # If urlRedirect specifies strip_query, the test
4142 # passes only if expectedOutputUrl does not contain any query
4143 # parameters.
4144 #
4145 # expectedOutputUrl is optional whenservice is specified.
4146 &quot;expectedRedirectResponseCode&quot;: 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
4147 # load balancer&#x27;s redirect response.
4148 #
4149 # expectedRedirectResponseCode cannot be set whenservice is set.
4150 &quot;expectedUrlRedirect&quot;: &quot;A String&quot;, # The expected URL that should be redirected to for the host and path
4151 # being tested.
4152 # [Deprecated] This field is deprecated.
4153 # Use expected_output_url instead.
4154 &quot;headers&quot;: [ # HTTP headers for this request. If headers contains
4155 # a host header, then host must also match the header value.
4156 { # HTTP headers used in UrlMapTests.
4157 &quot;name&quot;: &quot;A String&quot;, # Header name.
4158 &quot;value&quot;: &quot;A String&quot;, # Header value.
4159 },
4160 ],
4161 &quot;host&quot;: &quot;A String&quot;, # Host portion of the URL. If headers contains a host header,
4162 # then host must also match the header value.
4163 &quot;path&quot;: &quot;A String&quot;, # Path portion of the URL.
4164 &quot;service&quot;: &quot;A String&quot;, # Expected BackendService or BackendBucket resource
4165 # the given URL should be mapped to.
4166 #
4167 # The service field cannot
4168 # be set if expectedRedirectResponseCode is set.
4169 },
4170 ],
4171 }</pre>
4172 </div>
4173
4174 <div class="method">
4175 <code class="details" id="insert">insert(project, region, body=None, requestId=None, x__xgafv=None)</code>
4176 <pre>Creates a UrlMap resource in the specified project using
4177 the data included in the request.
4178
4179 Args:
4180 project: string, Project ID for this request. (required)
4181 region: string, Name of the region scoping this request. (required)
4182 body: object, The request body.
4183 The object takes the form of:
4184
4185 { # Represents a URL Map resource.
4186 #
4187 # Compute Engine has two URL Map resources:
4188 #
4189 # * [Global](/compute/docs/reference/rest/alpha/urlMaps)
4190 # * [Regional](/compute/docs/reference/rest/alpha/regionUrlMaps)
4191 #
4192 # A URL map resource is a component of certain types of cloud load balancers
4193 # and Traffic Director:
4194 #
4195 # * urlMaps are used by global external Application Load
4196 # Balancers, classic Application Load Balancers, and cross-region internal
4197 # Application Load Balancers.
4198 # * regionUrlMaps are used by internal Application Load Balancers,
4199 # regional external Application Load Balancers and regional internal
4200 # Application Load Balancers.
4201 #
4202 # For a list of supported URL map features by the load balancer type, see the
4203 # Load balancing features: Routing and traffic management table.
4204 #
4205 # For a list of supported URL map features for Traffic Director, see the
4206 # Traffic Director features: Routing and traffic management table.
4207 #
4208 # This resource defines mappings from hostnames and URL paths to either a
4209 # backend service or a backend bucket.
4210 #
4211 # To use the global urlMaps resource, the backend service must
4212 # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
4213 # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
4214 # information, read URL
4215 # Map Concepts.
4216 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
4217 # text format.
4218 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
4219 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
4220 #
4221 # This policy takes
4222 # effect at the load balancer level and applies only when no policy has been
4223 # defined for the error code at lower levels like PathMatcher, RouteRule and
4224 # PathRule within this UrlMap.
4225 #
4226 # For example, consider a UrlMap with the
4227 # following configuration:
4228 #
4229 #
4230 # - defaultCustomErrorResponsePolicy containing policies for
4231 # responding to 5xx and 4xx errors
4232 # - A PathMatcher configured for *.example.com has
4233 # defaultCustomErrorResponsePolicy for 4xx.
4234 #
4235 # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
4236 # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
4237 # a request that does not match any host in *.example.com such
4238 # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
4239 # takes effect.
4240 #
4241 # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
4242 # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
4243 # a retry, if load balancer is successful in reaching the
4244 # service, the defaultCustomErrorResponsePolicy is ignored and
4245 # the response from the service is returned to the client.
4246 #
4247 # defaultCustomErrorResponsePolicy is supported only for
4248 # global external Application Load Balancers.
4249 # backend service or backend bucket responds with an error.
4250 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
4251 #
4252 # In a given policy, if you specify rules for both a range of error codes
4253 # as well as rules for specific error codes then rules with specific error
4254 # codes have a higher priority. For example, assume that you configure a rule
4255 # for 401 (Un-authorized) code, and another for all 4 series
4256 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
4257 # However if the backend service returns a 403, the rule for4xx takes effect.
4258 { # Specifies the mapping between the response code that will be returned along
4259 # with the custom error content and the response code returned by the backend
4260 # service.
4261 &quot;matchResponseCodes&quot;: [ # Valid values include:
4262 #
4263 #
4264 # - A number between 400 and 599: For example
4265 # 401 or 503, in which case the load balancer
4266 # applies the policy if the error code exactly matches this value.
4267 # - 5xx: Load Balancer will apply the policy if the
4268 # backend service responds with any response code in the range of
4269 # 500 to 599.
4270 # - 4xx: Load
4271 # Balancer will apply the policy if the backend service responds with any
4272 # response code in the range of 400 to
4273 # 499.
4274 #
4275 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
4276 &quot;A String&quot;,
4277 ],
4278 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
4279 # error content. If overrideResponseCode is not supplied, the
4280 # same response code returned by the original backend bucket or backend
4281 # service is returned to the client.
4282 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
4283 #
4284 # path must start
4285 # with a leading slash. path cannot have trailing slashes.
4286 #
4287 # If the file is not available in backendBucket or the
4288 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
4289 #
4290 # The value must
4291 # be from 1 to 1024 characters
4292 },
4293 ],
4294 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
4295 # contains the custom error content. Examples are:
4296 #
4297 #
4298 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
4299 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
4300 # - global/backendBuckets/myBackendBucket
4301 #
4302 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
4303 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
4304 #
4305 # If load balancer cannot reach
4306 # the backendBucket, a simple Not Found Error will
4307 # be returned, with the original response code (oroverrideResponseCode if configured).
4308 #
4309 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
4310 },
4311 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
4312 # hostRules match. The load balancer performs advanced routing
4313 # actions, such as URL rewrites and header transformations, before forwarding
4314 # the request to the selected backend.
4315 #
4316 #
4317 # Only one of defaultUrlRedirect, defaultService
4318 # or defaultRouteAction.weightedBackendService can be set.
4319 #
4320 #
4321 # URL maps for classic Application Load Balancers only support
4322 # the urlRewrite action within defaultRouteAction.
4323 #
4324 #
4325 # defaultRouteAction has no effect when the URL map is bound
4326 # to a target gRPC proxy that has the validateForProxyless field
4327 # set to true.
4328 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
4329 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
4330 # property must be specified. This policy cannot be specified if any target
4331 # backend has Identity-Aware Proxy enabled.
4332 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
4333 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
4334 # header names can be specified. The cache is bypassed for all `cacheMode`
4335 # values.
4336 &quot;A String&quot;,
4337 ],
4338 &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
4339 # on the backend type: for Backend Services, the complete request URI is
4340 # used; for Backend Buckets, the request URI is used without the protocol or
4341 # host, and only query parameters known to Cloud Storage are included.
4342 # Policy defined on Route Action.
4343 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
4344 # parameters will be included. Either specify `excludedQueryParameters`
4345 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
4346 # encoded and not treated as delimiters.
4347 #
4348 # Note: This field applies to routes that use backend services. Attempting
4349 # to set it on a route that points exclusively to Backend Buckets will
4350 # result in a configuration error. For routes that point to a Backend
4351 # Bucket, use `includedQueryParameters` to define which parameters should
4352 # be part of the cache key.
4353 &quot;A String&quot;,
4354 ],
4355 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
4356 #
4357 # Note: This setting is only applicable to routes that use a Backend
4358 # Service. It does not affect requests served by a Backend Bucket, as the
4359 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
4360 # it on a route that points exclusively to Backend Buckets will result in a
4361 # configuration error.
4362 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
4363 #
4364 # Note: This setting is only applicable to routes that use a Backend
4365 # Service. It does not affect requests served by a Backend Bucket, as the
4366 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
4367 # set on a route that points exclusively to Backend Buckets will result in
4368 # a configuration error.
4369 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
4370 # `includedQueryParameters` and `excludedQueryParameters`. If neither
4371 # is set, the entire query string will be included. If false, the query
4372 # string will be excluded from the cache key entirely.
4373 #
4374 # Note: This field applies to routes that use backend services. Attempting
4375 # to set it on a route that points exclusively to Backend Buckets will
4376 # result in a configuration error. For routes that point to a Backend
4377 # Bucket, use `includedQueryParameters` to define which parameters should
4378 # be part of the cache key.
4379 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
4380 # The name=value pair will be used in the cache key Cloud CDN generates.
4381 #
4382 # Note: This setting is only applicable to routes that use a Backend
4383 # Service. It does not affect requests served by a Backend Bucket.
4384 # Attempting to set it on a route that points exclusively to Backend
4385 # Buckets will result in a configuration error. Up to 5 cookie names can be
4386 # specified.
4387 &quot;A String&quot;,
4388 ],
4389 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
4390 &quot;A String&quot;,
4391 ],
4392 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
4393 # parameters will be excluded. Either specify `includedQueryParameters`
4394 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
4395 # encoded and not treated as delimiters.
4396 &quot;A String&quot;,
4397 ],
4398 },
4399 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
4400 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
4401 &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
4402 # content. This is used to clamp the max-age (or Expires) value sent to the
4403 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
4404 # is used for the response max-age directive, along with a &quot;public&quot;
4405 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
4406 # clamps the max-age from the origin (if specified), or else sets the
4407 # response max-age directive to the lesser of the `clientTtl` and
4408 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
4409 # present. The maximum allowed value is 31,622,400s (1 year). If not
4410 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
4411 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
4412 # `USE_ORIGIN_HEADERS`.
4413 # as a count of seconds and fractions of seconds at nanosecond
4414 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4415 # or &quot;month&quot;. Range is approximately 10,000 years.
4416 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4417 # Durations less than one second are represented with a 0
4418 # `seconds` field and a positive `nanos` field. Must be from 0
4419 # to 999,999,999 inclusive.
4420 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4421 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4422 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4423 },
4424 &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
4425 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
4426 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
4427 # greater than that of `maxTtl`. When the `cacheMode` is set to
4428 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
4429 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
4430 # accessed objects may be evicted from the cache before the defined TTL. If
4431 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
4432 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
4433 # `USE_ORIGIN_HEADERS`.
4434 # as a count of seconds and fractions of seconds at nanosecond
4435 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4436 # or &quot;month&quot;. Range is approximately 10,000 years.
4437 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4438 # Durations less than one second are represented with a 0
4439 # `seconds` field and a positive `nanos` field. Must be from 0
4440 # to 999,999,999 inclusive.
4441 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4442 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4443 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4444 },
4445 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
4446 # attempt to set a max-age or s-maxage higher than this, or an Expires header
4447 # more than `maxTtl` seconds in the future will be capped at the value of
4448 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
4449 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
4450 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
4451 # Infrequently accessed objects may be evicted from the cache before the
4452 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
4453 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
4454 # mode.
4455 # as a count of seconds and fractions of seconds at nanosecond
4456 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4457 # or &quot;month&quot;. Range is approximately 10,000 years.
4458 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4459 # Durations less than one second are represented with a 0
4460 # `seconds` field and a positive `nanos` field. Must be from 0
4461 # to 999,999,999 inclusive.
4462 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4463 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4464 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4465 },
4466 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
4467 # to apply fine-grained caching for common errors or redirects.
4468 # This can reduce the load on your origin and improve end-user
4469 # experience by reducing response latency.
4470 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
4471 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
4472 # the specified response code that lack any Cache-Control, Expires, or
4473 # Pragma: no-cache directives. When the `cacheMode` is set to
4474 # `FORCE_CACHE_ALL`, negative caching applies to all responses
4475 # with the specified response code, and overrides any caching headers. By
4476 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
4477 #
4478 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
4479 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
4480 # * 405 (Method Not Found), 501 (Not Implemented): 60s
4481 #
4482 # These defaults can be overridden in `negativeCachingPolicy`.
4483 # If not specified, Cloud CDN applies negative caching by default.
4484 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
4485 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
4486 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
4487 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
4488 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
4489 # all response codes that you wish to cache. Cloud CDN will not apply any
4490 # default negative caching when a policy exists.
4491 { # Specify CDN TTLs for response error codes.
4492 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
4493 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
4494 # specified as values, and you cannot specify a status code more than
4495 # once.
4496 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
4497 # corresponding status code.
4498 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
4499 # objects may be evicted from the cache before the defined TTL.
4500 # as a count of seconds and fractions of seconds at nanosecond
4501 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4502 # or &quot;month&quot;. Range is approximately 10,000 years.
4503 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4504 # Durations less than one second are represented with a 0
4505 # `seconds` field and a positive `nanos` field. Must be from 0
4506 # to 999,999,999 inclusive.
4507 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4508 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4509 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4510 },
4511 },
4512 ],
4513 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
4514 # requests into a small number of requests to the origin. If not specified,
4515 # Cloud CDN applies request coalescing by default.
4516 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
4517 # content with the origin, or when an error is encountered when refreshing
4518 # the cache.
4519 # This setting defines the default &quot;max-stale&quot; duration for any cached
4520 # responses that do not specify a max-stale directive. Stale responses that
4521 # exceed the TTL configured here will not be served. The default limit
4522 # (max-stale) is 86400s (1 day), which will allow stale content to be
4523 # served up to this limit beyond the max-age (or s-maxage) of a cached
4524 # response.
4525 # The maximum allowed value is 604800 (1 week).
4526 # Set this to zero (0) to disable serve-while-stale.
4527 # as a count of seconds and fractions of seconds at nanosecond
4528 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4529 # or &quot;month&quot;. Range is approximately 10,000 years.
4530 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4531 # Durations less than one second are represented with a 0
4532 # `seconds` field and a positive `nanos` field. Must be from 0
4533 # to 999,999,999 inclusive.
4534 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4535 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4536 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4537 },
4538 },
4539 &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
4540 # information about the W3C recommendation for cross-origin resource sharing
4541 # (CORS), see Fetch API Living
4542 # Standard.
4543 #
4544 # Not supported when the URL map is bound to a target gRPC proxy.
4545 # information about the W3C recommendation for cross-origin resource sharing
4546 # (CORS), see Fetch API Living
4547 # Standard.
4548 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
4549 # indicates that
4550 # the actual request can include user credentials. This field translates to
4551 # the Access-Control-Allow-Credentials header.
4552 #
4553 # Default is false.
4554 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
4555 # header.
4556 &quot;A String&quot;,
4557 ],
4558 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
4559 # header.
4560 &quot;A String&quot;,
4561 ],
4562 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
4563 # more information, see regular expression syntax.
4564 #
4565 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
4566 #
4567 # Regular expressions can only be used when the loadBalancingScheme is
4568 # set to INTERNAL_SELF_MANAGED.
4569 &quot;A String&quot;,
4570 ],
4571 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
4572 #
4573 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
4574 &quot;A String&quot;,
4575 ],
4576 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
4577 # The default value is false, which indicates that the CORS
4578 # policy is in effect.
4579 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
4580 # header.
4581 &quot;A String&quot;,
4582 ],
4583 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
4584 # seconds. This field translates to the Access-Control-Max-Age
4585 # header.
4586 },
4587 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
4588 # the resiliency of clients to backend service failure. As part of fault
4589 # injection, when clients send requests to a backend service, delays can be
4590 # introduced by a load balancer on a percentage of requests before sending
4591 # those requests to the backend service. Similarly requests from clients can
4592 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
4593 # that are configured with a fault_injection_policy if:
4594 # 1. The traffic is generated by fault injection AND
4595 # 2. The fault injection is not a delay fault injection.
4596 # Fault injection is not supported with the classic Application Load Balancer
4597 # . To see which load balancers support fault injection,
4598 # see Load
4599 # balancing: Routing and traffic management features.
4600 # the resiliency of clients to backend service failure. As part of fault
4601 # injection, when clients send requests to a backend service, delays can be
4602 # introduced by the load balancer on a percentage of requests before sending
4603 # those request to the backend service. Similarly requests from clients can be
4604 # aborted by the load balancer for a percentage of requests.
4605 &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
4606 # injection.
4607 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
4608 #
4609 # The value must be from 200 to 599 inclusive.
4610 #
4611 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
4612 # according to this
4613 # mapping table. HTTP status 200 is mapped to gRPC status
4614 # UNKNOWN. Injecting an OK status is currently not supported by
4615 # Traffic Director.
4616 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
4617 # that is aborted as part of fault injection.
4618 #
4619 # The value must be from 0.0 to 100.0 inclusive.
4620 },
4621 &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
4622 # injection, before being sent to a backend service.
4623 # request to the backend service as part of fault injection.
4624 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
4625 # as a count of seconds and fractions of seconds at nanosecond
4626 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4627 # or &quot;month&quot;. Range is approximately 10,000 years.
4628 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4629 # Durations less than one second are represented with a 0
4630 # `seconds` field and a positive `nanos` field. Must be from 0
4631 # to 999,999,999 inclusive.
4632 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4633 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4634 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4635 },
4636 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
4637 # which a delay is introduced as part of fault injection.
4638 #
4639 # The value must be from 0.0 to 100.0 inclusive.
4640 },
4641 },
4642 &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
4643 # Global EXTERNAL_MANAGED load balancer schemes.
4644 # Either Cloud CDN must be enabled on the backend service or backend bucket
4645 # serving the route, or cache policy must be configured on the same route
4646 # dynamically processes and delivers images from the network edge.
4647 # Image Optimization is only available for Global External Application Load
4648 # Balancers.
4649 # Either Cloud CDN must be enabled on the backend service or backend bucket
4650 # serving the route, or cache policy must be configured on the same route.
4651 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
4652 },
4653 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
4654 # Unlike the timeout field where the timeout duration starts
4655 # from the time the request has been fully processed (known as*end-of-stream*),
4656 # the duration in this field is computed from the beginning of the stream
4657 # until the response has been processed, including all retries. A
4658 # stream that does not complete in this duration is closed.
4659 #
4660 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
4661 # with the route.
4662 #
4663 # This field is only allowed if the Url map is used with backend services
4664 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
4665 # as a count of seconds and fractions of seconds at nanosecond
4666 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4667 # or &quot;month&quot;. Range is approximately 10,000 years.
4668 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4669 # Durations less than one second are represented with a 0
4670 # `seconds` field and a positive `nanos` field. Must be from 0
4671 # to 999,999,999 inclusive.
4672 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4673 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4674 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4675 },
4676 &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
4677 # are shadowed to a separate mirrored backend service. The load balancer does
4678 # not wait for responses from the shadow service. Before sending traffic
4679 # to the shadow service, the host / authority header is suffixed with-shadow.
4680 #
4681 # Not supported when the URL map is bound to a target gRPC proxy that
4682 # has the validateForProxyless field set to true.
4683 # are shadowed to a separate mirrored backend service. The load balancer
4684 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
4685 # to the shadow service, the host or authority header is suffixed with-shadow.
4686 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
4687 # mirrored to.
4688 #
4689 # The backend service configured for a mirroring
4690 # policy must reference backends that are of the same type as the original
4691 # backend service matched in the URL map.
4692 #
4693 # Serverless NEG backends are not currently supported as a mirrored
4694 # backend service.
4695 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
4696 },
4697 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
4698 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
4699 # If not specified, defaults to 1.
4700 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
4701 #
4702 # If not specified, will use the timeout set in theHttpRouteAction field.
4703 # If timeout in the HttpRouteAction field is not set, this field
4704 # uses the largest timeout
4705 # among all backend services associated with the route.
4706 #
4707 # Not supported when the URL map is bound to a target gRPC proxy that
4708 # has the validateForProxyless field set to true.
4709 # as a count of seconds and fractions of seconds at nanosecond
4710 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4711 # or &quot;month&quot;. Range is approximately 10,000 years.
4712 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4713 # Durations less than one second are represented with a 0
4714 # `seconds` field and a positive `nanos` field. Must be from 0
4715 # to 999,999,999 inclusive.
4716 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4717 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4718 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4719 },
4720 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
4721 # values are:
4722 #
4723 # - 5xx: retry is attempted if the instance or endpoint
4724 # responds with any 5xx response code, or if the instance or
4725 # endpoint does not respond at all. For example, disconnects, reset, read
4726 # timeout, connection failure, and refused streams.
4727 # - gateway-error: Similar to 5xx, but only
4728 # applies to response codes 502, 503 or504.
4729 # - connect-failure: a retry is attempted on failures
4730 # connecting to the instance or endpoint. For example, connection
4731 # timeouts.
4732 # - retriable-4xx: a retry is attempted if the instance
4733 # or endpoint responds with a 4xx response code.
4734 # The only error that you can retry is error code 409.
4735 # - refused-stream: a retry is attempted if the instance
4736 # or endpoint resets the stream with a REFUSED_STREAM error
4737 # code. This reset type indicates that it is safe to retry.
4738 # - cancelled: a retry is attempted if the gRPC status
4739 # code in the response header is set to cancelled.
4740 # - deadline-exceeded: a retry is attempted if the gRPC
4741 # status code in the response header is set todeadline-exceeded.
4742 # - internal: a retry is attempted if the gRPC
4743 # status code in the response header is set tointernal.
4744 # - resource-exhausted: a retry is attempted if the gRPC
4745 # status code in the response header is set toresource-exhausted.
4746 # - unavailable: a retry is attempted if the gRPC
4747 # status code in the response header is set tounavailable.
4748 #
4749 # Only the following codes are supported when the URL map is bound to
4750 # target gRPC proxy that has validateForProxyless field set to true.
4751 #
4752 # - cancelled
4753 # - deadline-exceeded
4754 # - internal
4755 # - resource-exhausted
4756 # - unavailable
4757 &quot;A String&quot;,
4758 ],
4759 },
4760 &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
4761 # time the request has been fully processed (known as *end-of-stream*)
4762 # up until the response has been processed. Timeout includes
4763 # all retries.
4764 #
4765 # If not specified, this field uses the largest timeout among all backend
4766 # services associated with the route.
4767 #
4768 # Not supported when the URL map is bound to a target gRPC proxy that
4769 # has validateForProxyless field set to true.
4770 # as a count of seconds and fractions of seconds at nanosecond
4771 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4772 # or &quot;month&quot;. Range is approximately 10,000 years.
4773 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4774 # Durations less than one second are represented with a 0
4775 # `seconds` field and a positive `nanos` field. Must be from 0
4776 # to 999,999,999 inclusive.
4777 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4778 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4779 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4780 },
4781 &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
4782 # to the matched service.
4783 #
4784 # urlRewrite is the only action supported in UrlMaps
4785 # for classic Application Load Balancers.
4786 #
4787 # Not supported when the URL map is bound to a target gRPC proxy that
4788 # has the validateForProxyless field set to true.
4789 # backend service.
4790 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
4791 # host header is replaced with contents of hostRewrite.
4792 #
4793 # The value must be from 1 to 255 characters.
4794 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
4795 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
4796 #
4797 # The value must be from 1 to 1024 characters.
4798 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
4799 # header) using the HTTP template syntax.
4800 #
4801 # A corresponding
4802 # path_template_match must be specified. Any template variables must exist in
4803 # the path_template_match field.
4804 #
4805 #
4806 # - -At least one variable must be specified in the path_template_match
4807 # field
4808 # - You can omit variables from the rewritten URL
4809 # - The * and ** operators cannot be matched
4810 # unless they have a corresponding variable name - e.g.
4811 # {format=*} or {var=**}.
4812 #
4813 # For example, a path_template_match of /static/{format=**}
4814 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
4815 # rewrite, so that /{country}/{format}/{suffix=**} can be
4816 # rewritten as /content/{format}/{country}/{suffix}.
4817 #
4818 # At least
4819 # one non-empty routeRules[].matchRules[].path_template_match is
4820 # required.
4821 #
4822 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
4823 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
4824 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
4825 # It uses RE2 syntax with the following constraints:
4826 #
4827 #
4828 # - Any single character operators
4829 # - Groups are allowed to have only submatch operator inside
4830 # - Groups are allowed only without any char repetition, e.g.
4831 # .*
4832 # - Any char repetition, e.g. .*, is
4833 # only allowed to be used in a single regex together with:
4834 #
4835 #
4836 # - Empty string operators
4837 # - Other repetitions
4838 # - Ranges
4839 # - Repetitions of ranges
4840 #
4841 #
4842 # - Ranges are only allowed to have:
4843 #
4844 #
4845 # - Character range
4846 # - Digits range
4847 # - Symbols listed in characters allowed for ranges
4848 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
4849 # the path.
4850 },
4851 },
4852 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
4853 # occurs. The weights determine the fraction of traffic that flows to
4854 # their corresponding backend service. If all traffic needs to
4855 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
4856 #
4857 # After a backend service is identified and before forwarding
4858 # the request to
4859 # the backend service, advanced routing actions such as URL rewrites and
4860 # header transformations are applied depending on additional settings
4861 # specified in this HttpRouteAction.
4862 { # In contrast to a single BackendService in
4863 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
4864 # multiple backend services. The volume of traffic for each
4865 # backend service is proportional to the weight specified
4866 # in each WeightedBackendService
4867 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
4868 # resource. Before
4869 # forwarding the request to backendService, the load balancer
4870 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
4871 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
4872 # effect for the selected backendService.
4873 #
4874 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
4875 #
4876 # headerAction is not supported for load balancers that have
4877 # their loadBalancingScheme set to EXTERNAL.
4878 #
4879 # Not supported when the URL map is bound to a target gRPC proxy that
4880 # has validateForProxyless field set to true.
4881 # the request is passed along to the selected backendService.
4882 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
4883 { # Specification determining how headers are added to requests or responses.
4884 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
4885 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
4886 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
4887 # that already
4888 # exist for the header. If true, headerValue is set for the
4889 # header, discarding any values that were set for that header.
4890 #
4891 # The default value is true,
4892 # unless a variable is present in headerValue,
4893 # in which case the default value is false.
4894 # .
4895 },
4896 ],
4897 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
4898 # request before forwarding the request to the backendService.
4899 &quot;A String&quot;,
4900 ],
4901 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
4902 # client.
4903 { # Specification determining how headers are added to requests or responses.
4904 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
4905 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
4906 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
4907 # that already
4908 # exist for the header. If true, headerValue is set for the
4909 # header, discarding any values that were set for that header.
4910 #
4911 # The default value is true,
4912 # unless a variable is present in headerValue,
4913 # in which case the default value is false.
4914 # .
4915 },
4916 ],
4917 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
4918 # response before sending the response back to the client.
4919 &quot;A String&quot;,
4920 ],
4921 },
4922 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
4923 # computed asweight / (sum of all weightedBackendService weights in routeAction).
4924 #
4925 # The selection of a backend service is determined only for new traffic.
4926 # Once a user&#x27;s request has been directed to a backend service,
4927 # subsequent requests are sent to the same backend service as
4928 # determined by the backend service&#x27;s session affinity policy.
4929 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
4930 # splitting. If you do, the weighted traffic splitting configuration takes
4931 # precedence.
4932 #
4933 # The value must be from 0 to 1000.
4934 },
4935 ],
4936 },
4937 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL of the defaultService resource to
4938 # which traffic is directed if none of the hostRules match.
4939 # If defaultRouteAction is also specified, advanced
4940 # routing actions, such as URL rewrites, take effect before sending the
4941 # request to the backend.
4942 #
4943 #
4944 # Only one of defaultUrlRedirect, defaultService
4945 # or defaultRouteAction.weightedBackendService can be set.
4946 #
4947 #
4948 # defaultService has no effect when the URL map is bound
4949 # to a target gRPC proxy that has the validateForProxyless field
4950 # set to true.
4951 &quot;defaultUrlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
4952 # is redirected to a URL specified by defaultUrlRedirect.
4953 #
4954 #
4955 # Only one of defaultUrlRedirect, defaultService
4956 # or defaultRouteAction.weightedBackendService can be set.
4957 #
4958 #
4959 # Not supported when the URL map is bound to a target gRPC proxy.
4960 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
4961 # was supplied in the request.
4962 #
4963 # The value must be from 1 to 255
4964 # characters.
4965 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
4966 # set to HTTPS.
4967 # If set to false, the URL scheme of the redirected request
4968 # remains the same as that of the request.
4969 #
4970 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
4971 #
4972 # The default is set to false.
4973 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
4974 # that was supplied in the request.
4975 #
4976 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
4977 # supplied, the path of the original request is used for the redirect.
4978 #
4979 # The value must be from 1 to 1024 characters.
4980 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
4981 # the HttpRouteRuleMatch, retaining the remaining portion
4982 # of the URL before redirecting the request.
4983 #
4984 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
4985 # supplied, the path of the original request is used for the redirect.
4986 #
4987 # The value must be from 1 to 1024 characters.
4988 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
4989 #
4990 # Supported values are:
4991 #
4992 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
4993 # to 301.
4994 # - FOUND, which corresponds to 302.
4995 # - SEE_OTHER which corresponds to 303.
4996 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
4997 # method is retained.
4998 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
4999 # method is retained.
5000 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
5001 # URL is
5002 # removed before redirecting the request. If set to false, the
5003 # query portion of the original URL is retained.
5004 #
5005 # The default is set to false.
5006 },
5007 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
5008 # create the resource.
5009 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. A hash of the contents stored in this object.
5010 # This field is used in optimistic locking. This field is ignored when
5011 # inserting a UrlMap. An up-to-date fingerprint must be provided
5012 # in order to update the UrlMap, otherwise the request will
5013 # fail with error 412 conditionNotMet.
5014 #
5015 # To see the latest fingerprint, make a get() request to
5016 # retrieve a UrlMap.
5017 &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
5018 # for the selected backendService.
5019 #
5020 # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
5021 #
5022 # headerAction is not supported for load balancers
5023 # that have
5024 # their loadBalancingScheme set to EXTERNAL.
5025 #
5026 # Not supported when the URL map is bound to a target gRPC proxy that
5027 # has validateForProxyless field set to true.
5028 # the request is passed along to the selected backendService.
5029 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
5030 { # Specification determining how headers are added to requests or responses.
5031 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
5032 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
5033 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
5034 # that already
5035 # exist for the header. If true, headerValue is set for the
5036 # header, discarding any values that were set for that header.
5037 #
5038 # The default value is true,
5039 # unless a variable is present in headerValue,
5040 # in which case the default value is false.
5041 # .
5042 },
5043 ],
5044 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
5045 # request before forwarding the request to the backendService.
5046 &quot;A String&quot;,
5047 ],
5048 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
5049 # client.
5050 { # Specification determining how headers are added to requests or responses.
5051 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
5052 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
5053 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
5054 # that already
5055 # exist for the header. If true, headerValue is set for the
5056 # header, discarding any values that were set for that header.
5057 #
5058 # The default value is true,
5059 # unless a variable is present in headerValue,
5060 # in which case the default value is false.
5061 # .
5062 },
5063 ],
5064 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
5065 # response before sending the response back to the client.
5066 &quot;A String&quot;,
5067 ],
5068 },
5069 &quot;hostRules&quot;: [ # The list of host rules to use against the URL.
5070 { # UrlMaps
5071 # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
5072 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
5073 # create the resource.
5074 &quot;hosts&quot;: [ # The list of host patterns to match. They must be valid hostnames with
5075 # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
5076 # that case, * must be the first character, and if followed by
5077 # anything, the immediate following character must be either -
5078 # or ..
5079 #
5080 # * based matching is not supported when the URL map is bound
5081 # to a target gRPC proxy that has the validateForProxyless field
5082 # set to true.
5083 &quot;A String&quot;,
5084 ],
5085 &quot;pathMatcher&quot;: &quot;A String&quot;, # The name of the PathMatcher to use to match the path portion
5086 # of the URL if the hostRule matches the URL&#x27;s host portion.
5087 },
5088 ],
5089 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the resource. This identifier is
5090 # defined by the server.
5091 &quot;kind&quot;: &quot;compute#urlMap&quot;, # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
5092 # url maps.
5093 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
5094 # The name must be 1-63 characters long, and comply withRFC1035.
5095 # Specifically, the name must be 1-63 characters long and match the regular
5096 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
5097 # character must be a lowercase letter, and all following characters must
5098 # be a dash, lowercase letter, or digit, except the last character, which
5099 # cannot be a dash.
5100 &quot;pathMatchers&quot;: [ # The list of named PathMatchers to use against the URL.
5101 { # A matcher for the path portion of the URL. The BackendService
5102 # from the longest-matched rule will serve the URL. If no rule was matched, the
5103 # default service is used.
5104 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
5105 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
5106 #
5107 # This policy takes
5108 # effect at the PathMatcher level and applies only when no
5109 # 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
5110 # in defaultCustomErrorResponsePolicy, then a policy defined for
5111 # the error code in UrlMap.defaultCustomErrorResponsePolicy
5112 # takes effect.
5113 #
5114 # For example, consider a UrlMap with the following
5115 # configuration:
5116 #
5117 #
5118 # - UrlMap.defaultCustomErrorResponsePolicy is configured
5119 # with policies for 5xx and 4xx errors
5120 # - A RouteRule for /coming_soon/ is configured for the
5121 # error code 404.
5122 #
5123 # 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
5124 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
5125 # the policy in RouteRule.customErrorResponsePolicy takes
5126 # effect. If any of the requests in this example encounter a 500
5127 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
5128 #
5129 # When
5130 # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
5131 # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
5132 # a retry, if load balancer is successful in reaching the
5133 # service, the defaultCustomErrorResponsePolicy is ignored and
5134 # the response from the service is returned to the client.
5135 #
5136 # defaultCustomErrorResponsePolicy is supported only for
5137 # global external Application Load Balancers.
5138 # backend service or backend bucket responds with an error.
5139 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
5140 #
5141 # In a given policy, if you specify rules for both a range of error codes
5142 # as well as rules for specific error codes then rules with specific error
5143 # codes have a higher priority. For example, assume that you configure a rule
5144 # for 401 (Un-authorized) code, and another for all 4 series
5145 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
5146 # However if the backend service returns a 403, the rule for4xx takes effect.
5147 { # Specifies the mapping between the response code that will be returned along
5148 # with the custom error content and the response code returned by the backend
5149 # service.
5150 &quot;matchResponseCodes&quot;: [ # Valid values include:
5151 #
5152 #
5153 # - A number between 400 and 599: For example
5154 # 401 or 503, in which case the load balancer
5155 # applies the policy if the error code exactly matches this value.
5156 # - 5xx: Load Balancer will apply the policy if the
5157 # backend service responds with any response code in the range of
5158 # 500 to 599.
5159 # - 4xx: Load
5160 # Balancer will apply the policy if the backend service responds with any
5161 # response code in the range of 400 to
5162 # 499.
5163 #
5164 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
5165 &quot;A String&quot;,
5166 ],
5167 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
5168 # error content. If overrideResponseCode is not supplied, the
5169 # same response code returned by the original backend bucket or backend
5170 # service is returned to the client.
5171 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
5172 #
5173 # path must start
5174 # with a leading slash. path cannot have trailing slashes.
5175 #
5176 # If the file is not available in backendBucket or the
5177 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
5178 #
5179 # The value must
5180 # be from 1 to 1024 characters
5181 },
5182 ],
5183 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
5184 # contains the custom error content. Examples are:
5185 #
5186 #
5187 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
5188 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
5189 # - global/backendBuckets/myBackendBucket
5190 #
5191 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
5192 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
5193 #
5194 # If load balancer cannot reach
5195 # the backendBucket, a simple Not Found Error will
5196 # be returned, with the original response code (oroverrideResponseCode if configured).
5197 #
5198 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
5199 },
5200 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
5201 # pathRules or routeRules match. The load balancer
5202 # performs advanced routing actions, such as URL rewrites and
5203 # header transformations, before forwarding the request to the
5204 # selected backend.
5205 #
5206 #
5207 # Only one of defaultUrlRedirect, defaultService
5208 # or defaultRouteAction.weightedBackendService can be set.
5209 #
5210 #
5211 # URL maps for classic Application Load Balancers only support
5212 # the urlRewrite action within a path matcher&#x27;sdefaultRouteAction.
5213 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
5214 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
5215 # property must be specified. This policy cannot be specified if any target
5216 # backend has Identity-Aware Proxy enabled.
5217 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
5218 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
5219 # header names can be specified. The cache is bypassed for all `cacheMode`
5220 # values.
5221 &quot;A String&quot;,
5222 ],
5223 &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
5224 # on the backend type: for Backend Services, the complete request URI is
5225 # used; for Backend Buckets, the request URI is used without the protocol or
5226 # host, and only query parameters known to Cloud Storage are included.
5227 # Policy defined on Route Action.
5228 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
5229 # parameters will be included. Either specify `excludedQueryParameters`
5230 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
5231 # encoded and not treated as delimiters.
5232 #
5233 # Note: This field applies to routes that use backend services. Attempting
5234 # to set it on a route that points exclusively to Backend Buckets will
5235 # result in a configuration error. For routes that point to a Backend
5236 # Bucket, use `includedQueryParameters` to define which parameters should
5237 # be part of the cache key.
5238 &quot;A String&quot;,
5239 ],
5240 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
5241 #
5242 # Note: This setting is only applicable to routes that use a Backend
5243 # Service. It does not affect requests served by a Backend Bucket, as the
5244 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
5245 # it on a route that points exclusively to Backend Buckets will result in a
5246 # configuration error.
5247 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
5248 #
5249 # Note: This setting is only applicable to routes that use a Backend
5250 # Service. It does not affect requests served by a Backend Bucket, as the
5251 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
5252 # set on a route that points exclusively to Backend Buckets will result in
5253 # a configuration error.
5254 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
5255 # `includedQueryParameters` and `excludedQueryParameters`. If neither
5256 # is set, the entire query string will be included. If false, the query
5257 # string will be excluded from the cache key entirely.
5258 #
5259 # Note: This field applies to routes that use backend services. Attempting
5260 # to set it on a route that points exclusively to Backend Buckets will
5261 # result in a configuration error. For routes that point to a Backend
5262 # Bucket, use `includedQueryParameters` to define which parameters should
5263 # be part of the cache key.
5264 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
5265 # The name=value pair will be used in the cache key Cloud CDN generates.
5266 #
5267 # Note: This setting is only applicable to routes that use a Backend
5268 # Service. It does not affect requests served by a Backend Bucket.
5269 # Attempting to set it on a route that points exclusively to Backend
5270 # Buckets will result in a configuration error. Up to 5 cookie names can be
5271 # specified.
5272 &quot;A String&quot;,
5273 ],
5274 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
5275 &quot;A String&quot;,
5276 ],
5277 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
5278 # parameters will be excluded. Either specify `includedQueryParameters`
5279 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
5280 # encoded and not treated as delimiters.
5281 &quot;A String&quot;,
5282 ],
5283 },
5284 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
5285 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
5286 &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
5287 # content. This is used to clamp the max-age (or Expires) value sent to the
5288 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
5289 # is used for the response max-age directive, along with a &quot;public&quot;
5290 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
5291 # clamps the max-age from the origin (if specified), or else sets the
5292 # response max-age directive to the lesser of the `clientTtl` and
5293 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
5294 # present. The maximum allowed value is 31,622,400s (1 year). If not
5295 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
5296 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
5297 # `USE_ORIGIN_HEADERS`.
5298 # as a count of seconds and fractions of seconds at nanosecond
5299 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5300 # or &quot;month&quot;. Range is approximately 10,000 years.
5301 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5302 # Durations less than one second are represented with a 0
5303 # `seconds` field and a positive `nanos` field. Must be from 0
5304 # to 999,999,999 inclusive.
5305 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5306 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5307 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5308 },
5309 &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
5310 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
5311 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
5312 # greater than that of `maxTtl`. When the `cacheMode` is set to
5313 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
5314 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
5315 # accessed objects may be evicted from the cache before the defined TTL. If
5316 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
5317 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
5318 # `USE_ORIGIN_HEADERS`.
5319 # as a count of seconds and fractions of seconds at nanosecond
5320 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5321 # or &quot;month&quot;. Range is approximately 10,000 years.
5322 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5323 # Durations less than one second are represented with a 0
5324 # `seconds` field and a positive `nanos` field. Must be from 0
5325 # to 999,999,999 inclusive.
5326 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5327 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5328 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5329 },
5330 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
5331 # attempt to set a max-age or s-maxage higher than this, or an Expires header
5332 # more than `maxTtl` seconds in the future will be capped at the value of
5333 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
5334 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
5335 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
5336 # Infrequently accessed objects may be evicted from the cache before the
5337 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
5338 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
5339 # mode.
5340 # as a count of seconds and fractions of seconds at nanosecond
5341 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5342 # or &quot;month&quot;. Range is approximately 10,000 years.
5343 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5344 # Durations less than one second are represented with a 0
5345 # `seconds` field and a positive `nanos` field. Must be from 0
5346 # to 999,999,999 inclusive.
5347 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5348 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5349 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5350 },
5351 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
5352 # to apply fine-grained caching for common errors or redirects.
5353 # This can reduce the load on your origin and improve end-user
5354 # experience by reducing response latency.
5355 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
5356 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
5357 # the specified response code that lack any Cache-Control, Expires, or
5358 # Pragma: no-cache directives. When the `cacheMode` is set to
5359 # `FORCE_CACHE_ALL`, negative caching applies to all responses
5360 # with the specified response code, and overrides any caching headers. By
5361 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
5362 #
5363 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
5364 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
5365 # * 405 (Method Not Found), 501 (Not Implemented): 60s
5366 #
5367 # These defaults can be overridden in `negativeCachingPolicy`.
5368 # If not specified, Cloud CDN applies negative caching by default.
5369 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
5370 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
5371 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
5372 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
5373 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
5374 # all response codes that you wish to cache. Cloud CDN will not apply any
5375 # default negative caching when a policy exists.
5376 { # Specify CDN TTLs for response error codes.
5377 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
5378 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
5379 # specified as values, and you cannot specify a status code more than
5380 # once.
5381 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
5382 # corresponding status code.
5383 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
5384 # objects may be evicted from the cache before the defined TTL.
5385 # as a count of seconds and fractions of seconds at nanosecond
5386 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5387 # or &quot;month&quot;. Range is approximately 10,000 years.
5388 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5389 # Durations less than one second are represented with a 0
5390 # `seconds` field and a positive `nanos` field. Must be from 0
5391 # to 999,999,999 inclusive.
5392 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5393 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5394 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5395 },
5396 },
5397 ],
5398 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
5399 # requests into a small number of requests to the origin. If not specified,
5400 # Cloud CDN applies request coalescing by default.
5401 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
5402 # content with the origin, or when an error is encountered when refreshing
5403 # the cache.
5404 # This setting defines the default &quot;max-stale&quot; duration for any cached
5405 # responses that do not specify a max-stale directive. Stale responses that
5406 # exceed the TTL configured here will not be served. The default limit
5407 # (max-stale) is 86400s (1 day), which will allow stale content to be
5408 # served up to this limit beyond the max-age (or s-maxage) of a cached
5409 # response.
5410 # The maximum allowed value is 604800 (1 week).
5411 # Set this to zero (0) to disable serve-while-stale.
5412 # as a count of seconds and fractions of seconds at nanosecond
5413 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5414 # or &quot;month&quot;. Range is approximately 10,000 years.
5415 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5416 # Durations less than one second are represented with a 0
5417 # `seconds` field and a positive `nanos` field. Must be from 0
5418 # to 999,999,999 inclusive.
5419 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5420 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5421 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5422 },
5423 },
5424 &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
5425 # information about the W3C recommendation for cross-origin resource sharing
5426 # (CORS), see Fetch API Living
5427 # Standard.
5428 #
5429 # Not supported when the URL map is bound to a target gRPC proxy.
5430 # information about the W3C recommendation for cross-origin resource sharing
5431 # (CORS), see Fetch API Living
5432 # Standard.
5433 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
5434 # indicates that
5435 # the actual request can include user credentials. This field translates to
5436 # the Access-Control-Allow-Credentials header.
5437 #
5438 # Default is false.
5439 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
5440 # header.
5441 &quot;A String&quot;,
5442 ],
5443 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
5444 # header.
5445 &quot;A String&quot;,
5446 ],
5447 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
5448 # more information, see regular expression syntax.
5449 #
5450 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
5451 #
5452 # Regular expressions can only be used when the loadBalancingScheme is
5453 # set to INTERNAL_SELF_MANAGED.
5454 &quot;A String&quot;,
5455 ],
5456 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
5457 #
5458 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
5459 &quot;A String&quot;,
5460 ],
5461 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
5462 # The default value is false, which indicates that the CORS
5463 # policy is in effect.
5464 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
5465 # header.
5466 &quot;A String&quot;,
5467 ],
5468 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
5469 # seconds. This field translates to the Access-Control-Max-Age
5470 # header.
5471 },
5472 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
5473 # the resiliency of clients to backend service failure. As part of fault
5474 # injection, when clients send requests to a backend service, delays can be
5475 # introduced by a load balancer on a percentage of requests before sending
5476 # those requests to the backend service. Similarly requests from clients can
5477 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
5478 # that are configured with a fault_injection_policy if:
5479 # 1. The traffic is generated by fault injection AND
5480 # 2. The fault injection is not a delay fault injection.
5481 # Fault injection is not supported with the classic Application Load Balancer
5482 # . To see which load balancers support fault injection,
5483 # see Load
5484 # balancing: Routing and traffic management features.
5485 # the resiliency of clients to backend service failure. As part of fault
5486 # injection, when clients send requests to a backend service, delays can be
5487 # introduced by the load balancer on a percentage of requests before sending
5488 # those request to the backend service. Similarly requests from clients can be
5489 # aborted by the load balancer for a percentage of requests.
5490 &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
5491 # injection.
5492 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
5493 #
5494 # The value must be from 200 to 599 inclusive.
5495 #
5496 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
5497 # according to this
5498 # mapping table. HTTP status 200 is mapped to gRPC status
5499 # UNKNOWN. Injecting an OK status is currently not supported by
5500 # Traffic Director.
5501 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
5502 # that is aborted as part of fault injection.
5503 #
5504 # The value must be from 0.0 to 100.0 inclusive.
5505 },
5506 &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
5507 # injection, before being sent to a backend service.
5508 # request to the backend service as part of fault injection.
5509 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
5510 # as a count of seconds and fractions of seconds at nanosecond
5511 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5512 # or &quot;month&quot;. Range is approximately 10,000 years.
5513 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5514 # Durations less than one second are represented with a 0
5515 # `seconds` field and a positive `nanos` field. Must be from 0
5516 # to 999,999,999 inclusive.
5517 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5518 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5519 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5520 },
5521 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
5522 # which a delay is introduced as part of fault injection.
5523 #
5524 # The value must be from 0.0 to 100.0 inclusive.
5525 },
5526 },
5527 &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
5528 # Global EXTERNAL_MANAGED load balancer schemes.
5529 # Either Cloud CDN must be enabled on the backend service or backend bucket
5530 # serving the route, or cache policy must be configured on the same route
5531 # dynamically processes and delivers images from the network edge.
5532 # Image Optimization is only available for Global External Application Load
5533 # Balancers.
5534 # Either Cloud CDN must be enabled on the backend service or backend bucket
5535 # serving the route, or cache policy must be configured on the same route.
5536 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
5537 },
5538 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
5539 # Unlike the timeout field where the timeout duration starts
5540 # from the time the request has been fully processed (known as*end-of-stream*),
5541 # the duration in this field is computed from the beginning of the stream
5542 # until the response has been processed, including all retries. A
5543 # stream that does not complete in this duration is closed.
5544 #
5545 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
5546 # with the route.
5547 #
5548 # This field is only allowed if the Url map is used with backend services
5549 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
5550 # as a count of seconds and fractions of seconds at nanosecond
5551 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5552 # or &quot;month&quot;. Range is approximately 10,000 years.
5553 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5554 # Durations less than one second are represented with a 0
5555 # `seconds` field and a positive `nanos` field. Must be from 0
5556 # to 999,999,999 inclusive.
5557 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5558 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5559 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5560 },
5561 &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
5562 # are shadowed to a separate mirrored backend service. The load balancer does
5563 # not wait for responses from the shadow service. Before sending traffic
5564 # to the shadow service, the host / authority header is suffixed with-shadow.
5565 #
5566 # Not supported when the URL map is bound to a target gRPC proxy that
5567 # has the validateForProxyless field set to true.
5568 # are shadowed to a separate mirrored backend service. The load balancer
5569 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
5570 # to the shadow service, the host or authority header is suffixed with-shadow.
5571 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
5572 # mirrored to.
5573 #
5574 # The backend service configured for a mirroring
5575 # policy must reference backends that are of the same type as the original
5576 # backend service matched in the URL map.
5577 #
5578 # Serverless NEG backends are not currently supported as a mirrored
5579 # backend service.
5580 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
5581 },
5582 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
5583 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
5584 # If not specified, defaults to 1.
5585 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
5586 #
5587 # If not specified, will use the timeout set in theHttpRouteAction field.
5588 # If timeout in the HttpRouteAction field is not set, this field
5589 # uses the largest timeout
5590 # among all backend services associated with the route.
5591 #
5592 # Not supported when the URL map is bound to a target gRPC proxy that
5593 # has the validateForProxyless field set to true.
5594 # as a count of seconds and fractions of seconds at nanosecond
5595 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5596 # or &quot;month&quot;. Range is approximately 10,000 years.
5597 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5598 # Durations less than one second are represented with a 0
5599 # `seconds` field and a positive `nanos` field. Must be from 0
5600 # to 999,999,999 inclusive.
5601 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5602 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5603 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5604 },
5605 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
5606 # values are:
5607 #
5608 # - 5xx: retry is attempted if the instance or endpoint
5609 # responds with any 5xx response code, or if the instance or
5610 # endpoint does not respond at all. For example, disconnects, reset, read
5611 # timeout, connection failure, and refused streams.
5612 # - gateway-error: Similar to 5xx, but only
5613 # applies to response codes 502, 503 or504.
5614 # - connect-failure: a retry is attempted on failures
5615 # connecting to the instance or endpoint. For example, connection
5616 # timeouts.
5617 # - retriable-4xx: a retry is attempted if the instance
5618 # or endpoint responds with a 4xx response code.
5619 # The only error that you can retry is error code 409.
5620 # - refused-stream: a retry is attempted if the instance
5621 # or endpoint resets the stream with a REFUSED_STREAM error
5622 # code. This reset type indicates that it is safe to retry.
5623 # - cancelled: a retry is attempted if the gRPC status
5624 # code in the response header is set to cancelled.
5625 # - deadline-exceeded: a retry is attempted if the gRPC
5626 # status code in the response header is set todeadline-exceeded.
5627 # - internal: a retry is attempted if the gRPC
5628 # status code in the response header is set tointernal.
5629 # - resource-exhausted: a retry is attempted if the gRPC
5630 # status code in the response header is set toresource-exhausted.
5631 # - unavailable: a retry is attempted if the gRPC
5632 # status code in the response header is set tounavailable.
5633 #
5634 # Only the following codes are supported when the URL map is bound to
5635 # target gRPC proxy that has validateForProxyless field set to true.
5636 #
5637 # - cancelled
5638 # - deadline-exceeded
5639 # - internal
5640 # - resource-exhausted
5641 # - unavailable
5642 &quot;A String&quot;,
5643 ],
5644 },
5645 &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
5646 # time the request has been fully processed (known as *end-of-stream*)
5647 # up until the response has been processed. Timeout includes
5648 # all retries.
5649 #
5650 # If not specified, this field uses the largest timeout among all backend
5651 # services associated with the route.
5652 #
5653 # Not supported when the URL map is bound to a target gRPC proxy that
5654 # has validateForProxyless field set to true.
5655 # as a count of seconds and fractions of seconds at nanosecond
5656 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5657 # or &quot;month&quot;. Range is approximately 10,000 years.
5658 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5659 # Durations less than one second are represented with a 0
5660 # `seconds` field and a positive `nanos` field. Must be from 0
5661 # to 999,999,999 inclusive.
5662 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5663 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5664 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5665 },
5666 &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
5667 # to the matched service.
5668 #
5669 # urlRewrite is the only action supported in UrlMaps
5670 # for classic Application Load Balancers.
5671 #
5672 # Not supported when the URL map is bound to a target gRPC proxy that
5673 # has the validateForProxyless field set to true.
5674 # backend service.
5675 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
5676 # host header is replaced with contents of hostRewrite.
5677 #
5678 # The value must be from 1 to 255 characters.
5679 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
5680 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
5681 #
5682 # The value must be from 1 to 1024 characters.
5683 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
5684 # header) using the HTTP template syntax.
5685 #
5686 # A corresponding
5687 # path_template_match must be specified. Any template variables must exist in
5688 # the path_template_match field.
5689 #
5690 #
5691 # - -At least one variable must be specified in the path_template_match
5692 # field
5693 # - You can omit variables from the rewritten URL
5694 # - The * and ** operators cannot be matched
5695 # unless they have a corresponding variable name - e.g.
5696 # {format=*} or {var=**}.
5697 #
5698 # For example, a path_template_match of /static/{format=**}
5699 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
5700 # rewrite, so that /{country}/{format}/{suffix=**} can be
5701 # rewritten as /content/{format}/{country}/{suffix}.
5702 #
5703 # At least
5704 # one non-empty routeRules[].matchRules[].path_template_match is
5705 # required.
5706 #
5707 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
5708 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
5709 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
5710 # It uses RE2 syntax with the following constraints:
5711 #
5712 #
5713 # - Any single character operators
5714 # - Groups are allowed to have only submatch operator inside
5715 # - Groups are allowed only without any char repetition, e.g.
5716 # .*
5717 # - Any char repetition, e.g. .*, is
5718 # only allowed to be used in a single regex together with:
5719 #
5720 #
5721 # - Empty string operators
5722 # - Other repetitions
5723 # - Ranges
5724 # - Repetitions of ranges
5725 #
5726 #
5727 # - Ranges are only allowed to have:
5728 #
5729 #
5730 # - Character range
5731 # - Digits range
5732 # - Symbols listed in characters allowed for ranges
5733 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
5734 # the path.
5735 },
5736 },
5737 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
5738 # occurs. The weights determine the fraction of traffic that flows to
5739 # their corresponding backend service. If all traffic needs to
5740 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
5741 #
5742 # After a backend service is identified and before forwarding
5743 # the request to
5744 # the backend service, advanced routing actions such as URL rewrites and
5745 # header transformations are applied depending on additional settings
5746 # specified in this HttpRouteAction.
5747 { # In contrast to a single BackendService in
5748 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
5749 # multiple backend services. The volume of traffic for each
5750 # backend service is proportional to the weight specified
5751 # in each WeightedBackendService
5752 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
5753 # resource. Before
5754 # forwarding the request to backendService, the load balancer
5755 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
5756 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
5757 # effect for the selected backendService.
5758 #
5759 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
5760 #
5761 # headerAction is not supported for load balancers that have
5762 # their loadBalancingScheme set to EXTERNAL.
5763 #
5764 # Not supported when the URL map is bound to a target gRPC proxy that
5765 # has validateForProxyless field set to true.
5766 # the request is passed along to the selected backendService.
5767 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
5768 { # Specification determining how headers are added to requests or responses.
5769 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
5770 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
5771 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
5772 # that already
5773 # exist for the header. If true, headerValue is set for the
5774 # header, discarding any values that were set for that header.
5775 #
5776 # The default value is true,
5777 # unless a variable is present in headerValue,
5778 # in which case the default value is false.
5779 # .
5780 },
5781 ],
5782 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
5783 # request before forwarding the request to the backendService.
5784 &quot;A String&quot;,
5785 ],
5786 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
5787 # client.
5788 { # Specification determining how headers are added to requests or responses.
5789 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
5790 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
5791 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
5792 # that already
5793 # exist for the header. If true, headerValue is set for the
5794 # header, discarding any values that were set for that header.
5795 #
5796 # The default value is true,
5797 # unless a variable is present in headerValue,
5798 # in which case the default value is false.
5799 # .
5800 },
5801 ],
5802 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
5803 # response before sending the response back to the client.
5804 &quot;A String&quot;,
5805 ],
5806 },
5807 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
5808 # computed asweight / (sum of all weightedBackendService weights in routeAction).
5809 #
5810 # The selection of a backend service is determined only for new traffic.
5811 # Once a user&#x27;s request has been directed to a backend service,
5812 # subsequent requests are sent to the same backend service as
5813 # determined by the backend service&#x27;s session affinity policy.
5814 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
5815 # splitting. If you do, the weighted traffic splitting configuration takes
5816 # precedence.
5817 #
5818 # The value must be from 0 to 1000.
5819 },
5820 ],
5821 },
5822 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource. This
5823 # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
5824 # matched. For example, the
5825 # following are all valid URLs to a BackendService resource:
5826 #
5827 #
5828 # - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
5829 # - compute/v1/projects/project/global/backendServices/backendService
5830 # - global/backendServices/backendService
5831 #
5832 #
5833 # If defaultRouteAction is also specified, advanced
5834 # routing actions, such as URL rewrites, take effect before sending the
5835 # request to the backend.
5836 #
5837 #
5838 # Only one of defaultUrlRedirect, defaultService
5839 # or defaultRouteAction.weightedBackendService can be set.
5840 #
5841 #
5842 # Authorization requires one or more of the following Google IAM permissions on the
5843 # specified resource default_service:
5844 #
5845 #
5846 # - compute.backendBuckets.use
5847 # - compute.backendServices.use
5848 &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
5849 # by defaultUrlRedirect.
5850 #
5851 #
5852 # Only one of defaultUrlRedirect, defaultService
5853 # or defaultRouteAction.weightedBackendService can be set.
5854 #
5855 #
5856 # Not supported when the URL map is bound to a target gRPC proxy.
5857 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
5858 # was supplied in the request.
5859 #
5860 # The value must be from 1 to 255
5861 # characters.
5862 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
5863 # set to HTTPS.
5864 # If set to false, the URL scheme of the redirected request
5865 # remains the same as that of the request.
5866 #
5867 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
5868 #
5869 # The default is set to false.
5870 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
5871 # that was supplied in the request.
5872 #
5873 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
5874 # supplied, the path of the original request is used for the redirect.
5875 #
5876 # The value must be from 1 to 1024 characters.
5877 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
5878 # the HttpRouteRuleMatch, retaining the remaining portion
5879 # of the URL before redirecting the request.
5880 #
5881 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
5882 # supplied, the path of the original request is used for the redirect.
5883 #
5884 # The value must be from 1 to 1024 characters.
5885 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
5886 #
5887 # Supported values are:
5888 #
5889 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
5890 # to 301.
5891 # - FOUND, which corresponds to 302.
5892 # - SEE_OTHER which corresponds to 303.
5893 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
5894 # method is retained.
5895 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
5896 # method is retained.
5897 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
5898 # URL is
5899 # removed before redirecting the request. If set to false, the
5900 # query portion of the original URL is retained.
5901 #
5902 # The default is set to false.
5903 },
5904 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
5905 # create the resource.
5906 &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
5907 # for the selected backend service.
5908 #
5909 # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
5910 #
5911 # HeaderAction is not supported for load balancers
5912 # that have
5913 # their loadBalancingScheme set to EXTERNAL.
5914 #
5915 # Not supported when the URL map is bound to a target gRPC proxy that
5916 # has validateForProxyless field set to true.
5917 # the request is passed along to the selected backendService.
5918 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
5919 { # Specification determining how headers are added to requests or responses.
5920 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
5921 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
5922 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
5923 # that already
5924 # exist for the header. If true, headerValue is set for the
5925 # header, discarding any values that were set for that header.
5926 #
5927 # The default value is true,
5928 # unless a variable is present in headerValue,
5929 # in which case the default value is false.
5930 # .
5931 },
5932 ],
5933 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
5934 # request before forwarding the request to the backendService.
5935 &quot;A String&quot;,
5936 ],
5937 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
5938 # client.
5939 { # Specification determining how headers are added to requests or responses.
5940 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
5941 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
5942 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
5943 # that already
5944 # exist for the header. If true, headerValue is set for the
5945 # header, discarding any values that were set for that header.
5946 #
5947 # The default value is true,
5948 # unless a variable is present in headerValue,
5949 # in which case the default value is false.
5950 # .
5951 },
5952 ],
5953 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
5954 # response before sending the response back to the client.
5955 &quot;A String&quot;,
5956 ],
5957 },
5958 &quot;name&quot;: &quot;A String&quot;, # The name to which this PathMatcher is referred by theHostRule.
5959 &quot;pathRules&quot;: [ # The list of path rules. Use this list instead of routeRules
5960 # when routing based on simple path matching is all that&#x27;s required. A path
5961 # rule can only include a wildcard character (*) after a
5962 # forward slash character (&quot;/&quot;).
5963 #
5964 # The order by which path rules are specified does not matter.
5965 # Matches are always done on the longest-path-first basis.
5966 #
5967 # For example: a pathRule with a path /a/b/c/* will match
5968 # before /a/b/* irrespective of the order in which those paths appear in this
5969 # list.
5970 #
5971 # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
5972 { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
5973 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
5974 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
5975 #
5976 # If a policy for an
5977 # error code is not configured for the PathRule, a policy for
5978 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
5979 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
5980 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
5981 # effect.
5982 #
5983 # For example, consider a UrlMap with the following configuration:
5984 #
5985 #
5986 # - UrlMap.defaultCustomErrorResponsePolicy are configured
5987 # with policies for 5xx and 4xx errors
5988 # - A PathRule for /coming_soon/ is configured for the error
5989 # code 404.
5990 #
5991 # 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
5992 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
5993 # the policy in PathRule.customErrorResponsePolicy takes
5994 # effect. If any of the requests in this example encounter a 500
5995 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
5996 #
5997 # customErrorResponsePolicy is supported only for
5998 # global external Application Load Balancers.
5999 # backend service or backend bucket responds with an error.
6000 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
6001 #
6002 # In a given policy, if you specify rules for both a range of error codes
6003 # as well as rules for specific error codes then rules with specific error
6004 # codes have a higher priority. For example, assume that you configure a rule
6005 # for 401 (Un-authorized) code, and another for all 4 series
6006 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
6007 # However if the backend service returns a 403, the rule for4xx takes effect.
6008 { # Specifies the mapping between the response code that will be returned along
6009 # with the custom error content and the response code returned by the backend
6010 # service.
6011 &quot;matchResponseCodes&quot;: [ # Valid values include:
6012 #
6013 #
6014 # - A number between 400 and 599: For example
6015 # 401 or 503, in which case the load balancer
6016 # applies the policy if the error code exactly matches this value.
6017 # - 5xx: Load Balancer will apply the policy if the
6018 # backend service responds with any response code in the range of
6019 # 500 to 599.
6020 # - 4xx: Load
6021 # Balancer will apply the policy if the backend service responds with any
6022 # response code in the range of 400 to
6023 # 499.
6024 #
6025 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
6026 &quot;A String&quot;,
6027 ],
6028 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
6029 # error content. If overrideResponseCode is not supplied, the
6030 # same response code returned by the original backend bucket or backend
6031 # service is returned to the client.
6032 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
6033 #
6034 # path must start
6035 # with a leading slash. path cannot have trailing slashes.
6036 #
6037 # If the file is not available in backendBucket or the
6038 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
6039 #
6040 # The value must
6041 # be from 1 to 1024 characters
6042 },
6043 ],
6044 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
6045 # contains the custom error content. Examples are:
6046 #
6047 #
6048 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
6049 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
6050 # - global/backendBuckets/myBackendBucket
6051 #
6052 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
6053 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
6054 #
6055 # If load balancer cannot reach
6056 # the backendBucket, a simple Not Found Error will
6057 # be returned, with the original response code (oroverrideResponseCode if configured).
6058 #
6059 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
6060 },
6061 &quot;paths&quot;: [ # The list of path patterns to match. Each must start with /
6062 # and the only place a * is allowed is at the end following
6063 # a /. The string fed to the path matcher does not include
6064 # any text after the first ? or #, and
6065 # those chars are not allowed here.
6066 &quot;A String&quot;,
6067 ],
6068 &quot;routeAction&quot;: { # In response to a matching path, the load balancer
6069 # performs advanced routing actions, such as URL rewrites and header
6070 # transformations, before forwarding the request to the selected
6071 # backend.
6072 #
6073 #
6074 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
6075 #
6076 #
6077 # URL maps for classic Application Load Balancers only support
6078 # the urlRewrite action within a path rule&#x27;srouteAction.
6079 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
6080 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
6081 # property must be specified. This policy cannot be specified if any target
6082 # backend has Identity-Aware Proxy enabled.
6083 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
6084 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
6085 # header names can be specified. The cache is bypassed for all `cacheMode`
6086 # values.
6087 &quot;A String&quot;,
6088 ],
6089 &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
6090 # on the backend type: for Backend Services, the complete request URI is
6091 # used; for Backend Buckets, the request URI is used without the protocol or
6092 # host, and only query parameters known to Cloud Storage are included.
6093 # Policy defined on Route Action.
6094 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
6095 # parameters will be included. Either specify `excludedQueryParameters`
6096 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
6097 # encoded and not treated as delimiters.
6098 #
6099 # Note: This field applies to routes that use backend services. Attempting
6100 # to set it on a route that points exclusively to Backend Buckets will
6101 # result in a configuration error. For routes that point to a Backend
6102 # Bucket, use `includedQueryParameters` to define which parameters should
6103 # be part of the cache key.
6104 &quot;A String&quot;,
6105 ],
6106 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
6107 #
6108 # Note: This setting is only applicable to routes that use a Backend
6109 # Service. It does not affect requests served by a Backend Bucket, as the
6110 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
6111 # it on a route that points exclusively to Backend Buckets will result in a
6112 # configuration error.
6113 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
6114 #
6115 # Note: This setting is only applicable to routes that use a Backend
6116 # Service. It does not affect requests served by a Backend Bucket, as the
6117 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
6118 # set on a route that points exclusively to Backend Buckets will result in
6119 # a configuration error.
6120 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
6121 # `includedQueryParameters` and `excludedQueryParameters`. If neither
6122 # is set, the entire query string will be included. If false, the query
6123 # string will be excluded from the cache key entirely.
6124 #
6125 # Note: This field applies to routes that use backend services. Attempting
6126 # to set it on a route that points exclusively to Backend Buckets will
6127 # result in a configuration error. For routes that point to a Backend
6128 # Bucket, use `includedQueryParameters` to define which parameters should
6129 # be part of the cache key.
6130 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
6131 # The name=value pair will be used in the cache key Cloud CDN generates.
6132 #
6133 # Note: This setting is only applicable to routes that use a Backend
6134 # Service. It does not affect requests served by a Backend Bucket.
6135 # Attempting to set it on a route that points exclusively to Backend
6136 # Buckets will result in a configuration error. Up to 5 cookie names can be
6137 # specified.
6138 &quot;A String&quot;,
6139 ],
6140 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
6141 &quot;A String&quot;,
6142 ],
6143 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
6144 # parameters will be excluded. Either specify `includedQueryParameters`
6145 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
6146 # encoded and not treated as delimiters.
6147 &quot;A String&quot;,
6148 ],
6149 },
6150 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
6151 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
6152 &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
6153 # content. This is used to clamp the max-age (or Expires) value sent to the
6154 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
6155 # is used for the response max-age directive, along with a &quot;public&quot;
6156 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
6157 # clamps the max-age from the origin (if specified), or else sets the
6158 # response max-age directive to the lesser of the `clientTtl` and
6159 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
6160 # present. The maximum allowed value is 31,622,400s (1 year). If not
6161 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
6162 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
6163 # `USE_ORIGIN_HEADERS`.
6164 # as a count of seconds and fractions of seconds at nanosecond
6165 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6166 # or &quot;month&quot;. Range is approximately 10,000 years.
6167 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6168 # Durations less than one second are represented with a 0
6169 # `seconds` field and a positive `nanos` field. Must be from 0
6170 # to 999,999,999 inclusive.
6171 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6172 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6173 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6174 },
6175 &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
6176 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
6177 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
6178 # greater than that of `maxTtl`. When the `cacheMode` is set to
6179 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
6180 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
6181 # accessed objects may be evicted from the cache before the defined TTL. If
6182 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
6183 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
6184 # `USE_ORIGIN_HEADERS`.
6185 # as a count of seconds and fractions of seconds at nanosecond
6186 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6187 # or &quot;month&quot;. Range is approximately 10,000 years.
6188 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6189 # Durations less than one second are represented with a 0
6190 # `seconds` field and a positive `nanos` field. Must be from 0
6191 # to 999,999,999 inclusive.
6192 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6193 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6194 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6195 },
6196 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
6197 # attempt to set a max-age or s-maxage higher than this, or an Expires header
6198 # more than `maxTtl` seconds in the future will be capped at the value of
6199 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
6200 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
6201 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
6202 # Infrequently accessed objects may be evicted from the cache before the
6203 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
6204 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
6205 # mode.
6206 # as a count of seconds and fractions of seconds at nanosecond
6207 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6208 # or &quot;month&quot;. Range is approximately 10,000 years.
6209 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6210 # Durations less than one second are represented with a 0
6211 # `seconds` field and a positive `nanos` field. Must be from 0
6212 # to 999,999,999 inclusive.
6213 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6214 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6215 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6216 },
6217 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
6218 # to apply fine-grained caching for common errors or redirects.
6219 # This can reduce the load on your origin and improve end-user
6220 # experience by reducing response latency.
6221 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
6222 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
6223 # the specified response code that lack any Cache-Control, Expires, or
6224 # Pragma: no-cache directives. When the `cacheMode` is set to
6225 # `FORCE_CACHE_ALL`, negative caching applies to all responses
6226 # with the specified response code, and overrides any caching headers. By
6227 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
6228 #
6229 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
6230 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
6231 # * 405 (Method Not Found), 501 (Not Implemented): 60s
6232 #
6233 # These defaults can be overridden in `negativeCachingPolicy`.
6234 # If not specified, Cloud CDN applies negative caching by default.
6235 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
6236 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
6237 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
6238 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
6239 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
6240 # all response codes that you wish to cache. Cloud CDN will not apply any
6241 # default negative caching when a policy exists.
6242 { # Specify CDN TTLs for response error codes.
6243 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
6244 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
6245 # specified as values, and you cannot specify a status code more than
6246 # once.
6247 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
6248 # corresponding status code.
6249 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
6250 # objects may be evicted from the cache before the defined TTL.
6251 # as a count of seconds and fractions of seconds at nanosecond
6252 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6253 # or &quot;month&quot;. Range is approximately 10,000 years.
6254 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6255 # Durations less than one second are represented with a 0
6256 # `seconds` field and a positive `nanos` field. Must be from 0
6257 # to 999,999,999 inclusive.
6258 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6259 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6260 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6261 },
6262 },
6263 ],
6264 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
6265 # requests into a small number of requests to the origin. If not specified,
6266 # Cloud CDN applies request coalescing by default.
6267 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
6268 # content with the origin, or when an error is encountered when refreshing
6269 # the cache.
6270 # This setting defines the default &quot;max-stale&quot; duration for any cached
6271 # responses that do not specify a max-stale directive. Stale responses that
6272 # exceed the TTL configured here will not be served. The default limit
6273 # (max-stale) is 86400s (1 day), which will allow stale content to be
6274 # served up to this limit beyond the max-age (or s-maxage) of a cached
6275 # response.
6276 # The maximum allowed value is 604800 (1 week).
6277 # Set this to zero (0) to disable serve-while-stale.
6278 # as a count of seconds and fractions of seconds at nanosecond
6279 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6280 # or &quot;month&quot;. Range is approximately 10,000 years.
6281 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6282 # Durations less than one second are represented with a 0
6283 # `seconds` field and a positive `nanos` field. Must be from 0
6284 # to 999,999,999 inclusive.
6285 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6286 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6287 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6288 },
6289 },
6290 &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
6291 # information about the W3C recommendation for cross-origin resource sharing
6292 # (CORS), see Fetch API Living
6293 # Standard.
6294 #
6295 # Not supported when the URL map is bound to a target gRPC proxy.
6296 # information about the W3C recommendation for cross-origin resource sharing
6297 # (CORS), see Fetch API Living
6298 # Standard.
6299 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
6300 # indicates that
6301 # the actual request can include user credentials. This field translates to
6302 # the Access-Control-Allow-Credentials header.
6303 #
6304 # Default is false.
6305 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
6306 # header.
6307 &quot;A String&quot;,
6308 ],
6309 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
6310 # header.
6311 &quot;A String&quot;,
6312 ],
6313 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
6314 # more information, see regular expression syntax.
6315 #
6316 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
6317 #
6318 # Regular expressions can only be used when the loadBalancingScheme is
6319 # set to INTERNAL_SELF_MANAGED.
6320 &quot;A String&quot;,
6321 ],
6322 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
6323 #
6324 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
6325 &quot;A String&quot;,
6326 ],
6327 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
6328 # The default value is false, which indicates that the CORS
6329 # policy is in effect.
6330 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
6331 # header.
6332 &quot;A String&quot;,
6333 ],
6334 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
6335 # seconds. This field translates to the Access-Control-Max-Age
6336 # header.
6337 },
6338 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
6339 # the resiliency of clients to backend service failure. As part of fault
6340 # injection, when clients send requests to a backend service, delays can be
6341 # introduced by a load balancer on a percentage of requests before sending
6342 # those requests to the backend service. Similarly requests from clients can
6343 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
6344 # that are configured with a fault_injection_policy if:
6345 # 1. The traffic is generated by fault injection AND
6346 # 2. The fault injection is not a delay fault injection.
6347 # Fault injection is not supported with the classic Application Load Balancer
6348 # . To see which load balancers support fault injection,
6349 # see Load
6350 # balancing: Routing and traffic management features.
6351 # the resiliency of clients to backend service failure. As part of fault
6352 # injection, when clients send requests to a backend service, delays can be
6353 # introduced by the load balancer on a percentage of requests before sending
6354 # those request to the backend service. Similarly requests from clients can be
6355 # aborted by the load balancer for a percentage of requests.
6356 &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
6357 # injection.
6358 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
6359 #
6360 # The value must be from 200 to 599 inclusive.
6361 #
6362 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
6363 # according to this
6364 # mapping table. HTTP status 200 is mapped to gRPC status
6365 # UNKNOWN. Injecting an OK status is currently not supported by
6366 # Traffic Director.
6367 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
6368 # that is aborted as part of fault injection.
6369 #
6370 # The value must be from 0.0 to 100.0 inclusive.
6371 },
6372 &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
6373 # injection, before being sent to a backend service.
6374 # request to the backend service as part of fault injection.
6375 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
6376 # as a count of seconds and fractions of seconds at nanosecond
6377 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6378 # or &quot;month&quot;. Range is approximately 10,000 years.
6379 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6380 # Durations less than one second are represented with a 0
6381 # `seconds` field and a positive `nanos` field. Must be from 0
6382 # to 999,999,999 inclusive.
6383 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6384 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6385 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6386 },
6387 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
6388 # which a delay is introduced as part of fault injection.
6389 #
6390 # The value must be from 0.0 to 100.0 inclusive.
6391 },
6392 },
6393 &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
6394 # Global EXTERNAL_MANAGED load balancer schemes.
6395 # Either Cloud CDN must be enabled on the backend service or backend bucket
6396 # serving the route, or cache policy must be configured on the same route
6397 # dynamically processes and delivers images from the network edge.
6398 # Image Optimization is only available for Global External Application Load
6399 # Balancers.
6400 # Either Cloud CDN must be enabled on the backend service or backend bucket
6401 # serving the route, or cache policy must be configured on the same route.
6402 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
6403 },
6404 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
6405 # Unlike the timeout field where the timeout duration starts
6406 # from the time the request has been fully processed (known as*end-of-stream*),
6407 # the duration in this field is computed from the beginning of the stream
6408 # until the response has been processed, including all retries. A
6409 # stream that does not complete in this duration is closed.
6410 #
6411 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
6412 # with the route.
6413 #
6414 # This field is only allowed if the Url map is used with backend services
6415 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
6416 # as a count of seconds and fractions of seconds at nanosecond
6417 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6418 # or &quot;month&quot;. Range is approximately 10,000 years.
6419 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6420 # Durations less than one second are represented with a 0
6421 # `seconds` field and a positive `nanos` field. Must be from 0
6422 # to 999,999,999 inclusive.
6423 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6424 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6425 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6426 },
6427 &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
6428 # are shadowed to a separate mirrored backend service. The load balancer does
6429 # not wait for responses from the shadow service. Before sending traffic
6430 # to the shadow service, the host / authority header is suffixed with-shadow.
6431 #
6432 # Not supported when the URL map is bound to a target gRPC proxy that
6433 # has the validateForProxyless field set to true.
6434 # are shadowed to a separate mirrored backend service. The load balancer
6435 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
6436 # to the shadow service, the host or authority header is suffixed with-shadow.
6437 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
6438 # mirrored to.
6439 #
6440 # The backend service configured for a mirroring
6441 # policy must reference backends that are of the same type as the original
6442 # backend service matched in the URL map.
6443 #
6444 # Serverless NEG backends are not currently supported as a mirrored
6445 # backend service.
6446 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
6447 },
6448 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
6449 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
6450 # If not specified, defaults to 1.
6451 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
6452 #
6453 # If not specified, will use the timeout set in theHttpRouteAction field.
6454 # If timeout in the HttpRouteAction field is not set, this field
6455 # uses the largest timeout
6456 # among all backend services associated with the route.
6457 #
6458 # Not supported when the URL map is bound to a target gRPC proxy that
6459 # has the validateForProxyless field set to true.
6460 # as a count of seconds and fractions of seconds at nanosecond
6461 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6462 # or &quot;month&quot;. Range is approximately 10,000 years.
6463 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6464 # Durations less than one second are represented with a 0
6465 # `seconds` field and a positive `nanos` field. Must be from 0
6466 # to 999,999,999 inclusive.
6467 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6468 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6469 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6470 },
6471 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
6472 # values are:
6473 #
6474 # - 5xx: retry is attempted if the instance or endpoint
6475 # responds with any 5xx response code, or if the instance or
6476 # endpoint does not respond at all. For example, disconnects, reset, read
6477 # timeout, connection failure, and refused streams.
6478 # - gateway-error: Similar to 5xx, but only
6479 # applies to response codes 502, 503 or504.
6480 # - connect-failure: a retry is attempted on failures
6481 # connecting to the instance or endpoint. For example, connection
6482 # timeouts.
6483 # - retriable-4xx: a retry is attempted if the instance
6484 # or endpoint responds with a 4xx response code.
6485 # The only error that you can retry is error code 409.
6486 # - refused-stream: a retry is attempted if the instance
6487 # or endpoint resets the stream with a REFUSED_STREAM error
6488 # code. This reset type indicates that it is safe to retry.
6489 # - cancelled: a retry is attempted if the gRPC status
6490 # code in the response header is set to cancelled.
6491 # - deadline-exceeded: a retry is attempted if the gRPC
6492 # status code in the response header is set todeadline-exceeded.
6493 # - internal: a retry is attempted if the gRPC
6494 # status code in the response header is set tointernal.
6495 # - resource-exhausted: a retry is attempted if the gRPC
6496 # status code in the response header is set toresource-exhausted.
6497 # - unavailable: a retry is attempted if the gRPC
6498 # status code in the response header is set tounavailable.
6499 #
6500 # Only the following codes are supported when the URL map is bound to
6501 # target gRPC proxy that has validateForProxyless field set to true.
6502 #
6503 # - cancelled
6504 # - deadline-exceeded
6505 # - internal
6506 # - resource-exhausted
6507 # - unavailable
6508 &quot;A String&quot;,
6509 ],
6510 },
6511 &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
6512 # time the request has been fully processed (known as *end-of-stream*)
6513 # up until the response has been processed. Timeout includes
6514 # all retries.
6515 #
6516 # If not specified, this field uses the largest timeout among all backend
6517 # services associated with the route.
6518 #
6519 # Not supported when the URL map is bound to a target gRPC proxy that
6520 # has validateForProxyless field set to true.
6521 # as a count of seconds and fractions of seconds at nanosecond
6522 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6523 # or &quot;month&quot;. Range is approximately 10,000 years.
6524 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6525 # Durations less than one second are represented with a 0
6526 # `seconds` field and a positive `nanos` field. Must be from 0
6527 # to 999,999,999 inclusive.
6528 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6529 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6530 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6531 },
6532 &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
6533 # to the matched service.
6534 #
6535 # urlRewrite is the only action supported in UrlMaps
6536 # for classic Application Load Balancers.
6537 #
6538 # Not supported when the URL map is bound to a target gRPC proxy that
6539 # has the validateForProxyless field set to true.
6540 # backend service.
6541 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
6542 # host header is replaced with contents of hostRewrite.
6543 #
6544 # The value must be from 1 to 255 characters.
6545 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
6546 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
6547 #
6548 # The value must be from 1 to 1024 characters.
6549 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
6550 # header) using the HTTP template syntax.
6551 #
6552 # A corresponding
6553 # path_template_match must be specified. Any template variables must exist in
6554 # the path_template_match field.
6555 #
6556 #
6557 # - -At least one variable must be specified in the path_template_match
6558 # field
6559 # - You can omit variables from the rewritten URL
6560 # - The * and ** operators cannot be matched
6561 # unless they have a corresponding variable name - e.g.
6562 # {format=*} or {var=**}.
6563 #
6564 # For example, a path_template_match of /static/{format=**}
6565 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
6566 # rewrite, so that /{country}/{format}/{suffix=**} can be
6567 # rewritten as /content/{format}/{country}/{suffix}.
6568 #
6569 # At least
6570 # one non-empty routeRules[].matchRules[].path_template_match is
6571 # required.
6572 #
6573 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
6574 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
6575 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
6576 # It uses RE2 syntax with the following constraints:
6577 #
6578 #
6579 # - Any single character operators
6580 # - Groups are allowed to have only submatch operator inside
6581 # - Groups are allowed only without any char repetition, e.g.
6582 # .*
6583 # - Any char repetition, e.g. .*, is
6584 # only allowed to be used in a single regex together with:
6585 #
6586 #
6587 # - Empty string operators
6588 # - Other repetitions
6589 # - Ranges
6590 # - Repetitions of ranges
6591 #
6592 #
6593 # - Ranges are only allowed to have:
6594 #
6595 #
6596 # - Character range
6597 # - Digits range
6598 # - Symbols listed in characters allowed for ranges
6599 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
6600 # the path.
6601 },
6602 },
6603 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
6604 # occurs. The weights determine the fraction of traffic that flows to
6605 # their corresponding backend service. If all traffic needs to
6606 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
6607 #
6608 # After a backend service is identified and before forwarding
6609 # the request to
6610 # the backend service, advanced routing actions such as URL rewrites and
6611 # header transformations are applied depending on additional settings
6612 # specified in this HttpRouteAction.
6613 { # In contrast to a single BackendService in
6614 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
6615 # multiple backend services. The volume of traffic for each
6616 # backend service is proportional to the weight specified
6617 # in each WeightedBackendService
6618 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
6619 # resource. Before
6620 # forwarding the request to backendService, the load balancer
6621 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
6622 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
6623 # effect for the selected backendService.
6624 #
6625 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
6626 #
6627 # headerAction is not supported for load balancers that have
6628 # their loadBalancingScheme set to EXTERNAL.
6629 #
6630 # Not supported when the URL map is bound to a target gRPC proxy that
6631 # has validateForProxyless field set to true.
6632 # the request is passed along to the selected backendService.
6633 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
6634 { # Specification determining how headers are added to requests or responses.
6635 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
6636 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
6637 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
6638 # that already
6639 # exist for the header. If true, headerValue is set for the
6640 # header, discarding any values that were set for that header.
6641 #
6642 # The default value is true,
6643 # unless a variable is present in headerValue,
6644 # in which case the default value is false.
6645 # .
6646 },
6647 ],
6648 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
6649 # request before forwarding the request to the backendService.
6650 &quot;A String&quot;,
6651 ],
6652 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
6653 # client.
6654 { # Specification determining how headers are added to requests or responses.
6655 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
6656 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
6657 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
6658 # that already
6659 # exist for the header. If true, headerValue is set for the
6660 # header, discarding any values that were set for that header.
6661 #
6662 # The default value is true,
6663 # unless a variable is present in headerValue,
6664 # in which case the default value is false.
6665 # .
6666 },
6667 ],
6668 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
6669 # response before sending the response back to the client.
6670 &quot;A String&quot;,
6671 ],
6672 },
6673 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
6674 # computed asweight / (sum of all weightedBackendService weights in routeAction).
6675 #
6676 # The selection of a backend service is determined only for new traffic.
6677 # Once a user&#x27;s request has been directed to a backend service,
6678 # subsequent requests are sent to the same backend service as
6679 # determined by the backend service&#x27;s session affinity policy.
6680 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
6681 # splitting. If you do, the weighted traffic splitting configuration takes
6682 # precedence.
6683 #
6684 # The value must be from 0 to 1000.
6685 },
6686 ],
6687 },
6688 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
6689 # is directed if this rule is matched. If routeAction is
6690 # also specified, advanced routing actions, such as URL rewrites,
6691 # take effect before sending the request to the backend.
6692 #
6693 #
6694 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
6695 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
6696 # specified by urlRedirect.
6697 #
6698 #
6699 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
6700 #
6701 #
6702 # Not supported when the URL map is bound to a target gRPC proxy.
6703 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
6704 # was supplied in the request.
6705 #
6706 # The value must be from 1 to 255
6707 # characters.
6708 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
6709 # set to HTTPS.
6710 # If set to false, the URL scheme of the redirected request
6711 # remains the same as that of the request.
6712 #
6713 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
6714 #
6715 # The default is set to false.
6716 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
6717 # that was supplied in the request.
6718 #
6719 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
6720 # supplied, the path of the original request is used for the redirect.
6721 #
6722 # The value must be from 1 to 1024 characters.
6723 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
6724 # the HttpRouteRuleMatch, retaining the remaining portion
6725 # of the URL before redirecting the request.
6726 #
6727 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
6728 # supplied, the path of the original request is used for the redirect.
6729 #
6730 # The value must be from 1 to 1024 characters.
6731 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
6732 #
6733 # Supported values are:
6734 #
6735 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
6736 # to 301.
6737 # - FOUND, which corresponds to 302.
6738 # - SEE_OTHER which corresponds to 303.
6739 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
6740 # method is retained.
6741 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
6742 # method is retained.
6743 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
6744 # URL is
6745 # removed before redirecting the request. If set to false, the
6746 # query portion of the original URL is retained.
6747 #
6748 # The default is set to false.
6749 },
6750 },
6751 ],
6752 &quot;routeRules&quot;: [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
6753 # desired. routeRules are evaluated in order of priority, from
6754 # the lowest to highest number.
6755 #
6756 # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
6757 { # The HttpRouteRule setting specifies how to match an HTTP request
6758 # and the corresponding routing action that load balancing proxies perform.
6759 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
6760 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
6761 #
6762 # If a policy for an
6763 # error code is not configured for the RouteRule, a policy for
6764 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
6765 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
6766 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
6767 # effect.
6768 #
6769 # For example, consider a UrlMap with the following configuration:
6770 #
6771 #
6772 # - UrlMap.defaultCustomErrorResponsePolicy are configured
6773 # with policies for 5xx and 4xx errors
6774 # - A RouteRule for /coming_soon/ is configured for the
6775 # error code 404.
6776 #
6777 # 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
6778 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
6779 # the policy in RouteRule.customErrorResponsePolicy takes
6780 # effect. If any of the requests in this example encounter a 500
6781 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
6782 #
6783 # When
6784 # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
6785 # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
6786 # a retry, if load balancer is successful in reaching the
6787 # service, the customErrorResponsePolicy is ignored and
6788 # the response from the service is returned to the client.
6789 #
6790 # customErrorResponsePolicy is supported only for
6791 # global external Application Load Balancers.
6792 # backend service or backend bucket responds with an error.
6793 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
6794 #
6795 # In a given policy, if you specify rules for both a range of error codes
6796 # as well as rules for specific error codes then rules with specific error
6797 # codes have a higher priority. For example, assume that you configure a rule
6798 # for 401 (Un-authorized) code, and another for all 4 series
6799 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
6800 # However if the backend service returns a 403, the rule for4xx takes effect.
6801 { # Specifies the mapping between the response code that will be returned along
6802 # with the custom error content and the response code returned by the backend
6803 # service.
6804 &quot;matchResponseCodes&quot;: [ # Valid values include:
6805 #
6806 #
6807 # - A number between 400 and 599: For example
6808 # 401 or 503, in which case the load balancer
6809 # applies the policy if the error code exactly matches this value.
6810 # - 5xx: Load Balancer will apply the policy if the
6811 # backend service responds with any response code in the range of
6812 # 500 to 599.
6813 # - 4xx: Load
6814 # Balancer will apply the policy if the backend service responds with any
6815 # response code in the range of 400 to
6816 # 499.
6817 #
6818 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
6819 &quot;A String&quot;,
6820 ],
6821 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
6822 # error content. If overrideResponseCode is not supplied, the
6823 # same response code returned by the original backend bucket or backend
6824 # service is returned to the client.
6825 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
6826 #
6827 # path must start
6828 # with a leading slash. path cannot have trailing slashes.
6829 #
6830 # If the file is not available in backendBucket or the
6831 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
6832 #
6833 # The value must
6834 # be from 1 to 1024 characters
6835 },
6836 ],
6837 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
6838 # contains the custom error content. Examples are:
6839 #
6840 #
6841 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
6842 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
6843 # - global/backendBuckets/myBackendBucket
6844 #
6845 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
6846 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
6847 #
6848 # If load balancer cannot reach
6849 # the backendBucket, a simple Not Found Error will
6850 # be returned, with the original response code (oroverrideResponseCode if configured).
6851 #
6852 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
6853 },
6854 &quot;description&quot;: &quot;A String&quot;, # The short description conveying the intent of this routeRule.
6855 #
6856 #
6857 # The description can have a maximum length of 1024 characters.
6858 &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
6859 # for the selected backendService.
6860 #
6861 # The headerAction value specified here is applied before the
6862 # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
6863 #
6864 # HeaderAction is not supported for load balancers
6865 # that have
6866 # their loadBalancingScheme set to EXTERNAL.
6867 #
6868 # Not supported when the URL map is bound to a target gRPC proxy that
6869 # has validateForProxyless field set to true.
6870 # the request is passed along to the selected backendService.
6871 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
6872 { # Specification determining how headers are added to requests or responses.
6873 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
6874 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
6875 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
6876 # that already
6877 # exist for the header. If true, headerValue is set for the
6878 # header, discarding any values that were set for that header.
6879 #
6880 # The default value is true,
6881 # unless a variable is present in headerValue,
6882 # in which case the default value is false.
6883 # .
6884 },
6885 ],
6886 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
6887 # request before forwarding the request to the backendService.
6888 &quot;A String&quot;,
6889 ],
6890 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
6891 # client.
6892 { # Specification determining how headers are added to requests or responses.
6893 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
6894 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
6895 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
6896 # that already
6897 # exist for the header. If true, headerValue is set for the
6898 # header, discarding any values that were set for that header.
6899 #
6900 # The default value is true,
6901 # unless a variable is present in headerValue,
6902 # in which case the default value is false.
6903 # .
6904 },
6905 ],
6906 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
6907 # response before sending the response back to the client.
6908 &quot;A String&quot;,
6909 ],
6910 },
6911 &quot;httpFilterConfigs&quot;: [ # Outbound route specific configuration fornetworkservices.HttpFilter resources enabled by Traffic
6912 # Director. httpFilterConfigs only applies for load balancers
6913 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
6914 # more details.
6915 #
6916 # Not supported when the URL map is bound to a target gRPC proxy that
6917 # has validateForProxyless field set to true.
6918 { # HttpFilterConfiguration supplies additional contextual settings
6919 # for networkservices.HttpFilter resources enabled by Traffic
6920 # Director.
6921 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
6922 # YAML formatted and only contain fields defined in the protobuf identified
6923 # in configTypeUrl
6924 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
6925 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
6926 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
6927 # configuration belongs to. This name must be known to the xDS client.
6928 # Example: envoy.wasm
6929 },
6930 ],
6931 &quot;httpFilterMetadata&quot;: [ # Outbound route specific metadata supplied tonetworkservices.HttpFilter resources enabled by Traffic
6932 # Director. httpFilterMetadata only applies for load balancers
6933 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
6934 # more details.
6935 #
6936 # The only configTypeUrl supported istype.googleapis.com/google.protobuf.Struct
6937 #
6938 # Not supported when the URL map is bound to a target gRPC proxy that
6939 # has validateForProxyless field set to true.
6940 { # HttpFilterConfiguration supplies additional contextual settings
6941 # for networkservices.HttpFilter resources enabled by Traffic
6942 # Director.
6943 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
6944 # YAML formatted and only contain fields defined in the protobuf identified
6945 # in configTypeUrl
6946 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
6947 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
6948 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
6949 # configuration belongs to. This name must be known to the xDS client.
6950 # Example: envoy.wasm
6951 },
6952 ],
6953 &quot;matchRules&quot;: [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
6954 # this routeRule when any of thematchRules are satisfied. However predicates within
6955 # a given matchRule have AND semantics. All predicates
6956 # within a matchRule must match for the request to
6957 # match the rule.
6958 { # HttpRouteRuleMatch specifies a set of criteria for matching
6959 # requests to an HttpRouteRule. All specified criteria must
6960 # be satisfied for a match to occur.
6961 &quot;fullPathMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
6962 # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
6963 # that may be part of the original URL.
6964 #
6965 # fullPathMatch must be from 1 to 1024 characters.
6966 #
6967 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
6968 # specified.
6969 &quot;headerMatches&quot;: [ # Specifies a list of header match criteria, all of which must match
6970 # corresponding headers in the request.
6971 { # matchRule criteria for request header matches.
6972 &quot;exactMatch&quot;: &quot;A String&quot;, # The value should exactly match contents of exactMatch.
6973 #
6974 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
6975 &quot;headerName&quot;: &quot;A String&quot;, # The name of the HTTP header to match.
6976 #
6977 # For matching against the HTTP request&#x27;s authority, use a headerMatch
6978 # with the header name &quot;:authority&quot;.
6979 #
6980 # For matching a request&#x27;s method, use the headerName &quot;:method&quot;.
6981 #
6982 # When the URL map is bound to a target gRPC proxy that has
6983 # the validateForProxyless field set to true, only
6984 # non-binary
6985 # user-specified custom metadata and the `content-type` header are supported.
6986 # The following transport-level headers cannot be used in header matching
6987 # rules:
6988 # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
6989 # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
6990 # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
6991 # `grpc-timeout` and `grpc-trace-bin`.
6992 &quot;invertMatch&quot;: True or False, # If set to false, the headerMatch is considered a
6993 # match if the preceding match criteria are met. If set to true,
6994 # the headerMatch is considered a match if the preceding
6995 # match criteria are NOT met.
6996 #
6997 # The default setting is false.
6998 &quot;prefixMatch&quot;: &quot;A String&quot;, # The value of the header must start with the contents ofprefixMatch.
6999 #
7000 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
7001 &quot;presentMatch&quot;: True or False, # A header with the contents of headerName must exist. The
7002 # match takes place whether or not the request&#x27;s header has a value.
7003 #
7004 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
7005 &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
7006 # specified in rangeMatch. If the header does not contain an
7007 # integer, number or is empty, the match fails.
7008 #
7009 # For example for a range [-5, 0]
7010 #
7011 #
7012 # - -3 will match.
7013 # - 0 will not match.
7014 # - 0.25 will not match.
7015 # - -3someString will not match.
7016 #
7017 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
7018 #
7019 # rangeMatch is not supported for load balancers
7020 # that have loadBalancingScheme set to EXTERNAL.
7021 # within the specified integer range.
7022 &quot;rangeEnd&quot;: &quot;A String&quot;, # The end of the range (exclusive) in signed long integer format.
7023 &quot;rangeStart&quot;: &quot;A String&quot;, # The start of the range (inclusive) in signed long integer format.
7024 },
7025 &quot;regexMatch&quot;: &quot;A String&quot;, # The value of the header must match the regular expression specified inregexMatch.
7026 # For more information about regular expression syntax, see Syntax.
7027 #
7028 # For matching against a port specified in the HTTP request, use a
7029 # headerMatch with headerName set to PORT and a regular expression that
7030 # satisfies the RFC2616 Host header&#x27;s port specifier.
7031 #
7032 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
7033 #
7034 # Regular expressions can only be used when the loadBalancingScheme is
7035 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
7036 # (regional scope) or INTERNAL_MANAGED.
7037 &quot;suffixMatch&quot;: &quot;A String&quot;, # The value of the header must end with the contents ofsuffixMatch.
7038 #
7039 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
7040 },
7041 ],
7042 &quot;ignoreCase&quot;: True or False, # Specifies that prefixMatch and fullPathMatch
7043 # matches are case sensitive.
7044 #
7045 # The default value is false.
7046 #
7047 # ignoreCase must not be used with regexMatch.
7048 #
7049 # Not supported when the URL map is bound to a target gRPC proxy.
7050 &quot;metadataFilters&quot;: [ # Opaque filter criteria used by the load balancer to restrict routing
7051 # configuration to a limited set of xDS
7052 # compliant clients. In their xDS requests to the load balancer, xDS clients
7053 # present node
7054 # metadata. When there is a match, the relevant routing configuration
7055 # is made available to those proxies.
7056 #
7057 # 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
7058 # the metadata. If its filterMatchCriteria is set to
7059 # MATCH_ALL, then all of its filterLabels must match with
7060 # corresponding labels provided in the metadata. If multiple
7061 # metadata filters are specified, all of them need to be
7062 # satisfied in order to be considered a match.
7063 #
7064 # metadataFilters specified here is applied after those
7065 # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
7066 #
7067 # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
7068 #
7069 # Not supported when the URL map is bound to a target gRPC proxy that
7070 # has validateForProxyless field set to true.
7071 { # Opaque filter criteria used by load balancers to restrict routing
7072 # configuration to a limited set of load balancing proxies. Proxies and
7073 # sidecars involved in load balancing would typically present metadata to the
7074 # load balancers that need to match criteria specified here. If a match takes
7075 # place, the relevant configuration is made available to those
7076 # proxies.
7077 #
7078 # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
7079 # one of thefilterLabels must match the corresponding label provided in
7080 # the metadata. If its filterMatchCriteria is set to
7081 # MATCH_ALL, then all of its filterLabels must match with
7082 # corresponding labels provided in the metadata.
7083 #
7084 # An example for using metadataFilters would be: if
7085 # load balancing involves
7086 # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in of their XDS requests to loadbalancers.
7087 &quot;filterLabels&quot;: [ # The list of label value pairs that must match labels in the provided
7088 # metadata based on filterMatchCriteria
7089 #
7090 # This list must not be empty and can have at the most 64 entries.
7091 { # MetadataFilter label name value pairs that are expected
7092 # to match corresponding labels presented as metadata to the load balancer.
7093 &quot;name&quot;: &quot;A String&quot;, # Name of metadata label.
7094 #
7095 # The name can have a maximum length of 1024 characters and must be at
7096 # least 1 character long.
7097 &quot;value&quot;: &quot;A String&quot;, # The value of the label must match the specified value.
7098 #
7099 # value can have a maximum length of 1024 characters.
7100 },
7101 ],
7102 &quot;filterMatchCriteria&quot;: &quot;A String&quot;, # Specifies how individual filter label matches
7103 # within the list of filterLabels and contributes toward the
7104 # overall metadataFilter match.
7105 #
7106 # Supported values are:
7107 #
7108 # - MATCH_ANY: at least one of the filterLabels
7109 # must have a matching label in the provided metadata.
7110 # - MATCH_ALL: all filterLabels must have
7111 # matching labels in the provided metadata.
7112 },
7113 ],
7114 &quot;pathTemplateMatch&quot;: &quot;A String&quot;, # If specified, this field defines a path template pattern that must match
7115 # the :path header after the query string is removed.
7116 #
7117 # A path template pattern can include variables and wildcards.
7118 # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
7119 # matches a single path segment, and ** that matches zero or
7120 # more path segments. The pattern must follow these rules:
7121 #
7122 #
7123 # - The value must be between 1 and 1024 characters.
7124 # - The pattern must start with a leading slash (&quot;/&quot;).
7125 # - No more than 5 operators (variables or wildcards) may appear in
7126 # the pattern.
7127 #
7128 # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
7129 # set.
7130 &quot;prefixMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the request&#x27;s
7131 # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
7132 #
7133 # The value must be from 1 to 1024 characters.
7134 #
7135 # The * character inside a prefix match is
7136 # treated as a literal character, not as a wildcard.
7137 #
7138 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
7139 # used within a matchRule.
7140 &quot;queryParameterMatches&quot;: [ # Specifies a list of query parameter match criteria, all of which must
7141 # match corresponding query parameters in the request.
7142 #
7143 # Not supported when the URL map is bound to a target gRPC proxy.
7144 { # HttpRouteRuleMatch criteria for a request&#x27;s query parameter.
7145 &quot;exactMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
7146 # parameter exactly matches the contents of exactMatch.
7147 #
7148 # Only one of presentMatch, exactMatch, orregexMatch must be set.
7149 &quot;name&quot;: &quot;A String&quot;, # The name of the query parameter to match. The query parameter must exist in
7150 # the request, in the absence of which the request match fails.
7151 &quot;presentMatch&quot;: True or False, # Specifies that the queryParameterMatch matches if the
7152 # request contains the query parameter, irrespective of whether the
7153 # parameter has a value or not.
7154 #
7155 # Only one of presentMatch, exactMatch, orregexMatch must be set.
7156 &quot;regexMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
7157 # parameter matches the regular expression specified byregexMatch. For
7158 # more information about regular expression syntax, see Syntax.
7159 #
7160 # Only one of presentMatch, exactMatch, orregexMatch must be set.
7161 #
7162 # Regular expressions can only be used when the loadBalancingScheme is
7163 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
7164 # (regional scope) or INTERNAL_MANAGED.
7165 },
7166 ],
7167 &quot;regexMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
7168 # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
7169 # supplied with the original URL. For
7170 # more information about regular expression syntax, see Syntax.
7171 #
7172 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
7173 # specified.
7174 #
7175 # Regular expressions can only be used when the loadBalancingScheme is
7176 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
7177 # (regional scope) or INTERNAL_MANAGED.
7178 },
7179 ],
7180 &quot;priority&quot;: 42, # For routeRules within a given pathMatcher,
7181 # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
7182 # of priority, from the lowest to highest number. The priority of a
7183 # rule decreases as its number increases (1, 2, 3, N+1). The first rule
7184 # that matches the request is applied.
7185 #
7186 #
7187 # You cannot configure two or more routeRules with the same priority.
7188 # Priority for each rule must be set to a number from 0 to 2147483647
7189 # inclusive.
7190 #
7191 #
7192 # Priority numbers can have gaps, which enable you to add or remove rules
7193 # in the future without affecting the rest of the rules. For example, 1, 2,
7194 # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
7195 # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
7196 # without any impact on existing rules.
7197 &quot;routeAction&quot;: { # In response to a matching matchRule, the load balancer
7198 # performs advanced routing actions, such as URL rewrites and header
7199 # transformations, before forwarding the request to the selected backend.
7200 #
7201 #
7202 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
7203 #
7204 #
7205 # URL maps for classic Application Load Balancers only support
7206 # the urlRewrite action within a route rule&#x27;srouteAction.
7207 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
7208 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
7209 # property must be specified. This policy cannot be specified if any target
7210 # backend has Identity-Aware Proxy enabled.
7211 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
7212 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
7213 # header names can be specified. The cache is bypassed for all `cacheMode`
7214 # values.
7215 &quot;A String&quot;,
7216 ],
7217 &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
7218 # on the backend type: for Backend Services, the complete request URI is
7219 # used; for Backend Buckets, the request URI is used without the protocol or
7220 # host, and only query parameters known to Cloud Storage are included.
7221 # Policy defined on Route Action.
7222 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
7223 # parameters will be included. Either specify `excludedQueryParameters`
7224 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
7225 # encoded and not treated as delimiters.
7226 #
7227 # Note: This field applies to routes that use backend services. Attempting
7228 # to set it on a route that points exclusively to Backend Buckets will
7229 # result in a configuration error. For routes that point to a Backend
7230 # Bucket, use `includedQueryParameters` to define which parameters should
7231 # be part of the cache key.
7232 &quot;A String&quot;,
7233 ],
7234 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
7235 #
7236 # Note: This setting is only applicable to routes that use a Backend
7237 # Service. It does not affect requests served by a Backend Bucket, as the
7238 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
7239 # it on a route that points exclusively to Backend Buckets will result in a
7240 # configuration error.
7241 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
7242 #
7243 # Note: This setting is only applicable to routes that use a Backend
7244 # Service. It does not affect requests served by a Backend Bucket, as the
7245 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
7246 # set on a route that points exclusively to Backend Buckets will result in
7247 # a configuration error.
7248 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
7249 # `includedQueryParameters` and `excludedQueryParameters`. If neither
7250 # is set, the entire query string will be included. If false, the query
7251 # string will be excluded from the cache key entirely.
7252 #
7253 # Note: This field applies to routes that use backend services. Attempting
7254 # to set it on a route that points exclusively to Backend Buckets will
7255 # result in a configuration error. For routes that point to a Backend
7256 # Bucket, use `includedQueryParameters` to define which parameters should
7257 # be part of the cache key.
7258 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
7259 # The name=value pair will be used in the cache key Cloud CDN generates.
7260 #
7261 # Note: This setting is only applicable to routes that use a Backend
7262 # Service. It does not affect requests served by a Backend Bucket.
7263 # Attempting to set it on a route that points exclusively to Backend
7264 # Buckets will result in a configuration error. Up to 5 cookie names can be
7265 # specified.
7266 &quot;A String&quot;,
7267 ],
7268 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
7269 &quot;A String&quot;,
7270 ],
7271 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
7272 # parameters will be excluded. Either specify `includedQueryParameters`
7273 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
7274 # encoded and not treated as delimiters.
7275 &quot;A String&quot;,
7276 ],
7277 },
7278 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
7279 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
7280 &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
7281 # content. This is used to clamp the max-age (or Expires) value sent to the
7282 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
7283 # is used for the response max-age directive, along with a &quot;public&quot;
7284 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
7285 # clamps the max-age from the origin (if specified), or else sets the
7286 # response max-age directive to the lesser of the `clientTtl` and
7287 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
7288 # present. The maximum allowed value is 31,622,400s (1 year). If not
7289 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
7290 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
7291 # `USE_ORIGIN_HEADERS`.
7292 # as a count of seconds and fractions of seconds at nanosecond
7293 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7294 # or &quot;month&quot;. Range is approximately 10,000 years.
7295 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7296 # Durations less than one second are represented with a 0
7297 # `seconds` field and a positive `nanos` field. Must be from 0
7298 # to 999,999,999 inclusive.
7299 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7300 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7301 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7302 },
7303 &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
7304 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
7305 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
7306 # greater than that of `maxTtl`. When the `cacheMode` is set to
7307 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
7308 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
7309 # accessed objects may be evicted from the cache before the defined TTL. If
7310 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
7311 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
7312 # `USE_ORIGIN_HEADERS`.
7313 # as a count of seconds and fractions of seconds at nanosecond
7314 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7315 # or &quot;month&quot;. Range is approximately 10,000 years.
7316 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7317 # Durations less than one second are represented with a 0
7318 # `seconds` field and a positive `nanos` field. Must be from 0
7319 # to 999,999,999 inclusive.
7320 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7321 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7322 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7323 },
7324 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
7325 # attempt to set a max-age or s-maxage higher than this, or an Expires header
7326 # more than `maxTtl` seconds in the future will be capped at the value of
7327 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
7328 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
7329 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
7330 # Infrequently accessed objects may be evicted from the cache before the
7331 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
7332 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
7333 # mode.
7334 # as a count of seconds and fractions of seconds at nanosecond
7335 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7336 # or &quot;month&quot;. Range is approximately 10,000 years.
7337 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7338 # Durations less than one second are represented with a 0
7339 # `seconds` field and a positive `nanos` field. Must be from 0
7340 # to 999,999,999 inclusive.
7341 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7342 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7343 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7344 },
7345 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
7346 # to apply fine-grained caching for common errors or redirects.
7347 # This can reduce the load on your origin and improve end-user
7348 # experience by reducing response latency.
7349 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
7350 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
7351 # the specified response code that lack any Cache-Control, Expires, or
7352 # Pragma: no-cache directives. When the `cacheMode` is set to
7353 # `FORCE_CACHE_ALL`, negative caching applies to all responses
7354 # with the specified response code, and overrides any caching headers. By
7355 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
7356 #
7357 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
7358 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
7359 # * 405 (Method Not Found), 501 (Not Implemented): 60s
7360 #
7361 # These defaults can be overridden in `negativeCachingPolicy`.
7362 # If not specified, Cloud CDN applies negative caching by default.
7363 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
7364 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
7365 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
7366 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
7367 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
7368 # all response codes that you wish to cache. Cloud CDN will not apply any
7369 # default negative caching when a policy exists.
7370 { # Specify CDN TTLs for response error codes.
7371 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
7372 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
7373 # specified as values, and you cannot specify a status code more than
7374 # once.
7375 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
7376 # corresponding status code.
7377 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
7378 # objects may be evicted from the cache before the defined TTL.
7379 # as a count of seconds and fractions of seconds at nanosecond
7380 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7381 # or &quot;month&quot;. Range is approximately 10,000 years.
7382 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7383 # Durations less than one second are represented with a 0
7384 # `seconds` field and a positive `nanos` field. Must be from 0
7385 # to 999,999,999 inclusive.
7386 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7387 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7388 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7389 },
7390 },
7391 ],
7392 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
7393 # requests into a small number of requests to the origin. If not specified,
7394 # Cloud CDN applies request coalescing by default.
7395 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
7396 # content with the origin, or when an error is encountered when refreshing
7397 # the cache.
7398 # This setting defines the default &quot;max-stale&quot; duration for any cached
7399 # responses that do not specify a max-stale directive. Stale responses that
7400 # exceed the TTL configured here will not be served. The default limit
7401 # (max-stale) is 86400s (1 day), which will allow stale content to be
7402 # served up to this limit beyond the max-age (or s-maxage) of a cached
7403 # response.
7404 # The maximum allowed value is 604800 (1 week).
7405 # Set this to zero (0) to disable serve-while-stale.
7406 # as a count of seconds and fractions of seconds at nanosecond
7407 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7408 # or &quot;month&quot;. Range is approximately 10,000 years.
7409 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7410 # Durations less than one second are represented with a 0
7411 # `seconds` field and a positive `nanos` field. Must be from 0
7412 # to 999,999,999 inclusive.
7413 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7414 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7415 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7416 },
7417 },
7418 &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
7419 # information about the W3C recommendation for cross-origin resource sharing
7420 # (CORS), see Fetch API Living
7421 # Standard.
7422 #
7423 # Not supported when the URL map is bound to a target gRPC proxy.
7424 # information about the W3C recommendation for cross-origin resource sharing
7425 # (CORS), see Fetch API Living
7426 # Standard.
7427 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
7428 # indicates that
7429 # the actual request can include user credentials. This field translates to
7430 # the Access-Control-Allow-Credentials header.
7431 #
7432 # Default is false.
7433 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
7434 # header.
7435 &quot;A String&quot;,
7436 ],
7437 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
7438 # header.
7439 &quot;A String&quot;,
7440 ],
7441 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
7442 # more information, see regular expression syntax.
7443 #
7444 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
7445 #
7446 # Regular expressions can only be used when the loadBalancingScheme is
7447 # set to INTERNAL_SELF_MANAGED.
7448 &quot;A String&quot;,
7449 ],
7450 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
7451 #
7452 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
7453 &quot;A String&quot;,
7454 ],
7455 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
7456 # The default value is false, which indicates that the CORS
7457 # policy is in effect.
7458 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
7459 # header.
7460 &quot;A String&quot;,
7461 ],
7462 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
7463 # seconds. This field translates to the Access-Control-Max-Age
7464 # header.
7465 },
7466 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
7467 # the resiliency of clients to backend service failure. As part of fault
7468 # injection, when clients send requests to a backend service, delays can be
7469 # introduced by a load balancer on a percentage of requests before sending
7470 # those requests to the backend service. Similarly requests from clients can
7471 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
7472 # that are configured with a fault_injection_policy if:
7473 # 1. The traffic is generated by fault injection AND
7474 # 2. The fault injection is not a delay fault injection.
7475 # Fault injection is not supported with the classic Application Load Balancer
7476 # . To see which load balancers support fault injection,
7477 # see Load
7478 # balancing: Routing and traffic management features.
7479 # the resiliency of clients to backend service failure. As part of fault
7480 # injection, when clients send requests to a backend service, delays can be
7481 # introduced by the load balancer on a percentage of requests before sending
7482 # those request to the backend service. Similarly requests from clients can be
7483 # aborted by the load balancer for a percentage of requests.
7484 &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
7485 # injection.
7486 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
7487 #
7488 # The value must be from 200 to 599 inclusive.
7489 #
7490 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
7491 # according to this
7492 # mapping table. HTTP status 200 is mapped to gRPC status
7493 # UNKNOWN. Injecting an OK status is currently not supported by
7494 # Traffic Director.
7495 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
7496 # that is aborted as part of fault injection.
7497 #
7498 # The value must be from 0.0 to 100.0 inclusive.
7499 },
7500 &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
7501 # injection, before being sent to a backend service.
7502 # request to the backend service as part of fault injection.
7503 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
7504 # as a count of seconds and fractions of seconds at nanosecond
7505 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7506 # or &quot;month&quot;. Range is approximately 10,000 years.
7507 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7508 # Durations less than one second are represented with a 0
7509 # `seconds` field and a positive `nanos` field. Must be from 0
7510 # to 999,999,999 inclusive.
7511 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7512 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7513 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7514 },
7515 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
7516 # which a delay is introduced as part of fault injection.
7517 #
7518 # The value must be from 0.0 to 100.0 inclusive.
7519 },
7520 },
7521 &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
7522 # Global EXTERNAL_MANAGED load balancer schemes.
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 # dynamically processes and delivers images from the network edge.
7526 # Image Optimization is only available for Global External Application Load
7527 # Balancers.
7528 # Either Cloud CDN must be enabled on the backend service or backend bucket
7529 # serving the route, or cache policy must be configured on the same route.
7530 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
7531 },
7532 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
7533 # Unlike the timeout field where the timeout duration starts
7534 # from the time the request has been fully processed (known as*end-of-stream*),
7535 # the duration in this field is computed from the beginning of the stream
7536 # until the response has been processed, including all retries. A
7537 # stream that does not complete in this duration is closed.
7538 #
7539 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
7540 # with the route.
7541 #
7542 # This field is only allowed if the Url map is used with backend services
7543 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
7544 # as a count of seconds and fractions of seconds at nanosecond
7545 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7546 # or &quot;month&quot;. Range is approximately 10,000 years.
7547 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7548 # Durations less than one second are represented with a 0
7549 # `seconds` field and a positive `nanos` field. Must be from 0
7550 # to 999,999,999 inclusive.
7551 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7552 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7553 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7554 },
7555 &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
7556 # are shadowed to a separate mirrored backend service. The load balancer does
7557 # not wait for responses from the shadow service. Before sending traffic
7558 # to the shadow service, the host / authority header is suffixed with-shadow.
7559 #
7560 # Not supported when the URL map is bound to a target gRPC proxy that
7561 # has the validateForProxyless field set to true.
7562 # are shadowed to a separate mirrored backend service. The load balancer
7563 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
7564 # to the shadow service, the host or authority header is suffixed with-shadow.
7565 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
7566 # mirrored to.
7567 #
7568 # The backend service configured for a mirroring
7569 # policy must reference backends that are of the same type as the original
7570 # backend service matched in the URL map.
7571 #
7572 # Serverless NEG backends are not currently supported as a mirrored
7573 # backend service.
7574 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
7575 },
7576 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
7577 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
7578 # If not specified, defaults to 1.
7579 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
7580 #
7581 # If not specified, will use the timeout set in theHttpRouteAction field.
7582 # If timeout in the HttpRouteAction field is not set, this field
7583 # uses the largest timeout
7584 # among all backend services associated with the route.
7585 #
7586 # Not supported when the URL map is bound to a target gRPC proxy that
7587 # has the validateForProxyless field set to true.
7588 # as a count of seconds and fractions of seconds at nanosecond
7589 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7590 # or &quot;month&quot;. Range is approximately 10,000 years.
7591 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7592 # Durations less than one second are represented with a 0
7593 # `seconds` field and a positive `nanos` field. Must be from 0
7594 # to 999,999,999 inclusive.
7595 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7596 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7597 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7598 },
7599 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
7600 # values are:
7601 #
7602 # - 5xx: retry is attempted if the instance or endpoint
7603 # responds with any 5xx response code, or if the instance or
7604 # endpoint does not respond at all. For example, disconnects, reset, read
7605 # timeout, connection failure, and refused streams.
7606 # - gateway-error: Similar to 5xx, but only
7607 # applies to response codes 502, 503 or504.
7608 # - connect-failure: a retry is attempted on failures
7609 # connecting to the instance or endpoint. For example, connection
7610 # timeouts.
7611 # - retriable-4xx: a retry is attempted if the instance
7612 # or endpoint responds with a 4xx response code.
7613 # The only error that you can retry is error code 409.
7614 # - refused-stream: a retry is attempted if the instance
7615 # or endpoint resets the stream with a REFUSED_STREAM error
7616 # code. This reset type indicates that it is safe to retry.
7617 # - cancelled: a retry is attempted if the gRPC status
7618 # code in the response header is set to cancelled.
7619 # - deadline-exceeded: a retry is attempted if the gRPC
7620 # status code in the response header is set todeadline-exceeded.
7621 # - internal: a retry is attempted if the gRPC
7622 # status code in the response header is set tointernal.
7623 # - resource-exhausted: a retry is attempted if the gRPC
7624 # status code in the response header is set toresource-exhausted.
7625 # - unavailable: a retry is attempted if the gRPC
7626 # status code in the response header is set tounavailable.
7627 #
7628 # Only the following codes are supported when the URL map is bound to
7629 # target gRPC proxy that has validateForProxyless field set to true.
7630 #
7631 # - cancelled
7632 # - deadline-exceeded
7633 # - internal
7634 # - resource-exhausted
7635 # - unavailable
7636 &quot;A String&quot;,
7637 ],
7638 },
7639 &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
7640 # time the request has been fully processed (known as *end-of-stream*)
7641 # up until the response has been processed. Timeout includes
7642 # all retries.
7643 #
7644 # If not specified, this field uses the largest timeout among all backend
7645 # services associated with the route.
7646 #
7647 # Not supported when the URL map is bound to a target gRPC proxy that
7648 # has validateForProxyless field set to true.
7649 # as a count of seconds and fractions of seconds at nanosecond
7650 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7651 # or &quot;month&quot;. Range is approximately 10,000 years.
7652 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7653 # Durations less than one second are represented with a 0
7654 # `seconds` field and a positive `nanos` field. Must be from 0
7655 # to 999,999,999 inclusive.
7656 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7657 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7658 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7659 },
7660 &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
7661 # to the matched service.
7662 #
7663 # urlRewrite is the only action supported in UrlMaps
7664 # for classic Application Load Balancers.
7665 #
7666 # Not supported when the URL map is bound to a target gRPC proxy that
7667 # has the validateForProxyless field set to true.
7668 # backend service.
7669 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
7670 # host header is replaced with contents of hostRewrite.
7671 #
7672 # The value must be from 1 to 255 characters.
7673 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
7674 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
7675 #
7676 # The value must be from 1 to 1024 characters.
7677 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
7678 # header) using the HTTP template syntax.
7679 #
7680 # A corresponding
7681 # path_template_match must be specified. Any template variables must exist in
7682 # the path_template_match field.
7683 #
7684 #
7685 # - -At least one variable must be specified in the path_template_match
7686 # field
7687 # - You can omit variables from the rewritten URL
7688 # - The * and ** operators cannot be matched
7689 # unless they have a corresponding variable name - e.g.
7690 # {format=*} or {var=**}.
7691 #
7692 # For example, a path_template_match of /static/{format=**}
7693 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
7694 # rewrite, so that /{country}/{format}/{suffix=**} can be
7695 # rewritten as /content/{format}/{country}/{suffix}.
7696 #
7697 # At least
7698 # one non-empty routeRules[].matchRules[].path_template_match is
7699 # required.
7700 #
7701 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
7702 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
7703 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
7704 # It uses RE2 syntax with the following constraints:
7705 #
7706 #
7707 # - Any single character operators
7708 # - Groups are allowed to have only submatch operator inside
7709 # - Groups are allowed only without any char repetition, e.g.
7710 # .*
7711 # - Any char repetition, e.g. .*, is
7712 # only allowed to be used in a single regex together with:
7713 #
7714 #
7715 # - Empty string operators
7716 # - Other repetitions
7717 # - Ranges
7718 # - Repetitions of ranges
7719 #
7720 #
7721 # - Ranges are only allowed to have:
7722 #
7723 #
7724 # - Character range
7725 # - Digits range
7726 # - Symbols listed in characters allowed for ranges
7727 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
7728 # the path.
7729 },
7730 },
7731 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
7732 # occurs. The weights determine the fraction of traffic that flows to
7733 # their corresponding backend service. If all traffic needs to
7734 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
7735 #
7736 # After a backend service is identified and before forwarding
7737 # the request to
7738 # the backend service, advanced routing actions such as URL rewrites and
7739 # header transformations are applied depending on additional settings
7740 # specified in this HttpRouteAction.
7741 { # In contrast to a single BackendService in
7742 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
7743 # multiple backend services. The volume of traffic for each
7744 # backend service is proportional to the weight specified
7745 # in each WeightedBackendService
7746 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
7747 # resource. Before
7748 # forwarding the request to backendService, the load balancer
7749 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
7750 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
7751 # effect for the selected backendService.
7752 #
7753 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
7754 #
7755 # headerAction is not supported for load balancers that have
7756 # their loadBalancingScheme set to EXTERNAL.
7757 #
7758 # Not supported when the URL map is bound to a target gRPC proxy that
7759 # has validateForProxyless field set to true.
7760 # the request is passed along to the selected backendService.
7761 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
7762 { # Specification determining how headers are added to requests or responses.
7763 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
7764 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
7765 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
7766 # that already
7767 # exist for the header. If true, headerValue is set for the
7768 # header, discarding any values that were set for that header.
7769 #
7770 # The default value is true,
7771 # unless a variable is present in headerValue,
7772 # in which case the default value is false.
7773 # .
7774 },
7775 ],
7776 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
7777 # request before forwarding the request to the backendService.
7778 &quot;A String&quot;,
7779 ],
7780 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
7781 # client.
7782 { # Specification determining how headers are added to requests or responses.
7783 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
7784 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
7785 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
7786 # that already
7787 # exist for the header. If true, headerValue is set for the
7788 # header, discarding any values that were set for that header.
7789 #
7790 # The default value is true,
7791 # unless a variable is present in headerValue,
7792 # in which case the default value is false.
7793 # .
7794 },
7795 ],
7796 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
7797 # response before sending the response back to the client.
7798 &quot;A String&quot;,
7799 ],
7800 },
7801 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
7802 # computed asweight / (sum of all weightedBackendService weights in routeAction).
7803 #
7804 # The selection of a backend service is determined only for new traffic.
7805 # Once a user&#x27;s request has been directed to a backend service,
7806 # subsequent requests are sent to the same backend service as
7807 # determined by the backend service&#x27;s session affinity policy.
7808 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
7809 # splitting. If you do, the weighted traffic splitting configuration takes
7810 # precedence.
7811 #
7812 # The value must be from 0 to 1000.
7813 },
7814 ],
7815 },
7816 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
7817 # is directed if this rule is matched. If routeAction is
7818 # also specified, advanced routing actions, such as URL rewrites,
7819 # take effect before sending the request to the backend.
7820 #
7821 #
7822 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
7823 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
7824 # specified by urlRedirect.
7825 #
7826 #
7827 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
7828 #
7829 #
7830 # Not supported when the URL map is bound to a target gRPC proxy.
7831 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
7832 # was supplied in the request.
7833 #
7834 # The value must be from 1 to 255
7835 # characters.
7836 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
7837 # set to HTTPS.
7838 # If set to false, the URL scheme of the redirected request
7839 # remains the same as that of the request.
7840 #
7841 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
7842 #
7843 # The default is set to false.
7844 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
7845 # that was supplied in the request.
7846 #
7847 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
7848 # supplied, the path of the original request is used for the redirect.
7849 #
7850 # The value must be from 1 to 1024 characters.
7851 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
7852 # the HttpRouteRuleMatch, retaining the remaining portion
7853 # of the URL before redirecting the request.
7854 #
7855 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
7856 # supplied, the path of the original request is used for the redirect.
7857 #
7858 # The value must be from 1 to 1024 characters.
7859 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
7860 #
7861 # Supported values are:
7862 #
7863 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
7864 # to 301.
7865 # - FOUND, which corresponds to 302.
7866 # - SEE_OTHER which corresponds to 303.
7867 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
7868 # method is retained.
7869 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
7870 # method is retained.
7871 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
7872 # URL is
7873 # removed before redirecting the request. If set to false, the
7874 # query portion of the original URL is retained.
7875 #
7876 # The default is set to false.
7877 },
7878 },
7879 ],
7880 },
7881 ],
7882 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the regional URL map resides.
7883 # This field is not applicable to global URL maps.
7884 # You must specify this field as part of the HTTP request URL. It is
7885 # not settable as a field in the request body.
7886 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
7887 &quot;status&quot;: { # [Output Only] The status of the URL map. # Output only. [Output Only] The status of the URL map.
7888 &quot;quotaUsage&quot;: { # Message representing the quota usage for a UrlMap. # Output only. Summary of quota usage for given UrlMap.
7889 &quot;forwardingRules&quot;: 42, # Output only. The number of forwarding rules that uses this UrlMap.
7890 &quot;units&quot;: &quot;A String&quot;, # Output only. The number of quota units calculated for this UrlMap.
7891 },
7892 },
7893 &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
7894 # maximum of 100 tests per UrlMap.
7895 #
7896 # Not supported when the URL map is bound to a target gRPC proxy that
7897 # has validateForProxyless field set to true.
7898 { # Message for the expected URL mappings.
7899 &quot;backendServiceWeight&quot;: 42, # The weight to use for the supplied host and path when using advanced
7900 # routing rules that involve traffic splitting.
7901 &quot;description&quot;: &quot;A String&quot;, # Description of this test case.
7902 &quot;expectedOutputUrl&quot;: &quot;A String&quot;, # The expected output URL evaluated by the load balancer
7903 # containing the scheme, host, path and query parameters.
7904 #
7905 # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
7906 # the load balancer to backends. For rules with urlRewrite,
7907 # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
7908 #
7909 # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer&#x27;s
7910 # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
7911 # If urlRedirect specifies strip_query, the test
7912 # passes only if expectedOutputUrl does not contain any query
7913 # parameters.
7914 #
7915 # expectedOutputUrl is optional whenservice is specified.
7916 &quot;expectedRedirectResponseCode&quot;: 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
7917 # load balancer&#x27;s redirect response.
7918 #
7919 # expectedRedirectResponseCode cannot be set whenservice is set.
7920 &quot;expectedUrlRedirect&quot;: &quot;A String&quot;, # The expected URL that should be redirected to for the host and path
7921 # being tested.
7922 # [Deprecated] This field is deprecated.
7923 # Use expected_output_url instead.
7924 &quot;headers&quot;: [ # HTTP headers for this request. If headers contains
7925 # a host header, then host must also match the header value.
7926 { # HTTP headers used in UrlMapTests.
7927 &quot;name&quot;: &quot;A String&quot;, # Header name.
7928 &quot;value&quot;: &quot;A String&quot;, # Header value.
7929 },
7930 ],
7931 &quot;host&quot;: &quot;A String&quot;, # Host portion of the URL. If headers contains a host header,
7932 # then host must also match the header value.
7933 &quot;path&quot;: &quot;A String&quot;, # Path portion of the URL.
7934 &quot;service&quot;: &quot;A String&quot;, # Expected BackendService or BackendBucket resource
7935 # the given URL should be mapped to.
7936 #
7937 # The service field cannot
7938 # be set if expectedRedirectResponseCode is set.
7939 },
7940 ],
7941 }
7942
7943 requestId: string, begin_interface: MixerMutationRequestBuilder
7944 Request ID to support idempotency.
7945 x__xgafv: string, V1 error format.
7946 Allowed values
7947 1 - v1 error format
7948 2 - v2 error format
7949
7950 Returns:
7951 An object of the form:
7952
7953 { # Represents an Operation resource.
7954 #
7955 # Google Compute Engine has three Operation resources:
7956 #
7957 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
7958 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
7959 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
7960 #
7961 # You can use an operation resource to manage asynchronous API requests.
7962 # For more information, readHandling
7963 # API responses.
7964 #
7965 # Operations can be global, regional or zonal.
7966 #
7967 # - For global operations, use the `globalOperations`
7968 # resource.
7969 # - For regional operations, use the
7970 # `regionOperations` resource.
7971 # - For zonal operations, use
7972 # the `zoneOperations` resource.
7973 #
7974 #
7975 #
7976 # For more information, read
7977 # Global, Regional, and Zonal Resources.
7978 #
7979 # Note that completed Operation resources have a limited
7980 # retention period.
7981 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
7982 # Not present otherwise.
7983 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
7984 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
7985 # set when the operation is created.
7986 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
7987 # text format.
7988 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
7989 # this field will be populated.
7990 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
7991 # operation.
7992 {
7993 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
7994 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
7995 # details. There is a set of defined message types to use for providing
7996 # details.The syntax depends on the error code. For example,
7997 # QuotaExceededInfo will have details when the error code is
7998 # QUOTA_EXCEEDED.
7999 {
8000 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
8001 #
8002 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
8003 # is not enabled:
8004 #
8005 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
8006 # &quot;domain&quot;: &quot;googleapis.com&quot;
8007 # &quot;metadata&quot;: {
8008 # &quot;resource&quot;: &quot;projects/123&quot;,
8009 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
8010 # }
8011 # }
8012 #
8013 # This response indicates that the pubsub.googleapis.com API is not enabled.
8014 #
8015 # Example of an error that is returned when attempting to create a Spanner
8016 # instance in a region that is out of stock:
8017 #
8018 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
8019 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
8020 # &quot;metadata&quot;: {
8021 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
8022 # }
8023 # }
8024 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
8025 # is typically the registered service name of the tool or product that
8026 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
8027 # generated by some common infrastructure, the error domain must be a
8028 # globally unique value that identifies the infrastructure. For Google API
8029 # infrastructure, the error domain is &quot;googleapis.com&quot;.
8030 &quot;metadatas&quot;: { # Additional structured details about this error.
8031 #
8032 # Keys must match a regular expression of `a-z+` but should
8033 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
8034 # length. When identifying the current value of an exceeded limit, the units
8035 # should be contained in the key, not the value. For example, rather than
8036 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
8037 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
8038 # instances that can be created in a single (batch) request.
8039 &quot;a_key&quot;: &quot;A String&quot;,
8040 },
8041 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
8042 # proximate cause of the error. Error reasons are unique within a particular
8043 # domain of errors. This should be at most 63 characters and match a
8044 # regular expression of `A-Z+[A-Z0-9]`, which represents
8045 # UPPER_SNAKE_CASE.
8046 },
8047 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
8048 #
8049 # For example, if a quota check failed with an error indicating the calling
8050 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
8051 # directly to the right place in the developer console to flip the bit.
8052 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
8053 { # Describes a URL link.
8054 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
8055 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
8056 },
8057 ],
8058 },
8059 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
8060 # which can be attached to an RPC error.
8061 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
8062 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
8063 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
8064 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
8065 },
8066 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
8067 &quot;dimensions&quot;: { # The map holding related quota dimensions.
8068 &quot;a_key&quot;: &quot;A String&quot;,
8069 },
8070 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
8071 # type or metric.
8072 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
8073 # or metric.
8074 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
8075 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
8076 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
8077 },
8078 },
8079 ],
8080 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
8081 # This property is optional.
8082 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
8083 },
8084 ],
8085 },
8086 &quot;getVersionOperationMetadata&quot;: {
8087 &quot;inlineSbomInfo&quot;: {
8088 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
8089 # appropriate identifiers.
8090 &quot;a_key&quot;: &quot;A String&quot;,
8091 },
8092 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
8093 # identifiers.
8094 &quot;a_key&quot;: &quot;A String&quot;,
8095 },
8096 },
8097 },
8098 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
8099 # message that was returned, such as `NOT FOUND`.
8100 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
8101 # status code that was returned. For example, a `404` means the
8102 # resource was not found.
8103 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
8104 # defined by the server.
8105 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
8106 # This value is inRFC3339
8107 # text format.
8108 &quot;instancesBulkInsertOperationMetadata&quot;: {
8109 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
8110 # Example key: zones/us-central1-a
8111 &quot;a_key&quot;: {
8112 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
8113 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
8114 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
8115 # error.
8116 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
8117 # if the flow is rolling forward or rolling back.
8118 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
8119 },
8120 },
8121 },
8122 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
8123 # Operation resources.
8124 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
8125 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
8126 # group of operations results from a `bulkInsert` API request.
8127 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
8128 # `update`, or `delete`, and so on.
8129 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
8130 # There is no requirement that this be linear or support any granularity of
8131 # operations. This should not be used to guess when the operation will be
8132 # complete. This number should monotonically increase as the operation
8133 # progresses.
8134 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
8135 # applicable when performing regional operations.
8136 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
8137 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
8138 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
8139 # this field will contain information on all underlying zonal actions and
8140 # their state.
8141 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
8142 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
8143 # Example key: zones/us-central1-a
8144 &quot;a_key&quot;: {
8145 &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
8146 # populated.
8147 # different programming environments, including REST APIs and RPC APIs. It is
8148 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
8149 # three pieces of data: error code, error message, and error details.
8150 #
8151 # You can find out more about this error model and how to work with it in the
8152 # [API Design Guide](https://cloud.google.com/apis/design/errors).
8153 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
8154 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
8155 # message types for APIs to use.
8156 {
8157 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
8158 },
8159 ],
8160 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
8161 # user-facing error message should be localized and sent in the
8162 # google.rpc.Status.details field, or localized by the client.
8163 },
8164 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
8165 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
8166 },
8167 },
8168 },
8169 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
8170 # This value is inRFC3339
8171 # text format.
8172 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
8173 # following:
8174 # `PENDING`, `RUNNING`, or `DONE`.
8175 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
8176 # operation.
8177 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
8178 # of the target resource.
8179 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
8180 # operations related to creating a snapshot, this points to the disk
8181 # that the snapshot was created from.
8182 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
8183 # `[email protected]` or
8184 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
8185 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
8186 # operation, this field will be populated.
8187 {
8188 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
8189 # Engine returns NO_RESULTS_ON_PAGE if there
8190 # are no results in the response.
8191 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
8192 # value format. For example:
8193 #
8194 # &quot;data&quot;: [
8195 # {
8196 # &quot;key&quot;: &quot;scope&quot;,
8197 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
8198 # }
8199 {
8200 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
8201 # returned. For example, for warnings where there are no results in a list
8202 # request for a particular zone, this key might be scope and
8203 # the key value might be the zone name. Other examples might be a key
8204 # indicating a deprecated resource and a suggested replacement, or a
8205 # warning about invalid network settings (for example, if an instance
8206 # attempts to perform IP forwarding but is not enabled for IP forwarding).
8207 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
8208 },
8209 ],
8210 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
8211 },
8212 ],
8213 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
8214 # applicable when performing per-zone operations.
8215 }</pre>
8216 </div>
8217
8218 <div class="method">
8219 <code class="details" id="invalidateCache">invalidateCache(project, region, urlMap, body=None, requestId=None, x__xgafv=None)</code>
8220 <pre>Initiates a cache invalidation operation, invalidating the specified path,
8221 scoped to the specified UrlMap.
8222
8223 For more information, see [Invalidating cached
8224 content](/cdn/docs/invalidating-cached-content).
8225
8226 Args:
8227 project: string, Project ID for this request. (required)
8228 region: string, Name of the region scoping this request. (required)
8229 urlMap: string, Name of the UrlMap scoping this request. (required)
8230 body: object, The request body.
8231 The object takes the form of:
8232
8233 {
8234 &quot;backendService&quot;: &quot;A String&quot;, # If set, this invalidation rule will only apply to requests routed to the
8235 # given backend service or backend bucket.
8236 # For example, for a backend bucket `bb1` in the same scope as the URL map,
8237 # the path would be `projects/my-project/global/backendBuckets/bb1`; and
8238 # for a backend service `bs1` in the same scope as the URL map, the path
8239 # would be `projects/my-project/global/backendServices/bs1`.
8240 &quot;cacheTags&quot;: [ # A list of cache tags used to identify cached objects.
8241 #
8242 #
8243 # - Cache tags are specified when the response is first cached, by setting
8244 # the `Cache-Tag` response header at the origin.
8245 # - Multiple cache tags in the same invalidation request are treated as
8246 # Boolean `OR` - for example, `tag1 OR tag2 OR tag3`.
8247 # - If other fields are also specified, these are treated as Boolean `AND`
8248 # with any tags.
8249 #
8250 #
8251 # Up to 10 tags can be specified in a single invalidation request.
8252 &quot;A String&quot;,
8253 ],
8254 &quot;contentType&quot;: &quot;A String&quot;, # If set, this invalidation rule will only apply to responses with the given
8255 # content-type. Parameters are not allowed and are ignored from the response
8256 # when matching. Wildcards are not allowed.
8257 &quot;host&quot;: &quot;A String&quot;, # If set, this invalidation rule will only apply to requests with a Host
8258 # header matching host.
8259 &quot;httpStatus&quot;: 42, # If set, this invalidation rule will only apply to responses with the
8260 # given HTTP status. Valid range is 200-599.
8261 &quot;path&quot;: &quot;A String&quot;,
8262 }
8263
8264 requestId: string, begin_interface: MixerMutationRequestBuilder
8265 Request ID to support idempotency.
8266 x__xgafv: string, V1 error format.
8267 Allowed values
8268 1 - v1 error format
8269 2 - v2 error format
8270
8271 Returns:
8272 An object of the form:
8273
8274 { # Represents an Operation resource.
8275 #
8276 # Google Compute Engine has three Operation resources:
8277 #
8278 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
8279 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
8280 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
8281 #
8282 # You can use an operation resource to manage asynchronous API requests.
8283 # For more information, readHandling
8284 # API responses.
8285 #
8286 # Operations can be global, regional or zonal.
8287 #
8288 # - For global operations, use the `globalOperations`
8289 # resource.
8290 # - For regional operations, use the
8291 # `regionOperations` resource.
8292 # - For zonal operations, use
8293 # the `zoneOperations` resource.
8294 #
8295 #
8296 #
8297 # For more information, read
8298 # Global, Regional, and Zonal Resources.
8299 #
8300 # Note that completed Operation resources have a limited
8301 # retention period.
8302 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
8303 # Not present otherwise.
8304 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
8305 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
8306 # set when the operation is created.
8307 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
8308 # text format.
8309 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
8310 # this field will be populated.
8311 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
8312 # operation.
8313 {
8314 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
8315 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
8316 # details. There is a set of defined message types to use for providing
8317 # details.The syntax depends on the error code. For example,
8318 # QuotaExceededInfo will have details when the error code is
8319 # QUOTA_EXCEEDED.
8320 {
8321 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
8322 #
8323 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
8324 # is not enabled:
8325 #
8326 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
8327 # &quot;domain&quot;: &quot;googleapis.com&quot;
8328 # &quot;metadata&quot;: {
8329 # &quot;resource&quot;: &quot;projects/123&quot;,
8330 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
8331 # }
8332 # }
8333 #
8334 # This response indicates that the pubsub.googleapis.com API is not enabled.
8335 #
8336 # Example of an error that is returned when attempting to create a Spanner
8337 # instance in a region that is out of stock:
8338 #
8339 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
8340 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
8341 # &quot;metadata&quot;: {
8342 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
8343 # }
8344 # }
8345 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
8346 # is typically the registered service name of the tool or product that
8347 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
8348 # generated by some common infrastructure, the error domain must be a
8349 # globally unique value that identifies the infrastructure. For Google API
8350 # infrastructure, the error domain is &quot;googleapis.com&quot;.
8351 &quot;metadatas&quot;: { # Additional structured details about this error.
8352 #
8353 # Keys must match a regular expression of `a-z+` but should
8354 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
8355 # length. When identifying the current value of an exceeded limit, the units
8356 # should be contained in the key, not the value. For example, rather than
8357 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
8358 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
8359 # instances that can be created in a single (batch) request.
8360 &quot;a_key&quot;: &quot;A String&quot;,
8361 },
8362 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
8363 # proximate cause of the error. Error reasons are unique within a particular
8364 # domain of errors. This should be at most 63 characters and match a
8365 # regular expression of `A-Z+[A-Z0-9]`, which represents
8366 # UPPER_SNAKE_CASE.
8367 },
8368 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
8369 #
8370 # For example, if a quota check failed with an error indicating the calling
8371 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
8372 # directly to the right place in the developer console to flip the bit.
8373 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
8374 { # Describes a URL link.
8375 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
8376 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
8377 },
8378 ],
8379 },
8380 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
8381 # which can be attached to an RPC error.
8382 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
8383 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
8384 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
8385 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
8386 },
8387 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
8388 &quot;dimensions&quot;: { # The map holding related quota dimensions.
8389 &quot;a_key&quot;: &quot;A String&quot;,
8390 },
8391 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
8392 # type or metric.
8393 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
8394 # or metric.
8395 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
8396 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
8397 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
8398 },
8399 },
8400 ],
8401 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
8402 # This property is optional.
8403 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
8404 },
8405 ],
8406 },
8407 &quot;getVersionOperationMetadata&quot;: {
8408 &quot;inlineSbomInfo&quot;: {
8409 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
8410 # appropriate identifiers.
8411 &quot;a_key&quot;: &quot;A String&quot;,
8412 },
8413 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
8414 # identifiers.
8415 &quot;a_key&quot;: &quot;A String&quot;,
8416 },
8417 },
8418 },
8419 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
8420 # message that was returned, such as `NOT FOUND`.
8421 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
8422 # status code that was returned. For example, a `404` means the
8423 # resource was not found.
8424 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
8425 # defined by the server.
8426 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
8427 # This value is inRFC3339
8428 # text format.
8429 &quot;instancesBulkInsertOperationMetadata&quot;: {
8430 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
8431 # Example key: zones/us-central1-a
8432 &quot;a_key&quot;: {
8433 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
8434 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
8435 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
8436 # error.
8437 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
8438 # if the flow is rolling forward or rolling back.
8439 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
8440 },
8441 },
8442 },
8443 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
8444 # Operation resources.
8445 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
8446 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
8447 # group of operations results from a `bulkInsert` API request.
8448 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
8449 # `update`, or `delete`, and so on.
8450 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
8451 # There is no requirement that this be linear or support any granularity of
8452 # operations. This should not be used to guess when the operation will be
8453 # complete. This number should monotonically increase as the operation
8454 # progresses.
8455 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
8456 # applicable when performing regional operations.
8457 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
8458 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
8459 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
8460 # this field will contain information on all underlying zonal actions and
8461 # their state.
8462 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
8463 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
8464 # Example key: zones/us-central1-a
8465 &quot;a_key&quot;: {
8466 &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
8467 # populated.
8468 # different programming environments, including REST APIs and RPC APIs. It is
8469 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
8470 # three pieces of data: error code, error message, and error details.
8471 #
8472 # You can find out more about this error model and how to work with it in the
8473 # [API Design Guide](https://cloud.google.com/apis/design/errors).
8474 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
8475 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
8476 # message types for APIs to use.
8477 {
8478 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
8479 },
8480 ],
8481 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
8482 # user-facing error message should be localized and sent in the
8483 # google.rpc.Status.details field, or localized by the client.
8484 },
8485 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
8486 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
8487 },
8488 },
8489 },
8490 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
8491 # This value is inRFC3339
8492 # text format.
8493 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
8494 # following:
8495 # `PENDING`, `RUNNING`, or `DONE`.
8496 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
8497 # operation.
8498 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
8499 # of the target resource.
8500 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
8501 # operations related to creating a snapshot, this points to the disk
8502 # that the snapshot was created from.
8503 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
8504 # `[email protected]` or
8505 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
8506 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
8507 # operation, this field will be populated.
8508 {
8509 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
8510 # Engine returns NO_RESULTS_ON_PAGE if there
8511 # are no results in the response.
8512 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
8513 # value format. For example:
8514 #
8515 # &quot;data&quot;: [
8516 # {
8517 # &quot;key&quot;: &quot;scope&quot;,
8518 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
8519 # }
8520 {
8521 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
8522 # returned. For example, for warnings where there are no results in a list
8523 # request for a particular zone, this key might be scope and
8524 # the key value might be the zone name. Other examples might be a key
8525 # indicating a deprecated resource and a suggested replacement, or a
8526 # warning about invalid network settings (for example, if an instance
8527 # attempts to perform IP forwarding but is not enabled for IP forwarding).
8528 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
8529 },
8530 ],
8531 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
8532 },
8533 ],
8534 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
8535 # applicable when performing per-zone operations.
8536 }</pre>
8537 </div>
8538
8539 <div class="method">
8540 <code class="details" id="list">list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</code>
8541 <pre>Retrieves the list of UrlMap resources available to the specified
8542 project in the specified region.
8543
8544 Args:
8545 project: string, Project ID for this request. (required)
8546 region: string, Name of the region scoping this request. (required)
8547 filter: string, A filter expression that filters resources listed in the response. Most
8548 Compute resources support two types of filter expressions:
8549 expressions that support regular expressions and expressions that follow
8550 API improvement proposal AIP-160.
8551 These two types of filter expressions cannot be mixed in one request.
8552
8553 If you want to use AIP-160, your expression must specify the field name, an
8554 operator, and the value that you want to use for filtering. The value
8555 must be a string, a number, or a boolean. The operator
8556 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
8557
8558 For example, if you are filtering Compute Engine instances, you can
8559 exclude instances named `example-instance` by specifying
8560 `name != example-instance`.
8561
8562 The `:*` comparison can be used to test whether a key has been defined.
8563 For example, to find all objects with `owner` label use:
8564 ```
8565 labels.owner:*
8566 ```
8567
8568 You can also filter nested fields. For example, you could specify
8569 `scheduling.automaticRestart = false` to include instances only
8570 if they are not scheduled for automatic restarts. You can use filtering
8571 on nested fields to filter based onresource labels.
8572
8573 To filter on multiple expressions, provide each separate expression within
8574 parentheses. For example:
8575 ```
8576 (scheduling.automaticRestart = true)
8577 (cpuPlatform = &quot;Intel Skylake&quot;)
8578 ```
8579 By default, each expression is an `AND` expression. However, you
8580 can include `AND` and `OR` expressions explicitly.
8581 For example:
8582 ```
8583 (cpuPlatform = &quot;Intel Skylake&quot;) OR
8584 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
8585 (scheduling.automaticRestart = true)
8586 ```
8587
8588 If you want to use a regular expression, use the `eq` (equal) or `ne`
8589 (not equal) operator against a single un-parenthesized expression with or
8590 without quotes or against multiple parenthesized expressions. Examples:
8591
8592 `fieldname eq unquoted literal`
8593 `fieldname eq &#x27;single quoted literal&#x27;`
8594 `fieldname eq &quot;double quoted literal&quot;`
8595 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
8596
8597 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
8598 The literal value must match the entire field.
8599
8600 For example, to filter for instances that do not end with name &quot;instance&quot;,
8601 you would use `name ne .*instance`.
8602
8603 You cannot combine constraints on multiple fields using regular
8604 expressions.
8605 maxResults: integer, The maximum number of results per page that should be returned.
8606 If the number of available results is larger than `maxResults`,
8607 Compute Engine returns a `nextPageToken` that can be used to get
8608 the next page of results in subsequent list requests. Acceptable values are
8609 `0` to `500`, inclusive. (Default: `500`)
8610 orderBy: string, Sorts list results by a certain order. By default, results
8611 are returned in alphanumerical order based on the resource name.
8612
8613 You can also sort results in descending order based on the creation
8614 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
8615 results based on the `creationTimestamp` field in
8616 reverse chronological order (newest result first). Use this to sort
8617 resources like operations so that the newest operation is returned first.
8618
8619 Currently, only sorting by `name` or
8620 `creationTimestamp desc` is supported.
8621 pageToken: string, Specifies a page token to use. Set `pageToken` to the
8622 `nextPageToken` returned by a previous list request to get
8623 the next page of results.
8624 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
8625 of failure. The default value is false.
8626
8627 For example, when partial success behavior is enabled, aggregatedList for a
8628 single zone scope either returns all resources in the zone or no resources,
8629 with an error code.
8630 x__xgafv: string, V1 error format.
8631 Allowed values
8632 1 - v1 error format
8633 2 - v2 error format
8634
8635 Returns:
8636 An object of the form:
8637
8638 { # Contains a list of UrlMap resources.
8639 &quot;id&quot;: &quot;A String&quot;, # [Output Only] Unique identifier for the resource; defined by the server.
8640 &quot;items&quot;: [ # A list of UrlMap resources.
8641 { # Represents a URL Map resource.
8642 #
8643 # Compute Engine has two URL Map resources:
8644 #
8645 # * [Global](/compute/docs/reference/rest/alpha/urlMaps)
8646 # * [Regional](/compute/docs/reference/rest/alpha/regionUrlMaps)
8647 #
8648 # A URL map resource is a component of certain types of cloud load balancers
8649 # and Traffic Director:
8650 #
8651 # * urlMaps are used by global external Application Load
8652 # Balancers, classic Application Load Balancers, and cross-region internal
8653 # Application Load Balancers.
8654 # * regionUrlMaps are used by internal Application Load Balancers,
8655 # regional external Application Load Balancers and regional internal
8656 # Application Load Balancers.
8657 #
8658 # For a list of supported URL map features by the load balancer type, see the
8659 # Load balancing features: Routing and traffic management table.
8660 #
8661 # For a list of supported URL map features for Traffic Director, see the
8662 # Traffic Director features: Routing and traffic management table.
8663 #
8664 # This resource defines mappings from hostnames and URL paths to either a
8665 # backend service or a backend bucket.
8666 #
8667 # To use the global urlMaps resource, the backend service must
8668 # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
8669 # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
8670 # information, read URL
8671 # Map Concepts.
8672 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
8673 # text format.
8674 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
8675 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
8676 #
8677 # This policy takes
8678 # effect at the load balancer level and applies only when no policy has been
8679 # defined for the error code at lower levels like PathMatcher, RouteRule and
8680 # PathRule within this UrlMap.
8681 #
8682 # For example, consider a UrlMap with the
8683 # following configuration:
8684 #
8685 #
8686 # - defaultCustomErrorResponsePolicy containing policies for
8687 # responding to 5xx and 4xx errors
8688 # - A PathMatcher configured for *.example.com has
8689 # defaultCustomErrorResponsePolicy for 4xx.
8690 #
8691 # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
8692 # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
8693 # a request that does not match any host in *.example.com such
8694 # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
8695 # takes effect.
8696 #
8697 # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
8698 # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
8699 # a retry, if load balancer is successful in reaching the
8700 # service, the defaultCustomErrorResponsePolicy is ignored and
8701 # the response from the service is returned to the client.
8702 #
8703 # defaultCustomErrorResponsePolicy is supported only for
8704 # global external Application Load Balancers.
8705 # backend service or backend bucket responds with an error.
8706 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
8707 #
8708 # In a given policy, if you specify rules for both a range of error codes
8709 # as well as rules for specific error codes then rules with specific error
8710 # codes have a higher priority. For example, assume that you configure a rule
8711 # for 401 (Un-authorized) code, and another for all 4 series
8712 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
8713 # However if the backend service returns a 403, the rule for4xx takes effect.
8714 { # Specifies the mapping between the response code that will be returned along
8715 # with the custom error content and the response code returned by the backend
8716 # service.
8717 &quot;matchResponseCodes&quot;: [ # Valid values include:
8718 #
8719 #
8720 # - A number between 400 and 599: For example
8721 # 401 or 503, in which case the load balancer
8722 # applies the policy if the error code exactly matches this value.
8723 # - 5xx: Load Balancer will apply the policy if the
8724 # backend service responds with any response code in the range of
8725 # 500 to 599.
8726 # - 4xx: Load
8727 # Balancer will apply the policy if the backend service responds with any
8728 # response code in the range of 400 to
8729 # 499.
8730 #
8731 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
8732 &quot;A String&quot;,
8733 ],
8734 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
8735 # error content. If overrideResponseCode is not supplied, the
8736 # same response code returned by the original backend bucket or backend
8737 # service is returned to the client.
8738 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
8739 #
8740 # path must start
8741 # with a leading slash. path cannot have trailing slashes.
8742 #
8743 # If the file is not available in backendBucket or the
8744 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
8745 #
8746 # The value must
8747 # be from 1 to 1024 characters
8748 },
8749 ],
8750 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
8751 # contains the custom error content. Examples are:
8752 #
8753 #
8754 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
8755 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
8756 # - global/backendBuckets/myBackendBucket
8757 #
8758 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
8759 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
8760 #
8761 # If load balancer cannot reach
8762 # the backendBucket, a simple Not Found Error will
8763 # be returned, with the original response code (oroverrideResponseCode if configured).
8764 #
8765 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
8766 },
8767 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
8768 # hostRules match. The load balancer performs advanced routing
8769 # actions, such as URL rewrites and header transformations, before forwarding
8770 # the request to the selected backend.
8771 #
8772 #
8773 # Only one of defaultUrlRedirect, defaultService
8774 # or defaultRouteAction.weightedBackendService can be set.
8775 #
8776 #
8777 # URL maps for classic Application Load Balancers only support
8778 # the urlRewrite action within defaultRouteAction.
8779 #
8780 #
8781 # defaultRouteAction has no effect when the URL map is bound
8782 # to a target gRPC proxy that has the validateForProxyless field
8783 # set to true.
8784 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
8785 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
8786 # property must be specified. This policy cannot be specified if any target
8787 # backend has Identity-Aware Proxy enabled.
8788 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
8789 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
8790 # header names can be specified. The cache is bypassed for all `cacheMode`
8791 # values.
8792 &quot;A String&quot;,
8793 ],
8794 &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
8795 # on the backend type: for Backend Services, the complete request URI is
8796 # used; for Backend Buckets, the request URI is used without the protocol or
8797 # host, and only query parameters known to Cloud Storage are included.
8798 # Policy defined on Route Action.
8799 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
8800 # parameters will be included. Either specify `excludedQueryParameters`
8801 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
8802 # encoded and not treated as delimiters.
8803 #
8804 # Note: This field applies to routes that use backend services. Attempting
8805 # to set it on a route that points exclusively to Backend Buckets will
8806 # result in a configuration error. For routes that point to a Backend
8807 # Bucket, use `includedQueryParameters` to define which parameters should
8808 # be part of the cache key.
8809 &quot;A String&quot;,
8810 ],
8811 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
8812 #
8813 # Note: This setting is only applicable to routes that use a Backend
8814 # Service. It does not affect requests served by a Backend Bucket, as the
8815 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
8816 # it on a route that points exclusively to Backend Buckets will result in a
8817 # configuration error.
8818 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
8819 #
8820 # Note: This setting is only applicable to routes that use a Backend
8821 # Service. It does not affect requests served by a Backend Bucket, as the
8822 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
8823 # set on a route that points exclusively to Backend Buckets will result in
8824 # a configuration error.
8825 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
8826 # `includedQueryParameters` and `excludedQueryParameters`. If neither
8827 # is set, the entire query string will be included. If false, the query
8828 # string will be excluded from the cache key entirely.
8829 #
8830 # Note: This field applies to routes that use backend services. Attempting
8831 # to set it on a route that points exclusively to Backend Buckets will
8832 # result in a configuration error. For routes that point to a Backend
8833 # Bucket, use `includedQueryParameters` to define which parameters should
8834 # be part of the cache key.
8835 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
8836 # The name=value pair will be used in the cache key Cloud CDN generates.
8837 #
8838 # Note: This setting is only applicable to routes that use a Backend
8839 # Service. It does not affect requests served by a Backend Bucket.
8840 # Attempting to set it on a route that points exclusively to Backend
8841 # Buckets will result in a configuration error. Up to 5 cookie names can be
8842 # specified.
8843 &quot;A String&quot;,
8844 ],
8845 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
8846 &quot;A String&quot;,
8847 ],
8848 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
8849 # parameters will be excluded. Either specify `includedQueryParameters`
8850 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
8851 # encoded and not treated as delimiters.
8852 &quot;A String&quot;,
8853 ],
8854 },
8855 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
8856 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
8857 &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
8858 # content. This is used to clamp the max-age (or Expires) value sent to the
8859 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
8860 # is used for the response max-age directive, along with a &quot;public&quot;
8861 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
8862 # clamps the max-age from the origin (if specified), or else sets the
8863 # response max-age directive to the lesser of the `clientTtl` and
8864 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
8865 # present. The maximum allowed value is 31,622,400s (1 year). If not
8866 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
8867 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
8868 # `USE_ORIGIN_HEADERS`.
8869 # as a count of seconds and fractions of seconds at nanosecond
8870 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8871 # or &quot;month&quot;. Range is approximately 10,000 years.
8872 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8873 # Durations less than one second are represented with a 0
8874 # `seconds` field and a positive `nanos` field. Must be from 0
8875 # to 999,999,999 inclusive.
8876 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8877 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8878 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8879 },
8880 &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
8881 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
8882 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
8883 # greater than that of `maxTtl`. When the `cacheMode` is set to
8884 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
8885 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
8886 # accessed objects may be evicted from the cache before the defined TTL. If
8887 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
8888 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
8889 # `USE_ORIGIN_HEADERS`.
8890 # as a count of seconds and fractions of seconds at nanosecond
8891 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8892 # or &quot;month&quot;. Range is approximately 10,000 years.
8893 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8894 # Durations less than one second are represented with a 0
8895 # `seconds` field and a positive `nanos` field. Must be from 0
8896 # to 999,999,999 inclusive.
8897 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8898 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8899 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8900 },
8901 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
8902 # attempt to set a max-age or s-maxage higher than this, or an Expires header
8903 # more than `maxTtl` seconds in the future will be capped at the value of
8904 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
8905 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
8906 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
8907 # Infrequently accessed objects may be evicted from the cache before the
8908 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
8909 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
8910 # mode.
8911 # as a count of seconds and fractions of seconds at nanosecond
8912 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8913 # or &quot;month&quot;. Range is approximately 10,000 years.
8914 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8915 # Durations less than one second are represented with a 0
8916 # `seconds` field and a positive `nanos` field. Must be from 0
8917 # to 999,999,999 inclusive.
8918 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8919 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8920 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8921 },
8922 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
8923 # to apply fine-grained caching for common errors or redirects.
8924 # This can reduce the load on your origin and improve end-user
8925 # experience by reducing response latency.
8926 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
8927 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
8928 # the specified response code that lack any Cache-Control, Expires, or
8929 # Pragma: no-cache directives. When the `cacheMode` is set to
8930 # `FORCE_CACHE_ALL`, negative caching applies to all responses
8931 # with the specified response code, and overrides any caching headers. By
8932 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
8933 #
8934 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
8935 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
8936 # * 405 (Method Not Found), 501 (Not Implemented): 60s
8937 #
8938 # These defaults can be overridden in `negativeCachingPolicy`.
8939 # If not specified, Cloud CDN applies negative caching by default.
8940 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
8941 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
8942 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
8943 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
8944 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
8945 # all response codes that you wish to cache. Cloud CDN will not apply any
8946 # default negative caching when a policy exists.
8947 { # Specify CDN TTLs for response error codes.
8948 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
8949 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
8950 # specified as values, and you cannot specify a status code more than
8951 # once.
8952 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
8953 # corresponding status code.
8954 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
8955 # objects may be evicted from the cache before the defined TTL.
8956 # as a count of seconds and fractions of seconds at nanosecond
8957 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8958 # or &quot;month&quot;. Range is approximately 10,000 years.
8959 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8960 # Durations less than one second are represented with a 0
8961 # `seconds` field and a positive `nanos` field. Must be from 0
8962 # to 999,999,999 inclusive.
8963 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8964 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8965 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8966 },
8967 },
8968 ],
8969 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
8970 # requests into a small number of requests to the origin. If not specified,
8971 # Cloud CDN applies request coalescing by default.
8972 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
8973 # content with the origin, or when an error is encountered when refreshing
8974 # the cache.
8975 # This setting defines the default &quot;max-stale&quot; duration for any cached
8976 # responses that do not specify a max-stale directive. Stale responses that
8977 # exceed the TTL configured here will not be served. The default limit
8978 # (max-stale) is 86400s (1 day), which will allow stale content to be
8979 # served up to this limit beyond the max-age (or s-maxage) of a cached
8980 # response.
8981 # The maximum allowed value is 604800 (1 week).
8982 # Set this to zero (0) to disable serve-while-stale.
8983 # as a count of seconds and fractions of seconds at nanosecond
8984 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8985 # or &quot;month&quot;. Range is approximately 10,000 years.
8986 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8987 # Durations less than one second are represented with a 0
8988 # `seconds` field and a positive `nanos` field. Must be from 0
8989 # to 999,999,999 inclusive.
8990 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8991 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8992 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8993 },
8994 },
8995 &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
8996 # information about the W3C recommendation for cross-origin resource sharing
8997 # (CORS), see Fetch API Living
8998 # Standard.
8999 #
9000 # Not supported when the URL map is bound to a target gRPC proxy.
9001 # information about the W3C recommendation for cross-origin resource sharing
9002 # (CORS), see Fetch API Living
9003 # Standard.
9004 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
9005 # indicates that
9006 # the actual request can include user credentials. This field translates to
9007 # the Access-Control-Allow-Credentials header.
9008 #
9009 # Default is false.
9010 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
9011 # header.
9012 &quot;A String&quot;,
9013 ],
9014 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
9015 # header.
9016 &quot;A String&quot;,
9017 ],
9018 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
9019 # more information, see regular expression syntax.
9020 #
9021 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
9022 #
9023 # Regular expressions can only be used when the loadBalancingScheme is
9024 # set to INTERNAL_SELF_MANAGED.
9025 &quot;A String&quot;,
9026 ],
9027 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
9028 #
9029 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
9030 &quot;A String&quot;,
9031 ],
9032 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
9033 # The default value is false, which indicates that the CORS
9034 # policy is in effect.
9035 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
9036 # header.
9037 &quot;A String&quot;,
9038 ],
9039 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
9040 # seconds. This field translates to the Access-Control-Max-Age
9041 # header.
9042 },
9043 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
9044 # the resiliency of clients to backend service failure. As part of fault
9045 # injection, when clients send requests to a backend service, delays can be
9046 # introduced by a load balancer on a percentage of requests before sending
9047 # those requests to the backend service. Similarly requests from clients can
9048 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
9049 # that are configured with a fault_injection_policy if:
9050 # 1. The traffic is generated by fault injection AND
9051 # 2. The fault injection is not a delay fault injection.
9052 # Fault injection is not supported with the classic Application Load Balancer
9053 # . To see which load balancers support fault injection,
9054 # see Load
9055 # balancing: Routing and traffic management features.
9056 # the resiliency of clients to backend service failure. As part of fault
9057 # injection, when clients send requests to a backend service, delays can be
9058 # introduced by the load balancer on a percentage of requests before sending
9059 # those request to the backend service. Similarly requests from clients can be
9060 # aborted by the load balancer for a percentage of requests.
9061 &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
9062 # injection.
9063 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
9064 #
9065 # The value must be from 200 to 599 inclusive.
9066 #
9067 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
9068 # according to this
9069 # mapping table. HTTP status 200 is mapped to gRPC status
9070 # UNKNOWN. Injecting an OK status is currently not supported by
9071 # Traffic Director.
9072 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
9073 # that is aborted as part of fault injection.
9074 #
9075 # The value must be from 0.0 to 100.0 inclusive.
9076 },
9077 &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
9078 # injection, before being sent to a backend service.
9079 # request to the backend service as part of fault injection.
9080 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
9081 # as a count of seconds and fractions of seconds at nanosecond
9082 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9083 # or &quot;month&quot;. Range is approximately 10,000 years.
9084 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9085 # Durations less than one second are represented with a 0
9086 # `seconds` field and a positive `nanos` field. Must be from 0
9087 # to 999,999,999 inclusive.
9088 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9089 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9090 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9091 },
9092 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
9093 # which a delay is introduced as part of fault injection.
9094 #
9095 # The value must be from 0.0 to 100.0 inclusive.
9096 },
9097 },
9098 &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
9099 # Global EXTERNAL_MANAGED load balancer schemes.
9100 # Either Cloud CDN must be enabled on the backend service or backend bucket
9101 # serving the route, or cache policy must be configured on the same route
9102 # dynamically processes and delivers images from the network edge.
9103 # Image Optimization is only available for Global External Application Load
9104 # Balancers.
9105 # Either Cloud CDN must be enabled on the backend service or backend bucket
9106 # serving the route, or cache policy must be configured on the same route.
9107 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
9108 },
9109 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
9110 # Unlike the timeout field where the timeout duration starts
9111 # from the time the request has been fully processed (known as*end-of-stream*),
9112 # the duration in this field is computed from the beginning of the stream
9113 # until the response has been processed, including all retries. A
9114 # stream that does not complete in this duration is closed.
9115 #
9116 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
9117 # with the route.
9118 #
9119 # This field is only allowed if the Url map is used with backend services
9120 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
9121 # as a count of seconds and fractions of seconds at nanosecond
9122 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9123 # or &quot;month&quot;. Range is approximately 10,000 years.
9124 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9125 # Durations less than one second are represented with a 0
9126 # `seconds` field and a positive `nanos` field. Must be from 0
9127 # to 999,999,999 inclusive.
9128 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9129 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9130 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9131 },
9132 &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
9133 # are shadowed to a separate mirrored backend service. The load balancer does
9134 # not wait for responses from the shadow service. Before sending traffic
9135 # to the shadow service, the host / authority header is suffixed with-shadow.
9136 #
9137 # Not supported when the URL map is bound to a target gRPC proxy that
9138 # has the validateForProxyless field set to true.
9139 # are shadowed to a separate mirrored backend service. The load balancer
9140 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
9141 # to the shadow service, the host or authority header is suffixed with-shadow.
9142 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
9143 # mirrored to.
9144 #
9145 # The backend service configured for a mirroring
9146 # policy must reference backends that are of the same type as the original
9147 # backend service matched in the URL map.
9148 #
9149 # Serverless NEG backends are not currently supported as a mirrored
9150 # backend service.
9151 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
9152 },
9153 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
9154 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
9155 # If not specified, defaults to 1.
9156 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
9157 #
9158 # If not specified, will use the timeout set in theHttpRouteAction field.
9159 # If timeout in the HttpRouteAction field is not set, this field
9160 # uses the largest timeout
9161 # among all backend services associated with the route.
9162 #
9163 # Not supported when the URL map is bound to a target gRPC proxy that
9164 # has the validateForProxyless field set to true.
9165 # as a count of seconds and fractions of seconds at nanosecond
9166 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9167 # or &quot;month&quot;. Range is approximately 10,000 years.
9168 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9169 # Durations less than one second are represented with a 0
9170 # `seconds` field and a positive `nanos` field. Must be from 0
9171 # to 999,999,999 inclusive.
9172 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9173 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9174 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9175 },
9176 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
9177 # values are:
9178 #
9179 # - 5xx: retry is attempted if the instance or endpoint
9180 # responds with any 5xx response code, or if the instance or
9181 # endpoint does not respond at all. For example, disconnects, reset, read
9182 # timeout, connection failure, and refused streams.
9183 # - gateway-error: Similar to 5xx, but only
9184 # applies to response codes 502, 503 or504.
9185 # - connect-failure: a retry is attempted on failures
9186 # connecting to the instance or endpoint. For example, connection
9187 # timeouts.
9188 # - retriable-4xx: a retry is attempted if the instance
9189 # or endpoint responds with a 4xx response code.
9190 # The only error that you can retry is error code 409.
9191 # - refused-stream: a retry is attempted if the instance
9192 # or endpoint resets the stream with a REFUSED_STREAM error
9193 # code. This reset type indicates that it is safe to retry.
9194 # - cancelled: a retry is attempted if the gRPC status
9195 # code in the response header is set to cancelled.
9196 # - deadline-exceeded: a retry is attempted if the gRPC
9197 # status code in the response header is set todeadline-exceeded.
9198 # - internal: a retry is attempted if the gRPC
9199 # status code in the response header is set tointernal.
9200 # - resource-exhausted: a retry is attempted if the gRPC
9201 # status code in the response header is set toresource-exhausted.
9202 # - unavailable: a retry is attempted if the gRPC
9203 # status code in the response header is set tounavailable.
9204 #
9205 # Only the following codes are supported when the URL map is bound to
9206 # target gRPC proxy that has validateForProxyless field set to true.
9207 #
9208 # - cancelled
9209 # - deadline-exceeded
9210 # - internal
9211 # - resource-exhausted
9212 # - unavailable
9213 &quot;A String&quot;,
9214 ],
9215 },
9216 &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
9217 # time the request has been fully processed (known as *end-of-stream*)
9218 # up until the response has been processed. Timeout includes
9219 # all retries.
9220 #
9221 # If not specified, this field uses the largest timeout among all backend
9222 # services associated with the route.
9223 #
9224 # Not supported when the URL map is bound to a target gRPC proxy that
9225 # has validateForProxyless field set to true.
9226 # as a count of seconds and fractions of seconds at nanosecond
9227 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9228 # or &quot;month&quot;. Range is approximately 10,000 years.
9229 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9230 # Durations less than one second are represented with a 0
9231 # `seconds` field and a positive `nanos` field. Must be from 0
9232 # to 999,999,999 inclusive.
9233 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9234 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9235 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9236 },
9237 &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
9238 # to the matched service.
9239 #
9240 # urlRewrite is the only action supported in UrlMaps
9241 # for classic Application Load Balancers.
9242 #
9243 # Not supported when the URL map is bound to a target gRPC proxy that
9244 # has the validateForProxyless field set to true.
9245 # backend service.
9246 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
9247 # host header is replaced with contents of hostRewrite.
9248 #
9249 # The value must be from 1 to 255 characters.
9250 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
9251 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
9252 #
9253 # The value must be from 1 to 1024 characters.
9254 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
9255 # header) using the HTTP template syntax.
9256 #
9257 # A corresponding
9258 # path_template_match must be specified. Any template variables must exist in
9259 # the path_template_match field.
9260 #
9261 #
9262 # - -At least one variable must be specified in the path_template_match
9263 # field
9264 # - You can omit variables from the rewritten URL
9265 # - The * and ** operators cannot be matched
9266 # unless they have a corresponding variable name - e.g.
9267 # {format=*} or {var=**}.
9268 #
9269 # For example, a path_template_match of /static/{format=**}
9270 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
9271 # rewrite, so that /{country}/{format}/{suffix=**} can be
9272 # rewritten as /content/{format}/{country}/{suffix}.
9273 #
9274 # At least
9275 # one non-empty routeRules[].matchRules[].path_template_match is
9276 # required.
9277 #
9278 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
9279 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
9280 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
9281 # It uses RE2 syntax with the following constraints:
9282 #
9283 #
9284 # - Any single character operators
9285 # - Groups are allowed to have only submatch operator inside
9286 # - Groups are allowed only without any char repetition, e.g.
9287 # .*
9288 # - Any char repetition, e.g. .*, is
9289 # only allowed to be used in a single regex together with:
9290 #
9291 #
9292 # - Empty string operators
9293 # - Other repetitions
9294 # - Ranges
9295 # - Repetitions of ranges
9296 #
9297 #
9298 # - Ranges are only allowed to have:
9299 #
9300 #
9301 # - Character range
9302 # - Digits range
9303 # - Symbols listed in characters allowed for ranges
9304 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
9305 # the path.
9306 },
9307 },
9308 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
9309 # occurs. The weights determine the fraction of traffic that flows to
9310 # their corresponding backend service. If all traffic needs to
9311 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
9312 #
9313 # After a backend service is identified and before forwarding
9314 # the request to
9315 # the backend service, advanced routing actions such as URL rewrites and
9316 # header transformations are applied depending on additional settings
9317 # specified in this HttpRouteAction.
9318 { # In contrast to a single BackendService in
9319 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
9320 # multiple backend services. The volume of traffic for each
9321 # backend service is proportional to the weight specified
9322 # in each WeightedBackendService
9323 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
9324 # resource. Before
9325 # forwarding the request to backendService, the load balancer
9326 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
9327 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
9328 # effect for the selected backendService.
9329 #
9330 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
9331 #
9332 # headerAction is not supported for load balancers that have
9333 # their loadBalancingScheme set to EXTERNAL.
9334 #
9335 # Not supported when the URL map is bound to a target gRPC proxy that
9336 # has validateForProxyless field set to true.
9337 # the request is passed along to the selected backendService.
9338 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
9339 { # Specification determining how headers are added to requests or responses.
9340 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
9341 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
9342 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
9343 # that already
9344 # exist for the header. If true, headerValue is set for the
9345 # header, discarding any values that were set for that header.
9346 #
9347 # The default value is true,
9348 # unless a variable is present in headerValue,
9349 # in which case the default value is false.
9350 # .
9351 },
9352 ],
9353 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
9354 # request before forwarding the request to the backendService.
9355 &quot;A String&quot;,
9356 ],
9357 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
9358 # client.
9359 { # Specification determining how headers are added to requests or responses.
9360 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
9361 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
9362 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
9363 # that already
9364 # exist for the header. If true, headerValue is set for the
9365 # header, discarding any values that were set for that header.
9366 #
9367 # The default value is true,
9368 # unless a variable is present in headerValue,
9369 # in which case the default value is false.
9370 # .
9371 },
9372 ],
9373 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
9374 # response before sending the response back to the client.
9375 &quot;A String&quot;,
9376 ],
9377 },
9378 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
9379 # computed asweight / (sum of all weightedBackendService weights in routeAction).
9380 #
9381 # The selection of a backend service is determined only for new traffic.
9382 # Once a user&#x27;s request has been directed to a backend service,
9383 # subsequent requests are sent to the same backend service as
9384 # determined by the backend service&#x27;s session affinity policy.
9385 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
9386 # splitting. If you do, the weighted traffic splitting configuration takes
9387 # precedence.
9388 #
9389 # The value must be from 0 to 1000.
9390 },
9391 ],
9392 },
9393 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL of the defaultService resource to
9394 # which traffic is directed if none of the hostRules match.
9395 # If defaultRouteAction is also specified, advanced
9396 # routing actions, such as URL rewrites, take effect before sending the
9397 # request to the backend.
9398 #
9399 #
9400 # Only one of defaultUrlRedirect, defaultService
9401 # or defaultRouteAction.weightedBackendService can be set.
9402 #
9403 #
9404 # defaultService has no effect when the URL map is bound
9405 # to a target gRPC proxy that has the validateForProxyless field
9406 # set to true.
9407 &quot;defaultUrlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
9408 # is redirected to a URL specified by defaultUrlRedirect.
9409 #
9410 #
9411 # Only one of defaultUrlRedirect, defaultService
9412 # or defaultRouteAction.weightedBackendService can be set.
9413 #
9414 #
9415 # Not supported when the URL map is bound to a target gRPC proxy.
9416 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
9417 # was supplied in the request.
9418 #
9419 # The value must be from 1 to 255
9420 # characters.
9421 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
9422 # set to HTTPS.
9423 # If set to false, the URL scheme of the redirected request
9424 # remains the same as that of the request.
9425 #
9426 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
9427 #
9428 # The default is set to false.
9429 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
9430 # that was supplied in the request.
9431 #
9432 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
9433 # supplied, the path of the original request is used for the redirect.
9434 #
9435 # The value must be from 1 to 1024 characters.
9436 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
9437 # the HttpRouteRuleMatch, retaining the remaining portion
9438 # of the URL before redirecting the request.
9439 #
9440 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
9441 # supplied, the path of the original request is used for the redirect.
9442 #
9443 # The value must be from 1 to 1024 characters.
9444 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
9445 #
9446 # Supported values are:
9447 #
9448 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
9449 # to 301.
9450 # - FOUND, which corresponds to 302.
9451 # - SEE_OTHER which corresponds to 303.
9452 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
9453 # method is retained.
9454 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
9455 # method is retained.
9456 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
9457 # URL is
9458 # removed before redirecting the request. If set to false, the
9459 # query portion of the original URL is retained.
9460 #
9461 # The default is set to false.
9462 },
9463 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
9464 # create the resource.
9465 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. A hash of the contents stored in this object.
9466 # This field is used in optimistic locking. This field is ignored when
9467 # inserting a UrlMap. An up-to-date fingerprint must be provided
9468 # in order to update the UrlMap, otherwise the request will
9469 # fail with error 412 conditionNotMet.
9470 #
9471 # To see the latest fingerprint, make a get() request to
9472 # retrieve a UrlMap.
9473 &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
9474 # for the selected backendService.
9475 #
9476 # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
9477 #
9478 # headerAction is not supported for load balancers
9479 # that have
9480 # their loadBalancingScheme set to EXTERNAL.
9481 #
9482 # Not supported when the URL map is bound to a target gRPC proxy that
9483 # has validateForProxyless field set to true.
9484 # the request is passed along to the selected backendService.
9485 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
9486 { # Specification determining how headers are added to requests or responses.
9487 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
9488 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
9489 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
9490 # that already
9491 # exist for the header. If true, headerValue is set for the
9492 # header, discarding any values that were set for that header.
9493 #
9494 # The default value is true,
9495 # unless a variable is present in headerValue,
9496 # in which case the default value is false.
9497 # .
9498 },
9499 ],
9500 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
9501 # request before forwarding the request to the backendService.
9502 &quot;A String&quot;,
9503 ],
9504 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
9505 # client.
9506 { # Specification determining how headers are added to requests or responses.
9507 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
9508 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
9509 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
9510 # that already
9511 # exist for the header. If true, headerValue is set for the
9512 # header, discarding any values that were set for that header.
9513 #
9514 # The default value is true,
9515 # unless a variable is present in headerValue,
9516 # in which case the default value is false.
9517 # .
9518 },
9519 ],
9520 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
9521 # response before sending the response back to the client.
9522 &quot;A String&quot;,
9523 ],
9524 },
9525 &quot;hostRules&quot;: [ # The list of host rules to use against the URL.
9526 { # UrlMaps
9527 # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
9528 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
9529 # create the resource.
9530 &quot;hosts&quot;: [ # The list of host patterns to match. They must be valid hostnames with
9531 # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
9532 # that case, * must be the first character, and if followed by
9533 # anything, the immediate following character must be either -
9534 # or ..
9535 #
9536 # * based matching is not supported when the URL map is bound
9537 # to a target gRPC proxy that has the validateForProxyless field
9538 # set to true.
9539 &quot;A String&quot;,
9540 ],
9541 &quot;pathMatcher&quot;: &quot;A String&quot;, # The name of the PathMatcher to use to match the path portion
9542 # of the URL if the hostRule matches the URL&#x27;s host portion.
9543 },
9544 ],
9545 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the resource. This identifier is
9546 # defined by the server.
9547 &quot;kind&quot;: &quot;compute#urlMap&quot;, # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
9548 # url maps.
9549 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
9550 # The name must be 1-63 characters long, and comply withRFC1035.
9551 # Specifically, the name must be 1-63 characters long and match the regular
9552 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
9553 # character must be a lowercase letter, and all following characters must
9554 # be a dash, lowercase letter, or digit, except the last character, which
9555 # cannot be a dash.
9556 &quot;pathMatchers&quot;: [ # The list of named PathMatchers to use against the URL.
9557 { # A matcher for the path portion of the URL. The BackendService
9558 # from the longest-matched rule will serve the URL. If no rule was matched, the
9559 # default service is used.
9560 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
9561 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
9562 #
9563 # This policy takes
9564 # effect at the PathMatcher level and applies only when no
9565 # 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
9566 # in defaultCustomErrorResponsePolicy, then a policy defined for
9567 # the error code in UrlMap.defaultCustomErrorResponsePolicy
9568 # takes effect.
9569 #
9570 # For example, consider a UrlMap with the following
9571 # configuration:
9572 #
9573 #
9574 # - UrlMap.defaultCustomErrorResponsePolicy is configured
9575 # with policies for 5xx and 4xx errors
9576 # - A RouteRule for /coming_soon/ is configured for the
9577 # error code 404.
9578 #
9579 # 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
9580 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
9581 # the policy in RouteRule.customErrorResponsePolicy takes
9582 # effect. If any of the requests in this example encounter a 500
9583 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
9584 #
9585 # When
9586 # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
9587 # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
9588 # a retry, if load balancer is successful in reaching the
9589 # service, the defaultCustomErrorResponsePolicy is ignored and
9590 # the response from the service is returned to the client.
9591 #
9592 # defaultCustomErrorResponsePolicy is supported only for
9593 # global external Application Load Balancers.
9594 # backend service or backend bucket responds with an error.
9595 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
9596 #
9597 # In a given policy, if you specify rules for both a range of error codes
9598 # as well as rules for specific error codes then rules with specific error
9599 # codes have a higher priority. For example, assume that you configure a rule
9600 # for 401 (Un-authorized) code, and another for all 4 series
9601 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
9602 # However if the backend service returns a 403, the rule for4xx takes effect.
9603 { # Specifies the mapping between the response code that will be returned along
9604 # with the custom error content and the response code returned by the backend
9605 # service.
9606 &quot;matchResponseCodes&quot;: [ # Valid values include:
9607 #
9608 #
9609 # - A number between 400 and 599: For example
9610 # 401 or 503, in which case the load balancer
9611 # applies the policy if the error code exactly matches this value.
9612 # - 5xx: Load Balancer will apply the policy if the
9613 # backend service responds with any response code in the range of
9614 # 500 to 599.
9615 # - 4xx: Load
9616 # Balancer will apply the policy if the backend service responds with any
9617 # response code in the range of 400 to
9618 # 499.
9619 #
9620 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
9621 &quot;A String&quot;,
9622 ],
9623 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
9624 # error content. If overrideResponseCode is not supplied, the
9625 # same response code returned by the original backend bucket or backend
9626 # service is returned to the client.
9627 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
9628 #
9629 # path must start
9630 # with a leading slash. path cannot have trailing slashes.
9631 #
9632 # If the file is not available in backendBucket or the
9633 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
9634 #
9635 # The value must
9636 # be from 1 to 1024 characters
9637 },
9638 ],
9639 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
9640 # contains the custom error content. Examples are:
9641 #
9642 #
9643 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
9644 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
9645 # - global/backendBuckets/myBackendBucket
9646 #
9647 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
9648 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
9649 #
9650 # If load balancer cannot reach
9651 # the backendBucket, a simple Not Found Error will
9652 # be returned, with the original response code (oroverrideResponseCode if configured).
9653 #
9654 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
9655 },
9656 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
9657 # pathRules or routeRules match. The load balancer
9658 # performs advanced routing actions, such as URL rewrites and
9659 # header transformations, before forwarding the request to the
9660 # selected backend.
9661 #
9662 #
9663 # Only one of defaultUrlRedirect, defaultService
9664 # or defaultRouteAction.weightedBackendService can be set.
9665 #
9666 #
9667 # URL maps for classic Application Load Balancers only support
9668 # the urlRewrite action within a path matcher&#x27;sdefaultRouteAction.
9669 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
9670 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
9671 # property must be specified. This policy cannot be specified if any target
9672 # backend has Identity-Aware Proxy enabled.
9673 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
9674 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
9675 # header names can be specified. The cache is bypassed for all `cacheMode`
9676 # values.
9677 &quot;A String&quot;,
9678 ],
9679 &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
9680 # on the backend type: for Backend Services, the complete request URI is
9681 # used; for Backend Buckets, the request URI is used without the protocol or
9682 # host, and only query parameters known to Cloud Storage are included.
9683 # Policy defined on Route Action.
9684 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
9685 # parameters will be included. Either specify `excludedQueryParameters`
9686 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
9687 # encoded and not treated as delimiters.
9688 #
9689 # Note: This field applies to routes that use backend services. Attempting
9690 # to set it on a route that points exclusively to Backend Buckets will
9691 # result in a configuration error. For routes that point to a Backend
9692 # Bucket, use `includedQueryParameters` to define which parameters should
9693 # be part of the cache key.
9694 &quot;A String&quot;,
9695 ],
9696 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
9697 #
9698 # Note: This setting is only applicable to routes that use a Backend
9699 # Service. It does not affect requests served by a Backend Bucket, as the
9700 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
9701 # it on a route that points exclusively to Backend Buckets will result in a
9702 # configuration error.
9703 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
9704 #
9705 # Note: This setting is only applicable to routes that use a Backend
9706 # Service. It does not affect requests served by a Backend Bucket, as the
9707 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
9708 # set on a route that points exclusively to Backend Buckets will result in
9709 # a configuration error.
9710 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
9711 # `includedQueryParameters` and `excludedQueryParameters`. If neither
9712 # is set, the entire query string will be included. If false, the query
9713 # string will be excluded from the cache key entirely.
9714 #
9715 # Note: This field applies to routes that use backend services. Attempting
9716 # to set it on a route that points exclusively to Backend Buckets will
9717 # result in a configuration error. For routes that point to a Backend
9718 # Bucket, use `includedQueryParameters` to define which parameters should
9719 # be part of the cache key.
9720 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
9721 # The name=value pair will be used in the cache key Cloud CDN generates.
9722 #
9723 # Note: This setting is only applicable to routes that use a Backend
9724 # Service. It does not affect requests served by a Backend Bucket.
9725 # Attempting to set it on a route that points exclusively to Backend
9726 # Buckets will result in a configuration error. Up to 5 cookie names can be
9727 # specified.
9728 &quot;A String&quot;,
9729 ],
9730 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
9731 &quot;A String&quot;,
9732 ],
9733 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
9734 # parameters will be excluded. Either specify `includedQueryParameters`
9735 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
9736 # encoded and not treated as delimiters.
9737 &quot;A String&quot;,
9738 ],
9739 },
9740 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
9741 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
9742 &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
9743 # content. This is used to clamp the max-age (or Expires) value sent to the
9744 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
9745 # is used for the response max-age directive, along with a &quot;public&quot;
9746 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
9747 # clamps the max-age from the origin (if specified), or else sets the
9748 # response max-age directive to the lesser of the `clientTtl` and
9749 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
9750 # present. The maximum allowed value is 31,622,400s (1 year). If not
9751 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
9752 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
9753 # `USE_ORIGIN_HEADERS`.
9754 # as a count of seconds and fractions of seconds at nanosecond
9755 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9756 # or &quot;month&quot;. Range is approximately 10,000 years.
9757 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9758 # Durations less than one second are represented with a 0
9759 # `seconds` field and a positive `nanos` field. Must be from 0
9760 # to 999,999,999 inclusive.
9761 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9762 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9763 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9764 },
9765 &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
9766 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
9767 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
9768 # greater than that of `maxTtl`. When the `cacheMode` is set to
9769 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
9770 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
9771 # accessed objects may be evicted from the cache before the defined TTL. If
9772 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
9773 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
9774 # `USE_ORIGIN_HEADERS`.
9775 # as a count of seconds and fractions of seconds at nanosecond
9776 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9777 # or &quot;month&quot;. Range is approximately 10,000 years.
9778 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9779 # Durations less than one second are represented with a 0
9780 # `seconds` field and a positive `nanos` field. Must be from 0
9781 # to 999,999,999 inclusive.
9782 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9783 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9784 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9785 },
9786 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
9787 # attempt to set a max-age or s-maxage higher than this, or an Expires header
9788 # more than `maxTtl` seconds in the future will be capped at the value of
9789 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
9790 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
9791 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
9792 # Infrequently accessed objects may be evicted from the cache before the
9793 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
9794 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
9795 # mode.
9796 # as a count of seconds and fractions of seconds at nanosecond
9797 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9798 # or &quot;month&quot;. Range is approximately 10,000 years.
9799 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9800 # Durations less than one second are represented with a 0
9801 # `seconds` field and a positive `nanos` field. Must be from 0
9802 # to 999,999,999 inclusive.
9803 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9804 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9805 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9806 },
9807 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
9808 # to apply fine-grained caching for common errors or redirects.
9809 # This can reduce the load on your origin and improve end-user
9810 # experience by reducing response latency.
9811 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
9812 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
9813 # the specified response code that lack any Cache-Control, Expires, or
9814 # Pragma: no-cache directives. When the `cacheMode` is set to
9815 # `FORCE_CACHE_ALL`, negative caching applies to all responses
9816 # with the specified response code, and overrides any caching headers. By
9817 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
9818 #
9819 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
9820 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
9821 # * 405 (Method Not Found), 501 (Not Implemented): 60s
9822 #
9823 # These defaults can be overridden in `negativeCachingPolicy`.
9824 # If not specified, Cloud CDN applies negative caching by default.
9825 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
9826 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
9827 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
9828 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
9829 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
9830 # all response codes that you wish to cache. Cloud CDN will not apply any
9831 # default negative caching when a policy exists.
9832 { # Specify CDN TTLs for response error codes.
9833 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
9834 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
9835 # specified as values, and you cannot specify a status code more than
9836 # once.
9837 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
9838 # corresponding status code.
9839 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
9840 # objects may be evicted from the cache before the defined TTL.
9841 # as a count of seconds and fractions of seconds at nanosecond
9842 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9843 # or &quot;month&quot;. Range is approximately 10,000 years.
9844 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9845 # Durations less than one second are represented with a 0
9846 # `seconds` field and a positive `nanos` field. Must be from 0
9847 # to 999,999,999 inclusive.
9848 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9849 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9850 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9851 },
9852 },
9853 ],
9854 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
9855 # requests into a small number of requests to the origin. If not specified,
9856 # Cloud CDN applies request coalescing by default.
9857 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
9858 # content with the origin, or when an error is encountered when refreshing
9859 # the cache.
9860 # This setting defines the default &quot;max-stale&quot; duration for any cached
9861 # responses that do not specify a max-stale directive. Stale responses that
9862 # exceed the TTL configured here will not be served. The default limit
9863 # (max-stale) is 86400s (1 day), which will allow stale content to be
9864 # served up to this limit beyond the max-age (or s-maxage) of a cached
9865 # response.
9866 # The maximum allowed value is 604800 (1 week).
9867 # Set this to zero (0) to disable serve-while-stale.
9868 # as a count of seconds and fractions of seconds at nanosecond
9869 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9870 # or &quot;month&quot;. Range is approximately 10,000 years.
9871 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9872 # Durations less than one second are represented with a 0
9873 # `seconds` field and a positive `nanos` field. Must be from 0
9874 # to 999,999,999 inclusive.
9875 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9876 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9877 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9878 },
9879 },
9880 &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
9881 # information about the W3C recommendation for cross-origin resource sharing
9882 # (CORS), see Fetch API Living
9883 # Standard.
9884 #
9885 # Not supported when the URL map is bound to a target gRPC proxy.
9886 # information about the W3C recommendation for cross-origin resource sharing
9887 # (CORS), see Fetch API Living
9888 # Standard.
9889 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
9890 # indicates that
9891 # the actual request can include user credentials. This field translates to
9892 # the Access-Control-Allow-Credentials header.
9893 #
9894 # Default is false.
9895 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
9896 # header.
9897 &quot;A String&quot;,
9898 ],
9899 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
9900 # header.
9901 &quot;A String&quot;,
9902 ],
9903 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
9904 # more information, see regular expression syntax.
9905 #
9906 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
9907 #
9908 # Regular expressions can only be used when the loadBalancingScheme is
9909 # set to INTERNAL_SELF_MANAGED.
9910 &quot;A String&quot;,
9911 ],
9912 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
9913 #
9914 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
9915 &quot;A String&quot;,
9916 ],
9917 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
9918 # The default value is false, which indicates that the CORS
9919 # policy is in effect.
9920 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
9921 # header.
9922 &quot;A String&quot;,
9923 ],
9924 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
9925 # seconds. This field translates to the Access-Control-Max-Age
9926 # header.
9927 },
9928 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
9929 # the resiliency of clients to backend service failure. As part of fault
9930 # injection, when clients send requests to a backend service, delays can be
9931 # introduced by a load balancer on a percentage of requests before sending
9932 # those requests to the backend service. Similarly requests from clients can
9933 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
9934 # that are configured with a fault_injection_policy if:
9935 # 1. The traffic is generated by fault injection AND
9936 # 2. The fault injection is not a delay fault injection.
9937 # Fault injection is not supported with the classic Application Load Balancer
9938 # . To see which load balancers support fault injection,
9939 # see Load
9940 # balancing: Routing and traffic management features.
9941 # the resiliency of clients to backend service failure. As part of fault
9942 # injection, when clients send requests to a backend service, delays can be
9943 # introduced by the load balancer on a percentage of requests before sending
9944 # those request to the backend service. Similarly requests from clients can be
9945 # aborted by the load balancer for a percentage of requests.
9946 &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
9947 # injection.
9948 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
9949 #
9950 # The value must be from 200 to 599 inclusive.
9951 #
9952 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
9953 # according to this
9954 # mapping table. HTTP status 200 is mapped to gRPC status
9955 # UNKNOWN. Injecting an OK status is currently not supported by
9956 # Traffic Director.
9957 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
9958 # that is aborted as part of fault injection.
9959 #
9960 # The value must be from 0.0 to 100.0 inclusive.
9961 },
9962 &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
9963 # injection, before being sent to a backend service.
9964 # request to the backend service as part of fault injection.
9965 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
9966 # as a count of seconds and fractions of seconds at nanosecond
9967 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9968 # or &quot;month&quot;. Range is approximately 10,000 years.
9969 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9970 # Durations less than one second are represented with a 0
9971 # `seconds` field and a positive `nanos` field. Must be from 0
9972 # to 999,999,999 inclusive.
9973 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9974 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9975 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9976 },
9977 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
9978 # which a delay is introduced as part of fault injection.
9979 #
9980 # The value must be from 0.0 to 100.0 inclusive.
9981 },
9982 },
9983 &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
9984 # Global EXTERNAL_MANAGED load balancer schemes.
9985 # Either Cloud CDN must be enabled on the backend service or backend bucket
9986 # serving the route, or cache policy must be configured on the same route
9987 # dynamically processes and delivers images from the network edge.
9988 # Image Optimization is only available for Global External Application Load
9989 # Balancers.
9990 # Either Cloud CDN must be enabled on the backend service or backend bucket
9991 # serving the route, or cache policy must be configured on the same route.
9992 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
9993 },
9994 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
9995 # Unlike the timeout field where the timeout duration starts
9996 # from the time the request has been fully processed (known as*end-of-stream*),
9997 # the duration in this field is computed from the beginning of the stream
9998 # until the response has been processed, including all retries. A
9999 # stream that does not complete in this duration is closed.
10000 #
10001 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
10002 # with the route.
10003 #
10004 # This field is only allowed if the Url map is used with backend services
10005 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
10006 # as a count of seconds and fractions of seconds at nanosecond
10007 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10008 # or &quot;month&quot;. Range is approximately 10,000 years.
10009 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10010 # Durations less than one second are represented with a 0
10011 # `seconds` field and a positive `nanos` field. Must be from 0
10012 # to 999,999,999 inclusive.
10013 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10014 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10015 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10016 },
10017 &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
10018 # are shadowed to a separate mirrored backend service. The load balancer does
10019 # not wait for responses from the shadow service. Before sending traffic
10020 # to the shadow service, the host / authority header is suffixed with-shadow.
10021 #
10022 # Not supported when the URL map is bound to a target gRPC proxy that
10023 # has the validateForProxyless field set to true.
10024 # are shadowed to a separate mirrored backend service. The load balancer
10025 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
10026 # to the shadow service, the host or authority header is suffixed with-shadow.
10027 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
10028 # mirrored to.
10029 #
10030 # The backend service configured for a mirroring
10031 # policy must reference backends that are of the same type as the original
10032 # backend service matched in the URL map.
10033 #
10034 # Serverless NEG backends are not currently supported as a mirrored
10035 # backend service.
10036 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
10037 },
10038 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
10039 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
10040 # If not specified, defaults to 1.
10041 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
10042 #
10043 # If not specified, will use the timeout set in theHttpRouteAction field.
10044 # If timeout in the HttpRouteAction field is not set, this field
10045 # uses the largest timeout
10046 # among all backend services associated with the route.
10047 #
10048 # Not supported when the URL map is bound to a target gRPC proxy that
10049 # has the validateForProxyless field set to true.
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;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
10062 # values are:
10063 #
10064 # - 5xx: retry is attempted if the instance or endpoint
10065 # responds with any 5xx response code, or if the instance or
10066 # endpoint does not respond at all. For example, disconnects, reset, read
10067 # timeout, connection failure, and refused streams.
10068 # - gateway-error: Similar to 5xx, but only
10069 # applies to response codes 502, 503 or504.
10070 # - connect-failure: a retry is attempted on failures
10071 # connecting to the instance or endpoint. For example, connection
10072 # timeouts.
10073 # - retriable-4xx: a retry is attempted if the instance
10074 # or endpoint responds with a 4xx response code.
10075 # The only error that you can retry is error code 409.
10076 # - refused-stream: a retry is attempted if the instance
10077 # or endpoint resets the stream with a REFUSED_STREAM error
10078 # code. This reset type indicates that it is safe to retry.
10079 # - cancelled: a retry is attempted if the gRPC status
10080 # code in the response header is set to cancelled.
10081 # - deadline-exceeded: a retry is attempted if the gRPC
10082 # status code in the response header is set todeadline-exceeded.
10083 # - internal: a retry is attempted if the gRPC
10084 # status code in the response header is set tointernal.
10085 # - resource-exhausted: a retry is attempted if the gRPC
10086 # status code in the response header is set toresource-exhausted.
10087 # - unavailable: a retry is attempted if the gRPC
10088 # status code in the response header is set tounavailable.
10089 #
10090 # Only the following codes are supported when the URL map is bound to
10091 # target gRPC proxy that has validateForProxyless field set to true.
10092 #
10093 # - cancelled
10094 # - deadline-exceeded
10095 # - internal
10096 # - resource-exhausted
10097 # - unavailable
10098 &quot;A String&quot;,
10099 ],
10100 },
10101 &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
10102 # time the request has been fully processed (known as *end-of-stream*)
10103 # up until the response has been processed. Timeout includes
10104 # all retries.
10105 #
10106 # If not specified, this field uses the largest timeout among all backend
10107 # services associated with the route.
10108 #
10109 # Not supported when the URL map is bound to a target gRPC proxy that
10110 # has validateForProxyless field set to true.
10111 # as a count of seconds and fractions of seconds at nanosecond
10112 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10113 # or &quot;month&quot;. Range is approximately 10,000 years.
10114 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10115 # Durations less than one second are represented with a 0
10116 # `seconds` field and a positive `nanos` field. Must be from 0
10117 # to 999,999,999 inclusive.
10118 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10119 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10120 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10121 },
10122 &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
10123 # to the matched service.
10124 #
10125 # urlRewrite is the only action supported in UrlMaps
10126 # for classic Application Load Balancers.
10127 #
10128 # Not supported when the URL map is bound to a target gRPC proxy that
10129 # has the validateForProxyless field set to true.
10130 # backend service.
10131 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
10132 # host header is replaced with contents of hostRewrite.
10133 #
10134 # The value must be from 1 to 255 characters.
10135 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
10136 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
10137 #
10138 # The value must be from 1 to 1024 characters.
10139 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
10140 # header) using the HTTP template syntax.
10141 #
10142 # A corresponding
10143 # path_template_match must be specified. Any template variables must exist in
10144 # the path_template_match field.
10145 #
10146 #
10147 # - -At least one variable must be specified in the path_template_match
10148 # field
10149 # - You can omit variables from the rewritten URL
10150 # - The * and ** operators cannot be matched
10151 # unless they have a corresponding variable name - e.g.
10152 # {format=*} or {var=**}.
10153 #
10154 # For example, a path_template_match of /static/{format=**}
10155 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
10156 # rewrite, so that /{country}/{format}/{suffix=**} can be
10157 # rewritten as /content/{format}/{country}/{suffix}.
10158 #
10159 # At least
10160 # one non-empty routeRules[].matchRules[].path_template_match is
10161 # required.
10162 #
10163 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
10164 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
10165 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
10166 # It uses RE2 syntax with the following constraints:
10167 #
10168 #
10169 # - Any single character operators
10170 # - Groups are allowed to have only submatch operator inside
10171 # - Groups are allowed only without any char repetition, e.g.
10172 # .*
10173 # - Any char repetition, e.g. .*, is
10174 # only allowed to be used in a single regex together with:
10175 #
10176 #
10177 # - Empty string operators
10178 # - Other repetitions
10179 # - Ranges
10180 # - Repetitions of ranges
10181 #
10182 #
10183 # - Ranges are only allowed to have:
10184 #
10185 #
10186 # - Character range
10187 # - Digits range
10188 # - Symbols listed in characters allowed for ranges
10189 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
10190 # the path.
10191 },
10192 },
10193 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
10194 # occurs. The weights determine the fraction of traffic that flows to
10195 # their corresponding backend service. If all traffic needs to
10196 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
10197 #
10198 # After a backend service is identified and before forwarding
10199 # the request to
10200 # the backend service, advanced routing actions such as URL rewrites and
10201 # header transformations are applied depending on additional settings
10202 # specified in this HttpRouteAction.
10203 { # In contrast to a single BackendService in
10204 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
10205 # multiple backend services. The volume of traffic for each
10206 # backend service is proportional to the weight specified
10207 # in each WeightedBackendService
10208 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
10209 # resource. Before
10210 # forwarding the request to backendService, the load balancer
10211 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
10212 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
10213 # effect for the selected backendService.
10214 #
10215 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
10216 #
10217 # headerAction is not supported for load balancers that have
10218 # their loadBalancingScheme set to EXTERNAL.
10219 #
10220 # Not supported when the URL map is bound to a target gRPC proxy that
10221 # has validateForProxyless field set to true.
10222 # the request is passed along to the selected backendService.
10223 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
10224 { # Specification determining how headers are added to requests or responses.
10225 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
10226 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
10227 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
10228 # that already
10229 # exist for the header. If true, headerValue is set for the
10230 # header, discarding any values that were set for that header.
10231 #
10232 # The default value is true,
10233 # unless a variable is present in headerValue,
10234 # in which case the default value is false.
10235 # .
10236 },
10237 ],
10238 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
10239 # request before forwarding the request to the backendService.
10240 &quot;A String&quot;,
10241 ],
10242 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
10243 # client.
10244 { # Specification determining how headers are added to requests or responses.
10245 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
10246 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
10247 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
10248 # that already
10249 # exist for the header. If true, headerValue is set for the
10250 # header, discarding any values that were set for that header.
10251 #
10252 # The default value is true,
10253 # unless a variable is present in headerValue,
10254 # in which case the default value is false.
10255 # .
10256 },
10257 ],
10258 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
10259 # response before sending the response back to the client.
10260 &quot;A String&quot;,
10261 ],
10262 },
10263 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
10264 # computed asweight / (sum of all weightedBackendService weights in routeAction).
10265 #
10266 # The selection of a backend service is determined only for new traffic.
10267 # Once a user&#x27;s request has been directed to a backend service,
10268 # subsequent requests are sent to the same backend service as
10269 # determined by the backend service&#x27;s session affinity policy.
10270 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
10271 # splitting. If you do, the weighted traffic splitting configuration takes
10272 # precedence.
10273 #
10274 # The value must be from 0 to 1000.
10275 },
10276 ],
10277 },
10278 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource. This
10279 # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
10280 # matched. For example, the
10281 # following are all valid URLs to a BackendService resource:
10282 #
10283 #
10284 # - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
10285 # - compute/v1/projects/project/global/backendServices/backendService
10286 # - global/backendServices/backendService
10287 #
10288 #
10289 # If defaultRouteAction is also specified, advanced
10290 # routing actions, such as URL rewrites, take effect before sending the
10291 # request to the backend.
10292 #
10293 #
10294 # Only one of defaultUrlRedirect, defaultService
10295 # or defaultRouteAction.weightedBackendService can be set.
10296 #
10297 #
10298 # Authorization requires one or more of the following Google IAM permissions on the
10299 # specified resource default_service:
10300 #
10301 #
10302 # - compute.backendBuckets.use
10303 # - compute.backendServices.use
10304 &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
10305 # by defaultUrlRedirect.
10306 #
10307 #
10308 # Only one of defaultUrlRedirect, defaultService
10309 # or defaultRouteAction.weightedBackendService can be set.
10310 #
10311 #
10312 # Not supported when the URL map is bound to a target gRPC proxy.
10313 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
10314 # was supplied in the request.
10315 #
10316 # The value must be from 1 to 255
10317 # characters.
10318 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
10319 # set to HTTPS.
10320 # If set to false, the URL scheme of the redirected request
10321 # remains the same as that of the request.
10322 #
10323 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
10324 #
10325 # The default is set to false.
10326 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
10327 # that was supplied in the request.
10328 #
10329 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
10330 # supplied, the path of the original request is used for the redirect.
10331 #
10332 # The value must be from 1 to 1024 characters.
10333 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
10334 # the HttpRouteRuleMatch, retaining the remaining portion
10335 # of the URL before redirecting the request.
10336 #
10337 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
10338 # supplied, the path of the original request is used for the redirect.
10339 #
10340 # The value must be from 1 to 1024 characters.
10341 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
10342 #
10343 # Supported values are:
10344 #
10345 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
10346 # to 301.
10347 # - FOUND, which corresponds to 302.
10348 # - SEE_OTHER which corresponds to 303.
10349 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
10350 # method is retained.
10351 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
10352 # method is retained.
10353 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
10354 # URL is
10355 # removed before redirecting the request. If set to false, the
10356 # query portion of the original URL is retained.
10357 #
10358 # The default is set to false.
10359 },
10360 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
10361 # create the resource.
10362 &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
10363 # for the selected backend service.
10364 #
10365 # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
10366 #
10367 # HeaderAction is not supported for load balancers
10368 # that have
10369 # their loadBalancingScheme set to EXTERNAL.
10370 #
10371 # Not supported when the URL map is bound to a target gRPC proxy that
10372 # has validateForProxyless field set to true.
10373 # the request is passed along to the selected backendService.
10374 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
10375 { # Specification determining how headers are added to requests or responses.
10376 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
10377 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
10378 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
10379 # that already
10380 # exist for the header. If true, headerValue is set for the
10381 # header, discarding any values that were set for that header.
10382 #
10383 # The default value is true,
10384 # unless a variable is present in headerValue,
10385 # in which case the default value is false.
10386 # .
10387 },
10388 ],
10389 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
10390 # request before forwarding the request to the backendService.
10391 &quot;A String&quot;,
10392 ],
10393 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
10394 # client.
10395 { # Specification determining how headers are added to requests or responses.
10396 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
10397 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
10398 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
10399 # that already
10400 # exist for the header. If true, headerValue is set for the
10401 # header, discarding any values that were set for that header.
10402 #
10403 # The default value is true,
10404 # unless a variable is present in headerValue,
10405 # in which case the default value is false.
10406 # .
10407 },
10408 ],
10409 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
10410 # response before sending the response back to the client.
10411 &quot;A String&quot;,
10412 ],
10413 },
10414 &quot;name&quot;: &quot;A String&quot;, # The name to which this PathMatcher is referred by theHostRule.
10415 &quot;pathRules&quot;: [ # The list of path rules. Use this list instead of routeRules
10416 # when routing based on simple path matching is all that&#x27;s required. A path
10417 # rule can only include a wildcard character (*) after a
10418 # forward slash character (&quot;/&quot;).
10419 #
10420 # The order by which path rules are specified does not matter.
10421 # Matches are always done on the longest-path-first basis.
10422 #
10423 # For example: a pathRule with a path /a/b/c/* will match
10424 # before /a/b/* irrespective of the order in which those paths appear in this
10425 # list.
10426 #
10427 # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
10428 { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
10429 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
10430 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
10431 #
10432 # If a policy for an
10433 # error code is not configured for the PathRule, a policy for
10434 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
10435 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
10436 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
10437 # effect.
10438 #
10439 # For example, consider a UrlMap with the following configuration:
10440 #
10441 #
10442 # - UrlMap.defaultCustomErrorResponsePolicy are configured
10443 # with policies for 5xx and 4xx errors
10444 # - A PathRule for /coming_soon/ is configured for the error
10445 # code 404.
10446 #
10447 # 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
10448 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
10449 # the policy in PathRule.customErrorResponsePolicy takes
10450 # effect. If any of the requests in this example encounter a 500
10451 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
10452 #
10453 # customErrorResponsePolicy is supported only for
10454 # global external Application Load Balancers.
10455 # backend service or backend bucket responds with an error.
10456 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
10457 #
10458 # In a given policy, if you specify rules for both a range of error codes
10459 # as well as rules for specific error codes then rules with specific error
10460 # codes have a higher priority. For example, assume that you configure a rule
10461 # for 401 (Un-authorized) code, and another for all 4 series
10462 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
10463 # However if the backend service returns a 403, the rule for4xx takes effect.
10464 { # Specifies the mapping between the response code that will be returned along
10465 # with the custom error content and the response code returned by the backend
10466 # service.
10467 &quot;matchResponseCodes&quot;: [ # Valid values include:
10468 #
10469 #
10470 # - A number between 400 and 599: For example
10471 # 401 or 503, in which case the load balancer
10472 # applies the policy if the error code exactly matches this value.
10473 # - 5xx: Load Balancer will apply the policy if the
10474 # backend service responds with any response code in the range of
10475 # 500 to 599.
10476 # - 4xx: Load
10477 # Balancer will apply the policy if the backend service responds with any
10478 # response code in the range of 400 to
10479 # 499.
10480 #
10481 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
10482 &quot;A String&quot;,
10483 ],
10484 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
10485 # error content. If overrideResponseCode is not supplied, the
10486 # same response code returned by the original backend bucket or backend
10487 # service is returned to the client.
10488 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
10489 #
10490 # path must start
10491 # with a leading slash. path cannot have trailing slashes.
10492 #
10493 # If the file is not available in backendBucket or the
10494 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
10495 #
10496 # The value must
10497 # be from 1 to 1024 characters
10498 },
10499 ],
10500 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
10501 # contains the custom error content. Examples are:
10502 #
10503 #
10504 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
10505 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
10506 # - global/backendBuckets/myBackendBucket
10507 #
10508 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
10509 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
10510 #
10511 # If load balancer cannot reach
10512 # the backendBucket, a simple Not Found Error will
10513 # be returned, with the original response code (oroverrideResponseCode if configured).
10514 #
10515 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
10516 },
10517 &quot;paths&quot;: [ # The list of path patterns to match. Each must start with /
10518 # and the only place a * is allowed is at the end following
10519 # a /. The string fed to the path matcher does not include
10520 # any text after the first ? or #, and
10521 # those chars are not allowed here.
10522 &quot;A String&quot;,
10523 ],
10524 &quot;routeAction&quot;: { # In response to a matching path, the load balancer
10525 # performs advanced routing actions, such as URL rewrites and header
10526 # transformations, before forwarding the request to the selected
10527 # backend.
10528 #
10529 #
10530 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
10531 #
10532 #
10533 # URL maps for classic Application Load Balancers only support
10534 # the urlRewrite action within a path rule&#x27;srouteAction.
10535 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
10536 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
10537 # property must be specified. This policy cannot be specified if any target
10538 # backend has Identity-Aware Proxy enabled.
10539 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
10540 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
10541 # header names can be specified. The cache is bypassed for all `cacheMode`
10542 # values.
10543 &quot;A String&quot;,
10544 ],
10545 &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
10546 # on the backend type: for Backend Services, the complete request URI is
10547 # used; for Backend Buckets, the request URI is used without the protocol or
10548 # host, and only query parameters known to Cloud Storage are included.
10549 # Policy defined on Route Action.
10550 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
10551 # parameters will be included. Either specify `excludedQueryParameters`
10552 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
10553 # encoded and not treated as delimiters.
10554 #
10555 # Note: This field applies to routes that use backend services. Attempting
10556 # to set it on a route that points exclusively to Backend Buckets will
10557 # result in a configuration error. For routes that point to a Backend
10558 # Bucket, use `includedQueryParameters` to define which parameters should
10559 # be part of the cache key.
10560 &quot;A String&quot;,
10561 ],
10562 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
10563 #
10564 # Note: This setting is only applicable to routes that use a Backend
10565 # Service. It does not affect requests served by a Backend Bucket, as the
10566 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
10567 # it on a route that points exclusively to Backend Buckets will result in a
10568 # configuration error.
10569 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
10570 #
10571 # Note: This setting is only applicable to routes that use a Backend
10572 # Service. It does not affect requests served by a Backend Bucket, as the
10573 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
10574 # set on a route that points exclusively to Backend Buckets will result in
10575 # a configuration error.
10576 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
10577 # `includedQueryParameters` and `excludedQueryParameters`. If neither
10578 # is set, the entire query string will be included. If false, the query
10579 # string will be excluded from the cache key entirely.
10580 #
10581 # Note: This field applies to routes that use backend services. Attempting
10582 # to set it on a route that points exclusively to Backend Buckets will
10583 # result in a configuration error. For routes that point to a Backend
10584 # Bucket, use `includedQueryParameters` to define which parameters should
10585 # be part of the cache key.
10586 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
10587 # The name=value pair will be used in the cache key Cloud CDN generates.
10588 #
10589 # Note: This setting is only applicable to routes that use a Backend
10590 # Service. It does not affect requests served by a Backend Bucket.
10591 # Attempting to set it on a route that points exclusively to Backend
10592 # Buckets will result in a configuration error. Up to 5 cookie names can be
10593 # specified.
10594 &quot;A String&quot;,
10595 ],
10596 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
10597 &quot;A String&quot;,
10598 ],
10599 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
10600 # parameters will be excluded. Either specify `includedQueryParameters`
10601 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
10602 # encoded and not treated as delimiters.
10603 &quot;A String&quot;,
10604 ],
10605 },
10606 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
10607 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
10608 &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
10609 # content. This is used to clamp the max-age (or Expires) value sent to the
10610 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
10611 # is used for the response max-age directive, along with a &quot;public&quot;
10612 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
10613 # clamps the max-age from the origin (if specified), or else sets the
10614 # response max-age directive to the lesser of the `clientTtl` and
10615 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
10616 # present. The maximum allowed value is 31,622,400s (1 year). If not
10617 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
10618 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
10619 # `USE_ORIGIN_HEADERS`.
10620 # as a count of seconds and fractions of seconds at nanosecond
10621 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10622 # or &quot;month&quot;. Range is approximately 10,000 years.
10623 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10624 # Durations less than one second are represented with a 0
10625 # `seconds` field and a positive `nanos` field. Must be from 0
10626 # to 999,999,999 inclusive.
10627 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10628 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10629 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10630 },
10631 &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
10632 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
10633 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
10634 # greater than that of `maxTtl`. When the `cacheMode` is set to
10635 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
10636 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
10637 # accessed objects may be evicted from the cache before the defined TTL. If
10638 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
10639 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
10640 # `USE_ORIGIN_HEADERS`.
10641 # as a count of seconds and fractions of seconds at nanosecond
10642 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10643 # or &quot;month&quot;. Range is approximately 10,000 years.
10644 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10645 # Durations less than one second are represented with a 0
10646 # `seconds` field and a positive `nanos` field. Must be from 0
10647 # to 999,999,999 inclusive.
10648 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10649 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10650 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10651 },
10652 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
10653 # attempt to set a max-age or s-maxage higher than this, or an Expires header
10654 # more than `maxTtl` seconds in the future will be capped at the value of
10655 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
10656 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
10657 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
10658 # Infrequently accessed objects may be evicted from the cache before the
10659 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
10660 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
10661 # mode.
10662 # as a count of seconds and fractions of seconds at nanosecond
10663 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10664 # or &quot;month&quot;. Range is approximately 10,000 years.
10665 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10666 # Durations less than one second are represented with a 0
10667 # `seconds` field and a positive `nanos` field. Must be from 0
10668 # to 999,999,999 inclusive.
10669 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10670 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10671 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10672 },
10673 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
10674 # to apply fine-grained caching for common errors or redirects.
10675 # This can reduce the load on your origin and improve end-user
10676 # experience by reducing response latency.
10677 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
10678 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
10679 # the specified response code that lack any Cache-Control, Expires, or
10680 # Pragma: no-cache directives. When the `cacheMode` is set to
10681 # `FORCE_CACHE_ALL`, negative caching applies to all responses
10682 # with the specified response code, and overrides any caching headers. By
10683 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
10684 #
10685 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
10686 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
10687 # * 405 (Method Not Found), 501 (Not Implemented): 60s
10688 #
10689 # These defaults can be overridden in `negativeCachingPolicy`.
10690 # If not specified, Cloud CDN applies negative caching by default.
10691 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
10692 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
10693 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
10694 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
10695 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
10696 # all response codes that you wish to cache. Cloud CDN will not apply any
10697 # default negative caching when a policy exists.
10698 { # Specify CDN TTLs for response error codes.
10699 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
10700 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
10701 # specified as values, and you cannot specify a status code more than
10702 # once.
10703 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
10704 # corresponding status code.
10705 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
10706 # objects may be evicted from the cache before the defined TTL.
10707 # as a count of seconds and fractions of seconds at nanosecond
10708 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10709 # or &quot;month&quot;. Range is approximately 10,000 years.
10710 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10711 # Durations less than one second are represented with a 0
10712 # `seconds` field and a positive `nanos` field. Must be from 0
10713 # to 999,999,999 inclusive.
10714 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10715 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10716 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10717 },
10718 },
10719 ],
10720 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
10721 # requests into a small number of requests to the origin. If not specified,
10722 # Cloud CDN applies request coalescing by default.
10723 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
10724 # content with the origin, or when an error is encountered when refreshing
10725 # the cache.
10726 # This setting defines the default &quot;max-stale&quot; duration for any cached
10727 # responses that do not specify a max-stale directive. Stale responses that
10728 # exceed the TTL configured here will not be served. The default limit
10729 # (max-stale) is 86400s (1 day), which will allow stale content to be
10730 # served up to this limit beyond the max-age (or s-maxage) of a cached
10731 # response.
10732 # The maximum allowed value is 604800 (1 week).
10733 # Set this to zero (0) to disable serve-while-stale.
10734 # as a count of seconds and fractions of seconds at nanosecond
10735 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10736 # or &quot;month&quot;. Range is approximately 10,000 years.
10737 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10738 # Durations less than one second are represented with a 0
10739 # `seconds` field and a positive `nanos` field. Must be from 0
10740 # to 999,999,999 inclusive.
10741 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10742 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10743 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10744 },
10745 },
10746 &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
10747 # information about the W3C recommendation for cross-origin resource sharing
10748 # (CORS), see Fetch API Living
10749 # Standard.
10750 #
10751 # Not supported when the URL map is bound to a target gRPC proxy.
10752 # information about the W3C recommendation for cross-origin resource sharing
10753 # (CORS), see Fetch API Living
10754 # Standard.
10755 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
10756 # indicates that
10757 # the actual request can include user credentials. This field translates to
10758 # the Access-Control-Allow-Credentials header.
10759 #
10760 # Default is false.
10761 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
10762 # header.
10763 &quot;A String&quot;,
10764 ],
10765 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
10766 # header.
10767 &quot;A String&quot;,
10768 ],
10769 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
10770 # more information, see regular expression syntax.
10771 #
10772 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
10773 #
10774 # Regular expressions can only be used when the loadBalancingScheme is
10775 # set to INTERNAL_SELF_MANAGED.
10776 &quot;A String&quot;,
10777 ],
10778 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
10779 #
10780 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
10781 &quot;A String&quot;,
10782 ],
10783 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
10784 # The default value is false, which indicates that the CORS
10785 # policy is in effect.
10786 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
10787 # header.
10788 &quot;A String&quot;,
10789 ],
10790 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
10791 # seconds. This field translates to the Access-Control-Max-Age
10792 # header.
10793 },
10794 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
10795 # the resiliency of clients to backend service failure. As part of fault
10796 # injection, when clients send requests to a backend service, delays can be
10797 # introduced by a load balancer on a percentage of requests before sending
10798 # those requests to the backend service. Similarly requests from clients can
10799 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
10800 # that are configured with a fault_injection_policy if:
10801 # 1. The traffic is generated by fault injection AND
10802 # 2. The fault injection is not a delay fault injection.
10803 # Fault injection is not supported with the classic Application Load Balancer
10804 # . To see which load balancers support fault injection,
10805 # see Load
10806 # balancing: Routing and traffic management features.
10807 # the resiliency of clients to backend service failure. As part of fault
10808 # injection, when clients send requests to a backend service, delays can be
10809 # introduced by the load balancer on a percentage of requests before sending
10810 # those request to the backend service. Similarly requests from clients can be
10811 # aborted by the load balancer for a percentage of requests.
10812 &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
10813 # injection.
10814 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
10815 #
10816 # The value must be from 200 to 599 inclusive.
10817 #
10818 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
10819 # according to this
10820 # mapping table. HTTP status 200 is mapped to gRPC status
10821 # UNKNOWN. Injecting an OK status is currently not supported by
10822 # Traffic Director.
10823 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
10824 # that is aborted as part of fault injection.
10825 #
10826 # The value must be from 0.0 to 100.0 inclusive.
10827 },
10828 &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
10829 # injection, before being sent to a backend service.
10830 # request to the backend service as part of fault injection.
10831 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
10832 # as a count of seconds and fractions of seconds at nanosecond
10833 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10834 # or &quot;month&quot;. Range is approximately 10,000 years.
10835 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10836 # Durations less than one second are represented with a 0
10837 # `seconds` field and a positive `nanos` field. Must be from 0
10838 # to 999,999,999 inclusive.
10839 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10840 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10841 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10842 },
10843 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
10844 # which a delay is introduced as part of fault injection.
10845 #
10846 # The value must be from 0.0 to 100.0 inclusive.
10847 },
10848 },
10849 &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
10850 # Global EXTERNAL_MANAGED load balancer schemes.
10851 # Either Cloud CDN must be enabled on the backend service or backend bucket
10852 # serving the route, or cache policy must be configured on the same route
10853 # dynamically processes and delivers images from the network edge.
10854 # Image Optimization is only available for Global External Application Load
10855 # Balancers.
10856 # Either Cloud CDN must be enabled on the backend service or backend bucket
10857 # serving the route, or cache policy must be configured on the same route.
10858 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
10859 },
10860 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
10861 # Unlike the timeout field where the timeout duration starts
10862 # from the time the request has been fully processed (known as*end-of-stream*),
10863 # the duration in this field is computed from the beginning of the stream
10864 # until the response has been processed, including all retries. A
10865 # stream that does not complete in this duration is closed.
10866 #
10867 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
10868 # with the route.
10869 #
10870 # This field is only allowed if the Url map is used with backend services
10871 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
10872 # as a count of seconds and fractions of seconds at nanosecond
10873 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10874 # or &quot;month&quot;. Range is approximately 10,000 years.
10875 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10876 # Durations less than one second are represented with a 0
10877 # `seconds` field and a positive `nanos` field. Must be from 0
10878 # to 999,999,999 inclusive.
10879 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10880 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10881 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10882 },
10883 &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
10884 # are shadowed to a separate mirrored backend service. The load balancer does
10885 # not wait for responses from the shadow service. Before sending traffic
10886 # to the shadow service, the host / authority header is suffixed with-shadow.
10887 #
10888 # Not supported when the URL map is bound to a target gRPC proxy that
10889 # has the validateForProxyless field set to true.
10890 # are shadowed to a separate mirrored backend service. The load balancer
10891 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
10892 # to the shadow service, the host or authority header is suffixed with-shadow.
10893 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
10894 # mirrored to.
10895 #
10896 # The backend service configured for a mirroring
10897 # policy must reference backends that are of the same type as the original
10898 # backend service matched in the URL map.
10899 #
10900 # Serverless NEG backends are not currently supported as a mirrored
10901 # backend service.
10902 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
10903 },
10904 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
10905 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
10906 # If not specified, defaults to 1.
10907 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
10908 #
10909 # If not specified, will use the timeout set in theHttpRouteAction field.
10910 # If timeout in the HttpRouteAction field is not set, this field
10911 # uses the largest timeout
10912 # among all backend services associated with the route.
10913 #
10914 # Not supported when the URL map is bound to a target gRPC proxy that
10915 # has the validateForProxyless field set to true.
10916 # as a count of seconds and fractions of seconds at nanosecond
10917 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10918 # or &quot;month&quot;. Range is approximately 10,000 years.
10919 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10920 # Durations less than one second are represented with a 0
10921 # `seconds` field and a positive `nanos` field. Must be from 0
10922 # to 999,999,999 inclusive.
10923 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10924 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10925 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10926 },
10927 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
10928 # values are:
10929 #
10930 # - 5xx: retry is attempted if the instance or endpoint
10931 # responds with any 5xx response code, or if the instance or
10932 # endpoint does not respond at all. For example, disconnects, reset, read
10933 # timeout, connection failure, and refused streams.
10934 # - gateway-error: Similar to 5xx, but only
10935 # applies to response codes 502, 503 or504.
10936 # - connect-failure: a retry is attempted on failures
10937 # connecting to the instance or endpoint. For example, connection
10938 # timeouts.
10939 # - retriable-4xx: a retry is attempted if the instance
10940 # or endpoint responds with a 4xx response code.
10941 # The only error that you can retry is error code 409.
10942 # - refused-stream: a retry is attempted if the instance
10943 # or endpoint resets the stream with a REFUSED_STREAM error
10944 # code. This reset type indicates that it is safe to retry.
10945 # - cancelled: a retry is attempted if the gRPC status
10946 # code in the response header is set to cancelled.
10947 # - deadline-exceeded: a retry is attempted if the gRPC
10948 # status code in the response header is set todeadline-exceeded.
10949 # - internal: a retry is attempted if the gRPC
10950 # status code in the response header is set tointernal.
10951 # - resource-exhausted: a retry is attempted if the gRPC
10952 # status code in the response header is set toresource-exhausted.
10953 # - unavailable: a retry is attempted if the gRPC
10954 # status code in the response header is set tounavailable.
10955 #
10956 # Only the following codes are supported when the URL map is bound to
10957 # target gRPC proxy that has validateForProxyless field set to true.
10958 #
10959 # - cancelled
10960 # - deadline-exceeded
10961 # - internal
10962 # - resource-exhausted
10963 # - unavailable
10964 &quot;A String&quot;,
10965 ],
10966 },
10967 &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
10968 # time the request has been fully processed (known as *end-of-stream*)
10969 # up until the response has been processed. Timeout includes
10970 # all retries.
10971 #
10972 # If not specified, this field uses the largest timeout among all backend
10973 # services associated with the route.
10974 #
10975 # Not supported when the URL map is bound to a target gRPC proxy that
10976 # has validateForProxyless field set to true.
10977 # as a count of seconds and fractions of seconds at nanosecond
10978 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10979 # or &quot;month&quot;. Range is approximately 10,000 years.
10980 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10981 # Durations less than one second are represented with a 0
10982 # `seconds` field and a positive `nanos` field. Must be from 0
10983 # to 999,999,999 inclusive.
10984 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10985 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10986 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10987 },
10988 &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
10989 # to the matched service.
10990 #
10991 # urlRewrite is the only action supported in UrlMaps
10992 # for classic Application Load Balancers.
10993 #
10994 # Not supported when the URL map is bound to a target gRPC proxy that
10995 # has the validateForProxyless field set to true.
10996 # backend service.
10997 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
10998 # host header is replaced with contents of hostRewrite.
10999 #
11000 # The value must be from 1 to 255 characters.
11001 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
11002 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
11003 #
11004 # The value must be from 1 to 1024 characters.
11005 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
11006 # header) using the HTTP template syntax.
11007 #
11008 # A corresponding
11009 # path_template_match must be specified. Any template variables must exist in
11010 # the path_template_match field.
11011 #
11012 #
11013 # - -At least one variable must be specified in the path_template_match
11014 # field
11015 # - You can omit variables from the rewritten URL
11016 # - The * and ** operators cannot be matched
11017 # unless they have a corresponding variable name - e.g.
11018 # {format=*} or {var=**}.
11019 #
11020 # For example, a path_template_match of /static/{format=**}
11021 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
11022 # rewrite, so that /{country}/{format}/{suffix=**} can be
11023 # rewritten as /content/{format}/{country}/{suffix}.
11024 #
11025 # At least
11026 # one non-empty routeRules[].matchRules[].path_template_match is
11027 # required.
11028 #
11029 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
11030 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
11031 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
11032 # It uses RE2 syntax with the following constraints:
11033 #
11034 #
11035 # - Any single character operators
11036 # - Groups are allowed to have only submatch operator inside
11037 # - Groups are allowed only without any char repetition, e.g.
11038 # .*
11039 # - Any char repetition, e.g. .*, is
11040 # only allowed to be used in a single regex together with:
11041 #
11042 #
11043 # - Empty string operators
11044 # - Other repetitions
11045 # - Ranges
11046 # - Repetitions of ranges
11047 #
11048 #
11049 # - Ranges are only allowed to have:
11050 #
11051 #
11052 # - Character range
11053 # - Digits range
11054 # - Symbols listed in characters allowed for ranges
11055 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
11056 # the path.
11057 },
11058 },
11059 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
11060 # occurs. The weights determine the fraction of traffic that flows to
11061 # their corresponding backend service. If all traffic needs to
11062 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
11063 #
11064 # After a backend service is identified and before forwarding
11065 # the request to
11066 # the backend service, advanced routing actions such as URL rewrites and
11067 # header transformations are applied depending on additional settings
11068 # specified in this HttpRouteAction.
11069 { # In contrast to a single BackendService in
11070 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
11071 # multiple backend services. The volume of traffic for each
11072 # backend service is proportional to the weight specified
11073 # in each WeightedBackendService
11074 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
11075 # resource. Before
11076 # forwarding the request to backendService, the load balancer
11077 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
11078 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
11079 # effect for the selected backendService.
11080 #
11081 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
11082 #
11083 # headerAction is not supported for load balancers that have
11084 # their loadBalancingScheme set to EXTERNAL.
11085 #
11086 # Not supported when the URL map is bound to a target gRPC proxy that
11087 # has validateForProxyless field set to true.
11088 # the request is passed along to the selected backendService.
11089 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
11090 { # Specification determining how headers are added to requests or responses.
11091 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
11092 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
11093 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
11094 # that already
11095 # exist for the header. If true, headerValue is set for the
11096 # header, discarding any values that were set for that header.
11097 #
11098 # The default value is true,
11099 # unless a variable is present in headerValue,
11100 # in which case the default value is false.
11101 # .
11102 },
11103 ],
11104 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
11105 # request before forwarding the request to the backendService.
11106 &quot;A String&quot;,
11107 ],
11108 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
11109 # client.
11110 { # Specification determining how headers are added to requests or responses.
11111 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
11112 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
11113 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
11114 # that already
11115 # exist for the header. If true, headerValue is set for the
11116 # header, discarding any values that were set for that header.
11117 #
11118 # The default value is true,
11119 # unless a variable is present in headerValue,
11120 # in which case the default value is false.
11121 # .
11122 },
11123 ],
11124 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
11125 # response before sending the response back to the client.
11126 &quot;A String&quot;,
11127 ],
11128 },
11129 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
11130 # computed asweight / (sum of all weightedBackendService weights in routeAction).
11131 #
11132 # The selection of a backend service is determined only for new traffic.
11133 # Once a user&#x27;s request has been directed to a backend service,
11134 # subsequent requests are sent to the same backend service as
11135 # determined by the backend service&#x27;s session affinity policy.
11136 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
11137 # splitting. If you do, the weighted traffic splitting configuration takes
11138 # precedence.
11139 #
11140 # The value must be from 0 to 1000.
11141 },
11142 ],
11143 },
11144 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
11145 # is directed if this rule is matched. If routeAction is
11146 # also specified, advanced routing actions, such as URL rewrites,
11147 # take effect before sending the request to the backend.
11148 #
11149 #
11150 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
11151 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
11152 # specified by urlRedirect.
11153 #
11154 #
11155 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
11156 #
11157 #
11158 # Not supported when the URL map is bound to a target gRPC proxy.
11159 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
11160 # was supplied in the request.
11161 #
11162 # The value must be from 1 to 255
11163 # characters.
11164 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
11165 # set to HTTPS.
11166 # If set to false, the URL scheme of the redirected request
11167 # remains the same as that of the request.
11168 #
11169 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
11170 #
11171 # The default is set to false.
11172 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
11173 # that was supplied in the request.
11174 #
11175 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
11176 # supplied, the path of the original request is used for the redirect.
11177 #
11178 # The value must be from 1 to 1024 characters.
11179 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
11180 # the HttpRouteRuleMatch, retaining the remaining portion
11181 # of the URL before redirecting the request.
11182 #
11183 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
11184 # supplied, the path of the original request is used for the redirect.
11185 #
11186 # The value must be from 1 to 1024 characters.
11187 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
11188 #
11189 # Supported values are:
11190 #
11191 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
11192 # to 301.
11193 # - FOUND, which corresponds to 302.
11194 # - SEE_OTHER which corresponds to 303.
11195 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
11196 # method is retained.
11197 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
11198 # method is retained.
11199 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
11200 # URL is
11201 # removed before redirecting the request. If set to false, the
11202 # query portion of the original URL is retained.
11203 #
11204 # The default is set to false.
11205 },
11206 },
11207 ],
11208 &quot;routeRules&quot;: [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
11209 # desired. routeRules are evaluated in order of priority, from
11210 # the lowest to highest number.
11211 #
11212 # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
11213 { # The HttpRouteRule setting specifies how to match an HTTP request
11214 # and the corresponding routing action that load balancing proxies perform.
11215 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
11216 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
11217 #
11218 # If a policy for an
11219 # error code is not configured for the RouteRule, a policy for
11220 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
11221 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
11222 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
11223 # effect.
11224 #
11225 # For example, consider a UrlMap with the following configuration:
11226 #
11227 #
11228 # - UrlMap.defaultCustomErrorResponsePolicy are configured
11229 # with policies for 5xx and 4xx errors
11230 # - A RouteRule for /coming_soon/ is configured for the
11231 # error code 404.
11232 #
11233 # 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
11234 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
11235 # the policy in RouteRule.customErrorResponsePolicy takes
11236 # effect. If any of the requests in this example encounter a 500
11237 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
11238 #
11239 # When
11240 # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
11241 # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
11242 # a retry, if load balancer is successful in reaching the
11243 # service, the customErrorResponsePolicy is ignored and
11244 # the response from the service is returned to the client.
11245 #
11246 # customErrorResponsePolicy is supported only for
11247 # global external Application Load Balancers.
11248 # backend service or backend bucket responds with an error.
11249 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
11250 #
11251 # In a given policy, if you specify rules for both a range of error codes
11252 # as well as rules for specific error codes then rules with specific error
11253 # codes have a higher priority. For example, assume that you configure a rule
11254 # for 401 (Un-authorized) code, and another for all 4 series
11255 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
11256 # However if the backend service returns a 403, the rule for4xx takes effect.
11257 { # Specifies the mapping between the response code that will be returned along
11258 # with the custom error content and the response code returned by the backend
11259 # service.
11260 &quot;matchResponseCodes&quot;: [ # Valid values include:
11261 #
11262 #
11263 # - A number between 400 and 599: For example
11264 # 401 or 503, in which case the load balancer
11265 # applies the policy if the error code exactly matches this value.
11266 # - 5xx: Load Balancer will apply the policy if the
11267 # backend service responds with any response code in the range of
11268 # 500 to 599.
11269 # - 4xx: Load
11270 # Balancer will apply the policy if the backend service responds with any
11271 # response code in the range of 400 to
11272 # 499.
11273 #
11274 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
11275 &quot;A String&quot;,
11276 ],
11277 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
11278 # error content. If overrideResponseCode is not supplied, the
11279 # same response code returned by the original backend bucket or backend
11280 # service is returned to the client.
11281 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
11282 #
11283 # path must start
11284 # with a leading slash. path cannot have trailing slashes.
11285 #
11286 # If the file is not available in backendBucket or the
11287 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
11288 #
11289 # The value must
11290 # be from 1 to 1024 characters
11291 },
11292 ],
11293 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
11294 # contains the custom error content. Examples are:
11295 #
11296 #
11297 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
11298 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
11299 # - global/backendBuckets/myBackendBucket
11300 #
11301 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
11302 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
11303 #
11304 # If load balancer cannot reach
11305 # the backendBucket, a simple Not Found Error will
11306 # be returned, with the original response code (oroverrideResponseCode if configured).
11307 #
11308 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
11309 },
11310 &quot;description&quot;: &quot;A String&quot;, # The short description conveying the intent of this routeRule.
11311 #
11312 #
11313 # The description can have a maximum length of 1024 characters.
11314 &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
11315 # for the selected backendService.
11316 #
11317 # The headerAction value specified here is applied before the
11318 # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
11319 #
11320 # HeaderAction is not supported for load balancers
11321 # that have
11322 # their loadBalancingScheme set to EXTERNAL.
11323 #
11324 # Not supported when the URL map is bound to a target gRPC proxy that
11325 # has validateForProxyless field set to true.
11326 # the request is passed along to the selected backendService.
11327 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
11328 { # Specification determining how headers are added to requests or responses.
11329 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
11330 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
11331 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
11332 # that already
11333 # exist for the header. If true, headerValue is set for the
11334 # header, discarding any values that were set for that header.
11335 #
11336 # The default value is true,
11337 # unless a variable is present in headerValue,
11338 # in which case the default value is false.
11339 # .
11340 },
11341 ],
11342 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
11343 # request before forwarding the request to the backendService.
11344 &quot;A String&quot;,
11345 ],
11346 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
11347 # client.
11348 { # Specification determining how headers are added to requests or responses.
11349 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
11350 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
11351 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
11352 # that already
11353 # exist for the header. If true, headerValue is set for the
11354 # header, discarding any values that were set for that header.
11355 #
11356 # The default value is true,
11357 # unless a variable is present in headerValue,
11358 # in which case the default value is false.
11359 # .
11360 },
11361 ],
11362 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
11363 # response before sending the response back to the client.
11364 &quot;A String&quot;,
11365 ],
11366 },
11367 &quot;httpFilterConfigs&quot;: [ # Outbound route specific configuration fornetworkservices.HttpFilter resources enabled by Traffic
11368 # Director. httpFilterConfigs only applies for load balancers
11369 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
11370 # more details.
11371 #
11372 # Not supported when the URL map is bound to a target gRPC proxy that
11373 # has validateForProxyless field set to true.
11374 { # HttpFilterConfiguration supplies additional contextual settings
11375 # for networkservices.HttpFilter resources enabled by Traffic
11376 # Director.
11377 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
11378 # YAML formatted and only contain fields defined in the protobuf identified
11379 # in configTypeUrl
11380 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
11381 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
11382 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
11383 # configuration belongs to. This name must be known to the xDS client.
11384 # Example: envoy.wasm
11385 },
11386 ],
11387 &quot;httpFilterMetadata&quot;: [ # Outbound route specific metadata supplied tonetworkservices.HttpFilter resources enabled by Traffic
11388 # Director. httpFilterMetadata only applies for load balancers
11389 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
11390 # more details.
11391 #
11392 # The only configTypeUrl supported istype.googleapis.com/google.protobuf.Struct
11393 #
11394 # Not supported when the URL map is bound to a target gRPC proxy that
11395 # has validateForProxyless field set to true.
11396 { # HttpFilterConfiguration supplies additional contextual settings
11397 # for networkservices.HttpFilter resources enabled by Traffic
11398 # Director.
11399 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
11400 # YAML formatted and only contain fields defined in the protobuf identified
11401 # in configTypeUrl
11402 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
11403 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
11404 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
11405 # configuration belongs to. This name must be known to the xDS client.
11406 # Example: envoy.wasm
11407 },
11408 ],
11409 &quot;matchRules&quot;: [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
11410 # this routeRule when any of thematchRules are satisfied. However predicates within
11411 # a given matchRule have AND semantics. All predicates
11412 # within a matchRule must match for the request to
11413 # match the rule.
11414 { # HttpRouteRuleMatch specifies a set of criteria for matching
11415 # requests to an HttpRouteRule. All specified criteria must
11416 # be satisfied for a match to occur.
11417 &quot;fullPathMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
11418 # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
11419 # that may be part of the original URL.
11420 #
11421 # fullPathMatch must be from 1 to 1024 characters.
11422 #
11423 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
11424 # specified.
11425 &quot;headerMatches&quot;: [ # Specifies a list of header match criteria, all of which must match
11426 # corresponding headers in the request.
11427 { # matchRule criteria for request header matches.
11428 &quot;exactMatch&quot;: &quot;A String&quot;, # The value should exactly match contents of exactMatch.
11429 #
11430 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
11431 &quot;headerName&quot;: &quot;A String&quot;, # The name of the HTTP header to match.
11432 #
11433 # For matching against the HTTP request&#x27;s authority, use a headerMatch
11434 # with the header name &quot;:authority&quot;.
11435 #
11436 # For matching a request&#x27;s method, use the headerName &quot;:method&quot;.
11437 #
11438 # When the URL map is bound to a target gRPC proxy that has
11439 # the validateForProxyless field set to true, only
11440 # non-binary
11441 # user-specified custom metadata and the `content-type` header are supported.
11442 # The following transport-level headers cannot be used in header matching
11443 # rules:
11444 # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
11445 # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
11446 # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
11447 # `grpc-timeout` and `grpc-trace-bin`.
11448 &quot;invertMatch&quot;: True or False, # If set to false, the headerMatch is considered a
11449 # match if the preceding match criteria are met. If set to true,
11450 # the headerMatch is considered a match if the preceding
11451 # match criteria are NOT met.
11452 #
11453 # The default setting is false.
11454 &quot;prefixMatch&quot;: &quot;A String&quot;, # The value of the header must start with the contents ofprefixMatch.
11455 #
11456 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
11457 &quot;presentMatch&quot;: True or False, # A header with the contents of headerName must exist. The
11458 # match takes place whether or not the request&#x27;s header has a value.
11459 #
11460 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
11461 &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
11462 # specified in rangeMatch. If the header does not contain an
11463 # integer, number or is empty, the match fails.
11464 #
11465 # For example for a range [-5, 0]
11466 #
11467 #
11468 # - -3 will match.
11469 # - 0 will not match.
11470 # - 0.25 will not match.
11471 # - -3someString will not match.
11472 #
11473 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
11474 #
11475 # rangeMatch is not supported for load balancers
11476 # that have loadBalancingScheme set to EXTERNAL.
11477 # within the specified integer range.
11478 &quot;rangeEnd&quot;: &quot;A String&quot;, # The end of the range (exclusive) in signed long integer format.
11479 &quot;rangeStart&quot;: &quot;A String&quot;, # The start of the range (inclusive) in signed long integer format.
11480 },
11481 &quot;regexMatch&quot;: &quot;A String&quot;, # The value of the header must match the regular expression specified inregexMatch.
11482 # For more information about regular expression syntax, see Syntax.
11483 #
11484 # For matching against a port specified in the HTTP request, use a
11485 # headerMatch with headerName set to PORT and a regular expression that
11486 # satisfies the RFC2616 Host header&#x27;s port specifier.
11487 #
11488 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
11489 #
11490 # Regular expressions can only be used when the loadBalancingScheme is
11491 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
11492 # (regional scope) or INTERNAL_MANAGED.
11493 &quot;suffixMatch&quot;: &quot;A String&quot;, # The value of the header must end with the contents ofsuffixMatch.
11494 #
11495 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
11496 },
11497 ],
11498 &quot;ignoreCase&quot;: True or False, # Specifies that prefixMatch and fullPathMatch
11499 # matches are case sensitive.
11500 #
11501 # The default value is false.
11502 #
11503 # ignoreCase must not be used with regexMatch.
11504 #
11505 # Not supported when the URL map is bound to a target gRPC proxy.
11506 &quot;metadataFilters&quot;: [ # Opaque filter criteria used by the load balancer to restrict routing
11507 # configuration to a limited set of xDS
11508 # compliant clients. In their xDS requests to the load balancer, xDS clients
11509 # present node
11510 # metadata. When there is a match, the relevant routing configuration
11511 # is made available to those proxies.
11512 #
11513 # 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
11514 # the metadata. If its filterMatchCriteria is set to
11515 # MATCH_ALL, then all of its filterLabels must match with
11516 # corresponding labels provided in the metadata. If multiple
11517 # metadata filters are specified, all of them need to be
11518 # satisfied in order to be considered a match.
11519 #
11520 # metadataFilters specified here is applied after those
11521 # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
11522 #
11523 # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
11524 #
11525 # Not supported when the URL map is bound to a target gRPC proxy that
11526 # has validateForProxyless field set to true.
11527 { # Opaque filter criteria used by load balancers to restrict routing
11528 # configuration to a limited set of load balancing proxies. Proxies and
11529 # sidecars involved in load balancing would typically present metadata to the
11530 # load balancers that need to match criteria specified here. If a match takes
11531 # place, the relevant configuration is made available to those
11532 # proxies.
11533 #
11534 # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
11535 # one of thefilterLabels must match the corresponding label provided in
11536 # the metadata. If its filterMatchCriteria is set to
11537 # MATCH_ALL, then all of its filterLabels must match with
11538 # corresponding labels provided in the metadata.
11539 #
11540 # An example for using metadataFilters would be: if
11541 # load balancing involves
11542 # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in of their XDS requests to loadbalancers.
11543 &quot;filterLabels&quot;: [ # The list of label value pairs that must match labels in the provided
11544 # metadata based on filterMatchCriteria
11545 #
11546 # This list must not be empty and can have at the most 64 entries.
11547 { # MetadataFilter label name value pairs that are expected
11548 # to match corresponding labels presented as metadata to the load balancer.
11549 &quot;name&quot;: &quot;A String&quot;, # Name of metadata label.
11550 #
11551 # The name can have a maximum length of 1024 characters and must be at
11552 # least 1 character long.
11553 &quot;value&quot;: &quot;A String&quot;, # The value of the label must match the specified value.
11554 #
11555 # value can have a maximum length of 1024 characters.
11556 },
11557 ],
11558 &quot;filterMatchCriteria&quot;: &quot;A String&quot;, # Specifies how individual filter label matches
11559 # within the list of filterLabels and contributes toward the
11560 # overall metadataFilter match.
11561 #
11562 # Supported values are:
11563 #
11564 # - MATCH_ANY: at least one of the filterLabels
11565 # must have a matching label in the provided metadata.
11566 # - MATCH_ALL: all filterLabels must have
11567 # matching labels in the provided metadata.
11568 },
11569 ],
11570 &quot;pathTemplateMatch&quot;: &quot;A String&quot;, # If specified, this field defines a path template pattern that must match
11571 # the :path header after the query string is removed.
11572 #
11573 # A path template pattern can include variables and wildcards.
11574 # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
11575 # matches a single path segment, and ** that matches zero or
11576 # more path segments. The pattern must follow these rules:
11577 #
11578 #
11579 # - The value must be between 1 and 1024 characters.
11580 # - The pattern must start with a leading slash (&quot;/&quot;).
11581 # - No more than 5 operators (variables or wildcards) may appear in
11582 # the pattern.
11583 #
11584 # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
11585 # set.
11586 &quot;prefixMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the request&#x27;s
11587 # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
11588 #
11589 # The value must be from 1 to 1024 characters.
11590 #
11591 # The * character inside a prefix match is
11592 # treated as a literal character, not as a wildcard.
11593 #
11594 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
11595 # used within a matchRule.
11596 &quot;queryParameterMatches&quot;: [ # Specifies a list of query parameter match criteria, all of which must
11597 # match corresponding query parameters in the request.
11598 #
11599 # Not supported when the URL map is bound to a target gRPC proxy.
11600 { # HttpRouteRuleMatch criteria for a request&#x27;s query parameter.
11601 &quot;exactMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
11602 # parameter exactly matches the contents of exactMatch.
11603 #
11604 # Only one of presentMatch, exactMatch, orregexMatch must be set.
11605 &quot;name&quot;: &quot;A String&quot;, # The name of the query parameter to match. The query parameter must exist in
11606 # the request, in the absence of which the request match fails.
11607 &quot;presentMatch&quot;: True or False, # Specifies that the queryParameterMatch matches if the
11608 # request contains the query parameter, irrespective of whether the
11609 # parameter has a value or not.
11610 #
11611 # Only one of presentMatch, exactMatch, orregexMatch must be set.
11612 &quot;regexMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
11613 # parameter matches the regular expression specified byregexMatch. For
11614 # more information about regular expression syntax, see Syntax.
11615 #
11616 # Only one of presentMatch, exactMatch, orregexMatch must be set.
11617 #
11618 # Regular expressions can only be used when the loadBalancingScheme is
11619 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
11620 # (regional scope) or INTERNAL_MANAGED.
11621 },
11622 ],
11623 &quot;regexMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
11624 # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
11625 # supplied with the original URL. For
11626 # more information about regular expression syntax, see Syntax.
11627 #
11628 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
11629 # specified.
11630 #
11631 # Regular expressions can only be used when the loadBalancingScheme is
11632 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
11633 # (regional scope) or INTERNAL_MANAGED.
11634 },
11635 ],
11636 &quot;priority&quot;: 42, # For routeRules within a given pathMatcher,
11637 # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
11638 # of priority, from the lowest to highest number. The priority of a
11639 # rule decreases as its number increases (1, 2, 3, N+1). The first rule
11640 # that matches the request is applied.
11641 #
11642 #
11643 # You cannot configure two or more routeRules with the same priority.
11644 # Priority for each rule must be set to a number from 0 to 2147483647
11645 # inclusive.
11646 #
11647 #
11648 # Priority numbers can have gaps, which enable you to add or remove rules
11649 # in the future without affecting the rest of the rules. For example, 1, 2,
11650 # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
11651 # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
11652 # without any impact on existing rules.
11653 &quot;routeAction&quot;: { # In response to a matching matchRule, the load balancer
11654 # performs advanced routing actions, such as URL rewrites and header
11655 # transformations, before forwarding the request to the selected backend.
11656 #
11657 #
11658 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
11659 #
11660 #
11661 # URL maps for classic Application Load Balancers only support
11662 # the urlRewrite action within a route rule&#x27;srouteAction.
11663 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
11664 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
11665 # property must be specified. This policy cannot be specified if any target
11666 # backend has Identity-Aware Proxy enabled.
11667 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
11668 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
11669 # header names can be specified. The cache is bypassed for all `cacheMode`
11670 # values.
11671 &quot;A String&quot;,
11672 ],
11673 &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
11674 # on the backend type: for Backend Services, the complete request URI is
11675 # used; for Backend Buckets, the request URI is used without the protocol or
11676 # host, and only query parameters known to Cloud Storage are included.
11677 # Policy defined on Route Action.
11678 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
11679 # parameters will be included. Either specify `excludedQueryParameters`
11680 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
11681 # encoded and not treated as delimiters.
11682 #
11683 # Note: This field applies to routes that use backend services. Attempting
11684 # to set it on a route that points exclusively to Backend Buckets will
11685 # result in a configuration error. For routes that point to a Backend
11686 # Bucket, use `includedQueryParameters` to define which parameters should
11687 # be part of the cache key.
11688 &quot;A String&quot;,
11689 ],
11690 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
11691 #
11692 # Note: This setting is only applicable to routes that use a Backend
11693 # Service. It does not affect requests served by a Backend Bucket, as the
11694 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
11695 # it on a route that points exclusively to Backend Buckets will result in a
11696 # configuration error.
11697 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
11698 #
11699 # Note: This setting is only applicable to routes that use a Backend
11700 # Service. It does not affect requests served by a Backend Bucket, as the
11701 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
11702 # set on a route that points exclusively to Backend Buckets will result in
11703 # a configuration error.
11704 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
11705 # `includedQueryParameters` and `excludedQueryParameters`. If neither
11706 # is set, the entire query string will be included. If false, the query
11707 # string will be excluded from the cache key entirely.
11708 #
11709 # Note: This field applies to routes that use backend services. Attempting
11710 # to set it on a route that points exclusively to Backend Buckets will
11711 # result in a configuration error. For routes that point to a Backend
11712 # Bucket, use `includedQueryParameters` to define which parameters should
11713 # be part of the cache key.
11714 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
11715 # The name=value pair will be used in the cache key Cloud CDN generates.
11716 #
11717 # Note: This setting is only applicable to routes that use a Backend
11718 # Service. It does not affect requests served by a Backend Bucket.
11719 # Attempting to set it on a route that points exclusively to Backend
11720 # Buckets will result in a configuration error. Up to 5 cookie names can be
11721 # specified.
11722 &quot;A String&quot;,
11723 ],
11724 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
11725 &quot;A String&quot;,
11726 ],
11727 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
11728 # parameters will be excluded. Either specify `includedQueryParameters`
11729 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
11730 # encoded and not treated as delimiters.
11731 &quot;A String&quot;,
11732 ],
11733 },
11734 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
11735 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
11736 &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
11737 # content. This is used to clamp the max-age (or Expires) value sent to the
11738 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
11739 # is used for the response max-age directive, along with a &quot;public&quot;
11740 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
11741 # clamps the max-age from the origin (if specified), or else sets the
11742 # response max-age directive to the lesser of the `clientTtl` and
11743 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
11744 # present. The maximum allowed value is 31,622,400s (1 year). If not
11745 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
11746 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
11747 # `USE_ORIGIN_HEADERS`.
11748 # as a count of seconds and fractions of seconds at nanosecond
11749 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
11750 # or &quot;month&quot;. Range is approximately 10,000 years.
11751 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
11752 # Durations less than one second are represented with a 0
11753 # `seconds` field and a positive `nanos` field. Must be from 0
11754 # to 999,999,999 inclusive.
11755 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
11756 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
11757 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
11758 },
11759 &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
11760 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
11761 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
11762 # greater than that of `maxTtl`. When the `cacheMode` is set to
11763 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
11764 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
11765 # accessed objects may be evicted from the cache before the defined TTL. If
11766 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
11767 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
11768 # `USE_ORIGIN_HEADERS`.
11769 # as a count of seconds and fractions of seconds at nanosecond
11770 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
11771 # or &quot;month&quot;. Range is approximately 10,000 years.
11772 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
11773 # Durations less than one second are represented with a 0
11774 # `seconds` field and a positive `nanos` field. Must be from 0
11775 # to 999,999,999 inclusive.
11776 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
11777 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
11778 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
11779 },
11780 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
11781 # attempt to set a max-age or s-maxage higher than this, or an Expires header
11782 # more than `maxTtl` seconds in the future will be capped at the value of
11783 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
11784 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
11785 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
11786 # Infrequently accessed objects may be evicted from the cache before the
11787 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
11788 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
11789 # mode.
11790 # as a count of seconds and fractions of seconds at nanosecond
11791 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
11792 # or &quot;month&quot;. Range is approximately 10,000 years.
11793 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
11794 # Durations less than one second are represented with a 0
11795 # `seconds` field and a positive `nanos` field. Must be from 0
11796 # to 999,999,999 inclusive.
11797 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
11798 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
11799 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
11800 },
11801 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
11802 # to apply fine-grained caching for common errors or redirects.
11803 # This can reduce the load on your origin and improve end-user
11804 # experience by reducing response latency.
11805 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
11806 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
11807 # the specified response code that lack any Cache-Control, Expires, or
11808 # Pragma: no-cache directives. When the `cacheMode` is set to
11809 # `FORCE_CACHE_ALL`, negative caching applies to all responses
11810 # with the specified response code, and overrides any caching headers. By
11811 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
11812 #
11813 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
11814 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
11815 # * 405 (Method Not Found), 501 (Not Implemented): 60s
11816 #
11817 # These defaults can be overridden in `negativeCachingPolicy`.
11818 # If not specified, Cloud CDN applies negative caching by default.
11819 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
11820 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
11821 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
11822 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
11823 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
11824 # all response codes that you wish to cache. Cloud CDN will not apply any
11825 # default negative caching when a policy exists.
11826 { # Specify CDN TTLs for response error codes.
11827 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
11828 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
11829 # specified as values, and you cannot specify a status code more than
11830 # once.
11831 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
11832 # corresponding status code.
11833 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
11834 # objects may be evicted from the cache before the defined TTL.
11835 # as a count of seconds and fractions of seconds at nanosecond
11836 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
11837 # or &quot;month&quot;. Range is approximately 10,000 years.
11838 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
11839 # Durations less than one second are represented with a 0
11840 # `seconds` field and a positive `nanos` field. Must be from 0
11841 # to 999,999,999 inclusive.
11842 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
11843 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
11844 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
11845 },
11846 },
11847 ],
11848 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
11849 # requests into a small number of requests to the origin. If not specified,
11850 # Cloud CDN applies request coalescing by default.
11851 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
11852 # content with the origin, or when an error is encountered when refreshing
11853 # the cache.
11854 # This setting defines the default &quot;max-stale&quot; duration for any cached
11855 # responses that do not specify a max-stale directive. Stale responses that
11856 # exceed the TTL configured here will not be served. The default limit
11857 # (max-stale) is 86400s (1 day), which will allow stale content to be
11858 # served up to this limit beyond the max-age (or s-maxage) of a cached
11859 # response.
11860 # The maximum allowed value is 604800 (1 week).
11861 # Set this to zero (0) to disable serve-while-stale.
11862 # as a count of seconds and fractions of seconds at nanosecond
11863 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
11864 # or &quot;month&quot;. Range is approximately 10,000 years.
11865 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
11866 # Durations less than one second are represented with a 0
11867 # `seconds` field and a positive `nanos` field. Must be from 0
11868 # to 999,999,999 inclusive.
11869 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
11870 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
11871 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
11872 },
11873 },
11874 &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
11875 # information about the W3C recommendation for cross-origin resource sharing
11876 # (CORS), see Fetch API Living
11877 # Standard.
11878 #
11879 # Not supported when the URL map is bound to a target gRPC proxy.
11880 # information about the W3C recommendation for cross-origin resource sharing
11881 # (CORS), see Fetch API Living
11882 # Standard.
11883 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
11884 # indicates that
11885 # the actual request can include user credentials. This field translates to
11886 # the Access-Control-Allow-Credentials header.
11887 #
11888 # Default is false.
11889 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
11890 # header.
11891 &quot;A String&quot;,
11892 ],
11893 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
11894 # header.
11895 &quot;A String&quot;,
11896 ],
11897 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
11898 # more information, see regular expression syntax.
11899 #
11900 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
11901 #
11902 # Regular expressions can only be used when the loadBalancingScheme is
11903 # set to INTERNAL_SELF_MANAGED.
11904 &quot;A String&quot;,
11905 ],
11906 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
11907 #
11908 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
11909 &quot;A String&quot;,
11910 ],
11911 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
11912 # The default value is false, which indicates that the CORS
11913 # policy is in effect.
11914 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
11915 # header.
11916 &quot;A String&quot;,
11917 ],
11918 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
11919 # seconds. This field translates to the Access-Control-Max-Age
11920 # header.
11921 },
11922 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
11923 # the resiliency of clients to backend service failure. As part of fault
11924 # injection, when clients send requests to a backend service, delays can be
11925 # introduced by a load balancer on a percentage of requests before sending
11926 # those requests to the backend service. Similarly requests from clients can
11927 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
11928 # that are configured with a fault_injection_policy if:
11929 # 1. The traffic is generated by fault injection AND
11930 # 2. The fault injection is not a delay fault injection.
11931 # Fault injection is not supported with the classic Application Load Balancer
11932 # . To see which load balancers support fault injection,
11933 # see Load
11934 # balancing: Routing and traffic management features.
11935 # the resiliency of clients to backend service failure. As part of fault
11936 # injection, when clients send requests to a backend service, delays can be
11937 # introduced by the load balancer on a percentage of requests before sending
11938 # those request to the backend service. Similarly requests from clients can be
11939 # aborted by the load balancer for a percentage of requests.
11940 &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
11941 # injection.
11942 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
11943 #
11944 # The value must be from 200 to 599 inclusive.
11945 #
11946 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
11947 # according to this
11948 # mapping table. HTTP status 200 is mapped to gRPC status
11949 # UNKNOWN. Injecting an OK status is currently not supported by
11950 # Traffic Director.
11951 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
11952 # that is aborted as part of fault injection.
11953 #
11954 # The value must be from 0.0 to 100.0 inclusive.
11955 },
11956 &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
11957 # injection, before being sent to a backend service.
11958 # request to the backend service as part of fault injection.
11959 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
11960 # as a count of seconds and fractions of seconds at nanosecond
11961 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
11962 # or &quot;month&quot;. Range is approximately 10,000 years.
11963 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
11964 # Durations less than one second are represented with a 0
11965 # `seconds` field and a positive `nanos` field. Must be from 0
11966 # to 999,999,999 inclusive.
11967 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
11968 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
11969 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
11970 },
11971 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
11972 # which a delay is introduced as part of fault injection.
11973 #
11974 # The value must be from 0.0 to 100.0 inclusive.
11975 },
11976 },
11977 &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
11978 # Global EXTERNAL_MANAGED load balancer schemes.
11979 # Either Cloud CDN must be enabled on the backend service or backend bucket
11980 # serving the route, or cache policy must be configured on the same route
11981 # dynamically processes and delivers images from the network edge.
11982 # Image Optimization is only available for Global External Application Load
11983 # Balancers.
11984 # Either Cloud CDN must be enabled on the backend service or backend bucket
11985 # serving the route, or cache policy must be configured on the same route.
11986 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
11987 },
11988 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
11989 # Unlike the timeout field where the timeout duration starts
11990 # from the time the request has been fully processed (known as*end-of-stream*),
11991 # the duration in this field is computed from the beginning of the stream
11992 # until the response has been processed, including all retries. A
11993 # stream that does not complete in this duration is closed.
11994 #
11995 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
11996 # with the route.
11997 #
11998 # This field is only allowed if the Url map is used with backend services
11999 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
12000 # as a count of seconds and fractions of seconds at nanosecond
12001 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12002 # or &quot;month&quot;. Range is approximately 10,000 years.
12003 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12004 # Durations less than one second are represented with a 0
12005 # `seconds` field and a positive `nanos` field. Must be from 0
12006 # to 999,999,999 inclusive.
12007 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12008 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12009 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12010 },
12011 &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
12012 # are shadowed to a separate mirrored backend service. The load balancer does
12013 # not wait for responses from the shadow service. Before sending traffic
12014 # to the shadow service, the host / authority header is suffixed with-shadow.
12015 #
12016 # Not supported when the URL map is bound to a target gRPC proxy that
12017 # has the validateForProxyless field set to true.
12018 # are shadowed to a separate mirrored backend service. The load balancer
12019 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
12020 # to the shadow service, the host or authority header is suffixed with-shadow.
12021 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
12022 # mirrored to.
12023 #
12024 # The backend service configured for a mirroring
12025 # policy must reference backends that are of the same type as the original
12026 # backend service matched in the URL map.
12027 #
12028 # Serverless NEG backends are not currently supported as a mirrored
12029 # backend service.
12030 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
12031 },
12032 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
12033 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
12034 # If not specified, defaults to 1.
12035 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
12036 #
12037 # If not specified, will use the timeout set in theHttpRouteAction field.
12038 # If timeout in the HttpRouteAction field is not set, this field
12039 # uses the largest timeout
12040 # among all backend services associated with the route.
12041 #
12042 # Not supported when the URL map is bound to a target gRPC proxy that
12043 # has the validateForProxyless field set to true.
12044 # as a count of seconds and fractions of seconds at nanosecond
12045 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12046 # or &quot;month&quot;. Range is approximately 10,000 years.
12047 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12048 # Durations less than one second are represented with a 0
12049 # `seconds` field and a positive `nanos` field. Must be from 0
12050 # to 999,999,999 inclusive.
12051 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12052 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12053 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12054 },
12055 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
12056 # values are:
12057 #
12058 # - 5xx: retry is attempted if the instance or endpoint
12059 # responds with any 5xx response code, or if the instance or
12060 # endpoint does not respond at all. For example, disconnects, reset, read
12061 # timeout, connection failure, and refused streams.
12062 # - gateway-error: Similar to 5xx, but only
12063 # applies to response codes 502, 503 or504.
12064 # - connect-failure: a retry is attempted on failures
12065 # connecting to the instance or endpoint. For example, connection
12066 # timeouts.
12067 # - retriable-4xx: a retry is attempted if the instance
12068 # or endpoint responds with a 4xx response code.
12069 # The only error that you can retry is error code 409.
12070 # - refused-stream: a retry is attempted if the instance
12071 # or endpoint resets the stream with a REFUSED_STREAM error
12072 # code. This reset type indicates that it is safe to retry.
12073 # - cancelled: a retry is attempted if the gRPC status
12074 # code in the response header is set to cancelled.
12075 # - deadline-exceeded: a retry is attempted if the gRPC
12076 # status code in the response header is set todeadline-exceeded.
12077 # - internal: a retry is attempted if the gRPC
12078 # status code in the response header is set tointernal.
12079 # - resource-exhausted: a retry is attempted if the gRPC
12080 # status code in the response header is set toresource-exhausted.
12081 # - unavailable: a retry is attempted if the gRPC
12082 # status code in the response header is set tounavailable.
12083 #
12084 # Only the following codes are supported when the URL map is bound to
12085 # target gRPC proxy that has validateForProxyless field set to true.
12086 #
12087 # - cancelled
12088 # - deadline-exceeded
12089 # - internal
12090 # - resource-exhausted
12091 # - unavailable
12092 &quot;A String&quot;,
12093 ],
12094 },
12095 &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
12096 # time the request has been fully processed (known as *end-of-stream*)
12097 # up until the response has been processed. Timeout includes
12098 # all retries.
12099 #
12100 # If not specified, this field uses the largest timeout among all backend
12101 # services associated with the route.
12102 #
12103 # Not supported when the URL map is bound to a target gRPC proxy that
12104 # has validateForProxyless field set to true.
12105 # as a count of seconds and fractions of seconds at nanosecond
12106 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12107 # or &quot;month&quot;. Range is approximately 10,000 years.
12108 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12109 # Durations less than one second are represented with a 0
12110 # `seconds` field and a positive `nanos` field. Must be from 0
12111 # to 999,999,999 inclusive.
12112 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12113 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12114 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12115 },
12116 &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
12117 # to the matched service.
12118 #
12119 # urlRewrite is the only action supported in UrlMaps
12120 # for classic Application Load Balancers.
12121 #
12122 # Not supported when the URL map is bound to a target gRPC proxy that
12123 # has the validateForProxyless field set to true.
12124 # backend service.
12125 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
12126 # host header is replaced with contents of hostRewrite.
12127 #
12128 # The value must be from 1 to 255 characters.
12129 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
12130 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
12131 #
12132 # The value must be from 1 to 1024 characters.
12133 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
12134 # header) using the HTTP template syntax.
12135 #
12136 # A corresponding
12137 # path_template_match must be specified. Any template variables must exist in
12138 # the path_template_match field.
12139 #
12140 #
12141 # - -At least one variable must be specified in the path_template_match
12142 # field
12143 # - You can omit variables from the rewritten URL
12144 # - The * and ** operators cannot be matched
12145 # unless they have a corresponding variable name - e.g.
12146 # {format=*} or {var=**}.
12147 #
12148 # For example, a path_template_match of /static/{format=**}
12149 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
12150 # rewrite, so that /{country}/{format}/{suffix=**} can be
12151 # rewritten as /content/{format}/{country}/{suffix}.
12152 #
12153 # At least
12154 # one non-empty routeRules[].matchRules[].path_template_match is
12155 # required.
12156 #
12157 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
12158 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
12159 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
12160 # It uses RE2 syntax with the following constraints:
12161 #
12162 #
12163 # - Any single character operators
12164 # - Groups are allowed to have only submatch operator inside
12165 # - Groups are allowed only without any char repetition, e.g.
12166 # .*
12167 # - Any char repetition, e.g. .*, is
12168 # only allowed to be used in a single regex together with:
12169 #
12170 #
12171 # - Empty string operators
12172 # - Other repetitions
12173 # - Ranges
12174 # - Repetitions of ranges
12175 #
12176 #
12177 # - Ranges are only allowed to have:
12178 #
12179 #
12180 # - Character range
12181 # - Digits range
12182 # - Symbols listed in characters allowed for ranges
12183 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
12184 # the path.
12185 },
12186 },
12187 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
12188 # occurs. The weights determine the fraction of traffic that flows to
12189 # their corresponding backend service. If all traffic needs to
12190 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
12191 #
12192 # After a backend service is identified and before forwarding
12193 # the request to
12194 # the backend service, advanced routing actions such as URL rewrites and
12195 # header transformations are applied depending on additional settings
12196 # specified in this HttpRouteAction.
12197 { # In contrast to a single BackendService in
12198 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
12199 # multiple backend services. The volume of traffic for each
12200 # backend service is proportional to the weight specified
12201 # in each WeightedBackendService
12202 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
12203 # resource. Before
12204 # forwarding the request to backendService, the load balancer
12205 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
12206 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
12207 # effect for the selected backendService.
12208 #
12209 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
12210 #
12211 # headerAction is not supported for load balancers that have
12212 # their loadBalancingScheme set to EXTERNAL.
12213 #
12214 # Not supported when the URL map is bound to a target gRPC proxy that
12215 # has validateForProxyless field set to true.
12216 # the request is passed along to the selected backendService.
12217 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
12218 { # Specification determining how headers are added to requests or responses.
12219 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
12220 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
12221 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
12222 # that already
12223 # exist for the header. If true, headerValue is set for the
12224 # header, discarding any values that were set for that header.
12225 #
12226 # The default value is true,
12227 # unless a variable is present in headerValue,
12228 # in which case the default value is false.
12229 # .
12230 },
12231 ],
12232 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
12233 # request before forwarding the request to the backendService.
12234 &quot;A String&quot;,
12235 ],
12236 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
12237 # client.
12238 { # Specification determining how headers are added to requests or responses.
12239 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
12240 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
12241 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
12242 # that already
12243 # exist for the header. If true, headerValue is set for the
12244 # header, discarding any values that were set for that header.
12245 #
12246 # The default value is true,
12247 # unless a variable is present in headerValue,
12248 # in which case the default value is false.
12249 # .
12250 },
12251 ],
12252 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
12253 # response before sending the response back to the client.
12254 &quot;A String&quot;,
12255 ],
12256 },
12257 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
12258 # computed asweight / (sum of all weightedBackendService weights in routeAction).
12259 #
12260 # The selection of a backend service is determined only for new traffic.
12261 # Once a user&#x27;s request has been directed to a backend service,
12262 # subsequent requests are sent to the same backend service as
12263 # determined by the backend service&#x27;s session affinity policy.
12264 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
12265 # splitting. If you do, the weighted traffic splitting configuration takes
12266 # precedence.
12267 #
12268 # The value must be from 0 to 1000.
12269 },
12270 ],
12271 },
12272 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
12273 # is directed if this rule is matched. If routeAction is
12274 # also specified, advanced routing actions, such as URL rewrites,
12275 # take effect before sending the request to the backend.
12276 #
12277 #
12278 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
12279 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
12280 # specified by urlRedirect.
12281 #
12282 #
12283 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
12284 #
12285 #
12286 # Not supported when the URL map is bound to a target gRPC proxy.
12287 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
12288 # was supplied in the request.
12289 #
12290 # The value must be from 1 to 255
12291 # characters.
12292 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
12293 # set to HTTPS.
12294 # If set to false, the URL scheme of the redirected request
12295 # remains the same as that of the request.
12296 #
12297 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
12298 #
12299 # The default is set to false.
12300 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
12301 # that was supplied in the request.
12302 #
12303 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
12304 # supplied, the path of the original request is used for the redirect.
12305 #
12306 # The value must be from 1 to 1024 characters.
12307 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
12308 # the HttpRouteRuleMatch, retaining the remaining portion
12309 # of the URL before redirecting the request.
12310 #
12311 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
12312 # supplied, the path of the original request is used for the redirect.
12313 #
12314 # The value must be from 1 to 1024 characters.
12315 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
12316 #
12317 # Supported values are:
12318 #
12319 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
12320 # to 301.
12321 # - FOUND, which corresponds to 302.
12322 # - SEE_OTHER which corresponds to 303.
12323 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
12324 # method is retained.
12325 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
12326 # method is retained.
12327 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
12328 # URL is
12329 # removed before redirecting the request. If set to false, the
12330 # query portion of the original URL is retained.
12331 #
12332 # The default is set to false.
12333 },
12334 },
12335 ],
12336 },
12337 ],
12338 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the regional URL map resides.
12339 # This field is not applicable to global URL maps.
12340 # You must specify this field as part of the HTTP request URL. It is
12341 # not settable as a field in the request body.
12342 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
12343 &quot;status&quot;: { # [Output Only] The status of the URL map. # Output only. [Output Only] The status of the URL map.
12344 &quot;quotaUsage&quot;: { # Message representing the quota usage for a UrlMap. # Output only. Summary of quota usage for given UrlMap.
12345 &quot;forwardingRules&quot;: 42, # Output only. The number of forwarding rules that uses this UrlMap.
12346 &quot;units&quot;: &quot;A String&quot;, # Output only. The number of quota units calculated for this UrlMap.
12347 },
12348 },
12349 &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
12350 # maximum of 100 tests per UrlMap.
12351 #
12352 # Not supported when the URL map is bound to a target gRPC proxy that
12353 # has validateForProxyless field set to true.
12354 { # Message for the expected URL mappings.
12355 &quot;backendServiceWeight&quot;: 42, # The weight to use for the supplied host and path when using advanced
12356 # routing rules that involve traffic splitting.
12357 &quot;description&quot;: &quot;A String&quot;, # Description of this test case.
12358 &quot;expectedOutputUrl&quot;: &quot;A String&quot;, # The expected output URL evaluated by the load balancer
12359 # containing the scheme, host, path and query parameters.
12360 #
12361 # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
12362 # the load balancer to backends. For rules with urlRewrite,
12363 # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
12364 #
12365 # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer&#x27;s
12366 # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
12367 # If urlRedirect specifies strip_query, the test
12368 # passes only if expectedOutputUrl does not contain any query
12369 # parameters.
12370 #
12371 # expectedOutputUrl is optional whenservice is specified.
12372 &quot;expectedRedirectResponseCode&quot;: 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
12373 # load balancer&#x27;s redirect response.
12374 #
12375 # expectedRedirectResponseCode cannot be set whenservice is set.
12376 &quot;expectedUrlRedirect&quot;: &quot;A String&quot;, # The expected URL that should be redirected to for the host and path
12377 # being tested.
12378 # [Deprecated] This field is deprecated.
12379 # Use expected_output_url instead.
12380 &quot;headers&quot;: [ # HTTP headers for this request. If headers contains
12381 # a host header, then host must also match the header value.
12382 { # HTTP headers used in UrlMapTests.
12383 &quot;name&quot;: &quot;A String&quot;, # Header name.
12384 &quot;value&quot;: &quot;A String&quot;, # Header value.
12385 },
12386 ],
12387 &quot;host&quot;: &quot;A String&quot;, # Host portion of the URL. If headers contains a host header,
12388 # then host must also match the header value.
12389 &quot;path&quot;: &quot;A String&quot;, # Path portion of the URL.
12390 &quot;service&quot;: &quot;A String&quot;, # Expected BackendService or BackendBucket resource
12391 # the given URL should be mapped to.
12392 #
12393 # The service field cannot
12394 # be set if expectedRedirectResponseCode is set.
12395 },
12396 ],
12397 },
12398 ],
12399 &quot;kind&quot;: &quot;compute#urlMapList&quot;, # Output only. Type of resource.
12400 &quot;nextPageToken&quot;: &quot;A String&quot;, # [Output Only] This token allows you to get the next page of results for
12401 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
12402 # the query parameter pageToken in the next list request.
12403 # Subsequent list requests will have their own nextPageToken to
12404 # continue paging through the results.
12405 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource.
12406 &quot;warning&quot;: { # [Output Only] Informational warning message.
12407 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
12408 # Engine returns NO_RESULTS_ON_PAGE if there
12409 # are no results in the response.
12410 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
12411 # value format. For example:
12412 #
12413 # &quot;data&quot;: [
12414 # {
12415 # &quot;key&quot;: &quot;scope&quot;,
12416 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
12417 # }
12418 {
12419 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
12420 # returned. For example, for warnings where there are no results in a list
12421 # request for a particular zone, this key might be scope and
12422 # the key value might be the zone name. Other examples might be a key
12423 # indicating a deprecated resource and a suggested replacement, or a
12424 # warning about invalid network settings (for example, if an instance
12425 # attempts to perform IP forwarding but is not enabled for IP forwarding).
12426 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
12427 },
12428 ],
12429 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
12430 },
12431 }</pre>
12432 </div>
12433
12434 <div class="method">
12435 <code class="details" id="list_next">list_next()</code>
12436 <pre>Retrieves the next page of results.
12437
12438 Args:
12439 previous_request: The request for the previous page. (required)
12440 previous_response: The response from the request for the previous page. (required)
12441
12442 Returns:
12443 A request object that you can call &#x27;execute()&#x27; on to request the next
12444 page. Returns None if there are no more items in the collection.
12445 </pre>
12446 </div>
12447
12448 <div class="method">
12449 <code class="details" id="patch">patch(project, region, urlMap, body=None, requestId=None, x__xgafv=None)</code>
12450 <pre>Patches the specified UrlMap resource with the data included in the
12451 request. This method supportsPATCH
12452 semantics and usesJSON merge
12453 patch format and processing rules.
12454
12455 Args:
12456 project: string, Project ID for this request. (required)
12457 region: string, Name of the region scoping this request. (required)
12458 urlMap: string, Name of the UrlMap resource to patch. (required)
12459 body: object, The request body.
12460 The object takes the form of:
12461
12462 { # Represents a URL Map resource.
12463 #
12464 # Compute Engine has two URL Map resources:
12465 #
12466 # * [Global](/compute/docs/reference/rest/alpha/urlMaps)
12467 # * [Regional](/compute/docs/reference/rest/alpha/regionUrlMaps)
12468 #
12469 # A URL map resource is a component of certain types of cloud load balancers
12470 # and Traffic Director:
12471 #
12472 # * urlMaps are used by global external Application Load
12473 # Balancers, classic Application Load Balancers, and cross-region internal
12474 # Application Load Balancers.
12475 # * regionUrlMaps are used by internal Application Load Balancers,
12476 # regional external Application Load Balancers and regional internal
12477 # Application Load Balancers.
12478 #
12479 # For a list of supported URL map features by the load balancer type, see the
12480 # Load balancing features: Routing and traffic management table.
12481 #
12482 # For a list of supported URL map features for Traffic Director, see the
12483 # Traffic Director features: Routing and traffic management table.
12484 #
12485 # This resource defines mappings from hostnames and URL paths to either a
12486 # backend service or a backend bucket.
12487 #
12488 # To use the global urlMaps resource, the backend service must
12489 # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
12490 # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
12491 # information, read URL
12492 # Map Concepts.
12493 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
12494 # text format.
12495 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
12496 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
12497 #
12498 # This policy takes
12499 # effect at the load balancer level and applies only when no policy has been
12500 # defined for the error code at lower levels like PathMatcher, RouteRule and
12501 # PathRule within this UrlMap.
12502 #
12503 # For example, consider a UrlMap with the
12504 # following configuration:
12505 #
12506 #
12507 # - defaultCustomErrorResponsePolicy containing policies for
12508 # responding to 5xx and 4xx errors
12509 # - A PathMatcher configured for *.example.com has
12510 # defaultCustomErrorResponsePolicy for 4xx.
12511 #
12512 # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
12513 # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
12514 # a request that does not match any host in *.example.com such
12515 # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
12516 # takes effect.
12517 #
12518 # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
12519 # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
12520 # a retry, if load balancer is successful in reaching the
12521 # service, the defaultCustomErrorResponsePolicy is ignored and
12522 # the response from the service is returned to the client.
12523 #
12524 # defaultCustomErrorResponsePolicy is supported only for
12525 # global external Application Load Balancers.
12526 # backend service or backend bucket responds with an error.
12527 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
12528 #
12529 # In a given policy, if you specify rules for both a range of error codes
12530 # as well as rules for specific error codes then rules with specific error
12531 # codes have a higher priority. For example, assume that you configure a rule
12532 # for 401 (Un-authorized) code, and another for all 4 series
12533 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
12534 # However if the backend service returns a 403, the rule for4xx takes effect.
12535 { # Specifies the mapping between the response code that will be returned along
12536 # with the custom error content and the response code returned by the backend
12537 # service.
12538 &quot;matchResponseCodes&quot;: [ # Valid values include:
12539 #
12540 #
12541 # - A number between 400 and 599: For example
12542 # 401 or 503, in which case the load balancer
12543 # applies the policy if the error code exactly matches this value.
12544 # - 5xx: Load Balancer will apply the policy if the
12545 # backend service responds with any response code in the range of
12546 # 500 to 599.
12547 # - 4xx: Load
12548 # Balancer will apply the policy if the backend service responds with any
12549 # response code in the range of 400 to
12550 # 499.
12551 #
12552 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
12553 &quot;A String&quot;,
12554 ],
12555 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
12556 # error content. If overrideResponseCode is not supplied, the
12557 # same response code returned by the original backend bucket or backend
12558 # service is returned to the client.
12559 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
12560 #
12561 # path must start
12562 # with a leading slash. path cannot have trailing slashes.
12563 #
12564 # If the file is not available in backendBucket or the
12565 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
12566 #
12567 # The value must
12568 # be from 1 to 1024 characters
12569 },
12570 ],
12571 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
12572 # contains the custom error content. Examples are:
12573 #
12574 #
12575 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
12576 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
12577 # - global/backendBuckets/myBackendBucket
12578 #
12579 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
12580 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
12581 #
12582 # If load balancer cannot reach
12583 # the backendBucket, a simple Not Found Error will
12584 # be returned, with the original response code (oroverrideResponseCode if configured).
12585 #
12586 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
12587 },
12588 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
12589 # hostRules match. The load balancer performs advanced routing
12590 # actions, such as URL rewrites and header transformations, before forwarding
12591 # the request to the selected backend.
12592 #
12593 #
12594 # Only one of defaultUrlRedirect, defaultService
12595 # or defaultRouteAction.weightedBackendService can be set.
12596 #
12597 #
12598 # URL maps for classic Application Load Balancers only support
12599 # the urlRewrite action within defaultRouteAction.
12600 #
12601 #
12602 # defaultRouteAction has no effect when the URL map is bound
12603 # to a target gRPC proxy that has the validateForProxyless field
12604 # set to true.
12605 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
12606 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
12607 # property must be specified. This policy cannot be specified if any target
12608 # backend has Identity-Aware Proxy enabled.
12609 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
12610 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
12611 # header names can be specified. The cache is bypassed for all `cacheMode`
12612 # values.
12613 &quot;A String&quot;,
12614 ],
12615 &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
12616 # on the backend type: for Backend Services, the complete request URI is
12617 # used; for Backend Buckets, the request URI is used without the protocol or
12618 # host, and only query parameters known to Cloud Storage are included.
12619 # Policy defined on Route Action.
12620 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
12621 # parameters will be included. Either specify `excludedQueryParameters`
12622 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
12623 # encoded and not treated as delimiters.
12624 #
12625 # Note: This field applies to routes that use backend services. Attempting
12626 # to set it on a route that points exclusively to Backend Buckets will
12627 # result in a configuration error. For routes that point to a Backend
12628 # Bucket, use `includedQueryParameters` to define which parameters should
12629 # be part of the cache key.
12630 &quot;A String&quot;,
12631 ],
12632 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
12633 #
12634 # Note: This setting is only applicable to routes that use a Backend
12635 # Service. It does not affect requests served by a Backend Bucket, as the
12636 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
12637 # it on a route that points exclusively to Backend Buckets will result in a
12638 # configuration error.
12639 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
12640 #
12641 # Note: This setting is only applicable to routes that use a Backend
12642 # Service. It does not affect requests served by a Backend Bucket, as the
12643 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
12644 # set on a route that points exclusively to Backend Buckets will result in
12645 # a configuration error.
12646 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
12647 # `includedQueryParameters` and `excludedQueryParameters`. If neither
12648 # is set, the entire query string will be included. If false, the query
12649 # string will be excluded from the cache key entirely.
12650 #
12651 # Note: This field applies to routes that use backend services. Attempting
12652 # to set it on a route that points exclusively to Backend Buckets will
12653 # result in a configuration error. For routes that point to a Backend
12654 # Bucket, use `includedQueryParameters` to define which parameters should
12655 # be part of the cache key.
12656 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
12657 # The name=value pair will be used in the cache key Cloud CDN generates.
12658 #
12659 # Note: This setting is only applicable to routes that use a Backend
12660 # Service. It does not affect requests served by a Backend Bucket.
12661 # Attempting to set it on a route that points exclusively to Backend
12662 # Buckets will result in a configuration error. Up to 5 cookie names can be
12663 # specified.
12664 &quot;A String&quot;,
12665 ],
12666 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
12667 &quot;A String&quot;,
12668 ],
12669 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
12670 # parameters will be excluded. Either specify `includedQueryParameters`
12671 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
12672 # encoded and not treated as delimiters.
12673 &quot;A String&quot;,
12674 ],
12675 },
12676 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
12677 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
12678 &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
12679 # content. This is used to clamp the max-age (or Expires) value sent to the
12680 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
12681 # is used for the response max-age directive, along with a &quot;public&quot;
12682 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
12683 # clamps the max-age from the origin (if specified), or else sets the
12684 # response max-age directive to the lesser of the `clientTtl` and
12685 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
12686 # present. The maximum allowed value is 31,622,400s (1 year). If not
12687 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
12688 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
12689 # `USE_ORIGIN_HEADERS`.
12690 # as a count of seconds and fractions of seconds at nanosecond
12691 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12692 # or &quot;month&quot;. Range is approximately 10,000 years.
12693 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12694 # Durations less than one second are represented with a 0
12695 # `seconds` field and a positive `nanos` field. Must be from 0
12696 # to 999,999,999 inclusive.
12697 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12698 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12699 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12700 },
12701 &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
12702 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
12703 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
12704 # greater than that of `maxTtl`. When the `cacheMode` is set to
12705 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
12706 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
12707 # accessed objects may be evicted from the cache before the defined TTL. If
12708 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
12709 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
12710 # `USE_ORIGIN_HEADERS`.
12711 # as a count of seconds and fractions of seconds at nanosecond
12712 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12713 # or &quot;month&quot;. Range is approximately 10,000 years.
12714 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12715 # Durations less than one second are represented with a 0
12716 # `seconds` field and a positive `nanos` field. Must be from 0
12717 # to 999,999,999 inclusive.
12718 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12719 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12720 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12721 },
12722 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
12723 # attempt to set a max-age or s-maxage higher than this, or an Expires header
12724 # more than `maxTtl` seconds in the future will be capped at the value of
12725 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
12726 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
12727 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
12728 # Infrequently accessed objects may be evicted from the cache before the
12729 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
12730 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
12731 # mode.
12732 # as a count of seconds and fractions of seconds at nanosecond
12733 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12734 # or &quot;month&quot;. Range is approximately 10,000 years.
12735 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12736 # Durations less than one second are represented with a 0
12737 # `seconds` field and a positive `nanos` field. Must be from 0
12738 # to 999,999,999 inclusive.
12739 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12740 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12741 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12742 },
12743 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
12744 # to apply fine-grained caching for common errors or redirects.
12745 # This can reduce the load on your origin and improve end-user
12746 # experience by reducing response latency.
12747 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
12748 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
12749 # the specified response code that lack any Cache-Control, Expires, or
12750 # Pragma: no-cache directives. When the `cacheMode` is set to
12751 # `FORCE_CACHE_ALL`, negative caching applies to all responses
12752 # with the specified response code, and overrides any caching headers. By
12753 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
12754 #
12755 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
12756 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
12757 # * 405 (Method Not Found), 501 (Not Implemented): 60s
12758 #
12759 # These defaults can be overridden in `negativeCachingPolicy`.
12760 # If not specified, Cloud CDN applies negative caching by default.
12761 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
12762 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
12763 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
12764 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
12765 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
12766 # all response codes that you wish to cache. Cloud CDN will not apply any
12767 # default negative caching when a policy exists.
12768 { # Specify CDN TTLs for response error codes.
12769 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
12770 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
12771 # specified as values, and you cannot specify a status code more than
12772 # once.
12773 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
12774 # corresponding status code.
12775 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
12776 # objects may be evicted from the cache before the defined TTL.
12777 # as a count of seconds and fractions of seconds at nanosecond
12778 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12779 # or &quot;month&quot;. Range is approximately 10,000 years.
12780 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12781 # Durations less than one second are represented with a 0
12782 # `seconds` field and a positive `nanos` field. Must be from 0
12783 # to 999,999,999 inclusive.
12784 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12785 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12786 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12787 },
12788 },
12789 ],
12790 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
12791 # requests into a small number of requests to the origin. If not specified,
12792 # Cloud CDN applies request coalescing by default.
12793 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
12794 # content with the origin, or when an error is encountered when refreshing
12795 # the cache.
12796 # This setting defines the default &quot;max-stale&quot; duration for any cached
12797 # responses that do not specify a max-stale directive. Stale responses that
12798 # exceed the TTL configured here will not be served. The default limit
12799 # (max-stale) is 86400s (1 day), which will allow stale content to be
12800 # served up to this limit beyond the max-age (or s-maxage) of a cached
12801 # response.
12802 # The maximum allowed value is 604800 (1 week).
12803 # Set this to zero (0) to disable serve-while-stale.
12804 # as a count of seconds and fractions of seconds at nanosecond
12805 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12806 # or &quot;month&quot;. Range is approximately 10,000 years.
12807 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12808 # Durations less than one second are represented with a 0
12809 # `seconds` field and a positive `nanos` field. Must be from 0
12810 # to 999,999,999 inclusive.
12811 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12812 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12813 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12814 },
12815 },
12816 &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
12817 # information about the W3C recommendation for cross-origin resource sharing
12818 # (CORS), see Fetch API Living
12819 # Standard.
12820 #
12821 # Not supported when the URL map is bound to a target gRPC proxy.
12822 # information about the W3C recommendation for cross-origin resource sharing
12823 # (CORS), see Fetch API Living
12824 # Standard.
12825 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
12826 # indicates that
12827 # the actual request can include user credentials. This field translates to
12828 # the Access-Control-Allow-Credentials header.
12829 #
12830 # Default is false.
12831 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
12832 # header.
12833 &quot;A String&quot;,
12834 ],
12835 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
12836 # header.
12837 &quot;A String&quot;,
12838 ],
12839 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
12840 # more information, see regular expression syntax.
12841 #
12842 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
12843 #
12844 # Regular expressions can only be used when the loadBalancingScheme is
12845 # set to INTERNAL_SELF_MANAGED.
12846 &quot;A String&quot;,
12847 ],
12848 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
12849 #
12850 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
12851 &quot;A String&quot;,
12852 ],
12853 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
12854 # The default value is false, which indicates that the CORS
12855 # policy is in effect.
12856 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
12857 # header.
12858 &quot;A String&quot;,
12859 ],
12860 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
12861 # seconds. This field translates to the Access-Control-Max-Age
12862 # header.
12863 },
12864 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
12865 # the resiliency of clients to backend service failure. As part of fault
12866 # injection, when clients send requests to a backend service, delays can be
12867 # introduced by a load balancer on a percentage of requests before sending
12868 # those requests to the backend service. Similarly requests from clients can
12869 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
12870 # that are configured with a fault_injection_policy if:
12871 # 1. The traffic is generated by fault injection AND
12872 # 2. The fault injection is not a delay fault injection.
12873 # Fault injection is not supported with the classic Application Load Balancer
12874 # . To see which load balancers support fault injection,
12875 # see Load
12876 # balancing: Routing and traffic management features.
12877 # the resiliency of clients to backend service failure. As part of fault
12878 # injection, when clients send requests to a backend service, delays can be
12879 # introduced by the load balancer on a percentage of requests before sending
12880 # those request to the backend service. Similarly requests from clients can be
12881 # aborted by the load balancer for a percentage of requests.
12882 &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
12883 # injection.
12884 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
12885 #
12886 # The value must be from 200 to 599 inclusive.
12887 #
12888 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
12889 # according to this
12890 # mapping table. HTTP status 200 is mapped to gRPC status
12891 # UNKNOWN. Injecting an OK status is currently not supported by
12892 # Traffic Director.
12893 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
12894 # that is aborted as part of fault injection.
12895 #
12896 # The value must be from 0.0 to 100.0 inclusive.
12897 },
12898 &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
12899 # injection, before being sent to a backend service.
12900 # request to the backend service as part of fault injection.
12901 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
12902 # as a count of seconds and fractions of seconds at nanosecond
12903 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12904 # or &quot;month&quot;. Range is approximately 10,000 years.
12905 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12906 # Durations less than one second are represented with a 0
12907 # `seconds` field and a positive `nanos` field. Must be from 0
12908 # to 999,999,999 inclusive.
12909 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12910 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12911 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12912 },
12913 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
12914 # which a delay is introduced as part of fault injection.
12915 #
12916 # The value must be from 0.0 to 100.0 inclusive.
12917 },
12918 },
12919 &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
12920 # Global EXTERNAL_MANAGED load balancer schemes.
12921 # Either Cloud CDN must be enabled on the backend service or backend bucket
12922 # serving the route, or cache policy must be configured on the same route
12923 # dynamically processes and delivers images from the network edge.
12924 # Image Optimization is only available for Global External Application Load
12925 # Balancers.
12926 # Either Cloud CDN must be enabled on the backend service or backend bucket
12927 # serving the route, or cache policy must be configured on the same route.
12928 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
12929 },
12930 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
12931 # Unlike the timeout field where the timeout duration starts
12932 # from the time the request has been fully processed (known as*end-of-stream*),
12933 # the duration in this field is computed from the beginning of the stream
12934 # until the response has been processed, including all retries. A
12935 # stream that does not complete in this duration is closed.
12936 #
12937 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
12938 # with the route.
12939 #
12940 # This field is only allowed if the Url map is used with backend services
12941 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
12942 # as a count of seconds and fractions of seconds at nanosecond
12943 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12944 # or &quot;month&quot;. Range is approximately 10,000 years.
12945 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12946 # Durations less than one second are represented with a 0
12947 # `seconds` field and a positive `nanos` field. Must be from 0
12948 # to 999,999,999 inclusive.
12949 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12950 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12951 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12952 },
12953 &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
12954 # are shadowed to a separate mirrored backend service. The load balancer does
12955 # not wait for responses from the shadow service. Before sending traffic
12956 # to the shadow service, the host / authority header is suffixed with-shadow.
12957 #
12958 # Not supported when the URL map is bound to a target gRPC proxy that
12959 # has the validateForProxyless field set to true.
12960 # are shadowed to a separate mirrored backend service. The load balancer
12961 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
12962 # to the shadow service, the host or authority header is suffixed with-shadow.
12963 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
12964 # mirrored to.
12965 #
12966 # The backend service configured for a mirroring
12967 # policy must reference backends that are of the same type as the original
12968 # backend service matched in the URL map.
12969 #
12970 # Serverless NEG backends are not currently supported as a mirrored
12971 # backend service.
12972 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
12973 },
12974 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
12975 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
12976 # If not specified, defaults to 1.
12977 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
12978 #
12979 # If not specified, will use the timeout set in theHttpRouteAction field.
12980 # If timeout in the HttpRouteAction field is not set, this field
12981 # uses the largest timeout
12982 # among all backend services associated with the route.
12983 #
12984 # Not supported when the URL map is bound to a target gRPC proxy that
12985 # has the validateForProxyless field set to true.
12986 # as a count of seconds and fractions of seconds at nanosecond
12987 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12988 # or &quot;month&quot;. Range is approximately 10,000 years.
12989 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12990 # Durations less than one second are represented with a 0
12991 # `seconds` field and a positive `nanos` field. Must be from 0
12992 # to 999,999,999 inclusive.
12993 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12994 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12995 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12996 },
12997 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
12998 # values are:
12999 #
13000 # - 5xx: retry is attempted if the instance or endpoint
13001 # responds with any 5xx response code, or if the instance or
13002 # endpoint does not respond at all. For example, disconnects, reset, read
13003 # timeout, connection failure, and refused streams.
13004 # - gateway-error: Similar to 5xx, but only
13005 # applies to response codes 502, 503 or504.
13006 # - connect-failure: a retry is attempted on failures
13007 # connecting to the instance or endpoint. For example, connection
13008 # timeouts.
13009 # - retriable-4xx: a retry is attempted if the instance
13010 # or endpoint responds with a 4xx response code.
13011 # The only error that you can retry is error code 409.
13012 # - refused-stream: a retry is attempted if the instance
13013 # or endpoint resets the stream with a REFUSED_STREAM error
13014 # code. This reset type indicates that it is safe to retry.
13015 # - cancelled: a retry is attempted if the gRPC status
13016 # code in the response header is set to cancelled.
13017 # - deadline-exceeded: a retry is attempted if the gRPC
13018 # status code in the response header is set todeadline-exceeded.
13019 # - internal: a retry is attempted if the gRPC
13020 # status code in the response header is set tointernal.
13021 # - resource-exhausted: a retry is attempted if the gRPC
13022 # status code in the response header is set toresource-exhausted.
13023 # - unavailable: a retry is attempted if the gRPC
13024 # status code in the response header is set tounavailable.
13025 #
13026 # Only the following codes are supported when the URL map is bound to
13027 # target gRPC proxy that has validateForProxyless field set to true.
13028 #
13029 # - cancelled
13030 # - deadline-exceeded
13031 # - internal
13032 # - resource-exhausted
13033 # - unavailable
13034 &quot;A String&quot;,
13035 ],
13036 },
13037 &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
13038 # time the request has been fully processed (known as *end-of-stream*)
13039 # up until the response has been processed. Timeout includes
13040 # all retries.
13041 #
13042 # If not specified, this field uses the largest timeout among all backend
13043 # services associated with the route.
13044 #
13045 # Not supported when the URL map is bound to a target gRPC proxy that
13046 # has validateForProxyless field set to true.
13047 # as a count of seconds and fractions of seconds at nanosecond
13048 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13049 # or &quot;month&quot;. Range is approximately 10,000 years.
13050 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13051 # Durations less than one second are represented with a 0
13052 # `seconds` field and a positive `nanos` field. Must be from 0
13053 # to 999,999,999 inclusive.
13054 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13055 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13056 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13057 },
13058 &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
13059 # to the matched service.
13060 #
13061 # urlRewrite is the only action supported in UrlMaps
13062 # for classic Application Load Balancers.
13063 #
13064 # Not supported when the URL map is bound to a target gRPC proxy that
13065 # has the validateForProxyless field set to true.
13066 # backend service.
13067 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
13068 # host header is replaced with contents of hostRewrite.
13069 #
13070 # The value must be from 1 to 255 characters.
13071 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
13072 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
13073 #
13074 # The value must be from 1 to 1024 characters.
13075 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
13076 # header) using the HTTP template syntax.
13077 #
13078 # A corresponding
13079 # path_template_match must be specified. Any template variables must exist in
13080 # the path_template_match field.
13081 #
13082 #
13083 # - -At least one variable must be specified in the path_template_match
13084 # field
13085 # - You can omit variables from the rewritten URL
13086 # - The * and ** operators cannot be matched
13087 # unless they have a corresponding variable name - e.g.
13088 # {format=*} or {var=**}.
13089 #
13090 # For example, a path_template_match of /static/{format=**}
13091 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
13092 # rewrite, so that /{country}/{format}/{suffix=**} can be
13093 # rewritten as /content/{format}/{country}/{suffix}.
13094 #
13095 # At least
13096 # one non-empty routeRules[].matchRules[].path_template_match is
13097 # required.
13098 #
13099 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
13100 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
13101 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
13102 # It uses RE2 syntax with the following constraints:
13103 #
13104 #
13105 # - Any single character operators
13106 # - Groups are allowed to have only submatch operator inside
13107 # - Groups are allowed only without any char repetition, e.g.
13108 # .*
13109 # - Any char repetition, e.g. .*, is
13110 # only allowed to be used in a single regex together with:
13111 #
13112 #
13113 # - Empty string operators
13114 # - Other repetitions
13115 # - Ranges
13116 # - Repetitions of ranges
13117 #
13118 #
13119 # - Ranges are only allowed to have:
13120 #
13121 #
13122 # - Character range
13123 # - Digits range
13124 # - Symbols listed in characters allowed for ranges
13125 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
13126 # the path.
13127 },
13128 },
13129 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
13130 # occurs. The weights determine the fraction of traffic that flows to
13131 # their corresponding backend service. If all traffic needs to
13132 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
13133 #
13134 # After a backend service is identified and before forwarding
13135 # the request to
13136 # the backend service, advanced routing actions such as URL rewrites and
13137 # header transformations are applied depending on additional settings
13138 # specified in this HttpRouteAction.
13139 { # In contrast to a single BackendService in
13140 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
13141 # multiple backend services. The volume of traffic for each
13142 # backend service is proportional to the weight specified
13143 # in each WeightedBackendService
13144 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
13145 # resource. Before
13146 # forwarding the request to backendService, the load balancer
13147 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
13148 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
13149 # effect for the selected backendService.
13150 #
13151 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
13152 #
13153 # headerAction is not supported for load balancers that have
13154 # their loadBalancingScheme set to EXTERNAL.
13155 #
13156 # Not supported when the URL map is bound to a target gRPC proxy that
13157 # has validateForProxyless field set to true.
13158 # the request is passed along to the selected backendService.
13159 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
13160 { # Specification determining how headers are added to requests or responses.
13161 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
13162 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
13163 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
13164 # that already
13165 # exist for the header. If true, headerValue is set for the
13166 # header, discarding any values that were set for that header.
13167 #
13168 # The default value is true,
13169 # unless a variable is present in headerValue,
13170 # in which case the default value is false.
13171 # .
13172 },
13173 ],
13174 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
13175 # request before forwarding the request to the backendService.
13176 &quot;A String&quot;,
13177 ],
13178 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
13179 # client.
13180 { # Specification determining how headers are added to requests or responses.
13181 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
13182 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
13183 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
13184 # that already
13185 # exist for the header. If true, headerValue is set for the
13186 # header, discarding any values that were set for that header.
13187 #
13188 # The default value is true,
13189 # unless a variable is present in headerValue,
13190 # in which case the default value is false.
13191 # .
13192 },
13193 ],
13194 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
13195 # response before sending the response back to the client.
13196 &quot;A String&quot;,
13197 ],
13198 },
13199 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
13200 # computed asweight / (sum of all weightedBackendService weights in routeAction).
13201 #
13202 # The selection of a backend service is determined only for new traffic.
13203 # Once a user&#x27;s request has been directed to a backend service,
13204 # subsequent requests are sent to the same backend service as
13205 # determined by the backend service&#x27;s session affinity policy.
13206 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
13207 # splitting. If you do, the weighted traffic splitting configuration takes
13208 # precedence.
13209 #
13210 # The value must be from 0 to 1000.
13211 },
13212 ],
13213 },
13214 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL of the defaultService resource to
13215 # which traffic is directed if none of the hostRules match.
13216 # If defaultRouteAction is also specified, advanced
13217 # routing actions, such as URL rewrites, take effect before sending the
13218 # request to the backend.
13219 #
13220 #
13221 # Only one of defaultUrlRedirect, defaultService
13222 # or defaultRouteAction.weightedBackendService can be set.
13223 #
13224 #
13225 # defaultService has no effect when the URL map is bound
13226 # to a target gRPC proxy that has the validateForProxyless field
13227 # set to true.
13228 &quot;defaultUrlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
13229 # is redirected to a URL specified by defaultUrlRedirect.
13230 #
13231 #
13232 # Only one of defaultUrlRedirect, defaultService
13233 # or defaultRouteAction.weightedBackendService can be set.
13234 #
13235 #
13236 # Not supported when the URL map is bound to a target gRPC proxy.
13237 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
13238 # was supplied in the request.
13239 #
13240 # The value must be from 1 to 255
13241 # characters.
13242 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
13243 # set to HTTPS.
13244 # If set to false, the URL scheme of the redirected request
13245 # remains the same as that of the request.
13246 #
13247 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
13248 #
13249 # The default is set to false.
13250 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
13251 # that was supplied in the request.
13252 #
13253 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
13254 # supplied, the path of the original request is used for the redirect.
13255 #
13256 # The value must be from 1 to 1024 characters.
13257 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
13258 # the HttpRouteRuleMatch, retaining the remaining portion
13259 # of the URL before redirecting the request.
13260 #
13261 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
13262 # supplied, the path of the original request is used for the redirect.
13263 #
13264 # The value must be from 1 to 1024 characters.
13265 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
13266 #
13267 # Supported values are:
13268 #
13269 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
13270 # to 301.
13271 # - FOUND, which corresponds to 302.
13272 # - SEE_OTHER which corresponds to 303.
13273 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
13274 # method is retained.
13275 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
13276 # method is retained.
13277 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
13278 # URL is
13279 # removed before redirecting the request. If set to false, the
13280 # query portion of the original URL is retained.
13281 #
13282 # The default is set to false.
13283 },
13284 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
13285 # create the resource.
13286 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. A hash of the contents stored in this object.
13287 # This field is used in optimistic locking. This field is ignored when
13288 # inserting a UrlMap. An up-to-date fingerprint must be provided
13289 # in order to update the UrlMap, otherwise the request will
13290 # fail with error 412 conditionNotMet.
13291 #
13292 # To see the latest fingerprint, make a get() request to
13293 # retrieve a UrlMap.
13294 &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
13295 # for the selected backendService.
13296 #
13297 # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
13298 #
13299 # headerAction is not supported for load balancers
13300 # that have
13301 # their loadBalancingScheme set to EXTERNAL.
13302 #
13303 # Not supported when the URL map is bound to a target gRPC proxy that
13304 # has validateForProxyless field set to true.
13305 # the request is passed along to the selected backendService.
13306 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
13307 { # Specification determining how headers are added to requests or responses.
13308 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
13309 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
13310 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
13311 # that already
13312 # exist for the header. If true, headerValue is set for the
13313 # header, discarding any values that were set for that header.
13314 #
13315 # The default value is true,
13316 # unless a variable is present in headerValue,
13317 # in which case the default value is false.
13318 # .
13319 },
13320 ],
13321 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
13322 # request before forwarding the request to the backendService.
13323 &quot;A String&quot;,
13324 ],
13325 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
13326 # client.
13327 { # Specification determining how headers are added to requests or responses.
13328 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
13329 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
13330 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
13331 # that already
13332 # exist for the header. If true, headerValue is set for the
13333 # header, discarding any values that were set for that header.
13334 #
13335 # The default value is true,
13336 # unless a variable is present in headerValue,
13337 # in which case the default value is false.
13338 # .
13339 },
13340 ],
13341 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
13342 # response before sending the response back to the client.
13343 &quot;A String&quot;,
13344 ],
13345 },
13346 &quot;hostRules&quot;: [ # The list of host rules to use against the URL.
13347 { # UrlMaps
13348 # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
13349 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
13350 # create the resource.
13351 &quot;hosts&quot;: [ # The list of host patterns to match. They must be valid hostnames with
13352 # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
13353 # that case, * must be the first character, and if followed by
13354 # anything, the immediate following character must be either -
13355 # or ..
13356 #
13357 # * based matching is not supported when the URL map is bound
13358 # to a target gRPC proxy that has the validateForProxyless field
13359 # set to true.
13360 &quot;A String&quot;,
13361 ],
13362 &quot;pathMatcher&quot;: &quot;A String&quot;, # The name of the PathMatcher to use to match the path portion
13363 # of the URL if the hostRule matches the URL&#x27;s host portion.
13364 },
13365 ],
13366 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the resource. This identifier is
13367 # defined by the server.
13368 &quot;kind&quot;: &quot;compute#urlMap&quot;, # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
13369 # url maps.
13370 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
13371 # The name must be 1-63 characters long, and comply withRFC1035.
13372 # Specifically, the name must be 1-63 characters long and match the regular
13373 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
13374 # character must be a lowercase letter, and all following characters must
13375 # be a dash, lowercase letter, or digit, except the last character, which
13376 # cannot be a dash.
13377 &quot;pathMatchers&quot;: [ # The list of named PathMatchers to use against the URL.
13378 { # A matcher for the path portion of the URL. The BackendService
13379 # from the longest-matched rule will serve the URL. If no rule was matched, the
13380 # default service is used.
13381 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
13382 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
13383 #
13384 # This policy takes
13385 # effect at the PathMatcher level and applies only when no
13386 # 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
13387 # in defaultCustomErrorResponsePolicy, then a policy defined for
13388 # the error code in UrlMap.defaultCustomErrorResponsePolicy
13389 # takes effect.
13390 #
13391 # For example, consider a UrlMap with the following
13392 # configuration:
13393 #
13394 #
13395 # - UrlMap.defaultCustomErrorResponsePolicy is configured
13396 # with policies for 5xx and 4xx errors
13397 # - A RouteRule for /coming_soon/ is configured for the
13398 # error code 404.
13399 #
13400 # 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
13401 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
13402 # the policy in RouteRule.customErrorResponsePolicy takes
13403 # effect. If any of the requests in this example encounter a 500
13404 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
13405 #
13406 # When
13407 # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
13408 # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
13409 # a retry, if load balancer is successful in reaching the
13410 # service, the defaultCustomErrorResponsePolicy is ignored and
13411 # the response from the service is returned to the client.
13412 #
13413 # defaultCustomErrorResponsePolicy is supported only for
13414 # global external Application Load Balancers.
13415 # backend service or backend bucket responds with an error.
13416 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
13417 #
13418 # In a given policy, if you specify rules for both a range of error codes
13419 # as well as rules for specific error codes then rules with specific error
13420 # codes have a higher priority. For example, assume that you configure a rule
13421 # for 401 (Un-authorized) code, and another for all 4 series
13422 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
13423 # However if the backend service returns a 403, the rule for4xx takes effect.
13424 { # Specifies the mapping between the response code that will be returned along
13425 # with the custom error content and the response code returned by the backend
13426 # service.
13427 &quot;matchResponseCodes&quot;: [ # Valid values include:
13428 #
13429 #
13430 # - A number between 400 and 599: For example
13431 # 401 or 503, in which case the load balancer
13432 # applies the policy if the error code exactly matches this value.
13433 # - 5xx: Load Balancer will apply the policy if the
13434 # backend service responds with any response code in the range of
13435 # 500 to 599.
13436 # - 4xx: Load
13437 # Balancer will apply the policy if the backend service responds with any
13438 # response code in the range of 400 to
13439 # 499.
13440 #
13441 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
13442 &quot;A String&quot;,
13443 ],
13444 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
13445 # error content. If overrideResponseCode is not supplied, the
13446 # same response code returned by the original backend bucket or backend
13447 # service is returned to the client.
13448 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
13449 #
13450 # path must start
13451 # with a leading slash. path cannot have trailing slashes.
13452 #
13453 # If the file is not available in backendBucket or the
13454 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
13455 #
13456 # The value must
13457 # be from 1 to 1024 characters
13458 },
13459 ],
13460 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
13461 # contains the custom error content. Examples are:
13462 #
13463 #
13464 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
13465 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
13466 # - global/backendBuckets/myBackendBucket
13467 #
13468 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
13469 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
13470 #
13471 # If load balancer cannot reach
13472 # the backendBucket, a simple Not Found Error will
13473 # be returned, with the original response code (oroverrideResponseCode if configured).
13474 #
13475 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
13476 },
13477 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
13478 # pathRules or routeRules match. The load balancer
13479 # performs advanced routing actions, such as URL rewrites and
13480 # header transformations, before forwarding the request to the
13481 # selected backend.
13482 #
13483 #
13484 # Only one of defaultUrlRedirect, defaultService
13485 # or defaultRouteAction.weightedBackendService can be set.
13486 #
13487 #
13488 # URL maps for classic Application Load Balancers only support
13489 # the urlRewrite action within a path matcher&#x27;sdefaultRouteAction.
13490 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
13491 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
13492 # property must be specified. This policy cannot be specified if any target
13493 # backend has Identity-Aware Proxy enabled.
13494 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
13495 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
13496 # header names can be specified. The cache is bypassed for all `cacheMode`
13497 # values.
13498 &quot;A String&quot;,
13499 ],
13500 &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
13501 # on the backend type: for Backend Services, the complete request URI is
13502 # used; for Backend Buckets, the request URI is used without the protocol or
13503 # host, and only query parameters known to Cloud Storage are included.
13504 # Policy defined on Route Action.
13505 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
13506 # parameters will be included. Either specify `excludedQueryParameters`
13507 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
13508 # encoded and not treated as delimiters.
13509 #
13510 # Note: This field applies to routes that use backend services. Attempting
13511 # to set it on a route that points exclusively to Backend Buckets will
13512 # result in a configuration error. For routes that point to a Backend
13513 # Bucket, use `includedQueryParameters` to define which parameters should
13514 # be part of the cache key.
13515 &quot;A String&quot;,
13516 ],
13517 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
13518 #
13519 # Note: This setting is only applicable to routes that use a Backend
13520 # Service. It does not affect requests served by a Backend Bucket, as the
13521 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
13522 # it on a route that points exclusively to Backend Buckets will result in a
13523 # configuration error.
13524 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
13525 #
13526 # Note: This setting is only applicable to routes that use a Backend
13527 # Service. It does not affect requests served by a Backend Bucket, as the
13528 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
13529 # set on a route that points exclusively to Backend Buckets will result in
13530 # a configuration error.
13531 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
13532 # `includedQueryParameters` and `excludedQueryParameters`. If neither
13533 # is set, the entire query string will be included. If false, the query
13534 # string will be excluded from the cache key entirely.
13535 #
13536 # Note: This field applies to routes that use backend services. Attempting
13537 # to set it on a route that points exclusively to Backend Buckets will
13538 # result in a configuration error. For routes that point to a Backend
13539 # Bucket, use `includedQueryParameters` to define which parameters should
13540 # be part of the cache key.
13541 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
13542 # The name=value pair will be used in the cache key Cloud CDN generates.
13543 #
13544 # Note: This setting is only applicable to routes that use a Backend
13545 # Service. It does not affect requests served by a Backend Bucket.
13546 # Attempting to set it on a route that points exclusively to Backend
13547 # Buckets will result in a configuration error. Up to 5 cookie names can be
13548 # specified.
13549 &quot;A String&quot;,
13550 ],
13551 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
13552 &quot;A String&quot;,
13553 ],
13554 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
13555 # parameters will be excluded. Either specify `includedQueryParameters`
13556 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
13557 # encoded and not treated as delimiters.
13558 &quot;A String&quot;,
13559 ],
13560 },
13561 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
13562 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
13563 &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
13564 # content. This is used to clamp the max-age (or Expires) value sent to the
13565 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
13566 # is used for the response max-age directive, along with a &quot;public&quot;
13567 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
13568 # clamps the max-age from the origin (if specified), or else sets the
13569 # response max-age directive to the lesser of the `clientTtl` and
13570 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
13571 # present. The maximum allowed value is 31,622,400s (1 year). If not
13572 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
13573 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
13574 # `USE_ORIGIN_HEADERS`.
13575 # as a count of seconds and fractions of seconds at nanosecond
13576 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13577 # or &quot;month&quot;. Range is approximately 10,000 years.
13578 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13579 # Durations less than one second are represented with a 0
13580 # `seconds` field and a positive `nanos` field. Must be from 0
13581 # to 999,999,999 inclusive.
13582 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13583 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13584 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13585 },
13586 &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
13587 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
13588 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
13589 # greater than that of `maxTtl`. When the `cacheMode` is set to
13590 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
13591 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
13592 # accessed objects may be evicted from the cache before the defined TTL. If
13593 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
13594 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
13595 # `USE_ORIGIN_HEADERS`.
13596 # as a count of seconds and fractions of seconds at nanosecond
13597 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13598 # or &quot;month&quot;. Range is approximately 10,000 years.
13599 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13600 # Durations less than one second are represented with a 0
13601 # `seconds` field and a positive `nanos` field. Must be from 0
13602 # to 999,999,999 inclusive.
13603 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13604 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13605 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13606 },
13607 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
13608 # attempt to set a max-age or s-maxage higher than this, or an Expires header
13609 # more than `maxTtl` seconds in the future will be capped at the value of
13610 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
13611 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
13612 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
13613 # Infrequently accessed objects may be evicted from the cache before the
13614 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
13615 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
13616 # mode.
13617 # as a count of seconds and fractions of seconds at nanosecond
13618 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13619 # or &quot;month&quot;. Range is approximately 10,000 years.
13620 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13621 # Durations less than one second are represented with a 0
13622 # `seconds` field and a positive `nanos` field. Must be from 0
13623 # to 999,999,999 inclusive.
13624 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13625 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13626 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13627 },
13628 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
13629 # to apply fine-grained caching for common errors or redirects.
13630 # This can reduce the load on your origin and improve end-user
13631 # experience by reducing response latency.
13632 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
13633 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
13634 # the specified response code that lack any Cache-Control, Expires, or
13635 # Pragma: no-cache directives. When the `cacheMode` is set to
13636 # `FORCE_CACHE_ALL`, negative caching applies to all responses
13637 # with the specified response code, and overrides any caching headers. By
13638 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
13639 #
13640 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
13641 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
13642 # * 405 (Method Not Found), 501 (Not Implemented): 60s
13643 #
13644 # These defaults can be overridden in `negativeCachingPolicy`.
13645 # If not specified, Cloud CDN applies negative caching by default.
13646 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
13647 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
13648 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
13649 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
13650 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
13651 # all response codes that you wish to cache. Cloud CDN will not apply any
13652 # default negative caching when a policy exists.
13653 { # Specify CDN TTLs for response error codes.
13654 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
13655 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
13656 # specified as values, and you cannot specify a status code more than
13657 # once.
13658 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
13659 # corresponding status code.
13660 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
13661 # objects may be evicted from the cache before the defined TTL.
13662 # as a count of seconds and fractions of seconds at nanosecond
13663 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13664 # or &quot;month&quot;. Range is approximately 10,000 years.
13665 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13666 # Durations less than one second are represented with a 0
13667 # `seconds` field and a positive `nanos` field. Must be from 0
13668 # to 999,999,999 inclusive.
13669 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13670 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13671 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13672 },
13673 },
13674 ],
13675 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
13676 # requests into a small number of requests to the origin. If not specified,
13677 # Cloud CDN applies request coalescing by default.
13678 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
13679 # content with the origin, or when an error is encountered when refreshing
13680 # the cache.
13681 # This setting defines the default &quot;max-stale&quot; duration for any cached
13682 # responses that do not specify a max-stale directive. Stale responses that
13683 # exceed the TTL configured here will not be served. The default limit
13684 # (max-stale) is 86400s (1 day), which will allow stale content to be
13685 # served up to this limit beyond the max-age (or s-maxage) of a cached
13686 # response.
13687 # The maximum allowed value is 604800 (1 week).
13688 # Set this to zero (0) to disable serve-while-stale.
13689 # as a count of seconds and fractions of seconds at nanosecond
13690 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13691 # or &quot;month&quot;. Range is approximately 10,000 years.
13692 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13693 # Durations less than one second are represented with a 0
13694 # `seconds` field and a positive `nanos` field. Must be from 0
13695 # to 999,999,999 inclusive.
13696 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13697 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13698 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13699 },
13700 },
13701 &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
13702 # information about the W3C recommendation for cross-origin resource sharing
13703 # (CORS), see Fetch API Living
13704 # Standard.
13705 #
13706 # Not supported when the URL map is bound to a target gRPC proxy.
13707 # information about the W3C recommendation for cross-origin resource sharing
13708 # (CORS), see Fetch API Living
13709 # Standard.
13710 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
13711 # indicates that
13712 # the actual request can include user credentials. This field translates to
13713 # the Access-Control-Allow-Credentials header.
13714 #
13715 # Default is false.
13716 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
13717 # header.
13718 &quot;A String&quot;,
13719 ],
13720 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
13721 # header.
13722 &quot;A String&quot;,
13723 ],
13724 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
13725 # more information, see regular expression syntax.
13726 #
13727 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
13728 #
13729 # Regular expressions can only be used when the loadBalancingScheme is
13730 # set to INTERNAL_SELF_MANAGED.
13731 &quot;A String&quot;,
13732 ],
13733 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
13734 #
13735 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
13736 &quot;A String&quot;,
13737 ],
13738 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
13739 # The default value is false, which indicates that the CORS
13740 # policy is in effect.
13741 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
13742 # header.
13743 &quot;A String&quot;,
13744 ],
13745 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
13746 # seconds. This field translates to the Access-Control-Max-Age
13747 # header.
13748 },
13749 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
13750 # the resiliency of clients to backend service failure. As part of fault
13751 # injection, when clients send requests to a backend service, delays can be
13752 # introduced by a load balancer on a percentage of requests before sending
13753 # those requests to the backend service. Similarly requests from clients can
13754 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
13755 # that are configured with a fault_injection_policy if:
13756 # 1. The traffic is generated by fault injection AND
13757 # 2. The fault injection is not a delay fault injection.
13758 # Fault injection is not supported with the classic Application Load Balancer
13759 # . To see which load balancers support fault injection,
13760 # see Load
13761 # balancing: Routing and traffic management features.
13762 # the resiliency of clients to backend service failure. As part of fault
13763 # injection, when clients send requests to a backend service, delays can be
13764 # introduced by the load balancer on a percentage of requests before sending
13765 # those request to the backend service. Similarly requests from clients can be
13766 # aborted by the load balancer for a percentage of requests.
13767 &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
13768 # injection.
13769 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
13770 #
13771 # The value must be from 200 to 599 inclusive.
13772 #
13773 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
13774 # according to this
13775 # mapping table. HTTP status 200 is mapped to gRPC status
13776 # UNKNOWN. Injecting an OK status is currently not supported by
13777 # Traffic Director.
13778 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
13779 # that is aborted as part of fault injection.
13780 #
13781 # The value must be from 0.0 to 100.0 inclusive.
13782 },
13783 &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
13784 # injection, before being sent to a backend service.
13785 # request to the backend service as part of fault injection.
13786 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
13787 # as a count of seconds and fractions of seconds at nanosecond
13788 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13789 # or &quot;month&quot;. Range is approximately 10,000 years.
13790 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13791 # Durations less than one second are represented with a 0
13792 # `seconds` field and a positive `nanos` field. Must be from 0
13793 # to 999,999,999 inclusive.
13794 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13795 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13796 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13797 },
13798 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
13799 # which a delay is introduced as part of fault injection.
13800 #
13801 # The value must be from 0.0 to 100.0 inclusive.
13802 },
13803 },
13804 &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
13805 # Global EXTERNAL_MANAGED load balancer schemes.
13806 # Either Cloud CDN must be enabled on the backend service or backend bucket
13807 # serving the route, or cache policy must be configured on the same route
13808 # dynamically processes and delivers images from the network edge.
13809 # Image Optimization is only available for Global External Application Load
13810 # Balancers.
13811 # Either Cloud CDN must be enabled on the backend service or backend bucket
13812 # serving the route, or cache policy must be configured on the same route.
13813 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
13814 },
13815 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
13816 # Unlike the timeout field where the timeout duration starts
13817 # from the time the request has been fully processed (known as*end-of-stream*),
13818 # the duration in this field is computed from the beginning of the stream
13819 # until the response has been processed, including all retries. A
13820 # stream that does not complete in this duration is closed.
13821 #
13822 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
13823 # with the route.
13824 #
13825 # This field is only allowed if the Url map is used with backend services
13826 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
13827 # as a count of seconds and fractions of seconds at nanosecond
13828 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13829 # or &quot;month&quot;. Range is approximately 10,000 years.
13830 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13831 # Durations less than one second are represented with a 0
13832 # `seconds` field and a positive `nanos` field. Must be from 0
13833 # to 999,999,999 inclusive.
13834 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13835 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13836 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13837 },
13838 &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
13839 # are shadowed to a separate mirrored backend service. The load balancer does
13840 # not wait for responses from the shadow service. Before sending traffic
13841 # to the shadow service, the host / authority header is suffixed with-shadow.
13842 #
13843 # Not supported when the URL map is bound to a target gRPC proxy that
13844 # has the validateForProxyless field set to true.
13845 # are shadowed to a separate mirrored backend service. The load balancer
13846 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
13847 # to the shadow service, the host or authority header is suffixed with-shadow.
13848 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
13849 # mirrored to.
13850 #
13851 # The backend service configured for a mirroring
13852 # policy must reference backends that are of the same type as the original
13853 # backend service matched in the URL map.
13854 #
13855 # Serverless NEG backends are not currently supported as a mirrored
13856 # backend service.
13857 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
13858 },
13859 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
13860 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
13861 # If not specified, defaults to 1.
13862 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
13863 #
13864 # If not specified, will use the timeout set in theHttpRouteAction field.
13865 # If timeout in the HttpRouteAction field is not set, this field
13866 # uses the largest timeout
13867 # among all backend services associated with the route.
13868 #
13869 # Not supported when the URL map is bound to a target gRPC proxy that
13870 # has the validateForProxyless field set to true.
13871 # as a count of seconds and fractions of seconds at nanosecond
13872 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13873 # or &quot;month&quot;. Range is approximately 10,000 years.
13874 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13875 # Durations less than one second are represented with a 0
13876 # `seconds` field and a positive `nanos` field. Must be from 0
13877 # to 999,999,999 inclusive.
13878 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13879 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13880 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13881 },
13882 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
13883 # values are:
13884 #
13885 # - 5xx: retry is attempted if the instance or endpoint
13886 # responds with any 5xx response code, or if the instance or
13887 # endpoint does not respond at all. For example, disconnects, reset, read
13888 # timeout, connection failure, and refused streams.
13889 # - gateway-error: Similar to 5xx, but only
13890 # applies to response codes 502, 503 or504.
13891 # - connect-failure: a retry is attempted on failures
13892 # connecting to the instance or endpoint. For example, connection
13893 # timeouts.
13894 # - retriable-4xx: a retry is attempted if the instance
13895 # or endpoint responds with a 4xx response code.
13896 # The only error that you can retry is error code 409.
13897 # - refused-stream: a retry is attempted if the instance
13898 # or endpoint resets the stream with a REFUSED_STREAM error
13899 # code. This reset type indicates that it is safe to retry.
13900 # - cancelled: a retry is attempted if the gRPC status
13901 # code in the response header is set to cancelled.
13902 # - deadline-exceeded: a retry is attempted if the gRPC
13903 # status code in the response header is set todeadline-exceeded.
13904 # - internal: a retry is attempted if the gRPC
13905 # status code in the response header is set tointernal.
13906 # - resource-exhausted: a retry is attempted if the gRPC
13907 # status code in the response header is set toresource-exhausted.
13908 # - unavailable: a retry is attempted if the gRPC
13909 # status code in the response header is set tounavailable.
13910 #
13911 # Only the following codes are supported when the URL map is bound to
13912 # target gRPC proxy that has validateForProxyless field set to true.
13913 #
13914 # - cancelled
13915 # - deadline-exceeded
13916 # - internal
13917 # - resource-exhausted
13918 # - unavailable
13919 &quot;A String&quot;,
13920 ],
13921 },
13922 &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
13923 # time the request has been fully processed (known as *end-of-stream*)
13924 # up until the response has been processed. Timeout includes
13925 # all retries.
13926 #
13927 # If not specified, this field uses the largest timeout among all backend
13928 # services associated with the route.
13929 #
13930 # Not supported when the URL map is bound to a target gRPC proxy that
13931 # has validateForProxyless field set to true.
13932 # as a count of seconds and fractions of seconds at nanosecond
13933 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13934 # or &quot;month&quot;. Range is approximately 10,000 years.
13935 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13936 # Durations less than one second are represented with a 0
13937 # `seconds` field and a positive `nanos` field. Must be from 0
13938 # to 999,999,999 inclusive.
13939 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13940 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13941 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13942 },
13943 &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
13944 # to the matched service.
13945 #
13946 # urlRewrite is the only action supported in UrlMaps
13947 # for classic Application Load Balancers.
13948 #
13949 # Not supported when the URL map is bound to a target gRPC proxy that
13950 # has the validateForProxyless field set to true.
13951 # backend service.
13952 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
13953 # host header is replaced with contents of hostRewrite.
13954 #
13955 # The value must be from 1 to 255 characters.
13956 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
13957 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
13958 #
13959 # The value must be from 1 to 1024 characters.
13960 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
13961 # header) using the HTTP template syntax.
13962 #
13963 # A corresponding
13964 # path_template_match must be specified. Any template variables must exist in
13965 # the path_template_match field.
13966 #
13967 #
13968 # - -At least one variable must be specified in the path_template_match
13969 # field
13970 # - You can omit variables from the rewritten URL
13971 # - The * and ** operators cannot be matched
13972 # unless they have a corresponding variable name - e.g.
13973 # {format=*} or {var=**}.
13974 #
13975 # For example, a path_template_match of /static/{format=**}
13976 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
13977 # rewrite, so that /{country}/{format}/{suffix=**} can be
13978 # rewritten as /content/{format}/{country}/{suffix}.
13979 #
13980 # At least
13981 # one non-empty routeRules[].matchRules[].path_template_match is
13982 # required.
13983 #
13984 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
13985 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
13986 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
13987 # It uses RE2 syntax with the following constraints:
13988 #
13989 #
13990 # - Any single character operators
13991 # - Groups are allowed to have only submatch operator inside
13992 # - Groups are allowed only without any char repetition, e.g.
13993 # .*
13994 # - Any char repetition, e.g. .*, is
13995 # only allowed to be used in a single regex together with:
13996 #
13997 #
13998 # - Empty string operators
13999 # - Other repetitions
14000 # - Ranges
14001 # - Repetitions of ranges
14002 #
14003 #
14004 # - Ranges are only allowed to have:
14005 #
14006 #
14007 # - Character range
14008 # - Digits range
14009 # - Symbols listed in characters allowed for ranges
14010 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
14011 # the path.
14012 },
14013 },
14014 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
14015 # occurs. The weights determine the fraction of traffic that flows to
14016 # their corresponding backend service. If all traffic needs to
14017 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
14018 #
14019 # After a backend service is identified and before forwarding
14020 # the request to
14021 # the backend service, advanced routing actions such as URL rewrites and
14022 # header transformations are applied depending on additional settings
14023 # specified in this HttpRouteAction.
14024 { # In contrast to a single BackendService in
14025 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
14026 # multiple backend services. The volume of traffic for each
14027 # backend service is proportional to the weight specified
14028 # in each WeightedBackendService
14029 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
14030 # resource. Before
14031 # forwarding the request to backendService, the load balancer
14032 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
14033 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
14034 # effect for the selected backendService.
14035 #
14036 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
14037 #
14038 # headerAction is not supported for load balancers that have
14039 # their loadBalancingScheme set to EXTERNAL.
14040 #
14041 # Not supported when the URL map is bound to a target gRPC proxy that
14042 # has validateForProxyless field set to true.
14043 # the request is passed along to the selected backendService.
14044 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
14045 { # Specification determining how headers are added to requests or responses.
14046 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
14047 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
14048 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
14049 # that already
14050 # exist for the header. If true, headerValue is set for the
14051 # header, discarding any values that were set for that header.
14052 #
14053 # The default value is true,
14054 # unless a variable is present in headerValue,
14055 # in which case the default value is false.
14056 # .
14057 },
14058 ],
14059 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
14060 # request before forwarding the request to the backendService.
14061 &quot;A String&quot;,
14062 ],
14063 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
14064 # client.
14065 { # Specification determining how headers are added to requests or responses.
14066 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
14067 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
14068 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
14069 # that already
14070 # exist for the header. If true, headerValue is set for the
14071 # header, discarding any values that were set for that header.
14072 #
14073 # The default value is true,
14074 # unless a variable is present in headerValue,
14075 # in which case the default value is false.
14076 # .
14077 },
14078 ],
14079 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
14080 # response before sending the response back to the client.
14081 &quot;A String&quot;,
14082 ],
14083 },
14084 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
14085 # computed asweight / (sum of all weightedBackendService weights in routeAction).
14086 #
14087 # The selection of a backend service is determined only for new traffic.
14088 # Once a user&#x27;s request has been directed to a backend service,
14089 # subsequent requests are sent to the same backend service as
14090 # determined by the backend service&#x27;s session affinity policy.
14091 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
14092 # splitting. If you do, the weighted traffic splitting configuration takes
14093 # precedence.
14094 #
14095 # The value must be from 0 to 1000.
14096 },
14097 ],
14098 },
14099 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource. This
14100 # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
14101 # matched. For example, the
14102 # following are all valid URLs to a BackendService resource:
14103 #
14104 #
14105 # - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
14106 # - compute/v1/projects/project/global/backendServices/backendService
14107 # - global/backendServices/backendService
14108 #
14109 #
14110 # If defaultRouteAction is also specified, advanced
14111 # routing actions, such as URL rewrites, take effect before sending the
14112 # request to the backend.
14113 #
14114 #
14115 # Only one of defaultUrlRedirect, defaultService
14116 # or defaultRouteAction.weightedBackendService can be set.
14117 #
14118 #
14119 # Authorization requires one or more of the following Google IAM permissions on the
14120 # specified resource default_service:
14121 #
14122 #
14123 # - compute.backendBuckets.use
14124 # - compute.backendServices.use
14125 &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
14126 # by defaultUrlRedirect.
14127 #
14128 #
14129 # Only one of defaultUrlRedirect, defaultService
14130 # or defaultRouteAction.weightedBackendService can be set.
14131 #
14132 #
14133 # Not supported when the URL map is bound to a target gRPC proxy.
14134 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
14135 # was supplied in the request.
14136 #
14137 # The value must be from 1 to 255
14138 # characters.
14139 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
14140 # set to HTTPS.
14141 # If set to false, the URL scheme of the redirected request
14142 # remains the same as that of the request.
14143 #
14144 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
14145 #
14146 # The default is set to false.
14147 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
14148 # that was supplied in the request.
14149 #
14150 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
14151 # supplied, the path of the original request is used for the redirect.
14152 #
14153 # The value must be from 1 to 1024 characters.
14154 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
14155 # the HttpRouteRuleMatch, retaining the remaining portion
14156 # of the URL before redirecting the request.
14157 #
14158 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
14159 # supplied, the path of the original request is used for the redirect.
14160 #
14161 # The value must be from 1 to 1024 characters.
14162 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
14163 #
14164 # Supported values are:
14165 #
14166 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
14167 # to 301.
14168 # - FOUND, which corresponds to 302.
14169 # - SEE_OTHER which corresponds to 303.
14170 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
14171 # method is retained.
14172 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
14173 # method is retained.
14174 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
14175 # URL is
14176 # removed before redirecting the request. If set to false, the
14177 # query portion of the original URL is retained.
14178 #
14179 # The default is set to false.
14180 },
14181 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
14182 # create the resource.
14183 &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
14184 # for the selected backend service.
14185 #
14186 # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
14187 #
14188 # HeaderAction is not supported for load balancers
14189 # that have
14190 # their loadBalancingScheme set to EXTERNAL.
14191 #
14192 # Not supported when the URL map is bound to a target gRPC proxy that
14193 # has validateForProxyless field set to true.
14194 # the request is passed along to the selected backendService.
14195 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
14196 { # Specification determining how headers are added to requests or responses.
14197 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
14198 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
14199 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
14200 # that already
14201 # exist for the header. If true, headerValue is set for the
14202 # header, discarding any values that were set for that header.
14203 #
14204 # The default value is true,
14205 # unless a variable is present in headerValue,
14206 # in which case the default value is false.
14207 # .
14208 },
14209 ],
14210 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
14211 # request before forwarding the request to the backendService.
14212 &quot;A String&quot;,
14213 ],
14214 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
14215 # client.
14216 { # Specification determining how headers are added to requests or responses.
14217 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
14218 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
14219 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
14220 # that already
14221 # exist for the header. If true, headerValue is set for the
14222 # header, discarding any values that were set for that header.
14223 #
14224 # The default value is true,
14225 # unless a variable is present in headerValue,
14226 # in which case the default value is false.
14227 # .
14228 },
14229 ],
14230 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
14231 # response before sending the response back to the client.
14232 &quot;A String&quot;,
14233 ],
14234 },
14235 &quot;name&quot;: &quot;A String&quot;, # The name to which this PathMatcher is referred by theHostRule.
14236 &quot;pathRules&quot;: [ # The list of path rules. Use this list instead of routeRules
14237 # when routing based on simple path matching is all that&#x27;s required. A path
14238 # rule can only include a wildcard character (*) after a
14239 # forward slash character (&quot;/&quot;).
14240 #
14241 # The order by which path rules are specified does not matter.
14242 # Matches are always done on the longest-path-first basis.
14243 #
14244 # For example: a pathRule with a path /a/b/c/* will match
14245 # before /a/b/* irrespective of the order in which those paths appear in this
14246 # list.
14247 #
14248 # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
14249 { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
14250 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
14251 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
14252 #
14253 # If a policy for an
14254 # error code is not configured for the PathRule, a policy for
14255 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
14256 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
14257 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
14258 # effect.
14259 #
14260 # For example, consider a UrlMap with the following configuration:
14261 #
14262 #
14263 # - UrlMap.defaultCustomErrorResponsePolicy are configured
14264 # with policies for 5xx and 4xx errors
14265 # - A PathRule for /coming_soon/ is configured for the error
14266 # code 404.
14267 #
14268 # 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
14269 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
14270 # the policy in PathRule.customErrorResponsePolicy takes
14271 # effect. If any of the requests in this example encounter a 500
14272 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
14273 #
14274 # customErrorResponsePolicy is supported only for
14275 # global external Application Load Balancers.
14276 # backend service or backend bucket responds with an error.
14277 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
14278 #
14279 # In a given policy, if you specify rules for both a range of error codes
14280 # as well as rules for specific error codes then rules with specific error
14281 # codes have a higher priority. For example, assume that you configure a rule
14282 # for 401 (Un-authorized) code, and another for all 4 series
14283 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
14284 # However if the backend service returns a 403, the rule for4xx takes effect.
14285 { # Specifies the mapping between the response code that will be returned along
14286 # with the custom error content and the response code returned by the backend
14287 # service.
14288 &quot;matchResponseCodes&quot;: [ # Valid values include:
14289 #
14290 #
14291 # - A number between 400 and 599: For example
14292 # 401 or 503, in which case the load balancer
14293 # applies the policy if the error code exactly matches this value.
14294 # - 5xx: Load Balancer will apply the policy if the
14295 # backend service responds with any response code in the range of
14296 # 500 to 599.
14297 # - 4xx: Load
14298 # Balancer will apply the policy if the backend service responds with any
14299 # response code in the range of 400 to
14300 # 499.
14301 #
14302 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
14303 &quot;A String&quot;,
14304 ],
14305 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
14306 # error content. If overrideResponseCode is not supplied, the
14307 # same response code returned by the original backend bucket or backend
14308 # service is returned to the client.
14309 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
14310 #
14311 # path must start
14312 # with a leading slash. path cannot have trailing slashes.
14313 #
14314 # If the file is not available in backendBucket or the
14315 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
14316 #
14317 # The value must
14318 # be from 1 to 1024 characters
14319 },
14320 ],
14321 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
14322 # contains the custom error content. Examples are:
14323 #
14324 #
14325 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
14326 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
14327 # - global/backendBuckets/myBackendBucket
14328 #
14329 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
14330 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
14331 #
14332 # If load balancer cannot reach
14333 # the backendBucket, a simple Not Found Error will
14334 # be returned, with the original response code (oroverrideResponseCode if configured).
14335 #
14336 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
14337 },
14338 &quot;paths&quot;: [ # The list of path patterns to match. Each must start with /
14339 # and the only place a * is allowed is at the end following
14340 # a /. The string fed to the path matcher does not include
14341 # any text after the first ? or #, and
14342 # those chars are not allowed here.
14343 &quot;A String&quot;,
14344 ],
14345 &quot;routeAction&quot;: { # In response to a matching path, the load balancer
14346 # performs advanced routing actions, such as URL rewrites and header
14347 # transformations, before forwarding the request to the selected
14348 # backend.
14349 #
14350 #
14351 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
14352 #
14353 #
14354 # URL maps for classic Application Load Balancers only support
14355 # the urlRewrite action within a path rule&#x27;srouteAction.
14356 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
14357 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
14358 # property must be specified. This policy cannot be specified if any target
14359 # backend has Identity-Aware Proxy enabled.
14360 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
14361 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
14362 # header names can be specified. The cache is bypassed for all `cacheMode`
14363 # values.
14364 &quot;A String&quot;,
14365 ],
14366 &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
14367 # on the backend type: for Backend Services, the complete request URI is
14368 # used; for Backend Buckets, the request URI is used without the protocol or
14369 # host, and only query parameters known to Cloud Storage are included.
14370 # Policy defined on Route Action.
14371 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
14372 # parameters will be included. Either specify `excludedQueryParameters`
14373 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
14374 # encoded and not treated as delimiters.
14375 #
14376 # Note: This field applies to routes that use backend services. Attempting
14377 # to set it on a route that points exclusively to Backend Buckets will
14378 # result in a configuration error. For routes that point to a Backend
14379 # Bucket, use `includedQueryParameters` to define which parameters should
14380 # be part of the cache key.
14381 &quot;A String&quot;,
14382 ],
14383 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
14384 #
14385 # Note: This setting is only applicable to routes that use a Backend
14386 # Service. It does not affect requests served by a Backend Bucket, as the
14387 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
14388 # it on a route that points exclusively to Backend Buckets will result in a
14389 # configuration error.
14390 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
14391 #
14392 # Note: This setting is only applicable to routes that use a Backend
14393 # Service. It does not affect requests served by a Backend Bucket, as the
14394 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
14395 # set on a route that points exclusively to Backend Buckets will result in
14396 # a configuration error.
14397 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
14398 # `includedQueryParameters` and `excludedQueryParameters`. If neither
14399 # is set, the entire query string will be included. If false, the query
14400 # string will be excluded from the cache key entirely.
14401 #
14402 # Note: This field applies to routes that use backend services. Attempting
14403 # to set it on a route that points exclusively to Backend Buckets will
14404 # result in a configuration error. For routes that point to a Backend
14405 # Bucket, use `includedQueryParameters` to define which parameters should
14406 # be part of the cache key.
14407 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
14408 # The name=value pair will be used in the cache key Cloud CDN generates.
14409 #
14410 # Note: This setting is only applicable to routes that use a Backend
14411 # Service. It does not affect requests served by a Backend Bucket.
14412 # Attempting to set it on a route that points exclusively to Backend
14413 # Buckets will result in a configuration error. Up to 5 cookie names can be
14414 # specified.
14415 &quot;A String&quot;,
14416 ],
14417 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
14418 &quot;A String&quot;,
14419 ],
14420 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
14421 # parameters will be excluded. Either specify `includedQueryParameters`
14422 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
14423 # encoded and not treated as delimiters.
14424 &quot;A String&quot;,
14425 ],
14426 },
14427 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
14428 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
14429 &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
14430 # content. This is used to clamp the max-age (or Expires) value sent to the
14431 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
14432 # is used for the response max-age directive, along with a &quot;public&quot;
14433 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
14434 # clamps the max-age from the origin (if specified), or else sets the
14435 # response max-age directive to the lesser of the `clientTtl` and
14436 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
14437 # present. The maximum allowed value is 31,622,400s (1 year). If not
14438 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
14439 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
14440 # `USE_ORIGIN_HEADERS`.
14441 # as a count of seconds and fractions of seconds at nanosecond
14442 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14443 # or &quot;month&quot;. Range is approximately 10,000 years.
14444 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14445 # Durations less than one second are represented with a 0
14446 # `seconds` field and a positive `nanos` field. Must be from 0
14447 # to 999,999,999 inclusive.
14448 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14449 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14450 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14451 },
14452 &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
14453 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
14454 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
14455 # greater than that of `maxTtl`. When the `cacheMode` is set to
14456 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
14457 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
14458 # accessed objects may be evicted from the cache before the defined TTL. If
14459 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
14460 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
14461 # `USE_ORIGIN_HEADERS`.
14462 # as a count of seconds and fractions of seconds at nanosecond
14463 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14464 # or &quot;month&quot;. Range is approximately 10,000 years.
14465 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14466 # Durations less than one second are represented with a 0
14467 # `seconds` field and a positive `nanos` field. Must be from 0
14468 # to 999,999,999 inclusive.
14469 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14470 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14471 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14472 },
14473 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
14474 # attempt to set a max-age or s-maxage higher than this, or an Expires header
14475 # more than `maxTtl` seconds in the future will be capped at the value of
14476 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
14477 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
14478 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
14479 # Infrequently accessed objects may be evicted from the cache before the
14480 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
14481 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
14482 # mode.
14483 # as a count of seconds and fractions of seconds at nanosecond
14484 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14485 # or &quot;month&quot;. Range is approximately 10,000 years.
14486 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14487 # Durations less than one second are represented with a 0
14488 # `seconds` field and a positive `nanos` field. Must be from 0
14489 # to 999,999,999 inclusive.
14490 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14491 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14492 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14493 },
14494 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
14495 # to apply fine-grained caching for common errors or redirects.
14496 # This can reduce the load on your origin and improve end-user
14497 # experience by reducing response latency.
14498 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
14499 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
14500 # the specified response code that lack any Cache-Control, Expires, or
14501 # Pragma: no-cache directives. When the `cacheMode` is set to
14502 # `FORCE_CACHE_ALL`, negative caching applies to all responses
14503 # with the specified response code, and overrides any caching headers. By
14504 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
14505 #
14506 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
14507 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
14508 # * 405 (Method Not Found), 501 (Not Implemented): 60s
14509 #
14510 # These defaults can be overridden in `negativeCachingPolicy`.
14511 # If not specified, Cloud CDN applies negative caching by default.
14512 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
14513 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
14514 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
14515 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
14516 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
14517 # all response codes that you wish to cache. Cloud CDN will not apply any
14518 # default negative caching when a policy exists.
14519 { # Specify CDN TTLs for response error codes.
14520 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
14521 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
14522 # specified as values, and you cannot specify a status code more than
14523 # once.
14524 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
14525 # corresponding status code.
14526 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
14527 # objects may be evicted from the cache before the defined TTL.
14528 # as a count of seconds and fractions of seconds at nanosecond
14529 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14530 # or &quot;month&quot;. Range is approximately 10,000 years.
14531 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14532 # Durations less than one second are represented with a 0
14533 # `seconds` field and a positive `nanos` field. Must be from 0
14534 # to 999,999,999 inclusive.
14535 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14536 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14537 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14538 },
14539 },
14540 ],
14541 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
14542 # requests into a small number of requests to the origin. If not specified,
14543 # Cloud CDN applies request coalescing by default.
14544 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
14545 # content with the origin, or when an error is encountered when refreshing
14546 # the cache.
14547 # This setting defines the default &quot;max-stale&quot; duration for any cached
14548 # responses that do not specify a max-stale directive. Stale responses that
14549 # exceed the TTL configured here will not be served. The default limit
14550 # (max-stale) is 86400s (1 day), which will allow stale content to be
14551 # served up to this limit beyond the max-age (or s-maxage) of a cached
14552 # response.
14553 # The maximum allowed value is 604800 (1 week).
14554 # Set this to zero (0) to disable serve-while-stale.
14555 # as a count of seconds and fractions of seconds at nanosecond
14556 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14557 # or &quot;month&quot;. Range is approximately 10,000 years.
14558 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14559 # Durations less than one second are represented with a 0
14560 # `seconds` field and a positive `nanos` field. Must be from 0
14561 # to 999,999,999 inclusive.
14562 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14563 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14564 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14565 },
14566 },
14567 &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
14568 # information about the W3C recommendation for cross-origin resource sharing
14569 # (CORS), see Fetch API Living
14570 # Standard.
14571 #
14572 # Not supported when the URL map is bound to a target gRPC proxy.
14573 # information about the W3C recommendation for cross-origin resource sharing
14574 # (CORS), see Fetch API Living
14575 # Standard.
14576 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
14577 # indicates that
14578 # the actual request can include user credentials. This field translates to
14579 # the Access-Control-Allow-Credentials header.
14580 #
14581 # Default is false.
14582 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
14583 # header.
14584 &quot;A String&quot;,
14585 ],
14586 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
14587 # header.
14588 &quot;A String&quot;,
14589 ],
14590 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
14591 # more information, see regular expression syntax.
14592 #
14593 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
14594 #
14595 # Regular expressions can only be used when the loadBalancingScheme is
14596 # set to INTERNAL_SELF_MANAGED.
14597 &quot;A String&quot;,
14598 ],
14599 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
14600 #
14601 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
14602 &quot;A String&quot;,
14603 ],
14604 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
14605 # The default value is false, which indicates that the CORS
14606 # policy is in effect.
14607 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
14608 # header.
14609 &quot;A String&quot;,
14610 ],
14611 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
14612 # seconds. This field translates to the Access-Control-Max-Age
14613 # header.
14614 },
14615 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
14616 # the resiliency of clients to backend service failure. As part of fault
14617 # injection, when clients send requests to a backend service, delays can be
14618 # introduced by a load balancer on a percentage of requests before sending
14619 # those requests to the backend service. Similarly requests from clients can
14620 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
14621 # that are configured with a fault_injection_policy if:
14622 # 1. The traffic is generated by fault injection AND
14623 # 2. The fault injection is not a delay fault injection.
14624 # Fault injection is not supported with the classic Application Load Balancer
14625 # . To see which load balancers support fault injection,
14626 # see Load
14627 # balancing: Routing and traffic management features.
14628 # the resiliency of clients to backend service failure. As part of fault
14629 # injection, when clients send requests to a backend service, delays can be
14630 # introduced by the load balancer on a percentage of requests before sending
14631 # those request to the backend service. Similarly requests from clients can be
14632 # aborted by the load balancer for a percentage of requests.
14633 &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
14634 # injection.
14635 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
14636 #
14637 # The value must be from 200 to 599 inclusive.
14638 #
14639 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
14640 # according to this
14641 # mapping table. HTTP status 200 is mapped to gRPC status
14642 # UNKNOWN. Injecting an OK status is currently not supported by
14643 # Traffic Director.
14644 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
14645 # that is aborted as part of fault injection.
14646 #
14647 # The value must be from 0.0 to 100.0 inclusive.
14648 },
14649 &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
14650 # injection, before being sent to a backend service.
14651 # request to the backend service as part of fault injection.
14652 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
14653 # as a count of seconds and fractions of seconds at nanosecond
14654 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14655 # or &quot;month&quot;. Range is approximately 10,000 years.
14656 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14657 # Durations less than one second are represented with a 0
14658 # `seconds` field and a positive `nanos` field. Must be from 0
14659 # to 999,999,999 inclusive.
14660 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14661 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14662 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14663 },
14664 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
14665 # which a delay is introduced as part of fault injection.
14666 #
14667 # The value must be from 0.0 to 100.0 inclusive.
14668 },
14669 },
14670 &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
14671 # Global EXTERNAL_MANAGED load balancer schemes.
14672 # Either Cloud CDN must be enabled on the backend service or backend bucket
14673 # serving the route, or cache policy must be configured on the same route
14674 # dynamically processes and delivers images from the network edge.
14675 # Image Optimization is only available for Global External Application Load
14676 # Balancers.
14677 # Either Cloud CDN must be enabled on the backend service or backend bucket
14678 # serving the route, or cache policy must be configured on the same route.
14679 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
14680 },
14681 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
14682 # Unlike the timeout field where the timeout duration starts
14683 # from the time the request has been fully processed (known as*end-of-stream*),
14684 # the duration in this field is computed from the beginning of the stream
14685 # until the response has been processed, including all retries. A
14686 # stream that does not complete in this duration is closed.
14687 #
14688 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
14689 # with the route.
14690 #
14691 # This field is only allowed if the Url map is used with backend services
14692 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
14693 # as a count of seconds and fractions of seconds at nanosecond
14694 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14695 # or &quot;month&quot;. Range is approximately 10,000 years.
14696 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14697 # Durations less than one second are represented with a 0
14698 # `seconds` field and a positive `nanos` field. Must be from 0
14699 # to 999,999,999 inclusive.
14700 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14701 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14702 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14703 },
14704 &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
14705 # are shadowed to a separate mirrored backend service. The load balancer does
14706 # not wait for responses from the shadow service. Before sending traffic
14707 # to the shadow service, the host / authority header is suffixed with-shadow.
14708 #
14709 # Not supported when the URL map is bound to a target gRPC proxy that
14710 # has the validateForProxyless field set to true.
14711 # are shadowed to a separate mirrored backend service. The load balancer
14712 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
14713 # to the shadow service, the host or authority header is suffixed with-shadow.
14714 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
14715 # mirrored to.
14716 #
14717 # The backend service configured for a mirroring
14718 # policy must reference backends that are of the same type as the original
14719 # backend service matched in the URL map.
14720 #
14721 # Serverless NEG backends are not currently supported as a mirrored
14722 # backend service.
14723 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
14724 },
14725 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
14726 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
14727 # If not specified, defaults to 1.
14728 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
14729 #
14730 # If not specified, will use the timeout set in theHttpRouteAction field.
14731 # If timeout in the HttpRouteAction field is not set, this field
14732 # uses the largest timeout
14733 # among all backend services associated with the route.
14734 #
14735 # Not supported when the URL map is bound to a target gRPC proxy that
14736 # has the validateForProxyless field set to true.
14737 # as a count of seconds and fractions of seconds at nanosecond
14738 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14739 # or &quot;month&quot;. Range is approximately 10,000 years.
14740 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14741 # Durations less than one second are represented with a 0
14742 # `seconds` field and a positive `nanos` field. Must be from 0
14743 # to 999,999,999 inclusive.
14744 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14745 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14746 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14747 },
14748 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
14749 # values are:
14750 #
14751 # - 5xx: retry is attempted if the instance or endpoint
14752 # responds with any 5xx response code, or if the instance or
14753 # endpoint does not respond at all. For example, disconnects, reset, read
14754 # timeout, connection failure, and refused streams.
14755 # - gateway-error: Similar to 5xx, but only
14756 # applies to response codes 502, 503 or504.
14757 # - connect-failure: a retry is attempted on failures
14758 # connecting to the instance or endpoint. For example, connection
14759 # timeouts.
14760 # - retriable-4xx: a retry is attempted if the instance
14761 # or endpoint responds with a 4xx response code.
14762 # The only error that you can retry is error code 409.
14763 # - refused-stream: a retry is attempted if the instance
14764 # or endpoint resets the stream with a REFUSED_STREAM error
14765 # code. This reset type indicates that it is safe to retry.
14766 # - cancelled: a retry is attempted if the gRPC status
14767 # code in the response header is set to cancelled.
14768 # - deadline-exceeded: a retry is attempted if the gRPC
14769 # status code in the response header is set todeadline-exceeded.
14770 # - internal: a retry is attempted if the gRPC
14771 # status code in the response header is set tointernal.
14772 # - resource-exhausted: a retry is attempted if the gRPC
14773 # status code in the response header is set toresource-exhausted.
14774 # - unavailable: a retry is attempted if the gRPC
14775 # status code in the response header is set tounavailable.
14776 #
14777 # Only the following codes are supported when the URL map is bound to
14778 # target gRPC proxy that has validateForProxyless field set to true.
14779 #
14780 # - cancelled
14781 # - deadline-exceeded
14782 # - internal
14783 # - resource-exhausted
14784 # - unavailable
14785 &quot;A String&quot;,
14786 ],
14787 },
14788 &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
14789 # time the request has been fully processed (known as *end-of-stream*)
14790 # up until the response has been processed. Timeout includes
14791 # all retries.
14792 #
14793 # If not specified, this field uses the largest timeout among all backend
14794 # services associated with the route.
14795 #
14796 # Not supported when the URL map is bound to a target gRPC proxy that
14797 # has validateForProxyless field set to true.
14798 # as a count of seconds and fractions of seconds at nanosecond
14799 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14800 # or &quot;month&quot;. Range is approximately 10,000 years.
14801 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14802 # Durations less than one second are represented with a 0
14803 # `seconds` field and a positive `nanos` field. Must be from 0
14804 # to 999,999,999 inclusive.
14805 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14806 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14807 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14808 },
14809 &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
14810 # to the matched service.
14811 #
14812 # urlRewrite is the only action supported in UrlMaps
14813 # for classic Application Load Balancers.
14814 #
14815 # Not supported when the URL map is bound to a target gRPC proxy that
14816 # has the validateForProxyless field set to true.
14817 # backend service.
14818 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
14819 # host header is replaced with contents of hostRewrite.
14820 #
14821 # The value must be from 1 to 255 characters.
14822 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
14823 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
14824 #
14825 # The value must be from 1 to 1024 characters.
14826 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
14827 # header) using the HTTP template syntax.
14828 #
14829 # A corresponding
14830 # path_template_match must be specified. Any template variables must exist in
14831 # the path_template_match field.
14832 #
14833 #
14834 # - -At least one variable must be specified in the path_template_match
14835 # field
14836 # - You can omit variables from the rewritten URL
14837 # - The * and ** operators cannot be matched
14838 # unless they have a corresponding variable name - e.g.
14839 # {format=*} or {var=**}.
14840 #
14841 # For example, a path_template_match of /static/{format=**}
14842 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
14843 # rewrite, so that /{country}/{format}/{suffix=**} can be
14844 # rewritten as /content/{format}/{country}/{suffix}.
14845 #
14846 # At least
14847 # one non-empty routeRules[].matchRules[].path_template_match is
14848 # required.
14849 #
14850 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
14851 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
14852 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
14853 # It uses RE2 syntax with the following constraints:
14854 #
14855 #
14856 # - Any single character operators
14857 # - Groups are allowed to have only submatch operator inside
14858 # - Groups are allowed only without any char repetition, e.g.
14859 # .*
14860 # - Any char repetition, e.g. .*, is
14861 # only allowed to be used in a single regex together with:
14862 #
14863 #
14864 # - Empty string operators
14865 # - Other repetitions
14866 # - Ranges
14867 # - Repetitions of ranges
14868 #
14869 #
14870 # - Ranges are only allowed to have:
14871 #
14872 #
14873 # - Character range
14874 # - Digits range
14875 # - Symbols listed in characters allowed for ranges
14876 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
14877 # the path.
14878 },
14879 },
14880 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
14881 # occurs. The weights determine the fraction of traffic that flows to
14882 # their corresponding backend service. If all traffic needs to
14883 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
14884 #
14885 # After a backend service is identified and before forwarding
14886 # the request to
14887 # the backend service, advanced routing actions such as URL rewrites and
14888 # header transformations are applied depending on additional settings
14889 # specified in this HttpRouteAction.
14890 { # In contrast to a single BackendService in
14891 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
14892 # multiple backend services. The volume of traffic for each
14893 # backend service is proportional to the weight specified
14894 # in each WeightedBackendService
14895 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
14896 # resource. Before
14897 # forwarding the request to backendService, the load balancer
14898 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
14899 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
14900 # effect for the selected backendService.
14901 #
14902 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
14903 #
14904 # headerAction is not supported for load balancers that have
14905 # their loadBalancingScheme set to EXTERNAL.
14906 #
14907 # Not supported when the URL map is bound to a target gRPC proxy that
14908 # has validateForProxyless field set to true.
14909 # the request is passed along to the selected backendService.
14910 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
14911 { # Specification determining how headers are added to requests or responses.
14912 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
14913 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
14914 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
14915 # that already
14916 # exist for the header. If true, headerValue is set for the
14917 # header, discarding any values that were set for that header.
14918 #
14919 # The default value is true,
14920 # unless a variable is present in headerValue,
14921 # in which case the default value is false.
14922 # .
14923 },
14924 ],
14925 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
14926 # request before forwarding the request to the backendService.
14927 &quot;A String&quot;,
14928 ],
14929 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
14930 # client.
14931 { # Specification determining how headers are added to requests or responses.
14932 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
14933 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
14934 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
14935 # that already
14936 # exist for the header. If true, headerValue is set for the
14937 # header, discarding any values that were set for that header.
14938 #
14939 # The default value is true,
14940 # unless a variable is present in headerValue,
14941 # in which case the default value is false.
14942 # .
14943 },
14944 ],
14945 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
14946 # response before sending the response back to the client.
14947 &quot;A String&quot;,
14948 ],
14949 },
14950 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
14951 # computed asweight / (sum of all weightedBackendService weights in routeAction).
14952 #
14953 # The selection of a backend service is determined only for new traffic.
14954 # Once a user&#x27;s request has been directed to a backend service,
14955 # subsequent requests are sent to the same backend service as
14956 # determined by the backend service&#x27;s session affinity policy.
14957 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
14958 # splitting. If you do, the weighted traffic splitting configuration takes
14959 # precedence.
14960 #
14961 # The value must be from 0 to 1000.
14962 },
14963 ],
14964 },
14965 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
14966 # is directed if this rule is matched. If routeAction is
14967 # also specified, advanced routing actions, such as URL rewrites,
14968 # take effect before sending the request to the backend.
14969 #
14970 #
14971 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
14972 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
14973 # specified by urlRedirect.
14974 #
14975 #
14976 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
14977 #
14978 #
14979 # Not supported when the URL map is bound to a target gRPC proxy.
14980 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
14981 # was supplied in the request.
14982 #
14983 # The value must be from 1 to 255
14984 # characters.
14985 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
14986 # set to HTTPS.
14987 # If set to false, the URL scheme of the redirected request
14988 # remains the same as that of the request.
14989 #
14990 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
14991 #
14992 # The default is set to false.
14993 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
14994 # that was supplied in the request.
14995 #
14996 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
14997 # supplied, the path of the original request is used for the redirect.
14998 #
14999 # The value must be from 1 to 1024 characters.
15000 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
15001 # the HttpRouteRuleMatch, retaining the remaining portion
15002 # of the URL before redirecting the request.
15003 #
15004 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
15005 # supplied, the path of the original request is used for the redirect.
15006 #
15007 # The value must be from 1 to 1024 characters.
15008 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
15009 #
15010 # Supported values are:
15011 #
15012 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
15013 # to 301.
15014 # - FOUND, which corresponds to 302.
15015 # - SEE_OTHER which corresponds to 303.
15016 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
15017 # method is retained.
15018 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
15019 # method is retained.
15020 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
15021 # URL is
15022 # removed before redirecting the request. If set to false, the
15023 # query portion of the original URL is retained.
15024 #
15025 # The default is set to false.
15026 },
15027 },
15028 ],
15029 &quot;routeRules&quot;: [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
15030 # desired. routeRules are evaluated in order of priority, from
15031 # the lowest to highest number.
15032 #
15033 # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
15034 { # The HttpRouteRule setting specifies how to match an HTTP request
15035 # and the corresponding routing action that load balancing proxies perform.
15036 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
15037 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
15038 #
15039 # If a policy for an
15040 # error code is not configured for the RouteRule, a policy for
15041 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
15042 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
15043 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
15044 # effect.
15045 #
15046 # For example, consider a UrlMap with the following configuration:
15047 #
15048 #
15049 # - UrlMap.defaultCustomErrorResponsePolicy are configured
15050 # with policies for 5xx and 4xx errors
15051 # - A RouteRule for /coming_soon/ is configured for the
15052 # error code 404.
15053 #
15054 # 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
15055 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
15056 # the policy in RouteRule.customErrorResponsePolicy takes
15057 # effect. If any of the requests in this example encounter a 500
15058 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
15059 #
15060 # When
15061 # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
15062 # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
15063 # a retry, if load balancer is successful in reaching the
15064 # service, the customErrorResponsePolicy is ignored and
15065 # the response from the service is returned to the client.
15066 #
15067 # customErrorResponsePolicy is supported only for
15068 # global external Application Load Balancers.
15069 # backend service or backend bucket responds with an error.
15070 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
15071 #
15072 # In a given policy, if you specify rules for both a range of error codes
15073 # as well as rules for specific error codes then rules with specific error
15074 # codes have a higher priority. For example, assume that you configure a rule
15075 # for 401 (Un-authorized) code, and another for all 4 series
15076 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
15077 # However if the backend service returns a 403, the rule for4xx takes effect.
15078 { # Specifies the mapping between the response code that will be returned along
15079 # with the custom error content and the response code returned by the backend
15080 # service.
15081 &quot;matchResponseCodes&quot;: [ # Valid values include:
15082 #
15083 #
15084 # - A number between 400 and 599: For example
15085 # 401 or 503, in which case the load balancer
15086 # applies the policy if the error code exactly matches this value.
15087 # - 5xx: Load Balancer will apply the policy if the
15088 # backend service responds with any response code in the range of
15089 # 500 to 599.
15090 # - 4xx: Load
15091 # Balancer will apply the policy if the backend service responds with any
15092 # response code in the range of 400 to
15093 # 499.
15094 #
15095 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
15096 &quot;A String&quot;,
15097 ],
15098 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
15099 # error content. If overrideResponseCode is not supplied, the
15100 # same response code returned by the original backend bucket or backend
15101 # service is returned to the client.
15102 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
15103 #
15104 # path must start
15105 # with a leading slash. path cannot have trailing slashes.
15106 #
15107 # If the file is not available in backendBucket or the
15108 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
15109 #
15110 # The value must
15111 # be from 1 to 1024 characters
15112 },
15113 ],
15114 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
15115 # contains the custom error content. Examples are:
15116 #
15117 #
15118 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
15119 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
15120 # - global/backendBuckets/myBackendBucket
15121 #
15122 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
15123 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
15124 #
15125 # If load balancer cannot reach
15126 # the backendBucket, a simple Not Found Error will
15127 # be returned, with the original response code (oroverrideResponseCode if configured).
15128 #
15129 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
15130 },
15131 &quot;description&quot;: &quot;A String&quot;, # The short description conveying the intent of this routeRule.
15132 #
15133 #
15134 # The description can have a maximum length of 1024 characters.
15135 &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
15136 # for the selected backendService.
15137 #
15138 # The headerAction value specified here is applied before the
15139 # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
15140 #
15141 # HeaderAction is not supported for load balancers
15142 # that have
15143 # their loadBalancingScheme set to EXTERNAL.
15144 #
15145 # Not supported when the URL map is bound to a target gRPC proxy that
15146 # has validateForProxyless field set to true.
15147 # the request is passed along to the selected backendService.
15148 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
15149 { # Specification determining how headers are added to requests or responses.
15150 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
15151 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
15152 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
15153 # that already
15154 # exist for the header. If true, headerValue is set for the
15155 # header, discarding any values that were set for that header.
15156 #
15157 # The default value is true,
15158 # unless a variable is present in headerValue,
15159 # in which case the default value is false.
15160 # .
15161 },
15162 ],
15163 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
15164 # request before forwarding the request to the backendService.
15165 &quot;A String&quot;,
15166 ],
15167 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
15168 # client.
15169 { # Specification determining how headers are added to requests or responses.
15170 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
15171 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
15172 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
15173 # that already
15174 # exist for the header. If true, headerValue is set for the
15175 # header, discarding any values that were set for that header.
15176 #
15177 # The default value is true,
15178 # unless a variable is present in headerValue,
15179 # in which case the default value is false.
15180 # .
15181 },
15182 ],
15183 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
15184 # response before sending the response back to the client.
15185 &quot;A String&quot;,
15186 ],
15187 },
15188 &quot;httpFilterConfigs&quot;: [ # Outbound route specific configuration fornetworkservices.HttpFilter resources enabled by Traffic
15189 # Director. httpFilterConfigs only applies for load balancers
15190 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
15191 # more details.
15192 #
15193 # Not supported when the URL map is bound to a target gRPC proxy that
15194 # has validateForProxyless field set to true.
15195 { # HttpFilterConfiguration supplies additional contextual settings
15196 # for networkservices.HttpFilter resources enabled by Traffic
15197 # Director.
15198 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
15199 # YAML formatted and only contain fields defined in the protobuf identified
15200 # in configTypeUrl
15201 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
15202 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
15203 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
15204 # configuration belongs to. This name must be known to the xDS client.
15205 # Example: envoy.wasm
15206 },
15207 ],
15208 &quot;httpFilterMetadata&quot;: [ # Outbound route specific metadata supplied tonetworkservices.HttpFilter resources enabled by Traffic
15209 # Director. httpFilterMetadata only applies for load balancers
15210 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
15211 # more details.
15212 #
15213 # The only configTypeUrl supported istype.googleapis.com/google.protobuf.Struct
15214 #
15215 # Not supported when the URL map is bound to a target gRPC proxy that
15216 # has validateForProxyless field set to true.
15217 { # HttpFilterConfiguration supplies additional contextual settings
15218 # for networkservices.HttpFilter resources enabled by Traffic
15219 # Director.
15220 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
15221 # YAML formatted and only contain fields defined in the protobuf identified
15222 # in configTypeUrl
15223 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
15224 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
15225 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
15226 # configuration belongs to. This name must be known to the xDS client.
15227 # Example: envoy.wasm
15228 },
15229 ],
15230 &quot;matchRules&quot;: [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
15231 # this routeRule when any of thematchRules are satisfied. However predicates within
15232 # a given matchRule have AND semantics. All predicates
15233 # within a matchRule must match for the request to
15234 # match the rule.
15235 { # HttpRouteRuleMatch specifies a set of criteria for matching
15236 # requests to an HttpRouteRule. All specified criteria must
15237 # be satisfied for a match to occur.
15238 &quot;fullPathMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
15239 # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
15240 # that may be part of the original URL.
15241 #
15242 # fullPathMatch must be from 1 to 1024 characters.
15243 #
15244 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
15245 # specified.
15246 &quot;headerMatches&quot;: [ # Specifies a list of header match criteria, all of which must match
15247 # corresponding headers in the request.
15248 { # matchRule criteria for request header matches.
15249 &quot;exactMatch&quot;: &quot;A String&quot;, # The value should exactly match contents of exactMatch.
15250 #
15251 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
15252 &quot;headerName&quot;: &quot;A String&quot;, # The name of the HTTP header to match.
15253 #
15254 # For matching against the HTTP request&#x27;s authority, use a headerMatch
15255 # with the header name &quot;:authority&quot;.
15256 #
15257 # For matching a request&#x27;s method, use the headerName &quot;:method&quot;.
15258 #
15259 # When the URL map is bound to a target gRPC proxy that has
15260 # the validateForProxyless field set to true, only
15261 # non-binary
15262 # user-specified custom metadata and the `content-type` header are supported.
15263 # The following transport-level headers cannot be used in header matching
15264 # rules:
15265 # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
15266 # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
15267 # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
15268 # `grpc-timeout` and `grpc-trace-bin`.
15269 &quot;invertMatch&quot;: True or False, # If set to false, the headerMatch is considered a
15270 # match if the preceding match criteria are met. If set to true,
15271 # the headerMatch is considered a match if the preceding
15272 # match criteria are NOT met.
15273 #
15274 # The default setting is false.
15275 &quot;prefixMatch&quot;: &quot;A String&quot;, # The value of the header must start with the contents ofprefixMatch.
15276 #
15277 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
15278 &quot;presentMatch&quot;: True or False, # A header with the contents of headerName must exist. The
15279 # match takes place whether or not the request&#x27;s header has a value.
15280 #
15281 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
15282 &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
15283 # specified in rangeMatch. If the header does not contain an
15284 # integer, number or is empty, the match fails.
15285 #
15286 # For example for a range [-5, 0]
15287 #
15288 #
15289 # - -3 will match.
15290 # - 0 will not match.
15291 # - 0.25 will not match.
15292 # - -3someString will not match.
15293 #
15294 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
15295 #
15296 # rangeMatch is not supported for load balancers
15297 # that have loadBalancingScheme set to EXTERNAL.
15298 # within the specified integer range.
15299 &quot;rangeEnd&quot;: &quot;A String&quot;, # The end of the range (exclusive) in signed long integer format.
15300 &quot;rangeStart&quot;: &quot;A String&quot;, # The start of the range (inclusive) in signed long integer format.
15301 },
15302 &quot;regexMatch&quot;: &quot;A String&quot;, # The value of the header must match the regular expression specified inregexMatch.
15303 # For more information about regular expression syntax, see Syntax.
15304 #
15305 # For matching against a port specified in the HTTP request, use a
15306 # headerMatch with headerName set to PORT and a regular expression that
15307 # satisfies the RFC2616 Host header&#x27;s port specifier.
15308 #
15309 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
15310 #
15311 # Regular expressions can only be used when the loadBalancingScheme is
15312 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
15313 # (regional scope) or INTERNAL_MANAGED.
15314 &quot;suffixMatch&quot;: &quot;A String&quot;, # The value of the header must end with the contents ofsuffixMatch.
15315 #
15316 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
15317 },
15318 ],
15319 &quot;ignoreCase&quot;: True or False, # Specifies that prefixMatch and fullPathMatch
15320 # matches are case sensitive.
15321 #
15322 # The default value is false.
15323 #
15324 # ignoreCase must not be used with regexMatch.
15325 #
15326 # Not supported when the URL map is bound to a target gRPC proxy.
15327 &quot;metadataFilters&quot;: [ # Opaque filter criteria used by the load balancer to restrict routing
15328 # configuration to a limited set of xDS
15329 # compliant clients. In their xDS requests to the load balancer, xDS clients
15330 # present node
15331 # metadata. When there is a match, the relevant routing configuration
15332 # is made available to those proxies.
15333 #
15334 # 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
15335 # the metadata. If its filterMatchCriteria is set to
15336 # MATCH_ALL, then all of its filterLabels must match with
15337 # corresponding labels provided in the metadata. If multiple
15338 # metadata filters are specified, all of them need to be
15339 # satisfied in order to be considered a match.
15340 #
15341 # metadataFilters specified here is applied after those
15342 # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
15343 #
15344 # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
15345 #
15346 # Not supported when the URL map is bound to a target gRPC proxy that
15347 # has validateForProxyless field set to true.
15348 { # Opaque filter criteria used by load balancers to restrict routing
15349 # configuration to a limited set of load balancing proxies. Proxies and
15350 # sidecars involved in load balancing would typically present metadata to the
15351 # load balancers that need to match criteria specified here. If a match takes
15352 # place, the relevant configuration is made available to those
15353 # proxies.
15354 #
15355 # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
15356 # one of thefilterLabels must match the corresponding label provided in
15357 # the metadata. If its filterMatchCriteria is set to
15358 # MATCH_ALL, then all of its filterLabels must match with
15359 # corresponding labels provided in the metadata.
15360 #
15361 # An example for using metadataFilters would be: if
15362 # load balancing involves
15363 # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in of their XDS requests to loadbalancers.
15364 &quot;filterLabels&quot;: [ # The list of label value pairs that must match labels in the provided
15365 # metadata based on filterMatchCriteria
15366 #
15367 # This list must not be empty and can have at the most 64 entries.
15368 { # MetadataFilter label name value pairs that are expected
15369 # to match corresponding labels presented as metadata to the load balancer.
15370 &quot;name&quot;: &quot;A String&quot;, # Name of metadata label.
15371 #
15372 # The name can have a maximum length of 1024 characters and must be at
15373 # least 1 character long.
15374 &quot;value&quot;: &quot;A String&quot;, # The value of the label must match the specified value.
15375 #
15376 # value can have a maximum length of 1024 characters.
15377 },
15378 ],
15379 &quot;filterMatchCriteria&quot;: &quot;A String&quot;, # Specifies how individual filter label matches
15380 # within the list of filterLabels and contributes toward the
15381 # overall metadataFilter match.
15382 #
15383 # Supported values are:
15384 #
15385 # - MATCH_ANY: at least one of the filterLabels
15386 # must have a matching label in the provided metadata.
15387 # - MATCH_ALL: all filterLabels must have
15388 # matching labels in the provided metadata.
15389 },
15390 ],
15391 &quot;pathTemplateMatch&quot;: &quot;A String&quot;, # If specified, this field defines a path template pattern that must match
15392 # the :path header after the query string is removed.
15393 #
15394 # A path template pattern can include variables and wildcards.
15395 # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
15396 # matches a single path segment, and ** that matches zero or
15397 # more path segments. The pattern must follow these rules:
15398 #
15399 #
15400 # - The value must be between 1 and 1024 characters.
15401 # - The pattern must start with a leading slash (&quot;/&quot;).
15402 # - No more than 5 operators (variables or wildcards) may appear in
15403 # the pattern.
15404 #
15405 # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
15406 # set.
15407 &quot;prefixMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the request&#x27;s
15408 # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
15409 #
15410 # The value must be from 1 to 1024 characters.
15411 #
15412 # The * character inside a prefix match is
15413 # treated as a literal character, not as a wildcard.
15414 #
15415 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
15416 # used within a matchRule.
15417 &quot;queryParameterMatches&quot;: [ # Specifies a list of query parameter match criteria, all of which must
15418 # match corresponding query parameters in the request.
15419 #
15420 # Not supported when the URL map is bound to a target gRPC proxy.
15421 { # HttpRouteRuleMatch criteria for a request&#x27;s query parameter.
15422 &quot;exactMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
15423 # parameter exactly matches the contents of exactMatch.
15424 #
15425 # Only one of presentMatch, exactMatch, orregexMatch must be set.
15426 &quot;name&quot;: &quot;A String&quot;, # The name of the query parameter to match. The query parameter must exist in
15427 # the request, in the absence of which the request match fails.
15428 &quot;presentMatch&quot;: True or False, # Specifies that the queryParameterMatch matches if the
15429 # request contains the query parameter, irrespective of whether the
15430 # parameter has a value or not.
15431 #
15432 # Only one of presentMatch, exactMatch, orregexMatch must be set.
15433 &quot;regexMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
15434 # parameter matches the regular expression specified byregexMatch. For
15435 # more information about regular expression syntax, see Syntax.
15436 #
15437 # Only one of presentMatch, exactMatch, orregexMatch must be set.
15438 #
15439 # Regular expressions can only be used when the loadBalancingScheme is
15440 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
15441 # (regional scope) or INTERNAL_MANAGED.
15442 },
15443 ],
15444 &quot;regexMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
15445 # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
15446 # supplied with the original URL. For
15447 # more information about regular expression syntax, see Syntax.
15448 #
15449 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
15450 # specified.
15451 #
15452 # Regular expressions can only be used when the loadBalancingScheme is
15453 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
15454 # (regional scope) or INTERNAL_MANAGED.
15455 },
15456 ],
15457 &quot;priority&quot;: 42, # For routeRules within a given pathMatcher,
15458 # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
15459 # of priority, from the lowest to highest number. The priority of a
15460 # rule decreases as its number increases (1, 2, 3, N+1). The first rule
15461 # that matches the request is applied.
15462 #
15463 #
15464 # You cannot configure two or more routeRules with the same priority.
15465 # Priority for each rule must be set to a number from 0 to 2147483647
15466 # inclusive.
15467 #
15468 #
15469 # Priority numbers can have gaps, which enable you to add or remove rules
15470 # in the future without affecting the rest of the rules. For example, 1, 2,
15471 # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
15472 # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
15473 # without any impact on existing rules.
15474 &quot;routeAction&quot;: { # In response to a matching matchRule, the load balancer
15475 # performs advanced routing actions, such as URL rewrites and header
15476 # transformations, before forwarding the request to the selected backend.
15477 #
15478 #
15479 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
15480 #
15481 #
15482 # URL maps for classic Application Load Balancers only support
15483 # the urlRewrite action within a route rule&#x27;srouteAction.
15484 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
15485 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
15486 # property must be specified. This policy cannot be specified if any target
15487 # backend has Identity-Aware Proxy enabled.
15488 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
15489 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
15490 # header names can be specified. The cache is bypassed for all `cacheMode`
15491 # values.
15492 &quot;A String&quot;,
15493 ],
15494 &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
15495 # on the backend type: for Backend Services, the complete request URI is
15496 # used; for Backend Buckets, the request URI is used without the protocol or
15497 # host, and only query parameters known to Cloud Storage are included.
15498 # Policy defined on Route Action.
15499 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
15500 # parameters will be included. Either specify `excludedQueryParameters`
15501 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
15502 # encoded and not treated as delimiters.
15503 #
15504 # Note: This field applies to routes that use backend services. Attempting
15505 # to set it on a route that points exclusively to Backend Buckets will
15506 # result in a configuration error. For routes that point to a Backend
15507 # Bucket, use `includedQueryParameters` to define which parameters should
15508 # be part of the cache key.
15509 &quot;A String&quot;,
15510 ],
15511 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
15512 #
15513 # Note: This setting is only applicable to routes that use a Backend
15514 # Service. It does not affect requests served by a Backend Bucket, as the
15515 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
15516 # it on a route that points exclusively to Backend Buckets will result in a
15517 # configuration error.
15518 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
15519 #
15520 # Note: This setting is only applicable to routes that use a Backend
15521 # Service. It does not affect requests served by a Backend Bucket, as the
15522 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
15523 # set on a route that points exclusively to Backend Buckets will result in
15524 # a configuration error.
15525 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
15526 # `includedQueryParameters` and `excludedQueryParameters`. If neither
15527 # is set, the entire query string will be included. If false, the query
15528 # string will be excluded from the cache key entirely.
15529 #
15530 # Note: This field applies to routes that use backend services. Attempting
15531 # to set it on a route that points exclusively to Backend Buckets will
15532 # result in a configuration error. For routes that point to a Backend
15533 # Bucket, use `includedQueryParameters` to define which parameters should
15534 # be part of the cache key.
15535 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
15536 # The name=value pair will be used in the cache key Cloud CDN generates.
15537 #
15538 # Note: This setting is only applicable to routes that use a Backend
15539 # Service. It does not affect requests served by a Backend Bucket.
15540 # Attempting to set it on a route that points exclusively to Backend
15541 # Buckets will result in a configuration error. Up to 5 cookie names can be
15542 # specified.
15543 &quot;A String&quot;,
15544 ],
15545 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
15546 &quot;A String&quot;,
15547 ],
15548 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
15549 # parameters will be excluded. Either specify `includedQueryParameters`
15550 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
15551 # encoded and not treated as delimiters.
15552 &quot;A String&quot;,
15553 ],
15554 },
15555 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
15556 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
15557 &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
15558 # content. This is used to clamp the max-age (or Expires) value sent to the
15559 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
15560 # is used for the response max-age directive, along with a &quot;public&quot;
15561 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
15562 # clamps the max-age from the origin (if specified), or else sets the
15563 # response max-age directive to the lesser of the `clientTtl` and
15564 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
15565 # present. The maximum allowed value is 31,622,400s (1 year). If not
15566 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
15567 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
15568 # `USE_ORIGIN_HEADERS`.
15569 # as a count of seconds and fractions of seconds at nanosecond
15570 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15571 # or &quot;month&quot;. Range is approximately 10,000 years.
15572 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15573 # Durations less than one second are represented with a 0
15574 # `seconds` field and a positive `nanos` field. Must be from 0
15575 # to 999,999,999 inclusive.
15576 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15577 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15578 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15579 },
15580 &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
15581 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
15582 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
15583 # greater than that of `maxTtl`. When the `cacheMode` is set to
15584 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
15585 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
15586 # accessed objects may be evicted from the cache before the defined TTL. If
15587 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
15588 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
15589 # `USE_ORIGIN_HEADERS`.
15590 # as a count of seconds and fractions of seconds at nanosecond
15591 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15592 # or &quot;month&quot;. Range is approximately 10,000 years.
15593 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15594 # Durations less than one second are represented with a 0
15595 # `seconds` field and a positive `nanos` field. Must be from 0
15596 # to 999,999,999 inclusive.
15597 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15598 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15599 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15600 },
15601 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
15602 # attempt to set a max-age or s-maxage higher than this, or an Expires header
15603 # more than `maxTtl` seconds in the future will be capped at the value of
15604 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
15605 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
15606 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
15607 # Infrequently accessed objects may be evicted from the cache before the
15608 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
15609 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
15610 # mode.
15611 # as a count of seconds and fractions of seconds at nanosecond
15612 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15613 # or &quot;month&quot;. Range is approximately 10,000 years.
15614 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15615 # Durations less than one second are represented with a 0
15616 # `seconds` field and a positive `nanos` field. Must be from 0
15617 # to 999,999,999 inclusive.
15618 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15619 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15620 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15621 },
15622 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
15623 # to apply fine-grained caching for common errors or redirects.
15624 # This can reduce the load on your origin and improve end-user
15625 # experience by reducing response latency.
15626 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
15627 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
15628 # the specified response code that lack any Cache-Control, Expires, or
15629 # Pragma: no-cache directives. When the `cacheMode` is set to
15630 # `FORCE_CACHE_ALL`, negative caching applies to all responses
15631 # with the specified response code, and overrides any caching headers. By
15632 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
15633 #
15634 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
15635 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
15636 # * 405 (Method Not Found), 501 (Not Implemented): 60s
15637 #
15638 # These defaults can be overridden in `negativeCachingPolicy`.
15639 # If not specified, Cloud CDN applies negative caching by default.
15640 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
15641 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
15642 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
15643 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
15644 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
15645 # all response codes that you wish to cache. Cloud CDN will not apply any
15646 # default negative caching when a policy exists.
15647 { # Specify CDN TTLs for response error codes.
15648 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
15649 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
15650 # specified as values, and you cannot specify a status code more than
15651 # once.
15652 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
15653 # corresponding status code.
15654 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
15655 # objects may be evicted from the cache before the defined TTL.
15656 # as a count of seconds and fractions of seconds at nanosecond
15657 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15658 # or &quot;month&quot;. Range is approximately 10,000 years.
15659 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15660 # Durations less than one second are represented with a 0
15661 # `seconds` field and a positive `nanos` field. Must be from 0
15662 # to 999,999,999 inclusive.
15663 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15664 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15665 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15666 },
15667 },
15668 ],
15669 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
15670 # requests into a small number of requests to the origin. If not specified,
15671 # Cloud CDN applies request coalescing by default.
15672 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
15673 # content with the origin, or when an error is encountered when refreshing
15674 # the cache.
15675 # This setting defines the default &quot;max-stale&quot; duration for any cached
15676 # responses that do not specify a max-stale directive. Stale responses that
15677 # exceed the TTL configured here will not be served. The default limit
15678 # (max-stale) is 86400s (1 day), which will allow stale content to be
15679 # served up to this limit beyond the max-age (or s-maxage) of a cached
15680 # response.
15681 # The maximum allowed value is 604800 (1 week).
15682 # Set this to zero (0) to disable serve-while-stale.
15683 # as a count of seconds and fractions of seconds at nanosecond
15684 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15685 # or &quot;month&quot;. Range is approximately 10,000 years.
15686 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15687 # Durations less than one second are represented with a 0
15688 # `seconds` field and a positive `nanos` field. Must be from 0
15689 # to 999,999,999 inclusive.
15690 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15691 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15692 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15693 },
15694 },
15695 &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
15696 # information about the W3C recommendation for cross-origin resource sharing
15697 # (CORS), see Fetch API Living
15698 # Standard.
15699 #
15700 # Not supported when the URL map is bound to a target gRPC proxy.
15701 # information about the W3C recommendation for cross-origin resource sharing
15702 # (CORS), see Fetch API Living
15703 # Standard.
15704 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
15705 # indicates that
15706 # the actual request can include user credentials. This field translates to
15707 # the Access-Control-Allow-Credentials header.
15708 #
15709 # Default is false.
15710 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
15711 # header.
15712 &quot;A String&quot;,
15713 ],
15714 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
15715 # header.
15716 &quot;A String&quot;,
15717 ],
15718 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
15719 # more information, see regular expression syntax.
15720 #
15721 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
15722 #
15723 # Regular expressions can only be used when the loadBalancingScheme is
15724 # set to INTERNAL_SELF_MANAGED.
15725 &quot;A String&quot;,
15726 ],
15727 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
15728 #
15729 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
15730 &quot;A String&quot;,
15731 ],
15732 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
15733 # The default value is false, which indicates that the CORS
15734 # policy is in effect.
15735 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
15736 # header.
15737 &quot;A String&quot;,
15738 ],
15739 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
15740 # seconds. This field translates to the Access-Control-Max-Age
15741 # header.
15742 },
15743 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
15744 # the resiliency of clients to backend service failure. As part of fault
15745 # injection, when clients send requests to a backend service, delays can be
15746 # introduced by a load balancer on a percentage of requests before sending
15747 # those requests to the backend service. Similarly requests from clients can
15748 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
15749 # that are configured with a fault_injection_policy if:
15750 # 1. The traffic is generated by fault injection AND
15751 # 2. The fault injection is not a delay fault injection.
15752 # Fault injection is not supported with the classic Application Load Balancer
15753 # . To see which load balancers support fault injection,
15754 # see Load
15755 # balancing: Routing and traffic management features.
15756 # the resiliency of clients to backend service failure. As part of fault
15757 # injection, when clients send requests to a backend service, delays can be
15758 # introduced by the load balancer on a percentage of requests before sending
15759 # those request to the backend service. Similarly requests from clients can be
15760 # aborted by the load balancer for a percentage of requests.
15761 &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
15762 # injection.
15763 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
15764 #
15765 # The value must be from 200 to 599 inclusive.
15766 #
15767 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
15768 # according to this
15769 # mapping table. HTTP status 200 is mapped to gRPC status
15770 # UNKNOWN. Injecting an OK status is currently not supported by
15771 # Traffic Director.
15772 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
15773 # that is aborted as part of fault injection.
15774 #
15775 # The value must be from 0.0 to 100.0 inclusive.
15776 },
15777 &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
15778 # injection, before being sent to a backend service.
15779 # request to the backend service as part of fault injection.
15780 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
15781 # as a count of seconds and fractions of seconds at nanosecond
15782 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15783 # or &quot;month&quot;. Range is approximately 10,000 years.
15784 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15785 # Durations less than one second are represented with a 0
15786 # `seconds` field and a positive `nanos` field. Must be from 0
15787 # to 999,999,999 inclusive.
15788 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15789 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15790 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15791 },
15792 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
15793 # which a delay is introduced as part of fault injection.
15794 #
15795 # The value must be from 0.0 to 100.0 inclusive.
15796 },
15797 },
15798 &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
15799 # Global EXTERNAL_MANAGED load balancer schemes.
15800 # Either Cloud CDN must be enabled on the backend service or backend bucket
15801 # serving the route, or cache policy must be configured on the same route
15802 # dynamically processes and delivers images from the network edge.
15803 # Image Optimization is only available for Global External Application Load
15804 # Balancers.
15805 # Either Cloud CDN must be enabled on the backend service or backend bucket
15806 # serving the route, or cache policy must be configured on the same route.
15807 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
15808 },
15809 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
15810 # Unlike the timeout field where the timeout duration starts
15811 # from the time the request has been fully processed (known as*end-of-stream*),
15812 # the duration in this field is computed from the beginning of the stream
15813 # until the response has been processed, including all retries. A
15814 # stream that does not complete in this duration is closed.
15815 #
15816 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
15817 # with the route.
15818 #
15819 # This field is only allowed if the Url map is used with backend services
15820 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
15821 # as a count of seconds and fractions of seconds at nanosecond
15822 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15823 # or &quot;month&quot;. Range is approximately 10,000 years.
15824 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15825 # Durations less than one second are represented with a 0
15826 # `seconds` field and a positive `nanos` field. Must be from 0
15827 # to 999,999,999 inclusive.
15828 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15829 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15830 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15831 },
15832 &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
15833 # are shadowed to a separate mirrored backend service. The load balancer does
15834 # not wait for responses from the shadow service. Before sending traffic
15835 # to the shadow service, the host / authority header is suffixed with-shadow.
15836 #
15837 # Not supported when the URL map is bound to a target gRPC proxy that
15838 # has the validateForProxyless field set to true.
15839 # are shadowed to a separate mirrored backend service. The load balancer
15840 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
15841 # to the shadow service, the host or authority header is suffixed with-shadow.
15842 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
15843 # mirrored to.
15844 #
15845 # The backend service configured for a mirroring
15846 # policy must reference backends that are of the same type as the original
15847 # backend service matched in the URL map.
15848 #
15849 # Serverless NEG backends are not currently supported as a mirrored
15850 # backend service.
15851 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
15852 },
15853 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
15854 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
15855 # If not specified, defaults to 1.
15856 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
15857 #
15858 # If not specified, will use the timeout set in theHttpRouteAction field.
15859 # If timeout in the HttpRouteAction field is not set, this field
15860 # uses the largest timeout
15861 # among all backend services associated with the route.
15862 #
15863 # Not supported when the URL map is bound to a target gRPC proxy that
15864 # has the validateForProxyless field set to true.
15865 # as a count of seconds and fractions of seconds at nanosecond
15866 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15867 # or &quot;month&quot;. Range is approximately 10,000 years.
15868 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15869 # Durations less than one second are represented with a 0
15870 # `seconds` field and a positive `nanos` field. Must be from 0
15871 # to 999,999,999 inclusive.
15872 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15873 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15874 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15875 },
15876 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
15877 # values are:
15878 #
15879 # - 5xx: retry is attempted if the instance or endpoint
15880 # responds with any 5xx response code, or if the instance or
15881 # endpoint does not respond at all. For example, disconnects, reset, read
15882 # timeout, connection failure, and refused streams.
15883 # - gateway-error: Similar to 5xx, but only
15884 # applies to response codes 502, 503 or504.
15885 # - connect-failure: a retry is attempted on failures
15886 # connecting to the instance or endpoint. For example, connection
15887 # timeouts.
15888 # - retriable-4xx: a retry is attempted if the instance
15889 # or endpoint responds with a 4xx response code.
15890 # The only error that you can retry is error code 409.
15891 # - refused-stream: a retry is attempted if the instance
15892 # or endpoint resets the stream with a REFUSED_STREAM error
15893 # code. This reset type indicates that it is safe to retry.
15894 # - cancelled: a retry is attempted if the gRPC status
15895 # code in the response header is set to cancelled.
15896 # - deadline-exceeded: a retry is attempted if the gRPC
15897 # status code in the response header is set todeadline-exceeded.
15898 # - internal: a retry is attempted if the gRPC
15899 # status code in the response header is set tointernal.
15900 # - resource-exhausted: a retry is attempted if the gRPC
15901 # status code in the response header is set toresource-exhausted.
15902 # - unavailable: a retry is attempted if the gRPC
15903 # status code in the response header is set tounavailable.
15904 #
15905 # Only the following codes are supported when the URL map is bound to
15906 # target gRPC proxy that has validateForProxyless field set to true.
15907 #
15908 # - cancelled
15909 # - deadline-exceeded
15910 # - internal
15911 # - resource-exhausted
15912 # - unavailable
15913 &quot;A String&quot;,
15914 ],
15915 },
15916 &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
15917 # time the request has been fully processed (known as *end-of-stream*)
15918 # up until the response has been processed. Timeout includes
15919 # all retries.
15920 #
15921 # If not specified, this field uses the largest timeout among all backend
15922 # services associated with the route.
15923 #
15924 # Not supported when the URL map is bound to a target gRPC proxy that
15925 # has validateForProxyless field set to true.
15926 # as a count of seconds and fractions of seconds at nanosecond
15927 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15928 # or &quot;month&quot;. Range is approximately 10,000 years.
15929 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15930 # Durations less than one second are represented with a 0
15931 # `seconds` field and a positive `nanos` field. Must be from 0
15932 # to 999,999,999 inclusive.
15933 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15934 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15935 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15936 },
15937 &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
15938 # to the matched service.
15939 #
15940 # urlRewrite is the only action supported in UrlMaps
15941 # for classic Application Load Balancers.
15942 #
15943 # Not supported when the URL map is bound to a target gRPC proxy that
15944 # has the validateForProxyless field set to true.
15945 # backend service.
15946 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
15947 # host header is replaced with contents of hostRewrite.
15948 #
15949 # The value must be from 1 to 255 characters.
15950 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
15951 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
15952 #
15953 # The value must be from 1 to 1024 characters.
15954 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
15955 # header) using the HTTP template syntax.
15956 #
15957 # A corresponding
15958 # path_template_match must be specified. Any template variables must exist in
15959 # the path_template_match field.
15960 #
15961 #
15962 # - -At least one variable must be specified in the path_template_match
15963 # field
15964 # - You can omit variables from the rewritten URL
15965 # - The * and ** operators cannot be matched
15966 # unless they have a corresponding variable name - e.g.
15967 # {format=*} or {var=**}.
15968 #
15969 # For example, a path_template_match of /static/{format=**}
15970 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
15971 # rewrite, so that /{country}/{format}/{suffix=**} can be
15972 # rewritten as /content/{format}/{country}/{suffix}.
15973 #
15974 # At least
15975 # one non-empty routeRules[].matchRules[].path_template_match is
15976 # required.
15977 #
15978 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
15979 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
15980 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
15981 # It uses RE2 syntax with the following constraints:
15982 #
15983 #
15984 # - Any single character operators
15985 # - Groups are allowed to have only submatch operator inside
15986 # - Groups are allowed only without any char repetition, e.g.
15987 # .*
15988 # - Any char repetition, e.g. .*, is
15989 # only allowed to be used in a single regex together with:
15990 #
15991 #
15992 # - Empty string operators
15993 # - Other repetitions
15994 # - Ranges
15995 # - Repetitions of ranges
15996 #
15997 #
15998 # - Ranges are only allowed to have:
15999 #
16000 #
16001 # - Character range
16002 # - Digits range
16003 # - Symbols listed in characters allowed for ranges
16004 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
16005 # the path.
16006 },
16007 },
16008 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
16009 # occurs. The weights determine the fraction of traffic that flows to
16010 # their corresponding backend service. If all traffic needs to
16011 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
16012 #
16013 # After a backend service is identified and before forwarding
16014 # the request to
16015 # the backend service, advanced routing actions such as URL rewrites and
16016 # header transformations are applied depending on additional settings
16017 # specified in this HttpRouteAction.
16018 { # In contrast to a single BackendService in
16019 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
16020 # multiple backend services. The volume of traffic for each
16021 # backend service is proportional to the weight specified
16022 # in each WeightedBackendService
16023 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
16024 # resource. Before
16025 # forwarding the request to backendService, the load balancer
16026 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
16027 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
16028 # effect for the selected backendService.
16029 #
16030 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
16031 #
16032 # headerAction is not supported for load balancers that have
16033 # their loadBalancingScheme set to EXTERNAL.
16034 #
16035 # Not supported when the URL map is bound to a target gRPC proxy that
16036 # has validateForProxyless field set to true.
16037 # the request is passed along to the selected backendService.
16038 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
16039 { # Specification determining how headers are added to requests or responses.
16040 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
16041 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
16042 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
16043 # that already
16044 # exist for the header. If true, headerValue is set for the
16045 # header, discarding any values that were set for that header.
16046 #
16047 # The default value is true,
16048 # unless a variable is present in headerValue,
16049 # in which case the default value is false.
16050 # .
16051 },
16052 ],
16053 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
16054 # request before forwarding the request to the backendService.
16055 &quot;A String&quot;,
16056 ],
16057 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
16058 # client.
16059 { # Specification determining how headers are added to requests or responses.
16060 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
16061 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
16062 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
16063 # that already
16064 # exist for the header. If true, headerValue is set for the
16065 # header, discarding any values that were set for that header.
16066 #
16067 # The default value is true,
16068 # unless a variable is present in headerValue,
16069 # in which case the default value is false.
16070 # .
16071 },
16072 ],
16073 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
16074 # response before sending the response back to the client.
16075 &quot;A String&quot;,
16076 ],
16077 },
16078 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
16079 # computed asweight / (sum of all weightedBackendService weights in routeAction).
16080 #
16081 # The selection of a backend service is determined only for new traffic.
16082 # Once a user&#x27;s request has been directed to a backend service,
16083 # subsequent requests are sent to the same backend service as
16084 # determined by the backend service&#x27;s session affinity policy.
16085 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
16086 # splitting. If you do, the weighted traffic splitting configuration takes
16087 # precedence.
16088 #
16089 # The value must be from 0 to 1000.
16090 },
16091 ],
16092 },
16093 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
16094 # is directed if this rule is matched. If routeAction is
16095 # also specified, advanced routing actions, such as URL rewrites,
16096 # take effect before sending the request to the backend.
16097 #
16098 #
16099 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
16100 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
16101 # specified by urlRedirect.
16102 #
16103 #
16104 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
16105 #
16106 #
16107 # Not supported when the URL map is bound to a target gRPC proxy.
16108 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
16109 # was supplied in the request.
16110 #
16111 # The value must be from 1 to 255
16112 # characters.
16113 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
16114 # set to HTTPS.
16115 # If set to false, the URL scheme of the redirected request
16116 # remains the same as that of the request.
16117 #
16118 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
16119 #
16120 # The default is set to false.
16121 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
16122 # that was supplied in the request.
16123 #
16124 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
16125 # supplied, the path of the original request is used for the redirect.
16126 #
16127 # The value must be from 1 to 1024 characters.
16128 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
16129 # the HttpRouteRuleMatch, retaining the remaining portion
16130 # of the URL before redirecting the request.
16131 #
16132 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
16133 # supplied, the path of the original request is used for the redirect.
16134 #
16135 # The value must be from 1 to 1024 characters.
16136 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
16137 #
16138 # Supported values are:
16139 #
16140 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
16141 # to 301.
16142 # - FOUND, which corresponds to 302.
16143 # - SEE_OTHER which corresponds to 303.
16144 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
16145 # method is retained.
16146 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
16147 # method is retained.
16148 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
16149 # URL is
16150 # removed before redirecting the request. If set to false, the
16151 # query portion of the original URL is retained.
16152 #
16153 # The default is set to false.
16154 },
16155 },
16156 ],
16157 },
16158 ],
16159 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the regional URL map resides.
16160 # This field is not applicable to global URL maps.
16161 # You must specify this field as part of the HTTP request URL. It is
16162 # not settable as a field in the request body.
16163 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
16164 &quot;status&quot;: { # [Output Only] The status of the URL map. # Output only. [Output Only] The status of the URL map.
16165 &quot;quotaUsage&quot;: { # Message representing the quota usage for a UrlMap. # Output only. Summary of quota usage for given UrlMap.
16166 &quot;forwardingRules&quot;: 42, # Output only. The number of forwarding rules that uses this UrlMap.
16167 &quot;units&quot;: &quot;A String&quot;, # Output only. The number of quota units calculated for this UrlMap.
16168 },
16169 },
16170 &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
16171 # maximum of 100 tests per UrlMap.
16172 #
16173 # Not supported when the URL map is bound to a target gRPC proxy that
16174 # has validateForProxyless field set to true.
16175 { # Message for the expected URL mappings.
16176 &quot;backendServiceWeight&quot;: 42, # The weight to use for the supplied host and path when using advanced
16177 # routing rules that involve traffic splitting.
16178 &quot;description&quot;: &quot;A String&quot;, # Description of this test case.
16179 &quot;expectedOutputUrl&quot;: &quot;A String&quot;, # The expected output URL evaluated by the load balancer
16180 # containing the scheme, host, path and query parameters.
16181 #
16182 # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
16183 # the load balancer to backends. For rules with urlRewrite,
16184 # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
16185 #
16186 # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer&#x27;s
16187 # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
16188 # If urlRedirect specifies strip_query, the test
16189 # passes only if expectedOutputUrl does not contain any query
16190 # parameters.
16191 #
16192 # expectedOutputUrl is optional whenservice is specified.
16193 &quot;expectedRedirectResponseCode&quot;: 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
16194 # load balancer&#x27;s redirect response.
16195 #
16196 # expectedRedirectResponseCode cannot be set whenservice is set.
16197 &quot;expectedUrlRedirect&quot;: &quot;A String&quot;, # The expected URL that should be redirected to for the host and path
16198 # being tested.
16199 # [Deprecated] This field is deprecated.
16200 # Use expected_output_url instead.
16201 &quot;headers&quot;: [ # HTTP headers for this request. If headers contains
16202 # a host header, then host must also match the header value.
16203 { # HTTP headers used in UrlMapTests.
16204 &quot;name&quot;: &quot;A String&quot;, # Header name.
16205 &quot;value&quot;: &quot;A String&quot;, # Header value.
16206 },
16207 ],
16208 &quot;host&quot;: &quot;A String&quot;, # Host portion of the URL. If headers contains a host header,
16209 # then host must also match the header value.
16210 &quot;path&quot;: &quot;A String&quot;, # Path portion of the URL.
16211 &quot;service&quot;: &quot;A String&quot;, # Expected BackendService or BackendBucket resource
16212 # the given URL should be mapped to.
16213 #
16214 # The service field cannot
16215 # be set if expectedRedirectResponseCode is set.
16216 },
16217 ],
16218 }
16219
16220 requestId: string, begin_interface: MixerMutationRequestBuilder
16221 Request ID to support idempotency.
16222 x__xgafv: string, V1 error format.
16223 Allowed values
16224 1 - v1 error format
16225 2 - v2 error format
16226
16227 Returns:
16228 An object of the form:
16229
16230 { # Represents an Operation resource.
16231 #
16232 # Google Compute Engine has three Operation resources:
16233 #
16234 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
16235 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
16236 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
16237 #
16238 # You can use an operation resource to manage asynchronous API requests.
16239 # For more information, readHandling
16240 # API responses.
16241 #
16242 # Operations can be global, regional or zonal.
16243 #
16244 # - For global operations, use the `globalOperations`
16245 # resource.
16246 # - For regional operations, use the
16247 # `regionOperations` resource.
16248 # - For zonal operations, use
16249 # the `zoneOperations` resource.
16250 #
16251 #
16252 #
16253 # For more information, read
16254 # Global, Regional, and Zonal Resources.
16255 #
16256 # Note that completed Operation resources have a limited
16257 # retention period.
16258 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
16259 # Not present otherwise.
16260 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
16261 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
16262 # set when the operation is created.
16263 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
16264 # text format.
16265 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
16266 # this field will be populated.
16267 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
16268 # operation.
16269 {
16270 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
16271 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
16272 # details. There is a set of defined message types to use for providing
16273 # details.The syntax depends on the error code. For example,
16274 # QuotaExceededInfo will have details when the error code is
16275 # QUOTA_EXCEEDED.
16276 {
16277 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
16278 #
16279 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
16280 # is not enabled:
16281 #
16282 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
16283 # &quot;domain&quot;: &quot;googleapis.com&quot;
16284 # &quot;metadata&quot;: {
16285 # &quot;resource&quot;: &quot;projects/123&quot;,
16286 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
16287 # }
16288 # }
16289 #
16290 # This response indicates that the pubsub.googleapis.com API is not enabled.
16291 #
16292 # Example of an error that is returned when attempting to create a Spanner
16293 # instance in a region that is out of stock:
16294 #
16295 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
16296 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
16297 # &quot;metadata&quot;: {
16298 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
16299 # }
16300 # }
16301 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
16302 # is typically the registered service name of the tool or product that
16303 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
16304 # generated by some common infrastructure, the error domain must be a
16305 # globally unique value that identifies the infrastructure. For Google API
16306 # infrastructure, the error domain is &quot;googleapis.com&quot;.
16307 &quot;metadatas&quot;: { # Additional structured details about this error.
16308 #
16309 # Keys must match a regular expression of `a-z+` but should
16310 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
16311 # length. When identifying the current value of an exceeded limit, the units
16312 # should be contained in the key, not the value. For example, rather than
16313 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
16314 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
16315 # instances that can be created in a single (batch) request.
16316 &quot;a_key&quot;: &quot;A String&quot;,
16317 },
16318 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
16319 # proximate cause of the error. Error reasons are unique within a particular
16320 # domain of errors. This should be at most 63 characters and match a
16321 # regular expression of `A-Z+[A-Z0-9]`, which represents
16322 # UPPER_SNAKE_CASE.
16323 },
16324 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
16325 #
16326 # For example, if a quota check failed with an error indicating the calling
16327 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
16328 # directly to the right place in the developer console to flip the bit.
16329 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
16330 { # Describes a URL link.
16331 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
16332 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
16333 },
16334 ],
16335 },
16336 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
16337 # which can be attached to an RPC error.
16338 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
16339 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
16340 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
16341 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
16342 },
16343 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
16344 &quot;dimensions&quot;: { # The map holding related quota dimensions.
16345 &quot;a_key&quot;: &quot;A String&quot;,
16346 },
16347 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
16348 # type or metric.
16349 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
16350 # or metric.
16351 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
16352 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
16353 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
16354 },
16355 },
16356 ],
16357 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
16358 # This property is optional.
16359 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
16360 },
16361 ],
16362 },
16363 &quot;getVersionOperationMetadata&quot;: {
16364 &quot;inlineSbomInfo&quot;: {
16365 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
16366 # appropriate identifiers.
16367 &quot;a_key&quot;: &quot;A String&quot;,
16368 },
16369 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
16370 # identifiers.
16371 &quot;a_key&quot;: &quot;A String&quot;,
16372 },
16373 },
16374 },
16375 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
16376 # message that was returned, such as `NOT FOUND`.
16377 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
16378 # status code that was returned. For example, a `404` means the
16379 # resource was not found.
16380 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
16381 # defined by the server.
16382 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
16383 # This value is inRFC3339
16384 # text format.
16385 &quot;instancesBulkInsertOperationMetadata&quot;: {
16386 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
16387 # Example key: zones/us-central1-a
16388 &quot;a_key&quot;: {
16389 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
16390 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
16391 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
16392 # error.
16393 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
16394 # if the flow is rolling forward or rolling back.
16395 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
16396 },
16397 },
16398 },
16399 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
16400 # Operation resources.
16401 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
16402 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
16403 # group of operations results from a `bulkInsert` API request.
16404 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
16405 # `update`, or `delete`, and so on.
16406 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
16407 # There is no requirement that this be linear or support any granularity of
16408 # operations. This should not be used to guess when the operation will be
16409 # complete. This number should monotonically increase as the operation
16410 # progresses.
16411 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
16412 # applicable when performing regional operations.
16413 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
16414 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
16415 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
16416 # this field will contain information on all underlying zonal actions and
16417 # their state.
16418 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
16419 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
16420 # Example key: zones/us-central1-a
16421 &quot;a_key&quot;: {
16422 &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
16423 # populated.
16424 # different programming environments, including REST APIs and RPC APIs. It is
16425 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
16426 # three pieces of data: error code, error message, and error details.
16427 #
16428 # You can find out more about this error model and how to work with it in the
16429 # [API Design Guide](https://cloud.google.com/apis/design/errors).
16430 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
16431 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
16432 # message types for APIs to use.
16433 {
16434 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
16435 },
16436 ],
16437 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
16438 # user-facing error message should be localized and sent in the
16439 # google.rpc.Status.details field, or localized by the client.
16440 },
16441 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
16442 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
16443 },
16444 },
16445 },
16446 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
16447 # This value is inRFC3339
16448 # text format.
16449 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
16450 # following:
16451 # `PENDING`, `RUNNING`, or `DONE`.
16452 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
16453 # operation.
16454 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
16455 # of the target resource.
16456 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
16457 # operations related to creating a snapshot, this points to the disk
16458 # that the snapshot was created from.
16459 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
16460 # `[email protected]` or
16461 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
16462 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
16463 # operation, this field will be populated.
16464 {
16465 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
16466 # Engine returns NO_RESULTS_ON_PAGE if there
16467 # are no results in the response.
16468 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
16469 # value format. For example:
16470 #
16471 # &quot;data&quot;: [
16472 # {
16473 # &quot;key&quot;: &quot;scope&quot;,
16474 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
16475 # }
16476 {
16477 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
16478 # returned. For example, for warnings where there are no results in a list
16479 # request for a particular zone, this key might be scope and
16480 # the key value might be the zone name. Other examples might be a key
16481 # indicating a deprecated resource and a suggested replacement, or a
16482 # warning about invalid network settings (for example, if an instance
16483 # attempts to perform IP forwarding but is not enabled for IP forwarding).
16484 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
16485 },
16486 ],
16487 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
16488 },
16489 ],
16490 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
16491 # applicable when performing per-zone operations.
16492 }</pre>
16493 </div>
16494
16495 <div class="method">
16496 <code class="details" id="testIamPermissions">testIamPermissions(project, region, resource, body=None, x__xgafv=None)</code>
16497 <pre>Returns permissions that a caller has on the specified resource.
16498
16499 Args:
16500 project: string, Project ID for this request. (required)
16501 region: string, The name of the region for this request. (required)
16502 resource: string, Name or id of the resource for this request. (required)
16503 body: object, The request body.
16504 The object takes the form of:
16505
16506 {
16507 &quot;permissions&quot;: [ # The set of permissions to check for the &#x27;resource&#x27;. Permissions with
16508 # wildcards (such as &#x27;*&#x27; or &#x27;storage.*&#x27;) are not allowed.
16509 &quot;A String&quot;,
16510 ],
16511 }
16512
16513 x__xgafv: string, V1 error format.
16514 Allowed values
16515 1 - v1 error format
16516 2 - v2 error format
16517
16518 Returns:
16519 An object of the form:
16520
16521 {
16522 &quot;permissions&quot;: [ # A subset of `TestPermissionsRequest.permissions` that the caller is
16523 # allowed.
16524 &quot;A String&quot;,
16525 ],
16526 }</pre>
16527 </div>
16528
16529 <div class="method">
16530 <code class="details" id="update">update(project, region, urlMap, body=None, requestId=None, x__xgafv=None)</code>
16531 <pre>Updates the specified UrlMap resource with the data included in the
16532 request.
16533
16534 Args:
16535 project: string, Project ID for this request. (required)
16536 region: string, Name of the region scoping this request. (required)
16537 urlMap: string, Name of the UrlMap resource to update. (required)
16538 body: object, The request body.
16539 The object takes the form of:
16540
16541 { # Represents a URL Map resource.
16542 #
16543 # Compute Engine has two URL Map resources:
16544 #
16545 # * [Global](/compute/docs/reference/rest/alpha/urlMaps)
16546 # * [Regional](/compute/docs/reference/rest/alpha/regionUrlMaps)
16547 #
16548 # A URL map resource is a component of certain types of cloud load balancers
16549 # and Traffic Director:
16550 #
16551 # * urlMaps are used by global external Application Load
16552 # Balancers, classic Application Load Balancers, and cross-region internal
16553 # Application Load Balancers.
16554 # * regionUrlMaps are used by internal Application Load Balancers,
16555 # regional external Application Load Balancers and regional internal
16556 # Application Load Balancers.
16557 #
16558 # For a list of supported URL map features by the load balancer type, see the
16559 # Load balancing features: Routing and traffic management table.
16560 #
16561 # For a list of supported URL map features for Traffic Director, see the
16562 # Traffic Director features: Routing and traffic management table.
16563 #
16564 # This resource defines mappings from hostnames and URL paths to either a
16565 # backend service or a backend bucket.
16566 #
16567 # To use the global urlMaps resource, the backend service must
16568 # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
16569 # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
16570 # information, read URL
16571 # Map Concepts.
16572 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
16573 # text format.
16574 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
16575 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
16576 #
16577 # This policy takes
16578 # effect at the load balancer level and applies only when no policy has been
16579 # defined for the error code at lower levels like PathMatcher, RouteRule and
16580 # PathRule within this UrlMap.
16581 #
16582 # For example, consider a UrlMap with the
16583 # following configuration:
16584 #
16585 #
16586 # - defaultCustomErrorResponsePolicy containing policies for
16587 # responding to 5xx and 4xx errors
16588 # - A PathMatcher configured for *.example.com has
16589 # defaultCustomErrorResponsePolicy for 4xx.
16590 #
16591 # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
16592 # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
16593 # a request that does not match any host in *.example.com such
16594 # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
16595 # takes effect.
16596 #
16597 # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
16598 # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
16599 # a retry, if load balancer is successful in reaching the
16600 # service, the defaultCustomErrorResponsePolicy is ignored and
16601 # the response from the service is returned to the client.
16602 #
16603 # defaultCustomErrorResponsePolicy is supported only for
16604 # global external Application Load Balancers.
16605 # backend service or backend bucket responds with an error.
16606 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
16607 #
16608 # In a given policy, if you specify rules for both a range of error codes
16609 # as well as rules for specific error codes then rules with specific error
16610 # codes have a higher priority. For example, assume that you configure a rule
16611 # for 401 (Un-authorized) code, and another for all 4 series
16612 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
16613 # However if the backend service returns a 403, the rule for4xx takes effect.
16614 { # Specifies the mapping between the response code that will be returned along
16615 # with the custom error content and the response code returned by the backend
16616 # service.
16617 &quot;matchResponseCodes&quot;: [ # Valid values include:
16618 #
16619 #
16620 # - A number between 400 and 599: For example
16621 # 401 or 503, in which case the load balancer
16622 # applies the policy if the error code exactly matches this value.
16623 # - 5xx: Load Balancer will apply the policy if the
16624 # backend service responds with any response code in the range of
16625 # 500 to 599.
16626 # - 4xx: Load
16627 # Balancer will apply the policy if the backend service responds with any
16628 # response code in the range of 400 to
16629 # 499.
16630 #
16631 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
16632 &quot;A String&quot;,
16633 ],
16634 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
16635 # error content. If overrideResponseCode is not supplied, the
16636 # same response code returned by the original backend bucket or backend
16637 # service is returned to the client.
16638 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
16639 #
16640 # path must start
16641 # with a leading slash. path cannot have trailing slashes.
16642 #
16643 # If the file is not available in backendBucket or the
16644 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
16645 #
16646 # The value must
16647 # be from 1 to 1024 characters
16648 },
16649 ],
16650 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
16651 # contains the custom error content. Examples are:
16652 #
16653 #
16654 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
16655 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
16656 # - global/backendBuckets/myBackendBucket
16657 #
16658 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
16659 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
16660 #
16661 # If load balancer cannot reach
16662 # the backendBucket, a simple Not Found Error will
16663 # be returned, with the original response code (oroverrideResponseCode if configured).
16664 #
16665 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
16666 },
16667 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
16668 # hostRules match. The load balancer performs advanced routing
16669 # actions, such as URL rewrites and header transformations, before forwarding
16670 # the request to the selected backend.
16671 #
16672 #
16673 # Only one of defaultUrlRedirect, defaultService
16674 # or defaultRouteAction.weightedBackendService can be set.
16675 #
16676 #
16677 # URL maps for classic Application Load Balancers only support
16678 # the urlRewrite action within defaultRouteAction.
16679 #
16680 #
16681 # defaultRouteAction has no effect when the URL map is bound
16682 # to a target gRPC proxy that has the validateForProxyless field
16683 # set to true.
16684 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
16685 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
16686 # property must be specified. This policy cannot be specified if any target
16687 # backend has Identity-Aware Proxy enabled.
16688 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
16689 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
16690 # header names can be specified. The cache is bypassed for all `cacheMode`
16691 # values.
16692 &quot;A String&quot;,
16693 ],
16694 &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
16695 # on the backend type: for Backend Services, the complete request URI is
16696 # used; for Backend Buckets, the request URI is used without the protocol or
16697 # host, and only query parameters known to Cloud Storage are included.
16698 # Policy defined on Route Action.
16699 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
16700 # parameters will be included. Either specify `excludedQueryParameters`
16701 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
16702 # encoded and not treated as delimiters.
16703 #
16704 # Note: This field applies to routes that use backend services. Attempting
16705 # to set it on a route that points exclusively to Backend Buckets will
16706 # result in a configuration error. For routes that point to a Backend
16707 # Bucket, use `includedQueryParameters` to define which parameters should
16708 # be part of the cache key.
16709 &quot;A String&quot;,
16710 ],
16711 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
16712 #
16713 # Note: This setting is only applicable to routes that use a Backend
16714 # Service. It does not affect requests served by a Backend Bucket, as the
16715 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
16716 # it on a route that points exclusively to Backend Buckets will result in a
16717 # configuration error.
16718 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
16719 #
16720 # Note: This setting is only applicable to routes that use a Backend
16721 # Service. It does not affect requests served by a Backend Bucket, as the
16722 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
16723 # set on a route that points exclusively to Backend Buckets will result in
16724 # a configuration error.
16725 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
16726 # `includedQueryParameters` and `excludedQueryParameters`. If neither
16727 # is set, the entire query string will be included. If false, the query
16728 # string will be excluded from the cache key entirely.
16729 #
16730 # Note: This field applies to routes that use backend services. Attempting
16731 # to set it on a route that points exclusively to Backend Buckets will
16732 # result in a configuration error. For routes that point to a Backend
16733 # Bucket, use `includedQueryParameters` to define which parameters should
16734 # be part of the cache key.
16735 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
16736 # The name=value pair will be used in the cache key Cloud CDN generates.
16737 #
16738 # Note: This setting is only applicable to routes that use a Backend
16739 # Service. It does not affect requests served by a Backend Bucket.
16740 # Attempting to set it on a route that points exclusively to Backend
16741 # Buckets will result in a configuration error. Up to 5 cookie names can be
16742 # specified.
16743 &quot;A String&quot;,
16744 ],
16745 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
16746 &quot;A String&quot;,
16747 ],
16748 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
16749 # parameters will be excluded. Either specify `includedQueryParameters`
16750 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
16751 # encoded and not treated as delimiters.
16752 &quot;A String&quot;,
16753 ],
16754 },
16755 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
16756 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
16757 &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
16758 # content. This is used to clamp the max-age (or Expires) value sent to the
16759 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
16760 # is used for the response max-age directive, along with a &quot;public&quot;
16761 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
16762 # clamps the max-age from the origin (if specified), or else sets the
16763 # response max-age directive to the lesser of the `clientTtl` and
16764 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
16765 # present. The maximum allowed value is 31,622,400s (1 year). If not
16766 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
16767 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
16768 # `USE_ORIGIN_HEADERS`.
16769 # as a count of seconds and fractions of seconds at nanosecond
16770 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16771 # or &quot;month&quot;. Range is approximately 10,000 years.
16772 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16773 # Durations less than one second are represented with a 0
16774 # `seconds` field and a positive `nanos` field. Must be from 0
16775 # to 999,999,999 inclusive.
16776 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16777 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16778 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16779 },
16780 &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
16781 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
16782 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
16783 # greater than that of `maxTtl`. When the `cacheMode` is set to
16784 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
16785 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
16786 # accessed objects may be evicted from the cache before the defined TTL. If
16787 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
16788 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
16789 # `USE_ORIGIN_HEADERS`.
16790 # as a count of seconds and fractions of seconds at nanosecond
16791 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16792 # or &quot;month&quot;. Range is approximately 10,000 years.
16793 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16794 # Durations less than one second are represented with a 0
16795 # `seconds` field and a positive `nanos` field. Must be from 0
16796 # to 999,999,999 inclusive.
16797 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16798 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16799 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16800 },
16801 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
16802 # attempt to set a max-age or s-maxage higher than this, or an Expires header
16803 # more than `maxTtl` seconds in the future will be capped at the value of
16804 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
16805 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
16806 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
16807 # Infrequently accessed objects may be evicted from the cache before the
16808 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
16809 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
16810 # mode.
16811 # as a count of seconds and fractions of seconds at nanosecond
16812 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16813 # or &quot;month&quot;. Range is approximately 10,000 years.
16814 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16815 # Durations less than one second are represented with a 0
16816 # `seconds` field and a positive `nanos` field. Must be from 0
16817 # to 999,999,999 inclusive.
16818 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16819 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16820 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16821 },
16822 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
16823 # to apply fine-grained caching for common errors or redirects.
16824 # This can reduce the load on your origin and improve end-user
16825 # experience by reducing response latency.
16826 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
16827 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
16828 # the specified response code that lack any Cache-Control, Expires, or
16829 # Pragma: no-cache directives. When the `cacheMode` is set to
16830 # `FORCE_CACHE_ALL`, negative caching applies to all responses
16831 # with the specified response code, and overrides any caching headers. By
16832 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
16833 #
16834 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
16835 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
16836 # * 405 (Method Not Found), 501 (Not Implemented): 60s
16837 #
16838 # These defaults can be overridden in `negativeCachingPolicy`.
16839 # If not specified, Cloud CDN applies negative caching by default.
16840 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
16841 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
16842 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
16843 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
16844 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
16845 # all response codes that you wish to cache. Cloud CDN will not apply any
16846 # default negative caching when a policy exists.
16847 { # Specify CDN TTLs for response error codes.
16848 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
16849 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
16850 # specified as values, and you cannot specify a status code more than
16851 # once.
16852 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
16853 # corresponding status code.
16854 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
16855 # objects may be evicted from the cache before the defined TTL.
16856 # as a count of seconds and fractions of seconds at nanosecond
16857 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16858 # or &quot;month&quot;. Range is approximately 10,000 years.
16859 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16860 # Durations less than one second are represented with a 0
16861 # `seconds` field and a positive `nanos` field. Must be from 0
16862 # to 999,999,999 inclusive.
16863 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16864 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16865 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16866 },
16867 },
16868 ],
16869 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
16870 # requests into a small number of requests to the origin. If not specified,
16871 # Cloud CDN applies request coalescing by default.
16872 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
16873 # content with the origin, or when an error is encountered when refreshing
16874 # the cache.
16875 # This setting defines the default &quot;max-stale&quot; duration for any cached
16876 # responses that do not specify a max-stale directive. Stale responses that
16877 # exceed the TTL configured here will not be served. The default limit
16878 # (max-stale) is 86400s (1 day), which will allow stale content to be
16879 # served up to this limit beyond the max-age (or s-maxage) of a cached
16880 # response.
16881 # The maximum allowed value is 604800 (1 week).
16882 # Set this to zero (0) to disable serve-while-stale.
16883 # as a count of seconds and fractions of seconds at nanosecond
16884 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16885 # or &quot;month&quot;. Range is approximately 10,000 years.
16886 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16887 # Durations less than one second are represented with a 0
16888 # `seconds` field and a positive `nanos` field. Must be from 0
16889 # to 999,999,999 inclusive.
16890 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16891 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16892 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16893 },
16894 },
16895 &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
16896 # information about the W3C recommendation for cross-origin resource sharing
16897 # (CORS), see Fetch API Living
16898 # Standard.
16899 #
16900 # Not supported when the URL map is bound to a target gRPC proxy.
16901 # information about the W3C recommendation for cross-origin resource sharing
16902 # (CORS), see Fetch API Living
16903 # Standard.
16904 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
16905 # indicates that
16906 # the actual request can include user credentials. This field translates to
16907 # the Access-Control-Allow-Credentials header.
16908 #
16909 # Default is false.
16910 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
16911 # header.
16912 &quot;A String&quot;,
16913 ],
16914 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
16915 # header.
16916 &quot;A String&quot;,
16917 ],
16918 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
16919 # more information, see regular expression syntax.
16920 #
16921 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
16922 #
16923 # Regular expressions can only be used when the loadBalancingScheme is
16924 # set to INTERNAL_SELF_MANAGED.
16925 &quot;A String&quot;,
16926 ],
16927 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
16928 #
16929 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
16930 &quot;A String&quot;,
16931 ],
16932 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
16933 # The default value is false, which indicates that the CORS
16934 # policy is in effect.
16935 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
16936 # header.
16937 &quot;A String&quot;,
16938 ],
16939 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
16940 # seconds. This field translates to the Access-Control-Max-Age
16941 # header.
16942 },
16943 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
16944 # the resiliency of clients to backend service failure. As part of fault
16945 # injection, when clients send requests to a backend service, delays can be
16946 # introduced by a load balancer on a percentage of requests before sending
16947 # those requests to the backend service. Similarly requests from clients can
16948 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
16949 # that are configured with a fault_injection_policy if:
16950 # 1. The traffic is generated by fault injection AND
16951 # 2. The fault injection is not a delay fault injection.
16952 # Fault injection is not supported with the classic Application Load Balancer
16953 # . To see which load balancers support fault injection,
16954 # see Load
16955 # balancing: Routing and traffic management features.
16956 # the resiliency of clients to backend service failure. As part of fault
16957 # injection, when clients send requests to a backend service, delays can be
16958 # introduced by the load balancer on a percentage of requests before sending
16959 # those request to the backend service. Similarly requests from clients can be
16960 # aborted by the load balancer for a percentage of requests.
16961 &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
16962 # injection.
16963 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
16964 #
16965 # The value must be from 200 to 599 inclusive.
16966 #
16967 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
16968 # according to this
16969 # mapping table. HTTP status 200 is mapped to gRPC status
16970 # UNKNOWN. Injecting an OK status is currently not supported by
16971 # Traffic Director.
16972 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
16973 # that is aborted as part of fault injection.
16974 #
16975 # The value must be from 0.0 to 100.0 inclusive.
16976 },
16977 &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
16978 # injection, before being sent to a backend service.
16979 # request to the backend service as part of fault injection.
16980 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
16981 # as a count of seconds and fractions of seconds at nanosecond
16982 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16983 # or &quot;month&quot;. Range is approximately 10,000 years.
16984 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16985 # Durations less than one second are represented with a 0
16986 # `seconds` field and a positive `nanos` field. Must be from 0
16987 # to 999,999,999 inclusive.
16988 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16989 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16990 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16991 },
16992 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
16993 # which a delay is introduced as part of fault injection.
16994 #
16995 # The value must be from 0.0 to 100.0 inclusive.
16996 },
16997 },
16998 &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
16999 # Global EXTERNAL_MANAGED load balancer schemes.
17000 # Either Cloud CDN must be enabled on the backend service or backend bucket
17001 # serving the route, or cache policy must be configured on the same route
17002 # dynamically processes and delivers images from the network edge.
17003 # Image Optimization is only available for Global External Application Load
17004 # Balancers.
17005 # Either Cloud CDN must be enabled on the backend service or backend bucket
17006 # serving the route, or cache policy must be configured on the same route.
17007 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
17008 },
17009 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
17010 # Unlike the timeout field where the timeout duration starts
17011 # from the time the request has been fully processed (known as*end-of-stream*),
17012 # the duration in this field is computed from the beginning of the stream
17013 # until the response has been processed, including all retries. A
17014 # stream that does not complete in this duration is closed.
17015 #
17016 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
17017 # with the route.
17018 #
17019 # This field is only allowed if the Url map is used with backend services
17020 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
17021 # as a count of seconds and fractions of seconds at nanosecond
17022 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17023 # or &quot;month&quot;. Range is approximately 10,000 years.
17024 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17025 # Durations less than one second are represented with a 0
17026 # `seconds` field and a positive `nanos` field. Must be from 0
17027 # to 999,999,999 inclusive.
17028 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17029 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17030 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17031 },
17032 &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
17033 # are shadowed to a separate mirrored backend service. The load balancer does
17034 # not wait for responses from the shadow service. Before sending traffic
17035 # to the shadow service, the host / authority header is suffixed with-shadow.
17036 #
17037 # Not supported when the URL map is bound to a target gRPC proxy that
17038 # has the validateForProxyless field set to true.
17039 # are shadowed to a separate mirrored backend service. The load balancer
17040 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
17041 # to the shadow service, the host or authority header is suffixed with-shadow.
17042 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
17043 # mirrored to.
17044 #
17045 # The backend service configured for a mirroring
17046 # policy must reference backends that are of the same type as the original
17047 # backend service matched in the URL map.
17048 #
17049 # Serverless NEG backends are not currently supported as a mirrored
17050 # backend service.
17051 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
17052 },
17053 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
17054 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
17055 # If not specified, defaults to 1.
17056 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
17057 #
17058 # If not specified, will use the timeout set in theHttpRouteAction field.
17059 # If timeout in the HttpRouteAction field is not set, this field
17060 # uses the largest timeout
17061 # among all backend services associated with the route.
17062 #
17063 # Not supported when the URL map is bound to a target gRPC proxy that
17064 # has the validateForProxyless field set to true.
17065 # as a count of seconds and fractions of seconds at nanosecond
17066 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17067 # or &quot;month&quot;. Range is approximately 10,000 years.
17068 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17069 # Durations less than one second are represented with a 0
17070 # `seconds` field and a positive `nanos` field. Must be from 0
17071 # to 999,999,999 inclusive.
17072 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17073 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17074 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17075 },
17076 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
17077 # values are:
17078 #
17079 # - 5xx: retry is attempted if the instance or endpoint
17080 # responds with any 5xx response code, or if the instance or
17081 # endpoint does not respond at all. For example, disconnects, reset, read
17082 # timeout, connection failure, and refused streams.
17083 # - gateway-error: Similar to 5xx, but only
17084 # applies to response codes 502, 503 or504.
17085 # - connect-failure: a retry is attempted on failures
17086 # connecting to the instance or endpoint. For example, connection
17087 # timeouts.
17088 # - retriable-4xx: a retry is attempted if the instance
17089 # or endpoint responds with a 4xx response code.
17090 # The only error that you can retry is error code 409.
17091 # - refused-stream: a retry is attempted if the instance
17092 # or endpoint resets the stream with a REFUSED_STREAM error
17093 # code. This reset type indicates that it is safe to retry.
17094 # - cancelled: a retry is attempted if the gRPC status
17095 # code in the response header is set to cancelled.
17096 # - deadline-exceeded: a retry is attempted if the gRPC
17097 # status code in the response header is set todeadline-exceeded.
17098 # - internal: a retry is attempted if the gRPC
17099 # status code in the response header is set tointernal.
17100 # - resource-exhausted: a retry is attempted if the gRPC
17101 # status code in the response header is set toresource-exhausted.
17102 # - unavailable: a retry is attempted if the gRPC
17103 # status code in the response header is set tounavailable.
17104 #
17105 # Only the following codes are supported when the URL map is bound to
17106 # target gRPC proxy that has validateForProxyless field set to true.
17107 #
17108 # - cancelled
17109 # - deadline-exceeded
17110 # - internal
17111 # - resource-exhausted
17112 # - unavailable
17113 &quot;A String&quot;,
17114 ],
17115 },
17116 &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
17117 # time the request has been fully processed (known as *end-of-stream*)
17118 # up until the response has been processed. Timeout includes
17119 # all retries.
17120 #
17121 # If not specified, this field uses the largest timeout among all backend
17122 # services associated with the route.
17123 #
17124 # Not supported when the URL map is bound to a target gRPC proxy that
17125 # has validateForProxyless field set to true.
17126 # as a count of seconds and fractions of seconds at nanosecond
17127 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17128 # or &quot;month&quot;. Range is approximately 10,000 years.
17129 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17130 # Durations less than one second are represented with a 0
17131 # `seconds` field and a positive `nanos` field. Must be from 0
17132 # to 999,999,999 inclusive.
17133 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17134 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17135 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17136 },
17137 &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
17138 # to the matched service.
17139 #
17140 # urlRewrite is the only action supported in UrlMaps
17141 # for classic Application Load Balancers.
17142 #
17143 # Not supported when the URL map is bound to a target gRPC proxy that
17144 # has the validateForProxyless field set to true.
17145 # backend service.
17146 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
17147 # host header is replaced with contents of hostRewrite.
17148 #
17149 # The value must be from 1 to 255 characters.
17150 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
17151 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
17152 #
17153 # The value must be from 1 to 1024 characters.
17154 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
17155 # header) using the HTTP template syntax.
17156 #
17157 # A corresponding
17158 # path_template_match must be specified. Any template variables must exist in
17159 # the path_template_match field.
17160 #
17161 #
17162 # - -At least one variable must be specified in the path_template_match
17163 # field
17164 # - You can omit variables from the rewritten URL
17165 # - The * and ** operators cannot be matched
17166 # unless they have a corresponding variable name - e.g.
17167 # {format=*} or {var=**}.
17168 #
17169 # For example, a path_template_match of /static/{format=**}
17170 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
17171 # rewrite, so that /{country}/{format}/{suffix=**} can be
17172 # rewritten as /content/{format}/{country}/{suffix}.
17173 #
17174 # At least
17175 # one non-empty routeRules[].matchRules[].path_template_match is
17176 # required.
17177 #
17178 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
17179 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
17180 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
17181 # It uses RE2 syntax with the following constraints:
17182 #
17183 #
17184 # - Any single character operators
17185 # - Groups are allowed to have only submatch operator inside
17186 # - Groups are allowed only without any char repetition, e.g.
17187 # .*
17188 # - Any char repetition, e.g. .*, is
17189 # only allowed to be used in a single regex together with:
17190 #
17191 #
17192 # - Empty string operators
17193 # - Other repetitions
17194 # - Ranges
17195 # - Repetitions of ranges
17196 #
17197 #
17198 # - Ranges are only allowed to have:
17199 #
17200 #
17201 # - Character range
17202 # - Digits range
17203 # - Symbols listed in characters allowed for ranges
17204 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
17205 # the path.
17206 },
17207 },
17208 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
17209 # occurs. The weights determine the fraction of traffic that flows to
17210 # their corresponding backend service. If all traffic needs to
17211 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
17212 #
17213 # After a backend service is identified and before forwarding
17214 # the request to
17215 # the backend service, advanced routing actions such as URL rewrites and
17216 # header transformations are applied depending on additional settings
17217 # specified in this HttpRouteAction.
17218 { # In contrast to a single BackendService in
17219 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
17220 # multiple backend services. The volume of traffic for each
17221 # backend service is proportional to the weight specified
17222 # in each WeightedBackendService
17223 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
17224 # resource. Before
17225 # forwarding the request to backendService, the load balancer
17226 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
17227 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
17228 # effect for the selected backendService.
17229 #
17230 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
17231 #
17232 # headerAction is not supported for load balancers that have
17233 # their loadBalancingScheme set to EXTERNAL.
17234 #
17235 # Not supported when the URL map is bound to a target gRPC proxy that
17236 # has validateForProxyless field set to true.
17237 # the request is passed along to the selected backendService.
17238 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
17239 { # Specification determining how headers are added to requests or responses.
17240 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
17241 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
17242 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
17243 # that already
17244 # exist for the header. If true, headerValue is set for the
17245 # header, discarding any values that were set for that header.
17246 #
17247 # The default value is true,
17248 # unless a variable is present in headerValue,
17249 # in which case the default value is false.
17250 # .
17251 },
17252 ],
17253 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
17254 # request before forwarding the request to the backendService.
17255 &quot;A String&quot;,
17256 ],
17257 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
17258 # client.
17259 { # Specification determining how headers are added to requests or responses.
17260 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
17261 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
17262 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
17263 # that already
17264 # exist for the header. If true, headerValue is set for the
17265 # header, discarding any values that were set for that header.
17266 #
17267 # The default value is true,
17268 # unless a variable is present in headerValue,
17269 # in which case the default value is false.
17270 # .
17271 },
17272 ],
17273 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
17274 # response before sending the response back to the client.
17275 &quot;A String&quot;,
17276 ],
17277 },
17278 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
17279 # computed asweight / (sum of all weightedBackendService weights in routeAction).
17280 #
17281 # The selection of a backend service is determined only for new traffic.
17282 # Once a user&#x27;s request has been directed to a backend service,
17283 # subsequent requests are sent to the same backend service as
17284 # determined by the backend service&#x27;s session affinity policy.
17285 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
17286 # splitting. If you do, the weighted traffic splitting configuration takes
17287 # precedence.
17288 #
17289 # The value must be from 0 to 1000.
17290 },
17291 ],
17292 },
17293 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL of the defaultService resource to
17294 # which traffic is directed if none of the hostRules match.
17295 # If defaultRouteAction is also specified, advanced
17296 # routing actions, such as URL rewrites, take effect before sending the
17297 # request to the backend.
17298 #
17299 #
17300 # Only one of defaultUrlRedirect, defaultService
17301 # or defaultRouteAction.weightedBackendService can be set.
17302 #
17303 #
17304 # defaultService has no effect when the URL map is bound
17305 # to a target gRPC proxy that has the validateForProxyless field
17306 # set to true.
17307 &quot;defaultUrlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
17308 # is redirected to a URL specified by defaultUrlRedirect.
17309 #
17310 #
17311 # Only one of defaultUrlRedirect, defaultService
17312 # or defaultRouteAction.weightedBackendService can be set.
17313 #
17314 #
17315 # Not supported when the URL map is bound to a target gRPC proxy.
17316 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
17317 # was supplied in the request.
17318 #
17319 # The value must be from 1 to 255
17320 # characters.
17321 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
17322 # set to HTTPS.
17323 # If set to false, the URL scheme of the redirected request
17324 # remains the same as that of the request.
17325 #
17326 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
17327 #
17328 # The default is set to false.
17329 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
17330 # that was supplied in the request.
17331 #
17332 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
17333 # supplied, the path of the original request is used for the redirect.
17334 #
17335 # The value must be from 1 to 1024 characters.
17336 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
17337 # the HttpRouteRuleMatch, retaining the remaining portion
17338 # of the URL before redirecting the request.
17339 #
17340 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
17341 # supplied, the path of the original request is used for the redirect.
17342 #
17343 # The value must be from 1 to 1024 characters.
17344 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
17345 #
17346 # Supported values are:
17347 #
17348 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
17349 # to 301.
17350 # - FOUND, which corresponds to 302.
17351 # - SEE_OTHER which corresponds to 303.
17352 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
17353 # method is retained.
17354 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
17355 # method is retained.
17356 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
17357 # URL is
17358 # removed before redirecting the request. If set to false, the
17359 # query portion of the original URL is retained.
17360 #
17361 # The default is set to false.
17362 },
17363 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
17364 # create the resource.
17365 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. A hash of the contents stored in this object.
17366 # This field is used in optimistic locking. This field is ignored when
17367 # inserting a UrlMap. An up-to-date fingerprint must be provided
17368 # in order to update the UrlMap, otherwise the request will
17369 # fail with error 412 conditionNotMet.
17370 #
17371 # To see the latest fingerprint, make a get() request to
17372 # retrieve a UrlMap.
17373 &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
17374 # for the selected backendService.
17375 #
17376 # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
17377 #
17378 # headerAction is not supported for load balancers
17379 # that have
17380 # their loadBalancingScheme set to EXTERNAL.
17381 #
17382 # Not supported when the URL map is bound to a target gRPC proxy that
17383 # has validateForProxyless field set to true.
17384 # the request is passed along to the selected backendService.
17385 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
17386 { # Specification determining how headers are added to requests or responses.
17387 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
17388 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
17389 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
17390 # that already
17391 # exist for the header. If true, headerValue is set for the
17392 # header, discarding any values that were set for that header.
17393 #
17394 # The default value is true,
17395 # unless a variable is present in headerValue,
17396 # in which case the default value is false.
17397 # .
17398 },
17399 ],
17400 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
17401 # request before forwarding the request to the backendService.
17402 &quot;A String&quot;,
17403 ],
17404 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
17405 # client.
17406 { # Specification determining how headers are added to requests or responses.
17407 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
17408 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
17409 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
17410 # that already
17411 # exist for the header. If true, headerValue is set for the
17412 # header, discarding any values that were set for that header.
17413 #
17414 # The default value is true,
17415 # unless a variable is present in headerValue,
17416 # in which case the default value is false.
17417 # .
17418 },
17419 ],
17420 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
17421 # response before sending the response back to the client.
17422 &quot;A String&quot;,
17423 ],
17424 },
17425 &quot;hostRules&quot;: [ # The list of host rules to use against the URL.
17426 { # UrlMaps
17427 # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
17428 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
17429 # create the resource.
17430 &quot;hosts&quot;: [ # The list of host patterns to match. They must be valid hostnames with
17431 # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
17432 # that case, * must be the first character, and if followed by
17433 # anything, the immediate following character must be either -
17434 # or ..
17435 #
17436 # * based matching is not supported when the URL map is bound
17437 # to a target gRPC proxy that has the validateForProxyless field
17438 # set to true.
17439 &quot;A String&quot;,
17440 ],
17441 &quot;pathMatcher&quot;: &quot;A String&quot;, # The name of the PathMatcher to use to match the path portion
17442 # of the URL if the hostRule matches the URL&#x27;s host portion.
17443 },
17444 ],
17445 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the resource. This identifier is
17446 # defined by the server.
17447 &quot;kind&quot;: &quot;compute#urlMap&quot;, # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
17448 # url maps.
17449 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
17450 # The name must be 1-63 characters long, and comply withRFC1035.
17451 # Specifically, the name must be 1-63 characters long and match the regular
17452 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
17453 # character must be a lowercase letter, and all following characters must
17454 # be a dash, lowercase letter, or digit, except the last character, which
17455 # cannot be a dash.
17456 &quot;pathMatchers&quot;: [ # The list of named PathMatchers to use against the URL.
17457 { # A matcher for the path portion of the URL. The BackendService
17458 # from the longest-matched rule will serve the URL. If no rule was matched, the
17459 # default service is used.
17460 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
17461 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
17462 #
17463 # This policy takes
17464 # effect at the PathMatcher level and applies only when no
17465 # 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
17466 # in defaultCustomErrorResponsePolicy, then a policy defined for
17467 # the error code in UrlMap.defaultCustomErrorResponsePolicy
17468 # takes effect.
17469 #
17470 # For example, consider a UrlMap with the following
17471 # configuration:
17472 #
17473 #
17474 # - UrlMap.defaultCustomErrorResponsePolicy is configured
17475 # with policies for 5xx and 4xx errors
17476 # - A RouteRule for /coming_soon/ is configured for the
17477 # error code 404.
17478 #
17479 # 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
17480 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
17481 # the policy in RouteRule.customErrorResponsePolicy takes
17482 # effect. If any of the requests in this example encounter a 500
17483 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
17484 #
17485 # When
17486 # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
17487 # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
17488 # a retry, if load balancer is successful in reaching the
17489 # service, the defaultCustomErrorResponsePolicy is ignored and
17490 # the response from the service is returned to the client.
17491 #
17492 # defaultCustomErrorResponsePolicy is supported only for
17493 # global external Application Load Balancers.
17494 # backend service or backend bucket responds with an error.
17495 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
17496 #
17497 # In a given policy, if you specify rules for both a range of error codes
17498 # as well as rules for specific error codes then rules with specific error
17499 # codes have a higher priority. For example, assume that you configure a rule
17500 # for 401 (Un-authorized) code, and another for all 4 series
17501 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
17502 # However if the backend service returns a 403, the rule for4xx takes effect.
17503 { # Specifies the mapping between the response code that will be returned along
17504 # with the custom error content and the response code returned by the backend
17505 # service.
17506 &quot;matchResponseCodes&quot;: [ # Valid values include:
17507 #
17508 #
17509 # - A number between 400 and 599: For example
17510 # 401 or 503, in which case the load balancer
17511 # applies the policy if the error code exactly matches this value.
17512 # - 5xx: Load Balancer will apply the policy if the
17513 # backend service responds with any response code in the range of
17514 # 500 to 599.
17515 # - 4xx: Load
17516 # Balancer will apply the policy if the backend service responds with any
17517 # response code in the range of 400 to
17518 # 499.
17519 #
17520 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
17521 &quot;A String&quot;,
17522 ],
17523 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
17524 # error content. If overrideResponseCode is not supplied, the
17525 # same response code returned by the original backend bucket or backend
17526 # service is returned to the client.
17527 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
17528 #
17529 # path must start
17530 # with a leading slash. path cannot have trailing slashes.
17531 #
17532 # If the file is not available in backendBucket or the
17533 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
17534 #
17535 # The value must
17536 # be from 1 to 1024 characters
17537 },
17538 ],
17539 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
17540 # contains the custom error content. Examples are:
17541 #
17542 #
17543 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
17544 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
17545 # - global/backendBuckets/myBackendBucket
17546 #
17547 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
17548 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
17549 #
17550 # If load balancer cannot reach
17551 # the backendBucket, a simple Not Found Error will
17552 # be returned, with the original response code (oroverrideResponseCode if configured).
17553 #
17554 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
17555 },
17556 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
17557 # pathRules or routeRules match. The load balancer
17558 # performs advanced routing actions, such as URL rewrites and
17559 # header transformations, before forwarding the request to the
17560 # selected backend.
17561 #
17562 #
17563 # Only one of defaultUrlRedirect, defaultService
17564 # or defaultRouteAction.weightedBackendService can be set.
17565 #
17566 #
17567 # URL maps for classic Application Load Balancers only support
17568 # the urlRewrite action within a path matcher&#x27;sdefaultRouteAction.
17569 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
17570 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
17571 # property must be specified. This policy cannot be specified if any target
17572 # backend has Identity-Aware Proxy enabled.
17573 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
17574 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
17575 # header names can be specified. The cache is bypassed for all `cacheMode`
17576 # values.
17577 &quot;A String&quot;,
17578 ],
17579 &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
17580 # on the backend type: for Backend Services, the complete request URI is
17581 # used; for Backend Buckets, the request URI is used without the protocol or
17582 # host, and only query parameters known to Cloud Storage are included.
17583 # Policy defined on Route Action.
17584 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
17585 # parameters will be included. Either specify `excludedQueryParameters`
17586 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
17587 # encoded and not treated as delimiters.
17588 #
17589 # Note: This field applies to routes that use backend services. Attempting
17590 # to set it on a route that points exclusively to Backend Buckets will
17591 # result in a configuration error. For routes that point to a Backend
17592 # Bucket, use `includedQueryParameters` to define which parameters should
17593 # be part of the cache key.
17594 &quot;A String&quot;,
17595 ],
17596 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
17597 #
17598 # Note: This setting is only applicable to routes that use a Backend
17599 # Service. It does not affect requests served by a Backend Bucket, as the
17600 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
17601 # it on a route that points exclusively to Backend Buckets will result in a
17602 # configuration error.
17603 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
17604 #
17605 # Note: This setting is only applicable to routes that use a Backend
17606 # Service. It does not affect requests served by a Backend Bucket, as the
17607 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
17608 # set on a route that points exclusively to Backend Buckets will result in
17609 # a configuration error.
17610 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
17611 # `includedQueryParameters` and `excludedQueryParameters`. If neither
17612 # is set, the entire query string will be included. If false, the query
17613 # string will be excluded from the cache key entirely.
17614 #
17615 # Note: This field applies to routes that use backend services. Attempting
17616 # to set it on a route that points exclusively to Backend Buckets will
17617 # result in a configuration error. For routes that point to a Backend
17618 # Bucket, use `includedQueryParameters` to define which parameters should
17619 # be part of the cache key.
17620 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
17621 # The name=value pair will be used in the cache key Cloud CDN generates.
17622 #
17623 # Note: This setting is only applicable to routes that use a Backend
17624 # Service. It does not affect requests served by a Backend Bucket.
17625 # Attempting to set it on a route that points exclusively to Backend
17626 # Buckets will result in a configuration error. Up to 5 cookie names can be
17627 # specified.
17628 &quot;A String&quot;,
17629 ],
17630 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
17631 &quot;A String&quot;,
17632 ],
17633 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
17634 # parameters will be excluded. Either specify `includedQueryParameters`
17635 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
17636 # encoded and not treated as delimiters.
17637 &quot;A String&quot;,
17638 ],
17639 },
17640 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
17641 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
17642 &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
17643 # content. This is used to clamp the max-age (or Expires) value sent to the
17644 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
17645 # is used for the response max-age directive, along with a &quot;public&quot;
17646 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
17647 # clamps the max-age from the origin (if specified), or else sets the
17648 # response max-age directive to the lesser of the `clientTtl` and
17649 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
17650 # present. The maximum allowed value is 31,622,400s (1 year). If not
17651 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
17652 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
17653 # `USE_ORIGIN_HEADERS`.
17654 # as a count of seconds and fractions of seconds at nanosecond
17655 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17656 # or &quot;month&quot;. Range is approximately 10,000 years.
17657 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17658 # Durations less than one second are represented with a 0
17659 # `seconds` field and a positive `nanos` field. Must be from 0
17660 # to 999,999,999 inclusive.
17661 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17662 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17663 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17664 },
17665 &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
17666 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
17667 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
17668 # greater than that of `maxTtl`. When the `cacheMode` is set to
17669 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
17670 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
17671 # accessed objects may be evicted from the cache before the defined TTL. If
17672 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
17673 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
17674 # `USE_ORIGIN_HEADERS`.
17675 # as a count of seconds and fractions of seconds at nanosecond
17676 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17677 # or &quot;month&quot;. Range is approximately 10,000 years.
17678 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17679 # Durations less than one second are represented with a 0
17680 # `seconds` field and a positive `nanos` field. Must be from 0
17681 # to 999,999,999 inclusive.
17682 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17683 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17684 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17685 },
17686 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
17687 # attempt to set a max-age or s-maxage higher than this, or an Expires header
17688 # more than `maxTtl` seconds in the future will be capped at the value of
17689 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
17690 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
17691 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
17692 # Infrequently accessed objects may be evicted from the cache before the
17693 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
17694 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
17695 # mode.
17696 # as a count of seconds and fractions of seconds at nanosecond
17697 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17698 # or &quot;month&quot;. Range is approximately 10,000 years.
17699 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17700 # Durations less than one second are represented with a 0
17701 # `seconds` field and a positive `nanos` field. Must be from 0
17702 # to 999,999,999 inclusive.
17703 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17704 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17705 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17706 },
17707 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
17708 # to apply fine-grained caching for common errors or redirects.
17709 # This can reduce the load on your origin and improve end-user
17710 # experience by reducing response latency.
17711 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
17712 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
17713 # the specified response code that lack any Cache-Control, Expires, or
17714 # Pragma: no-cache directives. When the `cacheMode` is set to
17715 # `FORCE_CACHE_ALL`, negative caching applies to all responses
17716 # with the specified response code, and overrides any caching headers. By
17717 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
17718 #
17719 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
17720 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
17721 # * 405 (Method Not Found), 501 (Not Implemented): 60s
17722 #
17723 # These defaults can be overridden in `negativeCachingPolicy`.
17724 # If not specified, Cloud CDN applies negative caching by default.
17725 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
17726 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
17727 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
17728 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
17729 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
17730 # all response codes that you wish to cache. Cloud CDN will not apply any
17731 # default negative caching when a policy exists.
17732 { # Specify CDN TTLs for response error codes.
17733 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
17734 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
17735 # specified as values, and you cannot specify a status code more than
17736 # once.
17737 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
17738 # corresponding status code.
17739 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
17740 # objects may be evicted from the cache before the defined TTL.
17741 # as a count of seconds and fractions of seconds at nanosecond
17742 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17743 # or &quot;month&quot;. Range is approximately 10,000 years.
17744 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17745 # Durations less than one second are represented with a 0
17746 # `seconds` field and a positive `nanos` field. Must be from 0
17747 # to 999,999,999 inclusive.
17748 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17749 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17750 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17751 },
17752 },
17753 ],
17754 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
17755 # requests into a small number of requests to the origin. If not specified,
17756 # Cloud CDN applies request coalescing by default.
17757 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
17758 # content with the origin, or when an error is encountered when refreshing
17759 # the cache.
17760 # This setting defines the default &quot;max-stale&quot; duration for any cached
17761 # responses that do not specify a max-stale directive. Stale responses that
17762 # exceed the TTL configured here will not be served. The default limit
17763 # (max-stale) is 86400s (1 day), which will allow stale content to be
17764 # served up to this limit beyond the max-age (or s-maxage) of a cached
17765 # response.
17766 # The maximum allowed value is 604800 (1 week).
17767 # Set this to zero (0) to disable serve-while-stale.
17768 # as a count of seconds and fractions of seconds at nanosecond
17769 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17770 # or &quot;month&quot;. Range is approximately 10,000 years.
17771 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17772 # Durations less than one second are represented with a 0
17773 # `seconds` field and a positive `nanos` field. Must be from 0
17774 # to 999,999,999 inclusive.
17775 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17776 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17777 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17778 },
17779 },
17780 &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
17781 # information about the W3C recommendation for cross-origin resource sharing
17782 # (CORS), see Fetch API Living
17783 # Standard.
17784 #
17785 # Not supported when the URL map is bound to a target gRPC proxy.
17786 # information about the W3C recommendation for cross-origin resource sharing
17787 # (CORS), see Fetch API Living
17788 # Standard.
17789 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
17790 # indicates that
17791 # the actual request can include user credentials. This field translates to
17792 # the Access-Control-Allow-Credentials header.
17793 #
17794 # Default is false.
17795 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
17796 # header.
17797 &quot;A String&quot;,
17798 ],
17799 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
17800 # header.
17801 &quot;A String&quot;,
17802 ],
17803 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
17804 # more information, see regular expression syntax.
17805 #
17806 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
17807 #
17808 # Regular expressions can only be used when the loadBalancingScheme is
17809 # set to INTERNAL_SELF_MANAGED.
17810 &quot;A String&quot;,
17811 ],
17812 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
17813 #
17814 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
17815 &quot;A String&quot;,
17816 ],
17817 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
17818 # The default value is false, which indicates that the CORS
17819 # policy is in effect.
17820 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
17821 # header.
17822 &quot;A String&quot;,
17823 ],
17824 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
17825 # seconds. This field translates to the Access-Control-Max-Age
17826 # header.
17827 },
17828 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
17829 # the resiliency of clients to backend service failure. As part of fault
17830 # injection, when clients send requests to a backend service, delays can be
17831 # introduced by a load balancer on a percentage of requests before sending
17832 # those requests to the backend service. Similarly requests from clients can
17833 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
17834 # that are configured with a fault_injection_policy if:
17835 # 1. The traffic is generated by fault injection AND
17836 # 2. The fault injection is not a delay fault injection.
17837 # Fault injection is not supported with the classic Application Load Balancer
17838 # . To see which load balancers support fault injection,
17839 # see Load
17840 # balancing: Routing and traffic management features.
17841 # the resiliency of clients to backend service failure. As part of fault
17842 # injection, when clients send requests to a backend service, delays can be
17843 # introduced by the load balancer on a percentage of requests before sending
17844 # those request to the backend service. Similarly requests from clients can be
17845 # aborted by the load balancer for a percentage of requests.
17846 &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
17847 # injection.
17848 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
17849 #
17850 # The value must be from 200 to 599 inclusive.
17851 #
17852 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
17853 # according to this
17854 # mapping table. HTTP status 200 is mapped to gRPC status
17855 # UNKNOWN. Injecting an OK status is currently not supported by
17856 # Traffic Director.
17857 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
17858 # that is aborted as part of fault injection.
17859 #
17860 # The value must be from 0.0 to 100.0 inclusive.
17861 },
17862 &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
17863 # injection, before being sent to a backend service.
17864 # request to the backend service as part of fault injection.
17865 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
17866 # as a count of seconds and fractions of seconds at nanosecond
17867 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17868 # or &quot;month&quot;. Range is approximately 10,000 years.
17869 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17870 # Durations less than one second are represented with a 0
17871 # `seconds` field and a positive `nanos` field. Must be from 0
17872 # to 999,999,999 inclusive.
17873 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17874 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17875 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17876 },
17877 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
17878 # which a delay is introduced as part of fault injection.
17879 #
17880 # The value must be from 0.0 to 100.0 inclusive.
17881 },
17882 },
17883 &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
17884 # Global EXTERNAL_MANAGED load balancer schemes.
17885 # Either Cloud CDN must be enabled on the backend service or backend bucket
17886 # serving the route, or cache policy must be configured on the same route
17887 # dynamically processes and delivers images from the network edge.
17888 # Image Optimization is only available for Global External Application Load
17889 # Balancers.
17890 # Either Cloud CDN must be enabled on the backend service or backend bucket
17891 # serving the route, or cache policy must be configured on the same route.
17892 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
17893 },
17894 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
17895 # Unlike the timeout field where the timeout duration starts
17896 # from the time the request has been fully processed (known as*end-of-stream*),
17897 # the duration in this field is computed from the beginning of the stream
17898 # until the response has been processed, including all retries. A
17899 # stream that does not complete in this duration is closed.
17900 #
17901 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
17902 # with the route.
17903 #
17904 # This field is only allowed if the Url map is used with backend services
17905 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
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;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
17918 # are shadowed to a separate mirrored backend service. The load balancer does
17919 # not wait for responses from the shadow service. Before sending traffic
17920 # to the shadow service, the host / authority header is suffixed with-shadow.
17921 #
17922 # Not supported when the URL map is bound to a target gRPC proxy that
17923 # has the validateForProxyless field set to true.
17924 # are shadowed to a separate mirrored backend service. The load balancer
17925 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
17926 # to the shadow service, the host or authority header is suffixed with-shadow.
17927 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
17928 # mirrored to.
17929 #
17930 # The backend service configured for a mirroring
17931 # policy must reference backends that are of the same type as the original
17932 # backend service matched in the URL map.
17933 #
17934 # Serverless NEG backends are not currently supported as a mirrored
17935 # backend service.
17936 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
17937 },
17938 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
17939 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
17940 # If not specified, defaults to 1.
17941 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
17942 #
17943 # If not specified, will use the timeout set in theHttpRouteAction field.
17944 # If timeout in the HttpRouteAction field is not set, this field
17945 # uses the largest timeout
17946 # among all backend services associated with the route.
17947 #
17948 # Not supported when the URL map is bound to a target gRPC proxy that
17949 # has the validateForProxyless field set to true.
17950 # as a count of seconds and fractions of seconds at nanosecond
17951 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17952 # or &quot;month&quot;. Range is approximately 10,000 years.
17953 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17954 # Durations less than one second are represented with a 0
17955 # `seconds` field and a positive `nanos` field. Must be from 0
17956 # to 999,999,999 inclusive.
17957 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17958 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17959 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17960 },
17961 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
17962 # values are:
17963 #
17964 # - 5xx: retry is attempted if the instance or endpoint
17965 # responds with any 5xx response code, or if the instance or
17966 # endpoint does not respond at all. For example, disconnects, reset, read
17967 # timeout, connection failure, and refused streams.
17968 # - gateway-error: Similar to 5xx, but only
17969 # applies to response codes 502, 503 or504.
17970 # - connect-failure: a retry is attempted on failures
17971 # connecting to the instance or endpoint. For example, connection
17972 # timeouts.
17973 # - retriable-4xx: a retry is attempted if the instance
17974 # or endpoint responds with a 4xx response code.
17975 # The only error that you can retry is error code 409.
17976 # - refused-stream: a retry is attempted if the instance
17977 # or endpoint resets the stream with a REFUSED_STREAM error
17978 # code. This reset type indicates that it is safe to retry.
17979 # - cancelled: a retry is attempted if the gRPC status
17980 # code in the response header is set to cancelled.
17981 # - deadline-exceeded: a retry is attempted if the gRPC
17982 # status code in the response header is set todeadline-exceeded.
17983 # - internal: a retry is attempted if the gRPC
17984 # status code in the response header is set tointernal.
17985 # - resource-exhausted: a retry is attempted if the gRPC
17986 # status code in the response header is set toresource-exhausted.
17987 # - unavailable: a retry is attempted if the gRPC
17988 # status code in the response header is set tounavailable.
17989 #
17990 # Only the following codes are supported when the URL map is bound to
17991 # target gRPC proxy that has validateForProxyless field set to true.
17992 #
17993 # - cancelled
17994 # - deadline-exceeded
17995 # - internal
17996 # - resource-exhausted
17997 # - unavailable
17998 &quot;A String&quot;,
17999 ],
18000 },
18001 &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
18002 # time the request has been fully processed (known as *end-of-stream*)
18003 # up until the response has been processed. Timeout includes
18004 # all retries.
18005 #
18006 # If not specified, this field uses the largest timeout among all backend
18007 # services associated with the route.
18008 #
18009 # Not supported when the URL map is bound to a target gRPC proxy that
18010 # has validateForProxyless field set to true.
18011 # as a count of seconds and fractions of seconds at nanosecond
18012 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18013 # or &quot;month&quot;. Range is approximately 10,000 years.
18014 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18015 # Durations less than one second are represented with a 0
18016 # `seconds` field and a positive `nanos` field. Must be from 0
18017 # to 999,999,999 inclusive.
18018 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18019 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18020 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18021 },
18022 &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
18023 # to the matched service.
18024 #
18025 # urlRewrite is the only action supported in UrlMaps
18026 # for classic Application Load Balancers.
18027 #
18028 # Not supported when the URL map is bound to a target gRPC proxy that
18029 # has the validateForProxyless field set to true.
18030 # backend service.
18031 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
18032 # host header is replaced with contents of hostRewrite.
18033 #
18034 # The value must be from 1 to 255 characters.
18035 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
18036 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
18037 #
18038 # The value must be from 1 to 1024 characters.
18039 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
18040 # header) using the HTTP template syntax.
18041 #
18042 # A corresponding
18043 # path_template_match must be specified. Any template variables must exist in
18044 # the path_template_match field.
18045 #
18046 #
18047 # - -At least one variable must be specified in the path_template_match
18048 # field
18049 # - You can omit variables from the rewritten URL
18050 # - The * and ** operators cannot be matched
18051 # unless they have a corresponding variable name - e.g.
18052 # {format=*} or {var=**}.
18053 #
18054 # For example, a path_template_match of /static/{format=**}
18055 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
18056 # rewrite, so that /{country}/{format}/{suffix=**} can be
18057 # rewritten as /content/{format}/{country}/{suffix}.
18058 #
18059 # At least
18060 # one non-empty routeRules[].matchRules[].path_template_match is
18061 # required.
18062 #
18063 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
18064 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
18065 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
18066 # It uses RE2 syntax with the following constraints:
18067 #
18068 #
18069 # - Any single character operators
18070 # - Groups are allowed to have only submatch operator inside
18071 # - Groups are allowed only without any char repetition, e.g.
18072 # .*
18073 # - Any char repetition, e.g. .*, is
18074 # only allowed to be used in a single regex together with:
18075 #
18076 #
18077 # - Empty string operators
18078 # - Other repetitions
18079 # - Ranges
18080 # - Repetitions of ranges
18081 #
18082 #
18083 # - Ranges are only allowed to have:
18084 #
18085 #
18086 # - Character range
18087 # - Digits range
18088 # - Symbols listed in characters allowed for ranges
18089 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
18090 # the path.
18091 },
18092 },
18093 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
18094 # occurs. The weights determine the fraction of traffic that flows to
18095 # their corresponding backend service. If all traffic needs to
18096 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
18097 #
18098 # After a backend service is identified and before forwarding
18099 # the request to
18100 # the backend service, advanced routing actions such as URL rewrites and
18101 # header transformations are applied depending on additional settings
18102 # specified in this HttpRouteAction.
18103 { # In contrast to a single BackendService in
18104 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
18105 # multiple backend services. The volume of traffic for each
18106 # backend service is proportional to the weight specified
18107 # in each WeightedBackendService
18108 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
18109 # resource. Before
18110 # forwarding the request to backendService, the load balancer
18111 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
18112 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
18113 # effect for the selected backendService.
18114 #
18115 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
18116 #
18117 # headerAction is not supported for load balancers that have
18118 # their loadBalancingScheme set to EXTERNAL.
18119 #
18120 # Not supported when the URL map is bound to a target gRPC proxy that
18121 # has validateForProxyless field set to true.
18122 # the request is passed along to the selected backendService.
18123 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
18124 { # Specification determining how headers are added to requests or responses.
18125 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
18126 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
18127 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
18128 # that already
18129 # exist for the header. If true, headerValue is set for the
18130 # header, discarding any values that were set for that header.
18131 #
18132 # The default value is true,
18133 # unless a variable is present in headerValue,
18134 # in which case the default value is false.
18135 # .
18136 },
18137 ],
18138 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
18139 # request before forwarding the request to the backendService.
18140 &quot;A String&quot;,
18141 ],
18142 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
18143 # client.
18144 { # Specification determining how headers are added to requests or responses.
18145 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
18146 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
18147 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
18148 # that already
18149 # exist for the header. If true, headerValue is set for the
18150 # header, discarding any values that were set for that header.
18151 #
18152 # The default value is true,
18153 # unless a variable is present in headerValue,
18154 # in which case the default value is false.
18155 # .
18156 },
18157 ],
18158 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
18159 # response before sending the response back to the client.
18160 &quot;A String&quot;,
18161 ],
18162 },
18163 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
18164 # computed asweight / (sum of all weightedBackendService weights in routeAction).
18165 #
18166 # The selection of a backend service is determined only for new traffic.
18167 # Once a user&#x27;s request has been directed to a backend service,
18168 # subsequent requests are sent to the same backend service as
18169 # determined by the backend service&#x27;s session affinity policy.
18170 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
18171 # splitting. If you do, the weighted traffic splitting configuration takes
18172 # precedence.
18173 #
18174 # The value must be from 0 to 1000.
18175 },
18176 ],
18177 },
18178 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource. This
18179 # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
18180 # matched. For example, the
18181 # following are all valid URLs to a BackendService resource:
18182 #
18183 #
18184 # - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
18185 # - compute/v1/projects/project/global/backendServices/backendService
18186 # - global/backendServices/backendService
18187 #
18188 #
18189 # If defaultRouteAction is also specified, advanced
18190 # routing actions, such as URL rewrites, take effect before sending the
18191 # request to the backend.
18192 #
18193 #
18194 # Only one of defaultUrlRedirect, defaultService
18195 # or defaultRouteAction.weightedBackendService can be set.
18196 #
18197 #
18198 # Authorization requires one or more of the following Google IAM permissions on the
18199 # specified resource default_service:
18200 #
18201 #
18202 # - compute.backendBuckets.use
18203 # - compute.backendServices.use
18204 &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
18205 # by defaultUrlRedirect.
18206 #
18207 #
18208 # Only one of defaultUrlRedirect, defaultService
18209 # or defaultRouteAction.weightedBackendService can be set.
18210 #
18211 #
18212 # Not supported when the URL map is bound to a target gRPC proxy.
18213 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
18214 # was supplied in the request.
18215 #
18216 # The value must be from 1 to 255
18217 # characters.
18218 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
18219 # set to HTTPS.
18220 # If set to false, the URL scheme of the redirected request
18221 # remains the same as that of the request.
18222 #
18223 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
18224 #
18225 # The default is set to false.
18226 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
18227 # that was supplied in the request.
18228 #
18229 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
18230 # supplied, the path of the original request is used for the redirect.
18231 #
18232 # The value must be from 1 to 1024 characters.
18233 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
18234 # the HttpRouteRuleMatch, retaining the remaining portion
18235 # of the URL before redirecting the request.
18236 #
18237 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
18238 # supplied, the path of the original request is used for the redirect.
18239 #
18240 # The value must be from 1 to 1024 characters.
18241 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
18242 #
18243 # Supported values are:
18244 #
18245 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
18246 # to 301.
18247 # - FOUND, which corresponds to 302.
18248 # - SEE_OTHER which corresponds to 303.
18249 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
18250 # method is retained.
18251 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
18252 # method is retained.
18253 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
18254 # URL is
18255 # removed before redirecting the request. If set to false, the
18256 # query portion of the original URL is retained.
18257 #
18258 # The default is set to false.
18259 },
18260 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
18261 # create the resource.
18262 &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
18263 # for the selected backend service.
18264 #
18265 # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
18266 #
18267 # HeaderAction is not supported for load balancers
18268 # that have
18269 # their loadBalancingScheme set to EXTERNAL.
18270 #
18271 # Not supported when the URL map is bound to a target gRPC proxy that
18272 # has validateForProxyless field set to true.
18273 # the request is passed along to the selected backendService.
18274 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
18275 { # Specification determining how headers are added to requests or responses.
18276 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
18277 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
18278 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
18279 # that already
18280 # exist for the header. If true, headerValue is set for the
18281 # header, discarding any values that were set for that header.
18282 #
18283 # The default value is true,
18284 # unless a variable is present in headerValue,
18285 # in which case the default value is false.
18286 # .
18287 },
18288 ],
18289 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
18290 # request before forwarding the request to the backendService.
18291 &quot;A String&quot;,
18292 ],
18293 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
18294 # client.
18295 { # Specification determining how headers are added to requests or responses.
18296 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
18297 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
18298 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
18299 # that already
18300 # exist for the header. If true, headerValue is set for the
18301 # header, discarding any values that were set for that header.
18302 #
18303 # The default value is true,
18304 # unless a variable is present in headerValue,
18305 # in which case the default value is false.
18306 # .
18307 },
18308 ],
18309 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
18310 # response before sending the response back to the client.
18311 &quot;A String&quot;,
18312 ],
18313 },
18314 &quot;name&quot;: &quot;A String&quot;, # The name to which this PathMatcher is referred by theHostRule.
18315 &quot;pathRules&quot;: [ # The list of path rules. Use this list instead of routeRules
18316 # when routing based on simple path matching is all that&#x27;s required. A path
18317 # rule can only include a wildcard character (*) after a
18318 # forward slash character (&quot;/&quot;).
18319 #
18320 # The order by which path rules are specified does not matter.
18321 # Matches are always done on the longest-path-first basis.
18322 #
18323 # For example: a pathRule with a path /a/b/c/* will match
18324 # before /a/b/* irrespective of the order in which those paths appear in this
18325 # list.
18326 #
18327 # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
18328 { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
18329 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
18330 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
18331 #
18332 # If a policy for an
18333 # error code is not configured for the PathRule, a policy for
18334 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
18335 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
18336 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
18337 # effect.
18338 #
18339 # For example, consider a UrlMap with the following configuration:
18340 #
18341 #
18342 # - UrlMap.defaultCustomErrorResponsePolicy are configured
18343 # with policies for 5xx and 4xx errors
18344 # - A PathRule for /coming_soon/ is configured for the error
18345 # code 404.
18346 #
18347 # 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
18348 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
18349 # the policy in PathRule.customErrorResponsePolicy takes
18350 # effect. If any of the requests in this example encounter a 500
18351 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
18352 #
18353 # customErrorResponsePolicy is supported only for
18354 # global external Application Load Balancers.
18355 # backend service or backend bucket responds with an error.
18356 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
18357 #
18358 # In a given policy, if you specify rules for both a range of error codes
18359 # as well as rules for specific error codes then rules with specific error
18360 # codes have a higher priority. For example, assume that you configure a rule
18361 # for 401 (Un-authorized) code, and another for all 4 series
18362 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
18363 # However if the backend service returns a 403, the rule for4xx takes effect.
18364 { # Specifies the mapping between the response code that will be returned along
18365 # with the custom error content and the response code returned by the backend
18366 # service.
18367 &quot;matchResponseCodes&quot;: [ # Valid values include:
18368 #
18369 #
18370 # - A number between 400 and 599: For example
18371 # 401 or 503, in which case the load balancer
18372 # applies the policy if the error code exactly matches this value.
18373 # - 5xx: Load Balancer will apply the policy if the
18374 # backend service responds with any response code in the range of
18375 # 500 to 599.
18376 # - 4xx: Load
18377 # Balancer will apply the policy if the backend service responds with any
18378 # response code in the range of 400 to
18379 # 499.
18380 #
18381 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
18382 &quot;A String&quot;,
18383 ],
18384 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
18385 # error content. If overrideResponseCode is not supplied, the
18386 # same response code returned by the original backend bucket or backend
18387 # service is returned to the client.
18388 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
18389 #
18390 # path must start
18391 # with a leading slash. path cannot have trailing slashes.
18392 #
18393 # If the file is not available in backendBucket or the
18394 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
18395 #
18396 # The value must
18397 # be from 1 to 1024 characters
18398 },
18399 ],
18400 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
18401 # contains the custom error content. Examples are:
18402 #
18403 #
18404 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
18405 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
18406 # - global/backendBuckets/myBackendBucket
18407 #
18408 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
18409 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
18410 #
18411 # If load balancer cannot reach
18412 # the backendBucket, a simple Not Found Error will
18413 # be returned, with the original response code (oroverrideResponseCode if configured).
18414 #
18415 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
18416 },
18417 &quot;paths&quot;: [ # The list of path patterns to match. Each must start with /
18418 # and the only place a * is allowed is at the end following
18419 # a /. The string fed to the path matcher does not include
18420 # any text after the first ? or #, and
18421 # those chars are not allowed here.
18422 &quot;A String&quot;,
18423 ],
18424 &quot;routeAction&quot;: { # In response to a matching path, the load balancer
18425 # performs advanced routing actions, such as URL rewrites and header
18426 # transformations, before forwarding the request to the selected
18427 # backend.
18428 #
18429 #
18430 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
18431 #
18432 #
18433 # URL maps for classic Application Load Balancers only support
18434 # the urlRewrite action within a path rule&#x27;srouteAction.
18435 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
18436 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
18437 # property must be specified. This policy cannot be specified if any target
18438 # backend has Identity-Aware Proxy enabled.
18439 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
18440 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
18441 # header names can be specified. The cache is bypassed for all `cacheMode`
18442 # values.
18443 &quot;A String&quot;,
18444 ],
18445 &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
18446 # on the backend type: for Backend Services, the complete request URI is
18447 # used; for Backend Buckets, the request URI is used without the protocol or
18448 # host, and only query parameters known to Cloud Storage are included.
18449 # Policy defined on Route Action.
18450 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
18451 # parameters will be included. Either specify `excludedQueryParameters`
18452 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
18453 # encoded and not treated as delimiters.
18454 #
18455 # Note: This field applies to routes that use backend services. Attempting
18456 # to set it on a route that points exclusively to Backend Buckets will
18457 # result in a configuration error. For routes that point to a Backend
18458 # Bucket, use `includedQueryParameters` to define which parameters should
18459 # be part of the cache key.
18460 &quot;A String&quot;,
18461 ],
18462 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
18463 #
18464 # Note: This setting is only applicable to routes that use a Backend
18465 # Service. It does not affect requests served by a Backend Bucket, as the
18466 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
18467 # it on a route that points exclusively to Backend Buckets will result in a
18468 # configuration error.
18469 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
18470 #
18471 # Note: This setting is only applicable to routes that use a Backend
18472 # Service. It does not affect requests served by a Backend Bucket, as the
18473 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
18474 # set on a route that points exclusively to Backend Buckets will result in
18475 # a configuration error.
18476 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
18477 # `includedQueryParameters` and `excludedQueryParameters`. If neither
18478 # is set, the entire query string will be included. If false, the query
18479 # string will be excluded from the cache key entirely.
18480 #
18481 # Note: This field applies to routes that use backend services. Attempting
18482 # to set it on a route that points exclusively to Backend Buckets will
18483 # result in a configuration error. For routes that point to a Backend
18484 # Bucket, use `includedQueryParameters` to define which parameters should
18485 # be part of the cache key.
18486 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
18487 # The name=value pair will be used in the cache key Cloud CDN generates.
18488 #
18489 # Note: This setting is only applicable to routes that use a Backend
18490 # Service. It does not affect requests served by a Backend Bucket.
18491 # Attempting to set it on a route that points exclusively to Backend
18492 # Buckets will result in a configuration error. Up to 5 cookie names can be
18493 # specified.
18494 &quot;A String&quot;,
18495 ],
18496 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
18497 &quot;A String&quot;,
18498 ],
18499 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
18500 # parameters will be excluded. Either specify `includedQueryParameters`
18501 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
18502 # encoded and not treated as delimiters.
18503 &quot;A String&quot;,
18504 ],
18505 },
18506 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
18507 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
18508 &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
18509 # content. This is used to clamp the max-age (or Expires) value sent to the
18510 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
18511 # is used for the response max-age directive, along with a &quot;public&quot;
18512 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
18513 # clamps the max-age from the origin (if specified), or else sets the
18514 # response max-age directive to the lesser of the `clientTtl` and
18515 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
18516 # present. The maximum allowed value is 31,622,400s (1 year). If not
18517 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
18518 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
18519 # `USE_ORIGIN_HEADERS`.
18520 # as a count of seconds and fractions of seconds at nanosecond
18521 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18522 # or &quot;month&quot;. Range is approximately 10,000 years.
18523 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18524 # Durations less than one second are represented with a 0
18525 # `seconds` field and a positive `nanos` field. Must be from 0
18526 # to 999,999,999 inclusive.
18527 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18528 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18529 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18530 },
18531 &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
18532 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
18533 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
18534 # greater than that of `maxTtl`. When the `cacheMode` is set to
18535 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
18536 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
18537 # accessed objects may be evicted from the cache before the defined TTL. If
18538 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
18539 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
18540 # `USE_ORIGIN_HEADERS`.
18541 # as a count of seconds and fractions of seconds at nanosecond
18542 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18543 # or &quot;month&quot;. Range is approximately 10,000 years.
18544 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18545 # Durations less than one second are represented with a 0
18546 # `seconds` field and a positive `nanos` field. Must be from 0
18547 # to 999,999,999 inclusive.
18548 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18549 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18550 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18551 },
18552 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
18553 # attempt to set a max-age or s-maxage higher than this, or an Expires header
18554 # more than `maxTtl` seconds in the future will be capped at the value of
18555 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
18556 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
18557 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
18558 # Infrequently accessed objects may be evicted from the cache before the
18559 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
18560 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
18561 # mode.
18562 # as a count of seconds and fractions of seconds at nanosecond
18563 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18564 # or &quot;month&quot;. Range is approximately 10,000 years.
18565 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18566 # Durations less than one second are represented with a 0
18567 # `seconds` field and a positive `nanos` field. Must be from 0
18568 # to 999,999,999 inclusive.
18569 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18570 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18571 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18572 },
18573 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
18574 # to apply fine-grained caching for common errors or redirects.
18575 # This can reduce the load on your origin and improve end-user
18576 # experience by reducing response latency.
18577 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
18578 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
18579 # the specified response code that lack any Cache-Control, Expires, or
18580 # Pragma: no-cache directives. When the `cacheMode` is set to
18581 # `FORCE_CACHE_ALL`, negative caching applies to all responses
18582 # with the specified response code, and overrides any caching headers. By
18583 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
18584 #
18585 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
18586 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
18587 # * 405 (Method Not Found), 501 (Not Implemented): 60s
18588 #
18589 # These defaults can be overridden in `negativeCachingPolicy`.
18590 # If not specified, Cloud CDN applies negative caching by default.
18591 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
18592 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
18593 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
18594 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
18595 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
18596 # all response codes that you wish to cache. Cloud CDN will not apply any
18597 # default negative caching when a policy exists.
18598 { # Specify CDN TTLs for response error codes.
18599 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
18600 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
18601 # specified as values, and you cannot specify a status code more than
18602 # once.
18603 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
18604 # corresponding status code.
18605 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
18606 # objects may be evicted from the cache before the defined TTL.
18607 # as a count of seconds and fractions of seconds at nanosecond
18608 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18609 # or &quot;month&quot;. Range is approximately 10,000 years.
18610 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18611 # Durations less than one second are represented with a 0
18612 # `seconds` field and a positive `nanos` field. Must be from 0
18613 # to 999,999,999 inclusive.
18614 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18615 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18616 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18617 },
18618 },
18619 ],
18620 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
18621 # requests into a small number of requests to the origin. If not specified,
18622 # Cloud CDN applies request coalescing by default.
18623 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
18624 # content with the origin, or when an error is encountered when refreshing
18625 # the cache.
18626 # This setting defines the default &quot;max-stale&quot; duration for any cached
18627 # responses that do not specify a max-stale directive. Stale responses that
18628 # exceed the TTL configured here will not be served. The default limit
18629 # (max-stale) is 86400s (1 day), which will allow stale content to be
18630 # served up to this limit beyond the max-age (or s-maxage) of a cached
18631 # response.
18632 # The maximum allowed value is 604800 (1 week).
18633 # Set this to zero (0) to disable serve-while-stale.
18634 # as a count of seconds and fractions of seconds at nanosecond
18635 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18636 # or &quot;month&quot;. Range is approximately 10,000 years.
18637 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18638 # Durations less than one second are represented with a 0
18639 # `seconds` field and a positive `nanos` field. Must be from 0
18640 # to 999,999,999 inclusive.
18641 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18642 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18643 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18644 },
18645 },
18646 &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
18647 # information about the W3C recommendation for cross-origin resource sharing
18648 # (CORS), see Fetch API Living
18649 # Standard.
18650 #
18651 # Not supported when the URL map is bound to a target gRPC proxy.
18652 # information about the W3C recommendation for cross-origin resource sharing
18653 # (CORS), see Fetch API Living
18654 # Standard.
18655 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
18656 # indicates that
18657 # the actual request can include user credentials. This field translates to
18658 # the Access-Control-Allow-Credentials header.
18659 #
18660 # Default is false.
18661 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
18662 # header.
18663 &quot;A String&quot;,
18664 ],
18665 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
18666 # header.
18667 &quot;A String&quot;,
18668 ],
18669 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
18670 # more information, see regular expression syntax.
18671 #
18672 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
18673 #
18674 # Regular expressions can only be used when the loadBalancingScheme is
18675 # set to INTERNAL_SELF_MANAGED.
18676 &quot;A String&quot;,
18677 ],
18678 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
18679 #
18680 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
18681 &quot;A String&quot;,
18682 ],
18683 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
18684 # The default value is false, which indicates that the CORS
18685 # policy is in effect.
18686 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
18687 # header.
18688 &quot;A String&quot;,
18689 ],
18690 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
18691 # seconds. This field translates to the Access-Control-Max-Age
18692 # header.
18693 },
18694 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
18695 # the resiliency of clients to backend service failure. As part of fault
18696 # injection, when clients send requests to a backend service, delays can be
18697 # introduced by a load balancer on a percentage of requests before sending
18698 # those requests to the backend service. Similarly requests from clients can
18699 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
18700 # that are configured with a fault_injection_policy if:
18701 # 1. The traffic is generated by fault injection AND
18702 # 2. The fault injection is not a delay fault injection.
18703 # Fault injection is not supported with the classic Application Load Balancer
18704 # . To see which load balancers support fault injection,
18705 # see Load
18706 # balancing: Routing and traffic management features.
18707 # the resiliency of clients to backend service failure. As part of fault
18708 # injection, when clients send requests to a backend service, delays can be
18709 # introduced by the load balancer on a percentage of requests before sending
18710 # those request to the backend service. Similarly requests from clients can be
18711 # aborted by the load balancer for a percentage of requests.
18712 &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
18713 # injection.
18714 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
18715 #
18716 # The value must be from 200 to 599 inclusive.
18717 #
18718 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
18719 # according to this
18720 # mapping table. HTTP status 200 is mapped to gRPC status
18721 # UNKNOWN. Injecting an OK status is currently not supported by
18722 # Traffic Director.
18723 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
18724 # that is aborted as part of fault injection.
18725 #
18726 # The value must be from 0.0 to 100.0 inclusive.
18727 },
18728 &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
18729 # injection, before being sent to a backend service.
18730 # request to the backend service as part of fault injection.
18731 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
18732 # as a count of seconds and fractions of seconds at nanosecond
18733 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18734 # or &quot;month&quot;. Range is approximately 10,000 years.
18735 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18736 # Durations less than one second are represented with a 0
18737 # `seconds` field and a positive `nanos` field. Must be from 0
18738 # to 999,999,999 inclusive.
18739 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18740 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18741 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18742 },
18743 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
18744 # which a delay is introduced as part of fault injection.
18745 #
18746 # The value must be from 0.0 to 100.0 inclusive.
18747 },
18748 },
18749 &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
18750 # Global EXTERNAL_MANAGED load balancer schemes.
18751 # Either Cloud CDN must be enabled on the backend service or backend bucket
18752 # serving the route, or cache policy must be configured on the same route
18753 # dynamically processes and delivers images from the network edge.
18754 # Image Optimization is only available for Global External Application Load
18755 # Balancers.
18756 # Either Cloud CDN must be enabled on the backend service or backend bucket
18757 # serving the route, or cache policy must be configured on the same route.
18758 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
18759 },
18760 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
18761 # Unlike the timeout field where the timeout duration starts
18762 # from the time the request has been fully processed (known as*end-of-stream*),
18763 # the duration in this field is computed from the beginning of the stream
18764 # until the response has been processed, including all retries. A
18765 # stream that does not complete in this duration is closed.
18766 #
18767 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
18768 # with the route.
18769 #
18770 # This field is only allowed if the Url map is used with backend services
18771 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
18772 # as a count of seconds and fractions of seconds at nanosecond
18773 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18774 # or &quot;month&quot;. Range is approximately 10,000 years.
18775 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18776 # Durations less than one second are represented with a 0
18777 # `seconds` field and a positive `nanos` field. Must be from 0
18778 # to 999,999,999 inclusive.
18779 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18780 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18781 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18782 },
18783 &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
18784 # are shadowed to a separate mirrored backend service. The load balancer does
18785 # not wait for responses from the shadow service. Before sending traffic
18786 # to the shadow service, the host / authority header is suffixed with-shadow.
18787 #
18788 # Not supported when the URL map is bound to a target gRPC proxy that
18789 # has the validateForProxyless field set to true.
18790 # are shadowed to a separate mirrored backend service. The load balancer
18791 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
18792 # to the shadow service, the host or authority header is suffixed with-shadow.
18793 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
18794 # mirrored to.
18795 #
18796 # The backend service configured for a mirroring
18797 # policy must reference backends that are of the same type as the original
18798 # backend service matched in the URL map.
18799 #
18800 # Serverless NEG backends are not currently supported as a mirrored
18801 # backend service.
18802 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
18803 },
18804 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
18805 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
18806 # If not specified, defaults to 1.
18807 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
18808 #
18809 # If not specified, will use the timeout set in theHttpRouteAction field.
18810 # If timeout in the HttpRouteAction field is not set, this field
18811 # uses the largest timeout
18812 # among all backend services associated with the route.
18813 #
18814 # Not supported when the URL map is bound to a target gRPC proxy that
18815 # has the validateForProxyless field set to true.
18816 # as a count of seconds and fractions of seconds at nanosecond
18817 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18818 # or &quot;month&quot;. Range is approximately 10,000 years.
18819 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18820 # Durations less than one second are represented with a 0
18821 # `seconds` field and a positive `nanos` field. Must be from 0
18822 # to 999,999,999 inclusive.
18823 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18824 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18825 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18826 },
18827 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
18828 # values are:
18829 #
18830 # - 5xx: retry is attempted if the instance or endpoint
18831 # responds with any 5xx response code, or if the instance or
18832 # endpoint does not respond at all. For example, disconnects, reset, read
18833 # timeout, connection failure, and refused streams.
18834 # - gateway-error: Similar to 5xx, but only
18835 # applies to response codes 502, 503 or504.
18836 # - connect-failure: a retry is attempted on failures
18837 # connecting to the instance or endpoint. For example, connection
18838 # timeouts.
18839 # - retriable-4xx: a retry is attempted if the instance
18840 # or endpoint responds with a 4xx response code.
18841 # The only error that you can retry is error code 409.
18842 # - refused-stream: a retry is attempted if the instance
18843 # or endpoint resets the stream with a REFUSED_STREAM error
18844 # code. This reset type indicates that it is safe to retry.
18845 # - cancelled: a retry is attempted if the gRPC status
18846 # code in the response header is set to cancelled.
18847 # - deadline-exceeded: a retry is attempted if the gRPC
18848 # status code in the response header is set todeadline-exceeded.
18849 # - internal: a retry is attempted if the gRPC
18850 # status code in the response header is set tointernal.
18851 # - resource-exhausted: a retry is attempted if the gRPC
18852 # status code in the response header is set toresource-exhausted.
18853 # - unavailable: a retry is attempted if the gRPC
18854 # status code in the response header is set tounavailable.
18855 #
18856 # Only the following codes are supported when the URL map is bound to
18857 # target gRPC proxy that has validateForProxyless field set to true.
18858 #
18859 # - cancelled
18860 # - deadline-exceeded
18861 # - internal
18862 # - resource-exhausted
18863 # - unavailable
18864 &quot;A String&quot;,
18865 ],
18866 },
18867 &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
18868 # time the request has been fully processed (known as *end-of-stream*)
18869 # up until the response has been processed. Timeout includes
18870 # all retries.
18871 #
18872 # If not specified, this field uses the largest timeout among all backend
18873 # services associated with the route.
18874 #
18875 # Not supported when the URL map is bound to a target gRPC proxy that
18876 # has validateForProxyless field set to true.
18877 # as a count of seconds and fractions of seconds at nanosecond
18878 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18879 # or &quot;month&quot;. Range is approximately 10,000 years.
18880 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18881 # Durations less than one second are represented with a 0
18882 # `seconds` field and a positive `nanos` field. Must be from 0
18883 # to 999,999,999 inclusive.
18884 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18885 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18886 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18887 },
18888 &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
18889 # to the matched service.
18890 #
18891 # urlRewrite is the only action supported in UrlMaps
18892 # for classic Application Load Balancers.
18893 #
18894 # Not supported when the URL map is bound to a target gRPC proxy that
18895 # has the validateForProxyless field set to true.
18896 # backend service.
18897 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
18898 # host header is replaced with contents of hostRewrite.
18899 #
18900 # The value must be from 1 to 255 characters.
18901 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
18902 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
18903 #
18904 # The value must be from 1 to 1024 characters.
18905 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
18906 # header) using the HTTP template syntax.
18907 #
18908 # A corresponding
18909 # path_template_match must be specified. Any template variables must exist in
18910 # the path_template_match field.
18911 #
18912 #
18913 # - -At least one variable must be specified in the path_template_match
18914 # field
18915 # - You can omit variables from the rewritten URL
18916 # - The * and ** operators cannot be matched
18917 # unless they have a corresponding variable name - e.g.
18918 # {format=*} or {var=**}.
18919 #
18920 # For example, a path_template_match of /static/{format=**}
18921 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
18922 # rewrite, so that /{country}/{format}/{suffix=**} can be
18923 # rewritten as /content/{format}/{country}/{suffix}.
18924 #
18925 # At least
18926 # one non-empty routeRules[].matchRules[].path_template_match is
18927 # required.
18928 #
18929 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
18930 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
18931 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
18932 # It uses RE2 syntax with the following constraints:
18933 #
18934 #
18935 # - Any single character operators
18936 # - Groups are allowed to have only submatch operator inside
18937 # - Groups are allowed only without any char repetition, e.g.
18938 # .*
18939 # - Any char repetition, e.g. .*, is
18940 # only allowed to be used in a single regex together with:
18941 #
18942 #
18943 # - Empty string operators
18944 # - Other repetitions
18945 # - Ranges
18946 # - Repetitions of ranges
18947 #
18948 #
18949 # - Ranges are only allowed to have:
18950 #
18951 #
18952 # - Character range
18953 # - Digits range
18954 # - Symbols listed in characters allowed for ranges
18955 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
18956 # the path.
18957 },
18958 },
18959 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
18960 # occurs. The weights determine the fraction of traffic that flows to
18961 # their corresponding backend service. If all traffic needs to
18962 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
18963 #
18964 # After a backend service is identified and before forwarding
18965 # the request to
18966 # the backend service, advanced routing actions such as URL rewrites and
18967 # header transformations are applied depending on additional settings
18968 # specified in this HttpRouteAction.
18969 { # In contrast to a single BackendService in
18970 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
18971 # multiple backend services. The volume of traffic for each
18972 # backend service is proportional to the weight specified
18973 # in each WeightedBackendService
18974 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
18975 # resource. Before
18976 # forwarding the request to backendService, the load balancer
18977 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
18978 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
18979 # effect for the selected backendService.
18980 #
18981 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
18982 #
18983 # headerAction is not supported for load balancers that have
18984 # their loadBalancingScheme set to EXTERNAL.
18985 #
18986 # Not supported when the URL map is bound to a target gRPC proxy that
18987 # has validateForProxyless field set to true.
18988 # the request is passed along to the selected backendService.
18989 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
18990 { # Specification determining how headers are added to requests or responses.
18991 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
18992 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
18993 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
18994 # that already
18995 # exist for the header. If true, headerValue is set for the
18996 # header, discarding any values that were set for that header.
18997 #
18998 # The default value is true,
18999 # unless a variable is present in headerValue,
19000 # in which case the default value is false.
19001 # .
19002 },
19003 ],
19004 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
19005 # request before forwarding the request to the backendService.
19006 &quot;A String&quot;,
19007 ],
19008 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
19009 # client.
19010 { # Specification determining how headers are added to requests or responses.
19011 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
19012 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
19013 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
19014 # that already
19015 # exist for the header. If true, headerValue is set for the
19016 # header, discarding any values that were set for that header.
19017 #
19018 # The default value is true,
19019 # unless a variable is present in headerValue,
19020 # in which case the default value is false.
19021 # .
19022 },
19023 ],
19024 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
19025 # response before sending the response back to the client.
19026 &quot;A String&quot;,
19027 ],
19028 },
19029 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
19030 # computed asweight / (sum of all weightedBackendService weights in routeAction).
19031 #
19032 # The selection of a backend service is determined only for new traffic.
19033 # Once a user&#x27;s request has been directed to a backend service,
19034 # subsequent requests are sent to the same backend service as
19035 # determined by the backend service&#x27;s session affinity policy.
19036 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
19037 # splitting. If you do, the weighted traffic splitting configuration takes
19038 # precedence.
19039 #
19040 # The value must be from 0 to 1000.
19041 },
19042 ],
19043 },
19044 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
19045 # is directed if this rule is matched. If routeAction is
19046 # also specified, advanced routing actions, such as URL rewrites,
19047 # take effect before sending the request to the backend.
19048 #
19049 #
19050 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
19051 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
19052 # specified by urlRedirect.
19053 #
19054 #
19055 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
19056 #
19057 #
19058 # Not supported when the URL map is bound to a target gRPC proxy.
19059 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
19060 # was supplied in the request.
19061 #
19062 # The value must be from 1 to 255
19063 # characters.
19064 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
19065 # set to HTTPS.
19066 # If set to false, the URL scheme of the redirected request
19067 # remains the same as that of the request.
19068 #
19069 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
19070 #
19071 # The default is set to false.
19072 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
19073 # that was supplied in the request.
19074 #
19075 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
19076 # supplied, the path of the original request is used for the redirect.
19077 #
19078 # The value must be from 1 to 1024 characters.
19079 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
19080 # the HttpRouteRuleMatch, retaining the remaining portion
19081 # of the URL before redirecting the request.
19082 #
19083 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
19084 # supplied, the path of the original request is used for the redirect.
19085 #
19086 # The value must be from 1 to 1024 characters.
19087 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
19088 #
19089 # Supported values are:
19090 #
19091 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
19092 # to 301.
19093 # - FOUND, which corresponds to 302.
19094 # - SEE_OTHER which corresponds to 303.
19095 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
19096 # method is retained.
19097 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
19098 # method is retained.
19099 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
19100 # URL is
19101 # removed before redirecting the request. If set to false, the
19102 # query portion of the original URL is retained.
19103 #
19104 # The default is set to false.
19105 },
19106 },
19107 ],
19108 &quot;routeRules&quot;: [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
19109 # desired. routeRules are evaluated in order of priority, from
19110 # the lowest to highest number.
19111 #
19112 # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
19113 { # The HttpRouteRule setting specifies how to match an HTTP request
19114 # and the corresponding routing action that load balancing proxies perform.
19115 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
19116 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
19117 #
19118 # If a policy for an
19119 # error code is not configured for the RouteRule, a policy for
19120 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
19121 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
19122 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
19123 # effect.
19124 #
19125 # For example, consider a UrlMap with the following configuration:
19126 #
19127 #
19128 # - UrlMap.defaultCustomErrorResponsePolicy are configured
19129 # with policies for 5xx and 4xx errors
19130 # - A RouteRule for /coming_soon/ is configured for the
19131 # error code 404.
19132 #
19133 # 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
19134 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
19135 # the policy in RouteRule.customErrorResponsePolicy takes
19136 # effect. If any of the requests in this example encounter a 500
19137 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
19138 #
19139 # When
19140 # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
19141 # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
19142 # a retry, if load balancer is successful in reaching the
19143 # service, the customErrorResponsePolicy is ignored and
19144 # the response from the service is returned to the client.
19145 #
19146 # customErrorResponsePolicy is supported only for
19147 # global external Application Load Balancers.
19148 # backend service or backend bucket responds with an error.
19149 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
19150 #
19151 # In a given policy, if you specify rules for both a range of error codes
19152 # as well as rules for specific error codes then rules with specific error
19153 # codes have a higher priority. For example, assume that you configure a rule
19154 # for 401 (Un-authorized) code, and another for all 4 series
19155 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
19156 # However if the backend service returns a 403, the rule for4xx takes effect.
19157 { # Specifies the mapping between the response code that will be returned along
19158 # with the custom error content and the response code returned by the backend
19159 # service.
19160 &quot;matchResponseCodes&quot;: [ # Valid values include:
19161 #
19162 #
19163 # - A number between 400 and 599: For example
19164 # 401 or 503, in which case the load balancer
19165 # applies the policy if the error code exactly matches this value.
19166 # - 5xx: Load Balancer will apply the policy if the
19167 # backend service responds with any response code in the range of
19168 # 500 to 599.
19169 # - 4xx: Load
19170 # Balancer will apply the policy if the backend service responds with any
19171 # response code in the range of 400 to
19172 # 499.
19173 #
19174 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
19175 &quot;A String&quot;,
19176 ],
19177 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
19178 # error content. If overrideResponseCode is not supplied, the
19179 # same response code returned by the original backend bucket or backend
19180 # service is returned to the client.
19181 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
19182 #
19183 # path must start
19184 # with a leading slash. path cannot have trailing slashes.
19185 #
19186 # If the file is not available in backendBucket or the
19187 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
19188 #
19189 # The value must
19190 # be from 1 to 1024 characters
19191 },
19192 ],
19193 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
19194 # contains the custom error content. Examples are:
19195 #
19196 #
19197 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
19198 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
19199 # - global/backendBuckets/myBackendBucket
19200 #
19201 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
19202 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
19203 #
19204 # If load balancer cannot reach
19205 # the backendBucket, a simple Not Found Error will
19206 # be returned, with the original response code (oroverrideResponseCode if configured).
19207 #
19208 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
19209 },
19210 &quot;description&quot;: &quot;A String&quot;, # The short description conveying the intent of this routeRule.
19211 #
19212 #
19213 # The description can have a maximum length of 1024 characters.
19214 &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
19215 # for the selected backendService.
19216 #
19217 # The headerAction value specified here is applied before the
19218 # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
19219 #
19220 # HeaderAction is not supported for load balancers
19221 # that have
19222 # their loadBalancingScheme set to EXTERNAL.
19223 #
19224 # Not supported when the URL map is bound to a target gRPC proxy that
19225 # has validateForProxyless field set to true.
19226 # the request is passed along to the selected backendService.
19227 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
19228 { # Specification determining how headers are added to requests or responses.
19229 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
19230 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
19231 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
19232 # that already
19233 # exist for the header. If true, headerValue is set for the
19234 # header, discarding any values that were set for that header.
19235 #
19236 # The default value is true,
19237 # unless a variable is present in headerValue,
19238 # in which case the default value is false.
19239 # .
19240 },
19241 ],
19242 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
19243 # request before forwarding the request to the backendService.
19244 &quot;A String&quot;,
19245 ],
19246 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
19247 # client.
19248 { # Specification determining how headers are added to requests or responses.
19249 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
19250 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
19251 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
19252 # that already
19253 # exist for the header. If true, headerValue is set for the
19254 # header, discarding any values that were set for that header.
19255 #
19256 # The default value is true,
19257 # unless a variable is present in headerValue,
19258 # in which case the default value is false.
19259 # .
19260 },
19261 ],
19262 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
19263 # response before sending the response back to the client.
19264 &quot;A String&quot;,
19265 ],
19266 },
19267 &quot;httpFilterConfigs&quot;: [ # Outbound route specific configuration fornetworkservices.HttpFilter resources enabled by Traffic
19268 # Director. httpFilterConfigs only applies for load balancers
19269 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
19270 # more details.
19271 #
19272 # Not supported when the URL map is bound to a target gRPC proxy that
19273 # has validateForProxyless field set to true.
19274 { # HttpFilterConfiguration supplies additional contextual settings
19275 # for networkservices.HttpFilter resources enabled by Traffic
19276 # Director.
19277 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
19278 # YAML formatted and only contain fields defined in the protobuf identified
19279 # in configTypeUrl
19280 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
19281 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
19282 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
19283 # configuration belongs to. This name must be known to the xDS client.
19284 # Example: envoy.wasm
19285 },
19286 ],
19287 &quot;httpFilterMetadata&quot;: [ # Outbound route specific metadata supplied tonetworkservices.HttpFilter resources enabled by Traffic
19288 # Director. httpFilterMetadata only applies for load balancers
19289 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
19290 # more details.
19291 #
19292 # The only configTypeUrl supported istype.googleapis.com/google.protobuf.Struct
19293 #
19294 # Not supported when the URL map is bound to a target gRPC proxy that
19295 # has validateForProxyless field set to true.
19296 { # HttpFilterConfiguration supplies additional contextual settings
19297 # for networkservices.HttpFilter resources enabled by Traffic
19298 # Director.
19299 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
19300 # YAML formatted and only contain fields defined in the protobuf identified
19301 # in configTypeUrl
19302 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
19303 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
19304 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
19305 # configuration belongs to. This name must be known to the xDS client.
19306 # Example: envoy.wasm
19307 },
19308 ],
19309 &quot;matchRules&quot;: [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
19310 # this routeRule when any of thematchRules are satisfied. However predicates within
19311 # a given matchRule have AND semantics. All predicates
19312 # within a matchRule must match for the request to
19313 # match the rule.
19314 { # HttpRouteRuleMatch specifies a set of criteria for matching
19315 # requests to an HttpRouteRule. All specified criteria must
19316 # be satisfied for a match to occur.
19317 &quot;fullPathMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
19318 # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
19319 # that may be part of the original URL.
19320 #
19321 # fullPathMatch must be from 1 to 1024 characters.
19322 #
19323 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
19324 # specified.
19325 &quot;headerMatches&quot;: [ # Specifies a list of header match criteria, all of which must match
19326 # corresponding headers in the request.
19327 { # matchRule criteria for request header matches.
19328 &quot;exactMatch&quot;: &quot;A String&quot;, # The value should exactly match contents of exactMatch.
19329 #
19330 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
19331 &quot;headerName&quot;: &quot;A String&quot;, # The name of the HTTP header to match.
19332 #
19333 # For matching against the HTTP request&#x27;s authority, use a headerMatch
19334 # with the header name &quot;:authority&quot;.
19335 #
19336 # For matching a request&#x27;s method, use the headerName &quot;:method&quot;.
19337 #
19338 # When the URL map is bound to a target gRPC proxy that has
19339 # the validateForProxyless field set to true, only
19340 # non-binary
19341 # user-specified custom metadata and the `content-type` header are supported.
19342 # The following transport-level headers cannot be used in header matching
19343 # rules:
19344 # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
19345 # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
19346 # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
19347 # `grpc-timeout` and `grpc-trace-bin`.
19348 &quot;invertMatch&quot;: True or False, # If set to false, the headerMatch is considered a
19349 # match if the preceding match criteria are met. If set to true,
19350 # the headerMatch is considered a match if the preceding
19351 # match criteria are NOT met.
19352 #
19353 # The default setting is false.
19354 &quot;prefixMatch&quot;: &quot;A String&quot;, # The value of the header must start with the contents ofprefixMatch.
19355 #
19356 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
19357 &quot;presentMatch&quot;: True or False, # A header with the contents of headerName must exist. The
19358 # match takes place whether or not the request&#x27;s header has a value.
19359 #
19360 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
19361 &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
19362 # specified in rangeMatch. If the header does not contain an
19363 # integer, number or is empty, the match fails.
19364 #
19365 # For example for a range [-5, 0]
19366 #
19367 #
19368 # - -3 will match.
19369 # - 0 will not match.
19370 # - 0.25 will not match.
19371 # - -3someString will not match.
19372 #
19373 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
19374 #
19375 # rangeMatch is not supported for load balancers
19376 # that have loadBalancingScheme set to EXTERNAL.
19377 # within the specified integer range.
19378 &quot;rangeEnd&quot;: &quot;A String&quot;, # The end of the range (exclusive) in signed long integer format.
19379 &quot;rangeStart&quot;: &quot;A String&quot;, # The start of the range (inclusive) in signed long integer format.
19380 },
19381 &quot;regexMatch&quot;: &quot;A String&quot;, # The value of the header must match the regular expression specified inregexMatch.
19382 # For more information about regular expression syntax, see Syntax.
19383 #
19384 # For matching against a port specified in the HTTP request, use a
19385 # headerMatch with headerName set to PORT and a regular expression that
19386 # satisfies the RFC2616 Host header&#x27;s port specifier.
19387 #
19388 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
19389 #
19390 # Regular expressions can only be used when the loadBalancingScheme is
19391 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
19392 # (regional scope) or INTERNAL_MANAGED.
19393 &quot;suffixMatch&quot;: &quot;A String&quot;, # The value of the header must end with the contents ofsuffixMatch.
19394 #
19395 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
19396 },
19397 ],
19398 &quot;ignoreCase&quot;: True or False, # Specifies that prefixMatch and fullPathMatch
19399 # matches are case sensitive.
19400 #
19401 # The default value is false.
19402 #
19403 # ignoreCase must not be used with regexMatch.
19404 #
19405 # Not supported when the URL map is bound to a target gRPC proxy.
19406 &quot;metadataFilters&quot;: [ # Opaque filter criteria used by the load balancer to restrict routing
19407 # configuration to a limited set of xDS
19408 # compliant clients. In their xDS requests to the load balancer, xDS clients
19409 # present node
19410 # metadata. When there is a match, the relevant routing configuration
19411 # is made available to those proxies.
19412 #
19413 # 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
19414 # the metadata. If its filterMatchCriteria is set to
19415 # MATCH_ALL, then all of its filterLabels must match with
19416 # corresponding labels provided in the metadata. If multiple
19417 # metadata filters are specified, all of them need to be
19418 # satisfied in order to be considered a match.
19419 #
19420 # metadataFilters specified here is applied after those
19421 # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
19422 #
19423 # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
19424 #
19425 # Not supported when the URL map is bound to a target gRPC proxy that
19426 # has validateForProxyless field set to true.
19427 { # Opaque filter criteria used by load balancers to restrict routing
19428 # configuration to a limited set of load balancing proxies. Proxies and
19429 # sidecars involved in load balancing would typically present metadata to the
19430 # load balancers that need to match criteria specified here. If a match takes
19431 # place, the relevant configuration is made available to those
19432 # proxies.
19433 #
19434 # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
19435 # one of thefilterLabels must match the corresponding label provided in
19436 # the metadata. If its filterMatchCriteria is set to
19437 # MATCH_ALL, then all of its filterLabels must match with
19438 # corresponding labels provided in the metadata.
19439 #
19440 # An example for using metadataFilters would be: if
19441 # load balancing involves
19442 # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in of their XDS requests to loadbalancers.
19443 &quot;filterLabels&quot;: [ # The list of label value pairs that must match labels in the provided
19444 # metadata based on filterMatchCriteria
19445 #
19446 # This list must not be empty and can have at the most 64 entries.
19447 { # MetadataFilter label name value pairs that are expected
19448 # to match corresponding labels presented as metadata to the load balancer.
19449 &quot;name&quot;: &quot;A String&quot;, # Name of metadata label.
19450 #
19451 # The name can have a maximum length of 1024 characters and must be at
19452 # least 1 character long.
19453 &quot;value&quot;: &quot;A String&quot;, # The value of the label must match the specified value.
19454 #
19455 # value can have a maximum length of 1024 characters.
19456 },
19457 ],
19458 &quot;filterMatchCriteria&quot;: &quot;A String&quot;, # Specifies how individual filter label matches
19459 # within the list of filterLabels and contributes toward the
19460 # overall metadataFilter match.
19461 #
19462 # Supported values are:
19463 #
19464 # - MATCH_ANY: at least one of the filterLabels
19465 # must have a matching label in the provided metadata.
19466 # - MATCH_ALL: all filterLabels must have
19467 # matching labels in the provided metadata.
19468 },
19469 ],
19470 &quot;pathTemplateMatch&quot;: &quot;A String&quot;, # If specified, this field defines a path template pattern that must match
19471 # the :path header after the query string is removed.
19472 #
19473 # A path template pattern can include variables and wildcards.
19474 # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
19475 # matches a single path segment, and ** that matches zero or
19476 # more path segments. The pattern must follow these rules:
19477 #
19478 #
19479 # - The value must be between 1 and 1024 characters.
19480 # - The pattern must start with a leading slash (&quot;/&quot;).
19481 # - No more than 5 operators (variables or wildcards) may appear in
19482 # the pattern.
19483 #
19484 # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
19485 # set.
19486 &quot;prefixMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the request&#x27;s
19487 # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
19488 #
19489 # The value must be from 1 to 1024 characters.
19490 #
19491 # The * character inside a prefix match is
19492 # treated as a literal character, not as a wildcard.
19493 #
19494 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
19495 # used within a matchRule.
19496 &quot;queryParameterMatches&quot;: [ # Specifies a list of query parameter match criteria, all of which must
19497 # match corresponding query parameters in the request.
19498 #
19499 # Not supported when the URL map is bound to a target gRPC proxy.
19500 { # HttpRouteRuleMatch criteria for a request&#x27;s query parameter.
19501 &quot;exactMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
19502 # parameter exactly matches the contents of exactMatch.
19503 #
19504 # Only one of presentMatch, exactMatch, orregexMatch must be set.
19505 &quot;name&quot;: &quot;A String&quot;, # The name of the query parameter to match. The query parameter must exist in
19506 # the request, in the absence of which the request match fails.
19507 &quot;presentMatch&quot;: True or False, # Specifies that the queryParameterMatch matches if the
19508 # request contains the query parameter, irrespective of whether the
19509 # parameter has a value or not.
19510 #
19511 # Only one of presentMatch, exactMatch, orregexMatch must be set.
19512 &quot;regexMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
19513 # parameter matches the regular expression specified byregexMatch. For
19514 # more information about regular expression syntax, see Syntax.
19515 #
19516 # Only one of presentMatch, exactMatch, orregexMatch must be set.
19517 #
19518 # Regular expressions can only be used when the loadBalancingScheme is
19519 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
19520 # (regional scope) or INTERNAL_MANAGED.
19521 },
19522 ],
19523 &quot;regexMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
19524 # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
19525 # supplied with the original URL. For
19526 # more information about regular expression syntax, see Syntax.
19527 #
19528 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
19529 # specified.
19530 #
19531 # Regular expressions can only be used when the loadBalancingScheme is
19532 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
19533 # (regional scope) or INTERNAL_MANAGED.
19534 },
19535 ],
19536 &quot;priority&quot;: 42, # For routeRules within a given pathMatcher,
19537 # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
19538 # of priority, from the lowest to highest number. The priority of a
19539 # rule decreases as its number increases (1, 2, 3, N+1). The first rule
19540 # that matches the request is applied.
19541 #
19542 #
19543 # You cannot configure two or more routeRules with the same priority.
19544 # Priority for each rule must be set to a number from 0 to 2147483647
19545 # inclusive.
19546 #
19547 #
19548 # Priority numbers can have gaps, which enable you to add or remove rules
19549 # in the future without affecting the rest of the rules. For example, 1, 2,
19550 # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
19551 # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
19552 # without any impact on existing rules.
19553 &quot;routeAction&quot;: { # In response to a matching matchRule, the load balancer
19554 # performs advanced routing actions, such as URL rewrites and header
19555 # transformations, before forwarding the request to the selected backend.
19556 #
19557 #
19558 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
19559 #
19560 #
19561 # URL maps for classic Application Load Balancers only support
19562 # the urlRewrite action within a route rule&#x27;srouteAction.
19563 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
19564 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
19565 # property must be specified. This policy cannot be specified if any target
19566 # backend has Identity-Aware Proxy enabled.
19567 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
19568 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
19569 # header names can be specified. The cache is bypassed for all `cacheMode`
19570 # values.
19571 &quot;A String&quot;,
19572 ],
19573 &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
19574 # on the backend type: for Backend Services, the complete request URI is
19575 # used; for Backend Buckets, the request URI is used without the protocol or
19576 # host, and only query parameters known to Cloud Storage are included.
19577 # Policy defined on Route Action.
19578 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
19579 # parameters will be included. Either specify `excludedQueryParameters`
19580 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
19581 # encoded and not treated as delimiters.
19582 #
19583 # Note: This field applies to routes that use backend services. Attempting
19584 # to set it on a route that points exclusively to Backend Buckets will
19585 # result in a configuration error. For routes that point to a Backend
19586 # Bucket, use `includedQueryParameters` to define which parameters should
19587 # be part of the cache key.
19588 &quot;A String&quot;,
19589 ],
19590 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
19591 #
19592 # Note: This setting is only applicable to routes that use a Backend
19593 # Service. It does not affect requests served by a Backend Bucket, as the
19594 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
19595 # it on a route that points exclusively to Backend Buckets will result in a
19596 # configuration error.
19597 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
19598 #
19599 # Note: This setting is only applicable to routes that use a Backend
19600 # Service. It does not affect requests served by a Backend Bucket, as the
19601 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
19602 # set on a route that points exclusively to Backend Buckets will result in
19603 # a configuration error.
19604 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
19605 # `includedQueryParameters` and `excludedQueryParameters`. If neither
19606 # is set, the entire query string will be included. If false, the query
19607 # string will be excluded from the cache key entirely.
19608 #
19609 # Note: This field applies to routes that use backend services. Attempting
19610 # to set it on a route that points exclusively to Backend Buckets will
19611 # result in a configuration error. For routes that point to a Backend
19612 # Bucket, use `includedQueryParameters` to define which parameters should
19613 # be part of the cache key.
19614 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
19615 # The name=value pair will be used in the cache key Cloud CDN generates.
19616 #
19617 # Note: This setting is only applicable to routes that use a Backend
19618 # Service. It does not affect requests served by a Backend Bucket.
19619 # Attempting to set it on a route that points exclusively to Backend
19620 # Buckets will result in a configuration error. Up to 5 cookie names can be
19621 # specified.
19622 &quot;A String&quot;,
19623 ],
19624 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
19625 &quot;A String&quot;,
19626 ],
19627 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
19628 # parameters will be excluded. Either specify `includedQueryParameters`
19629 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
19630 # encoded and not treated as delimiters.
19631 &quot;A String&quot;,
19632 ],
19633 },
19634 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
19635 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
19636 &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
19637 # content. This is used to clamp the max-age (or Expires) value sent to the
19638 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
19639 # is used for the response max-age directive, along with a &quot;public&quot;
19640 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
19641 # clamps the max-age from the origin (if specified), or else sets the
19642 # response max-age directive to the lesser of the `clientTtl` and
19643 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
19644 # present. The maximum allowed value is 31,622,400s (1 year). If not
19645 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
19646 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
19647 # `USE_ORIGIN_HEADERS`.
19648 # as a count of seconds and fractions of seconds at nanosecond
19649 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19650 # or &quot;month&quot;. Range is approximately 10,000 years.
19651 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19652 # Durations less than one second are represented with a 0
19653 # `seconds` field and a positive `nanos` field. Must be from 0
19654 # to 999,999,999 inclusive.
19655 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19656 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19657 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19658 },
19659 &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
19660 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
19661 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
19662 # greater than that of `maxTtl`. When the `cacheMode` is set to
19663 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
19664 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
19665 # accessed objects may be evicted from the cache before the defined TTL. If
19666 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
19667 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
19668 # `USE_ORIGIN_HEADERS`.
19669 # as a count of seconds and fractions of seconds at nanosecond
19670 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19671 # or &quot;month&quot;. Range is approximately 10,000 years.
19672 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19673 # Durations less than one second are represented with a 0
19674 # `seconds` field and a positive `nanos` field. Must be from 0
19675 # to 999,999,999 inclusive.
19676 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19677 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19678 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19679 },
19680 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
19681 # attempt to set a max-age or s-maxage higher than this, or an Expires header
19682 # more than `maxTtl` seconds in the future will be capped at the value of
19683 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
19684 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
19685 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
19686 # Infrequently accessed objects may be evicted from the cache before the
19687 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
19688 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
19689 # mode.
19690 # as a count of seconds and fractions of seconds at nanosecond
19691 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19692 # or &quot;month&quot;. Range is approximately 10,000 years.
19693 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19694 # Durations less than one second are represented with a 0
19695 # `seconds` field and a positive `nanos` field. Must be from 0
19696 # to 999,999,999 inclusive.
19697 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19698 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19699 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19700 },
19701 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
19702 # to apply fine-grained caching for common errors or redirects.
19703 # This can reduce the load on your origin and improve end-user
19704 # experience by reducing response latency.
19705 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
19706 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
19707 # the specified response code that lack any Cache-Control, Expires, or
19708 # Pragma: no-cache directives. When the `cacheMode` is set to
19709 # `FORCE_CACHE_ALL`, negative caching applies to all responses
19710 # with the specified response code, and overrides any caching headers. By
19711 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
19712 #
19713 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
19714 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
19715 # * 405 (Method Not Found), 501 (Not Implemented): 60s
19716 #
19717 # These defaults can be overridden in `negativeCachingPolicy`.
19718 # If not specified, Cloud CDN applies negative caching by default.
19719 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
19720 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
19721 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
19722 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
19723 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
19724 # all response codes that you wish to cache. Cloud CDN will not apply any
19725 # default negative caching when a policy exists.
19726 { # Specify CDN TTLs for response error codes.
19727 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
19728 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
19729 # specified as values, and you cannot specify a status code more than
19730 # once.
19731 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
19732 # corresponding status code.
19733 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
19734 # objects may be evicted from the cache before the defined TTL.
19735 # as a count of seconds and fractions of seconds at nanosecond
19736 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19737 # or &quot;month&quot;. Range is approximately 10,000 years.
19738 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19739 # Durations less than one second are represented with a 0
19740 # `seconds` field and a positive `nanos` field. Must be from 0
19741 # to 999,999,999 inclusive.
19742 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19743 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19744 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19745 },
19746 },
19747 ],
19748 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
19749 # requests into a small number of requests to the origin. If not specified,
19750 # Cloud CDN applies request coalescing by default.
19751 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
19752 # content with the origin, or when an error is encountered when refreshing
19753 # the cache.
19754 # This setting defines the default &quot;max-stale&quot; duration for any cached
19755 # responses that do not specify a max-stale directive. Stale responses that
19756 # exceed the TTL configured here will not be served. The default limit
19757 # (max-stale) is 86400s (1 day), which will allow stale content to be
19758 # served up to this limit beyond the max-age (or s-maxage) of a cached
19759 # response.
19760 # The maximum allowed value is 604800 (1 week).
19761 # Set this to zero (0) to disable serve-while-stale.
19762 # as a count of seconds and fractions of seconds at nanosecond
19763 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19764 # or &quot;month&quot;. Range is approximately 10,000 years.
19765 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19766 # Durations less than one second are represented with a 0
19767 # `seconds` field and a positive `nanos` field. Must be from 0
19768 # to 999,999,999 inclusive.
19769 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19770 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19771 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19772 },
19773 },
19774 &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
19775 # information about the W3C recommendation for cross-origin resource sharing
19776 # (CORS), see Fetch API Living
19777 # Standard.
19778 #
19779 # Not supported when the URL map is bound to a target gRPC proxy.
19780 # information about the W3C recommendation for cross-origin resource sharing
19781 # (CORS), see Fetch API Living
19782 # Standard.
19783 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
19784 # indicates that
19785 # the actual request can include user credentials. This field translates to
19786 # the Access-Control-Allow-Credentials header.
19787 #
19788 # Default is false.
19789 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
19790 # header.
19791 &quot;A String&quot;,
19792 ],
19793 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
19794 # header.
19795 &quot;A String&quot;,
19796 ],
19797 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
19798 # more information, see regular expression syntax.
19799 #
19800 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
19801 #
19802 # Regular expressions can only be used when the loadBalancingScheme is
19803 # set to INTERNAL_SELF_MANAGED.
19804 &quot;A String&quot;,
19805 ],
19806 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
19807 #
19808 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
19809 &quot;A String&quot;,
19810 ],
19811 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
19812 # The default value is false, which indicates that the CORS
19813 # policy is in effect.
19814 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
19815 # header.
19816 &quot;A String&quot;,
19817 ],
19818 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
19819 # seconds. This field translates to the Access-Control-Max-Age
19820 # header.
19821 },
19822 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
19823 # the resiliency of clients to backend service failure. As part of fault
19824 # injection, when clients send requests to a backend service, delays can be
19825 # introduced by a load balancer on a percentage of requests before sending
19826 # those requests to the backend service. Similarly requests from clients can
19827 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
19828 # that are configured with a fault_injection_policy if:
19829 # 1. The traffic is generated by fault injection AND
19830 # 2. The fault injection is not a delay fault injection.
19831 # Fault injection is not supported with the classic Application Load Balancer
19832 # . To see which load balancers support fault injection,
19833 # see Load
19834 # balancing: Routing and traffic management features.
19835 # the resiliency of clients to backend service failure. As part of fault
19836 # injection, when clients send requests to a backend service, delays can be
19837 # introduced by the load balancer on a percentage of requests before sending
19838 # those request to the backend service. Similarly requests from clients can be
19839 # aborted by the load balancer for a percentage of requests.
19840 &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
19841 # injection.
19842 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
19843 #
19844 # The value must be from 200 to 599 inclusive.
19845 #
19846 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
19847 # according to this
19848 # mapping table. HTTP status 200 is mapped to gRPC status
19849 # UNKNOWN. Injecting an OK status is currently not supported by
19850 # Traffic Director.
19851 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
19852 # that is aborted as part of fault injection.
19853 #
19854 # The value must be from 0.0 to 100.0 inclusive.
19855 },
19856 &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
19857 # injection, before being sent to a backend service.
19858 # request to the backend service as part of fault injection.
19859 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
19860 # as a count of seconds and fractions of seconds at nanosecond
19861 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19862 # or &quot;month&quot;. Range is approximately 10,000 years.
19863 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19864 # Durations less than one second are represented with a 0
19865 # `seconds` field and a positive `nanos` field. Must be from 0
19866 # to 999,999,999 inclusive.
19867 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19868 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19869 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19870 },
19871 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
19872 # which a delay is introduced as part of fault injection.
19873 #
19874 # The value must be from 0.0 to 100.0 inclusive.
19875 },
19876 },
19877 &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
19878 # Global EXTERNAL_MANAGED load balancer schemes.
19879 # Either Cloud CDN must be enabled on the backend service or backend bucket
19880 # serving the route, or cache policy must be configured on the same route
19881 # dynamically processes and delivers images from the network edge.
19882 # Image Optimization is only available for Global External Application Load
19883 # Balancers.
19884 # Either Cloud CDN must be enabled on the backend service or backend bucket
19885 # serving the route, or cache policy must be configured on the same route.
19886 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
19887 },
19888 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
19889 # Unlike the timeout field where the timeout duration starts
19890 # from the time the request has been fully processed (known as*end-of-stream*),
19891 # the duration in this field is computed from the beginning of the stream
19892 # until the response has been processed, including all retries. A
19893 # stream that does not complete in this duration is closed.
19894 #
19895 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
19896 # with the route.
19897 #
19898 # This field is only allowed if the Url map is used with backend services
19899 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
19900 # as a count of seconds and fractions of seconds at nanosecond
19901 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19902 # or &quot;month&quot;. Range is approximately 10,000 years.
19903 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19904 # Durations less than one second are represented with a 0
19905 # `seconds` field and a positive `nanos` field. Must be from 0
19906 # to 999,999,999 inclusive.
19907 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19908 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19909 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19910 },
19911 &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
19912 # are shadowed to a separate mirrored backend service. The load balancer does
19913 # not wait for responses from the shadow service. Before sending traffic
19914 # to the shadow service, the host / authority header is suffixed with-shadow.
19915 #
19916 # Not supported when the URL map is bound to a target gRPC proxy that
19917 # has the validateForProxyless field set to true.
19918 # are shadowed to a separate mirrored backend service. The load balancer
19919 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
19920 # to the shadow service, the host or authority header is suffixed with-shadow.
19921 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
19922 # mirrored to.
19923 #
19924 # The backend service configured for a mirroring
19925 # policy must reference backends that are of the same type as the original
19926 # backend service matched in the URL map.
19927 #
19928 # Serverless NEG backends are not currently supported as a mirrored
19929 # backend service.
19930 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
19931 },
19932 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
19933 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
19934 # If not specified, defaults to 1.
19935 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
19936 #
19937 # If not specified, will use the timeout set in theHttpRouteAction field.
19938 # If timeout in the HttpRouteAction field is not set, this field
19939 # uses the largest timeout
19940 # among all backend services associated with the route.
19941 #
19942 # Not supported when the URL map is bound to a target gRPC proxy that
19943 # has the validateForProxyless field set to true.
19944 # as a count of seconds and fractions of seconds at nanosecond
19945 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19946 # or &quot;month&quot;. Range is approximately 10,000 years.
19947 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19948 # Durations less than one second are represented with a 0
19949 # `seconds` field and a positive `nanos` field. Must be from 0
19950 # to 999,999,999 inclusive.
19951 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19952 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19953 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19954 },
19955 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
19956 # values are:
19957 #
19958 # - 5xx: retry is attempted if the instance or endpoint
19959 # responds with any 5xx response code, or if the instance or
19960 # endpoint does not respond at all. For example, disconnects, reset, read
19961 # timeout, connection failure, and refused streams.
19962 # - gateway-error: Similar to 5xx, but only
19963 # applies to response codes 502, 503 or504.
19964 # - connect-failure: a retry is attempted on failures
19965 # connecting to the instance or endpoint. For example, connection
19966 # timeouts.
19967 # - retriable-4xx: a retry is attempted if the instance
19968 # or endpoint responds with a 4xx response code.
19969 # The only error that you can retry is error code 409.
19970 # - refused-stream: a retry is attempted if the instance
19971 # or endpoint resets the stream with a REFUSED_STREAM error
19972 # code. This reset type indicates that it is safe to retry.
19973 # - cancelled: a retry is attempted if the gRPC status
19974 # code in the response header is set to cancelled.
19975 # - deadline-exceeded: a retry is attempted if the gRPC
19976 # status code in the response header is set todeadline-exceeded.
19977 # - internal: a retry is attempted if the gRPC
19978 # status code in the response header is set tointernal.
19979 # - resource-exhausted: a retry is attempted if the gRPC
19980 # status code in the response header is set toresource-exhausted.
19981 # - unavailable: a retry is attempted if the gRPC
19982 # status code in the response header is set tounavailable.
19983 #
19984 # Only the following codes are supported when the URL map is bound to
19985 # target gRPC proxy that has validateForProxyless field set to true.
19986 #
19987 # - cancelled
19988 # - deadline-exceeded
19989 # - internal
19990 # - resource-exhausted
19991 # - unavailable
19992 &quot;A String&quot;,
19993 ],
19994 },
19995 &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
19996 # time the request has been fully processed (known as *end-of-stream*)
19997 # up until the response has been processed. Timeout includes
19998 # all retries.
19999 #
20000 # If not specified, this field uses the largest timeout among all backend
20001 # services associated with the route.
20002 #
20003 # Not supported when the URL map is bound to a target gRPC proxy that
20004 # has validateForProxyless field set to true.
20005 # as a count of seconds and fractions of seconds at nanosecond
20006 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
20007 # or &quot;month&quot;. Range is approximately 10,000 years.
20008 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
20009 # Durations less than one second are represented with a 0
20010 # `seconds` field and a positive `nanos` field. Must be from 0
20011 # to 999,999,999 inclusive.
20012 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
20013 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
20014 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
20015 },
20016 &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
20017 # to the matched service.
20018 #
20019 # urlRewrite is the only action supported in UrlMaps
20020 # for classic Application Load Balancers.
20021 #
20022 # Not supported when the URL map is bound to a target gRPC proxy that
20023 # has the validateForProxyless field set to true.
20024 # backend service.
20025 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
20026 # host header is replaced with contents of hostRewrite.
20027 #
20028 # The value must be from 1 to 255 characters.
20029 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
20030 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
20031 #
20032 # The value must be from 1 to 1024 characters.
20033 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
20034 # header) using the HTTP template syntax.
20035 #
20036 # A corresponding
20037 # path_template_match must be specified. Any template variables must exist in
20038 # the path_template_match field.
20039 #
20040 #
20041 # - -At least one variable must be specified in the path_template_match
20042 # field
20043 # - You can omit variables from the rewritten URL
20044 # - The * and ** operators cannot be matched
20045 # unless they have a corresponding variable name - e.g.
20046 # {format=*} or {var=**}.
20047 #
20048 # For example, a path_template_match of /static/{format=**}
20049 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
20050 # rewrite, so that /{country}/{format}/{suffix=**} can be
20051 # rewritten as /content/{format}/{country}/{suffix}.
20052 #
20053 # At least
20054 # one non-empty routeRules[].matchRules[].path_template_match is
20055 # required.
20056 #
20057 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
20058 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
20059 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
20060 # It uses RE2 syntax with the following constraints:
20061 #
20062 #
20063 # - Any single character operators
20064 # - Groups are allowed to have only submatch operator inside
20065 # - Groups are allowed only without any char repetition, e.g.
20066 # .*
20067 # - Any char repetition, e.g. .*, is
20068 # only allowed to be used in a single regex together with:
20069 #
20070 #
20071 # - Empty string operators
20072 # - Other repetitions
20073 # - Ranges
20074 # - Repetitions of ranges
20075 #
20076 #
20077 # - Ranges are only allowed to have:
20078 #
20079 #
20080 # - Character range
20081 # - Digits range
20082 # - Symbols listed in characters allowed for ranges
20083 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
20084 # the path.
20085 },
20086 },
20087 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
20088 # occurs. The weights determine the fraction of traffic that flows to
20089 # their corresponding backend service. If all traffic needs to
20090 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
20091 #
20092 # After a backend service is identified and before forwarding
20093 # the request to
20094 # the backend service, advanced routing actions such as URL rewrites and
20095 # header transformations are applied depending on additional settings
20096 # specified in this HttpRouteAction.
20097 { # In contrast to a single BackendService in
20098 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
20099 # multiple backend services. The volume of traffic for each
20100 # backend service is proportional to the weight specified
20101 # in each WeightedBackendService
20102 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
20103 # resource. Before
20104 # forwarding the request to backendService, the load balancer
20105 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
20106 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
20107 # effect for the selected backendService.
20108 #
20109 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
20110 #
20111 # headerAction is not supported for load balancers that have
20112 # their loadBalancingScheme set to EXTERNAL.
20113 #
20114 # Not supported when the URL map is bound to a target gRPC proxy that
20115 # has validateForProxyless field set to true.
20116 # the request is passed along to the selected backendService.
20117 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
20118 { # Specification determining how headers are added to requests or responses.
20119 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
20120 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
20121 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
20122 # that already
20123 # exist for the header. If true, headerValue is set for the
20124 # header, discarding any values that were set for that header.
20125 #
20126 # The default value is true,
20127 # unless a variable is present in headerValue,
20128 # in which case the default value is false.
20129 # .
20130 },
20131 ],
20132 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
20133 # request before forwarding the request to the backendService.
20134 &quot;A String&quot;,
20135 ],
20136 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
20137 # client.
20138 { # Specification determining how headers are added to requests or responses.
20139 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
20140 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
20141 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
20142 # that already
20143 # exist for the header. If true, headerValue is set for the
20144 # header, discarding any values that were set for that header.
20145 #
20146 # The default value is true,
20147 # unless a variable is present in headerValue,
20148 # in which case the default value is false.
20149 # .
20150 },
20151 ],
20152 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
20153 # response before sending the response back to the client.
20154 &quot;A String&quot;,
20155 ],
20156 },
20157 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
20158 # computed asweight / (sum of all weightedBackendService weights in routeAction).
20159 #
20160 # The selection of a backend service is determined only for new traffic.
20161 # Once a user&#x27;s request has been directed to a backend service,
20162 # subsequent requests are sent to the same backend service as
20163 # determined by the backend service&#x27;s session affinity policy.
20164 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
20165 # splitting. If you do, the weighted traffic splitting configuration takes
20166 # precedence.
20167 #
20168 # The value must be from 0 to 1000.
20169 },
20170 ],
20171 },
20172 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
20173 # is directed if this rule is matched. If routeAction is
20174 # also specified, advanced routing actions, such as URL rewrites,
20175 # take effect before sending the request to the backend.
20176 #
20177 #
20178 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
20179 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
20180 # specified by urlRedirect.
20181 #
20182 #
20183 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
20184 #
20185 #
20186 # Not supported when the URL map is bound to a target gRPC proxy.
20187 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
20188 # was supplied in the request.
20189 #
20190 # The value must be from 1 to 255
20191 # characters.
20192 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
20193 # set to HTTPS.
20194 # If set to false, the URL scheme of the redirected request
20195 # remains the same as that of the request.
20196 #
20197 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
20198 #
20199 # The default is set to false.
20200 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
20201 # that was supplied in the request.
20202 #
20203 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
20204 # supplied, the path of the original request is used for the redirect.
20205 #
20206 # The value must be from 1 to 1024 characters.
20207 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
20208 # the HttpRouteRuleMatch, retaining the remaining portion
20209 # of the URL before redirecting the request.
20210 #
20211 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
20212 # supplied, the path of the original request is used for the redirect.
20213 #
20214 # The value must be from 1 to 1024 characters.
20215 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
20216 #
20217 # Supported values are:
20218 #
20219 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
20220 # to 301.
20221 # - FOUND, which corresponds to 302.
20222 # - SEE_OTHER which corresponds to 303.
20223 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
20224 # method is retained.
20225 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
20226 # method is retained.
20227 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
20228 # URL is
20229 # removed before redirecting the request. If set to false, the
20230 # query portion of the original URL is retained.
20231 #
20232 # The default is set to false.
20233 },
20234 },
20235 ],
20236 },
20237 ],
20238 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the regional URL map resides.
20239 # This field is not applicable to global URL maps.
20240 # You must specify this field as part of the HTTP request URL. It is
20241 # not settable as a field in the request body.
20242 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
20243 &quot;status&quot;: { # [Output Only] The status of the URL map. # Output only. [Output Only] The status of the URL map.
20244 &quot;quotaUsage&quot;: { # Message representing the quota usage for a UrlMap. # Output only. Summary of quota usage for given UrlMap.
20245 &quot;forwardingRules&quot;: 42, # Output only. The number of forwarding rules that uses this UrlMap.
20246 &quot;units&quot;: &quot;A String&quot;, # Output only. The number of quota units calculated for this UrlMap.
20247 },
20248 },
20249 &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
20250 # maximum of 100 tests per UrlMap.
20251 #
20252 # Not supported when the URL map is bound to a target gRPC proxy that
20253 # has validateForProxyless field set to true.
20254 { # Message for the expected URL mappings.
20255 &quot;backendServiceWeight&quot;: 42, # The weight to use for the supplied host and path when using advanced
20256 # routing rules that involve traffic splitting.
20257 &quot;description&quot;: &quot;A String&quot;, # Description of this test case.
20258 &quot;expectedOutputUrl&quot;: &quot;A String&quot;, # The expected output URL evaluated by the load balancer
20259 # containing the scheme, host, path and query parameters.
20260 #
20261 # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
20262 # the load balancer to backends. For rules with urlRewrite,
20263 # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
20264 #
20265 # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer&#x27;s
20266 # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
20267 # If urlRedirect specifies strip_query, the test
20268 # passes only if expectedOutputUrl does not contain any query
20269 # parameters.
20270 #
20271 # expectedOutputUrl is optional whenservice is specified.
20272 &quot;expectedRedirectResponseCode&quot;: 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
20273 # load balancer&#x27;s redirect response.
20274 #
20275 # expectedRedirectResponseCode cannot be set whenservice is set.
20276 &quot;expectedUrlRedirect&quot;: &quot;A String&quot;, # The expected URL that should be redirected to for the host and path
20277 # being tested.
20278 # [Deprecated] This field is deprecated.
20279 # Use expected_output_url instead.
20280 &quot;headers&quot;: [ # HTTP headers for this request. If headers contains
20281 # a host header, then host must also match the header value.
20282 { # HTTP headers used in UrlMapTests.
20283 &quot;name&quot;: &quot;A String&quot;, # Header name.
20284 &quot;value&quot;: &quot;A String&quot;, # Header value.
20285 },
20286 ],
20287 &quot;host&quot;: &quot;A String&quot;, # Host portion of the URL. If headers contains a host header,
20288 # then host must also match the header value.
20289 &quot;path&quot;: &quot;A String&quot;, # Path portion of the URL.
20290 &quot;service&quot;: &quot;A String&quot;, # Expected BackendService or BackendBucket resource
20291 # the given URL should be mapped to.
20292 #
20293 # The service field cannot
20294 # be set if expectedRedirectResponseCode is set.
20295 },
20296 ],
20297 }
20298
20299 requestId: string, begin_interface: MixerMutationRequestBuilder
20300 Request ID to support idempotency.
20301 x__xgafv: string, V1 error format.
20302 Allowed values
20303 1 - v1 error format
20304 2 - v2 error format
20305
20306 Returns:
20307 An object of the form:
20308
20309 { # Represents an Operation resource.
20310 #
20311 # Google Compute Engine has three Operation resources:
20312 #
20313 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
20314 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
20315 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
20316 #
20317 # You can use an operation resource to manage asynchronous API requests.
20318 # For more information, readHandling
20319 # API responses.
20320 #
20321 # Operations can be global, regional or zonal.
20322 #
20323 # - For global operations, use the `globalOperations`
20324 # resource.
20325 # - For regional operations, use the
20326 # `regionOperations` resource.
20327 # - For zonal operations, use
20328 # the `zoneOperations` resource.
20329 #
20330 #
20331 #
20332 # For more information, read
20333 # Global, Regional, and Zonal Resources.
20334 #
20335 # Note that completed Operation resources have a limited
20336 # retention period.
20337 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
20338 # Not present otherwise.
20339 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
20340 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
20341 # set when the operation is created.
20342 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
20343 # text format.
20344 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
20345 # this field will be populated.
20346 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
20347 # operation.
20348 {
20349 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
20350 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
20351 # details. There is a set of defined message types to use for providing
20352 # details.The syntax depends on the error code. For example,
20353 # QuotaExceededInfo will have details when the error code is
20354 # QUOTA_EXCEEDED.
20355 {
20356 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
20357 #
20358 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
20359 # is not enabled:
20360 #
20361 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
20362 # &quot;domain&quot;: &quot;googleapis.com&quot;
20363 # &quot;metadata&quot;: {
20364 # &quot;resource&quot;: &quot;projects/123&quot;,
20365 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
20366 # }
20367 # }
20368 #
20369 # This response indicates that the pubsub.googleapis.com API is not enabled.
20370 #
20371 # Example of an error that is returned when attempting to create a Spanner
20372 # instance in a region that is out of stock:
20373 #
20374 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
20375 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
20376 # &quot;metadata&quot;: {
20377 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
20378 # }
20379 # }
20380 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
20381 # is typically the registered service name of the tool or product that
20382 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
20383 # generated by some common infrastructure, the error domain must be a
20384 # globally unique value that identifies the infrastructure. For Google API
20385 # infrastructure, the error domain is &quot;googleapis.com&quot;.
20386 &quot;metadatas&quot;: { # Additional structured details about this error.
20387 #
20388 # Keys must match a regular expression of `a-z+` but should
20389 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
20390 # length. When identifying the current value of an exceeded limit, the units
20391 # should be contained in the key, not the value. For example, rather than
20392 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
20393 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
20394 # instances that can be created in a single (batch) request.
20395 &quot;a_key&quot;: &quot;A String&quot;,
20396 },
20397 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
20398 # proximate cause of the error. Error reasons are unique within a particular
20399 # domain of errors. This should be at most 63 characters and match a
20400 # regular expression of `A-Z+[A-Z0-9]`, which represents
20401 # UPPER_SNAKE_CASE.
20402 },
20403 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
20404 #
20405 # For example, if a quota check failed with an error indicating the calling
20406 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
20407 # directly to the right place in the developer console to flip the bit.
20408 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
20409 { # Describes a URL link.
20410 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
20411 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
20412 },
20413 ],
20414 },
20415 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
20416 # which can be attached to an RPC error.
20417 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
20418 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
20419 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
20420 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
20421 },
20422 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
20423 &quot;dimensions&quot;: { # The map holding related quota dimensions.
20424 &quot;a_key&quot;: &quot;A String&quot;,
20425 },
20426 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
20427 # type or metric.
20428 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
20429 # or metric.
20430 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
20431 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
20432 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
20433 },
20434 },
20435 ],
20436 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
20437 # This property is optional.
20438 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
20439 },
20440 ],
20441 },
20442 &quot;getVersionOperationMetadata&quot;: {
20443 &quot;inlineSbomInfo&quot;: {
20444 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
20445 # appropriate identifiers.
20446 &quot;a_key&quot;: &quot;A String&quot;,
20447 },
20448 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
20449 # identifiers.
20450 &quot;a_key&quot;: &quot;A String&quot;,
20451 },
20452 },
20453 },
20454 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
20455 # message that was returned, such as `NOT FOUND`.
20456 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
20457 # status code that was returned. For example, a `404` means the
20458 # resource was not found.
20459 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
20460 # defined by the server.
20461 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
20462 # This value is inRFC3339
20463 # text format.
20464 &quot;instancesBulkInsertOperationMetadata&quot;: {
20465 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
20466 # Example key: zones/us-central1-a
20467 &quot;a_key&quot;: {
20468 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
20469 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
20470 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
20471 # error.
20472 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
20473 # if the flow is rolling forward or rolling back.
20474 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
20475 },
20476 },
20477 },
20478 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
20479 # Operation resources.
20480 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
20481 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
20482 # group of operations results from a `bulkInsert` API request.
20483 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
20484 # `update`, or `delete`, and so on.
20485 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
20486 # There is no requirement that this be linear or support any granularity of
20487 # operations. This should not be used to guess when the operation will be
20488 # complete. This number should monotonically increase as the operation
20489 # progresses.
20490 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
20491 # applicable when performing regional operations.
20492 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
20493 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
20494 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
20495 # this field will contain information on all underlying zonal actions and
20496 # their state.
20497 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
20498 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
20499 # Example key: zones/us-central1-a
20500 &quot;a_key&quot;: {
20501 &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
20502 # populated.
20503 # different programming environments, including REST APIs and RPC APIs. It is
20504 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
20505 # three pieces of data: error code, error message, and error details.
20506 #
20507 # You can find out more about this error model and how to work with it in the
20508 # [API Design Guide](https://cloud.google.com/apis/design/errors).
20509 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
20510 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
20511 # message types for APIs to use.
20512 {
20513 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
20514 },
20515 ],
20516 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
20517 # user-facing error message should be localized and sent in the
20518 # google.rpc.Status.details field, or localized by the client.
20519 },
20520 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
20521 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
20522 },
20523 },
20524 },
20525 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
20526 # This value is inRFC3339
20527 # text format.
20528 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
20529 # following:
20530 # `PENDING`, `RUNNING`, or `DONE`.
20531 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
20532 # operation.
20533 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
20534 # of the target resource.
20535 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
20536 # operations related to creating a snapshot, this points to the disk
20537 # that the snapshot was created from.
20538 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
20539 # `[email protected]` or
20540 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
20541 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
20542 # operation, this field will be populated.
20543 {
20544 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
20545 # Engine returns NO_RESULTS_ON_PAGE if there
20546 # are no results in the response.
20547 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
20548 # value format. For example:
20549 #
20550 # &quot;data&quot;: [
20551 # {
20552 # &quot;key&quot;: &quot;scope&quot;,
20553 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
20554 # }
20555 {
20556 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
20557 # returned. For example, for warnings where there are no results in a list
20558 # request for a particular zone, this key might be scope and
20559 # the key value might be the zone name. Other examples might be a key
20560 # indicating a deprecated resource and a suggested replacement, or a
20561 # warning about invalid network settings (for example, if an instance
20562 # attempts to perform IP forwarding but is not enabled for IP forwarding).
20563 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
20564 },
20565 ],
20566 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
20567 },
20568 ],
20569 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
20570 # applicable when performing per-zone operations.
20571 }</pre>
20572 </div>
20573
20574 <div class="method">
20575 <code class="details" id="validate">validate(project, region, urlMap, body=None, x__xgafv=None)</code>
20576 <pre>Runs static validation for the UrlMap. In particular, the tests of the
20577 provided UrlMap will be run. Calling this method does NOT create the
20578 UrlMap.
20579
20580 Args:
20581 project: string, Project ID for this request. (required)
20582 region: string, Name of the region scoping this request. (required)
20583 urlMap: string, Name of the UrlMap resource to be validated as. (required)
20584 body: object, The request body.
20585 The object takes the form of:
20586
20587 {
20588 &quot;resource&quot;: { # Represents a URL Map resource. # Content of the UrlMap to be validated.
20589 #
20590 # Compute Engine has two URL Map resources:
20591 #
20592 # * [Global](/compute/docs/reference/rest/alpha/urlMaps)
20593 # * [Regional](/compute/docs/reference/rest/alpha/regionUrlMaps)
20594 #
20595 # A URL map resource is a component of certain types of cloud load balancers
20596 # and Traffic Director:
20597 #
20598 # * urlMaps are used by global external Application Load
20599 # Balancers, classic Application Load Balancers, and cross-region internal
20600 # Application Load Balancers.
20601 # * regionUrlMaps are used by internal Application Load Balancers,
20602 # regional external Application Load Balancers and regional internal
20603 # Application Load Balancers.
20604 #
20605 # For a list of supported URL map features by the load balancer type, see the
20606 # Load balancing features: Routing and traffic management table.
20607 #
20608 # For a list of supported URL map features for Traffic Director, see the
20609 # Traffic Director features: Routing and traffic management table.
20610 #
20611 # This resource defines mappings from hostnames and URL paths to either a
20612 # backend service or a backend bucket.
20613 #
20614 # To use the global urlMaps resource, the backend service must
20615 # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
20616 # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
20617 # information, read URL
20618 # Map Concepts.
20619 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
20620 # text format.
20621 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
20622 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
20623 #
20624 # This policy takes
20625 # effect at the load balancer level and applies only when no policy has been
20626 # defined for the error code at lower levels like PathMatcher, RouteRule and
20627 # PathRule within this UrlMap.
20628 #
20629 # For example, consider a UrlMap with the
20630 # following configuration:
20631 #
20632 #
20633 # - defaultCustomErrorResponsePolicy containing policies for
20634 # responding to 5xx and 4xx errors
20635 # - A PathMatcher configured for *.example.com has
20636 # defaultCustomErrorResponsePolicy for 4xx.
20637 #
20638 # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
20639 # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
20640 # a request that does not match any host in *.example.com such
20641 # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
20642 # takes effect.
20643 #
20644 # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
20645 # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
20646 # a retry, if load balancer is successful in reaching the
20647 # service, the defaultCustomErrorResponsePolicy is ignored and
20648 # the response from the service is returned to the client.
20649 #
20650 # defaultCustomErrorResponsePolicy is supported only for
20651 # global external Application Load Balancers.
20652 # backend service or backend bucket responds with an error.
20653 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
20654 #
20655 # In a given policy, if you specify rules for both a range of error codes
20656 # as well as rules for specific error codes then rules with specific error
20657 # codes have a higher priority. For example, assume that you configure a rule
20658 # for 401 (Un-authorized) code, and another for all 4 series
20659 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
20660 # However if the backend service returns a 403, the rule for4xx takes effect.
20661 { # Specifies the mapping between the response code that will be returned along
20662 # with the custom error content and the response code returned by the backend
20663 # service.
20664 &quot;matchResponseCodes&quot;: [ # Valid values include:
20665 #
20666 #
20667 # - A number between 400 and 599: For example
20668 # 401 or 503, in which case the load balancer
20669 # applies the policy if the error code exactly matches this value.
20670 # - 5xx: Load Balancer will apply the policy if the
20671 # backend service responds with any response code in the range of
20672 # 500 to 599.
20673 # - 4xx: Load
20674 # Balancer will apply the policy if the backend service responds with any
20675 # response code in the range of 400 to
20676 # 499.
20677 #
20678 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
20679 &quot;A String&quot;,
20680 ],
20681 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
20682 # error content. If overrideResponseCode is not supplied, the
20683 # same response code returned by the original backend bucket or backend
20684 # service is returned to the client.
20685 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
20686 #
20687 # path must start
20688 # with a leading slash. path cannot have trailing slashes.
20689 #
20690 # If the file is not available in backendBucket or the
20691 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
20692 #
20693 # The value must
20694 # be from 1 to 1024 characters
20695 },
20696 ],
20697 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
20698 # contains the custom error content. Examples are:
20699 #
20700 #
20701 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
20702 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
20703 # - global/backendBuckets/myBackendBucket
20704 #
20705 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
20706 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
20707 #
20708 # If load balancer cannot reach
20709 # the backendBucket, a simple Not Found Error will
20710 # be returned, with the original response code (oroverrideResponseCode if configured).
20711 #
20712 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
20713 },
20714 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
20715 # hostRules match. The load balancer performs advanced routing
20716 # actions, such as URL rewrites and header transformations, before forwarding
20717 # the request to the selected backend.
20718 #
20719 #
20720 # Only one of defaultUrlRedirect, defaultService
20721 # or defaultRouteAction.weightedBackendService can be set.
20722 #
20723 #
20724 # URL maps for classic Application Load Balancers only support
20725 # the urlRewrite action within defaultRouteAction.
20726 #
20727 #
20728 # defaultRouteAction has no effect when the URL map is bound
20729 # to a target gRPC proxy that has the validateForProxyless field
20730 # set to true.
20731 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
20732 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
20733 # property must be specified. This policy cannot be specified if any target
20734 # backend has Identity-Aware Proxy enabled.
20735 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
20736 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
20737 # header names can be specified. The cache is bypassed for all `cacheMode`
20738 # values.
20739 &quot;A String&quot;,
20740 ],
20741 &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
20742 # on the backend type: for Backend Services, the complete request URI is
20743 # used; for Backend Buckets, the request URI is used without the protocol or
20744 # host, and only query parameters known to Cloud Storage are included.
20745 # Policy defined on Route Action.
20746 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
20747 # parameters will be included. Either specify `excludedQueryParameters`
20748 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
20749 # encoded and not treated as delimiters.
20750 #
20751 # Note: This field applies to routes that use backend services. Attempting
20752 # to set it on a route that points exclusively to Backend Buckets will
20753 # result in a configuration error. For routes that point to a Backend
20754 # Bucket, use `includedQueryParameters` to define which parameters should
20755 # be part of the cache key.
20756 &quot;A String&quot;,
20757 ],
20758 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
20759 #
20760 # Note: This setting is only applicable to routes that use a Backend
20761 # Service. It does not affect requests served by a Backend Bucket, as the
20762 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
20763 # it on a route that points exclusively to Backend Buckets will result in a
20764 # configuration error.
20765 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
20766 #
20767 # Note: This setting is only applicable to routes that use a Backend
20768 # Service. It does not affect requests served by a Backend Bucket, as the
20769 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
20770 # set on a route that points exclusively to Backend Buckets will result in
20771 # a configuration error.
20772 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
20773 # `includedQueryParameters` and `excludedQueryParameters`. If neither
20774 # is set, the entire query string will be included. If false, the query
20775 # string will be excluded from the cache key entirely.
20776 #
20777 # Note: This field applies to routes that use backend services. Attempting
20778 # to set it on a route that points exclusively to Backend Buckets will
20779 # result in a configuration error. For routes that point to a Backend
20780 # Bucket, use `includedQueryParameters` to define which parameters should
20781 # be part of the cache key.
20782 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
20783 # The name=value pair will be used in the cache key Cloud CDN generates.
20784 #
20785 # Note: This setting is only applicable to routes that use a Backend
20786 # Service. It does not affect requests served by a Backend Bucket.
20787 # Attempting to set it on a route that points exclusively to Backend
20788 # Buckets will result in a configuration error. Up to 5 cookie names can be
20789 # specified.
20790 &quot;A String&quot;,
20791 ],
20792 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
20793 &quot;A String&quot;,
20794 ],
20795 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
20796 # parameters will be excluded. Either specify `includedQueryParameters`
20797 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
20798 # encoded and not treated as delimiters.
20799 &quot;A String&quot;,
20800 ],
20801 },
20802 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
20803 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
20804 &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
20805 # content. This is used to clamp the max-age (or Expires) value sent to the
20806 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
20807 # is used for the response max-age directive, along with a &quot;public&quot;
20808 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
20809 # clamps the max-age from the origin (if specified), or else sets the
20810 # response max-age directive to the lesser of the `clientTtl` and
20811 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
20812 # present. The maximum allowed value is 31,622,400s (1 year). If not
20813 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
20814 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
20815 # `USE_ORIGIN_HEADERS`.
20816 # as a count of seconds and fractions of seconds at nanosecond
20817 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
20818 # or &quot;month&quot;. Range is approximately 10,000 years.
20819 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
20820 # Durations less than one second are represented with a 0
20821 # `seconds` field and a positive `nanos` field. Must be from 0
20822 # to 999,999,999 inclusive.
20823 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
20824 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
20825 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
20826 },
20827 &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
20828 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
20829 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
20830 # greater than that of `maxTtl`. When the `cacheMode` is set to
20831 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
20832 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
20833 # accessed objects may be evicted from the cache before the defined TTL. If
20834 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
20835 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
20836 # `USE_ORIGIN_HEADERS`.
20837 # as a count of seconds and fractions of seconds at nanosecond
20838 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
20839 # or &quot;month&quot;. Range is approximately 10,000 years.
20840 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
20841 # Durations less than one second are represented with a 0
20842 # `seconds` field and a positive `nanos` field. Must be from 0
20843 # to 999,999,999 inclusive.
20844 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
20845 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
20846 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
20847 },
20848 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
20849 # attempt to set a max-age or s-maxage higher than this, or an Expires header
20850 # more than `maxTtl` seconds in the future will be capped at the value of
20851 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
20852 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
20853 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
20854 # Infrequently accessed objects may be evicted from the cache before the
20855 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
20856 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
20857 # mode.
20858 # as a count of seconds and fractions of seconds at nanosecond
20859 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
20860 # or &quot;month&quot;. Range is approximately 10,000 years.
20861 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
20862 # Durations less than one second are represented with a 0
20863 # `seconds` field and a positive `nanos` field. Must be from 0
20864 # to 999,999,999 inclusive.
20865 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
20866 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
20867 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
20868 },
20869 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
20870 # to apply fine-grained caching for common errors or redirects.
20871 # This can reduce the load on your origin and improve end-user
20872 # experience by reducing response latency.
20873 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
20874 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
20875 # the specified response code that lack any Cache-Control, Expires, or
20876 # Pragma: no-cache directives. When the `cacheMode` is set to
20877 # `FORCE_CACHE_ALL`, negative caching applies to all responses
20878 # with the specified response code, and overrides any caching headers. By
20879 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
20880 #
20881 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
20882 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
20883 # * 405 (Method Not Found), 501 (Not Implemented): 60s
20884 #
20885 # These defaults can be overridden in `negativeCachingPolicy`.
20886 # If not specified, Cloud CDN applies negative caching by default.
20887 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
20888 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
20889 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
20890 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
20891 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
20892 # all response codes that you wish to cache. Cloud CDN will not apply any
20893 # default negative caching when a policy exists.
20894 { # Specify CDN TTLs for response error codes.
20895 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
20896 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
20897 # specified as values, and you cannot specify a status code more than
20898 # once.
20899 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
20900 # corresponding status code.
20901 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
20902 # objects may be evicted from the cache before the defined TTL.
20903 # as a count of seconds and fractions of seconds at nanosecond
20904 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
20905 # or &quot;month&quot;. Range is approximately 10,000 years.
20906 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
20907 # Durations less than one second are represented with a 0
20908 # `seconds` field and a positive `nanos` field. Must be from 0
20909 # to 999,999,999 inclusive.
20910 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
20911 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
20912 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
20913 },
20914 },
20915 ],
20916 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
20917 # requests into a small number of requests to the origin. If not specified,
20918 # Cloud CDN applies request coalescing by default.
20919 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
20920 # content with the origin, or when an error is encountered when refreshing
20921 # the cache.
20922 # This setting defines the default &quot;max-stale&quot; duration for any cached
20923 # responses that do not specify a max-stale directive. Stale responses that
20924 # exceed the TTL configured here will not be served. The default limit
20925 # (max-stale) is 86400s (1 day), which will allow stale content to be
20926 # served up to this limit beyond the max-age (or s-maxage) of a cached
20927 # response.
20928 # The maximum allowed value is 604800 (1 week).
20929 # Set this to zero (0) to disable serve-while-stale.
20930 # as a count of seconds and fractions of seconds at nanosecond
20931 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
20932 # or &quot;month&quot;. Range is approximately 10,000 years.
20933 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
20934 # Durations less than one second are represented with a 0
20935 # `seconds` field and a positive `nanos` field. Must be from 0
20936 # to 999,999,999 inclusive.
20937 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
20938 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
20939 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
20940 },
20941 },
20942 &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
20943 # information about the W3C recommendation for cross-origin resource sharing
20944 # (CORS), see Fetch API Living
20945 # Standard.
20946 #
20947 # Not supported when the URL map is bound to a target gRPC proxy.
20948 # information about the W3C recommendation for cross-origin resource sharing
20949 # (CORS), see Fetch API Living
20950 # Standard.
20951 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
20952 # indicates that
20953 # the actual request can include user credentials. This field translates to
20954 # the Access-Control-Allow-Credentials header.
20955 #
20956 # Default is false.
20957 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
20958 # header.
20959 &quot;A String&quot;,
20960 ],
20961 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
20962 # header.
20963 &quot;A String&quot;,
20964 ],
20965 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
20966 # more information, see regular expression syntax.
20967 #
20968 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
20969 #
20970 # Regular expressions can only be used when the loadBalancingScheme is
20971 # set to INTERNAL_SELF_MANAGED.
20972 &quot;A String&quot;,
20973 ],
20974 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
20975 #
20976 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
20977 &quot;A String&quot;,
20978 ],
20979 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
20980 # The default value is false, which indicates that the CORS
20981 # policy is in effect.
20982 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
20983 # header.
20984 &quot;A String&quot;,
20985 ],
20986 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
20987 # seconds. This field translates to the Access-Control-Max-Age
20988 # header.
20989 },
20990 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
20991 # the resiliency of clients to backend service failure. As part of fault
20992 # injection, when clients send requests to a backend service, delays can be
20993 # introduced by a load balancer on a percentage of requests before sending
20994 # those requests to the backend service. Similarly requests from clients can
20995 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
20996 # that are configured with a fault_injection_policy if:
20997 # 1. The traffic is generated by fault injection AND
20998 # 2. The fault injection is not a delay fault injection.
20999 # Fault injection is not supported with the classic Application Load Balancer
21000 # . To see which load balancers support fault injection,
21001 # see Load
21002 # balancing: Routing and traffic management features.
21003 # the resiliency of clients to backend service failure. As part of fault
21004 # injection, when clients send requests to a backend service, delays can be
21005 # introduced by the load balancer on a percentage of requests before sending
21006 # those request to the backend service. Similarly requests from clients can be
21007 # aborted by the load balancer for a percentage of requests.
21008 &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
21009 # injection.
21010 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
21011 #
21012 # The value must be from 200 to 599 inclusive.
21013 #
21014 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
21015 # according to this
21016 # mapping table. HTTP status 200 is mapped to gRPC status
21017 # UNKNOWN. Injecting an OK status is currently not supported by
21018 # Traffic Director.
21019 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
21020 # that is aborted as part of fault injection.
21021 #
21022 # The value must be from 0.0 to 100.0 inclusive.
21023 },
21024 &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
21025 # injection, before being sent to a backend service.
21026 # request to the backend service as part of fault injection.
21027 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
21028 # as a count of seconds and fractions of seconds at nanosecond
21029 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21030 # or &quot;month&quot;. Range is approximately 10,000 years.
21031 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21032 # Durations less than one second are represented with a 0
21033 # `seconds` field and a positive `nanos` field. Must be from 0
21034 # to 999,999,999 inclusive.
21035 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21036 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21037 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21038 },
21039 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
21040 # which a delay is introduced as part of fault injection.
21041 #
21042 # The value must be from 0.0 to 100.0 inclusive.
21043 },
21044 },
21045 &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
21046 # Global EXTERNAL_MANAGED load balancer schemes.
21047 # Either Cloud CDN must be enabled on the backend service or backend bucket
21048 # serving the route, or cache policy must be configured on the same route
21049 # dynamically processes and delivers images from the network edge.
21050 # Image Optimization is only available for Global External Application Load
21051 # Balancers.
21052 # Either Cloud CDN must be enabled on the backend service or backend bucket
21053 # serving the route, or cache policy must be configured on the same route.
21054 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
21055 },
21056 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
21057 # Unlike the timeout field where the timeout duration starts
21058 # from the time the request has been fully processed (known as*end-of-stream*),
21059 # the duration in this field is computed from the beginning of the stream
21060 # until the response has been processed, including all retries. A
21061 # stream that does not complete in this duration is closed.
21062 #
21063 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
21064 # with the route.
21065 #
21066 # This field is only allowed if the Url map is used with backend services
21067 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
21068 # as a count of seconds and fractions of seconds at nanosecond
21069 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21070 # or &quot;month&quot;. Range is approximately 10,000 years.
21071 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21072 # Durations less than one second are represented with a 0
21073 # `seconds` field and a positive `nanos` field. Must be from 0
21074 # to 999,999,999 inclusive.
21075 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21076 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21077 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21078 },
21079 &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
21080 # are shadowed to a separate mirrored backend service. The load balancer does
21081 # not wait for responses from the shadow service. Before sending traffic
21082 # to the shadow service, the host / authority header is suffixed with-shadow.
21083 #
21084 # Not supported when the URL map is bound to a target gRPC proxy that
21085 # has the validateForProxyless field set to true.
21086 # are shadowed to a separate mirrored backend service. The load balancer
21087 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
21088 # to the shadow service, the host or authority header is suffixed with-shadow.
21089 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
21090 # mirrored to.
21091 #
21092 # The backend service configured for a mirroring
21093 # policy must reference backends that are of the same type as the original
21094 # backend service matched in the URL map.
21095 #
21096 # Serverless NEG backends are not currently supported as a mirrored
21097 # backend service.
21098 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
21099 },
21100 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
21101 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
21102 # If not specified, defaults to 1.
21103 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
21104 #
21105 # If not specified, will use the timeout set in theHttpRouteAction field.
21106 # If timeout in the HttpRouteAction field is not set, this field
21107 # uses the largest timeout
21108 # among all backend services associated with the route.
21109 #
21110 # Not supported when the URL map is bound to a target gRPC proxy that
21111 # has the validateForProxyless field set to true.
21112 # as a count of seconds and fractions of seconds at nanosecond
21113 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21114 # or &quot;month&quot;. Range is approximately 10,000 years.
21115 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21116 # Durations less than one second are represented with a 0
21117 # `seconds` field and a positive `nanos` field. Must be from 0
21118 # to 999,999,999 inclusive.
21119 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21120 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21121 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21122 },
21123 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
21124 # values are:
21125 #
21126 # - 5xx: retry is attempted if the instance or endpoint
21127 # responds with any 5xx response code, or if the instance or
21128 # endpoint does not respond at all. For example, disconnects, reset, read
21129 # timeout, connection failure, and refused streams.
21130 # - gateway-error: Similar to 5xx, but only
21131 # applies to response codes 502, 503 or504.
21132 # - connect-failure: a retry is attempted on failures
21133 # connecting to the instance or endpoint. For example, connection
21134 # timeouts.
21135 # - retriable-4xx: a retry is attempted if the instance
21136 # or endpoint responds with a 4xx response code.
21137 # The only error that you can retry is error code 409.
21138 # - refused-stream: a retry is attempted if the instance
21139 # or endpoint resets the stream with a REFUSED_STREAM error
21140 # code. This reset type indicates that it is safe to retry.
21141 # - cancelled: a retry is attempted if the gRPC status
21142 # code in the response header is set to cancelled.
21143 # - deadline-exceeded: a retry is attempted if the gRPC
21144 # status code in the response header is set todeadline-exceeded.
21145 # - internal: a retry is attempted if the gRPC
21146 # status code in the response header is set tointernal.
21147 # - resource-exhausted: a retry is attempted if the gRPC
21148 # status code in the response header is set toresource-exhausted.
21149 # - unavailable: a retry is attempted if the gRPC
21150 # status code in the response header is set tounavailable.
21151 #
21152 # Only the following codes are supported when the URL map is bound to
21153 # target gRPC proxy that has validateForProxyless field set to true.
21154 #
21155 # - cancelled
21156 # - deadline-exceeded
21157 # - internal
21158 # - resource-exhausted
21159 # - unavailable
21160 &quot;A String&quot;,
21161 ],
21162 },
21163 &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
21164 # time the request has been fully processed (known as *end-of-stream*)
21165 # up until the response has been processed. Timeout includes
21166 # all retries.
21167 #
21168 # If not specified, this field uses the largest timeout among all backend
21169 # services associated with the route.
21170 #
21171 # Not supported when the URL map is bound to a target gRPC proxy that
21172 # has validateForProxyless field set to true.
21173 # as a count of seconds and fractions of seconds at nanosecond
21174 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21175 # or &quot;month&quot;. Range is approximately 10,000 years.
21176 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21177 # Durations less than one second are represented with a 0
21178 # `seconds` field and a positive `nanos` field. Must be from 0
21179 # to 999,999,999 inclusive.
21180 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21181 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21182 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21183 },
21184 &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
21185 # to the matched service.
21186 #
21187 # urlRewrite is the only action supported in UrlMaps
21188 # for classic Application Load Balancers.
21189 #
21190 # Not supported when the URL map is bound to a target gRPC proxy that
21191 # has the validateForProxyless field set to true.
21192 # backend service.
21193 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
21194 # host header is replaced with contents of hostRewrite.
21195 #
21196 # The value must be from 1 to 255 characters.
21197 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
21198 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
21199 #
21200 # The value must be from 1 to 1024 characters.
21201 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
21202 # header) using the HTTP template syntax.
21203 #
21204 # A corresponding
21205 # path_template_match must be specified. Any template variables must exist in
21206 # the path_template_match field.
21207 #
21208 #
21209 # - -At least one variable must be specified in the path_template_match
21210 # field
21211 # - You can omit variables from the rewritten URL
21212 # - The * and ** operators cannot be matched
21213 # unless they have a corresponding variable name - e.g.
21214 # {format=*} or {var=**}.
21215 #
21216 # For example, a path_template_match of /static/{format=**}
21217 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
21218 # rewrite, so that /{country}/{format}/{suffix=**} can be
21219 # rewritten as /content/{format}/{country}/{suffix}.
21220 #
21221 # At least
21222 # one non-empty routeRules[].matchRules[].path_template_match is
21223 # required.
21224 #
21225 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
21226 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
21227 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
21228 # It uses RE2 syntax with the following constraints:
21229 #
21230 #
21231 # - Any single character operators
21232 # - Groups are allowed to have only submatch operator inside
21233 # - Groups are allowed only without any char repetition, e.g.
21234 # .*
21235 # - Any char repetition, e.g. .*, is
21236 # only allowed to be used in a single regex together with:
21237 #
21238 #
21239 # - Empty string operators
21240 # - Other repetitions
21241 # - Ranges
21242 # - Repetitions of ranges
21243 #
21244 #
21245 # - Ranges are only allowed to have:
21246 #
21247 #
21248 # - Character range
21249 # - Digits range
21250 # - Symbols listed in characters allowed for ranges
21251 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
21252 # the path.
21253 },
21254 },
21255 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
21256 # occurs. The weights determine the fraction of traffic that flows to
21257 # their corresponding backend service. If all traffic needs to
21258 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
21259 #
21260 # After a backend service is identified and before forwarding
21261 # the request to
21262 # the backend service, advanced routing actions such as URL rewrites and
21263 # header transformations are applied depending on additional settings
21264 # specified in this HttpRouteAction.
21265 { # In contrast to a single BackendService in
21266 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
21267 # multiple backend services. The volume of traffic for each
21268 # backend service is proportional to the weight specified
21269 # in each WeightedBackendService
21270 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
21271 # resource. Before
21272 # forwarding the request to backendService, the load balancer
21273 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
21274 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
21275 # effect for the selected backendService.
21276 #
21277 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
21278 #
21279 # headerAction is not supported for load balancers that have
21280 # their loadBalancingScheme set to EXTERNAL.
21281 #
21282 # Not supported when the URL map is bound to a target gRPC proxy that
21283 # has validateForProxyless field set to true.
21284 # the request is passed along to the selected backendService.
21285 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
21286 { # Specification determining how headers are added to requests or responses.
21287 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
21288 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
21289 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
21290 # that already
21291 # exist for the header. If true, headerValue is set for the
21292 # header, discarding any values that were set for that header.
21293 #
21294 # The default value is true,
21295 # unless a variable is present in headerValue,
21296 # in which case the default value is false.
21297 # .
21298 },
21299 ],
21300 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
21301 # request before forwarding the request to the backendService.
21302 &quot;A String&quot;,
21303 ],
21304 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
21305 # client.
21306 { # Specification determining how headers are added to requests or responses.
21307 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
21308 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
21309 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
21310 # that already
21311 # exist for the header. If true, headerValue is set for the
21312 # header, discarding any values that were set for that header.
21313 #
21314 # The default value is true,
21315 # unless a variable is present in headerValue,
21316 # in which case the default value is false.
21317 # .
21318 },
21319 ],
21320 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
21321 # response before sending the response back to the client.
21322 &quot;A String&quot;,
21323 ],
21324 },
21325 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
21326 # computed asweight / (sum of all weightedBackendService weights in routeAction).
21327 #
21328 # The selection of a backend service is determined only for new traffic.
21329 # Once a user&#x27;s request has been directed to a backend service,
21330 # subsequent requests are sent to the same backend service as
21331 # determined by the backend service&#x27;s session affinity policy.
21332 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
21333 # splitting. If you do, the weighted traffic splitting configuration takes
21334 # precedence.
21335 #
21336 # The value must be from 0 to 1000.
21337 },
21338 ],
21339 },
21340 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL of the defaultService resource to
21341 # which traffic is directed if none of the hostRules match.
21342 # If defaultRouteAction is also specified, advanced
21343 # routing actions, such as URL rewrites, take effect before sending the
21344 # request to the backend.
21345 #
21346 #
21347 # Only one of defaultUrlRedirect, defaultService
21348 # or defaultRouteAction.weightedBackendService can be set.
21349 #
21350 #
21351 # defaultService has no effect when the URL map is bound
21352 # to a target gRPC proxy that has the validateForProxyless field
21353 # set to true.
21354 &quot;defaultUrlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
21355 # is redirected to a URL specified by defaultUrlRedirect.
21356 #
21357 #
21358 # Only one of defaultUrlRedirect, defaultService
21359 # or defaultRouteAction.weightedBackendService can be set.
21360 #
21361 #
21362 # Not supported when the URL map is bound to a target gRPC proxy.
21363 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
21364 # was supplied in the request.
21365 #
21366 # The value must be from 1 to 255
21367 # characters.
21368 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
21369 # set to HTTPS.
21370 # If set to false, the URL scheme of the redirected request
21371 # remains the same as that of the request.
21372 #
21373 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
21374 #
21375 # The default is set to false.
21376 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
21377 # that was supplied in the request.
21378 #
21379 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
21380 # supplied, the path of the original request is used for the redirect.
21381 #
21382 # The value must be from 1 to 1024 characters.
21383 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
21384 # the HttpRouteRuleMatch, retaining the remaining portion
21385 # of the URL before redirecting the request.
21386 #
21387 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
21388 # supplied, the path of the original request is used for the redirect.
21389 #
21390 # The value must be from 1 to 1024 characters.
21391 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
21392 #
21393 # Supported values are:
21394 #
21395 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
21396 # to 301.
21397 # - FOUND, which corresponds to 302.
21398 # - SEE_OTHER which corresponds to 303.
21399 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
21400 # method is retained.
21401 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
21402 # method is retained.
21403 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
21404 # URL is
21405 # removed before redirecting the request. If set to false, the
21406 # query portion of the original URL is retained.
21407 #
21408 # The default is set to false.
21409 },
21410 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
21411 # create the resource.
21412 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. A hash of the contents stored in this object.
21413 # This field is used in optimistic locking. This field is ignored when
21414 # inserting a UrlMap. An up-to-date fingerprint must be provided
21415 # in order to update the UrlMap, otherwise the request will
21416 # fail with error 412 conditionNotMet.
21417 #
21418 # To see the latest fingerprint, make a get() request to
21419 # retrieve a UrlMap.
21420 &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
21421 # for the selected backendService.
21422 #
21423 # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
21424 #
21425 # headerAction is not supported for load balancers
21426 # that have
21427 # their loadBalancingScheme set to EXTERNAL.
21428 #
21429 # Not supported when the URL map is bound to a target gRPC proxy that
21430 # has validateForProxyless field set to true.
21431 # the request is passed along to the selected backendService.
21432 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
21433 { # Specification determining how headers are added to requests or responses.
21434 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
21435 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
21436 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
21437 # that already
21438 # exist for the header. If true, headerValue is set for the
21439 # header, discarding any values that were set for that header.
21440 #
21441 # The default value is true,
21442 # unless a variable is present in headerValue,
21443 # in which case the default value is false.
21444 # .
21445 },
21446 ],
21447 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
21448 # request before forwarding the request to the backendService.
21449 &quot;A String&quot;,
21450 ],
21451 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
21452 # client.
21453 { # Specification determining how headers are added to requests or responses.
21454 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
21455 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
21456 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
21457 # that already
21458 # exist for the header. If true, headerValue is set for the
21459 # header, discarding any values that were set for that header.
21460 #
21461 # The default value is true,
21462 # unless a variable is present in headerValue,
21463 # in which case the default value is false.
21464 # .
21465 },
21466 ],
21467 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
21468 # response before sending the response back to the client.
21469 &quot;A String&quot;,
21470 ],
21471 },
21472 &quot;hostRules&quot;: [ # The list of host rules to use against the URL.
21473 { # UrlMaps
21474 # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
21475 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
21476 # create the resource.
21477 &quot;hosts&quot;: [ # The list of host patterns to match. They must be valid hostnames with
21478 # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
21479 # that case, * must be the first character, and if followed by
21480 # anything, the immediate following character must be either -
21481 # or ..
21482 #
21483 # * based matching is not supported when the URL map is bound
21484 # to a target gRPC proxy that has the validateForProxyless field
21485 # set to true.
21486 &quot;A String&quot;,
21487 ],
21488 &quot;pathMatcher&quot;: &quot;A String&quot;, # The name of the PathMatcher to use to match the path portion
21489 # of the URL if the hostRule matches the URL&#x27;s host portion.
21490 },
21491 ],
21492 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the resource. This identifier is
21493 # defined by the server.
21494 &quot;kind&quot;: &quot;compute#urlMap&quot;, # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
21495 # url maps.
21496 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
21497 # The name must be 1-63 characters long, and comply withRFC1035.
21498 # Specifically, the name must be 1-63 characters long and match the regular
21499 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
21500 # character must be a lowercase letter, and all following characters must
21501 # be a dash, lowercase letter, or digit, except the last character, which
21502 # cannot be a dash.
21503 &quot;pathMatchers&quot;: [ # The list of named PathMatchers to use against the URL.
21504 { # A matcher for the path portion of the URL. The BackendService
21505 # from the longest-matched rule will serve the URL. If no rule was matched, the
21506 # default service is used.
21507 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
21508 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
21509 #
21510 # This policy takes
21511 # effect at the PathMatcher level and applies only when no
21512 # 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
21513 # in defaultCustomErrorResponsePolicy, then a policy defined for
21514 # the error code in UrlMap.defaultCustomErrorResponsePolicy
21515 # takes effect.
21516 #
21517 # For example, consider a UrlMap with the following
21518 # configuration:
21519 #
21520 #
21521 # - UrlMap.defaultCustomErrorResponsePolicy is configured
21522 # with policies for 5xx and 4xx errors
21523 # - A RouteRule for /coming_soon/ is configured for the
21524 # error code 404.
21525 #
21526 # 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
21527 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
21528 # the policy in RouteRule.customErrorResponsePolicy takes
21529 # effect. If any of the requests in this example encounter a 500
21530 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
21531 #
21532 # When
21533 # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
21534 # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
21535 # a retry, if load balancer is successful in reaching the
21536 # service, the defaultCustomErrorResponsePolicy is ignored and
21537 # the response from the service is returned to the client.
21538 #
21539 # defaultCustomErrorResponsePolicy is supported only for
21540 # global external Application Load Balancers.
21541 # backend service or backend bucket responds with an error.
21542 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
21543 #
21544 # In a given policy, if you specify rules for both a range of error codes
21545 # as well as rules for specific error codes then rules with specific error
21546 # codes have a higher priority. For example, assume that you configure a rule
21547 # for 401 (Un-authorized) code, and another for all 4 series
21548 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
21549 # However if the backend service returns a 403, the rule for4xx takes effect.
21550 { # Specifies the mapping between the response code that will be returned along
21551 # with the custom error content and the response code returned by the backend
21552 # service.
21553 &quot;matchResponseCodes&quot;: [ # Valid values include:
21554 #
21555 #
21556 # - A number between 400 and 599: For example
21557 # 401 or 503, in which case the load balancer
21558 # applies the policy if the error code exactly matches this value.
21559 # - 5xx: Load Balancer will apply the policy if the
21560 # backend service responds with any response code in the range of
21561 # 500 to 599.
21562 # - 4xx: Load
21563 # Balancer will apply the policy if the backend service responds with any
21564 # response code in the range of 400 to
21565 # 499.
21566 #
21567 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
21568 &quot;A String&quot;,
21569 ],
21570 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
21571 # error content. If overrideResponseCode is not supplied, the
21572 # same response code returned by the original backend bucket or backend
21573 # service is returned to the client.
21574 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
21575 #
21576 # path must start
21577 # with a leading slash. path cannot have trailing slashes.
21578 #
21579 # If the file is not available in backendBucket or the
21580 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
21581 #
21582 # The value must
21583 # be from 1 to 1024 characters
21584 },
21585 ],
21586 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
21587 # contains the custom error content. Examples are:
21588 #
21589 #
21590 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
21591 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
21592 # - global/backendBuckets/myBackendBucket
21593 #
21594 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
21595 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
21596 #
21597 # If load balancer cannot reach
21598 # the backendBucket, a simple Not Found Error will
21599 # be returned, with the original response code (oroverrideResponseCode if configured).
21600 #
21601 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
21602 },
21603 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
21604 # pathRules or routeRules match. The load balancer
21605 # performs advanced routing actions, such as URL rewrites and
21606 # header transformations, before forwarding the request to the
21607 # selected backend.
21608 #
21609 #
21610 # Only one of defaultUrlRedirect, defaultService
21611 # or defaultRouteAction.weightedBackendService can be set.
21612 #
21613 #
21614 # URL maps for classic Application Load Balancers only support
21615 # the urlRewrite action within a path matcher&#x27;sdefaultRouteAction.
21616 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
21617 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
21618 # property must be specified. This policy cannot be specified if any target
21619 # backend has Identity-Aware Proxy enabled.
21620 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
21621 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
21622 # header names can be specified. The cache is bypassed for all `cacheMode`
21623 # values.
21624 &quot;A String&quot;,
21625 ],
21626 &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
21627 # on the backend type: for Backend Services, the complete request URI is
21628 # used; for Backend Buckets, the request URI is used without the protocol or
21629 # host, and only query parameters known to Cloud Storage are included.
21630 # Policy defined on Route Action.
21631 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
21632 # parameters will be included. Either specify `excludedQueryParameters`
21633 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
21634 # encoded and not treated as delimiters.
21635 #
21636 # Note: This field applies to routes that use backend services. Attempting
21637 # to set it on a route that points exclusively to Backend Buckets will
21638 # result in a configuration error. For routes that point to a Backend
21639 # Bucket, use `includedQueryParameters` to define which parameters should
21640 # be part of the cache key.
21641 &quot;A String&quot;,
21642 ],
21643 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
21644 #
21645 # Note: This setting is only applicable to routes that use a Backend
21646 # Service. It does not affect requests served by a Backend Bucket, as the
21647 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
21648 # it on a route that points exclusively to Backend Buckets will result in a
21649 # configuration error.
21650 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
21651 #
21652 # Note: This setting is only applicable to routes that use a Backend
21653 # Service. It does not affect requests served by a Backend Bucket, as the
21654 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
21655 # set on a route that points exclusively to Backend Buckets will result in
21656 # a configuration error.
21657 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
21658 # `includedQueryParameters` and `excludedQueryParameters`. If neither
21659 # is set, the entire query string will be included. If false, the query
21660 # string will be excluded from the cache key entirely.
21661 #
21662 # Note: This field applies to routes that use backend services. Attempting
21663 # to set it on a route that points exclusively to Backend Buckets will
21664 # result in a configuration error. For routes that point to a Backend
21665 # Bucket, use `includedQueryParameters` to define which parameters should
21666 # be part of the cache key.
21667 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
21668 # The name=value pair will be used in the cache key Cloud CDN generates.
21669 #
21670 # Note: This setting is only applicable to routes that use a Backend
21671 # Service. It does not affect requests served by a Backend Bucket.
21672 # Attempting to set it on a route that points exclusively to Backend
21673 # Buckets will result in a configuration error. Up to 5 cookie names can be
21674 # specified.
21675 &quot;A String&quot;,
21676 ],
21677 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
21678 &quot;A String&quot;,
21679 ],
21680 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
21681 # parameters will be excluded. Either specify `includedQueryParameters`
21682 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
21683 # encoded and not treated as delimiters.
21684 &quot;A String&quot;,
21685 ],
21686 },
21687 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
21688 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
21689 &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
21690 # content. This is used to clamp the max-age (or Expires) value sent to the
21691 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
21692 # is used for the response max-age directive, along with a &quot;public&quot;
21693 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
21694 # clamps the max-age from the origin (if specified), or else sets the
21695 # response max-age directive to the lesser of the `clientTtl` and
21696 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
21697 # present. The maximum allowed value is 31,622,400s (1 year). If not
21698 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
21699 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
21700 # `USE_ORIGIN_HEADERS`.
21701 # as a count of seconds and fractions of seconds at nanosecond
21702 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21703 # or &quot;month&quot;. Range is approximately 10,000 years.
21704 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21705 # Durations less than one second are represented with a 0
21706 # `seconds` field and a positive `nanos` field. Must be from 0
21707 # to 999,999,999 inclusive.
21708 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21709 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21710 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21711 },
21712 &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
21713 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
21714 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
21715 # greater than that of `maxTtl`. When the `cacheMode` is set to
21716 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
21717 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
21718 # accessed objects may be evicted from the cache before the defined TTL. If
21719 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
21720 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
21721 # `USE_ORIGIN_HEADERS`.
21722 # as a count of seconds and fractions of seconds at nanosecond
21723 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21724 # or &quot;month&quot;. Range is approximately 10,000 years.
21725 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21726 # Durations less than one second are represented with a 0
21727 # `seconds` field and a positive `nanos` field. Must be from 0
21728 # to 999,999,999 inclusive.
21729 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21730 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21731 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21732 },
21733 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
21734 # attempt to set a max-age or s-maxage higher than this, or an Expires header
21735 # more than `maxTtl` seconds in the future will be capped at the value of
21736 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
21737 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
21738 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
21739 # Infrequently accessed objects may be evicted from the cache before the
21740 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
21741 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
21742 # mode.
21743 # as a count of seconds and fractions of seconds at nanosecond
21744 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21745 # or &quot;month&quot;. Range is approximately 10,000 years.
21746 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21747 # Durations less than one second are represented with a 0
21748 # `seconds` field and a positive `nanos` field. Must be from 0
21749 # to 999,999,999 inclusive.
21750 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21751 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21752 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21753 },
21754 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
21755 # to apply fine-grained caching for common errors or redirects.
21756 # This can reduce the load on your origin and improve end-user
21757 # experience by reducing response latency.
21758 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
21759 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
21760 # the specified response code that lack any Cache-Control, Expires, or
21761 # Pragma: no-cache directives. When the `cacheMode` is set to
21762 # `FORCE_CACHE_ALL`, negative caching applies to all responses
21763 # with the specified response code, and overrides any caching headers. By
21764 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
21765 #
21766 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
21767 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
21768 # * 405 (Method Not Found), 501 (Not Implemented): 60s
21769 #
21770 # These defaults can be overridden in `negativeCachingPolicy`.
21771 # If not specified, Cloud CDN applies negative caching by default.
21772 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
21773 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
21774 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
21775 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
21776 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
21777 # all response codes that you wish to cache. Cloud CDN will not apply any
21778 # default negative caching when a policy exists.
21779 { # Specify CDN TTLs for response error codes.
21780 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
21781 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
21782 # specified as values, and you cannot specify a status code more than
21783 # once.
21784 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
21785 # corresponding status code.
21786 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
21787 # objects may be evicted from the cache before the defined TTL.
21788 # as a count of seconds and fractions of seconds at nanosecond
21789 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21790 # or &quot;month&quot;. Range is approximately 10,000 years.
21791 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21792 # Durations less than one second are represented with a 0
21793 # `seconds` field and a positive `nanos` field. Must be from 0
21794 # to 999,999,999 inclusive.
21795 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21796 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21797 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21798 },
21799 },
21800 ],
21801 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
21802 # requests into a small number of requests to the origin. If not specified,
21803 # Cloud CDN applies request coalescing by default.
21804 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
21805 # content with the origin, or when an error is encountered when refreshing
21806 # the cache.
21807 # This setting defines the default &quot;max-stale&quot; duration for any cached
21808 # responses that do not specify a max-stale directive. Stale responses that
21809 # exceed the TTL configured here will not be served. The default limit
21810 # (max-stale) is 86400s (1 day), which will allow stale content to be
21811 # served up to this limit beyond the max-age (or s-maxage) of a cached
21812 # response.
21813 # The maximum allowed value is 604800 (1 week).
21814 # Set this to zero (0) to disable serve-while-stale.
21815 # as a count of seconds and fractions of seconds at nanosecond
21816 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21817 # or &quot;month&quot;. Range is approximately 10,000 years.
21818 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21819 # Durations less than one second are represented with a 0
21820 # `seconds` field and a positive `nanos` field. Must be from 0
21821 # to 999,999,999 inclusive.
21822 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21823 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21824 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21825 },
21826 },
21827 &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
21828 # information about the W3C recommendation for cross-origin resource sharing
21829 # (CORS), see Fetch API Living
21830 # Standard.
21831 #
21832 # Not supported when the URL map is bound to a target gRPC proxy.
21833 # information about the W3C recommendation for cross-origin resource sharing
21834 # (CORS), see Fetch API Living
21835 # Standard.
21836 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
21837 # indicates that
21838 # the actual request can include user credentials. This field translates to
21839 # the Access-Control-Allow-Credentials header.
21840 #
21841 # Default is false.
21842 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
21843 # header.
21844 &quot;A String&quot;,
21845 ],
21846 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
21847 # header.
21848 &quot;A String&quot;,
21849 ],
21850 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
21851 # more information, see regular expression syntax.
21852 #
21853 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
21854 #
21855 # Regular expressions can only be used when the loadBalancingScheme is
21856 # set to INTERNAL_SELF_MANAGED.
21857 &quot;A String&quot;,
21858 ],
21859 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
21860 #
21861 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
21862 &quot;A String&quot;,
21863 ],
21864 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
21865 # The default value is false, which indicates that the CORS
21866 # policy is in effect.
21867 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
21868 # header.
21869 &quot;A String&quot;,
21870 ],
21871 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
21872 # seconds. This field translates to the Access-Control-Max-Age
21873 # header.
21874 },
21875 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
21876 # the resiliency of clients to backend service failure. As part of fault
21877 # injection, when clients send requests to a backend service, delays can be
21878 # introduced by a load balancer on a percentage of requests before sending
21879 # those requests to the backend service. Similarly requests from clients can
21880 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
21881 # that are configured with a fault_injection_policy if:
21882 # 1. The traffic is generated by fault injection AND
21883 # 2. The fault injection is not a delay fault injection.
21884 # Fault injection is not supported with the classic Application Load Balancer
21885 # . To see which load balancers support fault injection,
21886 # see Load
21887 # balancing: Routing and traffic management features.
21888 # the resiliency of clients to backend service failure. As part of fault
21889 # injection, when clients send requests to a backend service, delays can be
21890 # introduced by the load balancer on a percentage of requests before sending
21891 # those request to the backend service. Similarly requests from clients can be
21892 # aborted by the load balancer for a percentage of requests.
21893 &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
21894 # injection.
21895 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
21896 #
21897 # The value must be from 200 to 599 inclusive.
21898 #
21899 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
21900 # according to this
21901 # mapping table. HTTP status 200 is mapped to gRPC status
21902 # UNKNOWN. Injecting an OK status is currently not supported by
21903 # Traffic Director.
21904 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
21905 # that is aborted as part of fault injection.
21906 #
21907 # The value must be from 0.0 to 100.0 inclusive.
21908 },
21909 &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
21910 # injection, before being sent to a backend service.
21911 # request to the backend service as part of fault injection.
21912 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
21913 # as a count of seconds and fractions of seconds at nanosecond
21914 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21915 # or &quot;month&quot;. Range is approximately 10,000 years.
21916 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21917 # Durations less than one second are represented with a 0
21918 # `seconds` field and a positive `nanos` field. Must be from 0
21919 # to 999,999,999 inclusive.
21920 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21921 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21922 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21923 },
21924 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
21925 # which a delay is introduced as part of fault injection.
21926 #
21927 # The value must be from 0.0 to 100.0 inclusive.
21928 },
21929 },
21930 &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
21931 # Global EXTERNAL_MANAGED load balancer schemes.
21932 # Either Cloud CDN must be enabled on the backend service or backend bucket
21933 # serving the route, or cache policy must be configured on the same route
21934 # dynamically processes and delivers images from the network edge.
21935 # Image Optimization is only available for Global External Application Load
21936 # Balancers.
21937 # Either Cloud CDN must be enabled on the backend service or backend bucket
21938 # serving the route, or cache policy must be configured on the same route.
21939 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
21940 },
21941 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
21942 # Unlike the timeout field where the timeout duration starts
21943 # from the time the request has been fully processed (known as*end-of-stream*),
21944 # the duration in this field is computed from the beginning of the stream
21945 # until the response has been processed, including all retries. A
21946 # stream that does not complete in this duration is closed.
21947 #
21948 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
21949 # with the route.
21950 #
21951 # This field is only allowed if the Url map is used with backend services
21952 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
21953 # as a count of seconds and fractions of seconds at nanosecond
21954 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21955 # or &quot;month&quot;. Range is approximately 10,000 years.
21956 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21957 # Durations less than one second are represented with a 0
21958 # `seconds` field and a positive `nanos` field. Must be from 0
21959 # to 999,999,999 inclusive.
21960 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21961 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21962 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21963 },
21964 &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
21965 # are shadowed to a separate mirrored backend service. The load balancer does
21966 # not wait for responses from the shadow service. Before sending traffic
21967 # to the shadow service, the host / authority header is suffixed with-shadow.
21968 #
21969 # Not supported when the URL map is bound to a target gRPC proxy that
21970 # has the validateForProxyless field set to true.
21971 # are shadowed to a separate mirrored backend service. The load balancer
21972 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
21973 # to the shadow service, the host or authority header is suffixed with-shadow.
21974 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
21975 # mirrored to.
21976 #
21977 # The backend service configured for a mirroring
21978 # policy must reference backends that are of the same type as the original
21979 # backend service matched in the URL map.
21980 #
21981 # Serverless NEG backends are not currently supported as a mirrored
21982 # backend service.
21983 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
21984 },
21985 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
21986 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
21987 # If not specified, defaults to 1.
21988 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
21989 #
21990 # If not specified, will use the timeout set in theHttpRouteAction field.
21991 # If timeout in the HttpRouteAction field is not set, this field
21992 # uses the largest timeout
21993 # among all backend services associated with the route.
21994 #
21995 # Not supported when the URL map is bound to a target gRPC proxy that
21996 # has the validateForProxyless field set to true.
21997 # as a count of seconds and fractions of seconds at nanosecond
21998 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21999 # or &quot;month&quot;. Range is approximately 10,000 years.
22000 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
22001 # Durations less than one second are represented with a 0
22002 # `seconds` field and a positive `nanos` field. Must be from 0
22003 # to 999,999,999 inclusive.
22004 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22005 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22006 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22007 },
22008 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
22009 # values are:
22010 #
22011 # - 5xx: retry is attempted if the instance or endpoint
22012 # responds with any 5xx response code, or if the instance or
22013 # endpoint does not respond at all. For example, disconnects, reset, read
22014 # timeout, connection failure, and refused streams.
22015 # - gateway-error: Similar to 5xx, but only
22016 # applies to response codes 502, 503 or504.
22017 # - connect-failure: a retry is attempted on failures
22018 # connecting to the instance or endpoint. For example, connection
22019 # timeouts.
22020 # - retriable-4xx: a retry is attempted if the instance
22021 # or endpoint responds with a 4xx response code.
22022 # The only error that you can retry is error code 409.
22023 # - refused-stream: a retry is attempted if the instance
22024 # or endpoint resets the stream with a REFUSED_STREAM error
22025 # code. This reset type indicates that it is safe to retry.
22026 # - cancelled: a retry is attempted if the gRPC status
22027 # code in the response header is set to cancelled.
22028 # - deadline-exceeded: a retry is attempted if the gRPC
22029 # status code in the response header is set todeadline-exceeded.
22030 # - internal: a retry is attempted if the gRPC
22031 # status code in the response header is set tointernal.
22032 # - resource-exhausted: a retry is attempted if the gRPC
22033 # status code in the response header is set toresource-exhausted.
22034 # - unavailable: a retry is attempted if the gRPC
22035 # status code in the response header is set tounavailable.
22036 #
22037 # Only the following codes are supported when the URL map is bound to
22038 # target gRPC proxy that has validateForProxyless field set to true.
22039 #
22040 # - cancelled
22041 # - deadline-exceeded
22042 # - internal
22043 # - resource-exhausted
22044 # - unavailable
22045 &quot;A String&quot;,
22046 ],
22047 },
22048 &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
22049 # time the request has been fully processed (known as *end-of-stream*)
22050 # up until the response has been processed. Timeout includes
22051 # all retries.
22052 #
22053 # If not specified, this field uses the largest timeout among all backend
22054 # services associated with the route.
22055 #
22056 # Not supported when the URL map is bound to a target gRPC proxy that
22057 # has validateForProxyless field set to true.
22058 # as a count of seconds and fractions of seconds at nanosecond
22059 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
22060 # or &quot;month&quot;. Range is approximately 10,000 years.
22061 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
22062 # Durations less than one second are represented with a 0
22063 # `seconds` field and a positive `nanos` field. Must be from 0
22064 # to 999,999,999 inclusive.
22065 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22066 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22067 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22068 },
22069 &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
22070 # to the matched service.
22071 #
22072 # urlRewrite is the only action supported in UrlMaps
22073 # for classic Application Load Balancers.
22074 #
22075 # Not supported when the URL map is bound to a target gRPC proxy that
22076 # has the validateForProxyless field set to true.
22077 # backend service.
22078 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
22079 # host header is replaced with contents of hostRewrite.
22080 #
22081 # The value must be from 1 to 255 characters.
22082 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
22083 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
22084 #
22085 # The value must be from 1 to 1024 characters.
22086 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
22087 # header) using the HTTP template syntax.
22088 #
22089 # A corresponding
22090 # path_template_match must be specified. Any template variables must exist in
22091 # the path_template_match field.
22092 #
22093 #
22094 # - -At least one variable must be specified in the path_template_match
22095 # field
22096 # - You can omit variables from the rewritten URL
22097 # - The * and ** operators cannot be matched
22098 # unless they have a corresponding variable name - e.g.
22099 # {format=*} or {var=**}.
22100 #
22101 # For example, a path_template_match of /static/{format=**}
22102 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
22103 # rewrite, so that /{country}/{format}/{suffix=**} can be
22104 # rewritten as /content/{format}/{country}/{suffix}.
22105 #
22106 # At least
22107 # one non-empty routeRules[].matchRules[].path_template_match is
22108 # required.
22109 #
22110 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
22111 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
22112 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
22113 # It uses RE2 syntax with the following constraints:
22114 #
22115 #
22116 # - Any single character operators
22117 # - Groups are allowed to have only submatch operator inside
22118 # - Groups are allowed only without any char repetition, e.g.
22119 # .*
22120 # - Any char repetition, e.g. .*, is
22121 # only allowed to be used in a single regex together with:
22122 #
22123 #
22124 # - Empty string operators
22125 # - Other repetitions
22126 # - Ranges
22127 # - Repetitions of ranges
22128 #
22129 #
22130 # - Ranges are only allowed to have:
22131 #
22132 #
22133 # - Character range
22134 # - Digits range
22135 # - Symbols listed in characters allowed for ranges
22136 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
22137 # the path.
22138 },
22139 },
22140 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
22141 # occurs. The weights determine the fraction of traffic that flows to
22142 # their corresponding backend service. If all traffic needs to
22143 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
22144 #
22145 # After a backend service is identified and before forwarding
22146 # the request to
22147 # the backend service, advanced routing actions such as URL rewrites and
22148 # header transformations are applied depending on additional settings
22149 # specified in this HttpRouteAction.
22150 { # In contrast to a single BackendService in
22151 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
22152 # multiple backend services. The volume of traffic for each
22153 # backend service is proportional to the weight specified
22154 # in each WeightedBackendService
22155 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
22156 # resource. Before
22157 # forwarding the request to backendService, the load balancer
22158 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
22159 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
22160 # effect for the selected backendService.
22161 #
22162 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
22163 #
22164 # headerAction is not supported for load balancers that have
22165 # their loadBalancingScheme set to EXTERNAL.
22166 #
22167 # Not supported when the URL map is bound to a target gRPC proxy that
22168 # has validateForProxyless field set to true.
22169 # the request is passed along to the selected backendService.
22170 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
22171 { # Specification determining how headers are added to requests or responses.
22172 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
22173 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
22174 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
22175 # that already
22176 # exist for the header. If true, headerValue is set for the
22177 # header, discarding any values that were set for that header.
22178 #
22179 # The default value is true,
22180 # unless a variable is present in headerValue,
22181 # in which case the default value is false.
22182 # .
22183 },
22184 ],
22185 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
22186 # request before forwarding the request to the backendService.
22187 &quot;A String&quot;,
22188 ],
22189 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
22190 # client.
22191 { # Specification determining how headers are added to requests or responses.
22192 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
22193 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
22194 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
22195 # that already
22196 # exist for the header. If true, headerValue is set for the
22197 # header, discarding any values that were set for that header.
22198 #
22199 # The default value is true,
22200 # unless a variable is present in headerValue,
22201 # in which case the default value is false.
22202 # .
22203 },
22204 ],
22205 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
22206 # response before sending the response back to the client.
22207 &quot;A String&quot;,
22208 ],
22209 },
22210 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
22211 # computed asweight / (sum of all weightedBackendService weights in routeAction).
22212 #
22213 # The selection of a backend service is determined only for new traffic.
22214 # Once a user&#x27;s request has been directed to a backend service,
22215 # subsequent requests are sent to the same backend service as
22216 # determined by the backend service&#x27;s session affinity policy.
22217 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
22218 # splitting. If you do, the weighted traffic splitting configuration takes
22219 # precedence.
22220 #
22221 # The value must be from 0 to 1000.
22222 },
22223 ],
22224 },
22225 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource. This
22226 # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
22227 # matched. For example, the
22228 # following are all valid URLs to a BackendService resource:
22229 #
22230 #
22231 # - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
22232 # - compute/v1/projects/project/global/backendServices/backendService
22233 # - global/backendServices/backendService
22234 #
22235 #
22236 # If defaultRouteAction is also specified, advanced
22237 # routing actions, such as URL rewrites, take effect before sending the
22238 # request to the backend.
22239 #
22240 #
22241 # Only one of defaultUrlRedirect, defaultService
22242 # or defaultRouteAction.weightedBackendService can be set.
22243 #
22244 #
22245 # Authorization requires one or more of the following Google IAM permissions on the
22246 # specified resource default_service:
22247 #
22248 #
22249 # - compute.backendBuckets.use
22250 # - compute.backendServices.use
22251 &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
22252 # by defaultUrlRedirect.
22253 #
22254 #
22255 # Only one of defaultUrlRedirect, defaultService
22256 # or defaultRouteAction.weightedBackendService can be set.
22257 #
22258 #
22259 # Not supported when the URL map is bound to a target gRPC proxy.
22260 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
22261 # was supplied in the request.
22262 #
22263 # The value must be from 1 to 255
22264 # characters.
22265 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
22266 # set to HTTPS.
22267 # If set to false, the URL scheme of the redirected request
22268 # remains the same as that of the request.
22269 #
22270 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
22271 #
22272 # The default is set to false.
22273 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
22274 # that was supplied in the request.
22275 #
22276 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
22277 # supplied, the path of the original request is used for the redirect.
22278 #
22279 # The value must be from 1 to 1024 characters.
22280 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
22281 # the HttpRouteRuleMatch, retaining the remaining portion
22282 # of the URL before redirecting the request.
22283 #
22284 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
22285 # supplied, the path of the original request is used for the redirect.
22286 #
22287 # The value must be from 1 to 1024 characters.
22288 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
22289 #
22290 # Supported values are:
22291 #
22292 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
22293 # to 301.
22294 # - FOUND, which corresponds to 302.
22295 # - SEE_OTHER which corresponds to 303.
22296 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
22297 # method is retained.
22298 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
22299 # method is retained.
22300 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
22301 # URL is
22302 # removed before redirecting the request. If set to false, the
22303 # query portion of the original URL is retained.
22304 #
22305 # The default is set to false.
22306 },
22307 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
22308 # create the resource.
22309 &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
22310 # for the selected backend service.
22311 #
22312 # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
22313 #
22314 # HeaderAction is not supported for load balancers
22315 # that have
22316 # their loadBalancingScheme set to EXTERNAL.
22317 #
22318 # Not supported when the URL map is bound to a target gRPC proxy that
22319 # has validateForProxyless field set to true.
22320 # the request is passed along to the selected backendService.
22321 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
22322 { # Specification determining how headers are added to requests or responses.
22323 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
22324 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
22325 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
22326 # that already
22327 # exist for the header. If true, headerValue is set for the
22328 # header, discarding any values that were set for that header.
22329 #
22330 # The default value is true,
22331 # unless a variable is present in headerValue,
22332 # in which case the default value is false.
22333 # .
22334 },
22335 ],
22336 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
22337 # request before forwarding the request to the backendService.
22338 &quot;A String&quot;,
22339 ],
22340 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
22341 # client.
22342 { # Specification determining how headers are added to requests or responses.
22343 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
22344 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
22345 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
22346 # that already
22347 # exist for the header. If true, headerValue is set for the
22348 # header, discarding any values that were set for that header.
22349 #
22350 # The default value is true,
22351 # unless a variable is present in headerValue,
22352 # in which case the default value is false.
22353 # .
22354 },
22355 ],
22356 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
22357 # response before sending the response back to the client.
22358 &quot;A String&quot;,
22359 ],
22360 },
22361 &quot;name&quot;: &quot;A String&quot;, # The name to which this PathMatcher is referred by theHostRule.
22362 &quot;pathRules&quot;: [ # The list of path rules. Use this list instead of routeRules
22363 # when routing based on simple path matching is all that&#x27;s required. A path
22364 # rule can only include a wildcard character (*) after a
22365 # forward slash character (&quot;/&quot;).
22366 #
22367 # The order by which path rules are specified does not matter.
22368 # Matches are always done on the longest-path-first basis.
22369 #
22370 # For example: a pathRule with a path /a/b/c/* will match
22371 # before /a/b/* irrespective of the order in which those paths appear in this
22372 # list.
22373 #
22374 # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
22375 { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
22376 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
22377 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
22378 #
22379 # If a policy for an
22380 # error code is not configured for the PathRule, a policy for
22381 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
22382 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
22383 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
22384 # effect.
22385 #
22386 # For example, consider a UrlMap with the following configuration:
22387 #
22388 #
22389 # - UrlMap.defaultCustomErrorResponsePolicy are configured
22390 # with policies for 5xx and 4xx errors
22391 # - A PathRule for /coming_soon/ is configured for the error
22392 # code 404.
22393 #
22394 # 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
22395 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
22396 # the policy in PathRule.customErrorResponsePolicy takes
22397 # effect. If any of the requests in this example encounter a 500
22398 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
22399 #
22400 # customErrorResponsePolicy is supported only for
22401 # global external Application Load Balancers.
22402 # backend service or backend bucket responds with an error.
22403 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
22404 #
22405 # In a given policy, if you specify rules for both a range of error codes
22406 # as well as rules for specific error codes then rules with specific error
22407 # codes have a higher priority. For example, assume that you configure a rule
22408 # for 401 (Un-authorized) code, and another for all 4 series
22409 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
22410 # However if the backend service returns a 403, the rule for4xx takes effect.
22411 { # Specifies the mapping between the response code that will be returned along
22412 # with the custom error content and the response code returned by the backend
22413 # service.
22414 &quot;matchResponseCodes&quot;: [ # Valid values include:
22415 #
22416 #
22417 # - A number between 400 and 599: For example
22418 # 401 or 503, in which case the load balancer
22419 # applies the policy if the error code exactly matches this value.
22420 # - 5xx: Load Balancer will apply the policy if the
22421 # backend service responds with any response code in the range of
22422 # 500 to 599.
22423 # - 4xx: Load
22424 # Balancer will apply the policy if the backend service responds with any
22425 # response code in the range of 400 to
22426 # 499.
22427 #
22428 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
22429 &quot;A String&quot;,
22430 ],
22431 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
22432 # error content. If overrideResponseCode is not supplied, the
22433 # same response code returned by the original backend bucket or backend
22434 # service is returned to the client.
22435 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
22436 #
22437 # path must start
22438 # with a leading slash. path cannot have trailing slashes.
22439 #
22440 # If the file is not available in backendBucket or the
22441 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
22442 #
22443 # The value must
22444 # be from 1 to 1024 characters
22445 },
22446 ],
22447 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
22448 # contains the custom error content. Examples are:
22449 #
22450 #
22451 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
22452 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
22453 # - global/backendBuckets/myBackendBucket
22454 #
22455 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
22456 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
22457 #
22458 # If load balancer cannot reach
22459 # the backendBucket, a simple Not Found Error will
22460 # be returned, with the original response code (oroverrideResponseCode if configured).
22461 #
22462 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
22463 },
22464 &quot;paths&quot;: [ # The list of path patterns to match. Each must start with /
22465 # and the only place a * is allowed is at the end following
22466 # a /. The string fed to the path matcher does not include
22467 # any text after the first ? or #, and
22468 # those chars are not allowed here.
22469 &quot;A String&quot;,
22470 ],
22471 &quot;routeAction&quot;: { # In response to a matching path, the load balancer
22472 # performs advanced routing actions, such as URL rewrites and header
22473 # transformations, before forwarding the request to the selected
22474 # backend.
22475 #
22476 #
22477 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
22478 #
22479 #
22480 # URL maps for classic Application Load Balancers only support
22481 # the urlRewrite action within a path rule&#x27;srouteAction.
22482 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
22483 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
22484 # property must be specified. This policy cannot be specified if any target
22485 # backend has Identity-Aware Proxy enabled.
22486 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
22487 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
22488 # header names can be specified. The cache is bypassed for all `cacheMode`
22489 # values.
22490 &quot;A String&quot;,
22491 ],
22492 &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
22493 # on the backend type: for Backend Services, the complete request URI is
22494 # used; for Backend Buckets, the request URI is used without the protocol or
22495 # host, and only query parameters known to Cloud Storage are included.
22496 # Policy defined on Route Action.
22497 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
22498 # parameters will be included. Either specify `excludedQueryParameters`
22499 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
22500 # encoded and not treated as delimiters.
22501 #
22502 # Note: This field applies to routes that use backend services. Attempting
22503 # to set it on a route that points exclusively to Backend Buckets will
22504 # result in a configuration error. For routes that point to a Backend
22505 # Bucket, use `includedQueryParameters` to define which parameters should
22506 # be part of the cache key.
22507 &quot;A String&quot;,
22508 ],
22509 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
22510 #
22511 # Note: This setting is only applicable to routes that use a Backend
22512 # Service. It does not affect requests served by a Backend Bucket, as the
22513 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
22514 # it on a route that points exclusively to Backend Buckets will result in a
22515 # configuration error.
22516 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
22517 #
22518 # Note: This setting is only applicable to routes that use a Backend
22519 # Service. It does not affect requests served by a Backend Bucket, as the
22520 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
22521 # set on a route that points exclusively to Backend Buckets will result in
22522 # a configuration error.
22523 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
22524 # `includedQueryParameters` and `excludedQueryParameters`. If neither
22525 # is set, the entire query string will be included. If false, the query
22526 # string will be excluded from the cache key entirely.
22527 #
22528 # Note: This field applies to routes that use backend services. Attempting
22529 # to set it on a route that points exclusively to Backend Buckets will
22530 # result in a configuration error. For routes that point to a Backend
22531 # Bucket, use `includedQueryParameters` to define which parameters should
22532 # be part of the cache key.
22533 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
22534 # The name=value pair will be used in the cache key Cloud CDN generates.
22535 #
22536 # Note: This setting is only applicable to routes that use a Backend
22537 # Service. It does not affect requests served by a Backend Bucket.
22538 # Attempting to set it on a route that points exclusively to Backend
22539 # Buckets will result in a configuration error. Up to 5 cookie names can be
22540 # specified.
22541 &quot;A String&quot;,
22542 ],
22543 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
22544 &quot;A String&quot;,
22545 ],
22546 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
22547 # parameters will be excluded. Either specify `includedQueryParameters`
22548 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
22549 # encoded and not treated as delimiters.
22550 &quot;A String&quot;,
22551 ],
22552 },
22553 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
22554 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
22555 &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
22556 # content. This is used to clamp the max-age (or Expires) value sent to the
22557 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
22558 # is used for the response max-age directive, along with a &quot;public&quot;
22559 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
22560 # clamps the max-age from the origin (if specified), or else sets the
22561 # response max-age directive to the lesser of the `clientTtl` and
22562 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
22563 # present. The maximum allowed value is 31,622,400s (1 year). If not
22564 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
22565 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
22566 # `USE_ORIGIN_HEADERS`.
22567 # as a count of seconds and fractions of seconds at nanosecond
22568 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
22569 # or &quot;month&quot;. Range is approximately 10,000 years.
22570 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
22571 # Durations less than one second are represented with a 0
22572 # `seconds` field and a positive `nanos` field. Must be from 0
22573 # to 999,999,999 inclusive.
22574 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22575 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22576 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22577 },
22578 &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
22579 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
22580 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
22581 # greater than that of `maxTtl`. When the `cacheMode` is set to
22582 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
22583 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
22584 # accessed objects may be evicted from the cache before the defined TTL. If
22585 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
22586 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
22587 # `USE_ORIGIN_HEADERS`.
22588 # as a count of seconds and fractions of seconds at nanosecond
22589 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
22590 # or &quot;month&quot;. Range is approximately 10,000 years.
22591 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
22592 # Durations less than one second are represented with a 0
22593 # `seconds` field and a positive `nanos` field. Must be from 0
22594 # to 999,999,999 inclusive.
22595 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22596 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22597 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22598 },
22599 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
22600 # attempt to set a max-age or s-maxage higher than this, or an Expires header
22601 # more than `maxTtl` seconds in the future will be capped at the value of
22602 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
22603 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
22604 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
22605 # Infrequently accessed objects may be evicted from the cache before the
22606 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
22607 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
22608 # mode.
22609 # as a count of seconds and fractions of seconds at nanosecond
22610 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
22611 # or &quot;month&quot;. Range is approximately 10,000 years.
22612 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
22613 # Durations less than one second are represented with a 0
22614 # `seconds` field and a positive `nanos` field. Must be from 0
22615 # to 999,999,999 inclusive.
22616 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22617 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22618 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22619 },
22620 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
22621 # to apply fine-grained caching for common errors or redirects.
22622 # This can reduce the load on your origin and improve end-user
22623 # experience by reducing response latency.
22624 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
22625 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
22626 # the specified response code that lack any Cache-Control, Expires, or
22627 # Pragma: no-cache directives. When the `cacheMode` is set to
22628 # `FORCE_CACHE_ALL`, negative caching applies to all responses
22629 # with the specified response code, and overrides any caching headers. By
22630 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
22631 #
22632 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
22633 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
22634 # * 405 (Method Not Found), 501 (Not Implemented): 60s
22635 #
22636 # These defaults can be overridden in `negativeCachingPolicy`.
22637 # If not specified, Cloud CDN applies negative caching by default.
22638 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
22639 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
22640 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
22641 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
22642 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
22643 # all response codes that you wish to cache. Cloud CDN will not apply any
22644 # default negative caching when a policy exists.
22645 { # Specify CDN TTLs for response error codes.
22646 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
22647 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
22648 # specified as values, and you cannot specify a status code more than
22649 # once.
22650 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
22651 # corresponding status code.
22652 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
22653 # objects may be evicted from the cache before the defined TTL.
22654 # as a count of seconds and fractions of seconds at nanosecond
22655 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
22656 # or &quot;month&quot;. Range is approximately 10,000 years.
22657 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
22658 # Durations less than one second are represented with a 0
22659 # `seconds` field and a positive `nanos` field. Must be from 0
22660 # to 999,999,999 inclusive.
22661 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22662 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22663 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22664 },
22665 },
22666 ],
22667 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
22668 # requests into a small number of requests to the origin. If not specified,
22669 # Cloud CDN applies request coalescing by default.
22670 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
22671 # content with the origin, or when an error is encountered when refreshing
22672 # the cache.
22673 # This setting defines the default &quot;max-stale&quot; duration for any cached
22674 # responses that do not specify a max-stale directive. Stale responses that
22675 # exceed the TTL configured here will not be served. The default limit
22676 # (max-stale) is 86400s (1 day), which will allow stale content to be
22677 # served up to this limit beyond the max-age (or s-maxage) of a cached
22678 # response.
22679 # The maximum allowed value is 604800 (1 week).
22680 # Set this to zero (0) to disable serve-while-stale.
22681 # as a count of seconds and fractions of seconds at nanosecond
22682 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
22683 # or &quot;month&quot;. Range is approximately 10,000 years.
22684 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
22685 # Durations less than one second are represented with a 0
22686 # `seconds` field and a positive `nanos` field. Must be from 0
22687 # to 999,999,999 inclusive.
22688 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22689 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22690 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22691 },
22692 },
22693 &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
22694 # information about the W3C recommendation for cross-origin resource sharing
22695 # (CORS), see Fetch API Living
22696 # Standard.
22697 #
22698 # Not supported when the URL map is bound to a target gRPC proxy.
22699 # information about the W3C recommendation for cross-origin resource sharing
22700 # (CORS), see Fetch API Living
22701 # Standard.
22702 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
22703 # indicates that
22704 # the actual request can include user credentials. This field translates to
22705 # the Access-Control-Allow-Credentials header.
22706 #
22707 # Default is false.
22708 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
22709 # header.
22710 &quot;A String&quot;,
22711 ],
22712 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
22713 # header.
22714 &quot;A String&quot;,
22715 ],
22716 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
22717 # more information, see regular expression syntax.
22718 #
22719 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
22720 #
22721 # Regular expressions can only be used when the loadBalancingScheme is
22722 # set to INTERNAL_SELF_MANAGED.
22723 &quot;A String&quot;,
22724 ],
22725 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
22726 #
22727 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
22728 &quot;A String&quot;,
22729 ],
22730 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
22731 # The default value is false, which indicates that the CORS
22732 # policy is in effect.
22733 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
22734 # header.
22735 &quot;A String&quot;,
22736 ],
22737 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
22738 # seconds. This field translates to the Access-Control-Max-Age
22739 # header.
22740 },
22741 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
22742 # the resiliency of clients to backend service failure. As part of fault
22743 # injection, when clients send requests to a backend service, delays can be
22744 # introduced by a load balancer on a percentage of requests before sending
22745 # those requests to the backend service. Similarly requests from clients can
22746 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
22747 # that are configured with a fault_injection_policy if:
22748 # 1. The traffic is generated by fault injection AND
22749 # 2. The fault injection is not a delay fault injection.
22750 # Fault injection is not supported with the classic Application Load Balancer
22751 # . To see which load balancers support fault injection,
22752 # see Load
22753 # balancing: Routing and traffic management features.
22754 # the resiliency of clients to backend service failure. As part of fault
22755 # injection, when clients send requests to a backend service, delays can be
22756 # introduced by the load balancer on a percentage of requests before sending
22757 # those request to the backend service. Similarly requests from clients can be
22758 # aborted by the load balancer for a percentage of requests.
22759 &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
22760 # injection.
22761 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
22762 #
22763 # The value must be from 200 to 599 inclusive.
22764 #
22765 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
22766 # according to this
22767 # mapping table. HTTP status 200 is mapped to gRPC status
22768 # UNKNOWN. Injecting an OK status is currently not supported by
22769 # Traffic Director.
22770 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
22771 # that is aborted as part of fault injection.
22772 #
22773 # The value must be from 0.0 to 100.0 inclusive.
22774 },
22775 &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
22776 # injection, before being sent to a backend service.
22777 # request to the backend service as part of fault injection.
22778 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
22779 # as a count of seconds and fractions of seconds at nanosecond
22780 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
22781 # or &quot;month&quot;. Range is approximately 10,000 years.
22782 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
22783 # Durations less than one second are represented with a 0
22784 # `seconds` field and a positive `nanos` field. Must be from 0
22785 # to 999,999,999 inclusive.
22786 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22787 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22788 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22789 },
22790 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
22791 # which a delay is introduced as part of fault injection.
22792 #
22793 # The value must be from 0.0 to 100.0 inclusive.
22794 },
22795 },
22796 &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
22797 # Global EXTERNAL_MANAGED load balancer schemes.
22798 # Either Cloud CDN must be enabled on the backend service or backend bucket
22799 # serving the route, or cache policy must be configured on the same route
22800 # dynamically processes and delivers images from the network edge.
22801 # Image Optimization is only available for Global External Application Load
22802 # Balancers.
22803 # Either Cloud CDN must be enabled on the backend service or backend bucket
22804 # serving the route, or cache policy must be configured on the same route.
22805 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
22806 },
22807 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
22808 # Unlike the timeout field where the timeout duration starts
22809 # from the time the request has been fully processed (known as*end-of-stream*),
22810 # the duration in this field is computed from the beginning of the stream
22811 # until the response has been processed, including all retries. A
22812 # stream that does not complete in this duration is closed.
22813 #
22814 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
22815 # with the route.
22816 #
22817 # This field is only allowed if the Url map is used with backend services
22818 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
22819 # as a count of seconds and fractions of seconds at nanosecond
22820 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
22821 # or &quot;month&quot;. Range is approximately 10,000 years.
22822 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
22823 # Durations less than one second are represented with a 0
22824 # `seconds` field and a positive `nanos` field. Must be from 0
22825 # to 999,999,999 inclusive.
22826 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22827 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22828 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22829 },
22830 &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
22831 # are shadowed to a separate mirrored backend service. The load balancer does
22832 # not wait for responses from the shadow service. Before sending traffic
22833 # to the shadow service, the host / authority header is suffixed with-shadow.
22834 #
22835 # Not supported when the URL map is bound to a target gRPC proxy that
22836 # has the validateForProxyless field set to true.
22837 # are shadowed to a separate mirrored backend service. The load balancer
22838 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
22839 # to the shadow service, the host or authority header is suffixed with-shadow.
22840 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
22841 # mirrored to.
22842 #
22843 # The backend service configured for a mirroring
22844 # policy must reference backends that are of the same type as the original
22845 # backend service matched in the URL map.
22846 #
22847 # Serverless NEG backends are not currently supported as a mirrored
22848 # backend service.
22849 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
22850 },
22851 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
22852 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
22853 # If not specified, defaults to 1.
22854 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
22855 #
22856 # If not specified, will use the timeout set in theHttpRouteAction field.
22857 # If timeout in the HttpRouteAction field is not set, this field
22858 # uses the largest timeout
22859 # among all backend services associated with the route.
22860 #
22861 # Not supported when the URL map is bound to a target gRPC proxy that
22862 # has the validateForProxyless field set to true.
22863 # as a count of seconds and fractions of seconds at nanosecond
22864 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
22865 # or &quot;month&quot;. Range is approximately 10,000 years.
22866 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
22867 # Durations less than one second are represented with a 0
22868 # `seconds` field and a positive `nanos` field. Must be from 0
22869 # to 999,999,999 inclusive.
22870 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22871 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22872 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22873 },
22874 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
22875 # values are:
22876 #
22877 # - 5xx: retry is attempted if the instance or endpoint
22878 # responds with any 5xx response code, or if the instance or
22879 # endpoint does not respond at all. For example, disconnects, reset, read
22880 # timeout, connection failure, and refused streams.
22881 # - gateway-error: Similar to 5xx, but only
22882 # applies to response codes 502, 503 or504.
22883 # - connect-failure: a retry is attempted on failures
22884 # connecting to the instance or endpoint. For example, connection
22885 # timeouts.
22886 # - retriable-4xx: a retry is attempted if the instance
22887 # or endpoint responds with a 4xx response code.
22888 # The only error that you can retry is error code 409.
22889 # - refused-stream: a retry is attempted if the instance
22890 # or endpoint resets the stream with a REFUSED_STREAM error
22891 # code. This reset type indicates that it is safe to retry.
22892 # - cancelled: a retry is attempted if the gRPC status
22893 # code in the response header is set to cancelled.
22894 # - deadline-exceeded: a retry is attempted if the gRPC
22895 # status code in the response header is set todeadline-exceeded.
22896 # - internal: a retry is attempted if the gRPC
22897 # status code in the response header is set tointernal.
22898 # - resource-exhausted: a retry is attempted if the gRPC
22899 # status code in the response header is set toresource-exhausted.
22900 # - unavailable: a retry is attempted if the gRPC
22901 # status code in the response header is set tounavailable.
22902 #
22903 # Only the following codes are supported when the URL map is bound to
22904 # target gRPC proxy that has validateForProxyless field set to true.
22905 #
22906 # - cancelled
22907 # - deadline-exceeded
22908 # - internal
22909 # - resource-exhausted
22910 # - unavailable
22911 &quot;A String&quot;,
22912 ],
22913 },
22914 &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
22915 # time the request has been fully processed (known as *end-of-stream*)
22916 # up until the response has been processed. Timeout includes
22917 # all retries.
22918 #
22919 # If not specified, this field uses the largest timeout among all backend
22920 # services associated with the route.
22921 #
22922 # Not supported when the URL map is bound to a target gRPC proxy that
22923 # has validateForProxyless field set to true.
22924 # as a count of seconds and fractions of seconds at nanosecond
22925 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
22926 # or &quot;month&quot;. Range is approximately 10,000 years.
22927 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
22928 # Durations less than one second are represented with a 0
22929 # `seconds` field and a positive `nanos` field. Must be from 0
22930 # to 999,999,999 inclusive.
22931 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22932 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22933 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22934 },
22935 &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
22936 # to the matched service.
22937 #
22938 # urlRewrite is the only action supported in UrlMaps
22939 # for classic Application Load Balancers.
22940 #
22941 # Not supported when the URL map is bound to a target gRPC proxy that
22942 # has the validateForProxyless field set to true.
22943 # backend service.
22944 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
22945 # host header is replaced with contents of hostRewrite.
22946 #
22947 # The value must be from 1 to 255 characters.
22948 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
22949 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
22950 #
22951 # The value must be from 1 to 1024 characters.
22952 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
22953 # header) using the HTTP template syntax.
22954 #
22955 # A corresponding
22956 # path_template_match must be specified. Any template variables must exist in
22957 # the path_template_match field.
22958 #
22959 #
22960 # - -At least one variable must be specified in the path_template_match
22961 # field
22962 # - You can omit variables from the rewritten URL
22963 # - The * and ** operators cannot be matched
22964 # unless they have a corresponding variable name - e.g.
22965 # {format=*} or {var=**}.
22966 #
22967 # For example, a path_template_match of /static/{format=**}
22968 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
22969 # rewrite, so that /{country}/{format}/{suffix=**} can be
22970 # rewritten as /content/{format}/{country}/{suffix}.
22971 #
22972 # At least
22973 # one non-empty routeRules[].matchRules[].path_template_match is
22974 # required.
22975 #
22976 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
22977 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
22978 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
22979 # It uses RE2 syntax with the following constraints:
22980 #
22981 #
22982 # - Any single character operators
22983 # - Groups are allowed to have only submatch operator inside
22984 # - Groups are allowed only without any char repetition, e.g.
22985 # .*
22986 # - Any char repetition, e.g. .*, is
22987 # only allowed to be used in a single regex together with:
22988 #
22989 #
22990 # - Empty string operators
22991 # - Other repetitions
22992 # - Ranges
22993 # - Repetitions of ranges
22994 #
22995 #
22996 # - Ranges are only allowed to have:
22997 #
22998 #
22999 # - Character range
23000 # - Digits range
23001 # - Symbols listed in characters allowed for ranges
23002 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
23003 # the path.
23004 },
23005 },
23006 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
23007 # occurs. The weights determine the fraction of traffic that flows to
23008 # their corresponding backend service. If all traffic needs to
23009 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
23010 #
23011 # After a backend service is identified and before forwarding
23012 # the request to
23013 # the backend service, advanced routing actions such as URL rewrites and
23014 # header transformations are applied depending on additional settings
23015 # specified in this HttpRouteAction.
23016 { # In contrast to a single BackendService in
23017 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
23018 # multiple backend services. The volume of traffic for each
23019 # backend service is proportional to the weight specified
23020 # in each WeightedBackendService
23021 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
23022 # resource. Before
23023 # forwarding the request to backendService, the load balancer
23024 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
23025 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
23026 # effect for the selected backendService.
23027 #
23028 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
23029 #
23030 # headerAction is not supported for load balancers that have
23031 # their loadBalancingScheme set to EXTERNAL.
23032 #
23033 # Not supported when the URL map is bound to a target gRPC proxy that
23034 # has validateForProxyless field set to true.
23035 # the request is passed along to the selected backendService.
23036 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
23037 { # Specification determining how headers are added to requests or responses.
23038 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
23039 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
23040 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
23041 # that already
23042 # exist for the header. If true, headerValue is set for the
23043 # header, discarding any values that were set for that header.
23044 #
23045 # The default value is true,
23046 # unless a variable is present in headerValue,
23047 # in which case the default value is false.
23048 # .
23049 },
23050 ],
23051 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
23052 # request before forwarding the request to the backendService.
23053 &quot;A String&quot;,
23054 ],
23055 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
23056 # client.
23057 { # Specification determining how headers are added to requests or responses.
23058 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
23059 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
23060 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
23061 # that already
23062 # exist for the header. If true, headerValue is set for the
23063 # header, discarding any values that were set for that header.
23064 #
23065 # The default value is true,
23066 # unless a variable is present in headerValue,
23067 # in which case the default value is false.
23068 # .
23069 },
23070 ],
23071 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
23072 # response before sending the response back to the client.
23073 &quot;A String&quot;,
23074 ],
23075 },
23076 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
23077 # computed asweight / (sum of all weightedBackendService weights in routeAction).
23078 #
23079 # The selection of a backend service is determined only for new traffic.
23080 # Once a user&#x27;s request has been directed to a backend service,
23081 # subsequent requests are sent to the same backend service as
23082 # determined by the backend service&#x27;s session affinity policy.
23083 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
23084 # splitting. If you do, the weighted traffic splitting configuration takes
23085 # precedence.
23086 #
23087 # The value must be from 0 to 1000.
23088 },
23089 ],
23090 },
23091 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
23092 # is directed if this rule is matched. If routeAction is
23093 # also specified, advanced routing actions, such as URL rewrites,
23094 # take effect before sending the request to the backend.
23095 #
23096 #
23097 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
23098 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
23099 # specified by urlRedirect.
23100 #
23101 #
23102 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
23103 #
23104 #
23105 # Not supported when the URL map is bound to a target gRPC proxy.
23106 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
23107 # was supplied in the request.
23108 #
23109 # The value must be from 1 to 255
23110 # characters.
23111 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
23112 # set to HTTPS.
23113 # If set to false, the URL scheme of the redirected request
23114 # remains the same as that of the request.
23115 #
23116 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
23117 #
23118 # The default is set to false.
23119 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
23120 # that was supplied in the request.
23121 #
23122 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
23123 # supplied, the path of the original request is used for the redirect.
23124 #
23125 # The value must be from 1 to 1024 characters.
23126 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
23127 # the HttpRouteRuleMatch, retaining the remaining portion
23128 # of the URL before redirecting the request.
23129 #
23130 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
23131 # supplied, the path of the original request is used for the redirect.
23132 #
23133 # The value must be from 1 to 1024 characters.
23134 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
23135 #
23136 # Supported values are:
23137 #
23138 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
23139 # to 301.
23140 # - FOUND, which corresponds to 302.
23141 # - SEE_OTHER which corresponds to 303.
23142 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
23143 # method is retained.
23144 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
23145 # method is retained.
23146 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
23147 # URL is
23148 # removed before redirecting the request. If set to false, the
23149 # query portion of the original URL is retained.
23150 #
23151 # The default is set to false.
23152 },
23153 },
23154 ],
23155 &quot;routeRules&quot;: [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
23156 # desired. routeRules are evaluated in order of priority, from
23157 # the lowest to highest number.
23158 #
23159 # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
23160 { # The HttpRouteRule setting specifies how to match an HTTP request
23161 # and the corresponding routing action that load balancing proxies perform.
23162 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
23163 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
23164 #
23165 # If a policy for an
23166 # error code is not configured for the RouteRule, a policy for
23167 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
23168 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
23169 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
23170 # effect.
23171 #
23172 # For example, consider a UrlMap with the following configuration:
23173 #
23174 #
23175 # - UrlMap.defaultCustomErrorResponsePolicy are configured
23176 # with policies for 5xx and 4xx errors
23177 # - A RouteRule for /coming_soon/ is configured for the
23178 # error code 404.
23179 #
23180 # 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
23181 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
23182 # the policy in RouteRule.customErrorResponsePolicy takes
23183 # effect. If any of the requests in this example encounter a 500
23184 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
23185 #
23186 # When
23187 # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
23188 # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
23189 # a retry, if load balancer is successful in reaching the
23190 # service, the customErrorResponsePolicy is ignored and
23191 # the response from the service is returned to the client.
23192 #
23193 # customErrorResponsePolicy is supported only for
23194 # global external Application Load Balancers.
23195 # backend service or backend bucket responds with an error.
23196 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
23197 #
23198 # In a given policy, if you specify rules for both a range of error codes
23199 # as well as rules for specific error codes then rules with specific error
23200 # codes have a higher priority. For example, assume that you configure a rule
23201 # for 401 (Un-authorized) code, and another for all 4 series
23202 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
23203 # However if the backend service returns a 403, the rule for4xx takes effect.
23204 { # Specifies the mapping between the response code that will be returned along
23205 # with the custom error content and the response code returned by the backend
23206 # service.
23207 &quot;matchResponseCodes&quot;: [ # Valid values include:
23208 #
23209 #
23210 # - A number between 400 and 599: For example
23211 # 401 or 503, in which case the load balancer
23212 # applies the policy if the error code exactly matches this value.
23213 # - 5xx: Load Balancer will apply the policy if the
23214 # backend service responds with any response code in the range of
23215 # 500 to 599.
23216 # - 4xx: Load
23217 # Balancer will apply the policy if the backend service responds with any
23218 # response code in the range of 400 to
23219 # 499.
23220 #
23221 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
23222 &quot;A String&quot;,
23223 ],
23224 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
23225 # error content. If overrideResponseCode is not supplied, the
23226 # same response code returned by the original backend bucket or backend
23227 # service is returned to the client.
23228 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
23229 #
23230 # path must start
23231 # with a leading slash. path cannot have trailing slashes.
23232 #
23233 # If the file is not available in backendBucket or the
23234 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
23235 #
23236 # The value must
23237 # be from 1 to 1024 characters
23238 },
23239 ],
23240 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
23241 # contains the custom error content. Examples are:
23242 #
23243 #
23244 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
23245 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
23246 # - global/backendBuckets/myBackendBucket
23247 #
23248 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
23249 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
23250 #
23251 # If load balancer cannot reach
23252 # the backendBucket, a simple Not Found Error will
23253 # be returned, with the original response code (oroverrideResponseCode if configured).
23254 #
23255 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
23256 },
23257 &quot;description&quot;: &quot;A String&quot;, # The short description conveying the intent of this routeRule.
23258 #
23259 #
23260 # The description can have a maximum length of 1024 characters.
23261 &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
23262 # for the selected backendService.
23263 #
23264 # The headerAction value specified here is applied before the
23265 # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
23266 #
23267 # HeaderAction is not supported for load balancers
23268 # that have
23269 # their loadBalancingScheme set to EXTERNAL.
23270 #
23271 # Not supported when the URL map is bound to a target gRPC proxy that
23272 # has validateForProxyless field set to true.
23273 # the request is passed along to the selected backendService.
23274 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
23275 { # Specification determining how headers are added to requests or responses.
23276 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
23277 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
23278 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
23279 # that already
23280 # exist for the header. If true, headerValue is set for the
23281 # header, discarding any values that were set for that header.
23282 #
23283 # The default value is true,
23284 # unless a variable is present in headerValue,
23285 # in which case the default value is false.
23286 # .
23287 },
23288 ],
23289 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
23290 # request before forwarding the request to the backendService.
23291 &quot;A String&quot;,
23292 ],
23293 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
23294 # client.
23295 { # Specification determining how headers are added to requests or responses.
23296 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
23297 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
23298 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
23299 # that already
23300 # exist for the header. If true, headerValue is set for the
23301 # header, discarding any values that were set for that header.
23302 #
23303 # The default value is true,
23304 # unless a variable is present in headerValue,
23305 # in which case the default value is false.
23306 # .
23307 },
23308 ],
23309 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
23310 # response before sending the response back to the client.
23311 &quot;A String&quot;,
23312 ],
23313 },
23314 &quot;httpFilterConfigs&quot;: [ # Outbound route specific configuration fornetworkservices.HttpFilter resources enabled by Traffic
23315 # Director. httpFilterConfigs only applies for load balancers
23316 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
23317 # more details.
23318 #
23319 # Not supported when the URL map is bound to a target gRPC proxy that
23320 # has validateForProxyless field set to true.
23321 { # HttpFilterConfiguration supplies additional contextual settings
23322 # for networkservices.HttpFilter resources enabled by Traffic
23323 # Director.
23324 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
23325 # YAML formatted and only contain fields defined in the protobuf identified
23326 # in configTypeUrl
23327 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
23328 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
23329 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
23330 # configuration belongs to. This name must be known to the xDS client.
23331 # Example: envoy.wasm
23332 },
23333 ],
23334 &quot;httpFilterMetadata&quot;: [ # Outbound route specific metadata supplied tonetworkservices.HttpFilter resources enabled by Traffic
23335 # Director. httpFilterMetadata only applies for load balancers
23336 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
23337 # more details.
23338 #
23339 # The only configTypeUrl supported istype.googleapis.com/google.protobuf.Struct
23340 #
23341 # Not supported when the URL map is bound to a target gRPC proxy that
23342 # has validateForProxyless field set to true.
23343 { # HttpFilterConfiguration supplies additional contextual settings
23344 # for networkservices.HttpFilter resources enabled by Traffic
23345 # Director.
23346 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
23347 # YAML formatted and only contain fields defined in the protobuf identified
23348 # in configTypeUrl
23349 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
23350 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
23351 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
23352 # configuration belongs to. This name must be known to the xDS client.
23353 # Example: envoy.wasm
23354 },
23355 ],
23356 &quot;matchRules&quot;: [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
23357 # this routeRule when any of thematchRules are satisfied. However predicates within
23358 # a given matchRule have AND semantics. All predicates
23359 # within a matchRule must match for the request to
23360 # match the rule.
23361 { # HttpRouteRuleMatch specifies a set of criteria for matching
23362 # requests to an HttpRouteRule. All specified criteria must
23363 # be satisfied for a match to occur.
23364 &quot;fullPathMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
23365 # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
23366 # that may be part of the original URL.
23367 #
23368 # fullPathMatch must be from 1 to 1024 characters.
23369 #
23370 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
23371 # specified.
23372 &quot;headerMatches&quot;: [ # Specifies a list of header match criteria, all of which must match
23373 # corresponding headers in the request.
23374 { # matchRule criteria for request header matches.
23375 &quot;exactMatch&quot;: &quot;A String&quot;, # The value should exactly match contents of exactMatch.
23376 #
23377 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
23378 &quot;headerName&quot;: &quot;A String&quot;, # The name of the HTTP header to match.
23379 #
23380 # For matching against the HTTP request&#x27;s authority, use a headerMatch
23381 # with the header name &quot;:authority&quot;.
23382 #
23383 # For matching a request&#x27;s method, use the headerName &quot;:method&quot;.
23384 #
23385 # When the URL map is bound to a target gRPC proxy that has
23386 # the validateForProxyless field set to true, only
23387 # non-binary
23388 # user-specified custom metadata and the `content-type` header are supported.
23389 # The following transport-level headers cannot be used in header matching
23390 # rules:
23391 # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
23392 # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
23393 # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
23394 # `grpc-timeout` and `grpc-trace-bin`.
23395 &quot;invertMatch&quot;: True or False, # If set to false, the headerMatch is considered a
23396 # match if the preceding match criteria are met. If set to true,
23397 # the headerMatch is considered a match if the preceding
23398 # match criteria are NOT met.
23399 #
23400 # The default setting is false.
23401 &quot;prefixMatch&quot;: &quot;A String&quot;, # The value of the header must start with the contents ofprefixMatch.
23402 #
23403 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
23404 &quot;presentMatch&quot;: True or False, # A header with the contents of headerName must exist. The
23405 # match takes place whether or not the request&#x27;s header has a value.
23406 #
23407 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
23408 &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
23409 # specified in rangeMatch. If the header does not contain an
23410 # integer, number or is empty, the match fails.
23411 #
23412 # For example for a range [-5, 0]
23413 #
23414 #
23415 # - -3 will match.
23416 # - 0 will not match.
23417 # - 0.25 will not match.
23418 # - -3someString will not match.
23419 #
23420 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
23421 #
23422 # rangeMatch is not supported for load balancers
23423 # that have loadBalancingScheme set to EXTERNAL.
23424 # within the specified integer range.
23425 &quot;rangeEnd&quot;: &quot;A String&quot;, # The end of the range (exclusive) in signed long integer format.
23426 &quot;rangeStart&quot;: &quot;A String&quot;, # The start of the range (inclusive) in signed long integer format.
23427 },
23428 &quot;regexMatch&quot;: &quot;A String&quot;, # The value of the header must match the regular expression specified inregexMatch.
23429 # For more information about regular expression syntax, see Syntax.
23430 #
23431 # For matching against a port specified in the HTTP request, use a
23432 # headerMatch with headerName set to PORT and a regular expression that
23433 # satisfies the RFC2616 Host header&#x27;s port specifier.
23434 #
23435 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
23436 #
23437 # Regular expressions can only be used when the loadBalancingScheme is
23438 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
23439 # (regional scope) or INTERNAL_MANAGED.
23440 &quot;suffixMatch&quot;: &quot;A String&quot;, # The value of the header must end with the contents ofsuffixMatch.
23441 #
23442 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
23443 },
23444 ],
23445 &quot;ignoreCase&quot;: True or False, # Specifies that prefixMatch and fullPathMatch
23446 # matches are case sensitive.
23447 #
23448 # The default value is false.
23449 #
23450 # ignoreCase must not be used with regexMatch.
23451 #
23452 # Not supported when the URL map is bound to a target gRPC proxy.
23453 &quot;metadataFilters&quot;: [ # Opaque filter criteria used by the load balancer to restrict routing
23454 # configuration to a limited set of xDS
23455 # compliant clients. In their xDS requests to the load balancer, xDS clients
23456 # present node
23457 # metadata. When there is a match, the relevant routing configuration
23458 # is made available to those proxies.
23459 #
23460 # 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
23461 # the metadata. If its filterMatchCriteria is set to
23462 # MATCH_ALL, then all of its filterLabels must match with
23463 # corresponding labels provided in the metadata. If multiple
23464 # metadata filters are specified, all of them need to be
23465 # satisfied in order to be considered a match.
23466 #
23467 # metadataFilters specified here is applied after those
23468 # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
23469 #
23470 # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
23471 #
23472 # Not supported when the URL map is bound to a target gRPC proxy that
23473 # has validateForProxyless field set to true.
23474 { # Opaque filter criteria used by load balancers to restrict routing
23475 # configuration to a limited set of load balancing proxies. Proxies and
23476 # sidecars involved in load balancing would typically present metadata to the
23477 # load balancers that need to match criteria specified here. If a match takes
23478 # place, the relevant configuration is made available to those
23479 # proxies.
23480 #
23481 # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
23482 # one of thefilterLabels must match the corresponding label provided in
23483 # the metadata. If its filterMatchCriteria is set to
23484 # MATCH_ALL, then all of its filterLabels must match with
23485 # corresponding labels provided in the metadata.
23486 #
23487 # An example for using metadataFilters would be: if
23488 # load balancing involves
23489 # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in of their XDS requests to loadbalancers.
23490 &quot;filterLabels&quot;: [ # The list of label value pairs that must match labels in the provided
23491 # metadata based on filterMatchCriteria
23492 #
23493 # This list must not be empty and can have at the most 64 entries.
23494 { # MetadataFilter label name value pairs that are expected
23495 # to match corresponding labels presented as metadata to the load balancer.
23496 &quot;name&quot;: &quot;A String&quot;, # Name of metadata label.
23497 #
23498 # The name can have a maximum length of 1024 characters and must be at
23499 # least 1 character long.
23500 &quot;value&quot;: &quot;A String&quot;, # The value of the label must match the specified value.
23501 #
23502 # value can have a maximum length of 1024 characters.
23503 },
23504 ],
23505 &quot;filterMatchCriteria&quot;: &quot;A String&quot;, # Specifies how individual filter label matches
23506 # within the list of filterLabels and contributes toward the
23507 # overall metadataFilter match.
23508 #
23509 # Supported values are:
23510 #
23511 # - MATCH_ANY: at least one of the filterLabels
23512 # must have a matching label in the provided metadata.
23513 # - MATCH_ALL: all filterLabels must have
23514 # matching labels in the provided metadata.
23515 },
23516 ],
23517 &quot;pathTemplateMatch&quot;: &quot;A String&quot;, # If specified, this field defines a path template pattern that must match
23518 # the :path header after the query string is removed.
23519 #
23520 # A path template pattern can include variables and wildcards.
23521 # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
23522 # matches a single path segment, and ** that matches zero or
23523 # more path segments. The pattern must follow these rules:
23524 #
23525 #
23526 # - The value must be between 1 and 1024 characters.
23527 # - The pattern must start with a leading slash (&quot;/&quot;).
23528 # - No more than 5 operators (variables or wildcards) may appear in
23529 # the pattern.
23530 #
23531 # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
23532 # set.
23533 &quot;prefixMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the request&#x27;s
23534 # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
23535 #
23536 # The value must be from 1 to 1024 characters.
23537 #
23538 # The * character inside a prefix match is
23539 # treated as a literal character, not as a wildcard.
23540 #
23541 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
23542 # used within a matchRule.
23543 &quot;queryParameterMatches&quot;: [ # Specifies a list of query parameter match criteria, all of which must
23544 # match corresponding query parameters in the request.
23545 #
23546 # Not supported when the URL map is bound to a target gRPC proxy.
23547 { # HttpRouteRuleMatch criteria for a request&#x27;s query parameter.
23548 &quot;exactMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
23549 # parameter exactly matches the contents of exactMatch.
23550 #
23551 # Only one of presentMatch, exactMatch, orregexMatch must be set.
23552 &quot;name&quot;: &quot;A String&quot;, # The name of the query parameter to match. The query parameter must exist in
23553 # the request, in the absence of which the request match fails.
23554 &quot;presentMatch&quot;: True or False, # Specifies that the queryParameterMatch matches if the
23555 # request contains the query parameter, irrespective of whether the
23556 # parameter has a value or not.
23557 #
23558 # Only one of presentMatch, exactMatch, orregexMatch must be set.
23559 &quot;regexMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
23560 # parameter matches the regular expression specified byregexMatch. For
23561 # more information about regular expression syntax, see Syntax.
23562 #
23563 # Only one of presentMatch, exactMatch, orregexMatch must be set.
23564 #
23565 # Regular expressions can only be used when the loadBalancingScheme is
23566 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
23567 # (regional scope) or INTERNAL_MANAGED.
23568 },
23569 ],
23570 &quot;regexMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
23571 # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
23572 # supplied with the original URL. For
23573 # more information about regular expression syntax, see Syntax.
23574 #
23575 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
23576 # specified.
23577 #
23578 # Regular expressions can only be used when the loadBalancingScheme is
23579 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
23580 # (regional scope) or INTERNAL_MANAGED.
23581 },
23582 ],
23583 &quot;priority&quot;: 42, # For routeRules within a given pathMatcher,
23584 # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
23585 # of priority, from the lowest to highest number. The priority of a
23586 # rule decreases as its number increases (1, 2, 3, N+1). The first rule
23587 # that matches the request is applied.
23588 #
23589 #
23590 # You cannot configure two or more routeRules with the same priority.
23591 # Priority for each rule must be set to a number from 0 to 2147483647
23592 # inclusive.
23593 #
23594 #
23595 # Priority numbers can have gaps, which enable you to add or remove rules
23596 # in the future without affecting the rest of the rules. For example, 1, 2,
23597 # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
23598 # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
23599 # without any impact on existing rules.
23600 &quot;routeAction&quot;: { # In response to a matching matchRule, the load balancer
23601 # performs advanced routing actions, such as URL rewrites and header
23602 # transformations, before forwarding the request to the selected backend.
23603 #
23604 #
23605 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
23606 #
23607 #
23608 # URL maps for classic Application Load Balancers only support
23609 # the urlRewrite action within a route rule&#x27;srouteAction.
23610 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
23611 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
23612 # property must be specified. This policy cannot be specified if any target
23613 # backend has Identity-Aware Proxy enabled.
23614 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
23615 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
23616 # header names can be specified. The cache is bypassed for all `cacheMode`
23617 # values.
23618 &quot;A String&quot;,
23619 ],
23620 &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
23621 # on the backend type: for Backend Services, the complete request URI is
23622 # used; for Backend Buckets, the request URI is used without the protocol or
23623 # host, and only query parameters known to Cloud Storage are included.
23624 # Policy defined on Route Action.
23625 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
23626 # parameters will be included. Either specify `excludedQueryParameters`
23627 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
23628 # encoded and not treated as delimiters.
23629 #
23630 # Note: This field applies to routes that use backend services. Attempting
23631 # to set it on a route that points exclusively to Backend Buckets will
23632 # result in a configuration error. For routes that point to a Backend
23633 # Bucket, use `includedQueryParameters` to define which parameters should
23634 # be part of the cache key.
23635 &quot;A String&quot;,
23636 ],
23637 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
23638 #
23639 # Note: This setting is only applicable to routes that use a Backend
23640 # Service. It does not affect requests served by a Backend Bucket, as the
23641 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
23642 # it on a route that points exclusively to Backend Buckets will result in a
23643 # configuration error.
23644 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
23645 #
23646 # Note: This setting is only applicable to routes that use a Backend
23647 # Service. It does not affect requests served by a Backend Bucket, as the
23648 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
23649 # set on a route that points exclusively to Backend Buckets will result in
23650 # a configuration error.
23651 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
23652 # `includedQueryParameters` and `excludedQueryParameters`. If neither
23653 # is set, the entire query string will be included. If false, the query
23654 # string will be excluded from the cache key entirely.
23655 #
23656 # Note: This field applies to routes that use backend services. Attempting
23657 # to set it on a route that points exclusively to Backend Buckets will
23658 # result in a configuration error. For routes that point to a Backend
23659 # Bucket, use `includedQueryParameters` to define which parameters should
23660 # be part of the cache key.
23661 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
23662 # The name=value pair will be used in the cache key Cloud CDN generates.
23663 #
23664 # Note: This setting is only applicable to routes that use a Backend
23665 # Service. It does not affect requests served by a Backend Bucket.
23666 # Attempting to set it on a route that points exclusively to Backend
23667 # Buckets will result in a configuration error. Up to 5 cookie names can be
23668 # specified.
23669 &quot;A String&quot;,
23670 ],
23671 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
23672 &quot;A String&quot;,
23673 ],
23674 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
23675 # parameters will be excluded. Either specify `includedQueryParameters`
23676 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
23677 # encoded and not treated as delimiters.
23678 &quot;A String&quot;,
23679 ],
23680 },
23681 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
23682 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
23683 &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
23684 # content. This is used to clamp the max-age (or Expires) value sent to the
23685 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
23686 # is used for the response max-age directive, along with a &quot;public&quot;
23687 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
23688 # clamps the max-age from the origin (if specified), or else sets the
23689 # response max-age directive to the lesser of the `clientTtl` and
23690 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
23691 # present. The maximum allowed value is 31,622,400s (1 year). If not
23692 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
23693 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
23694 # `USE_ORIGIN_HEADERS`.
23695 # as a count of seconds and fractions of seconds at nanosecond
23696 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
23697 # or &quot;month&quot;. Range is approximately 10,000 years.
23698 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
23699 # Durations less than one second are represented with a 0
23700 # `seconds` field and a positive `nanos` field. Must be from 0
23701 # to 999,999,999 inclusive.
23702 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
23703 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
23704 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
23705 },
23706 &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
23707 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
23708 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
23709 # greater than that of `maxTtl`. When the `cacheMode` is set to
23710 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
23711 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
23712 # accessed objects may be evicted from the cache before the defined TTL. If
23713 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
23714 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
23715 # `USE_ORIGIN_HEADERS`.
23716 # as a count of seconds and fractions of seconds at nanosecond
23717 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
23718 # or &quot;month&quot;. Range is approximately 10,000 years.
23719 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
23720 # Durations less than one second are represented with a 0
23721 # `seconds` field and a positive `nanos` field. Must be from 0
23722 # to 999,999,999 inclusive.
23723 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
23724 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
23725 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
23726 },
23727 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
23728 # attempt to set a max-age or s-maxage higher than this, or an Expires header
23729 # more than `maxTtl` seconds in the future will be capped at the value of
23730 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
23731 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
23732 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
23733 # Infrequently accessed objects may be evicted from the cache before the
23734 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
23735 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
23736 # mode.
23737 # as a count of seconds and fractions of seconds at nanosecond
23738 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
23739 # or &quot;month&quot;. Range is approximately 10,000 years.
23740 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
23741 # Durations less than one second are represented with a 0
23742 # `seconds` field and a positive `nanos` field. Must be from 0
23743 # to 999,999,999 inclusive.
23744 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
23745 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
23746 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
23747 },
23748 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
23749 # to apply fine-grained caching for common errors or redirects.
23750 # This can reduce the load on your origin and improve end-user
23751 # experience by reducing response latency.
23752 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
23753 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
23754 # the specified response code that lack any Cache-Control, Expires, or
23755 # Pragma: no-cache directives. When the `cacheMode` is set to
23756 # `FORCE_CACHE_ALL`, negative caching applies to all responses
23757 # with the specified response code, and overrides any caching headers. By
23758 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
23759 #
23760 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
23761 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
23762 # * 405 (Method Not Found), 501 (Not Implemented): 60s
23763 #
23764 # These defaults can be overridden in `negativeCachingPolicy`.
23765 # If not specified, Cloud CDN applies negative caching by default.
23766 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
23767 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
23768 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
23769 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
23770 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
23771 # all response codes that you wish to cache. Cloud CDN will not apply any
23772 # default negative caching when a policy exists.
23773 { # Specify CDN TTLs for response error codes.
23774 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
23775 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
23776 # specified as values, and you cannot specify a status code more than
23777 # once.
23778 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
23779 # corresponding status code.
23780 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
23781 # objects may be evicted from the cache before the defined TTL.
23782 # as a count of seconds and fractions of seconds at nanosecond
23783 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
23784 # or &quot;month&quot;. Range is approximately 10,000 years.
23785 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
23786 # Durations less than one second are represented with a 0
23787 # `seconds` field and a positive `nanos` field. Must be from 0
23788 # to 999,999,999 inclusive.
23789 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
23790 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
23791 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
23792 },
23793 },
23794 ],
23795 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
23796 # requests into a small number of requests to the origin. If not specified,
23797 # Cloud CDN applies request coalescing by default.
23798 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
23799 # content with the origin, or when an error is encountered when refreshing
23800 # the cache.
23801 # This setting defines the default &quot;max-stale&quot; duration for any cached
23802 # responses that do not specify a max-stale directive. Stale responses that
23803 # exceed the TTL configured here will not be served. The default limit
23804 # (max-stale) is 86400s (1 day), which will allow stale content to be
23805 # served up to this limit beyond the max-age (or s-maxage) of a cached
23806 # response.
23807 # The maximum allowed value is 604800 (1 week).
23808 # Set this to zero (0) to disable serve-while-stale.
23809 # as a count of seconds and fractions of seconds at nanosecond
23810 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
23811 # or &quot;month&quot;. Range is approximately 10,000 years.
23812 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
23813 # Durations less than one second are represented with a 0
23814 # `seconds` field and a positive `nanos` field. Must be from 0
23815 # to 999,999,999 inclusive.
23816 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
23817 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
23818 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
23819 },
23820 },
23821 &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
23822 # information about the W3C recommendation for cross-origin resource sharing
23823 # (CORS), see Fetch API Living
23824 # Standard.
23825 #
23826 # Not supported when the URL map is bound to a target gRPC proxy.
23827 # information about the W3C recommendation for cross-origin resource sharing
23828 # (CORS), see Fetch API Living
23829 # Standard.
23830 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
23831 # indicates that
23832 # the actual request can include user credentials. This field translates to
23833 # the Access-Control-Allow-Credentials header.
23834 #
23835 # Default is false.
23836 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
23837 # header.
23838 &quot;A String&quot;,
23839 ],
23840 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
23841 # header.
23842 &quot;A String&quot;,
23843 ],
23844 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
23845 # more information, see regular expression syntax.
23846 #
23847 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
23848 #
23849 # Regular expressions can only be used when the loadBalancingScheme is
23850 # set to INTERNAL_SELF_MANAGED.
23851 &quot;A String&quot;,
23852 ],
23853 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
23854 #
23855 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
23856 &quot;A String&quot;,
23857 ],
23858 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
23859 # The default value is false, which indicates that the CORS
23860 # policy is in effect.
23861 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
23862 # header.
23863 &quot;A String&quot;,
23864 ],
23865 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
23866 # seconds. This field translates to the Access-Control-Max-Age
23867 # header.
23868 },
23869 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
23870 # the resiliency of clients to backend service failure. As part of fault
23871 # injection, when clients send requests to a backend service, delays can be
23872 # introduced by a load balancer on a percentage of requests before sending
23873 # those requests to the backend service. Similarly requests from clients can
23874 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
23875 # that are configured with a fault_injection_policy if:
23876 # 1. The traffic is generated by fault injection AND
23877 # 2. The fault injection is not a delay fault injection.
23878 # Fault injection is not supported with the classic Application Load Balancer
23879 # . To see which load balancers support fault injection,
23880 # see Load
23881 # balancing: Routing and traffic management features.
23882 # the resiliency of clients to backend service failure. As part of fault
23883 # injection, when clients send requests to a backend service, delays can be
23884 # introduced by the load balancer on a percentage of requests before sending
23885 # those request to the backend service. Similarly requests from clients can be
23886 # aborted by the load balancer for a percentage of requests.
23887 &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
23888 # injection.
23889 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
23890 #
23891 # The value must be from 200 to 599 inclusive.
23892 #
23893 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
23894 # according to this
23895 # mapping table. HTTP status 200 is mapped to gRPC status
23896 # UNKNOWN. Injecting an OK status is currently not supported by
23897 # Traffic Director.
23898 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
23899 # that is aborted as part of fault injection.
23900 #
23901 # The value must be from 0.0 to 100.0 inclusive.
23902 },
23903 &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
23904 # injection, before being sent to a backend service.
23905 # request to the backend service as part of fault injection.
23906 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
23907 # as a count of seconds and fractions of seconds at nanosecond
23908 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
23909 # or &quot;month&quot;. Range is approximately 10,000 years.
23910 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
23911 # Durations less than one second are represented with a 0
23912 # `seconds` field and a positive `nanos` field. Must be from 0
23913 # to 999,999,999 inclusive.
23914 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
23915 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
23916 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
23917 },
23918 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
23919 # which a delay is introduced as part of fault injection.
23920 #
23921 # The value must be from 0.0 to 100.0 inclusive.
23922 },
23923 },
23924 &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
23925 # Global EXTERNAL_MANAGED load balancer schemes.
23926 # Either Cloud CDN must be enabled on the backend service or backend bucket
23927 # serving the route, or cache policy must be configured on the same route
23928 # dynamically processes and delivers images from the network edge.
23929 # Image Optimization is only available for Global External Application Load
23930 # Balancers.
23931 # Either Cloud CDN must be enabled on the backend service or backend bucket
23932 # serving the route, or cache policy must be configured on the same route.
23933 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
23934 },
23935 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
23936 # Unlike the timeout field where the timeout duration starts
23937 # from the time the request has been fully processed (known as*end-of-stream*),
23938 # the duration in this field is computed from the beginning of the stream
23939 # until the response has been processed, including all retries. A
23940 # stream that does not complete in this duration is closed.
23941 #
23942 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
23943 # with the route.
23944 #
23945 # This field is only allowed if the Url map is used with backend services
23946 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
23947 # as a count of seconds and fractions of seconds at nanosecond
23948 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
23949 # or &quot;month&quot;. Range is approximately 10,000 years.
23950 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
23951 # Durations less than one second are represented with a 0
23952 # `seconds` field and a positive `nanos` field. Must be from 0
23953 # to 999,999,999 inclusive.
23954 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
23955 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
23956 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
23957 },
23958 &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
23959 # are shadowed to a separate mirrored backend service. The load balancer does
23960 # not wait for responses from the shadow service. Before sending traffic
23961 # to the shadow service, the host / authority header is suffixed with-shadow.
23962 #
23963 # Not supported when the URL map is bound to a target gRPC proxy that
23964 # has the validateForProxyless field set to true.
23965 # are shadowed to a separate mirrored backend service. The load balancer
23966 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
23967 # to the shadow service, the host or authority header is suffixed with-shadow.
23968 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
23969 # mirrored to.
23970 #
23971 # The backend service configured for a mirroring
23972 # policy must reference backends that are of the same type as the original
23973 # backend service matched in the URL map.
23974 #
23975 # Serverless NEG backends are not currently supported as a mirrored
23976 # backend service.
23977 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
23978 },
23979 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
23980 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
23981 # If not specified, defaults to 1.
23982 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
23983 #
23984 # If not specified, will use the timeout set in theHttpRouteAction field.
23985 # If timeout in the HttpRouteAction field is not set, this field
23986 # uses the largest timeout
23987 # among all backend services associated with the route.
23988 #
23989 # Not supported when the URL map is bound to a target gRPC proxy that
23990 # has the validateForProxyless field set to true.
23991 # as a count of seconds and fractions of seconds at nanosecond
23992 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
23993 # or &quot;month&quot;. Range is approximately 10,000 years.
23994 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
23995 # Durations less than one second are represented with a 0
23996 # `seconds` field and a positive `nanos` field. Must be from 0
23997 # to 999,999,999 inclusive.
23998 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
23999 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
24000 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
24001 },
24002 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
24003 # values are:
24004 #
24005 # - 5xx: retry is attempted if the instance or endpoint
24006 # responds with any 5xx response code, or if the instance or
24007 # endpoint does not respond at all. For example, disconnects, reset, read
24008 # timeout, connection failure, and refused streams.
24009 # - gateway-error: Similar to 5xx, but only
24010 # applies to response codes 502, 503 or504.
24011 # - connect-failure: a retry is attempted on failures
24012 # connecting to the instance or endpoint. For example, connection
24013 # timeouts.
24014 # - retriable-4xx: a retry is attempted if the instance
24015 # or endpoint responds with a 4xx response code.
24016 # The only error that you can retry is error code 409.
24017 # - refused-stream: a retry is attempted if the instance
24018 # or endpoint resets the stream with a REFUSED_STREAM error
24019 # code. This reset type indicates that it is safe to retry.
24020 # - cancelled: a retry is attempted if the gRPC status
24021 # code in the response header is set to cancelled.
24022 # - deadline-exceeded: a retry is attempted if the gRPC
24023 # status code in the response header is set todeadline-exceeded.
24024 # - internal: a retry is attempted if the gRPC
24025 # status code in the response header is set tointernal.
24026 # - resource-exhausted: a retry is attempted if the gRPC
24027 # status code in the response header is set toresource-exhausted.
24028 # - unavailable: a retry is attempted if the gRPC
24029 # status code in the response header is set tounavailable.
24030 #
24031 # Only the following codes are supported when the URL map is bound to
24032 # target gRPC proxy that has validateForProxyless field set to true.
24033 #
24034 # - cancelled
24035 # - deadline-exceeded
24036 # - internal
24037 # - resource-exhausted
24038 # - unavailable
24039 &quot;A String&quot;,
24040 ],
24041 },
24042 &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
24043 # time the request has been fully processed (known as *end-of-stream*)
24044 # up until the response has been processed. Timeout includes
24045 # all retries.
24046 #
24047 # If not specified, this field uses the largest timeout among all backend
24048 # services associated with the route.
24049 #
24050 # Not supported when the URL map is bound to a target gRPC proxy that
24051 # has validateForProxyless field set to true.
24052 # as a count of seconds and fractions of seconds at nanosecond
24053 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
24054 # or &quot;month&quot;. Range is approximately 10,000 years.
24055 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
24056 # Durations less than one second are represented with a 0
24057 # `seconds` field and a positive `nanos` field. Must be from 0
24058 # to 999,999,999 inclusive.
24059 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
24060 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
24061 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
24062 },
24063 &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
24064 # to the matched service.
24065 #
24066 # urlRewrite is the only action supported in UrlMaps
24067 # for classic Application Load Balancers.
24068 #
24069 # Not supported when the URL map is bound to a target gRPC proxy that
24070 # has the validateForProxyless field set to true.
24071 # backend service.
24072 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
24073 # host header is replaced with contents of hostRewrite.
24074 #
24075 # The value must be from 1 to 255 characters.
24076 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
24077 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
24078 #
24079 # The value must be from 1 to 1024 characters.
24080 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
24081 # header) using the HTTP template syntax.
24082 #
24083 # A corresponding
24084 # path_template_match must be specified. Any template variables must exist in
24085 # the path_template_match field.
24086 #
24087 #
24088 # - -At least one variable must be specified in the path_template_match
24089 # field
24090 # - You can omit variables from the rewritten URL
24091 # - The * and ** operators cannot be matched
24092 # unless they have a corresponding variable name - e.g.
24093 # {format=*} or {var=**}.
24094 #
24095 # For example, a path_template_match of /static/{format=**}
24096 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
24097 # rewrite, so that /{country}/{format}/{suffix=**} can be
24098 # rewritten as /content/{format}/{country}/{suffix}.
24099 #
24100 # At least
24101 # one non-empty routeRules[].matchRules[].path_template_match is
24102 # required.
24103 #
24104 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
24105 &quot;regexRewrite&quot;: { # The spec for modifying the path using a regular expression. # The regex rewrite to be applied to the URL. Only one ofpathPrefixRewrite, pathTemplateRewrite, orregexRewrite may be specified.
24106 &quot;pathPattern&quot;: &quot;A String&quot;, # The regular expression used to match against the URL path.
24107 # It uses RE2 syntax with the following constraints:
24108 #
24109 #
24110 # - Any single character operators
24111 # - Groups are allowed to have only submatch operator inside
24112 # - Groups are allowed only without any char repetition, e.g.
24113 # .*
24114 # - Any char repetition, e.g. .*, is
24115 # only allowed to be used in a single regex together with:
24116 #
24117 #
24118 # - Empty string operators
24119 # - Other repetitions
24120 # - Ranges
24121 # - Repetitions of ranges
24122 #
24123 #
24124 # - Ranges are only allowed to have:
24125 #
24126 #
24127 # - Character range
24128 # - Digits range
24129 # - Symbols listed in characters allowed for ranges
24130 &quot;pathSubstitution&quot;: &quot;A String&quot;, # Required when path pattern is specified. Used to rewrite matching parts of
24131 # the path.
24132 },
24133 },
24134 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
24135 # occurs. The weights determine the fraction of traffic that flows to
24136 # their corresponding backend service. If all traffic needs to
24137 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
24138 #
24139 # After a backend service is identified and before forwarding
24140 # the request to
24141 # the backend service, advanced routing actions such as URL rewrites and
24142 # header transformations are applied depending on additional settings
24143 # specified in this HttpRouteAction.
24144 { # In contrast to a single BackendService in
24145 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
24146 # multiple backend services. The volume of traffic for each
24147 # backend service is proportional to the weight specified
24148 # in each WeightedBackendService
24149 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
24150 # resource. Before
24151 # forwarding the request to backendService, the load balancer
24152 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
24153 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
24154 # effect for the selected backendService.
24155 #
24156 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
24157 #
24158 # headerAction is not supported for load balancers that have
24159 # their loadBalancingScheme set to EXTERNAL.
24160 #
24161 # Not supported when the URL map is bound to a target gRPC proxy that
24162 # has validateForProxyless field set to true.
24163 # the request is passed along to the selected backendService.
24164 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
24165 { # Specification determining how headers are added to requests or responses.
24166 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
24167 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
24168 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
24169 # that already
24170 # exist for the header. If true, headerValue is set for the
24171 # header, discarding any values that were set for that header.
24172 #
24173 # The default value is true,
24174 # unless a variable is present in headerValue,
24175 # in which case the default value is false.
24176 # .
24177 },
24178 ],
24179 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
24180 # request before forwarding the request to the backendService.
24181 &quot;A String&quot;,
24182 ],
24183 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
24184 # client.
24185 { # Specification determining how headers are added to requests or responses.
24186 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
24187 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
24188 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
24189 # that already
24190 # exist for the header. If true, headerValue is set for the
24191 # header, discarding any values that were set for that header.
24192 #
24193 # The default value is true,
24194 # unless a variable is present in headerValue,
24195 # in which case the default value is false.
24196 # .
24197 },
24198 ],
24199 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
24200 # response before sending the response back to the client.
24201 &quot;A String&quot;,
24202 ],
24203 },
24204 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
24205 # computed asweight / (sum of all weightedBackendService weights in routeAction).
24206 #
24207 # The selection of a backend service is determined only for new traffic.
24208 # Once a user&#x27;s request has been directed to a backend service,
24209 # subsequent requests are sent to the same backend service as
24210 # determined by the backend service&#x27;s session affinity policy.
24211 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
24212 # splitting. If you do, the weighted traffic splitting configuration takes
24213 # precedence.
24214 #
24215 # The value must be from 0 to 1000.
24216 },
24217 ],
24218 },
24219 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
24220 # is directed if this rule is matched. If routeAction is
24221 # also specified, advanced routing actions, such as URL rewrites,
24222 # take effect before sending the request to the backend.
24223 #
24224 #
24225 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
24226 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
24227 # specified by urlRedirect.
24228 #
24229 #
24230 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
24231 #
24232 #
24233 # Not supported when the URL map is bound to a target gRPC proxy.
24234 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
24235 # was supplied in the request.
24236 #
24237 # The value must be from 1 to 255
24238 # characters.
24239 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
24240 # set to HTTPS.
24241 # If set to false, the URL scheme of the redirected request
24242 # remains the same as that of the request.
24243 #
24244 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
24245 #
24246 # The default is set to false.
24247 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
24248 # that was supplied in the request.
24249 #
24250 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
24251 # supplied, the path of the original request is used for the redirect.
24252 #
24253 # The value must be from 1 to 1024 characters.
24254 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
24255 # the HttpRouteRuleMatch, retaining the remaining portion
24256 # of the URL before redirecting the request.
24257 #
24258 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
24259 # supplied, the path of the original request is used for the redirect.
24260 #
24261 # The value must be from 1 to 1024 characters.
24262 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
24263 #
24264 # Supported values are:
24265 #
24266 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
24267 # to 301.
24268 # - FOUND, which corresponds to 302.
24269 # - SEE_OTHER which corresponds to 303.
24270 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
24271 # method is retained.
24272 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
24273 # method is retained.
24274 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
24275 # URL is
24276 # removed before redirecting the request. If set to false, the
24277 # query portion of the original URL is retained.
24278 #
24279 # The default is set to false.
24280 },
24281 },
24282 ],
24283 },
24284 ],
24285 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the regional URL map resides.
24286 # This field is not applicable to global URL maps.
24287 # You must specify this field as part of the HTTP request URL. It is
24288 # not settable as a field in the request body.
24289 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
24290 &quot;status&quot;: { # [Output Only] The status of the URL map. # Output only. [Output Only] The status of the URL map.
24291 &quot;quotaUsage&quot;: { # Message representing the quota usage for a UrlMap. # Output only. Summary of quota usage for given UrlMap.
24292 &quot;forwardingRules&quot;: 42, # Output only. The number of forwarding rules that uses this UrlMap.
24293 &quot;units&quot;: &quot;A String&quot;, # Output only. The number of quota units calculated for this UrlMap.
24294 },
24295 },
24296 &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
24297 # maximum of 100 tests per UrlMap.
24298 #
24299 # Not supported when the URL map is bound to a target gRPC proxy that
24300 # has validateForProxyless field set to true.
24301 { # Message for the expected URL mappings.
24302 &quot;backendServiceWeight&quot;: 42, # The weight to use for the supplied host and path when using advanced
24303 # routing rules that involve traffic splitting.
24304 &quot;description&quot;: &quot;A String&quot;, # Description of this test case.
24305 &quot;expectedOutputUrl&quot;: &quot;A String&quot;, # The expected output URL evaluated by the load balancer
24306 # containing the scheme, host, path and query parameters.
24307 #
24308 # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
24309 # the load balancer to backends. For rules with urlRewrite,
24310 # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
24311 #
24312 # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer&#x27;s
24313 # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
24314 # If urlRedirect specifies strip_query, the test
24315 # passes only if expectedOutputUrl does not contain any query
24316 # parameters.
24317 #
24318 # expectedOutputUrl is optional whenservice is specified.
24319 &quot;expectedRedirectResponseCode&quot;: 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
24320 # load balancer&#x27;s redirect response.
24321 #
24322 # expectedRedirectResponseCode cannot be set whenservice is set.
24323 &quot;expectedUrlRedirect&quot;: &quot;A String&quot;, # The expected URL that should be redirected to for the host and path
24324 # being tested.
24325 # [Deprecated] This field is deprecated.
24326 # Use expected_output_url instead.
24327 &quot;headers&quot;: [ # HTTP headers for this request. If headers contains
24328 # a host header, then host must also match the header value.
24329 { # HTTP headers used in UrlMapTests.
24330 &quot;name&quot;: &quot;A String&quot;, # Header name.
24331 &quot;value&quot;: &quot;A String&quot;, # Header value.
24332 },
24333 ],
24334 &quot;host&quot;: &quot;A String&quot;, # Host portion of the URL. If headers contains a host header,
24335 # then host must also match the header value.
24336 &quot;path&quot;: &quot;A String&quot;, # Path portion of the URL.
24337 &quot;service&quot;: &quot;A String&quot;, # Expected BackendService or BackendBucket resource
24338 # the given URL should be mapped to.
24339 #
24340 # The service field cannot
24341 # be set if expectedRedirectResponseCode is set.
24342 },
24343 ],
24344 },
24345 }
24346
24347 x__xgafv: string, V1 error format.
24348 Allowed values
24349 1 - v1 error format
24350 2 - v2 error format
24351
24352 Returns:
24353 An object of the form:
24354
24355 {
24356 &quot;result&quot;: { # Message representing the validation result for a UrlMap.
24357 &quot;loadErrors&quot;: [
24358 &quot;A String&quot;,
24359 ],
24360 &quot;loadSucceeded&quot;: True or False, # Whether the given UrlMap can be successfully loaded.
24361 # If false, &#x27;loadErrors&#x27; indicates the reasons.
24362 &quot;quotaUsage&quot;: { # Message representing the quota usage for a UrlMap. # Output only. Summary of quota usage for given UrlMap.
24363 &quot;forwardingRules&quot;: 42, # Output only. The number of forwarding rules that uses this UrlMap.
24364 &quot;units&quot;: &quot;A String&quot;, # Output only. The number of quota units calculated for this UrlMap.
24365 },
24366 &quot;testFailures&quot;: [
24367 {
24368 &quot;actualOutputUrl&quot;: &quot;A String&quot;, # The actual output URL evaluated by a load balancer containing the scheme,
24369 # host, path and query parameters.
24370 &quot;actualRedirectResponseCode&quot;: 42, # Actual HTTP status code for rule with `urlRedirect`
24371 # calculated by load balancer
24372 &quot;actualService&quot;: &quot;A String&quot;, # BackendService or BackendBucket returned by load
24373 # balancer.
24374 &quot;expectedOutputUrl&quot;: &quot;A String&quot;, # The expected output URL evaluated by a load balancer containing the scheme,
24375 # host, path and query parameters.
24376 &quot;expectedRedirectResponseCode&quot;: 42, # Expected HTTP status code for rule with `urlRedirect`
24377 # calculated by load balancer
24378 &quot;expectedService&quot;: &quot;A String&quot;, # Expected BackendService or BackendBucket resource
24379 # the given URL should be mapped to.
24380 &quot;headers&quot;: [ # HTTP headers of the request.
24381 { # HTTP headers used in UrlMapTests.
24382 &quot;name&quot;: &quot;A String&quot;, # Header name.
24383 &quot;value&quot;: &quot;A String&quot;, # Header value.
24384 },
24385 ],
24386 &quot;host&quot;: &quot;A String&quot;, # Host portion of the URL.
24387 &quot;path&quot;: &quot;A String&quot;, # Path portion including query parameters in the URL.
24388 },
24389 ],
24390 &quot;testPassed&quot;: True or False, # If successfully loaded, this field indicates whether the test passed.
24391 # If false, &#x27;testFailures&#x27;s indicate the reason of failure.
24392 },
24393 }</pre>
24394 </div>
24395
24396 </body></html>