Debian Codegraph @

docs/dyn/compute_beta.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_beta.html">Compute Engine API</a> . <a href="compute_beta.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/beta/globalOperations)
139 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
140 # * [Zonal](/compute/docs/reference/rest/beta/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;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
319 # this field will contain information on all underlying zonal actions and
320 # their state.
321 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
322 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
323 # Example key: zones/us-central1-a
324 &quot;a_key&quot;: {
325 &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
326 # populated.
327 # different programming environments, including REST APIs and RPC APIs. It is
328 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
329 # three pieces of data: error code, error message, and error details.
330 #
331 # You can find out more about this error model and how to work with it in the
332 # [API Design Guide](https://cloud.google.com/apis/design/errors).
333 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
334 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
335 # message types for APIs to use.
336 {
337 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
338 },
339 ],
340 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
341 # user-facing error message should be localized and sent in the
342 # google.rpc.Status.details field, or localized by the client.
343 },
344 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
345 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
346 },
347 },
348 },
349 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
350 # This value is inRFC3339
351 # text format.
352 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
353 # following:
354 # `PENDING`, `RUNNING`, or `DONE`.
355 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
356 # operation.
357 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
358 # of the target resource.
359 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
360 # operations related to creating a snapshot, this points to the disk
361 # that the snapshot was created from.
362 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
363 # `[email protected]` or
364 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
365 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
366 # operation, this field will be populated.
367 {
368 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
369 # Engine returns NO_RESULTS_ON_PAGE if there
370 # are no results in the response.
371 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
372 # value format. For example:
373 #
374 # &quot;data&quot;: [
375 # {
376 # &quot;key&quot;: &quot;scope&quot;,
377 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
378 # }
379 {
380 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
381 # returned. For example, for warnings where there are no results in a list
382 # request for a particular zone, this key might be scope and
383 # the key value might be the zone name. Other examples might be a key
384 # indicating a deprecated resource and a suggested replacement, or a
385 # warning about invalid network settings (for example, if an instance
386 # attempts to perform IP forwarding but is not enabled for IP forwarding).
387 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
388 },
389 ],
390 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
391 },
392 ],
393 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
394 # applicable when performing per-zone operations.
395 }</pre>
396 </div>
397
398 <div class="method">
399 <code class="details" id="get">get(project, region, urlMap, x__xgafv=None)</code>
400 <pre>Returns the specified UrlMap resource.
401
402 Args:
403 project: string, Project ID for this request. (required)
404 region: string, Name of the region scoping this request. (required)
405 urlMap: string, Name of the UrlMap resource to return. (required)
406 x__xgafv: string, V1 error format.
407 Allowed values
408 1 - v1 error format
409 2 - v2 error format
410
411 Returns:
412 An object of the form:
413
414 { # Represents a URL Map resource.
415 #
416 # Compute Engine has two URL Map resources:
417 #
418 # * [Global](/compute/docs/reference/rest/beta/urlMaps)
419 # * [Regional](/compute/docs/reference/rest/beta/regionUrlMaps)
420 #
421 # A URL map resource is a component of certain types of cloud load balancers
422 # and Traffic Director:
423 #
424 # * urlMaps are used by global external Application Load
425 # Balancers, classic Application Load Balancers, and cross-region internal
426 # Application Load Balancers.
427 # * regionUrlMaps are used by internal Application Load Balancers,
428 # regional external Application Load Balancers and regional internal
429 # Application Load Balancers.
430 #
431 # For a list of supported URL map features by the load balancer type, see the
432 # Load balancing features: Routing and traffic management table.
433 #
434 # For a list of supported URL map features for Traffic Director, see the
435 # Traffic Director features: Routing and traffic management table.
436 #
437 # This resource defines mappings from hostnames and URL paths to either a
438 # backend service or a backend bucket.
439 #
440 # To use the global urlMaps resource, the backend service must
441 # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
442 # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
443 # information, read URL
444 # Map Concepts.
445 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
446 # text format.
447 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
448 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
449 #
450 # This policy takes
451 # effect at the load balancer level and applies only when no policy has been
452 # defined for the error code at lower levels like PathMatcher, RouteRule and
453 # PathRule within this UrlMap.
454 #
455 # For example, consider a UrlMap with the
456 # following configuration:
457 #
458 #
459 # - defaultCustomErrorResponsePolicy containing policies for
460 # responding to 5xx and 4xx errors
461 # - A PathMatcher configured for *.example.com has
462 # defaultCustomErrorResponsePolicy for 4xx.
463 #
464 # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
465 # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
466 # a request that does not match any host in *.example.com such
467 # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
468 # takes effect.
469 #
470 # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
471 # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
472 # a retry, if load balancer is successful in reaching the
473 # service, the defaultCustomErrorResponsePolicy is ignored and
474 # the response from the service is returned to the client.
475 #
476 # defaultCustomErrorResponsePolicy is supported only for
477 # global external Application Load Balancers.
478 # backend service or backend bucket responds with an error.
479 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
480 #
481 # In a given policy, if you specify rules for both a range of error codes
482 # as well as rules for specific error codes then rules with specific error
483 # codes have a higher priority. For example, assume that you configure a rule
484 # for 401 (Un-authorized) code, and another for all 4 series
485 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
486 # However if the backend service returns a 403, the rule for4xx takes effect.
487 { # Specifies the mapping between the response code that will be returned along
488 # with the custom error content and the response code returned by the backend
489 # service.
490 &quot;matchResponseCodes&quot;: [ # Valid values include:
491 #
492 #
493 # - A number between 400 and 599: For example
494 # 401 or 503, in which case the load balancer
495 # applies the policy if the error code exactly matches this value.
496 # - 5xx: Load Balancer will apply the policy if the
497 # backend service responds with any response code in the range of
498 # 500 to 599.
499 # - 4xx: Load
500 # Balancer will apply the policy if the backend service responds with any
501 # response code in the range of 400 to
502 # 499.
503 #
504 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
505 &quot;A String&quot;,
506 ],
507 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
508 # error content. If overrideResponseCode is not supplied, the
509 # same response code returned by the original backend bucket or backend
510 # service is returned to the client.
511 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
512 #
513 # path must start
514 # with a leading slash. path cannot have trailing slashes.
515 #
516 # If the file is not available in backendBucket or the
517 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
518 #
519 # The value must
520 # be from 1 to 1024 characters
521 },
522 ],
523 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
524 # contains the custom error content. Examples are:
525 #
526 #
527 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
528 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
529 # - global/backendBuckets/myBackendBucket
530 #
531 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
532 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
533 #
534 # If load balancer cannot reach
535 # the backendBucket, a simple Not Found Error will
536 # be returned, with the original response code (oroverrideResponseCode if configured).
537 #
538 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
539 },
540 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
541 # hostRules match. The load balancer performs advanced routing
542 # actions, such as URL rewrites and header transformations, before forwarding
543 # the request to the selected backend.
544 #
545 #
546 # Only one of defaultUrlRedirect, defaultService
547 # or defaultRouteAction.weightedBackendService can be set.
548 #
549 #
550 # URL maps for classic Application Load Balancers only support
551 # the urlRewrite action within defaultRouteAction.
552 #
553 #
554 # defaultRouteAction has no effect when the URL map is bound
555 # to a target gRPC proxy that has the validateForProxyless field
556 # set to true.
557 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
558 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
559 # property must be specified. This policy cannot be specified if any target
560 # backend has Identity-Aware Proxy enabled.
561 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
562 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
563 # header names can be specified. The cache is bypassed for all `cacheMode`
564 # values.
565 &quot;A String&quot;,
566 ],
567 &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
568 # on the backend type: for Backend Services, the complete request URI is
569 # used; for Backend Buckets, the request URI is used without the protocol or
570 # host, and only query parameters known to Cloud Storage are included.
571 # Policy defined on Route Action.
572 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
573 # parameters will be included. Either specify `excludedQueryParameters`
574 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
575 # encoded and not treated as delimiters.
576 #
577 # Note: This field applies to routes that use backend services. Attempting
578 # to set it on a route that points exclusively to Backend Buckets will
579 # result in a configuration error. For routes that point to a Backend
580 # Bucket, use `includedQueryParameters` to define which parameters should
581 # be part of the cache key.
582 &quot;A String&quot;,
583 ],
584 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
585 #
586 # Note: This setting is only applicable to routes that use a Backend
587 # Service. It does not affect requests served by a Backend Bucket, as the
588 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
589 # it on a route that points exclusively to Backend Buckets will result in a
590 # configuration error.
591 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
592 #
593 # Note: This setting is only applicable to routes that use a Backend
594 # Service. It does not affect requests served by a Backend Bucket, as the
595 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
596 # set on a route that points exclusively to Backend Buckets will result in
597 # a configuration error.
598 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
599 # `includedQueryParameters` and `excludedQueryParameters`. If neither
600 # is set, the entire query string will be included. If false, the query
601 # string will be excluded from the cache key entirely.
602 #
603 # Note: This field applies to routes that use backend services. Attempting
604 # to set it on a route that points exclusively to Backend Buckets will
605 # result in a configuration error. For routes that point to a Backend
606 # Bucket, use `includedQueryParameters` to define which parameters should
607 # be part of the cache key.
608 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
609 # The name=value pair will be used in the cache key Cloud CDN generates.
610 #
611 # Note: This setting is only applicable to routes that use a Backend
612 # Service. It does not affect requests served by a Backend Bucket.
613 # Attempting to set it on a route that points exclusively to Backend
614 # Buckets will result in a configuration error. Up to 5 cookie names can be
615 # specified.
616 &quot;A String&quot;,
617 ],
618 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
619 &quot;A String&quot;,
620 ],
621 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
622 # parameters will be excluded. Either specify `includedQueryParameters`
623 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
624 # encoded and not treated as delimiters.
625 &quot;A String&quot;,
626 ],
627 },
628 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
629 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
630 &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
631 # content. This is used to clamp the max-age (or Expires) value sent to the
632 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
633 # is used for the response max-age directive, along with a &quot;public&quot;
634 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
635 # clamps the max-age from the origin (if specified), or else sets the
636 # response max-age directive to the lesser of the `clientTtl` and
637 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
638 # present. The maximum allowed value is 31,622,400s (1 year). If not
639 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
640 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
641 # `USE_ORIGIN_HEADERS`.
642 # as a count of seconds and fractions of seconds at nanosecond
643 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
644 # or &quot;month&quot;. Range is approximately 10,000 years.
645 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
646 # Durations less than one second are represented with a 0
647 # `seconds` field and a positive `nanos` field. Must be from 0
648 # to 999,999,999 inclusive.
649 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
650 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
651 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
652 },
653 &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
654 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
655 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
656 # greater than that of `maxTtl`. When the `cacheMode` is set to
657 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
658 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
659 # accessed objects may be evicted from the cache before the defined TTL. If
660 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
661 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
662 # `USE_ORIGIN_HEADERS`.
663 # as a count of seconds and fractions of seconds at nanosecond
664 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
665 # or &quot;month&quot;. Range is approximately 10,000 years.
666 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
667 # Durations less than one second are represented with a 0
668 # `seconds` field and a positive `nanos` field. Must be from 0
669 # to 999,999,999 inclusive.
670 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
671 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
672 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
673 },
674 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
675 # attempt to set a max-age or s-maxage higher than this, or an Expires header
676 # more than `maxTtl` seconds in the future will be capped at the value of
677 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
678 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
679 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
680 # Infrequently accessed objects may be evicted from the cache before the
681 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
682 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
683 # mode.
684 # as a count of seconds and fractions of seconds at nanosecond
685 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
686 # or &quot;month&quot;. Range is approximately 10,000 years.
687 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
688 # Durations less than one second are represented with a 0
689 # `seconds` field and a positive `nanos` field. Must be from 0
690 # to 999,999,999 inclusive.
691 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
692 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
693 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
694 },
695 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
696 # to apply fine-grained caching for common errors or redirects.
697 # This can reduce the load on your origin and improve end-user
698 # experience by reducing response latency.
699 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
700 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
701 # the specified response code that lack any Cache-Control, Expires, or
702 # Pragma: no-cache directives. When the `cacheMode` is set to
703 # `FORCE_CACHE_ALL`, negative caching applies to all responses
704 # with the specified response code, and overrides any caching headers. By
705 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
706 #
707 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
708 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
709 # * 405 (Method Not Found), 501 (Not Implemented): 60s
710 #
711 # These defaults can be overridden in `negativeCachingPolicy`.
712 # If not specified, Cloud CDN applies negative caching by default.
713 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
714 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
715 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
716 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
717 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
718 # all response codes that you wish to cache. Cloud CDN will not apply any
719 # default negative caching when a policy exists.
720 { # Specify CDN TTLs for response error codes.
721 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
722 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
723 # specified as values, and you cannot specify a status code more than
724 # once.
725 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
726 # corresponding status code.
727 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
728 # objects may be evicted from the cache before the defined TTL.
729 # as a count of seconds and fractions of seconds at nanosecond
730 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
731 # or &quot;month&quot;. Range is approximately 10,000 years.
732 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
733 # Durations less than one second are represented with a 0
734 # `seconds` field and a positive `nanos` field. Must be from 0
735 # to 999,999,999 inclusive.
736 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
737 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
738 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
739 },
740 },
741 ],
742 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
743 # requests into a small number of requests to the origin. If not specified,
744 # Cloud CDN applies request coalescing by default.
745 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
746 # content with the origin, or when an error is encountered when refreshing
747 # the cache.
748 # This setting defines the default &quot;max-stale&quot; duration for any cached
749 # responses that do not specify a max-stale directive. Stale responses that
750 # exceed the TTL configured here will not be served. The default limit
751 # (max-stale) is 86400s (1 day), which will allow stale content to be
752 # served up to this limit beyond the max-age (or s-maxage) of a cached
753 # response.
754 # The maximum allowed value is 604800 (1 week).
755 # Set this to zero (0) to disable serve-while-stale.
756 # as a count of seconds and fractions of seconds at nanosecond
757 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
758 # or &quot;month&quot;. Range is approximately 10,000 years.
759 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
760 # Durations less than one second are represented with a 0
761 # `seconds` field and a positive `nanos` field. Must be from 0
762 # to 999,999,999 inclusive.
763 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
764 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
765 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
766 },
767 },
768 &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
769 # information about the W3C recommendation for cross-origin resource sharing
770 # (CORS), see Fetch API Living
771 # Standard.
772 #
773 # Not supported when the URL map is bound to a target gRPC proxy.
774 # information about the W3C recommendation for cross-origin resource sharing
775 # (CORS), see Fetch API Living
776 # Standard.
777 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
778 # indicates that
779 # the actual request can include user credentials. This field translates to
780 # the Access-Control-Allow-Credentials header.
781 #
782 # Default is false.
783 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
784 # header.
785 &quot;A String&quot;,
786 ],
787 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
788 # header.
789 &quot;A String&quot;,
790 ],
791 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
792 # more information, see regular expression syntax.
793 #
794 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
795 #
796 # Regular expressions can only be used when the loadBalancingScheme is
797 # set to INTERNAL_SELF_MANAGED.
798 &quot;A String&quot;,
799 ],
800 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
801 #
802 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
803 &quot;A String&quot;,
804 ],
805 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
806 # The default value is false, which indicates that the CORS
807 # policy is in effect.
808 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
809 # header.
810 &quot;A String&quot;,
811 ],
812 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
813 # seconds. This field translates to the Access-Control-Max-Age
814 # header.
815 },
816 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
817 # the resiliency of clients to backend service failure. As part of fault
818 # injection, when clients send requests to a backend service, delays can be
819 # introduced by a load balancer on a percentage of requests before sending
820 # those requests to the backend service. Similarly requests from clients can
821 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
822 # that are configured with a fault_injection_policy if:
823 # 1. The traffic is generated by fault injection AND
824 # 2. The fault injection is not a delay fault injection.
825 # Fault injection is not supported with the classic Application Load Balancer
826 # . To see which load balancers support fault injection,
827 # see Load
828 # balancing: Routing and traffic management features.
829 # the resiliency of clients to backend service failure. As part of fault
830 # injection, when clients send requests to a backend service, delays can be
831 # introduced by the load balancer on a percentage of requests before sending
832 # those request to the backend service. Similarly requests from clients can be
833 # aborted by the load balancer for a percentage of requests.
834 &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
835 # injection.
836 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
837 #
838 # The value must be from 200 to 599 inclusive.
839 #
840 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
841 # according to this
842 # mapping table. HTTP status 200 is mapped to gRPC status
843 # UNKNOWN. Injecting an OK status is currently not supported by
844 # Traffic Director.
845 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
846 # that is aborted as part of fault injection.
847 #
848 # The value must be from 0.0 to 100.0 inclusive.
849 },
850 &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
851 # injection, before being sent to a backend service.
852 # request to the backend service as part of fault injection.
853 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
854 # as a count of seconds and fractions of seconds at nanosecond
855 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
856 # or &quot;month&quot;. Range is approximately 10,000 years.
857 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
858 # Durations less than one second are represented with a 0
859 # `seconds` field and a positive `nanos` field. Must be from 0
860 # to 999,999,999 inclusive.
861 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
862 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
863 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
864 },
865 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
866 # which a delay is introduced as part of fault injection.
867 #
868 # The value must be from 0.0 to 100.0 inclusive.
869 },
870 },
871 &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
872 # Global EXTERNAL_MANAGED load balancer schemes.
873 # Either Cloud CDN must be enabled on the backend service or backend bucket
874 # serving the route, or cache policy must be configured on the same route
875 # dynamically processes and delivers images from the network edge.
876 # Image Optimization is only available for Global External Application Load
877 # Balancers.
878 # Either Cloud CDN must be enabled on the backend service or backend bucket
879 # serving the route, or cache policy must be configured on the same route.
880 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
881 },
882 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
883 # Unlike the timeout field where the timeout duration starts
884 # from the time the request has been fully processed (known as*end-of-stream*),
885 # the duration in this field is computed from the beginning of the stream
886 # until the response has been processed, including all retries. A
887 # stream that does not complete in this duration is closed.
888 #
889 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
890 # with the route.
891 #
892 # This field is only allowed if the Url map is used with backend services
893 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
894 # as a count of seconds and fractions of seconds at nanosecond
895 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
896 # or &quot;month&quot;. Range is approximately 10,000 years.
897 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
898 # Durations less than one second are represented with a 0
899 # `seconds` field and a positive `nanos` field. Must be from 0
900 # to 999,999,999 inclusive.
901 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
902 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
903 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
904 },
905 &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
906 # are shadowed to a separate mirrored backend service. The load balancer does
907 # not wait for responses from the shadow service. Before sending traffic
908 # to the shadow service, the host / authority header is suffixed with-shadow.
909 #
910 # Not supported when the URL map is bound to a target gRPC proxy that
911 # has the validateForProxyless field set to true.
912 # are shadowed to a separate mirrored backend service. The load balancer
913 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
914 # to the shadow service, the host or authority header is suffixed with-shadow.
915 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
916 # mirrored to.
917 #
918 # The backend service configured for a mirroring
919 # policy must reference backends that are of the same type as the original
920 # backend service matched in the URL map.
921 #
922 # Serverless NEG backends are not currently supported as a mirrored
923 # backend service.
924 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
925 },
926 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
927 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
928 # If not specified, defaults to 1.
929 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
930 #
931 # If not specified, will use the timeout set in theHttpRouteAction field.
932 # If timeout in the HttpRouteAction field is not set, this field
933 # uses the largest timeout
934 # among all backend services associated with the route.
935 #
936 # Not supported when the URL map is bound to a target gRPC proxy that
937 # has the validateForProxyless field set to true.
938 # as a count of seconds and fractions of seconds at nanosecond
939 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
940 # or &quot;month&quot;. Range is approximately 10,000 years.
941 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
942 # Durations less than one second are represented with a 0
943 # `seconds` field and a positive `nanos` field. Must be from 0
944 # to 999,999,999 inclusive.
945 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
946 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
947 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
948 },
949 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
950 # values are:
951 #
952 # - 5xx: retry is attempted if the instance or endpoint
953 # responds with any 5xx response code, or if the instance or
954 # endpoint does not respond at all. For example, disconnects, reset, read
955 # timeout, connection failure, and refused streams.
956 # - gateway-error: Similar to 5xx, but only
957 # applies to response codes 502, 503 or504.
958 # - connect-failure: a retry is attempted on failures
959 # connecting to the instance or endpoint. For example, connection
960 # timeouts.
961 # - retriable-4xx: a retry is attempted if the instance
962 # or endpoint responds with a 4xx response code.
963 # The only error that you can retry is error code 409.
964 # - refused-stream: a retry is attempted if the instance
965 # or endpoint resets the stream with a REFUSED_STREAM error
966 # code. This reset type indicates that it is safe to retry.
967 # - cancelled: a retry is attempted if the gRPC status
968 # code in the response header is set to cancelled.
969 # - deadline-exceeded: a retry is attempted if the gRPC
970 # status code in the response header is set todeadline-exceeded.
971 # - internal: a retry is attempted if the gRPC
972 # status code in the response header is set tointernal.
973 # - resource-exhausted: a retry is attempted if the gRPC
974 # status code in the response header is set toresource-exhausted.
975 # - unavailable: a retry is attempted if the gRPC
976 # status code in the response header is set tounavailable.
977 #
978 # Only the following codes are supported when the URL map is bound to
979 # target gRPC proxy that has validateForProxyless field set to true.
980 #
981 # - cancelled
982 # - deadline-exceeded
983 # - internal
984 # - resource-exhausted
985 # - unavailable
986 &quot;A String&quot;,
987 ],
988 },
989 &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
990 # time the request has been fully processed (known as *end-of-stream*)
991 # up until the response has been processed. Timeout includes
992 # all retries.
993 #
994 # If not specified, this field uses the largest timeout among all backend
995 # services associated with the route.
996 #
997 # Not supported when the URL map is bound to a target gRPC proxy that
998 # has validateForProxyless field set to true.
999 # as a count of seconds and fractions of seconds at nanosecond
1000 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1001 # or &quot;month&quot;. Range is approximately 10,000 years.
1002 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1003 # Durations less than one second are represented with a 0
1004 # `seconds` field and a positive `nanos` field. Must be from 0
1005 # to 999,999,999 inclusive.
1006 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1007 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1008 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1009 },
1010 &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
1011 # to the matched service.
1012 #
1013 # urlRewrite is the only action supported in UrlMaps
1014 # for classic Application Load Balancers.
1015 #
1016 # Not supported when the URL map is bound to a target gRPC proxy that
1017 # has the validateForProxyless field set to true.
1018 # backend service.
1019 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
1020 # host header is replaced with contents of hostRewrite.
1021 #
1022 # The value must be from 1 to 255 characters.
1023 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
1024 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
1025 #
1026 # The value must be from 1 to 1024 characters.
1027 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
1028 # header) using the HTTP template syntax.
1029 #
1030 # A corresponding
1031 # path_template_match must be specified. Any template variables must exist in
1032 # the path_template_match field.
1033 #
1034 #
1035 # - -At least one variable must be specified in the path_template_match
1036 # field
1037 # - You can omit variables from the rewritten URL
1038 # - The * and ** operators cannot be matched
1039 # unless they have a corresponding variable name - e.g.
1040 # {format=*} or {var=**}.
1041 #
1042 # For example, a path_template_match of /static/{format=**}
1043 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
1044 # rewrite, so that /{country}/{format}/{suffix=**} can be
1045 # rewritten as /content/{format}/{country}/{suffix}.
1046 #
1047 # At least
1048 # one non-empty routeRules[].matchRules[].path_template_match is
1049 # required.
1050 #
1051 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
1052 },
1053 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
1054 # occurs. The weights determine the fraction of traffic that flows to
1055 # their corresponding backend service. If all traffic needs to
1056 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
1057 #
1058 # After a backend service is identified and before forwarding
1059 # the request to
1060 # the backend service, advanced routing actions such as URL rewrites and
1061 # header transformations are applied depending on additional settings
1062 # specified in this HttpRouteAction.
1063 { # In contrast to a single BackendService in
1064 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
1065 # multiple backend services. The volume of traffic for each
1066 # backend service is proportional to the weight specified
1067 # in each WeightedBackendService
1068 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
1069 # resource. Before
1070 # forwarding the request to backendService, the load balancer
1071 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
1072 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
1073 # effect for the selected backendService.
1074 #
1075 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
1076 #
1077 # headerAction is not supported for load balancers that have
1078 # their loadBalancingScheme set to EXTERNAL.
1079 #
1080 # Not supported when the URL map is bound to a target gRPC proxy that
1081 # has validateForProxyless field set to true.
1082 # the request is passed along to the selected backendService.
1083 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
1084 { # Specification determining how headers are added to requests or responses.
1085 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
1086 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
1087 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
1088 # that already
1089 # exist for the header. If true, headerValue is set for the
1090 # header, discarding any values that were set for that header.
1091 #
1092 # The default value is true,
1093 # unless a variable is present in headerValue,
1094 # in which case the default value is false.
1095 # .
1096 },
1097 ],
1098 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
1099 # request before forwarding the request to the backendService.
1100 &quot;A String&quot;,
1101 ],
1102 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
1103 # client.
1104 { # Specification determining how headers are added to requests or responses.
1105 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
1106 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
1107 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
1108 # that already
1109 # exist for the header. If true, headerValue is set for the
1110 # header, discarding any values that were set for that header.
1111 #
1112 # The default value is true,
1113 # unless a variable is present in headerValue,
1114 # in which case the default value is false.
1115 # .
1116 },
1117 ],
1118 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
1119 # response before sending the response back to the client.
1120 &quot;A String&quot;,
1121 ],
1122 },
1123 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
1124 # computed asweight / (sum of all weightedBackendService weights in routeAction).
1125 #
1126 # The selection of a backend service is determined only for new traffic.
1127 # Once a user&#x27;s request has been directed to a backend service,
1128 # subsequent requests are sent to the same backend service as
1129 # determined by the backend service&#x27;s session affinity policy.
1130 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
1131 # splitting. If you do, the weighted traffic splitting configuration takes
1132 # precedence.
1133 #
1134 # The value must be from 0 to 1000.
1135 },
1136 ],
1137 },
1138 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL of the defaultService resource to
1139 # which traffic is directed if none of the hostRules match.
1140 # If defaultRouteAction is also specified, advanced
1141 # routing actions, such as URL rewrites, take effect before sending the
1142 # request to the backend.
1143 #
1144 #
1145 # Only one of defaultUrlRedirect, defaultService
1146 # or defaultRouteAction.weightedBackendService can be set.
1147 #
1148 #
1149 # defaultService has no effect when the URL map is bound
1150 # to a target gRPC proxy that has the validateForProxyless field
1151 # set to true.
1152 &quot;defaultUrlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
1153 # is redirected to a URL specified by defaultUrlRedirect.
1154 #
1155 #
1156 # Only one of defaultUrlRedirect, defaultService
1157 # or defaultRouteAction.weightedBackendService can be set.
1158 #
1159 #
1160 # Not supported when the URL map is bound to a target gRPC proxy.
1161 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
1162 # was supplied in the request.
1163 #
1164 # The value must be from 1 to 255
1165 # characters.
1166 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
1167 # set to HTTPS.
1168 # If set to false, the URL scheme of the redirected request
1169 # remains the same as that of the request.
1170 #
1171 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
1172 #
1173 # The default is set to false.
1174 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
1175 # that was supplied in the request.
1176 #
1177 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
1178 # supplied, the path of the original request is used for the redirect.
1179 #
1180 # The value must be from 1 to 1024 characters.
1181 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
1182 # the HttpRouteRuleMatch, retaining the remaining portion
1183 # of the URL before redirecting the request.
1184 #
1185 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
1186 # supplied, the path of the original request is used for the redirect.
1187 #
1188 # The value must be from 1 to 1024 characters.
1189 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
1190 #
1191 # Supported values are:
1192 #
1193 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
1194 # to 301.
1195 # - FOUND, which corresponds to 302.
1196 # - SEE_OTHER which corresponds to 303.
1197 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
1198 # method is retained.
1199 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
1200 # method is retained.
1201 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
1202 # URL is
1203 # removed before redirecting the request. If set to false, the
1204 # query portion of the original URL is retained.
1205 #
1206 # The default is set to false.
1207 },
1208 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
1209 # create the resource.
1210 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. A hash of the contents stored in this object.
1211 # This field is used in optimistic locking. This field is ignored when
1212 # inserting a UrlMap. An up-to-date fingerprint must be provided
1213 # in order to update the UrlMap, otherwise the request will
1214 # fail with error 412 conditionNotMet.
1215 #
1216 # To see the latest fingerprint, make a get() request to
1217 # retrieve a UrlMap.
1218 &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
1219 # for the selected backendService.
1220 #
1221 # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
1222 #
1223 # headerAction is not supported for load balancers
1224 # that have
1225 # their loadBalancingScheme set to EXTERNAL.
1226 #
1227 # Not supported when the URL map is bound to a target gRPC proxy that
1228 # has validateForProxyless field set to true.
1229 # the request is passed along to the selected backendService.
1230 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
1231 { # Specification determining how headers are added to requests or responses.
1232 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
1233 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
1234 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
1235 # that already
1236 # exist for the header. If true, headerValue is set for the
1237 # header, discarding any values that were set for that header.
1238 #
1239 # The default value is true,
1240 # unless a variable is present in headerValue,
1241 # in which case the default value is false.
1242 # .
1243 },
1244 ],
1245 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
1246 # request before forwarding the request to the backendService.
1247 &quot;A String&quot;,
1248 ],
1249 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
1250 # client.
1251 { # Specification determining how headers are added to requests or responses.
1252 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
1253 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
1254 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
1255 # that already
1256 # exist for the header. If true, headerValue is set for the
1257 # header, discarding any values that were set for that header.
1258 #
1259 # The default value is true,
1260 # unless a variable is present in headerValue,
1261 # in which case the default value is false.
1262 # .
1263 },
1264 ],
1265 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
1266 # response before sending the response back to the client.
1267 &quot;A String&quot;,
1268 ],
1269 },
1270 &quot;hostRules&quot;: [ # The list of host rules to use against the URL.
1271 { # UrlMaps
1272 # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
1273 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
1274 # create the resource.
1275 &quot;hosts&quot;: [ # The list of host patterns to match. They must be valid hostnames with
1276 # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
1277 # that case, * must be the first character, and if followed by
1278 # anything, the immediate following character must be either -
1279 # or ..
1280 #
1281 # * based matching is not supported when the URL map is bound
1282 # to a target gRPC proxy that has the validateForProxyless field
1283 # set to true.
1284 &quot;A String&quot;,
1285 ],
1286 &quot;pathMatcher&quot;: &quot;A String&quot;, # The name of the PathMatcher to use to match the path portion
1287 # of the URL if the hostRule matches the URL&#x27;s host portion.
1288 },
1289 ],
1290 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the resource. This identifier is
1291 # defined by the server.
1292 &quot;kind&quot;: &quot;compute#urlMap&quot;, # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
1293 # url maps.
1294 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
1295 # The name must be 1-63 characters long, and comply withRFC1035.
1296 # Specifically, the name must be 1-63 characters long and match the regular
1297 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
1298 # character must be a lowercase letter, and all following characters must
1299 # be a dash, lowercase letter, or digit, except the last character, which
1300 # cannot be a dash.
1301 &quot;pathMatchers&quot;: [ # The list of named PathMatchers to use against the URL.
1302 { # A matcher for the path portion of the URL. The BackendService
1303 # from the longest-matched rule will serve the URL. If no rule was matched, the
1304 # default service is used.
1305 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
1306 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
1307 #
1308 # This policy takes
1309 # effect at the PathMatcher level and applies only when no
1310 # 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
1311 # in defaultCustomErrorResponsePolicy, then a policy defined for
1312 # the error code in UrlMap.defaultCustomErrorResponsePolicy
1313 # takes effect.
1314 #
1315 # For example, consider a UrlMap with the following
1316 # configuration:
1317 #
1318 #
1319 # - UrlMap.defaultCustomErrorResponsePolicy is configured
1320 # with policies for 5xx and 4xx errors
1321 # - A RouteRule for /coming_soon/ is configured for the
1322 # error code 404.
1323 #
1324 # 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
1325 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
1326 # the policy in RouteRule.customErrorResponsePolicy takes
1327 # effect. If any of the requests in this example encounter a 500
1328 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
1329 #
1330 # When
1331 # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
1332 # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
1333 # a retry, if load balancer is successful in reaching the
1334 # service, the defaultCustomErrorResponsePolicy is ignored and
1335 # the response from the service is returned to the client.
1336 #
1337 # defaultCustomErrorResponsePolicy is supported only for
1338 # global external Application Load Balancers.
1339 # backend service or backend bucket responds with an error.
1340 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
1341 #
1342 # In a given policy, if you specify rules for both a range of error codes
1343 # as well as rules for specific error codes then rules with specific error
1344 # codes have a higher priority. For example, assume that you configure a rule
1345 # for 401 (Un-authorized) code, and another for all 4 series
1346 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
1347 # However if the backend service returns a 403, the rule for4xx takes effect.
1348 { # Specifies the mapping between the response code that will be returned along
1349 # with the custom error content and the response code returned by the backend
1350 # service.
1351 &quot;matchResponseCodes&quot;: [ # Valid values include:
1352 #
1353 #
1354 # - A number between 400 and 599: For example
1355 # 401 or 503, in which case the load balancer
1356 # applies the policy if the error code exactly matches this value.
1357 # - 5xx: Load Balancer will apply the policy if the
1358 # backend service responds with any response code in the range of
1359 # 500 to 599.
1360 # - 4xx: Load
1361 # Balancer will apply the policy if the backend service responds with any
1362 # response code in the range of 400 to
1363 # 499.
1364 #
1365 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
1366 &quot;A String&quot;,
1367 ],
1368 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
1369 # error content. If overrideResponseCode is not supplied, the
1370 # same response code returned by the original backend bucket or backend
1371 # service is returned to the client.
1372 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
1373 #
1374 # path must start
1375 # with a leading slash. path cannot have trailing slashes.
1376 #
1377 # If the file is not available in backendBucket or the
1378 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
1379 #
1380 # The value must
1381 # be from 1 to 1024 characters
1382 },
1383 ],
1384 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
1385 # contains the custom error content. Examples are:
1386 #
1387 #
1388 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
1389 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
1390 # - global/backendBuckets/myBackendBucket
1391 #
1392 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
1393 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
1394 #
1395 # If load balancer cannot reach
1396 # the backendBucket, a simple Not Found Error will
1397 # be returned, with the original response code (oroverrideResponseCode if configured).
1398 #
1399 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
1400 },
1401 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
1402 # pathRules or routeRules match. The load balancer
1403 # performs advanced routing actions, such as URL rewrites and
1404 # header transformations, before forwarding the request to the
1405 # selected backend.
1406 #
1407 #
1408 # Only one of defaultUrlRedirect, defaultService
1409 # or defaultRouteAction.weightedBackendService can be set.
1410 #
1411 #
1412 # URL maps for classic Application Load Balancers only support
1413 # the urlRewrite action within a path matcher&#x27;sdefaultRouteAction.
1414 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
1415 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
1416 # property must be specified. This policy cannot be specified if any target
1417 # backend has Identity-Aware Proxy enabled.
1418 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
1419 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
1420 # header names can be specified. The cache is bypassed for all `cacheMode`
1421 # values.
1422 &quot;A String&quot;,
1423 ],
1424 &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
1425 # on the backend type: for Backend Services, the complete request URI is
1426 # used; for Backend Buckets, the request URI is used without the protocol or
1427 # host, and only query parameters known to Cloud Storage are included.
1428 # Policy defined on Route Action.
1429 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
1430 # parameters will be included. Either specify `excludedQueryParameters`
1431 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
1432 # encoded and not treated as delimiters.
1433 #
1434 # Note: This field applies to routes that use backend services. Attempting
1435 # to set it on a route that points exclusively to Backend Buckets will
1436 # result in a configuration error. For routes that point to a Backend
1437 # Bucket, use `includedQueryParameters` to define which parameters should
1438 # be part of the cache key.
1439 &quot;A String&quot;,
1440 ],
1441 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
1442 #
1443 # Note: This setting is only applicable to routes that use a Backend
1444 # Service. It does not affect requests served by a Backend Bucket, as the
1445 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
1446 # it on a route that points exclusively to Backend Buckets will result in a
1447 # configuration error.
1448 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
1449 #
1450 # Note: This setting is only applicable to routes that use a Backend
1451 # Service. It does not affect requests served by a Backend Bucket, as the
1452 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
1453 # set on a route that points exclusively to Backend Buckets will result in
1454 # a configuration error.
1455 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
1456 # `includedQueryParameters` and `excludedQueryParameters`. If neither
1457 # is set, the entire query string will be included. If false, the query
1458 # string will be excluded from the cache key entirely.
1459 #
1460 # Note: This field applies to routes that use backend services. Attempting
1461 # to set it on a route that points exclusively to Backend Buckets will
1462 # result in a configuration error. For routes that point to a Backend
1463 # Bucket, use `includedQueryParameters` to define which parameters should
1464 # be part of the cache key.
1465 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
1466 # The name=value pair will be used in the cache key Cloud CDN generates.
1467 #
1468 # Note: This setting is only applicable to routes that use a Backend
1469 # Service. It does not affect requests served by a Backend Bucket.
1470 # Attempting to set it on a route that points exclusively to Backend
1471 # Buckets will result in a configuration error. Up to 5 cookie names can be
1472 # specified.
1473 &quot;A String&quot;,
1474 ],
1475 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
1476 &quot;A String&quot;,
1477 ],
1478 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
1479 # parameters will be excluded. Either specify `includedQueryParameters`
1480 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
1481 # encoded and not treated as delimiters.
1482 &quot;A String&quot;,
1483 ],
1484 },
1485 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
1486 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
1487 &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
1488 # content. This is used to clamp the max-age (or Expires) value sent to the
1489 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
1490 # is used for the response max-age directive, along with a &quot;public&quot;
1491 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
1492 # clamps the max-age from the origin (if specified), or else sets the
1493 # response max-age directive to the lesser of the `clientTtl` and
1494 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
1495 # present. The maximum allowed value is 31,622,400s (1 year). If not
1496 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
1497 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
1498 # `USE_ORIGIN_HEADERS`.
1499 # as a count of seconds and fractions of seconds at nanosecond
1500 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1501 # or &quot;month&quot;. Range is approximately 10,000 years.
1502 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1503 # Durations less than one second are represented with a 0
1504 # `seconds` field and a positive `nanos` field. Must be from 0
1505 # to 999,999,999 inclusive.
1506 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1507 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1508 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1509 },
1510 &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
1511 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
1512 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
1513 # greater than that of `maxTtl`. When the `cacheMode` is set to
1514 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
1515 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
1516 # accessed objects may be evicted from the cache before the defined TTL. If
1517 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
1518 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
1519 # `USE_ORIGIN_HEADERS`.
1520 # as a count of seconds and fractions of seconds at nanosecond
1521 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1522 # or &quot;month&quot;. Range is approximately 10,000 years.
1523 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1524 # Durations less than one second are represented with a 0
1525 # `seconds` field and a positive `nanos` field. Must be from 0
1526 # to 999,999,999 inclusive.
1527 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1528 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1529 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1530 },
1531 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
1532 # attempt to set a max-age or s-maxage higher than this, or an Expires header
1533 # more than `maxTtl` seconds in the future will be capped at the value of
1534 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
1535 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
1536 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
1537 # Infrequently accessed objects may be evicted from the cache before the
1538 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
1539 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
1540 # mode.
1541 # as a count of seconds and fractions of seconds at nanosecond
1542 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1543 # or &quot;month&quot;. Range is approximately 10,000 years.
1544 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1545 # Durations less than one second are represented with a 0
1546 # `seconds` field and a positive `nanos` field. Must be from 0
1547 # to 999,999,999 inclusive.
1548 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1549 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1550 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1551 },
1552 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
1553 # to apply fine-grained caching for common errors or redirects.
1554 # This can reduce the load on your origin and improve end-user
1555 # experience by reducing response latency.
1556 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
1557 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
1558 # the specified response code that lack any Cache-Control, Expires, or
1559 # Pragma: no-cache directives. When the `cacheMode` is set to
1560 # `FORCE_CACHE_ALL`, negative caching applies to all responses
1561 # with the specified response code, and overrides any caching headers. By
1562 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
1563 #
1564 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
1565 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
1566 # * 405 (Method Not Found), 501 (Not Implemented): 60s
1567 #
1568 # These defaults can be overridden in `negativeCachingPolicy`.
1569 # If not specified, Cloud CDN applies negative caching by default.
1570 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
1571 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
1572 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
1573 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
1574 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
1575 # all response codes that you wish to cache. Cloud CDN will not apply any
1576 # default negative caching when a policy exists.
1577 { # Specify CDN TTLs for response error codes.
1578 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
1579 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
1580 # specified as values, and you cannot specify a status code more than
1581 # once.
1582 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
1583 # corresponding status code.
1584 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
1585 # objects may be evicted from the cache before the defined TTL.
1586 # as a count of seconds and fractions of seconds at nanosecond
1587 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1588 # or &quot;month&quot;. Range is approximately 10,000 years.
1589 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1590 # Durations less than one second are represented with a 0
1591 # `seconds` field and a positive `nanos` field. Must be from 0
1592 # to 999,999,999 inclusive.
1593 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1594 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1595 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1596 },
1597 },
1598 ],
1599 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
1600 # requests into a small number of requests to the origin. If not specified,
1601 # Cloud CDN applies request coalescing by default.
1602 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
1603 # content with the origin, or when an error is encountered when refreshing
1604 # the cache.
1605 # This setting defines the default &quot;max-stale&quot; duration for any cached
1606 # responses that do not specify a max-stale directive. Stale responses that
1607 # exceed the TTL configured here will not be served. The default limit
1608 # (max-stale) is 86400s (1 day), which will allow stale content to be
1609 # served up to this limit beyond the max-age (or s-maxage) of a cached
1610 # response.
1611 # The maximum allowed value is 604800 (1 week).
1612 # Set this to zero (0) to disable serve-while-stale.
1613 # as a count of seconds and fractions of seconds at nanosecond
1614 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1615 # or &quot;month&quot;. Range is approximately 10,000 years.
1616 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1617 # Durations less than one second are represented with a 0
1618 # `seconds` field and a positive `nanos` field. Must be from 0
1619 # to 999,999,999 inclusive.
1620 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1621 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1622 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1623 },
1624 },
1625 &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
1626 # information about the W3C recommendation for cross-origin resource sharing
1627 # (CORS), see Fetch API Living
1628 # Standard.
1629 #
1630 # Not supported when the URL map is bound to a target gRPC proxy.
1631 # information about the W3C recommendation for cross-origin resource sharing
1632 # (CORS), see Fetch API Living
1633 # Standard.
1634 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
1635 # indicates that
1636 # the actual request can include user credentials. This field translates to
1637 # the Access-Control-Allow-Credentials header.
1638 #
1639 # Default is false.
1640 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
1641 # header.
1642 &quot;A String&quot;,
1643 ],
1644 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
1645 # header.
1646 &quot;A String&quot;,
1647 ],
1648 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
1649 # more information, see regular expression syntax.
1650 #
1651 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
1652 #
1653 # Regular expressions can only be used when the loadBalancingScheme is
1654 # set to INTERNAL_SELF_MANAGED.
1655 &quot;A String&quot;,
1656 ],
1657 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
1658 #
1659 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
1660 &quot;A String&quot;,
1661 ],
1662 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
1663 # The default value is false, which indicates that the CORS
1664 # policy is in effect.
1665 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
1666 # header.
1667 &quot;A String&quot;,
1668 ],
1669 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
1670 # seconds. This field translates to the Access-Control-Max-Age
1671 # header.
1672 },
1673 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
1674 # the resiliency of clients to backend service failure. As part of fault
1675 # injection, when clients send requests to a backend service, delays can be
1676 # introduced by a load balancer on a percentage of requests before sending
1677 # those requests to the backend service. Similarly requests from clients can
1678 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
1679 # that are configured with a fault_injection_policy if:
1680 # 1. The traffic is generated by fault injection AND
1681 # 2. The fault injection is not a delay fault injection.
1682 # Fault injection is not supported with the classic Application Load Balancer
1683 # . To see which load balancers support fault injection,
1684 # see Load
1685 # balancing: Routing and traffic management features.
1686 # the resiliency of clients to backend service failure. As part of fault
1687 # injection, when clients send requests to a backend service, delays can be
1688 # introduced by the load balancer on a percentage of requests before sending
1689 # those request to the backend service. Similarly requests from clients can be
1690 # aborted by the load balancer for a percentage of requests.
1691 &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
1692 # injection.
1693 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
1694 #
1695 # The value must be from 200 to 599 inclusive.
1696 #
1697 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
1698 # according to this
1699 # mapping table. HTTP status 200 is mapped to gRPC status
1700 # UNKNOWN. Injecting an OK status is currently not supported by
1701 # Traffic Director.
1702 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
1703 # that is aborted as part of fault injection.
1704 #
1705 # The value must be from 0.0 to 100.0 inclusive.
1706 },
1707 &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
1708 # injection, before being sent to a backend service.
1709 # request to the backend service as part of fault injection.
1710 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
1711 # as a count of seconds and fractions of seconds at nanosecond
1712 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1713 # or &quot;month&quot;. Range is approximately 10,000 years.
1714 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1715 # Durations less than one second are represented with a 0
1716 # `seconds` field and a positive `nanos` field. Must be from 0
1717 # to 999,999,999 inclusive.
1718 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1719 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1720 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1721 },
1722 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
1723 # which a delay is introduced as part of fault injection.
1724 #
1725 # The value must be from 0.0 to 100.0 inclusive.
1726 },
1727 },
1728 &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
1729 # Global EXTERNAL_MANAGED load balancer schemes.
1730 # Either Cloud CDN must be enabled on the backend service or backend bucket
1731 # serving the route, or cache policy must be configured on the same route
1732 # dynamically processes and delivers images from the network edge.
1733 # Image Optimization is only available for Global External Application Load
1734 # Balancers.
1735 # Either Cloud CDN must be enabled on the backend service or backend bucket
1736 # serving the route, or cache policy must be configured on the same route.
1737 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
1738 },
1739 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
1740 # Unlike the timeout field where the timeout duration starts
1741 # from the time the request has been fully processed (known as*end-of-stream*),
1742 # the duration in this field is computed from the beginning of the stream
1743 # until the response has been processed, including all retries. A
1744 # stream that does not complete in this duration is closed.
1745 #
1746 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
1747 # with the route.
1748 #
1749 # This field is only allowed if the Url map is used with backend services
1750 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
1751 # as a count of seconds and fractions of seconds at nanosecond
1752 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1753 # or &quot;month&quot;. Range is approximately 10,000 years.
1754 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1755 # Durations less than one second are represented with a 0
1756 # `seconds` field and a positive `nanos` field. Must be from 0
1757 # to 999,999,999 inclusive.
1758 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1759 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1760 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1761 },
1762 &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
1763 # are shadowed to a separate mirrored backend service. The load balancer does
1764 # not wait for responses from the shadow service. Before sending traffic
1765 # to the shadow service, the host / authority header is suffixed with-shadow.
1766 #
1767 # Not supported when the URL map is bound to a target gRPC proxy that
1768 # has the validateForProxyless field set to true.
1769 # are shadowed to a separate mirrored backend service. The load balancer
1770 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
1771 # to the shadow service, the host or authority header is suffixed with-shadow.
1772 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
1773 # mirrored to.
1774 #
1775 # The backend service configured for a mirroring
1776 # policy must reference backends that are of the same type as the original
1777 # backend service matched in the URL map.
1778 #
1779 # Serverless NEG backends are not currently supported as a mirrored
1780 # backend service.
1781 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
1782 },
1783 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
1784 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
1785 # If not specified, defaults to 1.
1786 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
1787 #
1788 # If not specified, will use the timeout set in theHttpRouteAction field.
1789 # If timeout in the HttpRouteAction field is not set, this field
1790 # uses the largest timeout
1791 # among all backend services associated with the route.
1792 #
1793 # Not supported when the URL map is bound to a target gRPC proxy that
1794 # has the validateForProxyless field set to true.
1795 # as a count of seconds and fractions of seconds at nanosecond
1796 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1797 # or &quot;month&quot;. Range is approximately 10,000 years.
1798 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1799 # Durations less than one second are represented with a 0
1800 # `seconds` field and a positive `nanos` field. Must be from 0
1801 # to 999,999,999 inclusive.
1802 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1803 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1804 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1805 },
1806 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
1807 # values are:
1808 #
1809 # - 5xx: retry is attempted if the instance or endpoint
1810 # responds with any 5xx response code, or if the instance or
1811 # endpoint does not respond at all. For example, disconnects, reset, read
1812 # timeout, connection failure, and refused streams.
1813 # - gateway-error: Similar to 5xx, but only
1814 # applies to response codes 502, 503 or504.
1815 # - connect-failure: a retry is attempted on failures
1816 # connecting to the instance or endpoint. For example, connection
1817 # timeouts.
1818 # - retriable-4xx: a retry is attempted if the instance
1819 # or endpoint responds with a 4xx response code.
1820 # The only error that you can retry is error code 409.
1821 # - refused-stream: a retry is attempted if the instance
1822 # or endpoint resets the stream with a REFUSED_STREAM error
1823 # code. This reset type indicates that it is safe to retry.
1824 # - cancelled: a retry is attempted if the gRPC status
1825 # code in the response header is set to cancelled.
1826 # - deadline-exceeded: a retry is attempted if the gRPC
1827 # status code in the response header is set todeadline-exceeded.
1828 # - internal: a retry is attempted if the gRPC
1829 # status code in the response header is set tointernal.
1830 # - resource-exhausted: a retry is attempted if the gRPC
1831 # status code in the response header is set toresource-exhausted.
1832 # - unavailable: a retry is attempted if the gRPC
1833 # status code in the response header is set tounavailable.
1834 #
1835 # Only the following codes are supported when the URL map is bound to
1836 # target gRPC proxy that has validateForProxyless field set to true.
1837 #
1838 # - cancelled
1839 # - deadline-exceeded
1840 # - internal
1841 # - resource-exhausted
1842 # - unavailable
1843 &quot;A String&quot;,
1844 ],
1845 },
1846 &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
1847 # time the request has been fully processed (known as *end-of-stream*)
1848 # up until the response has been processed. Timeout includes
1849 # all retries.
1850 #
1851 # If not specified, this field uses the largest timeout among all backend
1852 # services associated with the route.
1853 #
1854 # Not supported when the URL map is bound to a target gRPC proxy that
1855 # has validateForProxyless field set to true.
1856 # as a count of seconds and fractions of seconds at nanosecond
1857 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1858 # or &quot;month&quot;. Range is approximately 10,000 years.
1859 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1860 # Durations less than one second are represented with a 0
1861 # `seconds` field and a positive `nanos` field. Must be from 0
1862 # to 999,999,999 inclusive.
1863 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1864 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1865 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1866 },
1867 &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
1868 # to the matched service.
1869 #
1870 # urlRewrite is the only action supported in UrlMaps
1871 # for classic Application Load Balancers.
1872 #
1873 # Not supported when the URL map is bound to a target gRPC proxy that
1874 # has the validateForProxyless field set to true.
1875 # backend service.
1876 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
1877 # host header is replaced with contents of hostRewrite.
1878 #
1879 # The value must be from 1 to 255 characters.
1880 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
1881 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
1882 #
1883 # The value must be from 1 to 1024 characters.
1884 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
1885 # header) using the HTTP template syntax.
1886 #
1887 # A corresponding
1888 # path_template_match must be specified. Any template variables must exist in
1889 # the path_template_match field.
1890 #
1891 #
1892 # - -At least one variable must be specified in the path_template_match
1893 # field
1894 # - You can omit variables from the rewritten URL
1895 # - The * and ** operators cannot be matched
1896 # unless they have a corresponding variable name - e.g.
1897 # {format=*} or {var=**}.
1898 #
1899 # For example, a path_template_match of /static/{format=**}
1900 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
1901 # rewrite, so that /{country}/{format}/{suffix=**} can be
1902 # rewritten as /content/{format}/{country}/{suffix}.
1903 #
1904 # At least
1905 # one non-empty routeRules[].matchRules[].path_template_match is
1906 # required.
1907 #
1908 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
1909 },
1910 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
1911 # occurs. The weights determine the fraction of traffic that flows to
1912 # their corresponding backend service. If all traffic needs to
1913 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
1914 #
1915 # After a backend service is identified and before forwarding
1916 # the request to
1917 # the backend service, advanced routing actions such as URL rewrites and
1918 # header transformations are applied depending on additional settings
1919 # specified in this HttpRouteAction.
1920 { # In contrast to a single BackendService in
1921 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
1922 # multiple backend services. The volume of traffic for each
1923 # backend service is proportional to the weight specified
1924 # in each WeightedBackendService
1925 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
1926 # resource. Before
1927 # forwarding the request to backendService, the load balancer
1928 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
1929 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
1930 # effect for the selected backendService.
1931 #
1932 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
1933 #
1934 # headerAction is not supported for load balancers that have
1935 # their loadBalancingScheme set to EXTERNAL.
1936 #
1937 # Not supported when the URL map is bound to a target gRPC proxy that
1938 # has validateForProxyless field set to true.
1939 # the request is passed along to the selected backendService.
1940 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
1941 { # Specification determining how headers are added to requests or responses.
1942 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
1943 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
1944 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
1945 # that already
1946 # exist for the header. If true, headerValue is set for the
1947 # header, discarding any values that were set for that header.
1948 #
1949 # The default value is true,
1950 # unless a variable is present in headerValue,
1951 # in which case the default value is false.
1952 # .
1953 },
1954 ],
1955 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
1956 # request before forwarding the request to the backendService.
1957 &quot;A String&quot;,
1958 ],
1959 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
1960 # client.
1961 { # Specification determining how headers are added to requests or responses.
1962 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
1963 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
1964 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
1965 # that already
1966 # exist for the header. If true, headerValue is set for the
1967 # header, discarding any values that were set for that header.
1968 #
1969 # The default value is true,
1970 # unless a variable is present in headerValue,
1971 # in which case the default value is false.
1972 # .
1973 },
1974 ],
1975 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
1976 # response before sending the response back to the client.
1977 &quot;A String&quot;,
1978 ],
1979 },
1980 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
1981 # computed asweight / (sum of all weightedBackendService weights in routeAction).
1982 #
1983 # The selection of a backend service is determined only for new traffic.
1984 # Once a user&#x27;s request has been directed to a backend service,
1985 # subsequent requests are sent to the same backend service as
1986 # determined by the backend service&#x27;s session affinity policy.
1987 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
1988 # splitting. If you do, the weighted traffic splitting configuration takes
1989 # precedence.
1990 #
1991 # The value must be from 0 to 1000.
1992 },
1993 ],
1994 },
1995 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource. This
1996 # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
1997 # matched. For example, the
1998 # following are all valid URLs to a BackendService resource:
1999 #
2000 #
2001 # - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
2002 # - compute/v1/projects/project/global/backendServices/backendService
2003 # - global/backendServices/backendService
2004 #
2005 #
2006 # If defaultRouteAction is also specified, advanced
2007 # routing actions, such as URL rewrites, take effect before sending the
2008 # request to the backend.
2009 #
2010 #
2011 # Only one of defaultUrlRedirect, defaultService
2012 # or defaultRouteAction.weightedBackendService can be set.
2013 #
2014 #
2015 # Authorization requires one or more of the following Google IAM permissions on the
2016 # specified resource default_service:
2017 #
2018 #
2019 # - compute.backendBuckets.use
2020 # - compute.backendServices.use
2021 &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
2022 # by defaultUrlRedirect.
2023 #
2024 #
2025 # Only one of defaultUrlRedirect, defaultService
2026 # or defaultRouteAction.weightedBackendService can be set.
2027 #
2028 #
2029 # Not supported when the URL map is bound to a target gRPC proxy.
2030 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
2031 # was supplied in the request.
2032 #
2033 # The value must be from 1 to 255
2034 # characters.
2035 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
2036 # set to HTTPS.
2037 # If set to false, the URL scheme of the redirected request
2038 # remains the same as that of the request.
2039 #
2040 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
2041 #
2042 # The default is set to false.
2043 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
2044 # that was supplied in the request.
2045 #
2046 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
2047 # supplied, the path of the original request is used for the redirect.
2048 #
2049 # The value must be from 1 to 1024 characters.
2050 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
2051 # the HttpRouteRuleMatch, retaining the remaining portion
2052 # of the URL before redirecting the request.
2053 #
2054 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
2055 # supplied, the path of the original request is used for the redirect.
2056 #
2057 # The value must be from 1 to 1024 characters.
2058 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
2059 #
2060 # Supported values are:
2061 #
2062 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
2063 # to 301.
2064 # - FOUND, which corresponds to 302.
2065 # - SEE_OTHER which corresponds to 303.
2066 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
2067 # method is retained.
2068 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
2069 # method is retained.
2070 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
2071 # URL is
2072 # removed before redirecting the request. If set to false, the
2073 # query portion of the original URL is retained.
2074 #
2075 # The default is set to false.
2076 },
2077 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
2078 # create the resource.
2079 &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
2080 # for the selected backend service.
2081 #
2082 # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
2083 #
2084 # HeaderAction is not supported for load balancers
2085 # that have
2086 # their loadBalancingScheme set to EXTERNAL.
2087 #
2088 # Not supported when the URL map is bound to a target gRPC proxy that
2089 # has validateForProxyless field set to true.
2090 # the request is passed along to the selected backendService.
2091 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
2092 { # Specification determining how headers are added to requests or responses.
2093 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
2094 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
2095 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
2096 # that already
2097 # exist for the header. If true, headerValue is set for the
2098 # header, discarding any values that were set for that header.
2099 #
2100 # The default value is true,
2101 # unless a variable is present in headerValue,
2102 # in which case the default value is false.
2103 # .
2104 },
2105 ],
2106 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
2107 # request before forwarding the request to the backendService.
2108 &quot;A String&quot;,
2109 ],
2110 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
2111 # client.
2112 { # Specification determining how headers are added to requests or responses.
2113 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
2114 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
2115 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
2116 # that already
2117 # exist for the header. If true, headerValue is set for the
2118 # header, discarding any values that were set for that header.
2119 #
2120 # The default value is true,
2121 # unless a variable is present in headerValue,
2122 # in which case the default value is false.
2123 # .
2124 },
2125 ],
2126 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
2127 # response before sending the response back to the client.
2128 &quot;A String&quot;,
2129 ],
2130 },
2131 &quot;name&quot;: &quot;A String&quot;, # The name to which this PathMatcher is referred by theHostRule.
2132 &quot;pathRules&quot;: [ # The list of path rules. Use this list instead of routeRules
2133 # when routing based on simple path matching is all that&#x27;s required. A path
2134 # rule can only include a wildcard character (*) after a
2135 # forward slash character (&quot;/&quot;).
2136 #
2137 # The order by which path rules are specified does not matter.
2138 # Matches are always done on the longest-path-first basis.
2139 #
2140 # For example: a pathRule with a path /a/b/c/* will match
2141 # before /a/b/* irrespective of the order in which those paths appear in this
2142 # list.
2143 #
2144 # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
2145 { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
2146 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
2147 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
2148 #
2149 # If a policy for an
2150 # error code is not configured for the PathRule, a policy for
2151 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
2152 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
2153 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
2154 # effect.
2155 #
2156 # For example, consider a UrlMap with the following configuration:
2157 #
2158 #
2159 # - UrlMap.defaultCustomErrorResponsePolicy are configured
2160 # with policies for 5xx and 4xx errors
2161 # - A PathRule for /coming_soon/ is configured for the error
2162 # code 404.
2163 #
2164 # 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
2165 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
2166 # the policy in PathRule.customErrorResponsePolicy takes
2167 # effect. If any of the requests in this example encounter a 500
2168 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
2169 #
2170 # customErrorResponsePolicy is supported only for
2171 # global external Application Load Balancers.
2172 # backend service or backend bucket responds with an error.
2173 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
2174 #
2175 # In a given policy, if you specify rules for both a range of error codes
2176 # as well as rules for specific error codes then rules with specific error
2177 # codes have a higher priority. For example, assume that you configure a rule
2178 # for 401 (Un-authorized) code, and another for all 4 series
2179 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
2180 # However if the backend service returns a 403, the rule for4xx takes effect.
2181 { # Specifies the mapping between the response code that will be returned along
2182 # with the custom error content and the response code returned by the backend
2183 # service.
2184 &quot;matchResponseCodes&quot;: [ # Valid values include:
2185 #
2186 #
2187 # - A number between 400 and 599: For example
2188 # 401 or 503, in which case the load balancer
2189 # applies the policy if the error code exactly matches this value.
2190 # - 5xx: Load Balancer will apply the policy if the
2191 # backend service responds with any response code in the range of
2192 # 500 to 599.
2193 # - 4xx: Load
2194 # Balancer will apply the policy if the backend service responds with any
2195 # response code in the range of 400 to
2196 # 499.
2197 #
2198 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
2199 &quot;A String&quot;,
2200 ],
2201 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
2202 # error content. If overrideResponseCode is not supplied, the
2203 # same response code returned by the original backend bucket or backend
2204 # service is returned to the client.
2205 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
2206 #
2207 # path must start
2208 # with a leading slash. path cannot have trailing slashes.
2209 #
2210 # If the file is not available in backendBucket or the
2211 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
2212 #
2213 # The value must
2214 # be from 1 to 1024 characters
2215 },
2216 ],
2217 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
2218 # contains the custom error content. Examples are:
2219 #
2220 #
2221 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
2222 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
2223 # - global/backendBuckets/myBackendBucket
2224 #
2225 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
2226 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
2227 #
2228 # If load balancer cannot reach
2229 # the backendBucket, a simple Not Found Error will
2230 # be returned, with the original response code (oroverrideResponseCode if configured).
2231 #
2232 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
2233 },
2234 &quot;paths&quot;: [ # The list of path patterns to match. Each must start with /
2235 # and the only place a * is allowed is at the end following
2236 # a /. The string fed to the path matcher does not include
2237 # any text after the first ? or #, and
2238 # those chars are not allowed here.
2239 &quot;A String&quot;,
2240 ],
2241 &quot;routeAction&quot;: { # In response to a matching path, the load balancer
2242 # performs advanced routing actions, such as URL rewrites and header
2243 # transformations, before forwarding the request to the selected
2244 # backend.
2245 #
2246 #
2247 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
2248 #
2249 #
2250 # URL maps for classic Application Load Balancers only support
2251 # the urlRewrite action within a path rule&#x27;srouteAction.
2252 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
2253 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
2254 # property must be specified. This policy cannot be specified if any target
2255 # backend has Identity-Aware Proxy enabled.
2256 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
2257 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
2258 # header names can be specified. The cache is bypassed for all `cacheMode`
2259 # values.
2260 &quot;A String&quot;,
2261 ],
2262 &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
2263 # on the backend type: for Backend Services, the complete request URI is
2264 # used; for Backend Buckets, the request URI is used without the protocol or
2265 # host, and only query parameters known to Cloud Storage are included.
2266 # Policy defined on Route Action.
2267 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
2268 # parameters will be included. Either specify `excludedQueryParameters`
2269 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
2270 # encoded and not treated as delimiters.
2271 #
2272 # Note: This field applies to routes that use backend services. Attempting
2273 # to set it on a route that points exclusively to Backend Buckets will
2274 # result in a configuration error. For routes that point to a Backend
2275 # Bucket, use `includedQueryParameters` to define which parameters should
2276 # be part of the cache key.
2277 &quot;A String&quot;,
2278 ],
2279 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
2280 #
2281 # Note: This setting is only applicable to routes that use a Backend
2282 # Service. It does not affect requests served by a Backend Bucket, as the
2283 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
2284 # it on a route that points exclusively to Backend Buckets will result in a
2285 # configuration error.
2286 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
2287 #
2288 # Note: This setting is only applicable to routes that use a Backend
2289 # Service. It does not affect requests served by a Backend Bucket, as the
2290 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
2291 # set on a route that points exclusively to Backend Buckets will result in
2292 # a configuration error.
2293 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
2294 # `includedQueryParameters` and `excludedQueryParameters`. If neither
2295 # is set, the entire query string will be included. If false, the query
2296 # string will be excluded from the cache key entirely.
2297 #
2298 # Note: This field applies to routes that use backend services. Attempting
2299 # to set it on a route that points exclusively to Backend Buckets will
2300 # result in a configuration error. For routes that point to a Backend
2301 # Bucket, use `includedQueryParameters` to define which parameters should
2302 # be part of the cache key.
2303 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
2304 # The name=value pair will be used in the cache key Cloud CDN generates.
2305 #
2306 # Note: This setting is only applicable to routes that use a Backend
2307 # Service. It does not affect requests served by a Backend Bucket.
2308 # Attempting to set it on a route that points exclusively to Backend
2309 # Buckets will result in a configuration error. Up to 5 cookie names can be
2310 # specified.
2311 &quot;A String&quot;,
2312 ],
2313 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
2314 &quot;A String&quot;,
2315 ],
2316 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
2317 # parameters will be excluded. Either specify `includedQueryParameters`
2318 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
2319 # encoded and not treated as delimiters.
2320 &quot;A String&quot;,
2321 ],
2322 },
2323 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
2324 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
2325 &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
2326 # content. This is used to clamp the max-age (or Expires) value sent to the
2327 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
2328 # is used for the response max-age directive, along with a &quot;public&quot;
2329 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
2330 # clamps the max-age from the origin (if specified), or else sets the
2331 # response max-age directive to the lesser of the `clientTtl` and
2332 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
2333 # present. The maximum allowed value is 31,622,400s (1 year). If not
2334 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
2335 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
2336 # `USE_ORIGIN_HEADERS`.
2337 # as a count of seconds and fractions of seconds at nanosecond
2338 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2339 # or &quot;month&quot;. Range is approximately 10,000 years.
2340 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2341 # Durations less than one second are represented with a 0
2342 # `seconds` field and a positive `nanos` field. Must be from 0
2343 # to 999,999,999 inclusive.
2344 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2345 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2346 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2347 },
2348 &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
2349 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
2350 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
2351 # greater than that of `maxTtl`. When the `cacheMode` is set to
2352 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
2353 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
2354 # accessed objects may be evicted from the cache before the defined TTL. If
2355 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
2356 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
2357 # `USE_ORIGIN_HEADERS`.
2358 # as a count of seconds and fractions of seconds at nanosecond
2359 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2360 # or &quot;month&quot;. Range is approximately 10,000 years.
2361 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2362 # Durations less than one second are represented with a 0
2363 # `seconds` field and a positive `nanos` field. Must be from 0
2364 # to 999,999,999 inclusive.
2365 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2366 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2367 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2368 },
2369 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
2370 # attempt to set a max-age or s-maxage higher than this, or an Expires header
2371 # more than `maxTtl` seconds in the future will be capped at the value of
2372 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
2373 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
2374 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
2375 # Infrequently accessed objects may be evicted from the cache before the
2376 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
2377 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
2378 # mode.
2379 # as a count of seconds and fractions of seconds at nanosecond
2380 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2381 # or &quot;month&quot;. Range is approximately 10,000 years.
2382 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2383 # Durations less than one second are represented with a 0
2384 # `seconds` field and a positive `nanos` field. Must be from 0
2385 # to 999,999,999 inclusive.
2386 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2387 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2388 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2389 },
2390 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
2391 # to apply fine-grained caching for common errors or redirects.
2392 # This can reduce the load on your origin and improve end-user
2393 # experience by reducing response latency.
2394 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
2395 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
2396 # the specified response code that lack any Cache-Control, Expires, or
2397 # Pragma: no-cache directives. When the `cacheMode` is set to
2398 # `FORCE_CACHE_ALL`, negative caching applies to all responses
2399 # with the specified response code, and overrides any caching headers. By
2400 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
2401 #
2402 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
2403 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
2404 # * 405 (Method Not Found), 501 (Not Implemented): 60s
2405 #
2406 # These defaults can be overridden in `negativeCachingPolicy`.
2407 # If not specified, Cloud CDN applies negative caching by default.
2408 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
2409 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
2410 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
2411 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
2412 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
2413 # all response codes that you wish to cache. Cloud CDN will not apply any
2414 # default negative caching when a policy exists.
2415 { # Specify CDN TTLs for response error codes.
2416 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
2417 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
2418 # specified as values, and you cannot specify a status code more than
2419 # once.
2420 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
2421 # corresponding status code.
2422 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
2423 # objects may be evicted from the cache before the defined TTL.
2424 # as a count of seconds and fractions of seconds at nanosecond
2425 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2426 # or &quot;month&quot;. Range is approximately 10,000 years.
2427 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2428 # Durations less than one second are represented with a 0
2429 # `seconds` field and a positive `nanos` field. Must be from 0
2430 # to 999,999,999 inclusive.
2431 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2432 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2433 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2434 },
2435 },
2436 ],
2437 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
2438 # requests into a small number of requests to the origin. If not specified,
2439 # Cloud CDN applies request coalescing by default.
2440 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
2441 # content with the origin, or when an error is encountered when refreshing
2442 # the cache.
2443 # This setting defines the default &quot;max-stale&quot; duration for any cached
2444 # responses that do not specify a max-stale directive. Stale responses that
2445 # exceed the TTL configured here will not be served. The default limit
2446 # (max-stale) is 86400s (1 day), which will allow stale content to be
2447 # served up to this limit beyond the max-age (or s-maxage) of a cached
2448 # response.
2449 # The maximum allowed value is 604800 (1 week).
2450 # Set this to zero (0) to disable serve-while-stale.
2451 # as a count of seconds and fractions of seconds at nanosecond
2452 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2453 # or &quot;month&quot;. Range is approximately 10,000 years.
2454 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2455 # Durations less than one second are represented with a 0
2456 # `seconds` field and a positive `nanos` field. Must be from 0
2457 # to 999,999,999 inclusive.
2458 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2459 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2460 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2461 },
2462 },
2463 &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
2464 # information about the W3C recommendation for cross-origin resource sharing
2465 # (CORS), see Fetch API Living
2466 # Standard.
2467 #
2468 # Not supported when the URL map is bound to a target gRPC proxy.
2469 # information about the W3C recommendation for cross-origin resource sharing
2470 # (CORS), see Fetch API Living
2471 # Standard.
2472 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
2473 # indicates that
2474 # the actual request can include user credentials. This field translates to
2475 # the Access-Control-Allow-Credentials header.
2476 #
2477 # Default is false.
2478 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
2479 # header.
2480 &quot;A String&quot;,
2481 ],
2482 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
2483 # header.
2484 &quot;A String&quot;,
2485 ],
2486 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
2487 # more information, see regular expression syntax.
2488 #
2489 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
2490 #
2491 # Regular expressions can only be used when the loadBalancingScheme is
2492 # set to INTERNAL_SELF_MANAGED.
2493 &quot;A String&quot;,
2494 ],
2495 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
2496 #
2497 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
2498 &quot;A String&quot;,
2499 ],
2500 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
2501 # The default value is false, which indicates that the CORS
2502 # policy is in effect.
2503 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
2504 # header.
2505 &quot;A String&quot;,
2506 ],
2507 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
2508 # seconds. This field translates to the Access-Control-Max-Age
2509 # header.
2510 },
2511 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
2512 # the resiliency of clients to backend service failure. As part of fault
2513 # injection, when clients send requests to a backend service, delays can be
2514 # introduced by a load balancer on a percentage of requests before sending
2515 # those requests to the backend service. Similarly requests from clients can
2516 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
2517 # that are configured with a fault_injection_policy if:
2518 # 1. The traffic is generated by fault injection AND
2519 # 2. The fault injection is not a delay fault injection.
2520 # Fault injection is not supported with the classic Application Load Balancer
2521 # . To see which load balancers support fault injection,
2522 # see Load
2523 # balancing: Routing and traffic management features.
2524 # the resiliency of clients to backend service failure. As part of fault
2525 # injection, when clients send requests to a backend service, delays can be
2526 # introduced by the load balancer on a percentage of requests before sending
2527 # those request to the backend service. Similarly requests from clients can be
2528 # aborted by the load balancer for a percentage of requests.
2529 &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
2530 # injection.
2531 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
2532 #
2533 # The value must be from 200 to 599 inclusive.
2534 #
2535 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
2536 # according to this
2537 # mapping table. HTTP status 200 is mapped to gRPC status
2538 # UNKNOWN. Injecting an OK status is currently not supported by
2539 # Traffic Director.
2540 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
2541 # that is aborted as part of fault injection.
2542 #
2543 # The value must be from 0.0 to 100.0 inclusive.
2544 },
2545 &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
2546 # injection, before being sent to a backend service.
2547 # request to the backend service as part of fault injection.
2548 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
2549 # as a count of seconds and fractions of seconds at nanosecond
2550 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2551 # or &quot;month&quot;. Range is approximately 10,000 years.
2552 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2553 # Durations less than one second are represented with a 0
2554 # `seconds` field and a positive `nanos` field. Must be from 0
2555 # to 999,999,999 inclusive.
2556 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2557 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2558 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2559 },
2560 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
2561 # which a delay is introduced as part of fault injection.
2562 #
2563 # The value must be from 0.0 to 100.0 inclusive.
2564 },
2565 },
2566 &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
2567 # Global EXTERNAL_MANAGED load balancer schemes.
2568 # Either Cloud CDN must be enabled on the backend service or backend bucket
2569 # serving the route, or cache policy must be configured on the same route
2570 # dynamically processes and delivers images from the network edge.
2571 # Image Optimization is only available for Global External Application Load
2572 # Balancers.
2573 # Either Cloud CDN must be enabled on the backend service or backend bucket
2574 # serving the route, or cache policy must be configured on the same route.
2575 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
2576 },
2577 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
2578 # Unlike the timeout field where the timeout duration starts
2579 # from the time the request has been fully processed (known as*end-of-stream*),
2580 # the duration in this field is computed from the beginning of the stream
2581 # until the response has been processed, including all retries. A
2582 # stream that does not complete in this duration is closed.
2583 #
2584 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
2585 # with the route.
2586 #
2587 # This field is only allowed if the Url map is used with backend services
2588 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
2589 # as a count of seconds and fractions of seconds at nanosecond
2590 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2591 # or &quot;month&quot;. Range is approximately 10,000 years.
2592 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2593 # Durations less than one second are represented with a 0
2594 # `seconds` field and a positive `nanos` field. Must be from 0
2595 # to 999,999,999 inclusive.
2596 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2597 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2598 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2599 },
2600 &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
2601 # are shadowed to a separate mirrored backend service. The load balancer does
2602 # not wait for responses from the shadow service. Before sending traffic
2603 # to the shadow service, the host / authority header is suffixed with-shadow.
2604 #
2605 # Not supported when the URL map is bound to a target gRPC proxy that
2606 # has the validateForProxyless field set to true.
2607 # are shadowed to a separate mirrored backend service. The load balancer
2608 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
2609 # to the shadow service, the host or authority header is suffixed with-shadow.
2610 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
2611 # mirrored to.
2612 #
2613 # The backend service configured for a mirroring
2614 # policy must reference backends that are of the same type as the original
2615 # backend service matched in the URL map.
2616 #
2617 # Serverless NEG backends are not currently supported as a mirrored
2618 # backend service.
2619 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
2620 },
2621 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
2622 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
2623 # If not specified, defaults to 1.
2624 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
2625 #
2626 # If not specified, will use the timeout set in theHttpRouteAction field.
2627 # If timeout in the HttpRouteAction field is not set, this field
2628 # uses the largest timeout
2629 # among all backend services associated with the route.
2630 #
2631 # Not supported when the URL map is bound to a target gRPC proxy that
2632 # has the validateForProxyless field set to true.
2633 # as a count of seconds and fractions of seconds at nanosecond
2634 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2635 # or &quot;month&quot;. Range is approximately 10,000 years.
2636 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2637 # Durations less than one second are represented with a 0
2638 # `seconds` field and a positive `nanos` field. Must be from 0
2639 # to 999,999,999 inclusive.
2640 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2641 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2642 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2643 },
2644 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
2645 # values are:
2646 #
2647 # - 5xx: retry is attempted if the instance or endpoint
2648 # responds with any 5xx response code, or if the instance or
2649 # endpoint does not respond at all. For example, disconnects, reset, read
2650 # timeout, connection failure, and refused streams.
2651 # - gateway-error: Similar to 5xx, but only
2652 # applies to response codes 502, 503 or504.
2653 # - connect-failure: a retry is attempted on failures
2654 # connecting to the instance or endpoint. For example, connection
2655 # timeouts.
2656 # - retriable-4xx: a retry is attempted if the instance
2657 # or endpoint responds with a 4xx response code.
2658 # The only error that you can retry is error code 409.
2659 # - refused-stream: a retry is attempted if the instance
2660 # or endpoint resets the stream with a REFUSED_STREAM error
2661 # code. This reset type indicates that it is safe to retry.
2662 # - cancelled: a retry is attempted if the gRPC status
2663 # code in the response header is set to cancelled.
2664 # - deadline-exceeded: a retry is attempted if the gRPC
2665 # status code in the response header is set todeadline-exceeded.
2666 # - internal: a retry is attempted if the gRPC
2667 # status code in the response header is set tointernal.
2668 # - resource-exhausted: a retry is attempted if the gRPC
2669 # status code in the response header is set toresource-exhausted.
2670 # - unavailable: a retry is attempted if the gRPC
2671 # status code in the response header is set tounavailable.
2672 #
2673 # Only the following codes are supported when the URL map is bound to
2674 # target gRPC proxy that has validateForProxyless field set to true.
2675 #
2676 # - cancelled
2677 # - deadline-exceeded
2678 # - internal
2679 # - resource-exhausted
2680 # - unavailable
2681 &quot;A String&quot;,
2682 ],
2683 },
2684 &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
2685 # time the request has been fully processed (known as *end-of-stream*)
2686 # up until the response has been processed. Timeout includes
2687 # all retries.
2688 #
2689 # If not specified, this field uses the largest timeout among all backend
2690 # services associated with the route.
2691 #
2692 # Not supported when the URL map is bound to a target gRPC proxy that
2693 # has validateForProxyless field set to true.
2694 # as a count of seconds and fractions of seconds at nanosecond
2695 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2696 # or &quot;month&quot;. Range is approximately 10,000 years.
2697 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2698 # Durations less than one second are represented with a 0
2699 # `seconds` field and a positive `nanos` field. Must be from 0
2700 # to 999,999,999 inclusive.
2701 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2702 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2703 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2704 },
2705 &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
2706 # to the matched service.
2707 #
2708 # urlRewrite is the only action supported in UrlMaps
2709 # for classic Application Load Balancers.
2710 #
2711 # Not supported when the URL map is bound to a target gRPC proxy that
2712 # has the validateForProxyless field set to true.
2713 # backend service.
2714 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
2715 # host header is replaced with contents of hostRewrite.
2716 #
2717 # The value must be from 1 to 255 characters.
2718 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
2719 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
2720 #
2721 # The value must be from 1 to 1024 characters.
2722 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
2723 # header) using the HTTP template syntax.
2724 #
2725 # A corresponding
2726 # path_template_match must be specified. Any template variables must exist in
2727 # the path_template_match field.
2728 #
2729 #
2730 # - -At least one variable must be specified in the path_template_match
2731 # field
2732 # - You can omit variables from the rewritten URL
2733 # - The * and ** operators cannot be matched
2734 # unless they have a corresponding variable name - e.g.
2735 # {format=*} or {var=**}.
2736 #
2737 # For example, a path_template_match of /static/{format=**}
2738 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
2739 # rewrite, so that /{country}/{format}/{suffix=**} can be
2740 # rewritten as /content/{format}/{country}/{suffix}.
2741 #
2742 # At least
2743 # one non-empty routeRules[].matchRules[].path_template_match is
2744 # required.
2745 #
2746 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
2747 },
2748 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
2749 # occurs. The weights determine the fraction of traffic that flows to
2750 # their corresponding backend service. If all traffic needs to
2751 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
2752 #
2753 # After a backend service is identified and before forwarding
2754 # the request to
2755 # the backend service, advanced routing actions such as URL rewrites and
2756 # header transformations are applied depending on additional settings
2757 # specified in this HttpRouteAction.
2758 { # In contrast to a single BackendService in
2759 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
2760 # multiple backend services. The volume of traffic for each
2761 # backend service is proportional to the weight specified
2762 # in each WeightedBackendService
2763 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
2764 # resource. Before
2765 # forwarding the request to backendService, the load balancer
2766 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
2767 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
2768 # effect for the selected backendService.
2769 #
2770 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
2771 #
2772 # headerAction is not supported for load balancers that have
2773 # their loadBalancingScheme set to EXTERNAL.
2774 #
2775 # Not supported when the URL map is bound to a target gRPC proxy that
2776 # has validateForProxyless field set to true.
2777 # the request is passed along to the selected backendService.
2778 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
2779 { # Specification determining how headers are added to requests or responses.
2780 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
2781 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
2782 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
2783 # that already
2784 # exist for the header. If true, headerValue is set for the
2785 # header, discarding any values that were set for that header.
2786 #
2787 # The default value is true,
2788 # unless a variable is present in headerValue,
2789 # in which case the default value is false.
2790 # .
2791 },
2792 ],
2793 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
2794 # request before forwarding the request to the backendService.
2795 &quot;A String&quot;,
2796 ],
2797 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
2798 # client.
2799 { # Specification determining how headers are added to requests or responses.
2800 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
2801 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
2802 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
2803 # that already
2804 # exist for the header. If true, headerValue is set for the
2805 # header, discarding any values that were set for that header.
2806 #
2807 # The default value is true,
2808 # unless a variable is present in headerValue,
2809 # in which case the default value is false.
2810 # .
2811 },
2812 ],
2813 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
2814 # response before sending the response back to the client.
2815 &quot;A String&quot;,
2816 ],
2817 },
2818 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
2819 # computed asweight / (sum of all weightedBackendService weights in routeAction).
2820 #
2821 # The selection of a backend service is determined only for new traffic.
2822 # Once a user&#x27;s request has been directed to a backend service,
2823 # subsequent requests are sent to the same backend service as
2824 # determined by the backend service&#x27;s session affinity policy.
2825 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
2826 # splitting. If you do, the weighted traffic splitting configuration takes
2827 # precedence.
2828 #
2829 # The value must be from 0 to 1000.
2830 },
2831 ],
2832 },
2833 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
2834 # is directed if this rule is matched. If routeAction is
2835 # also specified, advanced routing actions, such as URL rewrites,
2836 # take effect before sending the request to the backend.
2837 #
2838 #
2839 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
2840 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
2841 # specified by urlRedirect.
2842 #
2843 #
2844 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
2845 #
2846 #
2847 # Not supported when the URL map is bound to a target gRPC proxy.
2848 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
2849 # was supplied in the request.
2850 #
2851 # The value must be from 1 to 255
2852 # characters.
2853 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
2854 # set to HTTPS.
2855 # If set to false, the URL scheme of the redirected request
2856 # remains the same as that of the request.
2857 #
2858 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
2859 #
2860 # The default is set to false.
2861 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
2862 # that was supplied in the request.
2863 #
2864 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
2865 # supplied, the path of the original request is used for the redirect.
2866 #
2867 # The value must be from 1 to 1024 characters.
2868 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
2869 # the HttpRouteRuleMatch, retaining the remaining portion
2870 # of the URL before redirecting the request.
2871 #
2872 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
2873 # supplied, the path of the original request is used for the redirect.
2874 #
2875 # The value must be from 1 to 1024 characters.
2876 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
2877 #
2878 # Supported values are:
2879 #
2880 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
2881 # to 301.
2882 # - FOUND, which corresponds to 302.
2883 # - SEE_OTHER which corresponds to 303.
2884 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
2885 # method is retained.
2886 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
2887 # method is retained.
2888 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
2889 # URL is
2890 # removed before redirecting the request. If set to false, the
2891 # query portion of the original URL is retained.
2892 #
2893 # The default is set to false.
2894 },
2895 },
2896 ],
2897 &quot;routeRules&quot;: [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
2898 # desired. routeRules are evaluated in order of priority, from
2899 # the lowest to highest number.
2900 #
2901 # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
2902 { # The HttpRouteRule setting specifies how to match an HTTP request
2903 # and the corresponding routing action that load balancing proxies perform.
2904 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
2905 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
2906 #
2907 # If a policy for an
2908 # error code is not configured for the RouteRule, a policy for
2909 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
2910 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
2911 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
2912 # effect.
2913 #
2914 # For example, consider a UrlMap with the following configuration:
2915 #
2916 #
2917 # - UrlMap.defaultCustomErrorResponsePolicy are configured
2918 # with policies for 5xx and 4xx errors
2919 # - A RouteRule for /coming_soon/ is configured for the
2920 # error code 404.
2921 #
2922 # 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
2923 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
2924 # the policy in RouteRule.customErrorResponsePolicy takes
2925 # effect. If any of the requests in this example encounter a 500
2926 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
2927 #
2928 # When
2929 # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
2930 # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
2931 # a retry, if load balancer is successful in reaching the
2932 # service, the customErrorResponsePolicy is ignored and
2933 # the response from the service is returned to the client.
2934 #
2935 # customErrorResponsePolicy is supported only for
2936 # global external Application Load Balancers.
2937 # backend service or backend bucket responds with an error.
2938 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
2939 #
2940 # In a given policy, if you specify rules for both a range of error codes
2941 # as well as rules for specific error codes then rules with specific error
2942 # codes have a higher priority. For example, assume that you configure a rule
2943 # for 401 (Un-authorized) code, and another for all 4 series
2944 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
2945 # However if the backend service returns a 403, the rule for4xx takes effect.
2946 { # Specifies the mapping between the response code that will be returned along
2947 # with the custom error content and the response code returned by the backend
2948 # service.
2949 &quot;matchResponseCodes&quot;: [ # Valid values include:
2950 #
2951 #
2952 # - A number between 400 and 599: For example
2953 # 401 or 503, in which case the load balancer
2954 # applies the policy if the error code exactly matches this value.
2955 # - 5xx: Load Balancer will apply the policy if the
2956 # backend service responds with any response code in the range of
2957 # 500 to 599.
2958 # - 4xx: Load
2959 # Balancer will apply the policy if the backend service responds with any
2960 # response code in the range of 400 to
2961 # 499.
2962 #
2963 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
2964 &quot;A String&quot;,
2965 ],
2966 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
2967 # error content. If overrideResponseCode is not supplied, the
2968 # same response code returned by the original backend bucket or backend
2969 # service is returned to the client.
2970 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
2971 #
2972 # path must start
2973 # with a leading slash. path cannot have trailing slashes.
2974 #
2975 # If the file is not available in backendBucket or the
2976 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
2977 #
2978 # The value must
2979 # be from 1 to 1024 characters
2980 },
2981 ],
2982 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
2983 # contains the custom error content. Examples are:
2984 #
2985 #
2986 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
2987 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
2988 # - global/backendBuckets/myBackendBucket
2989 #
2990 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
2991 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
2992 #
2993 # If load balancer cannot reach
2994 # the backendBucket, a simple Not Found Error will
2995 # be returned, with the original response code (oroverrideResponseCode if configured).
2996 #
2997 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
2998 },
2999 &quot;description&quot;: &quot;A String&quot;, # The short description conveying the intent of this routeRule.
3000 #
3001 #
3002 # The description can have a maximum length of 1024 characters.
3003 &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
3004 # for the selected backendService.
3005 #
3006 # The headerAction value specified here is applied before the
3007 # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
3008 #
3009 # HeaderAction is not supported for load balancers
3010 # that have
3011 # their loadBalancingScheme set to EXTERNAL.
3012 #
3013 # Not supported when the URL map is bound to a target gRPC proxy that
3014 # has validateForProxyless field set to true.
3015 # the request is passed along to the selected backendService.
3016 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
3017 { # Specification determining how headers are added to requests or responses.
3018 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
3019 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
3020 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
3021 # that already
3022 # exist for the header. If true, headerValue is set for the
3023 # header, discarding any values that were set for that header.
3024 #
3025 # The default value is true,
3026 # unless a variable is present in headerValue,
3027 # in which case the default value is false.
3028 # .
3029 },
3030 ],
3031 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
3032 # request before forwarding the request to the backendService.
3033 &quot;A String&quot;,
3034 ],
3035 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
3036 # client.
3037 { # Specification determining how headers are added to requests or responses.
3038 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
3039 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
3040 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
3041 # that already
3042 # exist for the header. If true, headerValue is set for the
3043 # header, discarding any values that were set for that header.
3044 #
3045 # The default value is true,
3046 # unless a variable is present in headerValue,
3047 # in which case the default value is false.
3048 # .
3049 },
3050 ],
3051 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
3052 # response before sending the response back to the client.
3053 &quot;A String&quot;,
3054 ],
3055 },
3056 &quot;httpFilterConfigs&quot;: [ # Outbound route specific configuration fornetworkservices.HttpFilter resources enabled by Traffic
3057 # Director. httpFilterConfigs only applies for load balancers
3058 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
3059 # more details.
3060 #
3061 # Not supported when the URL map is bound to a target gRPC proxy that
3062 # has validateForProxyless field set to true.
3063 { # HttpFilterConfiguration supplies additional contextual settings
3064 # for networkservices.HttpFilter resources enabled by Traffic
3065 # Director.
3066 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
3067 # YAML formatted and only contain fields defined in the protobuf identified
3068 # in configTypeUrl
3069 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
3070 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
3071 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
3072 # configuration belongs to. This name must be known to the xDS client.
3073 # Example: envoy.wasm
3074 },
3075 ],
3076 &quot;httpFilterMetadata&quot;: [ # Outbound route specific metadata supplied tonetworkservices.HttpFilter resources enabled by Traffic
3077 # Director. httpFilterMetadata only applies for load balancers
3078 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
3079 # more details.
3080 #
3081 # The only configTypeUrl supported istype.googleapis.com/google.protobuf.Struct
3082 #
3083 # Not supported when the URL map is bound to a target gRPC proxy that
3084 # has validateForProxyless field set to true.
3085 { # HttpFilterConfiguration supplies additional contextual settings
3086 # for networkservices.HttpFilter resources enabled by Traffic
3087 # Director.
3088 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
3089 # YAML formatted and only contain fields defined in the protobuf identified
3090 # in configTypeUrl
3091 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
3092 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
3093 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
3094 # configuration belongs to. This name must be known to the xDS client.
3095 # Example: envoy.wasm
3096 },
3097 ],
3098 &quot;matchRules&quot;: [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
3099 # this routeRule when any of thematchRules are satisfied. However predicates within
3100 # a given matchRule have AND semantics. All predicates
3101 # within a matchRule must match for the request to
3102 # match the rule.
3103 { # HttpRouteRuleMatch specifies a set of criteria for matching
3104 # requests to an HttpRouteRule. All specified criteria must
3105 # be satisfied for a match to occur.
3106 &quot;fullPathMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
3107 # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
3108 # that may be part of the original URL.
3109 #
3110 # fullPathMatch must be from 1 to 1024 characters.
3111 #
3112 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
3113 # specified.
3114 &quot;headerMatches&quot;: [ # Specifies a list of header match criteria, all of which must match
3115 # corresponding headers in the request.
3116 { # matchRule criteria for request header matches.
3117 &quot;exactMatch&quot;: &quot;A String&quot;, # The value should exactly match contents of exactMatch.
3118 #
3119 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
3120 &quot;headerName&quot;: &quot;A String&quot;, # The name of the HTTP header to match.
3121 #
3122 # For matching against the HTTP request&#x27;s authority, use a headerMatch
3123 # with the header name &quot;:authority&quot;.
3124 #
3125 # For matching a request&#x27;s method, use the headerName &quot;:method&quot;.
3126 #
3127 # When the URL map is bound to a target gRPC proxy that has
3128 # the validateForProxyless field set to true, only
3129 # non-binary
3130 # user-specified custom metadata and the `content-type` header are supported.
3131 # The following transport-level headers cannot be used in header matching
3132 # rules:
3133 # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
3134 # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
3135 # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
3136 # `grpc-timeout` and `grpc-trace-bin`.
3137 &quot;invertMatch&quot;: True or False, # If set to false, the headerMatch is considered a
3138 # match if the preceding match criteria are met. If set to true,
3139 # the headerMatch is considered a match if the preceding
3140 # match criteria are NOT met.
3141 #
3142 # The default setting is false.
3143 &quot;prefixMatch&quot;: &quot;A String&quot;, # The value of the header must start with the contents ofprefixMatch.
3144 #
3145 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
3146 &quot;presentMatch&quot;: True or False, # A header with the contents of headerName must exist. The
3147 # match takes place whether or not the request&#x27;s header has a value.
3148 #
3149 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
3150 &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
3151 # specified in rangeMatch. If the header does not contain an
3152 # integer, number or is empty, the match fails.
3153 #
3154 # For example for a range [-5, 0]
3155 #
3156 #
3157 # - -3 will match.
3158 # - 0 will not match.
3159 # - 0.25 will not match.
3160 # - -3someString will not match.
3161 #
3162 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
3163 #
3164 # rangeMatch is not supported for load balancers
3165 # that have loadBalancingScheme set to EXTERNAL.
3166 # within the specified integer range.
3167 &quot;rangeEnd&quot;: &quot;A String&quot;, # The end of the range (exclusive) in signed long integer format.
3168 &quot;rangeStart&quot;: &quot;A String&quot;, # The start of the range (inclusive) in signed long integer format.
3169 },
3170 &quot;regexMatch&quot;: &quot;A String&quot;, # The value of the header must match the regular expression specified inregexMatch.
3171 # For more information about regular expression syntax, see Syntax.
3172 #
3173 # For matching against a port specified in the HTTP request, use a
3174 # headerMatch with headerName set to PORT and a regular expression that
3175 # satisfies the RFC2616 Host header&#x27;s port specifier.
3176 #
3177 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
3178 #
3179 # Regular expressions can only be used when the loadBalancingScheme is
3180 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
3181 # (regional scope) or INTERNAL_MANAGED.
3182 &quot;suffixMatch&quot;: &quot;A String&quot;, # The value of the header must end with the contents ofsuffixMatch.
3183 #
3184 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
3185 },
3186 ],
3187 &quot;ignoreCase&quot;: True or False, # Specifies that prefixMatch and fullPathMatch
3188 # matches are case sensitive.
3189 #
3190 # The default value is false.
3191 #
3192 # ignoreCase must not be used with regexMatch.
3193 #
3194 # Not supported when the URL map is bound to a target gRPC proxy.
3195 &quot;metadataFilters&quot;: [ # Opaque filter criteria used by the load balancer to restrict routing
3196 # configuration to a limited set of xDS
3197 # compliant clients. In their xDS requests to the load balancer, xDS clients
3198 # present node
3199 # metadata. When there is a match, the relevant routing configuration
3200 # is made available to those proxies.
3201 #
3202 # 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
3203 # the metadata. If its filterMatchCriteria is set to
3204 # MATCH_ALL, then all of its filterLabels must match with
3205 # corresponding labels provided in the metadata. If multiple
3206 # metadata filters are specified, all of them need to be
3207 # satisfied in order to be considered a match.
3208 #
3209 # metadataFilters specified here is applied after those
3210 # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
3211 #
3212 # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
3213 #
3214 # Not supported when the URL map is bound to a target gRPC proxy that
3215 # has validateForProxyless field set to true.
3216 { # Opaque filter criteria used by load balancers to restrict routing
3217 # configuration to a limited set of load balancing proxies. Proxies and
3218 # sidecars involved in load balancing would typically present metadata to the
3219 # load balancers that need to match criteria specified here. If a match takes
3220 # place, the relevant configuration is made available to those
3221 # proxies.
3222 #
3223 # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
3224 # one of thefilterLabels must match the corresponding label provided in
3225 # the metadata. If its filterMatchCriteria is set to
3226 # MATCH_ALL, then all of its filterLabels must match with
3227 # corresponding labels provided in the metadata.
3228 #
3229 # An example for using metadataFilters would be: if
3230 # load balancing involves
3231 # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in of their XDS requests to loadbalancers.
3232 &quot;filterLabels&quot;: [ # The list of label value pairs that must match labels in the provided
3233 # metadata based on filterMatchCriteria
3234 #
3235 # This list must not be empty and can have at the most 64 entries.
3236 { # MetadataFilter label name value pairs that are expected
3237 # to match corresponding labels presented as metadata to the load balancer.
3238 &quot;name&quot;: &quot;A String&quot;, # Name of metadata label.
3239 #
3240 # The name can have a maximum length of 1024 characters and must be at
3241 # least 1 character long.
3242 &quot;value&quot;: &quot;A String&quot;, # The value of the label must match the specified value.
3243 #
3244 # value can have a maximum length of 1024 characters.
3245 },
3246 ],
3247 &quot;filterMatchCriteria&quot;: &quot;A String&quot;, # Specifies how individual filter label matches
3248 # within the list of filterLabels and contributes toward the
3249 # overall metadataFilter match.
3250 #
3251 # Supported values are:
3252 #
3253 # - MATCH_ANY: at least one of the filterLabels
3254 # must have a matching label in the provided metadata.
3255 # - MATCH_ALL: all filterLabels must have
3256 # matching labels in the provided metadata.
3257 },
3258 ],
3259 &quot;pathTemplateMatch&quot;: &quot;A String&quot;, # If specified, this field defines a path template pattern that must match
3260 # the :path header after the query string is removed.
3261 #
3262 # A path template pattern can include variables and wildcards.
3263 # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
3264 # matches a single path segment, and ** that matches zero or
3265 # more path segments. The pattern must follow these rules:
3266 #
3267 #
3268 # - The value must be between 1 and 1024 characters.
3269 # - The pattern must start with a leading slash (&quot;/&quot;).
3270 # - No more than 5 operators (variables or wildcards) may appear in
3271 # the pattern.
3272 #
3273 # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
3274 # set.
3275 &quot;prefixMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the request&#x27;s
3276 # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
3277 #
3278 # The value must be from 1 to 1024 characters.
3279 #
3280 # The * character inside a prefix match is
3281 # treated as a literal character, not as a wildcard.
3282 #
3283 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
3284 # used within a matchRule.
3285 &quot;queryParameterMatches&quot;: [ # Specifies a list of query parameter match criteria, all of which must
3286 # match corresponding query parameters in the request.
3287 #
3288 # Not supported when the URL map is bound to a target gRPC proxy.
3289 { # HttpRouteRuleMatch criteria for a request&#x27;s query parameter.
3290 &quot;exactMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
3291 # parameter exactly matches the contents of exactMatch.
3292 #
3293 # Only one of presentMatch, exactMatch, orregexMatch must be set.
3294 &quot;name&quot;: &quot;A String&quot;, # The name of the query parameter to match. The query parameter must exist in
3295 # the request, in the absence of which the request match fails.
3296 &quot;presentMatch&quot;: True or False, # Specifies that the queryParameterMatch matches if the
3297 # request contains the query parameter, irrespective of whether the
3298 # parameter has a value or not.
3299 #
3300 # Only one of presentMatch, exactMatch, orregexMatch must be set.
3301 &quot;regexMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
3302 # parameter matches the regular expression specified byregexMatch. For
3303 # more information about regular expression syntax, see Syntax.
3304 #
3305 # Only one of presentMatch, exactMatch, orregexMatch must be set.
3306 #
3307 # Regular expressions can only be used when the loadBalancingScheme is
3308 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
3309 # (regional scope) or INTERNAL_MANAGED.
3310 },
3311 ],
3312 &quot;regexMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
3313 # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
3314 # supplied with the original URL. For
3315 # more information about regular expression syntax, see Syntax.
3316 #
3317 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
3318 # specified.
3319 #
3320 # Regular expressions can only be used when the loadBalancingScheme is
3321 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
3322 # (regional scope) or INTERNAL_MANAGED.
3323 },
3324 ],
3325 &quot;priority&quot;: 42, # For routeRules within a given pathMatcher,
3326 # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
3327 # of priority, from the lowest to highest number. The priority of a
3328 # rule decreases as its number increases (1, 2, 3, N+1). The first rule
3329 # that matches the request is applied.
3330 #
3331 #
3332 # You cannot configure two or more routeRules with the same priority.
3333 # Priority for each rule must be set to a number from 0 to 2147483647
3334 # inclusive.
3335 #
3336 #
3337 # Priority numbers can have gaps, which enable you to add or remove rules
3338 # in the future without affecting the rest of the rules. For example, 1, 2,
3339 # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
3340 # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
3341 # without any impact on existing rules.
3342 &quot;routeAction&quot;: { # In response to a matching matchRule, the load balancer
3343 # performs advanced routing actions, such as URL rewrites and header
3344 # transformations, before forwarding the request to the selected backend.
3345 #
3346 #
3347 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
3348 #
3349 #
3350 # URL maps for classic Application Load Balancers only support
3351 # the urlRewrite action within a route rule&#x27;srouteAction.
3352 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
3353 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
3354 # property must be specified. This policy cannot be specified if any target
3355 # backend has Identity-Aware Proxy enabled.
3356 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
3357 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
3358 # header names can be specified. The cache is bypassed for all `cacheMode`
3359 # values.
3360 &quot;A String&quot;,
3361 ],
3362 &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
3363 # on the backend type: for Backend Services, the complete request URI is
3364 # used; for Backend Buckets, the request URI is used without the protocol or
3365 # host, and only query parameters known to Cloud Storage are included.
3366 # Policy defined on Route Action.
3367 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
3368 # parameters will be included. Either specify `excludedQueryParameters`
3369 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
3370 # encoded and not treated as delimiters.
3371 #
3372 # Note: This field applies to routes that use backend services. Attempting
3373 # to set it on a route that points exclusively to Backend Buckets will
3374 # result in a configuration error. For routes that point to a Backend
3375 # Bucket, use `includedQueryParameters` to define which parameters should
3376 # be part of the cache key.
3377 &quot;A String&quot;,
3378 ],
3379 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
3380 #
3381 # Note: This setting is only applicable to routes that use a Backend
3382 # Service. It does not affect requests served by a Backend Bucket, as the
3383 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
3384 # it on a route that points exclusively to Backend Buckets will result in a
3385 # configuration error.
3386 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
3387 #
3388 # Note: This setting is only applicable to routes that use a Backend
3389 # Service. It does not affect requests served by a Backend Bucket, as the
3390 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
3391 # set on a route that points exclusively to Backend Buckets will result in
3392 # a configuration error.
3393 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
3394 # `includedQueryParameters` and `excludedQueryParameters`. If neither
3395 # is set, the entire query string will be included. If false, the query
3396 # string will be excluded from the cache key entirely.
3397 #
3398 # Note: This field applies to routes that use backend services. Attempting
3399 # to set it on a route that points exclusively to Backend Buckets will
3400 # result in a configuration error. For routes that point to a Backend
3401 # Bucket, use `includedQueryParameters` to define which parameters should
3402 # be part of the cache key.
3403 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
3404 # The name=value pair will be used in the cache key Cloud CDN generates.
3405 #
3406 # Note: This setting is only applicable to routes that use a Backend
3407 # Service. It does not affect requests served by a Backend Bucket.
3408 # Attempting to set it on a route that points exclusively to Backend
3409 # Buckets will result in a configuration error. Up to 5 cookie names can be
3410 # specified.
3411 &quot;A String&quot;,
3412 ],
3413 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
3414 &quot;A String&quot;,
3415 ],
3416 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
3417 # parameters will be excluded. Either specify `includedQueryParameters`
3418 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
3419 # encoded and not treated as delimiters.
3420 &quot;A String&quot;,
3421 ],
3422 },
3423 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
3424 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
3425 &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
3426 # content. This is used to clamp the max-age (or Expires) value sent to the
3427 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
3428 # is used for the response max-age directive, along with a &quot;public&quot;
3429 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
3430 # clamps the max-age from the origin (if specified), or else sets the
3431 # response max-age directive to the lesser of the `clientTtl` and
3432 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
3433 # present. The maximum allowed value is 31,622,400s (1 year). If not
3434 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
3435 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
3436 # `USE_ORIGIN_HEADERS`.
3437 # as a count of seconds and fractions of seconds at nanosecond
3438 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3439 # or &quot;month&quot;. Range is approximately 10,000 years.
3440 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3441 # Durations less than one second are represented with a 0
3442 # `seconds` field and a positive `nanos` field. Must be from 0
3443 # to 999,999,999 inclusive.
3444 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3445 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3446 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3447 },
3448 &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
3449 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
3450 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
3451 # greater than that of `maxTtl`. When the `cacheMode` is set to
3452 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
3453 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
3454 # accessed objects may be evicted from the cache before the defined TTL. If
3455 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
3456 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
3457 # `USE_ORIGIN_HEADERS`.
3458 # as a count of seconds and fractions of seconds at nanosecond
3459 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3460 # or &quot;month&quot;. Range is approximately 10,000 years.
3461 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3462 # Durations less than one second are represented with a 0
3463 # `seconds` field and a positive `nanos` field. Must be from 0
3464 # to 999,999,999 inclusive.
3465 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3466 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3467 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3468 },
3469 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
3470 # attempt to set a max-age or s-maxage higher than this, or an Expires header
3471 # more than `maxTtl` seconds in the future will be capped at the value of
3472 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
3473 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
3474 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
3475 # Infrequently accessed objects may be evicted from the cache before the
3476 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
3477 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
3478 # mode.
3479 # as a count of seconds and fractions of seconds at nanosecond
3480 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3481 # or &quot;month&quot;. Range is approximately 10,000 years.
3482 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3483 # Durations less than one second are represented with a 0
3484 # `seconds` field and a positive `nanos` field. Must be from 0
3485 # to 999,999,999 inclusive.
3486 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3487 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3488 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3489 },
3490 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
3491 # to apply fine-grained caching for common errors or redirects.
3492 # This can reduce the load on your origin and improve end-user
3493 # experience by reducing response latency.
3494 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
3495 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
3496 # the specified response code that lack any Cache-Control, Expires, or
3497 # Pragma: no-cache directives. When the `cacheMode` is set to
3498 # `FORCE_CACHE_ALL`, negative caching applies to all responses
3499 # with the specified response code, and overrides any caching headers. By
3500 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
3501 #
3502 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
3503 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
3504 # * 405 (Method Not Found), 501 (Not Implemented): 60s
3505 #
3506 # These defaults can be overridden in `negativeCachingPolicy`.
3507 # If not specified, Cloud CDN applies negative caching by default.
3508 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
3509 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
3510 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
3511 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
3512 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
3513 # all response codes that you wish to cache. Cloud CDN will not apply any
3514 # default negative caching when a policy exists.
3515 { # Specify CDN TTLs for response error codes.
3516 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
3517 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
3518 # specified as values, and you cannot specify a status code more than
3519 # once.
3520 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
3521 # corresponding status code.
3522 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
3523 # objects may be evicted from the cache before the defined TTL.
3524 # as a count of seconds and fractions of seconds at nanosecond
3525 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3526 # or &quot;month&quot;. Range is approximately 10,000 years.
3527 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3528 # Durations less than one second are represented with a 0
3529 # `seconds` field and a positive `nanos` field. Must be from 0
3530 # to 999,999,999 inclusive.
3531 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3532 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3533 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3534 },
3535 },
3536 ],
3537 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
3538 # requests into a small number of requests to the origin. If not specified,
3539 # Cloud CDN applies request coalescing by default.
3540 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
3541 # content with the origin, or when an error is encountered when refreshing
3542 # the cache.
3543 # This setting defines the default &quot;max-stale&quot; duration for any cached
3544 # responses that do not specify a max-stale directive. Stale responses that
3545 # exceed the TTL configured here will not be served. The default limit
3546 # (max-stale) is 86400s (1 day), which will allow stale content to be
3547 # served up to this limit beyond the max-age (or s-maxage) of a cached
3548 # response.
3549 # The maximum allowed value is 604800 (1 week).
3550 # Set this to zero (0) to disable serve-while-stale.
3551 # as a count of seconds and fractions of seconds at nanosecond
3552 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3553 # or &quot;month&quot;. Range is approximately 10,000 years.
3554 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3555 # Durations less than one second are represented with a 0
3556 # `seconds` field and a positive `nanos` field. Must be from 0
3557 # to 999,999,999 inclusive.
3558 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3559 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3560 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3561 },
3562 },
3563 &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
3564 # information about the W3C recommendation for cross-origin resource sharing
3565 # (CORS), see Fetch API Living
3566 # Standard.
3567 #
3568 # Not supported when the URL map is bound to a target gRPC proxy.
3569 # information about the W3C recommendation for cross-origin resource sharing
3570 # (CORS), see Fetch API Living
3571 # Standard.
3572 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
3573 # indicates that
3574 # the actual request can include user credentials. This field translates to
3575 # the Access-Control-Allow-Credentials header.
3576 #
3577 # Default is false.
3578 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
3579 # header.
3580 &quot;A String&quot;,
3581 ],
3582 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
3583 # header.
3584 &quot;A String&quot;,
3585 ],
3586 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
3587 # more information, see regular expression syntax.
3588 #
3589 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
3590 #
3591 # Regular expressions can only be used when the loadBalancingScheme is
3592 # set to INTERNAL_SELF_MANAGED.
3593 &quot;A String&quot;,
3594 ],
3595 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
3596 #
3597 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
3598 &quot;A String&quot;,
3599 ],
3600 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
3601 # The default value is false, which indicates that the CORS
3602 # policy is in effect.
3603 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
3604 # header.
3605 &quot;A String&quot;,
3606 ],
3607 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
3608 # seconds. This field translates to the Access-Control-Max-Age
3609 # header.
3610 },
3611 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
3612 # the resiliency of clients to backend service failure. As part of fault
3613 # injection, when clients send requests to a backend service, delays can be
3614 # introduced by a load balancer on a percentage of requests before sending
3615 # those requests to the backend service. Similarly requests from clients can
3616 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
3617 # that are configured with a fault_injection_policy if:
3618 # 1. The traffic is generated by fault injection AND
3619 # 2. The fault injection is not a delay fault injection.
3620 # Fault injection is not supported with the classic Application Load Balancer
3621 # . To see which load balancers support fault injection,
3622 # see Load
3623 # balancing: Routing and traffic management features.
3624 # the resiliency of clients to backend service failure. As part of fault
3625 # injection, when clients send requests to a backend service, delays can be
3626 # introduced by the load balancer on a percentage of requests before sending
3627 # those request to the backend service. Similarly requests from clients can be
3628 # aborted by the load balancer for a percentage of requests.
3629 &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
3630 # injection.
3631 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
3632 #
3633 # The value must be from 200 to 599 inclusive.
3634 #
3635 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
3636 # according to this
3637 # mapping table. HTTP status 200 is mapped to gRPC status
3638 # UNKNOWN. Injecting an OK status is currently not supported by
3639 # Traffic Director.
3640 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
3641 # that is aborted as part of fault injection.
3642 #
3643 # The value must be from 0.0 to 100.0 inclusive.
3644 },
3645 &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
3646 # injection, before being sent to a backend service.
3647 # request to the backend service as part of fault injection.
3648 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
3649 # as a count of seconds and fractions of seconds at nanosecond
3650 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3651 # or &quot;month&quot;. Range is approximately 10,000 years.
3652 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3653 # Durations less than one second are represented with a 0
3654 # `seconds` field and a positive `nanos` field. Must be from 0
3655 # to 999,999,999 inclusive.
3656 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3657 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3658 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3659 },
3660 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
3661 # which a delay is introduced as part of fault injection.
3662 #
3663 # The value must be from 0.0 to 100.0 inclusive.
3664 },
3665 },
3666 &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
3667 # Global EXTERNAL_MANAGED load balancer schemes.
3668 # Either Cloud CDN must be enabled on the backend service or backend bucket
3669 # serving the route, or cache policy must be configured on the same route
3670 # dynamically processes and delivers images from the network edge.
3671 # Image Optimization is only available for Global External Application Load
3672 # Balancers.
3673 # Either Cloud CDN must be enabled on the backend service or backend bucket
3674 # serving the route, or cache policy must be configured on the same route.
3675 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
3676 },
3677 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
3678 # Unlike the timeout field where the timeout duration starts
3679 # from the time the request has been fully processed (known as*end-of-stream*),
3680 # the duration in this field is computed from the beginning of the stream
3681 # until the response has been processed, including all retries. A
3682 # stream that does not complete in this duration is closed.
3683 #
3684 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
3685 # with the route.
3686 #
3687 # This field is only allowed if the Url map is used with backend services
3688 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
3689 # as a count of seconds and fractions of seconds at nanosecond
3690 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3691 # or &quot;month&quot;. Range is approximately 10,000 years.
3692 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3693 # Durations less than one second are represented with a 0
3694 # `seconds` field and a positive `nanos` field. Must be from 0
3695 # to 999,999,999 inclusive.
3696 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3697 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3698 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3699 },
3700 &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
3701 # are shadowed to a separate mirrored backend service. The load balancer does
3702 # not wait for responses from the shadow service. Before sending traffic
3703 # to the shadow service, the host / authority header is suffixed with-shadow.
3704 #
3705 # Not supported when the URL map is bound to a target gRPC proxy that
3706 # has the validateForProxyless field set to true.
3707 # are shadowed to a separate mirrored backend service. The load balancer
3708 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
3709 # to the shadow service, the host or authority header is suffixed with-shadow.
3710 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
3711 # mirrored to.
3712 #
3713 # The backend service configured for a mirroring
3714 # policy must reference backends that are of the same type as the original
3715 # backend service matched in the URL map.
3716 #
3717 # Serverless NEG backends are not currently supported as a mirrored
3718 # backend service.
3719 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
3720 },
3721 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
3722 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
3723 # If not specified, defaults to 1.
3724 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
3725 #
3726 # If not specified, will use the timeout set in theHttpRouteAction field.
3727 # If timeout in the HttpRouteAction field is not set, this field
3728 # uses the largest timeout
3729 # among all backend services associated with the route.
3730 #
3731 # Not supported when the URL map is bound to a target gRPC proxy that
3732 # has the validateForProxyless field set to true.
3733 # as a count of seconds and fractions of seconds at nanosecond
3734 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3735 # or &quot;month&quot;. Range is approximately 10,000 years.
3736 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3737 # Durations less than one second are represented with a 0
3738 # `seconds` field and a positive `nanos` field. Must be from 0
3739 # to 999,999,999 inclusive.
3740 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3741 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3742 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3743 },
3744 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
3745 # values are:
3746 #
3747 # - 5xx: retry is attempted if the instance or endpoint
3748 # responds with any 5xx response code, or if the instance or
3749 # endpoint does not respond at all. For example, disconnects, reset, read
3750 # timeout, connection failure, and refused streams.
3751 # - gateway-error: Similar to 5xx, but only
3752 # applies to response codes 502, 503 or504.
3753 # - connect-failure: a retry is attempted on failures
3754 # connecting to the instance or endpoint. For example, connection
3755 # timeouts.
3756 # - retriable-4xx: a retry is attempted if the instance
3757 # or endpoint responds with a 4xx response code.
3758 # The only error that you can retry is error code 409.
3759 # - refused-stream: a retry is attempted if the instance
3760 # or endpoint resets the stream with a REFUSED_STREAM error
3761 # code. This reset type indicates that it is safe to retry.
3762 # - cancelled: a retry is attempted if the gRPC status
3763 # code in the response header is set to cancelled.
3764 # - deadline-exceeded: a retry is attempted if the gRPC
3765 # status code in the response header is set todeadline-exceeded.
3766 # - internal: a retry is attempted if the gRPC
3767 # status code in the response header is set tointernal.
3768 # - resource-exhausted: a retry is attempted if the gRPC
3769 # status code in the response header is set toresource-exhausted.
3770 # - unavailable: a retry is attempted if the gRPC
3771 # status code in the response header is set tounavailable.
3772 #
3773 # Only the following codes are supported when the URL map is bound to
3774 # target gRPC proxy that has validateForProxyless field set to true.
3775 #
3776 # - cancelled
3777 # - deadline-exceeded
3778 # - internal
3779 # - resource-exhausted
3780 # - unavailable
3781 &quot;A String&quot;,
3782 ],
3783 },
3784 &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
3785 # time the request has been fully processed (known as *end-of-stream*)
3786 # up until the response has been processed. Timeout includes
3787 # all retries.
3788 #
3789 # If not specified, this field uses the largest timeout among all backend
3790 # services associated with the route.
3791 #
3792 # Not supported when the URL map is bound to a target gRPC proxy that
3793 # has validateForProxyless field set to true.
3794 # as a count of seconds and fractions of seconds at nanosecond
3795 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3796 # or &quot;month&quot;. Range is approximately 10,000 years.
3797 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3798 # Durations less than one second are represented with a 0
3799 # `seconds` field and a positive `nanos` field. Must be from 0
3800 # to 999,999,999 inclusive.
3801 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3802 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3803 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3804 },
3805 &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
3806 # to the matched service.
3807 #
3808 # urlRewrite is the only action supported in UrlMaps
3809 # for classic Application Load Balancers.
3810 #
3811 # Not supported when the URL map is bound to a target gRPC proxy that
3812 # has the validateForProxyless field set to true.
3813 # backend service.
3814 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
3815 # host header is replaced with contents of hostRewrite.
3816 #
3817 # The value must be from 1 to 255 characters.
3818 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
3819 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
3820 #
3821 # The value must be from 1 to 1024 characters.
3822 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
3823 # header) using the HTTP template syntax.
3824 #
3825 # A corresponding
3826 # path_template_match must be specified. Any template variables must exist in
3827 # the path_template_match field.
3828 #
3829 #
3830 # - -At least one variable must be specified in the path_template_match
3831 # field
3832 # - You can omit variables from the rewritten URL
3833 # - The * and ** operators cannot be matched
3834 # unless they have a corresponding variable name - e.g.
3835 # {format=*} or {var=**}.
3836 #
3837 # For example, a path_template_match of /static/{format=**}
3838 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
3839 # rewrite, so that /{country}/{format}/{suffix=**} can be
3840 # rewritten as /content/{format}/{country}/{suffix}.
3841 #
3842 # At least
3843 # one non-empty routeRules[].matchRules[].path_template_match is
3844 # required.
3845 #
3846 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
3847 },
3848 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
3849 # occurs. The weights determine the fraction of traffic that flows to
3850 # their corresponding backend service. If all traffic needs to
3851 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
3852 #
3853 # After a backend service is identified and before forwarding
3854 # the request to
3855 # the backend service, advanced routing actions such as URL rewrites and
3856 # header transformations are applied depending on additional settings
3857 # specified in this HttpRouteAction.
3858 { # In contrast to a single BackendService in
3859 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
3860 # multiple backend services. The volume of traffic for each
3861 # backend service is proportional to the weight specified
3862 # in each WeightedBackendService
3863 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
3864 # resource. Before
3865 # forwarding the request to backendService, the load balancer
3866 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
3867 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
3868 # effect for the selected backendService.
3869 #
3870 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
3871 #
3872 # headerAction is not supported for load balancers that have
3873 # their loadBalancingScheme set to EXTERNAL.
3874 #
3875 # Not supported when the URL map is bound to a target gRPC proxy that
3876 # has validateForProxyless field set to true.
3877 # the request is passed along to the selected backendService.
3878 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
3879 { # Specification determining how headers are added to requests or responses.
3880 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
3881 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
3882 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
3883 # that already
3884 # exist for the header. If true, headerValue is set for the
3885 # header, discarding any values that were set for that header.
3886 #
3887 # The default value is true,
3888 # unless a variable is present in headerValue,
3889 # in which case the default value is false.
3890 # .
3891 },
3892 ],
3893 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
3894 # request before forwarding the request to the backendService.
3895 &quot;A String&quot;,
3896 ],
3897 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
3898 # client.
3899 { # Specification determining how headers are added to requests or responses.
3900 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
3901 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
3902 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
3903 # that already
3904 # exist for the header. If true, headerValue is set for the
3905 # header, discarding any values that were set for that header.
3906 #
3907 # The default value is true,
3908 # unless a variable is present in headerValue,
3909 # in which case the default value is false.
3910 # .
3911 },
3912 ],
3913 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
3914 # response before sending the response back to the client.
3915 &quot;A String&quot;,
3916 ],
3917 },
3918 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
3919 # computed asweight / (sum of all weightedBackendService weights in routeAction).
3920 #
3921 # The selection of a backend service is determined only for new traffic.
3922 # Once a user&#x27;s request has been directed to a backend service,
3923 # subsequent requests are sent to the same backend service as
3924 # determined by the backend service&#x27;s session affinity policy.
3925 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
3926 # splitting. If you do, the weighted traffic splitting configuration takes
3927 # precedence.
3928 #
3929 # The value must be from 0 to 1000.
3930 },
3931 ],
3932 },
3933 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
3934 # is directed if this rule is matched. If routeAction is
3935 # also specified, advanced routing actions, such as URL rewrites,
3936 # take effect before sending the request to the backend.
3937 #
3938 #
3939 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
3940 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
3941 # specified by urlRedirect.
3942 #
3943 #
3944 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
3945 #
3946 #
3947 # Not supported when the URL map is bound to a target gRPC proxy.
3948 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
3949 # was supplied in the request.
3950 #
3951 # The value must be from 1 to 255
3952 # characters.
3953 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
3954 # set to HTTPS.
3955 # If set to false, the URL scheme of the redirected request
3956 # remains the same as that of the request.
3957 #
3958 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
3959 #
3960 # The default is set to false.
3961 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
3962 # that was supplied in the request.
3963 #
3964 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
3965 # supplied, the path of the original request is used for the redirect.
3966 #
3967 # The value must be from 1 to 1024 characters.
3968 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
3969 # the HttpRouteRuleMatch, retaining the remaining portion
3970 # of the URL before redirecting the request.
3971 #
3972 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
3973 # supplied, the path of the original request is used for the redirect.
3974 #
3975 # The value must be from 1 to 1024 characters.
3976 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
3977 #
3978 # Supported values are:
3979 #
3980 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
3981 # to 301.
3982 # - FOUND, which corresponds to 302.
3983 # - SEE_OTHER which corresponds to 303.
3984 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
3985 # method is retained.
3986 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
3987 # method is retained.
3988 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
3989 # URL is
3990 # removed before redirecting the request. If set to false, the
3991 # query portion of the original URL is retained.
3992 #
3993 # The default is set to false.
3994 },
3995 },
3996 ],
3997 },
3998 ],
3999 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the regional URL map resides.
4000 # This field is not applicable to global URL maps.
4001 # You must specify this field as part of the HTTP request URL. It is
4002 # not settable as a field in the request body.
4003 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
4004 &quot;status&quot;: { # [Output Only] The status of the URL map. # Output only. [Output Only] The status of the URL map.
4005 &quot;quotaUsage&quot;: { # Message representing the quota usage for a UrlMap. # Output only. Summary of quota usage for given UrlMap.
4006 &quot;forwardingRules&quot;: 42, # Output only. The number of forwarding rules that uses this UrlMap.
4007 &quot;units&quot;: &quot;A String&quot;, # Output only. The number of quota units calculated for this UrlMap.
4008 },
4009 },
4010 &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
4011 # maximum of 100 tests per UrlMap.
4012 #
4013 # Not supported when the URL map is bound to a target gRPC proxy that
4014 # has validateForProxyless field set to true.
4015 { # Message for the expected URL mappings.
4016 &quot;description&quot;: &quot;A String&quot;, # Description of this test case.
4017 &quot;expectedOutputUrl&quot;: &quot;A String&quot;, # The expected output URL evaluated by the load balancer
4018 # containing the scheme, host, path and query parameters.
4019 #
4020 # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
4021 # the load balancer to backends. For rules with urlRewrite,
4022 # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
4023 #
4024 # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer&#x27;s
4025 # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
4026 # If urlRedirect specifies strip_query, the test
4027 # passes only if expectedOutputUrl does not contain any query
4028 # parameters.
4029 #
4030 # expectedOutputUrl is optional whenservice is specified.
4031 &quot;expectedRedirectResponseCode&quot;: 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
4032 # load balancer&#x27;s redirect response.
4033 #
4034 # expectedRedirectResponseCode cannot be set whenservice is set.
4035 &quot;headers&quot;: [ # HTTP headers for this request. If headers contains
4036 # a host header, then host must also match the header value.
4037 { # HTTP headers used in UrlMapTests.
4038 &quot;name&quot;: &quot;A String&quot;, # Header name.
4039 &quot;value&quot;: &quot;A String&quot;, # Header value.
4040 },
4041 ],
4042 &quot;host&quot;: &quot;A String&quot;, # Host portion of the URL. If headers contains a host header,
4043 # then host must also match the header value.
4044 &quot;path&quot;: &quot;A String&quot;, # Path portion of the URL.
4045 &quot;service&quot;: &quot;A String&quot;, # Expected BackendService or BackendBucket resource
4046 # the given URL should be mapped to.
4047 #
4048 # The service field cannot
4049 # be set if expectedRedirectResponseCode is set.
4050 },
4051 ],
4052 }</pre>
4053 </div>
4054
4055 <div class="method">
4056 <code class="details" id="insert">insert(project, region, body=None, requestId=None, x__xgafv=None)</code>
4057 <pre>Creates a UrlMap resource in the specified project using
4058 the data included in the request.
4059
4060 Args:
4061 project: string, Project ID for this request. (required)
4062 region: string, Name of the region scoping this request. (required)
4063 body: object, The request body.
4064 The object takes the form of:
4065
4066 { # Represents a URL Map resource.
4067 #
4068 # Compute Engine has two URL Map resources:
4069 #
4070 # * [Global](/compute/docs/reference/rest/beta/urlMaps)
4071 # * [Regional](/compute/docs/reference/rest/beta/regionUrlMaps)
4072 #
4073 # A URL map resource is a component of certain types of cloud load balancers
4074 # and Traffic Director:
4075 #
4076 # * urlMaps are used by global external Application Load
4077 # Balancers, classic Application Load Balancers, and cross-region internal
4078 # Application Load Balancers.
4079 # * regionUrlMaps are used by internal Application Load Balancers,
4080 # regional external Application Load Balancers and regional internal
4081 # Application Load Balancers.
4082 #
4083 # For a list of supported URL map features by the load balancer type, see the
4084 # Load balancing features: Routing and traffic management table.
4085 #
4086 # For a list of supported URL map features for Traffic Director, see the
4087 # Traffic Director features: Routing and traffic management table.
4088 #
4089 # This resource defines mappings from hostnames and URL paths to either a
4090 # backend service or a backend bucket.
4091 #
4092 # To use the global urlMaps resource, the backend service must
4093 # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
4094 # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
4095 # information, read URL
4096 # Map Concepts.
4097 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
4098 # text format.
4099 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
4100 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
4101 #
4102 # This policy takes
4103 # effect at the load balancer level and applies only when no policy has been
4104 # defined for the error code at lower levels like PathMatcher, RouteRule and
4105 # PathRule within this UrlMap.
4106 #
4107 # For example, consider a UrlMap with the
4108 # following configuration:
4109 #
4110 #
4111 # - defaultCustomErrorResponsePolicy containing policies for
4112 # responding to 5xx and 4xx errors
4113 # - A PathMatcher configured for *.example.com has
4114 # defaultCustomErrorResponsePolicy for 4xx.
4115 #
4116 # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
4117 # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
4118 # a request that does not match any host in *.example.com such
4119 # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
4120 # takes effect.
4121 #
4122 # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
4123 # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
4124 # a retry, if load balancer is successful in reaching the
4125 # service, the defaultCustomErrorResponsePolicy is ignored and
4126 # the response from the service is returned to the client.
4127 #
4128 # defaultCustomErrorResponsePolicy is supported only for
4129 # global external Application Load Balancers.
4130 # backend service or backend bucket responds with an error.
4131 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
4132 #
4133 # In a given policy, if you specify rules for both a range of error codes
4134 # as well as rules for specific error codes then rules with specific error
4135 # codes have a higher priority. For example, assume that you configure a rule
4136 # for 401 (Un-authorized) code, and another for all 4 series
4137 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
4138 # However if the backend service returns a 403, the rule for4xx takes effect.
4139 { # Specifies the mapping between the response code that will be returned along
4140 # with the custom error content and the response code returned by the backend
4141 # service.
4142 &quot;matchResponseCodes&quot;: [ # Valid values include:
4143 #
4144 #
4145 # - A number between 400 and 599: For example
4146 # 401 or 503, in which case the load balancer
4147 # applies the policy if the error code exactly matches this value.
4148 # - 5xx: Load Balancer will apply the policy if the
4149 # backend service responds with any response code in the range of
4150 # 500 to 599.
4151 # - 4xx: Load
4152 # Balancer will apply the policy if the backend service responds with any
4153 # response code in the range of 400 to
4154 # 499.
4155 #
4156 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
4157 &quot;A String&quot;,
4158 ],
4159 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
4160 # error content. If overrideResponseCode is not supplied, the
4161 # same response code returned by the original backend bucket or backend
4162 # service is returned to the client.
4163 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
4164 #
4165 # path must start
4166 # with a leading slash. path cannot have trailing slashes.
4167 #
4168 # If the file is not available in backendBucket or the
4169 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
4170 #
4171 # The value must
4172 # be from 1 to 1024 characters
4173 },
4174 ],
4175 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
4176 # contains the custom error content. Examples are:
4177 #
4178 #
4179 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
4180 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
4181 # - global/backendBuckets/myBackendBucket
4182 #
4183 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
4184 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
4185 #
4186 # If load balancer cannot reach
4187 # the backendBucket, a simple Not Found Error will
4188 # be returned, with the original response code (oroverrideResponseCode if configured).
4189 #
4190 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
4191 },
4192 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
4193 # hostRules match. The load balancer performs advanced routing
4194 # actions, such as URL rewrites and header transformations, before forwarding
4195 # the request to the selected backend.
4196 #
4197 #
4198 # Only one of defaultUrlRedirect, defaultService
4199 # or defaultRouteAction.weightedBackendService can be set.
4200 #
4201 #
4202 # URL maps for classic Application Load Balancers only support
4203 # the urlRewrite action within defaultRouteAction.
4204 #
4205 #
4206 # defaultRouteAction has no effect when the URL map is bound
4207 # to a target gRPC proxy that has the validateForProxyless field
4208 # set to true.
4209 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
4210 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
4211 # property must be specified. This policy cannot be specified if any target
4212 # backend has Identity-Aware Proxy enabled.
4213 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
4214 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
4215 # header names can be specified. The cache is bypassed for all `cacheMode`
4216 # values.
4217 &quot;A String&quot;,
4218 ],
4219 &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
4220 # on the backend type: for Backend Services, the complete request URI is
4221 # used; for Backend Buckets, the request URI is used without the protocol or
4222 # host, and only query parameters known to Cloud Storage are included.
4223 # Policy defined on Route Action.
4224 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
4225 # parameters will be included. Either specify `excludedQueryParameters`
4226 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
4227 # encoded and not treated as delimiters.
4228 #
4229 # Note: This field applies to routes that use backend services. Attempting
4230 # to set it on a route that points exclusively to Backend Buckets will
4231 # result in a configuration error. For routes that point to a Backend
4232 # Bucket, use `includedQueryParameters` to define which parameters should
4233 # be part of the cache key.
4234 &quot;A String&quot;,
4235 ],
4236 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
4237 #
4238 # Note: This setting is only applicable to routes that use a Backend
4239 # Service. It does not affect requests served by a Backend Bucket, as the
4240 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
4241 # it on a route that points exclusively to Backend Buckets will result in a
4242 # configuration error.
4243 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
4244 #
4245 # Note: This setting is only applicable to routes that use a Backend
4246 # Service. It does not affect requests served by a Backend Bucket, as the
4247 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
4248 # set on a route that points exclusively to Backend Buckets will result in
4249 # a configuration error.
4250 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
4251 # `includedQueryParameters` and `excludedQueryParameters`. If neither
4252 # is set, the entire query string will be included. If false, the query
4253 # string will be excluded from the cache key entirely.
4254 #
4255 # Note: This field applies to routes that use backend services. Attempting
4256 # to set it on a route that points exclusively to Backend Buckets will
4257 # result in a configuration error. For routes that point to a Backend
4258 # Bucket, use `includedQueryParameters` to define which parameters should
4259 # be part of the cache key.
4260 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
4261 # The name=value pair will be used in the cache key Cloud CDN generates.
4262 #
4263 # Note: This setting is only applicable to routes that use a Backend
4264 # Service. It does not affect requests served by a Backend Bucket.
4265 # Attempting to set it on a route that points exclusively to Backend
4266 # Buckets will result in a configuration error. Up to 5 cookie names can be
4267 # specified.
4268 &quot;A String&quot;,
4269 ],
4270 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
4271 &quot;A String&quot;,
4272 ],
4273 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
4274 # parameters will be excluded. Either specify `includedQueryParameters`
4275 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
4276 # encoded and not treated as delimiters.
4277 &quot;A String&quot;,
4278 ],
4279 },
4280 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
4281 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
4282 &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
4283 # content. This is used to clamp the max-age (or Expires) value sent to the
4284 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
4285 # is used for the response max-age directive, along with a &quot;public&quot;
4286 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
4287 # clamps the max-age from the origin (if specified), or else sets the
4288 # response max-age directive to the lesser of the `clientTtl` and
4289 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
4290 # present. The maximum allowed value is 31,622,400s (1 year). If not
4291 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
4292 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
4293 # `USE_ORIGIN_HEADERS`.
4294 # as a count of seconds and fractions of seconds at nanosecond
4295 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4296 # or &quot;month&quot;. Range is approximately 10,000 years.
4297 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4298 # Durations less than one second are represented with a 0
4299 # `seconds` field and a positive `nanos` field. Must be from 0
4300 # to 999,999,999 inclusive.
4301 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4302 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4303 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4304 },
4305 &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
4306 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
4307 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
4308 # greater than that of `maxTtl`. When the `cacheMode` is set to
4309 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
4310 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
4311 # accessed objects may be evicted from the cache before the defined TTL. If
4312 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
4313 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
4314 # `USE_ORIGIN_HEADERS`.
4315 # as a count of seconds and fractions of seconds at nanosecond
4316 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4317 # or &quot;month&quot;. Range is approximately 10,000 years.
4318 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4319 # Durations less than one second are represented with a 0
4320 # `seconds` field and a positive `nanos` field. Must be from 0
4321 # to 999,999,999 inclusive.
4322 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4323 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4324 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4325 },
4326 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
4327 # attempt to set a max-age or s-maxage higher than this, or an Expires header
4328 # more than `maxTtl` seconds in the future will be capped at the value of
4329 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
4330 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
4331 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
4332 # Infrequently accessed objects may be evicted from the cache before the
4333 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
4334 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
4335 # mode.
4336 # as a count of seconds and fractions of seconds at nanosecond
4337 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4338 # or &quot;month&quot;. Range is approximately 10,000 years.
4339 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4340 # Durations less than one second are represented with a 0
4341 # `seconds` field and a positive `nanos` field. Must be from 0
4342 # to 999,999,999 inclusive.
4343 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4344 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4345 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4346 },
4347 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
4348 # to apply fine-grained caching for common errors or redirects.
4349 # This can reduce the load on your origin and improve end-user
4350 # experience by reducing response latency.
4351 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
4352 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
4353 # the specified response code that lack any Cache-Control, Expires, or
4354 # Pragma: no-cache directives. When the `cacheMode` is set to
4355 # `FORCE_CACHE_ALL`, negative caching applies to all responses
4356 # with the specified response code, and overrides any caching headers. By
4357 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
4358 #
4359 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
4360 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
4361 # * 405 (Method Not Found), 501 (Not Implemented): 60s
4362 #
4363 # These defaults can be overridden in `negativeCachingPolicy`.
4364 # If not specified, Cloud CDN applies negative caching by default.
4365 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
4366 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
4367 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
4368 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
4369 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
4370 # all response codes that you wish to cache. Cloud CDN will not apply any
4371 # default negative caching when a policy exists.
4372 { # Specify CDN TTLs for response error codes.
4373 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
4374 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
4375 # specified as values, and you cannot specify a status code more than
4376 # once.
4377 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
4378 # corresponding status code.
4379 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
4380 # objects may be evicted from the cache before the defined TTL.
4381 # as a count of seconds and fractions of seconds at nanosecond
4382 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4383 # or &quot;month&quot;. Range is approximately 10,000 years.
4384 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4385 # Durations less than one second are represented with a 0
4386 # `seconds` field and a positive `nanos` field. Must be from 0
4387 # to 999,999,999 inclusive.
4388 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4389 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4390 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4391 },
4392 },
4393 ],
4394 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
4395 # requests into a small number of requests to the origin. If not specified,
4396 # Cloud CDN applies request coalescing by default.
4397 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
4398 # content with the origin, or when an error is encountered when refreshing
4399 # the cache.
4400 # This setting defines the default &quot;max-stale&quot; duration for any cached
4401 # responses that do not specify a max-stale directive. Stale responses that
4402 # exceed the TTL configured here will not be served. The default limit
4403 # (max-stale) is 86400s (1 day), which will allow stale content to be
4404 # served up to this limit beyond the max-age (or s-maxage) of a cached
4405 # response.
4406 # The maximum allowed value is 604800 (1 week).
4407 # Set this to zero (0) to disable serve-while-stale.
4408 # as a count of seconds and fractions of seconds at nanosecond
4409 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4410 # or &quot;month&quot;. Range is approximately 10,000 years.
4411 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4412 # Durations less than one second are represented with a 0
4413 # `seconds` field and a positive `nanos` field. Must be from 0
4414 # to 999,999,999 inclusive.
4415 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4416 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4417 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4418 },
4419 },
4420 &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
4421 # information about the W3C recommendation for cross-origin resource sharing
4422 # (CORS), see Fetch API Living
4423 # Standard.
4424 #
4425 # Not supported when the URL map is bound to a target gRPC proxy.
4426 # information about the W3C recommendation for cross-origin resource sharing
4427 # (CORS), see Fetch API Living
4428 # Standard.
4429 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
4430 # indicates that
4431 # the actual request can include user credentials. This field translates to
4432 # the Access-Control-Allow-Credentials header.
4433 #
4434 # Default is false.
4435 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
4436 # header.
4437 &quot;A String&quot;,
4438 ],
4439 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
4440 # header.
4441 &quot;A String&quot;,
4442 ],
4443 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
4444 # more information, see regular expression syntax.
4445 #
4446 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
4447 #
4448 # Regular expressions can only be used when the loadBalancingScheme is
4449 # set to INTERNAL_SELF_MANAGED.
4450 &quot;A String&quot;,
4451 ],
4452 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
4453 #
4454 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
4455 &quot;A String&quot;,
4456 ],
4457 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
4458 # The default value is false, which indicates that the CORS
4459 # policy is in effect.
4460 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
4461 # header.
4462 &quot;A String&quot;,
4463 ],
4464 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
4465 # seconds. This field translates to the Access-Control-Max-Age
4466 # header.
4467 },
4468 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
4469 # the resiliency of clients to backend service failure. As part of fault
4470 # injection, when clients send requests to a backend service, delays can be
4471 # introduced by a load balancer on a percentage of requests before sending
4472 # those requests to the backend service. Similarly requests from clients can
4473 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
4474 # that are configured with a fault_injection_policy if:
4475 # 1. The traffic is generated by fault injection AND
4476 # 2. The fault injection is not a delay fault injection.
4477 # Fault injection is not supported with the classic Application Load Balancer
4478 # . To see which load balancers support fault injection,
4479 # see Load
4480 # balancing: Routing and traffic management features.
4481 # the resiliency of clients to backend service failure. As part of fault
4482 # injection, when clients send requests to a backend service, delays can be
4483 # introduced by the load balancer on a percentage of requests before sending
4484 # those request to the backend service. Similarly requests from clients can be
4485 # aborted by the load balancer for a percentage of requests.
4486 &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
4487 # injection.
4488 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
4489 #
4490 # The value must be from 200 to 599 inclusive.
4491 #
4492 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
4493 # according to this
4494 # mapping table. HTTP status 200 is mapped to gRPC status
4495 # UNKNOWN. Injecting an OK status is currently not supported by
4496 # Traffic Director.
4497 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
4498 # that is aborted as part of fault injection.
4499 #
4500 # The value must be from 0.0 to 100.0 inclusive.
4501 },
4502 &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
4503 # injection, before being sent to a backend service.
4504 # request to the backend service as part of fault injection.
4505 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
4506 # as a count of seconds and fractions of seconds at nanosecond
4507 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4508 # or &quot;month&quot;. Range is approximately 10,000 years.
4509 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4510 # Durations less than one second are represented with a 0
4511 # `seconds` field and a positive `nanos` field. Must be from 0
4512 # to 999,999,999 inclusive.
4513 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4514 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4515 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4516 },
4517 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
4518 # which a delay is introduced as part of fault injection.
4519 #
4520 # The value must be from 0.0 to 100.0 inclusive.
4521 },
4522 },
4523 &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
4524 # Global EXTERNAL_MANAGED load balancer schemes.
4525 # Either Cloud CDN must be enabled on the backend service or backend bucket
4526 # serving the route, or cache policy must be configured on the same route
4527 # dynamically processes and delivers images from the network edge.
4528 # Image Optimization is only available for Global External Application Load
4529 # Balancers.
4530 # Either Cloud CDN must be enabled on the backend service or backend bucket
4531 # serving the route, or cache policy must be configured on the same route.
4532 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
4533 },
4534 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
4535 # Unlike the timeout field where the timeout duration starts
4536 # from the time the request has been fully processed (known as*end-of-stream*),
4537 # the duration in this field is computed from the beginning of the stream
4538 # until the response has been processed, including all retries. A
4539 # stream that does not complete in this duration is closed.
4540 #
4541 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
4542 # with the route.
4543 #
4544 # This field is only allowed if the Url map is used with backend services
4545 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
4546 # as a count of seconds and fractions of seconds at nanosecond
4547 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4548 # or &quot;month&quot;. Range is approximately 10,000 years.
4549 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4550 # Durations less than one second are represented with a 0
4551 # `seconds` field and a positive `nanos` field. Must be from 0
4552 # to 999,999,999 inclusive.
4553 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4554 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4555 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4556 },
4557 &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
4558 # are shadowed to a separate mirrored backend service. The load balancer does
4559 # not wait for responses from the shadow service. Before sending traffic
4560 # to the shadow service, the host / authority header is suffixed with-shadow.
4561 #
4562 # Not supported when the URL map is bound to a target gRPC proxy that
4563 # has the validateForProxyless field set to true.
4564 # are shadowed to a separate mirrored backend service. The load balancer
4565 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
4566 # to the shadow service, the host or authority header is suffixed with-shadow.
4567 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
4568 # mirrored to.
4569 #
4570 # The backend service configured for a mirroring
4571 # policy must reference backends that are of the same type as the original
4572 # backend service matched in the URL map.
4573 #
4574 # Serverless NEG backends are not currently supported as a mirrored
4575 # backend service.
4576 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
4577 },
4578 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
4579 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
4580 # If not specified, defaults to 1.
4581 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
4582 #
4583 # If not specified, will use the timeout set in theHttpRouteAction field.
4584 # If timeout in the HttpRouteAction field is not set, this field
4585 # uses the largest timeout
4586 # among all backend services associated with the route.
4587 #
4588 # Not supported when the URL map is bound to a target gRPC proxy that
4589 # has the validateForProxyless field set to true.
4590 # as a count of seconds and fractions of seconds at nanosecond
4591 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4592 # or &quot;month&quot;. Range is approximately 10,000 years.
4593 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4594 # Durations less than one second are represented with a 0
4595 # `seconds` field and a positive `nanos` field. Must be from 0
4596 # to 999,999,999 inclusive.
4597 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4598 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4599 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4600 },
4601 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
4602 # values are:
4603 #
4604 # - 5xx: retry is attempted if the instance or endpoint
4605 # responds with any 5xx response code, or if the instance or
4606 # endpoint does not respond at all. For example, disconnects, reset, read
4607 # timeout, connection failure, and refused streams.
4608 # - gateway-error: Similar to 5xx, but only
4609 # applies to response codes 502, 503 or504.
4610 # - connect-failure: a retry is attempted on failures
4611 # connecting to the instance or endpoint. For example, connection
4612 # timeouts.
4613 # - retriable-4xx: a retry is attempted if the instance
4614 # or endpoint responds with a 4xx response code.
4615 # The only error that you can retry is error code 409.
4616 # - refused-stream: a retry is attempted if the instance
4617 # or endpoint resets the stream with a REFUSED_STREAM error
4618 # code. This reset type indicates that it is safe to retry.
4619 # - cancelled: a retry is attempted if the gRPC status
4620 # code in the response header is set to cancelled.
4621 # - deadline-exceeded: a retry is attempted if the gRPC
4622 # status code in the response header is set todeadline-exceeded.
4623 # - internal: a retry is attempted if the gRPC
4624 # status code in the response header is set tointernal.
4625 # - resource-exhausted: a retry is attempted if the gRPC
4626 # status code in the response header is set toresource-exhausted.
4627 # - unavailable: a retry is attempted if the gRPC
4628 # status code in the response header is set tounavailable.
4629 #
4630 # Only the following codes are supported when the URL map is bound to
4631 # target gRPC proxy that has validateForProxyless field set to true.
4632 #
4633 # - cancelled
4634 # - deadline-exceeded
4635 # - internal
4636 # - resource-exhausted
4637 # - unavailable
4638 &quot;A String&quot;,
4639 ],
4640 },
4641 &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
4642 # time the request has been fully processed (known as *end-of-stream*)
4643 # up until the response has been processed. Timeout includes
4644 # all retries.
4645 #
4646 # If not specified, this field uses the largest timeout among all backend
4647 # services associated with the route.
4648 #
4649 # Not supported when the URL map is bound to a target gRPC proxy that
4650 # has validateForProxyless field set to true.
4651 # as a count of seconds and fractions of seconds at nanosecond
4652 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4653 # or &quot;month&quot;. Range is approximately 10,000 years.
4654 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4655 # Durations less than one second are represented with a 0
4656 # `seconds` field and a positive `nanos` field. Must be from 0
4657 # to 999,999,999 inclusive.
4658 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4659 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4660 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4661 },
4662 &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
4663 # to the matched service.
4664 #
4665 # urlRewrite is the only action supported in UrlMaps
4666 # for classic Application Load Balancers.
4667 #
4668 # Not supported when the URL map is bound to a target gRPC proxy that
4669 # has the validateForProxyless field set to true.
4670 # backend service.
4671 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
4672 # host header is replaced with contents of hostRewrite.
4673 #
4674 # The value must be from 1 to 255 characters.
4675 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
4676 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
4677 #
4678 # The value must be from 1 to 1024 characters.
4679 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
4680 # header) using the HTTP template syntax.
4681 #
4682 # A corresponding
4683 # path_template_match must be specified. Any template variables must exist in
4684 # the path_template_match field.
4685 #
4686 #
4687 # - -At least one variable must be specified in the path_template_match
4688 # field
4689 # - You can omit variables from the rewritten URL
4690 # - The * and ** operators cannot be matched
4691 # unless they have a corresponding variable name - e.g.
4692 # {format=*} or {var=**}.
4693 #
4694 # For example, a path_template_match of /static/{format=**}
4695 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
4696 # rewrite, so that /{country}/{format}/{suffix=**} can be
4697 # rewritten as /content/{format}/{country}/{suffix}.
4698 #
4699 # At least
4700 # one non-empty routeRules[].matchRules[].path_template_match is
4701 # required.
4702 #
4703 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
4704 },
4705 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
4706 # occurs. The weights determine the fraction of traffic that flows to
4707 # their corresponding backend service. If all traffic needs to
4708 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
4709 #
4710 # After a backend service is identified and before forwarding
4711 # the request to
4712 # the backend service, advanced routing actions such as URL rewrites and
4713 # header transformations are applied depending on additional settings
4714 # specified in this HttpRouteAction.
4715 { # In contrast to a single BackendService in
4716 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
4717 # multiple backend services. The volume of traffic for each
4718 # backend service is proportional to the weight specified
4719 # in each WeightedBackendService
4720 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
4721 # resource. Before
4722 # forwarding the request to backendService, the load balancer
4723 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
4724 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
4725 # effect for the selected backendService.
4726 #
4727 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
4728 #
4729 # headerAction is not supported for load balancers that have
4730 # their loadBalancingScheme set to EXTERNAL.
4731 #
4732 # Not supported when the URL map is bound to a target gRPC proxy that
4733 # has validateForProxyless field set to true.
4734 # the request is passed along to the selected backendService.
4735 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
4736 { # Specification determining how headers are added to requests or responses.
4737 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
4738 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
4739 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
4740 # that already
4741 # exist for the header. If true, headerValue is set for the
4742 # header, discarding any values that were set for that header.
4743 #
4744 # The default value is true,
4745 # unless a variable is present in headerValue,
4746 # in which case the default value is false.
4747 # .
4748 },
4749 ],
4750 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
4751 # request before forwarding the request to the backendService.
4752 &quot;A String&quot;,
4753 ],
4754 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
4755 # client.
4756 { # Specification determining how headers are added to requests or responses.
4757 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
4758 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
4759 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
4760 # that already
4761 # exist for the header. If true, headerValue is set for the
4762 # header, discarding any values that were set for that header.
4763 #
4764 # The default value is true,
4765 # unless a variable is present in headerValue,
4766 # in which case the default value is false.
4767 # .
4768 },
4769 ],
4770 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
4771 # response before sending the response back to the client.
4772 &quot;A String&quot;,
4773 ],
4774 },
4775 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
4776 # computed asweight / (sum of all weightedBackendService weights in routeAction).
4777 #
4778 # The selection of a backend service is determined only for new traffic.
4779 # Once a user&#x27;s request has been directed to a backend service,
4780 # subsequent requests are sent to the same backend service as
4781 # determined by the backend service&#x27;s session affinity policy.
4782 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
4783 # splitting. If you do, the weighted traffic splitting configuration takes
4784 # precedence.
4785 #
4786 # The value must be from 0 to 1000.
4787 },
4788 ],
4789 },
4790 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL of the defaultService resource to
4791 # which traffic is directed if none of the hostRules match.
4792 # If defaultRouteAction is also specified, advanced
4793 # routing actions, such as URL rewrites, take effect before sending the
4794 # request to the backend.
4795 #
4796 #
4797 # Only one of defaultUrlRedirect, defaultService
4798 # or defaultRouteAction.weightedBackendService can be set.
4799 #
4800 #
4801 # defaultService has no effect when the URL map is bound
4802 # to a target gRPC proxy that has the validateForProxyless field
4803 # set to true.
4804 &quot;defaultUrlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
4805 # is redirected to a URL specified by defaultUrlRedirect.
4806 #
4807 #
4808 # Only one of defaultUrlRedirect, defaultService
4809 # or defaultRouteAction.weightedBackendService can be set.
4810 #
4811 #
4812 # Not supported when the URL map is bound to a target gRPC proxy.
4813 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
4814 # was supplied in the request.
4815 #
4816 # The value must be from 1 to 255
4817 # characters.
4818 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
4819 # set to HTTPS.
4820 # If set to false, the URL scheme of the redirected request
4821 # remains the same as that of the request.
4822 #
4823 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
4824 #
4825 # The default is set to false.
4826 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
4827 # that was supplied in the request.
4828 #
4829 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
4830 # supplied, the path of the original request is used for the redirect.
4831 #
4832 # The value must be from 1 to 1024 characters.
4833 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
4834 # the HttpRouteRuleMatch, retaining the remaining portion
4835 # of the URL before redirecting the request.
4836 #
4837 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
4838 # supplied, the path of the original request is used for the redirect.
4839 #
4840 # The value must be from 1 to 1024 characters.
4841 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
4842 #
4843 # Supported values are:
4844 #
4845 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
4846 # to 301.
4847 # - FOUND, which corresponds to 302.
4848 # - SEE_OTHER which corresponds to 303.
4849 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
4850 # method is retained.
4851 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
4852 # method is retained.
4853 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
4854 # URL is
4855 # removed before redirecting the request. If set to false, the
4856 # query portion of the original URL is retained.
4857 #
4858 # The default is set to false.
4859 },
4860 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
4861 # create the resource.
4862 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. A hash of the contents stored in this object.
4863 # This field is used in optimistic locking. This field is ignored when
4864 # inserting a UrlMap. An up-to-date fingerprint must be provided
4865 # in order to update the UrlMap, otherwise the request will
4866 # fail with error 412 conditionNotMet.
4867 #
4868 # To see the latest fingerprint, make a get() request to
4869 # retrieve a UrlMap.
4870 &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
4871 # for the selected backendService.
4872 #
4873 # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
4874 #
4875 # headerAction is not supported for load balancers
4876 # 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;hostRules&quot;: [ # The list of host rules to use against the URL.
4923 { # UrlMaps
4924 # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
4925 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
4926 # create the resource.
4927 &quot;hosts&quot;: [ # The list of host patterns to match. They must be valid hostnames with
4928 # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
4929 # that case, * must be the first character, and if followed by
4930 # anything, the immediate following character must be either -
4931 # or ..
4932 #
4933 # * based matching is not supported when the URL map is bound
4934 # to a target gRPC proxy that has the validateForProxyless field
4935 # set to true.
4936 &quot;A String&quot;,
4937 ],
4938 &quot;pathMatcher&quot;: &quot;A String&quot;, # The name of the PathMatcher to use to match the path portion
4939 # of the URL if the hostRule matches the URL&#x27;s host portion.
4940 },
4941 ],
4942 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the resource. This identifier is
4943 # defined by the server.
4944 &quot;kind&quot;: &quot;compute#urlMap&quot;, # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
4945 # url maps.
4946 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
4947 # The name must be 1-63 characters long, and comply withRFC1035.
4948 # Specifically, the name must be 1-63 characters long and match the regular
4949 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
4950 # character must be a lowercase letter, and all following characters must
4951 # be a dash, lowercase letter, or digit, except the last character, which
4952 # cannot be a dash.
4953 &quot;pathMatchers&quot;: [ # The list of named PathMatchers to use against the URL.
4954 { # A matcher for the path portion of the URL. The BackendService
4955 # from the longest-matched rule will serve the URL. If no rule was matched, the
4956 # default service is used.
4957 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
4958 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
4959 #
4960 # This policy takes
4961 # effect at the PathMatcher level and applies only when no
4962 # 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
4963 # in defaultCustomErrorResponsePolicy, then a policy defined for
4964 # the error code in UrlMap.defaultCustomErrorResponsePolicy
4965 # takes effect.
4966 #
4967 # For example, consider a UrlMap with the following
4968 # configuration:
4969 #
4970 #
4971 # - UrlMap.defaultCustomErrorResponsePolicy is configured
4972 # with policies for 5xx and 4xx errors
4973 # - A RouteRule for /coming_soon/ is configured for the
4974 # error code 404.
4975 #
4976 # 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
4977 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
4978 # the policy in RouteRule.customErrorResponsePolicy takes
4979 # effect. If any of the requests in this example encounter a 500
4980 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
4981 #
4982 # When
4983 # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
4984 # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
4985 # a retry, if load balancer is successful in reaching the
4986 # service, the defaultCustomErrorResponsePolicy is ignored and
4987 # the response from the service is returned to the client.
4988 #
4989 # defaultCustomErrorResponsePolicy is supported only for
4990 # global external Application Load Balancers.
4991 # backend service or backend bucket responds with an error.
4992 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
4993 #
4994 # In a given policy, if you specify rules for both a range of error codes
4995 # as well as rules for specific error codes then rules with specific error
4996 # codes have a higher priority. For example, assume that you configure a rule
4997 # for 401 (Un-authorized) code, and another for all 4 series
4998 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
4999 # However if the backend service returns a 403, the rule for4xx takes effect.
5000 { # Specifies the mapping between the response code that will be returned along
5001 # with the custom error content and the response code returned by the backend
5002 # service.
5003 &quot;matchResponseCodes&quot;: [ # Valid values include:
5004 #
5005 #
5006 # - A number between 400 and 599: For example
5007 # 401 or 503, in which case the load balancer
5008 # applies the policy if the error code exactly matches this value.
5009 # - 5xx: Load Balancer will apply the policy if the
5010 # backend service responds with any response code in the range of
5011 # 500 to 599.
5012 # - 4xx: Load
5013 # Balancer will apply the policy if the backend service responds with any
5014 # response code in the range of 400 to
5015 # 499.
5016 #
5017 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
5018 &quot;A String&quot;,
5019 ],
5020 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
5021 # error content. If overrideResponseCode is not supplied, the
5022 # same response code returned by the original backend bucket or backend
5023 # service is returned to the client.
5024 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
5025 #
5026 # path must start
5027 # with a leading slash. path cannot have trailing slashes.
5028 #
5029 # If the file is not available in backendBucket or the
5030 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
5031 #
5032 # The value must
5033 # be from 1 to 1024 characters
5034 },
5035 ],
5036 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
5037 # contains the custom error content. Examples are:
5038 #
5039 #
5040 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
5041 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
5042 # - global/backendBuckets/myBackendBucket
5043 #
5044 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
5045 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
5046 #
5047 # If load balancer cannot reach
5048 # the backendBucket, a simple Not Found Error will
5049 # be returned, with the original response code (oroverrideResponseCode if configured).
5050 #
5051 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
5052 },
5053 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
5054 # pathRules or routeRules match. The load balancer
5055 # performs advanced routing actions, such as URL rewrites and
5056 # header transformations, before forwarding the request to the
5057 # selected backend.
5058 #
5059 #
5060 # Only one of defaultUrlRedirect, defaultService
5061 # or defaultRouteAction.weightedBackendService can be set.
5062 #
5063 #
5064 # URL maps for classic Application Load Balancers only support
5065 # the urlRewrite action within a path matcher&#x27;sdefaultRouteAction.
5066 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
5067 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
5068 # property must be specified. This policy cannot be specified if any target
5069 # backend has Identity-Aware Proxy enabled.
5070 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
5071 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
5072 # header names can be specified. The cache is bypassed for all `cacheMode`
5073 # values.
5074 &quot;A String&quot;,
5075 ],
5076 &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
5077 # on the backend type: for Backend Services, the complete request URI is
5078 # used; for Backend Buckets, the request URI is used without the protocol or
5079 # host, and only query parameters known to Cloud Storage are included.
5080 # Policy defined on Route Action.
5081 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
5082 # parameters will be included. Either specify `excludedQueryParameters`
5083 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
5084 # encoded and not treated as delimiters.
5085 #
5086 # Note: This field applies to routes that use backend services. Attempting
5087 # to set it on a route that points exclusively to Backend Buckets will
5088 # result in a configuration error. For routes that point to a Backend
5089 # Bucket, use `includedQueryParameters` to define which parameters should
5090 # be part of the cache key.
5091 &quot;A String&quot;,
5092 ],
5093 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
5094 #
5095 # Note: This setting is only applicable to routes that use a Backend
5096 # Service. It does not affect requests served by a Backend Bucket, as the
5097 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
5098 # it on a route that points exclusively to Backend Buckets will result in a
5099 # configuration error.
5100 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
5101 #
5102 # Note: This setting is only applicable to routes that use a Backend
5103 # Service. It does not affect requests served by a Backend Bucket, as the
5104 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
5105 # set on a route that points exclusively to Backend Buckets will result in
5106 # a configuration error.
5107 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
5108 # `includedQueryParameters` and `excludedQueryParameters`. If neither
5109 # is set, the entire query string will be included. If false, the query
5110 # string will be excluded from the cache key entirely.
5111 #
5112 # Note: This field applies to routes that use backend services. Attempting
5113 # to set it on a route that points exclusively to Backend Buckets will
5114 # result in a configuration error. For routes that point to a Backend
5115 # Bucket, use `includedQueryParameters` to define which parameters should
5116 # be part of the cache key.
5117 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
5118 # The name=value pair will be used in the cache key Cloud CDN generates.
5119 #
5120 # Note: This setting is only applicable to routes that use a Backend
5121 # Service. It does not affect requests served by a Backend Bucket.
5122 # Attempting to set it on a route that points exclusively to Backend
5123 # Buckets will result in a configuration error. Up to 5 cookie names can be
5124 # specified.
5125 &quot;A String&quot;,
5126 ],
5127 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
5128 &quot;A String&quot;,
5129 ],
5130 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
5131 # parameters will be excluded. Either specify `includedQueryParameters`
5132 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
5133 # encoded and not treated as delimiters.
5134 &quot;A String&quot;,
5135 ],
5136 },
5137 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
5138 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
5139 &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
5140 # content. This is used to clamp the max-age (or Expires) value sent to the
5141 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
5142 # is used for the response max-age directive, along with a &quot;public&quot;
5143 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
5144 # clamps the max-age from the origin (if specified), or else sets the
5145 # response max-age directive to the lesser of the `clientTtl` and
5146 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
5147 # present. The maximum allowed value is 31,622,400s (1 year). If not
5148 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
5149 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
5150 # `USE_ORIGIN_HEADERS`.
5151 # as a count of seconds and fractions of seconds at nanosecond
5152 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5153 # or &quot;month&quot;. Range is approximately 10,000 years.
5154 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5155 # Durations less than one second are represented with a 0
5156 # `seconds` field and a positive `nanos` field. Must be from 0
5157 # to 999,999,999 inclusive.
5158 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5159 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5160 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5161 },
5162 &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
5163 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
5164 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
5165 # greater than that of `maxTtl`. When the `cacheMode` is set to
5166 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
5167 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
5168 # accessed objects may be evicted from the cache before the defined TTL. If
5169 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
5170 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
5171 # `USE_ORIGIN_HEADERS`.
5172 # as a count of seconds and fractions of seconds at nanosecond
5173 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5174 # or &quot;month&quot;. Range is approximately 10,000 years.
5175 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5176 # Durations less than one second are represented with a 0
5177 # `seconds` field and a positive `nanos` field. Must be from 0
5178 # to 999,999,999 inclusive.
5179 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5180 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5181 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5182 },
5183 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
5184 # attempt to set a max-age or s-maxage higher than this, or an Expires header
5185 # more than `maxTtl` seconds in the future will be capped at the value of
5186 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
5187 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
5188 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
5189 # Infrequently accessed objects may be evicted from the cache before the
5190 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
5191 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
5192 # mode.
5193 # as a count of seconds and fractions of seconds at nanosecond
5194 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5195 # or &quot;month&quot;. Range is approximately 10,000 years.
5196 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5197 # Durations less than one second are represented with a 0
5198 # `seconds` field and a positive `nanos` field. Must be from 0
5199 # to 999,999,999 inclusive.
5200 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5201 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5202 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5203 },
5204 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
5205 # to apply fine-grained caching for common errors or redirects.
5206 # This can reduce the load on your origin and improve end-user
5207 # experience by reducing response latency.
5208 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
5209 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
5210 # the specified response code that lack any Cache-Control, Expires, or
5211 # Pragma: no-cache directives. When the `cacheMode` is set to
5212 # `FORCE_CACHE_ALL`, negative caching applies to all responses
5213 # with the specified response code, and overrides any caching headers. By
5214 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
5215 #
5216 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
5217 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
5218 # * 405 (Method Not Found), 501 (Not Implemented): 60s
5219 #
5220 # These defaults can be overridden in `negativeCachingPolicy`.
5221 # If not specified, Cloud CDN applies negative caching by default.
5222 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
5223 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
5224 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
5225 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
5226 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
5227 # all response codes that you wish to cache. Cloud CDN will not apply any
5228 # default negative caching when a policy exists.
5229 { # Specify CDN TTLs for response error codes.
5230 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
5231 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
5232 # specified as values, and you cannot specify a status code more than
5233 # once.
5234 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
5235 # corresponding status code.
5236 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
5237 # objects may be evicted from the cache before the defined TTL.
5238 # as a count of seconds and fractions of seconds at nanosecond
5239 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5240 # or &quot;month&quot;. Range is approximately 10,000 years.
5241 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5242 # Durations less than one second are represented with a 0
5243 # `seconds` field and a positive `nanos` field. Must be from 0
5244 # to 999,999,999 inclusive.
5245 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5246 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5247 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5248 },
5249 },
5250 ],
5251 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
5252 # requests into a small number of requests to the origin. If not specified,
5253 # Cloud CDN applies request coalescing by default.
5254 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
5255 # content with the origin, or when an error is encountered when refreshing
5256 # the cache.
5257 # This setting defines the default &quot;max-stale&quot; duration for any cached
5258 # responses that do not specify a max-stale directive. Stale responses that
5259 # exceed the TTL configured here will not be served. The default limit
5260 # (max-stale) is 86400s (1 day), which will allow stale content to be
5261 # served up to this limit beyond the max-age (or s-maxage) of a cached
5262 # response.
5263 # The maximum allowed value is 604800 (1 week).
5264 # Set this to zero (0) to disable serve-while-stale.
5265 # as a count of seconds and fractions of seconds at nanosecond
5266 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5267 # or &quot;month&quot;. Range is approximately 10,000 years.
5268 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5269 # Durations less than one second are represented with a 0
5270 # `seconds` field and a positive `nanos` field. Must be from 0
5271 # to 999,999,999 inclusive.
5272 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5273 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5274 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5275 },
5276 },
5277 &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
5278 # information about the W3C recommendation for cross-origin resource sharing
5279 # (CORS), see Fetch API Living
5280 # Standard.
5281 #
5282 # Not supported when the URL map is bound to a target gRPC proxy.
5283 # information about the W3C recommendation for cross-origin resource sharing
5284 # (CORS), see Fetch API Living
5285 # Standard.
5286 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
5287 # indicates that
5288 # the actual request can include user credentials. This field translates to
5289 # the Access-Control-Allow-Credentials header.
5290 #
5291 # Default is false.
5292 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
5293 # header.
5294 &quot;A String&quot;,
5295 ],
5296 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
5297 # header.
5298 &quot;A String&quot;,
5299 ],
5300 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
5301 # more information, see regular expression syntax.
5302 #
5303 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
5304 #
5305 # Regular expressions can only be used when the loadBalancingScheme is
5306 # set to INTERNAL_SELF_MANAGED.
5307 &quot;A String&quot;,
5308 ],
5309 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
5310 #
5311 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
5312 &quot;A String&quot;,
5313 ],
5314 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
5315 # The default value is false, which indicates that the CORS
5316 # policy is in effect.
5317 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
5318 # header.
5319 &quot;A String&quot;,
5320 ],
5321 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
5322 # seconds. This field translates to the Access-Control-Max-Age
5323 # header.
5324 },
5325 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
5326 # the resiliency of clients to backend service failure. As part of fault
5327 # injection, when clients send requests to a backend service, delays can be
5328 # introduced by a load balancer on a percentage of requests before sending
5329 # those requests to the backend service. Similarly requests from clients can
5330 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
5331 # that are configured with a fault_injection_policy if:
5332 # 1. The traffic is generated by fault injection AND
5333 # 2. The fault injection is not a delay fault injection.
5334 # Fault injection is not supported with the classic Application Load Balancer
5335 # . To see which load balancers support fault injection,
5336 # see Load
5337 # balancing: Routing and traffic management features.
5338 # the resiliency of clients to backend service failure. As part of fault
5339 # injection, when clients send requests to a backend service, delays can be
5340 # introduced by the load balancer on a percentage of requests before sending
5341 # those request to the backend service. Similarly requests from clients can be
5342 # aborted by the load balancer for a percentage of requests.
5343 &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
5344 # injection.
5345 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
5346 #
5347 # The value must be from 200 to 599 inclusive.
5348 #
5349 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
5350 # according to this
5351 # mapping table. HTTP status 200 is mapped to gRPC status
5352 # UNKNOWN. Injecting an OK status is currently not supported by
5353 # Traffic Director.
5354 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
5355 # that is aborted as part of fault injection.
5356 #
5357 # The value must be from 0.0 to 100.0 inclusive.
5358 },
5359 &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
5360 # injection, before being sent to a backend service.
5361 # request to the backend service as part of fault injection.
5362 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
5363 # as a count of seconds and fractions of seconds at nanosecond
5364 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5365 # or &quot;month&quot;. Range is approximately 10,000 years.
5366 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5367 # Durations less than one second are represented with a 0
5368 # `seconds` field and a positive `nanos` field. Must be from 0
5369 # to 999,999,999 inclusive.
5370 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5371 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5372 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5373 },
5374 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
5375 # which a delay is introduced as part of fault injection.
5376 #
5377 # The value must be from 0.0 to 100.0 inclusive.
5378 },
5379 },
5380 &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
5381 # Global EXTERNAL_MANAGED load balancer schemes.
5382 # Either Cloud CDN must be enabled on the backend service or backend bucket
5383 # serving the route, or cache policy must be configured on the same route
5384 # dynamically processes and delivers images from the network edge.
5385 # Image Optimization is only available for Global External Application Load
5386 # Balancers.
5387 # Either Cloud CDN must be enabled on the backend service or backend bucket
5388 # serving the route, or cache policy must be configured on the same route.
5389 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
5390 },
5391 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
5392 # Unlike the timeout field where the timeout duration starts
5393 # from the time the request has been fully processed (known as*end-of-stream*),
5394 # the duration in this field is computed from the beginning of the stream
5395 # until the response has been processed, including all retries. A
5396 # stream that does not complete in this duration is closed.
5397 #
5398 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
5399 # with the route.
5400 #
5401 # This field is only allowed if the Url map is used with backend services
5402 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
5403 # as a count of seconds and fractions of seconds at nanosecond
5404 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5405 # or &quot;month&quot;. Range is approximately 10,000 years.
5406 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5407 # Durations less than one second are represented with a 0
5408 # `seconds` field and a positive `nanos` field. Must be from 0
5409 # to 999,999,999 inclusive.
5410 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5411 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5412 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5413 },
5414 &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
5415 # are shadowed to a separate mirrored backend service. The load balancer does
5416 # not wait for responses from the shadow service. Before sending traffic
5417 # to the shadow service, the host / authority header is suffixed with-shadow.
5418 #
5419 # Not supported when the URL map is bound to a target gRPC proxy that
5420 # has the validateForProxyless field set to true.
5421 # are shadowed to a separate mirrored backend service. The load balancer
5422 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
5423 # to the shadow service, the host or authority header is suffixed with-shadow.
5424 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
5425 # mirrored to.
5426 #
5427 # The backend service configured for a mirroring
5428 # policy must reference backends that are of the same type as the original
5429 # backend service matched in the URL map.
5430 #
5431 # Serverless NEG backends are not currently supported as a mirrored
5432 # backend service.
5433 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
5434 },
5435 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
5436 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
5437 # If not specified, defaults to 1.
5438 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
5439 #
5440 # If not specified, will use the timeout set in theHttpRouteAction field.
5441 # If timeout in the HttpRouteAction field is not set, this field
5442 # uses the largest timeout
5443 # among all backend services associated with the route.
5444 #
5445 # Not supported when the URL map is bound to a target gRPC proxy that
5446 # has the validateForProxyless field set to true.
5447 # as a count of seconds and fractions of seconds at nanosecond
5448 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5449 # or &quot;month&quot;. Range is approximately 10,000 years.
5450 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5451 # Durations less than one second are represented with a 0
5452 # `seconds` field and a positive `nanos` field. Must be from 0
5453 # to 999,999,999 inclusive.
5454 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5455 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5456 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5457 },
5458 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
5459 # values are:
5460 #
5461 # - 5xx: retry is attempted if the instance or endpoint
5462 # responds with any 5xx response code, or if the instance or
5463 # endpoint does not respond at all. For example, disconnects, reset, read
5464 # timeout, connection failure, and refused streams.
5465 # - gateway-error: Similar to 5xx, but only
5466 # applies to response codes 502, 503 or504.
5467 # - connect-failure: a retry is attempted on failures
5468 # connecting to the instance or endpoint. For example, connection
5469 # timeouts.
5470 # - retriable-4xx: a retry is attempted if the instance
5471 # or endpoint responds with a 4xx response code.
5472 # The only error that you can retry is error code 409.
5473 # - refused-stream: a retry is attempted if the instance
5474 # or endpoint resets the stream with a REFUSED_STREAM error
5475 # code. This reset type indicates that it is safe to retry.
5476 # - cancelled: a retry is attempted if the gRPC status
5477 # code in the response header is set to cancelled.
5478 # - deadline-exceeded: a retry is attempted if the gRPC
5479 # status code in the response header is set todeadline-exceeded.
5480 # - internal: a retry is attempted if the gRPC
5481 # status code in the response header is set tointernal.
5482 # - resource-exhausted: a retry is attempted if the gRPC
5483 # status code in the response header is set toresource-exhausted.
5484 # - unavailable: a retry is attempted if the gRPC
5485 # status code in the response header is set tounavailable.
5486 #
5487 # Only the following codes are supported when the URL map is bound to
5488 # target gRPC proxy that has validateForProxyless field set to true.
5489 #
5490 # - cancelled
5491 # - deadline-exceeded
5492 # - internal
5493 # - resource-exhausted
5494 # - unavailable
5495 &quot;A String&quot;,
5496 ],
5497 },
5498 &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
5499 # time the request has been fully processed (known as *end-of-stream*)
5500 # up until the response has been processed. Timeout includes
5501 # all retries.
5502 #
5503 # If not specified, this field uses the largest timeout among all backend
5504 # services associated with the route.
5505 #
5506 # Not supported when the URL map is bound to a target gRPC proxy that
5507 # has validateForProxyless field set to true.
5508 # as a count of seconds and fractions of seconds at nanosecond
5509 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5510 # or &quot;month&quot;. Range is approximately 10,000 years.
5511 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5512 # Durations less than one second are represented with a 0
5513 # `seconds` field and a positive `nanos` field. Must be from 0
5514 # to 999,999,999 inclusive.
5515 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5516 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5517 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5518 },
5519 &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
5520 # to the matched service.
5521 #
5522 # urlRewrite is the only action supported in UrlMaps
5523 # for classic Application Load Balancers.
5524 #
5525 # Not supported when the URL map is bound to a target gRPC proxy that
5526 # has the validateForProxyless field set to true.
5527 # backend service.
5528 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
5529 # host header is replaced with contents of hostRewrite.
5530 #
5531 # The value must be from 1 to 255 characters.
5532 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
5533 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
5534 #
5535 # The value must be from 1 to 1024 characters.
5536 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
5537 # header) using the HTTP template syntax.
5538 #
5539 # A corresponding
5540 # path_template_match must be specified. Any template variables must exist in
5541 # the path_template_match field.
5542 #
5543 #
5544 # - -At least one variable must be specified in the path_template_match
5545 # field
5546 # - You can omit variables from the rewritten URL
5547 # - The * and ** operators cannot be matched
5548 # unless they have a corresponding variable name - e.g.
5549 # {format=*} or {var=**}.
5550 #
5551 # For example, a path_template_match of /static/{format=**}
5552 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
5553 # rewrite, so that /{country}/{format}/{suffix=**} can be
5554 # rewritten as /content/{format}/{country}/{suffix}.
5555 #
5556 # At least
5557 # one non-empty routeRules[].matchRules[].path_template_match is
5558 # required.
5559 #
5560 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
5561 },
5562 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
5563 # occurs. The weights determine the fraction of traffic that flows to
5564 # their corresponding backend service. If all traffic needs to
5565 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
5566 #
5567 # After a backend service is identified and before forwarding
5568 # the request to
5569 # the backend service, advanced routing actions such as URL rewrites and
5570 # header transformations are applied depending on additional settings
5571 # specified in this HttpRouteAction.
5572 { # In contrast to a single BackendService in
5573 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
5574 # multiple backend services. The volume of traffic for each
5575 # backend service is proportional to the weight specified
5576 # in each WeightedBackendService
5577 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
5578 # resource. Before
5579 # forwarding the request to backendService, the load balancer
5580 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
5581 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
5582 # effect for the selected backendService.
5583 #
5584 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
5585 #
5586 # headerAction is not supported for load balancers that have
5587 # their loadBalancingScheme set to EXTERNAL.
5588 #
5589 # Not supported when the URL map is bound to a target gRPC proxy that
5590 # has validateForProxyless field set to true.
5591 # the request is passed along to the selected backendService.
5592 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
5593 { # Specification determining how headers are added to requests or responses.
5594 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
5595 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
5596 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
5597 # that already
5598 # exist for the header. If true, headerValue is set for the
5599 # header, discarding any values that were set for that header.
5600 #
5601 # The default value is true,
5602 # unless a variable is present in headerValue,
5603 # in which case the default value is false.
5604 # .
5605 },
5606 ],
5607 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
5608 # request before forwarding the request to the backendService.
5609 &quot;A String&quot;,
5610 ],
5611 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
5612 # client.
5613 { # Specification determining how headers are added to requests or responses.
5614 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
5615 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
5616 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
5617 # that already
5618 # exist for the header. If true, headerValue is set for the
5619 # header, discarding any values that were set for that header.
5620 #
5621 # The default value is true,
5622 # unless a variable is present in headerValue,
5623 # in which case the default value is false.
5624 # .
5625 },
5626 ],
5627 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
5628 # response before sending the response back to the client.
5629 &quot;A String&quot;,
5630 ],
5631 },
5632 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
5633 # computed asweight / (sum of all weightedBackendService weights in routeAction).
5634 #
5635 # The selection of a backend service is determined only for new traffic.
5636 # Once a user&#x27;s request has been directed to a backend service,
5637 # subsequent requests are sent to the same backend service as
5638 # determined by the backend service&#x27;s session affinity policy.
5639 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
5640 # splitting. If you do, the weighted traffic splitting configuration takes
5641 # precedence.
5642 #
5643 # The value must be from 0 to 1000.
5644 },
5645 ],
5646 },
5647 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource. This
5648 # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
5649 # matched. For example, the
5650 # following are all valid URLs to a BackendService resource:
5651 #
5652 #
5653 # - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
5654 # - compute/v1/projects/project/global/backendServices/backendService
5655 # - global/backendServices/backendService
5656 #
5657 #
5658 # If defaultRouteAction is also specified, advanced
5659 # routing actions, such as URL rewrites, take effect before sending the
5660 # request to the backend.
5661 #
5662 #
5663 # Only one of defaultUrlRedirect, defaultService
5664 # or defaultRouteAction.weightedBackendService can be set.
5665 #
5666 #
5667 # Authorization requires one or more of the following Google IAM permissions on the
5668 # specified resource default_service:
5669 #
5670 #
5671 # - compute.backendBuckets.use
5672 # - compute.backendServices.use
5673 &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
5674 # by defaultUrlRedirect.
5675 #
5676 #
5677 # Only one of defaultUrlRedirect, defaultService
5678 # or defaultRouteAction.weightedBackendService can be set.
5679 #
5680 #
5681 # Not supported when the URL map is bound to a target gRPC proxy.
5682 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
5683 # was supplied in the request.
5684 #
5685 # The value must be from 1 to 255
5686 # characters.
5687 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
5688 # set to HTTPS.
5689 # If set to false, the URL scheme of the redirected request
5690 # remains the same as that of the request.
5691 #
5692 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
5693 #
5694 # The default is set to false.
5695 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
5696 # that was supplied in the request.
5697 #
5698 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
5699 # supplied, the path of the original request is used for the redirect.
5700 #
5701 # The value must be from 1 to 1024 characters.
5702 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
5703 # the HttpRouteRuleMatch, retaining the remaining portion
5704 # of the URL before redirecting the request.
5705 #
5706 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
5707 # supplied, the path of the original request is used for the redirect.
5708 #
5709 # The value must be from 1 to 1024 characters.
5710 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
5711 #
5712 # Supported values are:
5713 #
5714 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
5715 # to 301.
5716 # - FOUND, which corresponds to 302.
5717 # - SEE_OTHER which corresponds to 303.
5718 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
5719 # method is retained.
5720 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
5721 # method is retained.
5722 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
5723 # URL is
5724 # removed before redirecting the request. If set to false, the
5725 # query portion of the original URL is retained.
5726 #
5727 # The default is set to false.
5728 },
5729 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
5730 # create the resource.
5731 &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
5732 # for the selected backend service.
5733 #
5734 # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
5735 #
5736 # HeaderAction is not supported for load balancers
5737 # that have
5738 # their loadBalancingScheme set to EXTERNAL.
5739 #
5740 # Not supported when the URL map is bound to a target gRPC proxy that
5741 # has validateForProxyless field set to true.
5742 # the request is passed along to the selected backendService.
5743 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
5744 { # Specification determining how headers are added to requests or responses.
5745 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
5746 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
5747 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
5748 # that already
5749 # exist for the header. If true, headerValue is set for the
5750 # header, discarding any values that were set for that header.
5751 #
5752 # The default value is true,
5753 # unless a variable is present in headerValue,
5754 # in which case the default value is false.
5755 # .
5756 },
5757 ],
5758 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
5759 # request before forwarding the request to the backendService.
5760 &quot;A String&quot;,
5761 ],
5762 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
5763 # client.
5764 { # Specification determining how headers are added to requests or responses.
5765 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
5766 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
5767 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
5768 # that already
5769 # exist for the header. If true, headerValue is set for the
5770 # header, discarding any values that were set for that header.
5771 #
5772 # The default value is true,
5773 # unless a variable is present in headerValue,
5774 # in which case the default value is false.
5775 # .
5776 },
5777 ],
5778 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
5779 # response before sending the response back to the client.
5780 &quot;A String&quot;,
5781 ],
5782 },
5783 &quot;name&quot;: &quot;A String&quot;, # The name to which this PathMatcher is referred by theHostRule.
5784 &quot;pathRules&quot;: [ # The list of path rules. Use this list instead of routeRules
5785 # when routing based on simple path matching is all that&#x27;s required. A path
5786 # rule can only include a wildcard character (*) after a
5787 # forward slash character (&quot;/&quot;).
5788 #
5789 # The order by which path rules are specified does not matter.
5790 # Matches are always done on the longest-path-first basis.
5791 #
5792 # For example: a pathRule with a path /a/b/c/* will match
5793 # before /a/b/* irrespective of the order in which those paths appear in this
5794 # list.
5795 #
5796 # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
5797 { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
5798 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
5799 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
5800 #
5801 # If a policy for an
5802 # error code is not configured for the PathRule, a policy for
5803 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
5804 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
5805 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
5806 # effect.
5807 #
5808 # For example, consider a UrlMap with the following configuration:
5809 #
5810 #
5811 # - UrlMap.defaultCustomErrorResponsePolicy are configured
5812 # with policies for 5xx and 4xx errors
5813 # - A PathRule for /coming_soon/ is configured for the error
5814 # code 404.
5815 #
5816 # 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
5817 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
5818 # the policy in PathRule.customErrorResponsePolicy takes
5819 # effect. If any of the requests in this example encounter a 500
5820 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
5821 #
5822 # customErrorResponsePolicy is supported only for
5823 # global external Application Load Balancers.
5824 # backend service or backend bucket responds with an error.
5825 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
5826 #
5827 # In a given policy, if you specify rules for both a range of error codes
5828 # as well as rules for specific error codes then rules with specific error
5829 # codes have a higher priority. For example, assume that you configure a rule
5830 # for 401 (Un-authorized) code, and another for all 4 series
5831 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
5832 # However if the backend service returns a 403, the rule for4xx takes effect.
5833 { # Specifies the mapping between the response code that will be returned along
5834 # with the custom error content and the response code returned by the backend
5835 # service.
5836 &quot;matchResponseCodes&quot;: [ # Valid values include:
5837 #
5838 #
5839 # - A number between 400 and 599: For example
5840 # 401 or 503, in which case the load balancer
5841 # applies the policy if the error code exactly matches this value.
5842 # - 5xx: Load Balancer will apply the policy if the
5843 # backend service responds with any response code in the range of
5844 # 500 to 599.
5845 # - 4xx: Load
5846 # Balancer will apply the policy if the backend service responds with any
5847 # response code in the range of 400 to
5848 # 499.
5849 #
5850 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
5851 &quot;A String&quot;,
5852 ],
5853 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
5854 # error content. If overrideResponseCode is not supplied, the
5855 # same response code returned by the original backend bucket or backend
5856 # service is returned to the client.
5857 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
5858 #
5859 # path must start
5860 # with a leading slash. path cannot have trailing slashes.
5861 #
5862 # If the file is not available in backendBucket or the
5863 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
5864 #
5865 # The value must
5866 # be from 1 to 1024 characters
5867 },
5868 ],
5869 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
5870 # contains the custom error content. Examples are:
5871 #
5872 #
5873 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
5874 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
5875 # - global/backendBuckets/myBackendBucket
5876 #
5877 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
5878 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
5879 #
5880 # If load balancer cannot reach
5881 # the backendBucket, a simple Not Found Error will
5882 # be returned, with the original response code (oroverrideResponseCode if configured).
5883 #
5884 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
5885 },
5886 &quot;paths&quot;: [ # The list of path patterns to match. Each must start with /
5887 # and the only place a * is allowed is at the end following
5888 # a /. The string fed to the path matcher does not include
5889 # any text after the first ? or #, and
5890 # those chars are not allowed here.
5891 &quot;A String&quot;,
5892 ],
5893 &quot;routeAction&quot;: { # In response to a matching path, the load balancer
5894 # performs advanced routing actions, such as URL rewrites and header
5895 # transformations, before forwarding the request to the selected
5896 # backend.
5897 #
5898 #
5899 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
5900 #
5901 #
5902 # URL maps for classic Application Load Balancers only support
5903 # the urlRewrite action within a path rule&#x27;srouteAction.
5904 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
5905 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
5906 # property must be specified. This policy cannot be specified if any target
5907 # backend has Identity-Aware Proxy enabled.
5908 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
5909 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
5910 # header names can be specified. The cache is bypassed for all `cacheMode`
5911 # values.
5912 &quot;A String&quot;,
5913 ],
5914 &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
5915 # on the backend type: for Backend Services, the complete request URI is
5916 # used; for Backend Buckets, the request URI is used without the protocol or
5917 # host, and only query parameters known to Cloud Storage are included.
5918 # Policy defined on Route Action.
5919 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
5920 # parameters will be included. Either specify `excludedQueryParameters`
5921 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
5922 # encoded and not treated as delimiters.
5923 #
5924 # Note: This field applies to routes that use backend services. Attempting
5925 # to set it on a route that points exclusively to Backend Buckets will
5926 # result in a configuration error. For routes that point to a Backend
5927 # Bucket, use `includedQueryParameters` to define which parameters should
5928 # be part of the cache key.
5929 &quot;A String&quot;,
5930 ],
5931 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
5932 #
5933 # Note: This setting is only applicable to routes that use a Backend
5934 # Service. It does not affect requests served by a Backend Bucket, as the
5935 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
5936 # it on a route that points exclusively to Backend Buckets will result in a
5937 # configuration error.
5938 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
5939 #
5940 # Note: This setting is only applicable to routes that use a Backend
5941 # Service. It does not affect requests served by a Backend Bucket, as the
5942 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
5943 # set on a route that points exclusively to Backend Buckets will result in
5944 # a configuration error.
5945 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
5946 # `includedQueryParameters` and `excludedQueryParameters`. If neither
5947 # is set, the entire query string will be included. If false, the query
5948 # string will be excluded from the cache key entirely.
5949 #
5950 # Note: This field applies to routes that use backend services. Attempting
5951 # to set it on a route that points exclusively to Backend Buckets will
5952 # result in a configuration error. For routes that point to a Backend
5953 # Bucket, use `includedQueryParameters` to define which parameters should
5954 # be part of the cache key.
5955 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
5956 # The name=value pair will be used in the cache key Cloud CDN generates.
5957 #
5958 # Note: This setting is only applicable to routes that use a Backend
5959 # Service. It does not affect requests served by a Backend Bucket.
5960 # Attempting to set it on a route that points exclusively to Backend
5961 # Buckets will result in a configuration error. Up to 5 cookie names can be
5962 # specified.
5963 &quot;A String&quot;,
5964 ],
5965 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
5966 &quot;A String&quot;,
5967 ],
5968 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
5969 # parameters will be excluded. Either specify `includedQueryParameters`
5970 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
5971 # encoded and not treated as delimiters.
5972 &quot;A String&quot;,
5973 ],
5974 },
5975 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
5976 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
5977 &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
5978 # content. This is used to clamp the max-age (or Expires) value sent to the
5979 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
5980 # is used for the response max-age directive, along with a &quot;public&quot;
5981 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
5982 # clamps the max-age from the origin (if specified), or else sets the
5983 # response max-age directive to the lesser of the `clientTtl` and
5984 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
5985 # present. The maximum allowed value is 31,622,400s (1 year). If not
5986 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
5987 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
5988 # `USE_ORIGIN_HEADERS`.
5989 # as a count of seconds and fractions of seconds at nanosecond
5990 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5991 # or &quot;month&quot;. Range is approximately 10,000 years.
5992 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5993 # Durations less than one second are represented with a 0
5994 # `seconds` field and a positive `nanos` field. Must be from 0
5995 # to 999,999,999 inclusive.
5996 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5997 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5998 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5999 },
6000 &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
6001 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
6002 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
6003 # greater than that of `maxTtl`. When the `cacheMode` is set to
6004 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
6005 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
6006 # accessed objects may be evicted from the cache before the defined TTL. If
6007 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
6008 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
6009 # `USE_ORIGIN_HEADERS`.
6010 # as a count of seconds and fractions of seconds at nanosecond
6011 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6012 # or &quot;month&quot;. Range is approximately 10,000 years.
6013 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6014 # Durations less than one second are represented with a 0
6015 # `seconds` field and a positive `nanos` field. Must be from 0
6016 # to 999,999,999 inclusive.
6017 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6018 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6019 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6020 },
6021 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
6022 # attempt to set a max-age or s-maxage higher than this, or an Expires header
6023 # more than `maxTtl` seconds in the future will be capped at the value of
6024 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
6025 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
6026 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
6027 # Infrequently accessed objects may be evicted from the cache before the
6028 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
6029 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
6030 # mode.
6031 # as a count of seconds and fractions of seconds at nanosecond
6032 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6033 # or &quot;month&quot;. Range is approximately 10,000 years.
6034 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6035 # Durations less than one second are represented with a 0
6036 # `seconds` field and a positive `nanos` field. Must be from 0
6037 # to 999,999,999 inclusive.
6038 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6039 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6040 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6041 },
6042 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
6043 # to apply fine-grained caching for common errors or redirects.
6044 # This can reduce the load on your origin and improve end-user
6045 # experience by reducing response latency.
6046 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
6047 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
6048 # the specified response code that lack any Cache-Control, Expires, or
6049 # Pragma: no-cache directives. When the `cacheMode` is set to
6050 # `FORCE_CACHE_ALL`, negative caching applies to all responses
6051 # with the specified response code, and overrides any caching headers. By
6052 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
6053 #
6054 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
6055 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
6056 # * 405 (Method Not Found), 501 (Not Implemented): 60s
6057 #
6058 # These defaults can be overridden in `negativeCachingPolicy`.
6059 # If not specified, Cloud CDN applies negative caching by default.
6060 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
6061 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
6062 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
6063 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
6064 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
6065 # all response codes that you wish to cache. Cloud CDN will not apply any
6066 # default negative caching when a policy exists.
6067 { # Specify CDN TTLs for response error codes.
6068 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
6069 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
6070 # specified as values, and you cannot specify a status code more than
6071 # once.
6072 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
6073 # corresponding status code.
6074 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
6075 # objects may be evicted from the cache before the defined TTL.
6076 # as a count of seconds and fractions of seconds at nanosecond
6077 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6078 # or &quot;month&quot;. Range is approximately 10,000 years.
6079 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6080 # Durations less than one second are represented with a 0
6081 # `seconds` field and a positive `nanos` field. Must be from 0
6082 # to 999,999,999 inclusive.
6083 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6084 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6085 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6086 },
6087 },
6088 ],
6089 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
6090 # requests into a small number of requests to the origin. If not specified,
6091 # Cloud CDN applies request coalescing by default.
6092 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
6093 # content with the origin, or when an error is encountered when refreshing
6094 # the cache.
6095 # This setting defines the default &quot;max-stale&quot; duration for any cached
6096 # responses that do not specify a max-stale directive. Stale responses that
6097 # exceed the TTL configured here will not be served. The default limit
6098 # (max-stale) is 86400s (1 day), which will allow stale content to be
6099 # served up to this limit beyond the max-age (or s-maxage) of a cached
6100 # response.
6101 # The maximum allowed value is 604800 (1 week).
6102 # Set this to zero (0) to disable serve-while-stale.
6103 # as a count of seconds and fractions of seconds at nanosecond
6104 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6105 # or &quot;month&quot;. Range is approximately 10,000 years.
6106 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6107 # Durations less than one second are represented with a 0
6108 # `seconds` field and a positive `nanos` field. Must be from 0
6109 # to 999,999,999 inclusive.
6110 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6111 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6112 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6113 },
6114 },
6115 &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
6116 # information about the W3C recommendation for cross-origin resource sharing
6117 # (CORS), see Fetch API Living
6118 # Standard.
6119 #
6120 # Not supported when the URL map is bound to a target gRPC proxy.
6121 # information about the W3C recommendation for cross-origin resource sharing
6122 # (CORS), see Fetch API Living
6123 # Standard.
6124 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
6125 # indicates that
6126 # the actual request can include user credentials. This field translates to
6127 # the Access-Control-Allow-Credentials header.
6128 #
6129 # Default is false.
6130 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
6131 # header.
6132 &quot;A String&quot;,
6133 ],
6134 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
6135 # header.
6136 &quot;A String&quot;,
6137 ],
6138 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
6139 # more information, see regular expression syntax.
6140 #
6141 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
6142 #
6143 # Regular expressions can only be used when the loadBalancingScheme is
6144 # set to INTERNAL_SELF_MANAGED.
6145 &quot;A String&quot;,
6146 ],
6147 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
6148 #
6149 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
6150 &quot;A String&quot;,
6151 ],
6152 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
6153 # The default value is false, which indicates that the CORS
6154 # policy is in effect.
6155 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
6156 # header.
6157 &quot;A String&quot;,
6158 ],
6159 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
6160 # seconds. This field translates to the Access-Control-Max-Age
6161 # header.
6162 },
6163 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
6164 # the resiliency of clients to backend service failure. As part of fault
6165 # injection, when clients send requests to a backend service, delays can be
6166 # introduced by a load balancer on a percentage of requests before sending
6167 # those requests to the backend service. Similarly requests from clients can
6168 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
6169 # that are configured with a fault_injection_policy if:
6170 # 1. The traffic is generated by fault injection AND
6171 # 2. The fault injection is not a delay fault injection.
6172 # Fault injection is not supported with the classic Application Load Balancer
6173 # . To see which load balancers support fault injection,
6174 # see Load
6175 # balancing: Routing and traffic management features.
6176 # the resiliency of clients to backend service failure. As part of fault
6177 # injection, when clients send requests to a backend service, delays can be
6178 # introduced by the load balancer on a percentage of requests before sending
6179 # those request to the backend service. Similarly requests from clients can be
6180 # aborted by the load balancer for a percentage of requests.
6181 &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
6182 # injection.
6183 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
6184 #
6185 # The value must be from 200 to 599 inclusive.
6186 #
6187 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
6188 # according to this
6189 # mapping table. HTTP status 200 is mapped to gRPC status
6190 # UNKNOWN. Injecting an OK status is currently not supported by
6191 # Traffic Director.
6192 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
6193 # that is aborted as part of fault injection.
6194 #
6195 # The value must be from 0.0 to 100.0 inclusive.
6196 },
6197 &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
6198 # injection, before being sent to a backend service.
6199 # request to the backend service as part of fault injection.
6200 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
6201 # as a count of seconds and fractions of seconds at nanosecond
6202 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6203 # or &quot;month&quot;. Range is approximately 10,000 years.
6204 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6205 # Durations less than one second are represented with a 0
6206 # `seconds` field and a positive `nanos` field. Must be from 0
6207 # to 999,999,999 inclusive.
6208 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6209 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6210 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6211 },
6212 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
6213 # which a delay is introduced as part of fault injection.
6214 #
6215 # The value must be from 0.0 to 100.0 inclusive.
6216 },
6217 },
6218 &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
6219 # Global EXTERNAL_MANAGED load balancer schemes.
6220 # Either Cloud CDN must be enabled on the backend service or backend bucket
6221 # serving the route, or cache policy must be configured on the same route
6222 # dynamically processes and delivers images from the network edge.
6223 # Image Optimization is only available for Global External Application Load
6224 # Balancers.
6225 # Either Cloud CDN must be enabled on the backend service or backend bucket
6226 # serving the route, or cache policy must be configured on the same route.
6227 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
6228 },
6229 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
6230 # Unlike the timeout field where the timeout duration starts
6231 # from the time the request has been fully processed (known as*end-of-stream*),
6232 # the duration in this field is computed from the beginning of the stream
6233 # until the response has been processed, including all retries. A
6234 # stream that does not complete in this duration is closed.
6235 #
6236 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
6237 # with the route.
6238 #
6239 # This field is only allowed if the Url map is used with backend services
6240 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
6241 # as a count of seconds and fractions of seconds at nanosecond
6242 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6243 # or &quot;month&quot;. Range is approximately 10,000 years.
6244 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6245 # Durations less than one second are represented with a 0
6246 # `seconds` field and a positive `nanos` field. Must be from 0
6247 # to 999,999,999 inclusive.
6248 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6249 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6250 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6251 },
6252 &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
6253 # are shadowed to a separate mirrored backend service. The load balancer does
6254 # not wait for responses from the shadow service. Before sending traffic
6255 # to the shadow service, the host / authority header is suffixed with-shadow.
6256 #
6257 # Not supported when the URL map is bound to a target gRPC proxy that
6258 # has the validateForProxyless field set to true.
6259 # are shadowed to a separate mirrored backend service. The load balancer
6260 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
6261 # to the shadow service, the host or authority header is suffixed with-shadow.
6262 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
6263 # mirrored to.
6264 #
6265 # The backend service configured for a mirroring
6266 # policy must reference backends that are of the same type as the original
6267 # backend service matched in the URL map.
6268 #
6269 # Serverless NEG backends are not currently supported as a mirrored
6270 # backend service.
6271 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
6272 },
6273 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
6274 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
6275 # If not specified, defaults to 1.
6276 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
6277 #
6278 # If not specified, will use the timeout set in theHttpRouteAction field.
6279 # If timeout in the HttpRouteAction field is not set, this field
6280 # uses the largest timeout
6281 # among all backend services associated with the route.
6282 #
6283 # Not supported when the URL map is bound to a target gRPC proxy that
6284 # has the validateForProxyless field set to true.
6285 # as a count of seconds and fractions of seconds at nanosecond
6286 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6287 # or &quot;month&quot;. Range is approximately 10,000 years.
6288 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6289 # Durations less than one second are represented with a 0
6290 # `seconds` field and a positive `nanos` field. Must be from 0
6291 # to 999,999,999 inclusive.
6292 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6293 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6294 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6295 },
6296 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
6297 # values are:
6298 #
6299 # - 5xx: retry is attempted if the instance or endpoint
6300 # responds with any 5xx response code, or if the instance or
6301 # endpoint does not respond at all. For example, disconnects, reset, read
6302 # timeout, connection failure, and refused streams.
6303 # - gateway-error: Similar to 5xx, but only
6304 # applies to response codes 502, 503 or504.
6305 # - connect-failure: a retry is attempted on failures
6306 # connecting to the instance or endpoint. For example, connection
6307 # timeouts.
6308 # - retriable-4xx: a retry is attempted if the instance
6309 # or endpoint responds with a 4xx response code.
6310 # The only error that you can retry is error code 409.
6311 # - refused-stream: a retry is attempted if the instance
6312 # or endpoint resets the stream with a REFUSED_STREAM error
6313 # code. This reset type indicates that it is safe to retry.
6314 # - cancelled: a retry is attempted if the gRPC status
6315 # code in the response header is set to cancelled.
6316 # - deadline-exceeded: a retry is attempted if the gRPC
6317 # status code in the response header is set todeadline-exceeded.
6318 # - internal: a retry is attempted if the gRPC
6319 # status code in the response header is set tointernal.
6320 # - resource-exhausted: a retry is attempted if the gRPC
6321 # status code in the response header is set toresource-exhausted.
6322 # - unavailable: a retry is attempted if the gRPC
6323 # status code in the response header is set tounavailable.
6324 #
6325 # Only the following codes are supported when the URL map is bound to
6326 # target gRPC proxy that has validateForProxyless field set to true.
6327 #
6328 # - cancelled
6329 # - deadline-exceeded
6330 # - internal
6331 # - resource-exhausted
6332 # - unavailable
6333 &quot;A String&quot;,
6334 ],
6335 },
6336 &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
6337 # time the request has been fully processed (known as *end-of-stream*)
6338 # up until the response has been processed. Timeout includes
6339 # all retries.
6340 #
6341 # If not specified, this field uses the largest timeout among all backend
6342 # services associated with the route.
6343 #
6344 # Not supported when the URL map is bound to a target gRPC proxy that
6345 # has validateForProxyless field set to true.
6346 # as a count of seconds and fractions of seconds at nanosecond
6347 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6348 # or &quot;month&quot;. Range is approximately 10,000 years.
6349 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6350 # Durations less than one second are represented with a 0
6351 # `seconds` field and a positive `nanos` field. Must be from 0
6352 # to 999,999,999 inclusive.
6353 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6354 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6355 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6356 },
6357 &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
6358 # to the matched service.
6359 #
6360 # urlRewrite is the only action supported in UrlMaps
6361 # for classic Application Load Balancers.
6362 #
6363 # Not supported when the URL map is bound to a target gRPC proxy that
6364 # has the validateForProxyless field set to true.
6365 # backend service.
6366 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
6367 # host header is replaced with contents of hostRewrite.
6368 #
6369 # The value must be from 1 to 255 characters.
6370 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
6371 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
6372 #
6373 # The value must be from 1 to 1024 characters.
6374 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
6375 # header) using the HTTP template syntax.
6376 #
6377 # A corresponding
6378 # path_template_match must be specified. Any template variables must exist in
6379 # the path_template_match field.
6380 #
6381 #
6382 # - -At least one variable must be specified in the path_template_match
6383 # field
6384 # - You can omit variables from the rewritten URL
6385 # - The * and ** operators cannot be matched
6386 # unless they have a corresponding variable name - e.g.
6387 # {format=*} or {var=**}.
6388 #
6389 # For example, a path_template_match of /static/{format=**}
6390 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
6391 # rewrite, so that /{country}/{format}/{suffix=**} can be
6392 # rewritten as /content/{format}/{country}/{suffix}.
6393 #
6394 # At least
6395 # one non-empty routeRules[].matchRules[].path_template_match is
6396 # required.
6397 #
6398 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
6399 },
6400 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
6401 # occurs. The weights determine the fraction of traffic that flows to
6402 # their corresponding backend service. If all traffic needs to
6403 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
6404 #
6405 # After a backend service is identified and before forwarding
6406 # the request to
6407 # the backend service, advanced routing actions such as URL rewrites and
6408 # header transformations are applied depending on additional settings
6409 # specified in this HttpRouteAction.
6410 { # In contrast to a single BackendService in
6411 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
6412 # multiple backend services. The volume of traffic for each
6413 # backend service is proportional to the weight specified
6414 # in each WeightedBackendService
6415 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
6416 # resource. Before
6417 # forwarding the request to backendService, the load balancer
6418 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
6419 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
6420 # effect for the selected backendService.
6421 #
6422 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
6423 #
6424 # headerAction is not supported for load balancers that have
6425 # their loadBalancingScheme set to EXTERNAL.
6426 #
6427 # Not supported when the URL map is bound to a target gRPC proxy that
6428 # has validateForProxyless field set to true.
6429 # the request is passed along to the selected backendService.
6430 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
6431 { # Specification determining how headers are added to requests or responses.
6432 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
6433 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
6434 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
6435 # that already
6436 # exist for the header. If true, headerValue is set for the
6437 # header, discarding any values that were set for that header.
6438 #
6439 # The default value is true,
6440 # unless a variable is present in headerValue,
6441 # in which case the default value is false.
6442 # .
6443 },
6444 ],
6445 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
6446 # request before forwarding the request to the backendService.
6447 &quot;A String&quot;,
6448 ],
6449 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
6450 # client.
6451 { # Specification determining how headers are added to requests or responses.
6452 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
6453 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
6454 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
6455 # that already
6456 # exist for the header. If true, headerValue is set for the
6457 # header, discarding any values that were set for that header.
6458 #
6459 # The default value is true,
6460 # unless a variable is present in headerValue,
6461 # in which case the default value is false.
6462 # .
6463 },
6464 ],
6465 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
6466 # response before sending the response back to the client.
6467 &quot;A String&quot;,
6468 ],
6469 },
6470 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
6471 # computed asweight / (sum of all weightedBackendService weights in routeAction).
6472 #
6473 # The selection of a backend service is determined only for new traffic.
6474 # Once a user&#x27;s request has been directed to a backend service,
6475 # subsequent requests are sent to the same backend service as
6476 # determined by the backend service&#x27;s session affinity policy.
6477 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
6478 # splitting. If you do, the weighted traffic splitting configuration takes
6479 # precedence.
6480 #
6481 # The value must be from 0 to 1000.
6482 },
6483 ],
6484 },
6485 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
6486 # is directed if this rule is matched. If routeAction is
6487 # also specified, advanced routing actions, such as URL rewrites,
6488 # take effect before sending the request to the backend.
6489 #
6490 #
6491 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
6492 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
6493 # specified by urlRedirect.
6494 #
6495 #
6496 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
6497 #
6498 #
6499 # Not supported when the URL map is bound to a target gRPC proxy.
6500 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
6501 # was supplied in the request.
6502 #
6503 # The value must be from 1 to 255
6504 # characters.
6505 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
6506 # set to HTTPS.
6507 # If set to false, the URL scheme of the redirected request
6508 # remains the same as that of the request.
6509 #
6510 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
6511 #
6512 # The default is set to false.
6513 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
6514 # that was supplied in the request.
6515 #
6516 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
6517 # supplied, the path of the original request is used for the redirect.
6518 #
6519 # The value must be from 1 to 1024 characters.
6520 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
6521 # the HttpRouteRuleMatch, retaining the remaining portion
6522 # of the URL before redirecting the request.
6523 #
6524 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
6525 # supplied, the path of the original request is used for the redirect.
6526 #
6527 # The value must be from 1 to 1024 characters.
6528 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
6529 #
6530 # Supported values are:
6531 #
6532 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
6533 # to 301.
6534 # - FOUND, which corresponds to 302.
6535 # - SEE_OTHER which corresponds to 303.
6536 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
6537 # method is retained.
6538 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
6539 # method is retained.
6540 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
6541 # URL is
6542 # removed before redirecting the request. If set to false, the
6543 # query portion of the original URL is retained.
6544 #
6545 # The default is set to false.
6546 },
6547 },
6548 ],
6549 &quot;routeRules&quot;: [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
6550 # desired. routeRules are evaluated in order of priority, from
6551 # the lowest to highest number.
6552 #
6553 # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
6554 { # The HttpRouteRule setting specifies how to match an HTTP request
6555 # and the corresponding routing action that load balancing proxies perform.
6556 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
6557 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
6558 #
6559 # If a policy for an
6560 # error code is not configured for the RouteRule, a policy for
6561 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
6562 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
6563 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
6564 # effect.
6565 #
6566 # For example, consider a UrlMap with the following configuration:
6567 #
6568 #
6569 # - UrlMap.defaultCustomErrorResponsePolicy are configured
6570 # with policies for 5xx and 4xx errors
6571 # - A RouteRule for /coming_soon/ is configured for the
6572 # error code 404.
6573 #
6574 # 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
6575 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
6576 # the policy in RouteRule.customErrorResponsePolicy takes
6577 # effect. If any of the requests in this example encounter a 500
6578 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
6579 #
6580 # When
6581 # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
6582 # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
6583 # a retry, if load balancer is successful in reaching the
6584 # service, the customErrorResponsePolicy is ignored and
6585 # the response from the service is returned to the client.
6586 #
6587 # customErrorResponsePolicy is supported only for
6588 # global external Application Load Balancers.
6589 # backend service or backend bucket responds with an error.
6590 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
6591 #
6592 # In a given policy, if you specify rules for both a range of error codes
6593 # as well as rules for specific error codes then rules with specific error
6594 # codes have a higher priority. For example, assume that you configure a rule
6595 # for 401 (Un-authorized) code, and another for all 4 series
6596 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
6597 # However if the backend service returns a 403, the rule for4xx takes effect.
6598 { # Specifies the mapping between the response code that will be returned along
6599 # with the custom error content and the response code returned by the backend
6600 # service.
6601 &quot;matchResponseCodes&quot;: [ # Valid values include:
6602 #
6603 #
6604 # - A number between 400 and 599: For example
6605 # 401 or 503, in which case the load balancer
6606 # applies the policy if the error code exactly matches this value.
6607 # - 5xx: Load Balancer will apply the policy if the
6608 # backend service responds with any response code in the range of
6609 # 500 to 599.
6610 # - 4xx: Load
6611 # Balancer will apply the policy if the backend service responds with any
6612 # response code in the range of 400 to
6613 # 499.
6614 #
6615 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
6616 &quot;A String&quot;,
6617 ],
6618 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
6619 # error content. If overrideResponseCode is not supplied, the
6620 # same response code returned by the original backend bucket or backend
6621 # service is returned to the client.
6622 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
6623 #
6624 # path must start
6625 # with a leading slash. path cannot have trailing slashes.
6626 #
6627 # If the file is not available in backendBucket or the
6628 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
6629 #
6630 # The value must
6631 # be from 1 to 1024 characters
6632 },
6633 ],
6634 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
6635 # contains the custom error content. Examples are:
6636 #
6637 #
6638 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
6639 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
6640 # - global/backendBuckets/myBackendBucket
6641 #
6642 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
6643 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
6644 #
6645 # If load balancer cannot reach
6646 # the backendBucket, a simple Not Found Error will
6647 # be returned, with the original response code (oroverrideResponseCode if configured).
6648 #
6649 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
6650 },
6651 &quot;description&quot;: &quot;A String&quot;, # The short description conveying the intent of this routeRule.
6652 #
6653 #
6654 # The description can have a maximum length of 1024 characters.
6655 &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
6656 # for the selected backendService.
6657 #
6658 # The headerAction value specified here is applied before the
6659 # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
6660 #
6661 # HeaderAction is not supported for load balancers
6662 # that have
6663 # their loadBalancingScheme set to EXTERNAL.
6664 #
6665 # Not supported when the URL map is bound to a target gRPC proxy that
6666 # has validateForProxyless field set to true.
6667 # the request is passed along to the selected backendService.
6668 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
6669 { # Specification determining how headers are added to requests or responses.
6670 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
6671 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
6672 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
6673 # that already
6674 # exist for the header. If true, headerValue is set for the
6675 # header, discarding any values that were set for that header.
6676 #
6677 # The default value is true,
6678 # unless a variable is present in headerValue,
6679 # in which case the default value is false.
6680 # .
6681 },
6682 ],
6683 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
6684 # request before forwarding the request to the backendService.
6685 &quot;A String&quot;,
6686 ],
6687 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
6688 # client.
6689 { # Specification determining how headers are added to requests or responses.
6690 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
6691 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
6692 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
6693 # that already
6694 # exist for the header. If true, headerValue is set for the
6695 # header, discarding any values that were set for that header.
6696 #
6697 # The default value is true,
6698 # unless a variable is present in headerValue,
6699 # in which case the default value is false.
6700 # .
6701 },
6702 ],
6703 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
6704 # response before sending the response back to the client.
6705 &quot;A String&quot;,
6706 ],
6707 },
6708 &quot;httpFilterConfigs&quot;: [ # Outbound route specific configuration fornetworkservices.HttpFilter resources enabled by Traffic
6709 # Director. httpFilterConfigs only applies for load balancers
6710 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
6711 # more details.
6712 #
6713 # Not supported when the URL map is bound to a target gRPC proxy that
6714 # has validateForProxyless field set to true.
6715 { # HttpFilterConfiguration supplies additional contextual settings
6716 # for networkservices.HttpFilter resources enabled by Traffic
6717 # Director.
6718 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
6719 # YAML formatted and only contain fields defined in the protobuf identified
6720 # in configTypeUrl
6721 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
6722 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
6723 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
6724 # configuration belongs to. This name must be known to the xDS client.
6725 # Example: envoy.wasm
6726 },
6727 ],
6728 &quot;httpFilterMetadata&quot;: [ # Outbound route specific metadata supplied tonetworkservices.HttpFilter resources enabled by Traffic
6729 # Director. httpFilterMetadata only applies for load balancers
6730 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
6731 # more details.
6732 #
6733 # The only configTypeUrl supported istype.googleapis.com/google.protobuf.Struct
6734 #
6735 # Not supported when the URL map is bound to a target gRPC proxy that
6736 # has validateForProxyless field set to true.
6737 { # HttpFilterConfiguration supplies additional contextual settings
6738 # for networkservices.HttpFilter resources enabled by Traffic
6739 # Director.
6740 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
6741 # YAML formatted and only contain fields defined in the protobuf identified
6742 # in configTypeUrl
6743 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
6744 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
6745 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
6746 # configuration belongs to. This name must be known to the xDS client.
6747 # Example: envoy.wasm
6748 },
6749 ],
6750 &quot;matchRules&quot;: [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
6751 # this routeRule when any of thematchRules are satisfied. However predicates within
6752 # a given matchRule have AND semantics. All predicates
6753 # within a matchRule must match for the request to
6754 # match the rule.
6755 { # HttpRouteRuleMatch specifies a set of criteria for matching
6756 # requests to an HttpRouteRule. All specified criteria must
6757 # be satisfied for a match to occur.
6758 &quot;fullPathMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
6759 # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
6760 # that may be part of the original URL.
6761 #
6762 # fullPathMatch must be from 1 to 1024 characters.
6763 #
6764 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
6765 # specified.
6766 &quot;headerMatches&quot;: [ # Specifies a list of header match criteria, all of which must match
6767 # corresponding headers in the request.
6768 { # matchRule criteria for request header matches.
6769 &quot;exactMatch&quot;: &quot;A String&quot;, # The value should exactly match contents of exactMatch.
6770 #
6771 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
6772 &quot;headerName&quot;: &quot;A String&quot;, # The name of the HTTP header to match.
6773 #
6774 # For matching against the HTTP request&#x27;s authority, use a headerMatch
6775 # with the header name &quot;:authority&quot;.
6776 #
6777 # For matching a request&#x27;s method, use the headerName &quot;:method&quot;.
6778 #
6779 # When the URL map is bound to a target gRPC proxy that has
6780 # the validateForProxyless field set to true, only
6781 # non-binary
6782 # user-specified custom metadata and the `content-type` header are supported.
6783 # The following transport-level headers cannot be used in header matching
6784 # rules:
6785 # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
6786 # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
6787 # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
6788 # `grpc-timeout` and `grpc-trace-bin`.
6789 &quot;invertMatch&quot;: True or False, # If set to false, the headerMatch is considered a
6790 # match if the preceding match criteria are met. If set to true,
6791 # the headerMatch is considered a match if the preceding
6792 # match criteria are NOT met.
6793 #
6794 # The default setting is false.
6795 &quot;prefixMatch&quot;: &quot;A String&quot;, # The value of the header must start with the contents ofprefixMatch.
6796 #
6797 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
6798 &quot;presentMatch&quot;: True or False, # A header with the contents of headerName must exist. The
6799 # match takes place whether or not the request&#x27;s header has a value.
6800 #
6801 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
6802 &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
6803 # specified in rangeMatch. If the header does not contain an
6804 # integer, number or is empty, the match fails.
6805 #
6806 # For example for a range [-5, 0]
6807 #
6808 #
6809 # - -3 will match.
6810 # - 0 will not match.
6811 # - 0.25 will not match.
6812 # - -3someString will not match.
6813 #
6814 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
6815 #
6816 # rangeMatch is not supported for load balancers
6817 # that have loadBalancingScheme set to EXTERNAL.
6818 # within the specified integer range.
6819 &quot;rangeEnd&quot;: &quot;A String&quot;, # The end of the range (exclusive) in signed long integer format.
6820 &quot;rangeStart&quot;: &quot;A String&quot;, # The start of the range (inclusive) in signed long integer format.
6821 },
6822 &quot;regexMatch&quot;: &quot;A String&quot;, # The value of the header must match the regular expression specified inregexMatch.
6823 # For more information about regular expression syntax, see Syntax.
6824 #
6825 # For matching against a port specified in the HTTP request, use a
6826 # headerMatch with headerName set to PORT and a regular expression that
6827 # satisfies the RFC2616 Host header&#x27;s port specifier.
6828 #
6829 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
6830 #
6831 # Regular expressions can only be used when the loadBalancingScheme is
6832 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
6833 # (regional scope) or INTERNAL_MANAGED.
6834 &quot;suffixMatch&quot;: &quot;A String&quot;, # The value of the header must end with the contents ofsuffixMatch.
6835 #
6836 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
6837 },
6838 ],
6839 &quot;ignoreCase&quot;: True or False, # Specifies that prefixMatch and fullPathMatch
6840 # matches are case sensitive.
6841 #
6842 # The default value is false.
6843 #
6844 # ignoreCase must not be used with regexMatch.
6845 #
6846 # Not supported when the URL map is bound to a target gRPC proxy.
6847 &quot;metadataFilters&quot;: [ # Opaque filter criteria used by the load balancer to restrict routing
6848 # configuration to a limited set of xDS
6849 # compliant clients. In their xDS requests to the load balancer, xDS clients
6850 # present node
6851 # metadata. When there is a match, the relevant routing configuration
6852 # is made available to those proxies.
6853 #
6854 # 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
6855 # the metadata. If its filterMatchCriteria is set to
6856 # MATCH_ALL, then all of its filterLabels must match with
6857 # corresponding labels provided in the metadata. If multiple
6858 # metadata filters are specified, all of them need to be
6859 # satisfied in order to be considered a match.
6860 #
6861 # metadataFilters specified here is applied after those
6862 # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
6863 #
6864 # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
6865 #
6866 # Not supported when the URL map is bound to a target gRPC proxy that
6867 # has validateForProxyless field set to true.
6868 { # Opaque filter criteria used by load balancers to restrict routing
6869 # configuration to a limited set of load balancing proxies. Proxies and
6870 # sidecars involved in load balancing would typically present metadata to the
6871 # load balancers that need to match criteria specified here. If a match takes
6872 # place, the relevant configuration is made available to those
6873 # proxies.
6874 #
6875 # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
6876 # one of thefilterLabels must match the corresponding label provided in
6877 # the metadata. If its filterMatchCriteria is set to
6878 # MATCH_ALL, then all of its filterLabels must match with
6879 # corresponding labels provided in the metadata.
6880 #
6881 # An example for using metadataFilters would be: if
6882 # load balancing involves
6883 # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in of their XDS requests to loadbalancers.
6884 &quot;filterLabels&quot;: [ # The list of label value pairs that must match labels in the provided
6885 # metadata based on filterMatchCriteria
6886 #
6887 # This list must not be empty and can have at the most 64 entries.
6888 { # MetadataFilter label name value pairs that are expected
6889 # to match corresponding labels presented as metadata to the load balancer.
6890 &quot;name&quot;: &quot;A String&quot;, # Name of metadata label.
6891 #
6892 # The name can have a maximum length of 1024 characters and must be at
6893 # least 1 character long.
6894 &quot;value&quot;: &quot;A String&quot;, # The value of the label must match the specified value.
6895 #
6896 # value can have a maximum length of 1024 characters.
6897 },
6898 ],
6899 &quot;filterMatchCriteria&quot;: &quot;A String&quot;, # Specifies how individual filter label matches
6900 # within the list of filterLabels and contributes toward the
6901 # overall metadataFilter match.
6902 #
6903 # Supported values are:
6904 #
6905 # - MATCH_ANY: at least one of the filterLabels
6906 # must have a matching label in the provided metadata.
6907 # - MATCH_ALL: all filterLabels must have
6908 # matching labels in the provided metadata.
6909 },
6910 ],
6911 &quot;pathTemplateMatch&quot;: &quot;A String&quot;, # If specified, this field defines a path template pattern that must match
6912 # the :path header after the query string is removed.
6913 #
6914 # A path template pattern can include variables and wildcards.
6915 # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
6916 # matches a single path segment, and ** that matches zero or
6917 # more path segments. The pattern must follow these rules:
6918 #
6919 #
6920 # - The value must be between 1 and 1024 characters.
6921 # - The pattern must start with a leading slash (&quot;/&quot;).
6922 # - No more than 5 operators (variables or wildcards) may appear in
6923 # the pattern.
6924 #
6925 # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
6926 # set.
6927 &quot;prefixMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the request&#x27;s
6928 # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
6929 #
6930 # The value must be from 1 to 1024 characters.
6931 #
6932 # The * character inside a prefix match is
6933 # treated as a literal character, not as a wildcard.
6934 #
6935 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
6936 # used within a matchRule.
6937 &quot;queryParameterMatches&quot;: [ # Specifies a list of query parameter match criteria, all of which must
6938 # match corresponding query parameters in the request.
6939 #
6940 # Not supported when the URL map is bound to a target gRPC proxy.
6941 { # HttpRouteRuleMatch criteria for a request&#x27;s query parameter.
6942 &quot;exactMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
6943 # parameter exactly matches the contents of exactMatch.
6944 #
6945 # Only one of presentMatch, exactMatch, orregexMatch must be set.
6946 &quot;name&quot;: &quot;A String&quot;, # The name of the query parameter to match. The query parameter must exist in
6947 # the request, in the absence of which the request match fails.
6948 &quot;presentMatch&quot;: True or False, # Specifies that the queryParameterMatch matches if the
6949 # request contains the query parameter, irrespective of whether the
6950 # parameter has a value or not.
6951 #
6952 # Only one of presentMatch, exactMatch, orregexMatch must be set.
6953 &quot;regexMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
6954 # parameter matches the regular expression specified byregexMatch. For
6955 # more information about regular expression syntax, see Syntax.
6956 #
6957 # Only one of presentMatch, exactMatch, orregexMatch must be set.
6958 #
6959 # Regular expressions can only be used when the loadBalancingScheme is
6960 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
6961 # (regional scope) or INTERNAL_MANAGED.
6962 },
6963 ],
6964 &quot;regexMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
6965 # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
6966 # supplied with the original URL. For
6967 # more information about regular expression syntax, see Syntax.
6968 #
6969 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
6970 # specified.
6971 #
6972 # Regular expressions can only be used when the loadBalancingScheme is
6973 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
6974 # (regional scope) or INTERNAL_MANAGED.
6975 },
6976 ],
6977 &quot;priority&quot;: 42, # For routeRules within a given pathMatcher,
6978 # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
6979 # of priority, from the lowest to highest number. The priority of a
6980 # rule decreases as its number increases (1, 2, 3, N+1). The first rule
6981 # that matches the request is applied.
6982 #
6983 #
6984 # You cannot configure two or more routeRules with the same priority.
6985 # Priority for each rule must be set to a number from 0 to 2147483647
6986 # inclusive.
6987 #
6988 #
6989 # Priority numbers can have gaps, which enable you to add or remove rules
6990 # in the future without affecting the rest of the rules. For example, 1, 2,
6991 # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
6992 # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
6993 # without any impact on existing rules.
6994 &quot;routeAction&quot;: { # In response to a matching matchRule, the load balancer
6995 # performs advanced routing actions, such as URL rewrites and header
6996 # transformations, before forwarding the request to the selected backend.
6997 #
6998 #
6999 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
7000 #
7001 #
7002 # URL maps for classic Application Load Balancers only support
7003 # the urlRewrite action within a route rule&#x27;srouteAction.
7004 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
7005 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
7006 # property must be specified. This policy cannot be specified if any target
7007 # backend has Identity-Aware Proxy enabled.
7008 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
7009 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
7010 # header names can be specified. The cache is bypassed for all `cacheMode`
7011 # values.
7012 &quot;A String&quot;,
7013 ],
7014 &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
7015 # on the backend type: for Backend Services, the complete request URI is
7016 # used; for Backend Buckets, the request URI is used without the protocol or
7017 # host, and only query parameters known to Cloud Storage are included.
7018 # Policy defined on Route Action.
7019 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
7020 # parameters will be included. Either specify `excludedQueryParameters`
7021 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
7022 # encoded and not treated as delimiters.
7023 #
7024 # Note: This field applies to routes that use backend services. Attempting
7025 # to set it on a route that points exclusively to Backend Buckets will
7026 # result in a configuration error. For routes that point to a Backend
7027 # Bucket, use `includedQueryParameters` to define which parameters should
7028 # be part of the cache key.
7029 &quot;A String&quot;,
7030 ],
7031 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
7032 #
7033 # Note: This setting is only applicable to routes that use a Backend
7034 # Service. It does not affect requests served by a Backend Bucket, as the
7035 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
7036 # it on a route that points exclusively to Backend Buckets will result in a
7037 # configuration error.
7038 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
7039 #
7040 # Note: This setting is only applicable to routes that use a Backend
7041 # Service. It does not affect requests served by a Backend Bucket, as the
7042 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
7043 # set on a route that points exclusively to Backend Buckets will result in
7044 # a configuration error.
7045 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
7046 # `includedQueryParameters` and `excludedQueryParameters`. If neither
7047 # is set, the entire query string will be included. If false, the query
7048 # string will be excluded from the cache key entirely.
7049 #
7050 # Note: This field applies to routes that use backend services. Attempting
7051 # to set it on a route that points exclusively to Backend Buckets will
7052 # result in a configuration error. For routes that point to a Backend
7053 # Bucket, use `includedQueryParameters` to define which parameters should
7054 # be part of the cache key.
7055 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
7056 # The name=value pair will be used in the cache key Cloud CDN generates.
7057 #
7058 # Note: This setting is only applicable to routes that use a Backend
7059 # Service. It does not affect requests served by a Backend Bucket.
7060 # Attempting to set it on a route that points exclusively to Backend
7061 # Buckets will result in a configuration error. Up to 5 cookie names can be
7062 # specified.
7063 &quot;A String&quot;,
7064 ],
7065 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
7066 &quot;A String&quot;,
7067 ],
7068 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
7069 # parameters will be excluded. Either specify `includedQueryParameters`
7070 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
7071 # encoded and not treated as delimiters.
7072 &quot;A String&quot;,
7073 ],
7074 },
7075 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
7076 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
7077 &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
7078 # content. This is used to clamp the max-age (or Expires) value sent to the
7079 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
7080 # is used for the response max-age directive, along with a &quot;public&quot;
7081 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
7082 # clamps the max-age from the origin (if specified), or else sets the
7083 # response max-age directive to the lesser of the `clientTtl` and
7084 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
7085 # present. The maximum allowed value is 31,622,400s (1 year). If not
7086 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
7087 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
7088 # `USE_ORIGIN_HEADERS`.
7089 # as a count of seconds and fractions of seconds at nanosecond
7090 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7091 # or &quot;month&quot;. Range is approximately 10,000 years.
7092 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7093 # Durations less than one second are represented with a 0
7094 # `seconds` field and a positive `nanos` field. Must be from 0
7095 # to 999,999,999 inclusive.
7096 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7097 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7098 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7099 },
7100 &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
7101 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
7102 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
7103 # greater than that of `maxTtl`. When the `cacheMode` is set to
7104 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
7105 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
7106 # accessed objects may be evicted from the cache before the defined TTL. If
7107 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
7108 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
7109 # `USE_ORIGIN_HEADERS`.
7110 # as a count of seconds and fractions of seconds at nanosecond
7111 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7112 # or &quot;month&quot;. Range is approximately 10,000 years.
7113 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7114 # Durations less than one second are represented with a 0
7115 # `seconds` field and a positive `nanos` field. Must be from 0
7116 # to 999,999,999 inclusive.
7117 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7118 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7119 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7120 },
7121 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
7122 # attempt to set a max-age or s-maxage higher than this, or an Expires header
7123 # more than `maxTtl` seconds in the future will be capped at the value of
7124 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
7125 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
7126 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
7127 # Infrequently accessed objects may be evicted from the cache before the
7128 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
7129 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
7130 # mode.
7131 # as a count of seconds and fractions of seconds at nanosecond
7132 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7133 # or &quot;month&quot;. Range is approximately 10,000 years.
7134 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7135 # Durations less than one second are represented with a 0
7136 # `seconds` field and a positive `nanos` field. Must be from 0
7137 # to 999,999,999 inclusive.
7138 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7139 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7140 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7141 },
7142 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
7143 # to apply fine-grained caching for common errors or redirects.
7144 # This can reduce the load on your origin and improve end-user
7145 # experience by reducing response latency.
7146 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
7147 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
7148 # the specified response code that lack any Cache-Control, Expires, or
7149 # Pragma: no-cache directives. When the `cacheMode` is set to
7150 # `FORCE_CACHE_ALL`, negative caching applies to all responses
7151 # with the specified response code, and overrides any caching headers. By
7152 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
7153 #
7154 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
7155 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
7156 # * 405 (Method Not Found), 501 (Not Implemented): 60s
7157 #
7158 # These defaults can be overridden in `negativeCachingPolicy`.
7159 # If not specified, Cloud CDN applies negative caching by default.
7160 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
7161 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
7162 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
7163 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
7164 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
7165 # all response codes that you wish to cache. Cloud CDN will not apply any
7166 # default negative caching when a policy exists.
7167 { # Specify CDN TTLs for response error codes.
7168 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
7169 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
7170 # specified as values, and you cannot specify a status code more than
7171 # once.
7172 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
7173 # corresponding status code.
7174 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
7175 # objects may be evicted from the cache before the defined TTL.
7176 # as a count of seconds and fractions of seconds at nanosecond
7177 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7178 # or &quot;month&quot;. Range is approximately 10,000 years.
7179 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7180 # Durations less than one second are represented with a 0
7181 # `seconds` field and a positive `nanos` field. Must be from 0
7182 # to 999,999,999 inclusive.
7183 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7184 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7185 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7186 },
7187 },
7188 ],
7189 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
7190 # requests into a small number of requests to the origin. If not specified,
7191 # Cloud CDN applies request coalescing by default.
7192 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
7193 # content with the origin, or when an error is encountered when refreshing
7194 # the cache.
7195 # This setting defines the default &quot;max-stale&quot; duration for any cached
7196 # responses that do not specify a max-stale directive. Stale responses that
7197 # exceed the TTL configured here will not be served. The default limit
7198 # (max-stale) is 86400s (1 day), which will allow stale content to be
7199 # served up to this limit beyond the max-age (or s-maxage) of a cached
7200 # response.
7201 # The maximum allowed value is 604800 (1 week).
7202 # Set this to zero (0) to disable serve-while-stale.
7203 # as a count of seconds and fractions of seconds at nanosecond
7204 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7205 # or &quot;month&quot;. Range is approximately 10,000 years.
7206 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7207 # Durations less than one second are represented with a 0
7208 # `seconds` field and a positive `nanos` field. Must be from 0
7209 # to 999,999,999 inclusive.
7210 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7211 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7212 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7213 },
7214 },
7215 &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
7216 # information about the W3C recommendation for cross-origin resource sharing
7217 # (CORS), see Fetch API Living
7218 # Standard.
7219 #
7220 # Not supported when the URL map is bound to a target gRPC proxy.
7221 # information about the W3C recommendation for cross-origin resource sharing
7222 # (CORS), see Fetch API Living
7223 # Standard.
7224 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
7225 # indicates that
7226 # the actual request can include user credentials. This field translates to
7227 # the Access-Control-Allow-Credentials header.
7228 #
7229 # Default is false.
7230 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
7231 # header.
7232 &quot;A String&quot;,
7233 ],
7234 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
7235 # header.
7236 &quot;A String&quot;,
7237 ],
7238 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
7239 # more information, see regular expression syntax.
7240 #
7241 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
7242 #
7243 # Regular expressions can only be used when the loadBalancingScheme is
7244 # set to INTERNAL_SELF_MANAGED.
7245 &quot;A String&quot;,
7246 ],
7247 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
7248 #
7249 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
7250 &quot;A String&quot;,
7251 ],
7252 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
7253 # The default value is false, which indicates that the CORS
7254 # policy is in effect.
7255 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
7256 # header.
7257 &quot;A String&quot;,
7258 ],
7259 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
7260 # seconds. This field translates to the Access-Control-Max-Age
7261 # header.
7262 },
7263 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
7264 # the resiliency of clients to backend service failure. As part of fault
7265 # injection, when clients send requests to a backend service, delays can be
7266 # introduced by a load balancer on a percentage of requests before sending
7267 # those requests to the backend service. Similarly requests from clients can
7268 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
7269 # that are configured with a fault_injection_policy if:
7270 # 1. The traffic is generated by fault injection AND
7271 # 2. The fault injection is not a delay fault injection.
7272 # Fault injection is not supported with the classic Application Load Balancer
7273 # . To see which load balancers support fault injection,
7274 # see Load
7275 # balancing: Routing and traffic management features.
7276 # the resiliency of clients to backend service failure. As part of fault
7277 # injection, when clients send requests to a backend service, delays can be
7278 # introduced by the load balancer on a percentage of requests before sending
7279 # those request to the backend service. Similarly requests from clients can be
7280 # aborted by the load balancer for a percentage of requests.
7281 &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
7282 # injection.
7283 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
7284 #
7285 # The value must be from 200 to 599 inclusive.
7286 #
7287 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
7288 # according to this
7289 # mapping table. HTTP status 200 is mapped to gRPC status
7290 # UNKNOWN. Injecting an OK status is currently not supported by
7291 # Traffic Director.
7292 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
7293 # that is aborted as part of fault injection.
7294 #
7295 # The value must be from 0.0 to 100.0 inclusive.
7296 },
7297 &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
7298 # injection, before being sent to a backend service.
7299 # request to the backend service as part of fault injection.
7300 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
7301 # as a count of seconds and fractions of seconds at nanosecond
7302 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7303 # or &quot;month&quot;. Range is approximately 10,000 years.
7304 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7305 # Durations less than one second are represented with a 0
7306 # `seconds` field and a positive `nanos` field. Must be from 0
7307 # to 999,999,999 inclusive.
7308 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7309 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7310 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7311 },
7312 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
7313 # which a delay is introduced as part of fault injection.
7314 #
7315 # The value must be from 0.0 to 100.0 inclusive.
7316 },
7317 },
7318 &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
7319 # Global EXTERNAL_MANAGED load balancer schemes.
7320 # Either Cloud CDN must be enabled on the backend service or backend bucket
7321 # serving the route, or cache policy must be configured on the same route
7322 # dynamically processes and delivers images from the network edge.
7323 # Image Optimization is only available for Global External Application Load
7324 # Balancers.
7325 # Either Cloud CDN must be enabled on the backend service or backend bucket
7326 # serving the route, or cache policy must be configured on the same route.
7327 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
7328 },
7329 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
7330 # Unlike the timeout field where the timeout duration starts
7331 # from the time the request has been fully processed (known as*end-of-stream*),
7332 # the duration in this field is computed from the beginning of the stream
7333 # until the response has been processed, including all retries. A
7334 # stream that does not complete in this duration is closed.
7335 #
7336 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
7337 # with the route.
7338 #
7339 # This field is only allowed if the Url map is used with backend services
7340 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
7341 # as a count of seconds and fractions of seconds at nanosecond
7342 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7343 # or &quot;month&quot;. Range is approximately 10,000 years.
7344 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7345 # Durations less than one second are represented with a 0
7346 # `seconds` field and a positive `nanos` field. Must be from 0
7347 # to 999,999,999 inclusive.
7348 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7349 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7350 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7351 },
7352 &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
7353 # are shadowed to a separate mirrored backend service. The load balancer does
7354 # not wait for responses from the shadow service. Before sending traffic
7355 # to the shadow service, the host / authority header is suffixed with-shadow.
7356 #
7357 # Not supported when the URL map is bound to a target gRPC proxy that
7358 # has the validateForProxyless field set to true.
7359 # are shadowed to a separate mirrored backend service. The load balancer
7360 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
7361 # to the shadow service, the host or authority header is suffixed with-shadow.
7362 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
7363 # mirrored to.
7364 #
7365 # The backend service configured for a mirroring
7366 # policy must reference backends that are of the same type as the original
7367 # backend service matched in the URL map.
7368 #
7369 # Serverless NEG backends are not currently supported as a mirrored
7370 # backend service.
7371 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
7372 },
7373 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
7374 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
7375 # If not specified, defaults to 1.
7376 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
7377 #
7378 # If not specified, will use the timeout set in theHttpRouteAction field.
7379 # If timeout in the HttpRouteAction field is not set, this field
7380 # uses the largest timeout
7381 # among all backend services associated with the route.
7382 #
7383 # Not supported when the URL map is bound to a target gRPC proxy that
7384 # has the validateForProxyless field set to true.
7385 # as a count of seconds and fractions of seconds at nanosecond
7386 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7387 # or &quot;month&quot;. Range is approximately 10,000 years.
7388 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7389 # Durations less than one second are represented with a 0
7390 # `seconds` field and a positive `nanos` field. Must be from 0
7391 # to 999,999,999 inclusive.
7392 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7393 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7394 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7395 },
7396 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
7397 # values are:
7398 #
7399 # - 5xx: retry is attempted if the instance or endpoint
7400 # responds with any 5xx response code, or if the instance or
7401 # endpoint does not respond at all. For example, disconnects, reset, read
7402 # timeout, connection failure, and refused streams.
7403 # - gateway-error: Similar to 5xx, but only
7404 # applies to response codes 502, 503 or504.
7405 # - connect-failure: a retry is attempted on failures
7406 # connecting to the instance or endpoint. For example, connection
7407 # timeouts.
7408 # - retriable-4xx: a retry is attempted if the instance
7409 # or endpoint responds with a 4xx response code.
7410 # The only error that you can retry is error code 409.
7411 # - refused-stream: a retry is attempted if the instance
7412 # or endpoint resets the stream with a REFUSED_STREAM error
7413 # code. This reset type indicates that it is safe to retry.
7414 # - cancelled: a retry is attempted if the gRPC status
7415 # code in the response header is set to cancelled.
7416 # - deadline-exceeded: a retry is attempted if the gRPC
7417 # status code in the response header is set todeadline-exceeded.
7418 # - internal: a retry is attempted if the gRPC
7419 # status code in the response header is set tointernal.
7420 # - resource-exhausted: a retry is attempted if the gRPC
7421 # status code in the response header is set toresource-exhausted.
7422 # - unavailable: a retry is attempted if the gRPC
7423 # status code in the response header is set tounavailable.
7424 #
7425 # Only the following codes are supported when the URL map is bound to
7426 # target gRPC proxy that has validateForProxyless field set to true.
7427 #
7428 # - cancelled
7429 # - deadline-exceeded
7430 # - internal
7431 # - resource-exhausted
7432 # - unavailable
7433 &quot;A String&quot;,
7434 ],
7435 },
7436 &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
7437 # time the request has been fully processed (known as *end-of-stream*)
7438 # up until the response has been processed. Timeout includes
7439 # all retries.
7440 #
7441 # If not specified, this field uses the largest timeout among all backend
7442 # services associated with the route.
7443 #
7444 # Not supported when the URL map is bound to a target gRPC proxy that
7445 # has validateForProxyless field set to true.
7446 # as a count of seconds and fractions of seconds at nanosecond
7447 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7448 # or &quot;month&quot;. Range is approximately 10,000 years.
7449 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7450 # Durations less than one second are represented with a 0
7451 # `seconds` field and a positive `nanos` field. Must be from 0
7452 # to 999,999,999 inclusive.
7453 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7454 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7455 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7456 },
7457 &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
7458 # to the matched service.
7459 #
7460 # urlRewrite is the only action supported in UrlMaps
7461 # for classic Application Load Balancers.
7462 #
7463 # Not supported when the URL map is bound to a target gRPC proxy that
7464 # has the validateForProxyless field set to true.
7465 # backend service.
7466 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
7467 # host header is replaced with contents of hostRewrite.
7468 #
7469 # The value must be from 1 to 255 characters.
7470 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
7471 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
7472 #
7473 # The value must be from 1 to 1024 characters.
7474 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
7475 # header) using the HTTP template syntax.
7476 #
7477 # A corresponding
7478 # path_template_match must be specified. Any template variables must exist in
7479 # the path_template_match field.
7480 #
7481 #
7482 # - -At least one variable must be specified in the path_template_match
7483 # field
7484 # - You can omit variables from the rewritten URL
7485 # - The * and ** operators cannot be matched
7486 # unless they have a corresponding variable name - e.g.
7487 # {format=*} or {var=**}.
7488 #
7489 # For example, a path_template_match of /static/{format=**}
7490 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
7491 # rewrite, so that /{country}/{format}/{suffix=**} can be
7492 # rewritten as /content/{format}/{country}/{suffix}.
7493 #
7494 # At least
7495 # one non-empty routeRules[].matchRules[].path_template_match is
7496 # required.
7497 #
7498 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
7499 },
7500 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
7501 # occurs. The weights determine the fraction of traffic that flows to
7502 # their corresponding backend service. If all traffic needs to
7503 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
7504 #
7505 # After a backend service is identified and before forwarding
7506 # the request to
7507 # the backend service, advanced routing actions such as URL rewrites and
7508 # header transformations are applied depending on additional settings
7509 # specified in this HttpRouteAction.
7510 { # In contrast to a single BackendService in
7511 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
7512 # multiple backend services. The volume of traffic for each
7513 # backend service is proportional to the weight specified
7514 # in each WeightedBackendService
7515 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
7516 # resource. Before
7517 # forwarding the request to backendService, the load balancer
7518 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
7519 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
7520 # effect for the selected backendService.
7521 #
7522 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
7523 #
7524 # headerAction is not supported for load balancers that have
7525 # their loadBalancingScheme set to EXTERNAL.
7526 #
7527 # Not supported when the URL map is bound to a target gRPC proxy that
7528 # has validateForProxyless field set to true.
7529 # the request is passed along to the selected backendService.
7530 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
7531 { # Specification determining how headers are added to requests or responses.
7532 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
7533 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
7534 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
7535 # that already
7536 # exist for the header. If true, headerValue is set for the
7537 # header, discarding any values that were set for that header.
7538 #
7539 # The default value is true,
7540 # unless a variable is present in headerValue,
7541 # in which case the default value is false.
7542 # .
7543 },
7544 ],
7545 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
7546 # request before forwarding the request to the backendService.
7547 &quot;A String&quot;,
7548 ],
7549 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
7550 # client.
7551 { # Specification determining how headers are added to requests or responses.
7552 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
7553 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
7554 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
7555 # that already
7556 # exist for the header. If true, headerValue is set for the
7557 # header, discarding any values that were set for that header.
7558 #
7559 # The default value is true,
7560 # unless a variable is present in headerValue,
7561 # in which case the default value is false.
7562 # .
7563 },
7564 ],
7565 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
7566 # response before sending the response back to the client.
7567 &quot;A String&quot;,
7568 ],
7569 },
7570 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
7571 # computed asweight / (sum of all weightedBackendService weights in routeAction).
7572 #
7573 # The selection of a backend service is determined only for new traffic.
7574 # Once a user&#x27;s request has been directed to a backend service,
7575 # subsequent requests are sent to the same backend service as
7576 # determined by the backend service&#x27;s session affinity policy.
7577 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
7578 # splitting. If you do, the weighted traffic splitting configuration takes
7579 # precedence.
7580 #
7581 # The value must be from 0 to 1000.
7582 },
7583 ],
7584 },
7585 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
7586 # is directed if this rule is matched. If routeAction is
7587 # also specified, advanced routing actions, such as URL rewrites,
7588 # take effect before sending the request to the backend.
7589 #
7590 #
7591 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
7592 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
7593 # specified by urlRedirect.
7594 #
7595 #
7596 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
7597 #
7598 #
7599 # Not supported when the URL map is bound to a target gRPC proxy.
7600 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
7601 # was supplied in the request.
7602 #
7603 # The value must be from 1 to 255
7604 # characters.
7605 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
7606 # set to HTTPS.
7607 # If set to false, the URL scheme of the redirected request
7608 # remains the same as that of the request.
7609 #
7610 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
7611 #
7612 # The default is set to false.
7613 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
7614 # that was supplied in the request.
7615 #
7616 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
7617 # supplied, the path of the original request is used for the redirect.
7618 #
7619 # The value must be from 1 to 1024 characters.
7620 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
7621 # the HttpRouteRuleMatch, retaining the remaining portion
7622 # of the URL before redirecting the request.
7623 #
7624 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
7625 # supplied, the path of the original request is used for the redirect.
7626 #
7627 # The value must be from 1 to 1024 characters.
7628 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
7629 #
7630 # Supported values are:
7631 #
7632 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
7633 # to 301.
7634 # - FOUND, which corresponds to 302.
7635 # - SEE_OTHER which corresponds to 303.
7636 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
7637 # method is retained.
7638 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
7639 # method is retained.
7640 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
7641 # URL is
7642 # removed before redirecting the request. If set to false, the
7643 # query portion of the original URL is retained.
7644 #
7645 # The default is set to false.
7646 },
7647 },
7648 ],
7649 },
7650 ],
7651 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the regional URL map resides.
7652 # This field is not applicable to global URL maps.
7653 # You must specify this field as part of the HTTP request URL. It is
7654 # not settable as a field in the request body.
7655 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
7656 &quot;status&quot;: { # [Output Only] The status of the URL map. # Output only. [Output Only] The status of the URL map.
7657 &quot;quotaUsage&quot;: { # Message representing the quota usage for a UrlMap. # Output only. Summary of quota usage for given UrlMap.
7658 &quot;forwardingRules&quot;: 42, # Output only. The number of forwarding rules that uses this UrlMap.
7659 &quot;units&quot;: &quot;A String&quot;, # Output only. The number of quota units calculated for this UrlMap.
7660 },
7661 },
7662 &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
7663 # maximum of 100 tests per UrlMap.
7664 #
7665 # Not supported when the URL map is bound to a target gRPC proxy that
7666 # has validateForProxyless field set to true.
7667 { # Message for the expected URL mappings.
7668 &quot;description&quot;: &quot;A String&quot;, # Description of this test case.
7669 &quot;expectedOutputUrl&quot;: &quot;A String&quot;, # The expected output URL evaluated by the load balancer
7670 # containing the scheme, host, path and query parameters.
7671 #
7672 # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
7673 # the load balancer to backends. For rules with urlRewrite,
7674 # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
7675 #
7676 # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer&#x27;s
7677 # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
7678 # If urlRedirect specifies strip_query, the test
7679 # passes only if expectedOutputUrl does not contain any query
7680 # parameters.
7681 #
7682 # expectedOutputUrl is optional whenservice is specified.
7683 &quot;expectedRedirectResponseCode&quot;: 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
7684 # load balancer&#x27;s redirect response.
7685 #
7686 # expectedRedirectResponseCode cannot be set whenservice is set.
7687 &quot;headers&quot;: [ # HTTP headers for this request. If headers contains
7688 # a host header, then host must also match the header value.
7689 { # HTTP headers used in UrlMapTests.
7690 &quot;name&quot;: &quot;A String&quot;, # Header name.
7691 &quot;value&quot;: &quot;A String&quot;, # Header value.
7692 },
7693 ],
7694 &quot;host&quot;: &quot;A String&quot;, # Host portion of the URL. If headers contains a host header,
7695 # then host must also match the header value.
7696 &quot;path&quot;: &quot;A String&quot;, # Path portion of the URL.
7697 &quot;service&quot;: &quot;A String&quot;, # Expected BackendService or BackendBucket resource
7698 # the given URL should be mapped to.
7699 #
7700 # The service field cannot
7701 # be set if expectedRedirectResponseCode is set.
7702 },
7703 ],
7704 }
7705
7706 requestId: string, begin_interface: MixerMutationRequestBuilder
7707 Request ID to support idempotency.
7708 x__xgafv: string, V1 error format.
7709 Allowed values
7710 1 - v1 error format
7711 2 - v2 error format
7712
7713 Returns:
7714 An object of the form:
7715
7716 { # Represents an Operation resource.
7717 #
7718 # Google Compute Engine has three Operation resources:
7719 #
7720 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
7721 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
7722 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
7723 #
7724 # You can use an operation resource to manage asynchronous API requests.
7725 # For more information, readHandling
7726 # API responses.
7727 #
7728 # Operations can be global, regional or zonal.
7729 #
7730 # - For global operations, use the `globalOperations`
7731 # resource.
7732 # - For regional operations, use the
7733 # `regionOperations` resource.
7734 # - For zonal operations, use
7735 # the `zoneOperations` resource.
7736 #
7737 #
7738 #
7739 # For more information, read
7740 # Global, Regional, and Zonal Resources.
7741 #
7742 # Note that completed Operation resources have a limited
7743 # retention period.
7744 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
7745 # Not present otherwise.
7746 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
7747 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
7748 # set when the operation is created.
7749 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
7750 # text format.
7751 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
7752 # this field will be populated.
7753 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
7754 # operation.
7755 {
7756 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
7757 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
7758 # details. There is a set of defined message types to use for providing
7759 # details.The syntax depends on the error code. For example,
7760 # QuotaExceededInfo will have details when the error code is
7761 # QUOTA_EXCEEDED.
7762 {
7763 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
7764 #
7765 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
7766 # is not enabled:
7767 #
7768 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
7769 # &quot;domain&quot;: &quot;googleapis.com&quot;
7770 # &quot;metadata&quot;: {
7771 # &quot;resource&quot;: &quot;projects/123&quot;,
7772 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
7773 # }
7774 # }
7775 #
7776 # This response indicates that the pubsub.googleapis.com API is not enabled.
7777 #
7778 # Example of an error that is returned when attempting to create a Spanner
7779 # instance in a region that is out of stock:
7780 #
7781 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
7782 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
7783 # &quot;metadata&quot;: {
7784 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
7785 # }
7786 # }
7787 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
7788 # is typically the registered service name of the tool or product that
7789 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
7790 # generated by some common infrastructure, the error domain must be a
7791 # globally unique value that identifies the infrastructure. For Google API
7792 # infrastructure, the error domain is &quot;googleapis.com&quot;.
7793 &quot;metadatas&quot;: { # Additional structured details about this error.
7794 #
7795 # Keys must match a regular expression of `a-z+` but should
7796 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
7797 # length. When identifying the current value of an exceeded limit, the units
7798 # should be contained in the key, not the value. For example, rather than
7799 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
7800 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
7801 # instances that can be created in a single (batch) request.
7802 &quot;a_key&quot;: &quot;A String&quot;,
7803 },
7804 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
7805 # proximate cause of the error. Error reasons are unique within a particular
7806 # domain of errors. This should be at most 63 characters and match a
7807 # regular expression of `A-Z+[A-Z0-9]`, which represents
7808 # UPPER_SNAKE_CASE.
7809 },
7810 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
7811 #
7812 # For example, if a quota check failed with an error indicating the calling
7813 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
7814 # directly to the right place in the developer console to flip the bit.
7815 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
7816 { # Describes a URL link.
7817 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
7818 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
7819 },
7820 ],
7821 },
7822 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
7823 # which can be attached to an RPC error.
7824 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
7825 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
7826 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
7827 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
7828 },
7829 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
7830 &quot;dimensions&quot;: { # The map holding related quota dimensions.
7831 &quot;a_key&quot;: &quot;A String&quot;,
7832 },
7833 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
7834 # type or metric.
7835 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
7836 # or metric.
7837 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
7838 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
7839 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
7840 },
7841 },
7842 ],
7843 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
7844 # This property is optional.
7845 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
7846 },
7847 ],
7848 },
7849 &quot;getVersionOperationMetadata&quot;: {
7850 &quot;inlineSbomInfo&quot;: {
7851 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
7852 # appropriate identifiers.
7853 &quot;a_key&quot;: &quot;A String&quot;,
7854 },
7855 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
7856 # identifiers.
7857 &quot;a_key&quot;: &quot;A String&quot;,
7858 },
7859 },
7860 },
7861 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
7862 # message that was returned, such as `NOT FOUND`.
7863 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
7864 # status code that was returned. For example, a `404` means the
7865 # resource was not found.
7866 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
7867 # defined by the server.
7868 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
7869 # This value is inRFC3339
7870 # text format.
7871 &quot;instancesBulkInsertOperationMetadata&quot;: {
7872 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
7873 # Example key: zones/us-central1-a
7874 &quot;a_key&quot;: {
7875 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
7876 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
7877 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
7878 # error.
7879 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
7880 # if the flow is rolling forward or rolling back.
7881 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
7882 },
7883 },
7884 },
7885 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
7886 # Operation resources.
7887 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
7888 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
7889 # group of operations results from a `bulkInsert` API request.
7890 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
7891 # `update`, or `delete`, and so on.
7892 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
7893 # There is no requirement that this be linear or support any granularity of
7894 # operations. This should not be used to guess when the operation will be
7895 # complete. This number should monotonically increase as the operation
7896 # progresses.
7897 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
7898 # applicable when performing regional operations.
7899 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
7900 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
7901 # this field will contain information on all underlying zonal actions and
7902 # their state.
7903 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
7904 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
7905 # Example key: zones/us-central1-a
7906 &quot;a_key&quot;: {
7907 &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
7908 # populated.
7909 # different programming environments, including REST APIs and RPC APIs. It is
7910 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
7911 # three pieces of data: error code, error message, and error details.
7912 #
7913 # You can find out more about this error model and how to work with it in the
7914 # [API Design Guide](https://cloud.google.com/apis/design/errors).
7915 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
7916 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
7917 # message types for APIs to use.
7918 {
7919 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
7920 },
7921 ],
7922 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
7923 # user-facing error message should be localized and sent in the
7924 # google.rpc.Status.details field, or localized by the client.
7925 },
7926 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
7927 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
7928 },
7929 },
7930 },
7931 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
7932 # This value is inRFC3339
7933 # text format.
7934 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
7935 # following:
7936 # `PENDING`, `RUNNING`, or `DONE`.
7937 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
7938 # operation.
7939 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
7940 # of the target resource.
7941 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
7942 # operations related to creating a snapshot, this points to the disk
7943 # that the snapshot was created from.
7944 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
7945 # `[email protected]` or
7946 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
7947 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
7948 # operation, this field will be populated.
7949 {
7950 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
7951 # Engine returns NO_RESULTS_ON_PAGE if there
7952 # are no results in the response.
7953 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
7954 # value format. For example:
7955 #
7956 # &quot;data&quot;: [
7957 # {
7958 # &quot;key&quot;: &quot;scope&quot;,
7959 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
7960 # }
7961 {
7962 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
7963 # returned. For example, for warnings where there are no results in a list
7964 # request for a particular zone, this key might be scope and
7965 # the key value might be the zone name. Other examples might be a key
7966 # indicating a deprecated resource and a suggested replacement, or a
7967 # warning about invalid network settings (for example, if an instance
7968 # attempts to perform IP forwarding but is not enabled for IP forwarding).
7969 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
7970 },
7971 ],
7972 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
7973 },
7974 ],
7975 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
7976 # applicable when performing per-zone operations.
7977 }</pre>
7978 </div>
7979
7980 <div class="method">
7981 <code class="details" id="invalidateCache">invalidateCache(project, region, urlMap, body=None, requestId=None, x__xgafv=None)</code>
7982 <pre>Initiates a cache invalidation operation, invalidating the specified path,
7983 scoped to the specified UrlMap.
7984
7985 For more information, see [Invalidating cached
7986 content](/cdn/docs/invalidating-cached-content).
7987
7988 Args:
7989 project: string, Project ID for this request. (required)
7990 region: string, Name of the region scoping this request. (required)
7991 urlMap: string, Name of the UrlMap scoping this request. (required)
7992 body: object, The request body.
7993 The object takes the form of:
7994
7995 {
7996 &quot;cacheTags&quot;: [ # A list of cache tags used to identify cached objects.
7997 #
7998 #
7999 # - Cache tags are specified when the response is first cached, by setting
8000 # the `Cache-Tag` response header at the origin.
8001 # - Multiple cache tags in the same invalidation request are treated as
8002 # Boolean `OR` - for example, `tag1 OR tag2 OR tag3`.
8003 # - If other fields are also specified, these are treated as Boolean `AND`
8004 # with any tags.
8005 #
8006 #
8007 # Up to 10 tags can be specified in a single invalidation request.
8008 &quot;A String&quot;,
8009 ],
8010 &quot;host&quot;: &quot;A String&quot;, # If set, this invalidation rule will only apply to requests with a Host
8011 # header matching host.
8012 &quot;path&quot;: &quot;A String&quot;,
8013 }
8014
8015 requestId: string, begin_interface: MixerMutationRequestBuilder
8016 Request ID to support idempotency.
8017 x__xgafv: string, V1 error format.
8018 Allowed values
8019 1 - v1 error format
8020 2 - v2 error format
8021
8022 Returns:
8023 An object of the form:
8024
8025 { # Represents an Operation resource.
8026 #
8027 # Google Compute Engine has three Operation resources:
8028 #
8029 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
8030 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
8031 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
8032 #
8033 # You can use an operation resource to manage asynchronous API requests.
8034 # For more information, readHandling
8035 # API responses.
8036 #
8037 # Operations can be global, regional or zonal.
8038 #
8039 # - For global operations, use the `globalOperations`
8040 # resource.
8041 # - For regional operations, use the
8042 # `regionOperations` resource.
8043 # - For zonal operations, use
8044 # the `zoneOperations` resource.
8045 #
8046 #
8047 #
8048 # For more information, read
8049 # Global, Regional, and Zonal Resources.
8050 #
8051 # Note that completed Operation resources have a limited
8052 # retention period.
8053 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
8054 # Not present otherwise.
8055 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
8056 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
8057 # set when the operation is created.
8058 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
8059 # text format.
8060 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
8061 # this field will be populated.
8062 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
8063 # operation.
8064 {
8065 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
8066 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
8067 # details. There is a set of defined message types to use for providing
8068 # details.The syntax depends on the error code. For example,
8069 # QuotaExceededInfo will have details when the error code is
8070 # QUOTA_EXCEEDED.
8071 {
8072 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
8073 #
8074 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
8075 # is not enabled:
8076 #
8077 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
8078 # &quot;domain&quot;: &quot;googleapis.com&quot;
8079 # &quot;metadata&quot;: {
8080 # &quot;resource&quot;: &quot;projects/123&quot;,
8081 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
8082 # }
8083 # }
8084 #
8085 # This response indicates that the pubsub.googleapis.com API is not enabled.
8086 #
8087 # Example of an error that is returned when attempting to create a Spanner
8088 # instance in a region that is out of stock:
8089 #
8090 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
8091 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
8092 # &quot;metadata&quot;: {
8093 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
8094 # }
8095 # }
8096 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
8097 # is typically the registered service name of the tool or product that
8098 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
8099 # generated by some common infrastructure, the error domain must be a
8100 # globally unique value that identifies the infrastructure. For Google API
8101 # infrastructure, the error domain is &quot;googleapis.com&quot;.
8102 &quot;metadatas&quot;: { # Additional structured details about this error.
8103 #
8104 # Keys must match a regular expression of `a-z+` but should
8105 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
8106 # length. When identifying the current value of an exceeded limit, the units
8107 # should be contained in the key, not the value. For example, rather than
8108 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
8109 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
8110 # instances that can be created in a single (batch) request.
8111 &quot;a_key&quot;: &quot;A String&quot;,
8112 },
8113 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
8114 # proximate cause of the error. Error reasons are unique within a particular
8115 # domain of errors. This should be at most 63 characters and match a
8116 # regular expression of `A-Z+[A-Z0-9]`, which represents
8117 # UPPER_SNAKE_CASE.
8118 },
8119 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
8120 #
8121 # For example, if a quota check failed with an error indicating the calling
8122 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
8123 # directly to the right place in the developer console to flip the bit.
8124 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
8125 { # Describes a URL link.
8126 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
8127 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
8128 },
8129 ],
8130 },
8131 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
8132 # which can be attached to an RPC error.
8133 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
8134 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
8135 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
8136 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
8137 },
8138 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
8139 &quot;dimensions&quot;: { # The map holding related quota dimensions.
8140 &quot;a_key&quot;: &quot;A String&quot;,
8141 },
8142 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
8143 # type or metric.
8144 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
8145 # or metric.
8146 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
8147 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
8148 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
8149 },
8150 },
8151 ],
8152 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
8153 # This property is optional.
8154 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
8155 },
8156 ],
8157 },
8158 &quot;getVersionOperationMetadata&quot;: {
8159 &quot;inlineSbomInfo&quot;: {
8160 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
8161 # appropriate identifiers.
8162 &quot;a_key&quot;: &quot;A String&quot;,
8163 },
8164 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
8165 # identifiers.
8166 &quot;a_key&quot;: &quot;A String&quot;,
8167 },
8168 },
8169 },
8170 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
8171 # message that was returned, such as `NOT FOUND`.
8172 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
8173 # status code that was returned. For example, a `404` means the
8174 # resource was not found.
8175 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
8176 # defined by the server.
8177 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
8178 # This value is inRFC3339
8179 # text format.
8180 &quot;instancesBulkInsertOperationMetadata&quot;: {
8181 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
8182 # Example key: zones/us-central1-a
8183 &quot;a_key&quot;: {
8184 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
8185 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
8186 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
8187 # error.
8188 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
8189 # if the flow is rolling forward or rolling back.
8190 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
8191 },
8192 },
8193 },
8194 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
8195 # Operation resources.
8196 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
8197 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
8198 # group of operations results from a `bulkInsert` API request.
8199 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
8200 # `update`, or `delete`, and so on.
8201 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
8202 # There is no requirement that this be linear or support any granularity of
8203 # operations. This should not be used to guess when the operation will be
8204 # complete. This number should monotonically increase as the operation
8205 # progresses.
8206 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
8207 # applicable when performing regional operations.
8208 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
8209 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
8210 # this field will contain information on all underlying zonal actions and
8211 # their state.
8212 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
8213 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
8214 # Example key: zones/us-central1-a
8215 &quot;a_key&quot;: {
8216 &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
8217 # populated.
8218 # different programming environments, including REST APIs and RPC APIs. It is
8219 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
8220 # three pieces of data: error code, error message, and error details.
8221 #
8222 # You can find out more about this error model and how to work with it in the
8223 # [API Design Guide](https://cloud.google.com/apis/design/errors).
8224 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
8225 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
8226 # message types for APIs to use.
8227 {
8228 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
8229 },
8230 ],
8231 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
8232 # user-facing error message should be localized and sent in the
8233 # google.rpc.Status.details field, or localized by the client.
8234 },
8235 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
8236 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
8237 },
8238 },
8239 },
8240 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
8241 # This value is inRFC3339
8242 # text format.
8243 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
8244 # following:
8245 # `PENDING`, `RUNNING`, or `DONE`.
8246 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
8247 # operation.
8248 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
8249 # of the target resource.
8250 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
8251 # operations related to creating a snapshot, this points to the disk
8252 # that the snapshot was created from.
8253 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
8254 # `[email protected]` or
8255 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
8256 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
8257 # operation, this field will be populated.
8258 {
8259 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
8260 # Engine returns NO_RESULTS_ON_PAGE if there
8261 # are no results in the response.
8262 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
8263 # value format. For example:
8264 #
8265 # &quot;data&quot;: [
8266 # {
8267 # &quot;key&quot;: &quot;scope&quot;,
8268 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
8269 # }
8270 {
8271 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
8272 # returned. For example, for warnings where there are no results in a list
8273 # request for a particular zone, this key might be scope and
8274 # the key value might be the zone name. Other examples might be a key
8275 # indicating a deprecated resource and a suggested replacement, or a
8276 # warning about invalid network settings (for example, if an instance
8277 # attempts to perform IP forwarding but is not enabled for IP forwarding).
8278 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
8279 },
8280 ],
8281 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
8282 },
8283 ],
8284 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
8285 # applicable when performing per-zone operations.
8286 }</pre>
8287 </div>
8288
8289 <div class="method">
8290 <code class="details" id="list">list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</code>
8291 <pre>Retrieves the list of UrlMap resources available to the specified
8292 project in the specified region.
8293
8294 Args:
8295 project: string, Project ID for this request. (required)
8296 region: string, Name of the region scoping this request. (required)
8297 filter: string, A filter expression that filters resources listed in the response. Most
8298 Compute resources support two types of filter expressions:
8299 expressions that support regular expressions and expressions that follow
8300 API improvement proposal AIP-160.
8301 These two types of filter expressions cannot be mixed in one request.
8302
8303 If you want to use AIP-160, your expression must specify the field name, an
8304 operator, and the value that you want to use for filtering. The value
8305 must be a string, a number, or a boolean. The operator
8306 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
8307
8308 For example, if you are filtering Compute Engine instances, you can
8309 exclude instances named `example-instance` by specifying
8310 `name != example-instance`.
8311
8312 The `:*` comparison can be used to test whether a key has been defined.
8313 For example, to find all objects with `owner` label use:
8314 ```
8315 labels.owner:*
8316 ```
8317
8318 You can also filter nested fields. For example, you could specify
8319 `scheduling.automaticRestart = false` to include instances only
8320 if they are not scheduled for automatic restarts. You can use filtering
8321 on nested fields to filter based onresource labels.
8322
8323 To filter on multiple expressions, provide each separate expression within
8324 parentheses. For example:
8325 ```
8326 (scheduling.automaticRestart = true)
8327 (cpuPlatform = &quot;Intel Skylake&quot;)
8328 ```
8329 By default, each expression is an `AND` expression. However, you
8330 can include `AND` and `OR` expressions explicitly.
8331 For example:
8332 ```
8333 (cpuPlatform = &quot;Intel Skylake&quot;) OR
8334 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
8335 (scheduling.automaticRestart = true)
8336 ```
8337
8338 If you want to use a regular expression, use the `eq` (equal) or `ne`
8339 (not equal) operator against a single un-parenthesized expression with or
8340 without quotes or against multiple parenthesized expressions. Examples:
8341
8342 `fieldname eq unquoted literal`
8343 `fieldname eq &#x27;single quoted literal&#x27;`
8344 `fieldname eq &quot;double quoted literal&quot;`
8345 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
8346
8347 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
8348 The literal value must match the entire field.
8349
8350 For example, to filter for instances that do not end with name &quot;instance&quot;,
8351 you would use `name ne .*instance`.
8352
8353 You cannot combine constraints on multiple fields using regular
8354 expressions.
8355 maxResults: integer, The maximum number of results per page that should be returned.
8356 If the number of available results is larger than `maxResults`,
8357 Compute Engine returns a `nextPageToken` that can be used to get
8358 the next page of results in subsequent list requests. Acceptable values are
8359 `0` to `500`, inclusive. (Default: `500`)
8360 orderBy: string, Sorts list results by a certain order. By default, results
8361 are returned in alphanumerical order based on the resource name.
8362
8363 You can also sort results in descending order based on the creation
8364 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
8365 results based on the `creationTimestamp` field in
8366 reverse chronological order (newest result first). Use this to sort
8367 resources like operations so that the newest operation is returned first.
8368
8369 Currently, only sorting by `name` or
8370 `creationTimestamp desc` is supported.
8371 pageToken: string, Specifies a page token to use. Set `pageToken` to the
8372 `nextPageToken` returned by a previous list request to get
8373 the next page of results.
8374 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
8375 of failure. The default value is false.
8376
8377 For example, when partial success behavior is enabled, aggregatedList for a
8378 single zone scope either returns all resources in the zone or no resources,
8379 with an error code.
8380 x__xgafv: string, V1 error format.
8381 Allowed values
8382 1 - v1 error format
8383 2 - v2 error format
8384
8385 Returns:
8386 An object of the form:
8387
8388 { # Contains a list of UrlMap resources.
8389 &quot;id&quot;: &quot;A String&quot;, # [Output Only] Unique identifier for the resource; defined by the server.
8390 &quot;items&quot;: [ # A list of UrlMap resources.
8391 { # Represents a URL Map resource.
8392 #
8393 # Compute Engine has two URL Map resources:
8394 #
8395 # * [Global](/compute/docs/reference/rest/beta/urlMaps)
8396 # * [Regional](/compute/docs/reference/rest/beta/regionUrlMaps)
8397 #
8398 # A URL map resource is a component of certain types of cloud load balancers
8399 # and Traffic Director:
8400 #
8401 # * urlMaps are used by global external Application Load
8402 # Balancers, classic Application Load Balancers, and cross-region internal
8403 # Application Load Balancers.
8404 # * regionUrlMaps are used by internal Application Load Balancers,
8405 # regional external Application Load Balancers and regional internal
8406 # Application Load Balancers.
8407 #
8408 # For a list of supported URL map features by the load balancer type, see the
8409 # Load balancing features: Routing and traffic management table.
8410 #
8411 # For a list of supported URL map features for Traffic Director, see the
8412 # Traffic Director features: Routing and traffic management table.
8413 #
8414 # This resource defines mappings from hostnames and URL paths to either a
8415 # backend service or a backend bucket.
8416 #
8417 # To use the global urlMaps resource, the backend service must
8418 # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
8419 # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
8420 # information, read URL
8421 # Map Concepts.
8422 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
8423 # text format.
8424 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
8425 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
8426 #
8427 # This policy takes
8428 # effect at the load balancer level and applies only when no policy has been
8429 # defined for the error code at lower levels like PathMatcher, RouteRule and
8430 # PathRule within this UrlMap.
8431 #
8432 # For example, consider a UrlMap with the
8433 # following configuration:
8434 #
8435 #
8436 # - defaultCustomErrorResponsePolicy containing policies for
8437 # responding to 5xx and 4xx errors
8438 # - A PathMatcher configured for *.example.com has
8439 # defaultCustomErrorResponsePolicy for 4xx.
8440 #
8441 # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
8442 # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
8443 # a request that does not match any host in *.example.com such
8444 # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
8445 # takes effect.
8446 #
8447 # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
8448 # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
8449 # a retry, if load balancer is successful in reaching the
8450 # service, the defaultCustomErrorResponsePolicy is ignored and
8451 # the response from the service is returned to the client.
8452 #
8453 # defaultCustomErrorResponsePolicy is supported only for
8454 # global external Application Load Balancers.
8455 # backend service or backend bucket responds with an error.
8456 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
8457 #
8458 # In a given policy, if you specify rules for both a range of error codes
8459 # as well as rules for specific error codes then rules with specific error
8460 # codes have a higher priority. For example, assume that you configure a rule
8461 # for 401 (Un-authorized) code, and another for all 4 series
8462 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
8463 # However if the backend service returns a 403, the rule for4xx takes effect.
8464 { # Specifies the mapping between the response code that will be returned along
8465 # with the custom error content and the response code returned by the backend
8466 # service.
8467 &quot;matchResponseCodes&quot;: [ # Valid values include:
8468 #
8469 #
8470 # - A number between 400 and 599: For example
8471 # 401 or 503, in which case the load balancer
8472 # applies the policy if the error code exactly matches this value.
8473 # - 5xx: Load Balancer will apply the policy if the
8474 # backend service responds with any response code in the range of
8475 # 500 to 599.
8476 # - 4xx: Load
8477 # Balancer will apply the policy if the backend service responds with any
8478 # response code in the range of 400 to
8479 # 499.
8480 #
8481 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
8482 &quot;A String&quot;,
8483 ],
8484 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
8485 # error content. If overrideResponseCode is not supplied, the
8486 # same response code returned by the original backend bucket or backend
8487 # service is returned to the client.
8488 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
8489 #
8490 # path must start
8491 # with a leading slash. path cannot have trailing slashes.
8492 #
8493 # If the file is not available in backendBucket or the
8494 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
8495 #
8496 # The value must
8497 # be from 1 to 1024 characters
8498 },
8499 ],
8500 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
8501 # contains the custom error content. Examples are:
8502 #
8503 #
8504 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
8505 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
8506 # - global/backendBuckets/myBackendBucket
8507 #
8508 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
8509 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
8510 #
8511 # If load balancer cannot reach
8512 # the backendBucket, a simple Not Found Error will
8513 # be returned, with the original response code (oroverrideResponseCode if configured).
8514 #
8515 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
8516 },
8517 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
8518 # hostRules match. The load balancer performs advanced routing
8519 # actions, such as URL rewrites and header transformations, before forwarding
8520 # the request to the selected backend.
8521 #
8522 #
8523 # Only one of defaultUrlRedirect, defaultService
8524 # or defaultRouteAction.weightedBackendService can be set.
8525 #
8526 #
8527 # URL maps for classic Application Load Balancers only support
8528 # the urlRewrite action within defaultRouteAction.
8529 #
8530 #
8531 # defaultRouteAction has no effect when the URL map is bound
8532 # to a target gRPC proxy that has the validateForProxyless field
8533 # set to true.
8534 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
8535 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
8536 # property must be specified. This policy cannot be specified if any target
8537 # backend has Identity-Aware Proxy enabled.
8538 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
8539 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
8540 # header names can be specified. The cache is bypassed for all `cacheMode`
8541 # values.
8542 &quot;A String&quot;,
8543 ],
8544 &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
8545 # on the backend type: for Backend Services, the complete request URI is
8546 # used; for Backend Buckets, the request URI is used without the protocol or
8547 # host, and only query parameters known to Cloud Storage are included.
8548 # Policy defined on Route Action.
8549 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
8550 # parameters will be included. Either specify `excludedQueryParameters`
8551 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
8552 # encoded and not treated as delimiters.
8553 #
8554 # Note: This field applies to routes that use backend services. Attempting
8555 # to set it on a route that points exclusively to Backend Buckets will
8556 # result in a configuration error. For routes that point to a Backend
8557 # Bucket, use `includedQueryParameters` to define which parameters should
8558 # be part of the cache key.
8559 &quot;A String&quot;,
8560 ],
8561 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
8562 #
8563 # Note: This setting is only applicable to routes that use a Backend
8564 # Service. It does not affect requests served by a Backend Bucket, as the
8565 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
8566 # it on a route that points exclusively to Backend Buckets will result in a
8567 # configuration error.
8568 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
8569 #
8570 # Note: This setting is only applicable to routes that use a Backend
8571 # Service. It does not affect requests served by a Backend Bucket, as the
8572 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
8573 # set on a route that points exclusively to Backend Buckets will result in
8574 # a configuration error.
8575 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
8576 # `includedQueryParameters` and `excludedQueryParameters`. If neither
8577 # is set, the entire query string will be included. If false, the query
8578 # string will be excluded from the cache key entirely.
8579 #
8580 # Note: This field applies to routes that use backend services. Attempting
8581 # to set it on a route that points exclusively to Backend Buckets will
8582 # result in a configuration error. For routes that point to a Backend
8583 # Bucket, use `includedQueryParameters` to define which parameters should
8584 # be part of the cache key.
8585 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
8586 # The name=value pair will be used in the cache key Cloud CDN generates.
8587 #
8588 # Note: This setting is only applicable to routes that use a Backend
8589 # Service. It does not affect requests served by a Backend Bucket.
8590 # Attempting to set it on a route that points exclusively to Backend
8591 # Buckets will result in a configuration error. Up to 5 cookie names can be
8592 # specified.
8593 &quot;A String&quot;,
8594 ],
8595 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
8596 &quot;A String&quot;,
8597 ],
8598 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
8599 # parameters will be excluded. Either specify `includedQueryParameters`
8600 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
8601 # encoded and not treated as delimiters.
8602 &quot;A String&quot;,
8603 ],
8604 },
8605 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
8606 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
8607 &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
8608 # content. This is used to clamp the max-age (or Expires) value sent to the
8609 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
8610 # is used for the response max-age directive, along with a &quot;public&quot;
8611 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
8612 # clamps the max-age from the origin (if specified), or else sets the
8613 # response max-age directive to the lesser of the `clientTtl` and
8614 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
8615 # present. The maximum allowed value is 31,622,400s (1 year). If not
8616 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
8617 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
8618 # `USE_ORIGIN_HEADERS`.
8619 # as a count of seconds and fractions of seconds at nanosecond
8620 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8621 # or &quot;month&quot;. Range is approximately 10,000 years.
8622 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8623 # Durations less than one second are represented with a 0
8624 # `seconds` field and a positive `nanos` field. Must be from 0
8625 # to 999,999,999 inclusive.
8626 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8627 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8628 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8629 },
8630 &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
8631 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
8632 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
8633 # greater than that of `maxTtl`. When the `cacheMode` is set to
8634 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
8635 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
8636 # accessed objects may be evicted from the cache before the defined TTL. If
8637 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
8638 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
8639 # `USE_ORIGIN_HEADERS`.
8640 # as a count of seconds and fractions of seconds at nanosecond
8641 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8642 # or &quot;month&quot;. Range is approximately 10,000 years.
8643 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8644 # Durations less than one second are represented with a 0
8645 # `seconds` field and a positive `nanos` field. Must be from 0
8646 # to 999,999,999 inclusive.
8647 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8648 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8649 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8650 },
8651 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
8652 # attempt to set a max-age or s-maxage higher than this, or an Expires header
8653 # more than `maxTtl` seconds in the future will be capped at the value of
8654 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
8655 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
8656 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
8657 # Infrequently accessed objects may be evicted from the cache before the
8658 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
8659 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
8660 # mode.
8661 # as a count of seconds and fractions of seconds at nanosecond
8662 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8663 # or &quot;month&quot;. Range is approximately 10,000 years.
8664 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8665 # Durations less than one second are represented with a 0
8666 # `seconds` field and a positive `nanos` field. Must be from 0
8667 # to 999,999,999 inclusive.
8668 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8669 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8670 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8671 },
8672 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
8673 # to apply fine-grained caching for common errors or redirects.
8674 # This can reduce the load on your origin and improve end-user
8675 # experience by reducing response latency.
8676 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
8677 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
8678 # the specified response code that lack any Cache-Control, Expires, or
8679 # Pragma: no-cache directives. When the `cacheMode` is set to
8680 # `FORCE_CACHE_ALL`, negative caching applies to all responses
8681 # with the specified response code, and overrides any caching headers. By
8682 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
8683 #
8684 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
8685 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
8686 # * 405 (Method Not Found), 501 (Not Implemented): 60s
8687 #
8688 # These defaults can be overridden in `negativeCachingPolicy`.
8689 # If not specified, Cloud CDN applies negative caching by default.
8690 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
8691 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
8692 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
8693 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
8694 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
8695 # all response codes that you wish to cache. Cloud CDN will not apply any
8696 # default negative caching when a policy exists.
8697 { # Specify CDN TTLs for response error codes.
8698 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
8699 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
8700 # specified as values, and you cannot specify a status code more than
8701 # once.
8702 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
8703 # corresponding status code.
8704 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
8705 # objects may be evicted from the cache before the defined TTL.
8706 # as a count of seconds and fractions of seconds at nanosecond
8707 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8708 # or &quot;month&quot;. Range is approximately 10,000 years.
8709 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8710 # Durations less than one second are represented with a 0
8711 # `seconds` field and a positive `nanos` field. Must be from 0
8712 # to 999,999,999 inclusive.
8713 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8714 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8715 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8716 },
8717 },
8718 ],
8719 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
8720 # requests into a small number of requests to the origin. If not specified,
8721 # Cloud CDN applies request coalescing by default.
8722 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
8723 # content with the origin, or when an error is encountered when refreshing
8724 # the cache.
8725 # This setting defines the default &quot;max-stale&quot; duration for any cached
8726 # responses that do not specify a max-stale directive. Stale responses that
8727 # exceed the TTL configured here will not be served. The default limit
8728 # (max-stale) is 86400s (1 day), which will allow stale content to be
8729 # served up to this limit beyond the max-age (or s-maxage) of a cached
8730 # response.
8731 # The maximum allowed value is 604800 (1 week).
8732 # Set this to zero (0) to disable serve-while-stale.
8733 # as a count of seconds and fractions of seconds at nanosecond
8734 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8735 # or &quot;month&quot;. Range is approximately 10,000 years.
8736 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8737 # Durations less than one second are represented with a 0
8738 # `seconds` field and a positive `nanos` field. Must be from 0
8739 # to 999,999,999 inclusive.
8740 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8741 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8742 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8743 },
8744 },
8745 &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
8746 # information about the W3C recommendation for cross-origin resource sharing
8747 # (CORS), see Fetch API Living
8748 # Standard.
8749 #
8750 # Not supported when the URL map is bound to a target gRPC proxy.
8751 # information about the W3C recommendation for cross-origin resource sharing
8752 # (CORS), see Fetch API Living
8753 # Standard.
8754 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
8755 # indicates that
8756 # the actual request can include user credentials. This field translates to
8757 # the Access-Control-Allow-Credentials header.
8758 #
8759 # Default is false.
8760 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
8761 # header.
8762 &quot;A String&quot;,
8763 ],
8764 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
8765 # header.
8766 &quot;A String&quot;,
8767 ],
8768 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
8769 # more information, see regular expression syntax.
8770 #
8771 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
8772 #
8773 # Regular expressions can only be used when the loadBalancingScheme is
8774 # set to INTERNAL_SELF_MANAGED.
8775 &quot;A String&quot;,
8776 ],
8777 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
8778 #
8779 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
8780 &quot;A String&quot;,
8781 ],
8782 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
8783 # The default value is false, which indicates that the CORS
8784 # policy is in effect.
8785 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
8786 # header.
8787 &quot;A String&quot;,
8788 ],
8789 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
8790 # seconds. This field translates to the Access-Control-Max-Age
8791 # header.
8792 },
8793 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
8794 # the resiliency of clients to backend service failure. As part of fault
8795 # injection, when clients send requests to a backend service, delays can be
8796 # introduced by a load balancer on a percentage of requests before sending
8797 # those requests to the backend service. Similarly requests from clients can
8798 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
8799 # that are configured with a fault_injection_policy if:
8800 # 1. The traffic is generated by fault injection AND
8801 # 2. The fault injection is not a delay fault injection.
8802 # Fault injection is not supported with the classic Application Load Balancer
8803 # . To see which load balancers support fault injection,
8804 # see Load
8805 # balancing: Routing and traffic management features.
8806 # the resiliency of clients to backend service failure. As part of fault
8807 # injection, when clients send requests to a backend service, delays can be
8808 # introduced by the load balancer on a percentage of requests before sending
8809 # those request to the backend service. Similarly requests from clients can be
8810 # aborted by the load balancer for a percentage of requests.
8811 &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
8812 # injection.
8813 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
8814 #
8815 # The value must be from 200 to 599 inclusive.
8816 #
8817 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
8818 # according to this
8819 # mapping table. HTTP status 200 is mapped to gRPC status
8820 # UNKNOWN. Injecting an OK status is currently not supported by
8821 # Traffic Director.
8822 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
8823 # that is aborted as part of fault injection.
8824 #
8825 # The value must be from 0.0 to 100.0 inclusive.
8826 },
8827 &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
8828 # injection, before being sent to a backend service.
8829 # request to the backend service as part of fault injection.
8830 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
8831 # as a count of seconds and fractions of seconds at nanosecond
8832 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8833 # or &quot;month&quot;. Range is approximately 10,000 years.
8834 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8835 # Durations less than one second are represented with a 0
8836 # `seconds` field and a positive `nanos` field. Must be from 0
8837 # to 999,999,999 inclusive.
8838 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8839 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8840 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8841 },
8842 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
8843 # which a delay is introduced as part of fault injection.
8844 #
8845 # The value must be from 0.0 to 100.0 inclusive.
8846 },
8847 },
8848 &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
8849 # Global EXTERNAL_MANAGED load balancer schemes.
8850 # Either Cloud CDN must be enabled on the backend service or backend bucket
8851 # serving the route, or cache policy must be configured on the same route
8852 # dynamically processes and delivers images from the network edge.
8853 # Image Optimization is only available for Global External Application Load
8854 # Balancers.
8855 # Either Cloud CDN must be enabled on the backend service or backend bucket
8856 # serving the route, or cache policy must be configured on the same route.
8857 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
8858 },
8859 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
8860 # Unlike the timeout field where the timeout duration starts
8861 # from the time the request has been fully processed (known as*end-of-stream*),
8862 # the duration in this field is computed from the beginning of the stream
8863 # until the response has been processed, including all retries. A
8864 # stream that does not complete in this duration is closed.
8865 #
8866 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
8867 # with the route.
8868 #
8869 # This field is only allowed if the Url map is used with backend services
8870 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
8871 # as a count of seconds and fractions of seconds at nanosecond
8872 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8873 # or &quot;month&quot;. Range is approximately 10,000 years.
8874 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8875 # Durations less than one second are represented with a 0
8876 # `seconds` field and a positive `nanos` field. Must be from 0
8877 # to 999,999,999 inclusive.
8878 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8879 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8880 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8881 },
8882 &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
8883 # are shadowed to a separate mirrored backend service. The load balancer does
8884 # not wait for responses from the shadow service. Before sending traffic
8885 # to the shadow service, the host / authority header is suffixed with-shadow.
8886 #
8887 # Not supported when the URL map is bound to a target gRPC proxy that
8888 # has the validateForProxyless field set to true.
8889 # are shadowed to a separate mirrored backend service. The load balancer
8890 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
8891 # to the shadow service, the host or authority header is suffixed with-shadow.
8892 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
8893 # mirrored to.
8894 #
8895 # The backend service configured for a mirroring
8896 # policy must reference backends that are of the same type as the original
8897 # backend service matched in the URL map.
8898 #
8899 # Serverless NEG backends are not currently supported as a mirrored
8900 # backend service.
8901 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
8902 },
8903 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
8904 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
8905 # If not specified, defaults to 1.
8906 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
8907 #
8908 # If not specified, will use the timeout set in theHttpRouteAction field.
8909 # If timeout in the HttpRouteAction field is not set, this field
8910 # uses the largest timeout
8911 # among all backend services associated with the route.
8912 #
8913 # Not supported when the URL map is bound to a target gRPC proxy that
8914 # has the validateForProxyless field set to true.
8915 # as a count of seconds and fractions of seconds at nanosecond
8916 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8917 # or &quot;month&quot;. Range is approximately 10,000 years.
8918 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8919 # Durations less than one second are represented with a 0
8920 # `seconds` field and a positive `nanos` field. Must be from 0
8921 # to 999,999,999 inclusive.
8922 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8923 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8924 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8925 },
8926 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
8927 # values are:
8928 #
8929 # - 5xx: retry is attempted if the instance or endpoint
8930 # responds with any 5xx response code, or if the instance or
8931 # endpoint does not respond at all. For example, disconnects, reset, read
8932 # timeout, connection failure, and refused streams.
8933 # - gateway-error: Similar to 5xx, but only
8934 # applies to response codes 502, 503 or504.
8935 # - connect-failure: a retry is attempted on failures
8936 # connecting to the instance or endpoint. For example, connection
8937 # timeouts.
8938 # - retriable-4xx: a retry is attempted if the instance
8939 # or endpoint responds with a 4xx response code.
8940 # The only error that you can retry is error code 409.
8941 # - refused-stream: a retry is attempted if the instance
8942 # or endpoint resets the stream with a REFUSED_STREAM error
8943 # code. This reset type indicates that it is safe to retry.
8944 # - cancelled: a retry is attempted if the gRPC status
8945 # code in the response header is set to cancelled.
8946 # - deadline-exceeded: a retry is attempted if the gRPC
8947 # status code in the response header is set todeadline-exceeded.
8948 # - internal: a retry is attempted if the gRPC
8949 # status code in the response header is set tointernal.
8950 # - resource-exhausted: a retry is attempted if the gRPC
8951 # status code in the response header is set toresource-exhausted.
8952 # - unavailable: a retry is attempted if the gRPC
8953 # status code in the response header is set tounavailable.
8954 #
8955 # Only the following codes are supported when the URL map is bound to
8956 # target gRPC proxy that has validateForProxyless field set to true.
8957 #
8958 # - cancelled
8959 # - deadline-exceeded
8960 # - internal
8961 # - resource-exhausted
8962 # - unavailable
8963 &quot;A String&quot;,
8964 ],
8965 },
8966 &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
8967 # time the request has been fully processed (known as *end-of-stream*)
8968 # up until the response has been processed. Timeout includes
8969 # all retries.
8970 #
8971 # If not specified, this field uses the largest timeout among all backend
8972 # services associated with the route.
8973 #
8974 # Not supported when the URL map is bound to a target gRPC proxy that
8975 # has validateForProxyless field set to true.
8976 # as a count of seconds and fractions of seconds at nanosecond
8977 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8978 # or &quot;month&quot;. Range is approximately 10,000 years.
8979 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8980 # Durations less than one second are represented with a 0
8981 # `seconds` field and a positive `nanos` field. Must be from 0
8982 # to 999,999,999 inclusive.
8983 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8984 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8985 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8986 },
8987 &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
8988 # to the matched service.
8989 #
8990 # urlRewrite is the only action supported in UrlMaps
8991 # for classic Application Load Balancers.
8992 #
8993 # Not supported when the URL map is bound to a target gRPC proxy that
8994 # has the validateForProxyless field set to true.
8995 # backend service.
8996 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
8997 # host header is replaced with contents of hostRewrite.
8998 #
8999 # The value must be from 1 to 255 characters.
9000 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
9001 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
9002 #
9003 # The value must be from 1 to 1024 characters.
9004 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
9005 # header) using the HTTP template syntax.
9006 #
9007 # A corresponding
9008 # path_template_match must be specified. Any template variables must exist in
9009 # the path_template_match field.
9010 #
9011 #
9012 # - -At least one variable must be specified in the path_template_match
9013 # field
9014 # - You can omit variables from the rewritten URL
9015 # - The * and ** operators cannot be matched
9016 # unless they have a corresponding variable name - e.g.
9017 # {format=*} or {var=**}.
9018 #
9019 # For example, a path_template_match of /static/{format=**}
9020 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
9021 # rewrite, so that /{country}/{format}/{suffix=**} can be
9022 # rewritten as /content/{format}/{country}/{suffix}.
9023 #
9024 # At least
9025 # one non-empty routeRules[].matchRules[].path_template_match is
9026 # required.
9027 #
9028 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
9029 },
9030 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
9031 # occurs. The weights determine the fraction of traffic that flows to
9032 # their corresponding backend service. If all traffic needs to
9033 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
9034 #
9035 # After a backend service is identified and before forwarding
9036 # the request to
9037 # the backend service, advanced routing actions such as URL rewrites and
9038 # header transformations are applied depending on additional settings
9039 # specified in this HttpRouteAction.
9040 { # In contrast to a single BackendService in
9041 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
9042 # multiple backend services. The volume of traffic for each
9043 # backend service is proportional to the weight specified
9044 # in each WeightedBackendService
9045 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
9046 # resource. Before
9047 # forwarding the request to backendService, the load balancer
9048 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
9049 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
9050 # effect for the selected backendService.
9051 #
9052 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
9053 #
9054 # headerAction is not supported for load balancers that have
9055 # their loadBalancingScheme set to EXTERNAL.
9056 #
9057 # Not supported when the URL map is bound to a target gRPC proxy that
9058 # has validateForProxyless field set to true.
9059 # the request is passed along to the selected backendService.
9060 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
9061 { # Specification determining how headers are added to requests or responses.
9062 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
9063 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
9064 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
9065 # that already
9066 # exist for the header. If true, headerValue is set for the
9067 # header, discarding any values that were set for that header.
9068 #
9069 # The default value is true,
9070 # unless a variable is present in headerValue,
9071 # in which case the default value is false.
9072 # .
9073 },
9074 ],
9075 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
9076 # request before forwarding the request to the backendService.
9077 &quot;A String&quot;,
9078 ],
9079 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
9080 # client.
9081 { # Specification determining how headers are added to requests or responses.
9082 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
9083 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
9084 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
9085 # that already
9086 # exist for the header. If true, headerValue is set for the
9087 # header, discarding any values that were set for that header.
9088 #
9089 # The default value is true,
9090 # unless a variable is present in headerValue,
9091 # in which case the default value is false.
9092 # .
9093 },
9094 ],
9095 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
9096 # response before sending the response back to the client.
9097 &quot;A String&quot;,
9098 ],
9099 },
9100 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
9101 # computed asweight / (sum of all weightedBackendService weights in routeAction).
9102 #
9103 # The selection of a backend service is determined only for new traffic.
9104 # Once a user&#x27;s request has been directed to a backend service,
9105 # subsequent requests are sent to the same backend service as
9106 # determined by the backend service&#x27;s session affinity policy.
9107 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
9108 # splitting. If you do, the weighted traffic splitting configuration takes
9109 # precedence.
9110 #
9111 # The value must be from 0 to 1000.
9112 },
9113 ],
9114 },
9115 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL of the defaultService resource to
9116 # which traffic is directed if none of the hostRules match.
9117 # If defaultRouteAction is also specified, advanced
9118 # routing actions, such as URL rewrites, take effect before sending the
9119 # request to the backend.
9120 #
9121 #
9122 # Only one of defaultUrlRedirect, defaultService
9123 # or defaultRouteAction.weightedBackendService can be set.
9124 #
9125 #
9126 # defaultService has no effect when the URL map is bound
9127 # to a target gRPC proxy that has the validateForProxyless field
9128 # set to true.
9129 &quot;defaultUrlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
9130 # is redirected to a URL specified by defaultUrlRedirect.
9131 #
9132 #
9133 # Only one of defaultUrlRedirect, defaultService
9134 # or defaultRouteAction.weightedBackendService can be set.
9135 #
9136 #
9137 # Not supported when the URL map is bound to a target gRPC proxy.
9138 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
9139 # was supplied in the request.
9140 #
9141 # The value must be from 1 to 255
9142 # characters.
9143 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
9144 # set to HTTPS.
9145 # If set to false, the URL scheme of the redirected request
9146 # remains the same as that of the request.
9147 #
9148 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
9149 #
9150 # The default is set to false.
9151 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
9152 # that was supplied in the request.
9153 #
9154 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
9155 # supplied, the path of the original request is used for the redirect.
9156 #
9157 # The value must be from 1 to 1024 characters.
9158 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
9159 # the HttpRouteRuleMatch, retaining the remaining portion
9160 # of the URL before redirecting the request.
9161 #
9162 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
9163 # supplied, the path of the original request is used for the redirect.
9164 #
9165 # The value must be from 1 to 1024 characters.
9166 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
9167 #
9168 # Supported values are:
9169 #
9170 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
9171 # to 301.
9172 # - FOUND, which corresponds to 302.
9173 # - SEE_OTHER which corresponds to 303.
9174 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
9175 # method is retained.
9176 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
9177 # method is retained.
9178 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
9179 # URL is
9180 # removed before redirecting the request. If set to false, the
9181 # query portion of the original URL is retained.
9182 #
9183 # The default is set to false.
9184 },
9185 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
9186 # create the resource.
9187 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. A hash of the contents stored in this object.
9188 # This field is used in optimistic locking. This field is ignored when
9189 # inserting a UrlMap. An up-to-date fingerprint must be provided
9190 # in order to update the UrlMap, otherwise the request will
9191 # fail with error 412 conditionNotMet.
9192 #
9193 # To see the latest fingerprint, make a get() request to
9194 # retrieve a UrlMap.
9195 &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
9196 # for the selected backendService.
9197 #
9198 # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
9199 #
9200 # headerAction is not supported for load balancers
9201 # that have
9202 # their loadBalancingScheme set to EXTERNAL.
9203 #
9204 # Not supported when the URL map is bound to a target gRPC proxy that
9205 # has validateForProxyless field set to true.
9206 # the request is passed along to the selected backendService.
9207 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
9208 { # Specification determining how headers are added to requests or responses.
9209 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
9210 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
9211 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
9212 # that already
9213 # exist for the header. If true, headerValue is set for the
9214 # header, discarding any values that were set for that header.
9215 #
9216 # The default value is true,
9217 # unless a variable is present in headerValue,
9218 # in which case the default value is false.
9219 # .
9220 },
9221 ],
9222 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
9223 # request before forwarding the request to the backendService.
9224 &quot;A String&quot;,
9225 ],
9226 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
9227 # client.
9228 { # Specification determining how headers are added to requests or responses.
9229 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
9230 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
9231 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
9232 # that already
9233 # exist for the header. If true, headerValue is set for the
9234 # header, discarding any values that were set for that header.
9235 #
9236 # The default value is true,
9237 # unless a variable is present in headerValue,
9238 # in which case the default value is false.
9239 # .
9240 },
9241 ],
9242 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
9243 # response before sending the response back to the client.
9244 &quot;A String&quot;,
9245 ],
9246 },
9247 &quot;hostRules&quot;: [ # The list of host rules to use against the URL.
9248 { # UrlMaps
9249 # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
9250 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
9251 # create the resource.
9252 &quot;hosts&quot;: [ # The list of host patterns to match. They must be valid hostnames with
9253 # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
9254 # that case, * must be the first character, and if followed by
9255 # anything, the immediate following character must be either -
9256 # or ..
9257 #
9258 # * based matching is not supported when the URL map is bound
9259 # to a target gRPC proxy that has the validateForProxyless field
9260 # set to true.
9261 &quot;A String&quot;,
9262 ],
9263 &quot;pathMatcher&quot;: &quot;A String&quot;, # The name of the PathMatcher to use to match the path portion
9264 # of the URL if the hostRule matches the URL&#x27;s host portion.
9265 },
9266 ],
9267 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the resource. This identifier is
9268 # defined by the server.
9269 &quot;kind&quot;: &quot;compute#urlMap&quot;, # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
9270 # url maps.
9271 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
9272 # The name must be 1-63 characters long, and comply withRFC1035.
9273 # Specifically, the name must be 1-63 characters long and match the regular
9274 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
9275 # character must be a lowercase letter, and all following characters must
9276 # be a dash, lowercase letter, or digit, except the last character, which
9277 # cannot be a dash.
9278 &quot;pathMatchers&quot;: [ # The list of named PathMatchers to use against the URL.
9279 { # A matcher for the path portion of the URL. The BackendService
9280 # from the longest-matched rule will serve the URL. If no rule was matched, the
9281 # default service is used.
9282 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
9283 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
9284 #
9285 # This policy takes
9286 # effect at the PathMatcher level and applies only when no
9287 # 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
9288 # in defaultCustomErrorResponsePolicy, then a policy defined for
9289 # the error code in UrlMap.defaultCustomErrorResponsePolicy
9290 # takes effect.
9291 #
9292 # For example, consider a UrlMap with the following
9293 # configuration:
9294 #
9295 #
9296 # - UrlMap.defaultCustomErrorResponsePolicy is configured
9297 # with policies for 5xx and 4xx errors
9298 # - A RouteRule for /coming_soon/ is configured for the
9299 # error code 404.
9300 #
9301 # 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
9302 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
9303 # the policy in RouteRule.customErrorResponsePolicy takes
9304 # effect. If any of the requests in this example encounter a 500
9305 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
9306 #
9307 # When
9308 # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
9309 # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
9310 # a retry, if load balancer is successful in reaching the
9311 # service, the defaultCustomErrorResponsePolicy is ignored and
9312 # the response from the service is returned to the client.
9313 #
9314 # defaultCustomErrorResponsePolicy is supported only for
9315 # global external Application Load Balancers.
9316 # backend service or backend bucket responds with an error.
9317 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
9318 #
9319 # In a given policy, if you specify rules for both a range of error codes
9320 # as well as rules for specific error codes then rules with specific error
9321 # codes have a higher priority. For example, assume that you configure a rule
9322 # for 401 (Un-authorized) code, and another for all 4 series
9323 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
9324 # However if the backend service returns a 403, the rule for4xx takes effect.
9325 { # Specifies the mapping between the response code that will be returned along
9326 # with the custom error content and the response code returned by the backend
9327 # service.
9328 &quot;matchResponseCodes&quot;: [ # Valid values include:
9329 #
9330 #
9331 # - A number between 400 and 599: For example
9332 # 401 or 503, in which case the load balancer
9333 # applies the policy if the error code exactly matches this value.
9334 # - 5xx: Load Balancer will apply the policy if the
9335 # backend service responds with any response code in the range of
9336 # 500 to 599.
9337 # - 4xx: Load
9338 # Balancer will apply the policy if the backend service responds with any
9339 # response code in the range of 400 to
9340 # 499.
9341 #
9342 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
9343 &quot;A String&quot;,
9344 ],
9345 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
9346 # error content. If overrideResponseCode is not supplied, the
9347 # same response code returned by the original backend bucket or backend
9348 # service is returned to the client.
9349 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
9350 #
9351 # path must start
9352 # with a leading slash. path cannot have trailing slashes.
9353 #
9354 # If the file is not available in backendBucket or the
9355 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
9356 #
9357 # The value must
9358 # be from 1 to 1024 characters
9359 },
9360 ],
9361 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
9362 # contains the custom error content. Examples are:
9363 #
9364 #
9365 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
9366 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
9367 # - global/backendBuckets/myBackendBucket
9368 #
9369 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
9370 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
9371 #
9372 # If load balancer cannot reach
9373 # the backendBucket, a simple Not Found Error will
9374 # be returned, with the original response code (oroverrideResponseCode if configured).
9375 #
9376 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
9377 },
9378 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
9379 # pathRules or routeRules match. The load balancer
9380 # performs advanced routing actions, such as URL rewrites and
9381 # header transformations, before forwarding the request to the
9382 # selected backend.
9383 #
9384 #
9385 # Only one of defaultUrlRedirect, defaultService
9386 # or defaultRouteAction.weightedBackendService can be set.
9387 #
9388 #
9389 # URL maps for classic Application Load Balancers only support
9390 # the urlRewrite action within a path matcher&#x27;sdefaultRouteAction.
9391 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
9392 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
9393 # property must be specified. This policy cannot be specified if any target
9394 # backend has Identity-Aware Proxy enabled.
9395 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
9396 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
9397 # header names can be specified. The cache is bypassed for all `cacheMode`
9398 # values.
9399 &quot;A String&quot;,
9400 ],
9401 &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
9402 # on the backend type: for Backend Services, the complete request URI is
9403 # used; for Backend Buckets, the request URI is used without the protocol or
9404 # host, and only query parameters known to Cloud Storage are included.
9405 # Policy defined on Route Action.
9406 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
9407 # parameters will be included. Either specify `excludedQueryParameters`
9408 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
9409 # encoded and not treated as delimiters.
9410 #
9411 # Note: This field applies to routes that use backend services. Attempting
9412 # to set it on a route that points exclusively to Backend Buckets will
9413 # result in a configuration error. For routes that point to a Backend
9414 # Bucket, use `includedQueryParameters` to define which parameters should
9415 # be part of the cache key.
9416 &quot;A String&quot;,
9417 ],
9418 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
9419 #
9420 # Note: This setting is only applicable to routes that use a Backend
9421 # Service. It does not affect requests served by a Backend Bucket, as the
9422 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
9423 # it on a route that points exclusively to Backend Buckets will result in a
9424 # configuration error.
9425 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
9426 #
9427 # Note: This setting is only applicable to routes that use a Backend
9428 # Service. It does not affect requests served by a Backend Bucket, as the
9429 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
9430 # set on a route that points exclusively to Backend Buckets will result in
9431 # a configuration error.
9432 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
9433 # `includedQueryParameters` and `excludedQueryParameters`. If neither
9434 # is set, the entire query string will be included. If false, the query
9435 # string will be excluded from the cache key entirely.
9436 #
9437 # Note: This field applies to routes that use backend services. Attempting
9438 # to set it on a route that points exclusively to Backend Buckets will
9439 # result in a configuration error. For routes that point to a Backend
9440 # Bucket, use `includedQueryParameters` to define which parameters should
9441 # be part of the cache key.
9442 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
9443 # The name=value pair will be used in the cache key Cloud CDN generates.
9444 #
9445 # Note: This setting is only applicable to routes that use a Backend
9446 # Service. It does not affect requests served by a Backend Bucket.
9447 # Attempting to set it on a route that points exclusively to Backend
9448 # Buckets will result in a configuration error. Up to 5 cookie names can be
9449 # specified.
9450 &quot;A String&quot;,
9451 ],
9452 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
9453 &quot;A String&quot;,
9454 ],
9455 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
9456 # parameters will be excluded. Either specify `includedQueryParameters`
9457 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
9458 # encoded and not treated as delimiters.
9459 &quot;A String&quot;,
9460 ],
9461 },
9462 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
9463 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
9464 &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
9465 # content. This is used to clamp the max-age (or Expires) value sent to the
9466 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
9467 # is used for the response max-age directive, along with a &quot;public&quot;
9468 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
9469 # clamps the max-age from the origin (if specified), or else sets the
9470 # response max-age directive to the lesser of the `clientTtl` and
9471 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
9472 # present. The maximum allowed value is 31,622,400s (1 year). If not
9473 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
9474 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
9475 # `USE_ORIGIN_HEADERS`.
9476 # as a count of seconds and fractions of seconds at nanosecond
9477 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9478 # or &quot;month&quot;. Range is approximately 10,000 years.
9479 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9480 # Durations less than one second are represented with a 0
9481 # `seconds` field and a positive `nanos` field. Must be from 0
9482 # to 999,999,999 inclusive.
9483 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9484 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9485 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9486 },
9487 &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
9488 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
9489 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
9490 # greater than that of `maxTtl`. When the `cacheMode` is set to
9491 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
9492 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
9493 # accessed objects may be evicted from the cache before the defined TTL. If
9494 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
9495 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
9496 # `USE_ORIGIN_HEADERS`.
9497 # as a count of seconds and fractions of seconds at nanosecond
9498 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9499 # or &quot;month&quot;. Range is approximately 10,000 years.
9500 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9501 # Durations less than one second are represented with a 0
9502 # `seconds` field and a positive `nanos` field. Must be from 0
9503 # to 999,999,999 inclusive.
9504 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9505 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9506 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9507 },
9508 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
9509 # attempt to set a max-age or s-maxage higher than this, or an Expires header
9510 # more than `maxTtl` seconds in the future will be capped at the value of
9511 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
9512 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
9513 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
9514 # Infrequently accessed objects may be evicted from the cache before the
9515 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
9516 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
9517 # mode.
9518 # as a count of seconds and fractions of seconds at nanosecond
9519 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9520 # or &quot;month&quot;. Range is approximately 10,000 years.
9521 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9522 # Durations less than one second are represented with a 0
9523 # `seconds` field and a positive `nanos` field. Must be from 0
9524 # to 999,999,999 inclusive.
9525 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9526 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9527 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9528 },
9529 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
9530 # to apply fine-grained caching for common errors or redirects.
9531 # This can reduce the load on your origin and improve end-user
9532 # experience by reducing response latency.
9533 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
9534 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
9535 # the specified response code that lack any Cache-Control, Expires, or
9536 # Pragma: no-cache directives. When the `cacheMode` is set to
9537 # `FORCE_CACHE_ALL`, negative caching applies to all responses
9538 # with the specified response code, and overrides any caching headers. By
9539 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
9540 #
9541 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
9542 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
9543 # * 405 (Method Not Found), 501 (Not Implemented): 60s
9544 #
9545 # These defaults can be overridden in `negativeCachingPolicy`.
9546 # If not specified, Cloud CDN applies negative caching by default.
9547 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
9548 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
9549 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
9550 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
9551 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
9552 # all response codes that you wish to cache. Cloud CDN will not apply any
9553 # default negative caching when a policy exists.
9554 { # Specify CDN TTLs for response error codes.
9555 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
9556 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
9557 # specified as values, and you cannot specify a status code more than
9558 # once.
9559 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
9560 # corresponding status code.
9561 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
9562 # objects may be evicted from the cache before the defined TTL.
9563 # as a count of seconds and fractions of seconds at nanosecond
9564 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9565 # or &quot;month&quot;. Range is approximately 10,000 years.
9566 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9567 # Durations less than one second are represented with a 0
9568 # `seconds` field and a positive `nanos` field. Must be from 0
9569 # to 999,999,999 inclusive.
9570 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9571 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9572 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9573 },
9574 },
9575 ],
9576 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
9577 # requests into a small number of requests to the origin. If not specified,
9578 # Cloud CDN applies request coalescing by default.
9579 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
9580 # content with the origin, or when an error is encountered when refreshing
9581 # the cache.
9582 # This setting defines the default &quot;max-stale&quot; duration for any cached
9583 # responses that do not specify a max-stale directive. Stale responses that
9584 # exceed the TTL configured here will not be served. The default limit
9585 # (max-stale) is 86400s (1 day), which will allow stale content to be
9586 # served up to this limit beyond the max-age (or s-maxage) of a cached
9587 # response.
9588 # The maximum allowed value is 604800 (1 week).
9589 # Set this to zero (0) to disable serve-while-stale.
9590 # as a count of seconds and fractions of seconds at nanosecond
9591 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9592 # or &quot;month&quot;. Range is approximately 10,000 years.
9593 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9594 # Durations less than one second are represented with a 0
9595 # `seconds` field and a positive `nanos` field. Must be from 0
9596 # to 999,999,999 inclusive.
9597 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9598 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9599 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9600 },
9601 },
9602 &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
9603 # information about the W3C recommendation for cross-origin resource sharing
9604 # (CORS), see Fetch API Living
9605 # Standard.
9606 #
9607 # Not supported when the URL map is bound to a target gRPC proxy.
9608 # information about the W3C recommendation for cross-origin resource sharing
9609 # (CORS), see Fetch API Living
9610 # Standard.
9611 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
9612 # indicates that
9613 # the actual request can include user credentials. This field translates to
9614 # the Access-Control-Allow-Credentials header.
9615 #
9616 # Default is false.
9617 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
9618 # header.
9619 &quot;A String&quot;,
9620 ],
9621 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
9622 # header.
9623 &quot;A String&quot;,
9624 ],
9625 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
9626 # more information, see regular expression syntax.
9627 #
9628 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
9629 #
9630 # Regular expressions can only be used when the loadBalancingScheme is
9631 # set to INTERNAL_SELF_MANAGED.
9632 &quot;A String&quot;,
9633 ],
9634 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
9635 #
9636 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
9637 &quot;A String&quot;,
9638 ],
9639 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
9640 # The default value is false, which indicates that the CORS
9641 # policy is in effect.
9642 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
9643 # header.
9644 &quot;A String&quot;,
9645 ],
9646 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
9647 # seconds. This field translates to the Access-Control-Max-Age
9648 # header.
9649 },
9650 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
9651 # the resiliency of clients to backend service failure. As part of fault
9652 # injection, when clients send requests to a backend service, delays can be
9653 # introduced by a load balancer on a percentage of requests before sending
9654 # those requests to the backend service. Similarly requests from clients can
9655 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
9656 # that are configured with a fault_injection_policy if:
9657 # 1. The traffic is generated by fault injection AND
9658 # 2. The fault injection is not a delay fault injection.
9659 # Fault injection is not supported with the classic Application Load Balancer
9660 # . To see which load balancers support fault injection,
9661 # see Load
9662 # balancing: Routing and traffic management features.
9663 # the resiliency of clients to backend service failure. As part of fault
9664 # injection, when clients send requests to a backend service, delays can be
9665 # introduced by the load balancer on a percentage of requests before sending
9666 # those request to the backend service. Similarly requests from clients can be
9667 # aborted by the load balancer for a percentage of requests.
9668 &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
9669 # injection.
9670 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
9671 #
9672 # The value must be from 200 to 599 inclusive.
9673 #
9674 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
9675 # according to this
9676 # mapping table. HTTP status 200 is mapped to gRPC status
9677 # UNKNOWN. Injecting an OK status is currently not supported by
9678 # Traffic Director.
9679 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
9680 # that is aborted as part of fault injection.
9681 #
9682 # The value must be from 0.0 to 100.0 inclusive.
9683 },
9684 &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
9685 # injection, before being sent to a backend service.
9686 # request to the backend service as part of fault injection.
9687 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
9688 # as a count of seconds and fractions of seconds at nanosecond
9689 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9690 # or &quot;month&quot;. Range is approximately 10,000 years.
9691 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9692 # Durations less than one second are represented with a 0
9693 # `seconds` field and a positive `nanos` field. Must be from 0
9694 # to 999,999,999 inclusive.
9695 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9696 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9697 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9698 },
9699 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
9700 # which a delay is introduced as part of fault injection.
9701 #
9702 # The value must be from 0.0 to 100.0 inclusive.
9703 },
9704 },
9705 &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
9706 # Global EXTERNAL_MANAGED load balancer schemes.
9707 # Either Cloud CDN must be enabled on the backend service or backend bucket
9708 # serving the route, or cache policy must be configured on the same route
9709 # dynamically processes and delivers images from the network edge.
9710 # Image Optimization is only available for Global External Application Load
9711 # Balancers.
9712 # Either Cloud CDN must be enabled on the backend service or backend bucket
9713 # serving the route, or cache policy must be configured on the same route.
9714 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
9715 },
9716 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
9717 # Unlike the timeout field where the timeout duration starts
9718 # from the time the request has been fully processed (known as*end-of-stream*),
9719 # the duration in this field is computed from the beginning of the stream
9720 # until the response has been processed, including all retries. A
9721 # stream that does not complete in this duration is closed.
9722 #
9723 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
9724 # with the route.
9725 #
9726 # This field is only allowed if the Url map is used with backend services
9727 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
9728 # as a count of seconds and fractions of seconds at nanosecond
9729 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9730 # or &quot;month&quot;. Range is approximately 10,000 years.
9731 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9732 # Durations less than one second are represented with a 0
9733 # `seconds` field and a positive `nanos` field. Must be from 0
9734 # to 999,999,999 inclusive.
9735 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9736 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9737 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9738 },
9739 &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
9740 # are shadowed to a separate mirrored backend service. The load balancer does
9741 # not wait for responses from the shadow service. Before sending traffic
9742 # to the shadow service, the host / authority header is suffixed with-shadow.
9743 #
9744 # Not supported when the URL map is bound to a target gRPC proxy that
9745 # has the validateForProxyless field set to true.
9746 # are shadowed to a separate mirrored backend service. The load balancer
9747 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
9748 # to the shadow service, the host or authority header is suffixed with-shadow.
9749 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
9750 # mirrored to.
9751 #
9752 # The backend service configured for a mirroring
9753 # policy must reference backends that are of the same type as the original
9754 # backend service matched in the URL map.
9755 #
9756 # Serverless NEG backends are not currently supported as a mirrored
9757 # backend service.
9758 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
9759 },
9760 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
9761 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
9762 # If not specified, defaults to 1.
9763 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
9764 #
9765 # If not specified, will use the timeout set in theHttpRouteAction field.
9766 # If timeout in the HttpRouteAction field is not set, this field
9767 # uses the largest timeout
9768 # among all backend services associated with the route.
9769 #
9770 # Not supported when the URL map is bound to a target gRPC proxy that
9771 # has the validateForProxyless field set to true.
9772 # as a count of seconds and fractions of seconds at nanosecond
9773 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9774 # or &quot;month&quot;. Range is approximately 10,000 years.
9775 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9776 # Durations less than one second are represented with a 0
9777 # `seconds` field and a positive `nanos` field. Must be from 0
9778 # to 999,999,999 inclusive.
9779 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9780 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9781 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9782 },
9783 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
9784 # values are:
9785 #
9786 # - 5xx: retry is attempted if the instance or endpoint
9787 # responds with any 5xx response code, or if the instance or
9788 # endpoint does not respond at all. For example, disconnects, reset, read
9789 # timeout, connection failure, and refused streams.
9790 # - gateway-error: Similar to 5xx, but only
9791 # applies to response codes 502, 503 or504.
9792 # - connect-failure: a retry is attempted on failures
9793 # connecting to the instance or endpoint. For example, connection
9794 # timeouts.
9795 # - retriable-4xx: a retry is attempted if the instance
9796 # or endpoint responds with a 4xx response code.
9797 # The only error that you can retry is error code 409.
9798 # - refused-stream: a retry is attempted if the instance
9799 # or endpoint resets the stream with a REFUSED_STREAM error
9800 # code. This reset type indicates that it is safe to retry.
9801 # - cancelled: a retry is attempted if the gRPC status
9802 # code in the response header is set to cancelled.
9803 # - deadline-exceeded: a retry is attempted if the gRPC
9804 # status code in the response header is set todeadline-exceeded.
9805 # - internal: a retry is attempted if the gRPC
9806 # status code in the response header is set tointernal.
9807 # - resource-exhausted: a retry is attempted if the gRPC
9808 # status code in the response header is set toresource-exhausted.
9809 # - unavailable: a retry is attempted if the gRPC
9810 # status code in the response header is set tounavailable.
9811 #
9812 # Only the following codes are supported when the URL map is bound to
9813 # target gRPC proxy that has validateForProxyless field set to true.
9814 #
9815 # - cancelled
9816 # - deadline-exceeded
9817 # - internal
9818 # - resource-exhausted
9819 # - unavailable
9820 &quot;A String&quot;,
9821 ],
9822 },
9823 &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
9824 # time the request has been fully processed (known as *end-of-stream*)
9825 # up until the response has been processed. Timeout includes
9826 # all retries.
9827 #
9828 # If not specified, this field uses the largest timeout among all backend
9829 # services associated with the route.
9830 #
9831 # Not supported when the URL map is bound to a target gRPC proxy that
9832 # has validateForProxyless field set to true.
9833 # as a count of seconds and fractions of seconds at nanosecond
9834 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9835 # or &quot;month&quot;. Range is approximately 10,000 years.
9836 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9837 # Durations less than one second are represented with a 0
9838 # `seconds` field and a positive `nanos` field. Must be from 0
9839 # to 999,999,999 inclusive.
9840 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9841 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9842 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9843 },
9844 &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
9845 # to the matched service.
9846 #
9847 # urlRewrite is the only action supported in UrlMaps
9848 # for classic Application Load Balancers.
9849 #
9850 # Not supported when the URL map is bound to a target gRPC proxy that
9851 # has the validateForProxyless field set to true.
9852 # backend service.
9853 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
9854 # host header is replaced with contents of hostRewrite.
9855 #
9856 # The value must be from 1 to 255 characters.
9857 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
9858 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
9859 #
9860 # The value must be from 1 to 1024 characters.
9861 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
9862 # header) using the HTTP template syntax.
9863 #
9864 # A corresponding
9865 # path_template_match must be specified. Any template variables must exist in
9866 # the path_template_match field.
9867 #
9868 #
9869 # - -At least one variable must be specified in the path_template_match
9870 # field
9871 # - You can omit variables from the rewritten URL
9872 # - The * and ** operators cannot be matched
9873 # unless they have a corresponding variable name - e.g.
9874 # {format=*} or {var=**}.
9875 #
9876 # For example, a path_template_match of /static/{format=**}
9877 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
9878 # rewrite, so that /{country}/{format}/{suffix=**} can be
9879 # rewritten as /content/{format}/{country}/{suffix}.
9880 #
9881 # At least
9882 # one non-empty routeRules[].matchRules[].path_template_match is
9883 # required.
9884 #
9885 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
9886 },
9887 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
9888 # occurs. The weights determine the fraction of traffic that flows to
9889 # their corresponding backend service. If all traffic needs to
9890 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
9891 #
9892 # After a backend service is identified and before forwarding
9893 # the request to
9894 # the backend service, advanced routing actions such as URL rewrites and
9895 # header transformations are applied depending on additional settings
9896 # specified in this HttpRouteAction.
9897 { # In contrast to a single BackendService in
9898 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
9899 # multiple backend services. The volume of traffic for each
9900 # backend service is proportional to the weight specified
9901 # in each WeightedBackendService
9902 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
9903 # resource. Before
9904 # forwarding the request to backendService, the load balancer
9905 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
9906 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
9907 # effect for the selected backendService.
9908 #
9909 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
9910 #
9911 # headerAction is not supported for load balancers that have
9912 # their loadBalancingScheme set to EXTERNAL.
9913 #
9914 # Not supported when the URL map is bound to a target gRPC proxy that
9915 # has validateForProxyless field set to true.
9916 # the request is passed along to the selected backendService.
9917 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
9918 { # Specification determining how headers are added to requests or responses.
9919 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
9920 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
9921 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
9922 # that already
9923 # exist for the header. If true, headerValue is set for the
9924 # header, discarding any values that were set for that header.
9925 #
9926 # The default value is true,
9927 # unless a variable is present in headerValue,
9928 # in which case the default value is false.
9929 # .
9930 },
9931 ],
9932 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
9933 # request before forwarding the request to the backendService.
9934 &quot;A String&quot;,
9935 ],
9936 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
9937 # client.
9938 { # Specification determining how headers are added to requests or responses.
9939 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
9940 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
9941 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
9942 # that already
9943 # exist for the header. If true, headerValue is set for the
9944 # header, discarding any values that were set for that header.
9945 #
9946 # The default value is true,
9947 # unless a variable is present in headerValue,
9948 # in which case the default value is false.
9949 # .
9950 },
9951 ],
9952 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
9953 # response before sending the response back to the client.
9954 &quot;A String&quot;,
9955 ],
9956 },
9957 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
9958 # computed asweight / (sum of all weightedBackendService weights in routeAction).
9959 #
9960 # The selection of a backend service is determined only for new traffic.
9961 # Once a user&#x27;s request has been directed to a backend service,
9962 # subsequent requests are sent to the same backend service as
9963 # determined by the backend service&#x27;s session affinity policy.
9964 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
9965 # splitting. If you do, the weighted traffic splitting configuration takes
9966 # precedence.
9967 #
9968 # The value must be from 0 to 1000.
9969 },
9970 ],
9971 },
9972 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource. This
9973 # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
9974 # matched. For example, the
9975 # following are all valid URLs to a BackendService resource:
9976 #
9977 #
9978 # - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
9979 # - compute/v1/projects/project/global/backendServices/backendService
9980 # - global/backendServices/backendService
9981 #
9982 #
9983 # If defaultRouteAction is also specified, advanced
9984 # routing actions, such as URL rewrites, take effect before sending the
9985 # request to the backend.
9986 #
9987 #
9988 # Only one of defaultUrlRedirect, defaultService
9989 # or defaultRouteAction.weightedBackendService can be set.
9990 #
9991 #
9992 # Authorization requires one or more of the following Google IAM permissions on the
9993 # specified resource default_service:
9994 #
9995 #
9996 # - compute.backendBuckets.use
9997 # - compute.backendServices.use
9998 &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
9999 # by defaultUrlRedirect.
10000 #
10001 #
10002 # Only one of defaultUrlRedirect, defaultService
10003 # or defaultRouteAction.weightedBackendService can be set.
10004 #
10005 #
10006 # Not supported when the URL map is bound to a target gRPC proxy.
10007 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
10008 # was supplied in the request.
10009 #
10010 # The value must be from 1 to 255
10011 # characters.
10012 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
10013 # set to HTTPS.
10014 # If set to false, the URL scheme of the redirected request
10015 # remains the same as that of the request.
10016 #
10017 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
10018 #
10019 # The default is set to false.
10020 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
10021 # that was supplied in the request.
10022 #
10023 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
10024 # supplied, the path of the original request is used for the redirect.
10025 #
10026 # The value must be from 1 to 1024 characters.
10027 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
10028 # the HttpRouteRuleMatch, retaining the remaining portion
10029 # of the URL before redirecting the request.
10030 #
10031 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
10032 # supplied, the path of the original request is used for the redirect.
10033 #
10034 # The value must be from 1 to 1024 characters.
10035 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
10036 #
10037 # Supported values are:
10038 #
10039 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
10040 # to 301.
10041 # - FOUND, which corresponds to 302.
10042 # - SEE_OTHER which corresponds to 303.
10043 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
10044 # method is retained.
10045 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
10046 # method is retained.
10047 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
10048 # URL is
10049 # removed before redirecting the request. If set to false, the
10050 # query portion of the original URL is retained.
10051 #
10052 # The default is set to false.
10053 },
10054 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
10055 # create the resource.
10056 &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
10057 # for the selected backend service.
10058 #
10059 # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
10060 #
10061 # HeaderAction is not supported for load balancers
10062 # that have
10063 # their loadBalancingScheme set to EXTERNAL.
10064 #
10065 # Not supported when the URL map is bound to a target gRPC proxy that
10066 # has validateForProxyless field set to true.
10067 # the request is passed along to the selected backendService.
10068 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
10069 { # Specification determining how headers are added to requests or responses.
10070 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
10071 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
10072 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
10073 # that already
10074 # exist for the header. If true, headerValue is set for the
10075 # header, discarding any values that were set for that header.
10076 #
10077 # The default value is true,
10078 # unless a variable is present in headerValue,
10079 # in which case the default value is false.
10080 # .
10081 },
10082 ],
10083 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
10084 # request before forwarding the request to the backendService.
10085 &quot;A String&quot;,
10086 ],
10087 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
10088 # client.
10089 { # Specification determining how headers are added to requests or responses.
10090 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
10091 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
10092 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
10093 # that already
10094 # exist for the header. If true, headerValue is set for the
10095 # header, discarding any values that were set for that header.
10096 #
10097 # The default value is true,
10098 # unless a variable is present in headerValue,
10099 # in which case the default value is false.
10100 # .
10101 },
10102 ],
10103 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
10104 # response before sending the response back to the client.
10105 &quot;A String&quot;,
10106 ],
10107 },
10108 &quot;name&quot;: &quot;A String&quot;, # The name to which this PathMatcher is referred by theHostRule.
10109 &quot;pathRules&quot;: [ # The list of path rules. Use this list instead of routeRules
10110 # when routing based on simple path matching is all that&#x27;s required. A path
10111 # rule can only include a wildcard character (*) after a
10112 # forward slash character (&quot;/&quot;).
10113 #
10114 # The order by which path rules are specified does not matter.
10115 # Matches are always done on the longest-path-first basis.
10116 #
10117 # For example: a pathRule with a path /a/b/c/* will match
10118 # before /a/b/* irrespective of the order in which those paths appear in this
10119 # list.
10120 #
10121 # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
10122 { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
10123 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
10124 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
10125 #
10126 # If a policy for an
10127 # error code is not configured for the PathRule, a policy for
10128 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
10129 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
10130 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
10131 # effect.
10132 #
10133 # For example, consider a UrlMap with the following configuration:
10134 #
10135 #
10136 # - UrlMap.defaultCustomErrorResponsePolicy are configured
10137 # with policies for 5xx and 4xx errors
10138 # - A PathRule for /coming_soon/ is configured for the error
10139 # code 404.
10140 #
10141 # 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
10142 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
10143 # the policy in PathRule.customErrorResponsePolicy takes
10144 # effect. If any of the requests in this example encounter a 500
10145 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
10146 #
10147 # customErrorResponsePolicy is supported only for
10148 # global external Application Load Balancers.
10149 # backend service or backend bucket responds with an error.
10150 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
10151 #
10152 # In a given policy, if you specify rules for both a range of error codes
10153 # as well as rules for specific error codes then rules with specific error
10154 # codes have a higher priority. For example, assume that you configure a rule
10155 # for 401 (Un-authorized) code, and another for all 4 series
10156 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
10157 # However if the backend service returns a 403, the rule for4xx takes effect.
10158 { # Specifies the mapping between the response code that will be returned along
10159 # with the custom error content and the response code returned by the backend
10160 # service.
10161 &quot;matchResponseCodes&quot;: [ # Valid values include:
10162 #
10163 #
10164 # - A number between 400 and 599: For example
10165 # 401 or 503, in which case the load balancer
10166 # applies the policy if the error code exactly matches this value.
10167 # - 5xx: Load Balancer will apply the policy if the
10168 # backend service responds with any response code in the range of
10169 # 500 to 599.
10170 # - 4xx: Load
10171 # Balancer will apply the policy if the backend service responds with any
10172 # response code in the range of 400 to
10173 # 499.
10174 #
10175 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
10176 &quot;A String&quot;,
10177 ],
10178 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
10179 # error content. If overrideResponseCode is not supplied, the
10180 # same response code returned by the original backend bucket or backend
10181 # service is returned to the client.
10182 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
10183 #
10184 # path must start
10185 # with a leading slash. path cannot have trailing slashes.
10186 #
10187 # If the file is not available in backendBucket or the
10188 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
10189 #
10190 # The value must
10191 # be from 1 to 1024 characters
10192 },
10193 ],
10194 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
10195 # contains the custom error content. Examples are:
10196 #
10197 #
10198 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
10199 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
10200 # - global/backendBuckets/myBackendBucket
10201 #
10202 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
10203 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
10204 #
10205 # If load balancer cannot reach
10206 # the backendBucket, a simple Not Found Error will
10207 # be returned, with the original response code (oroverrideResponseCode if configured).
10208 #
10209 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
10210 },
10211 &quot;paths&quot;: [ # The list of path patterns to match. Each must start with /
10212 # and the only place a * is allowed is at the end following
10213 # a /. The string fed to the path matcher does not include
10214 # any text after the first ? or #, and
10215 # those chars are not allowed here.
10216 &quot;A String&quot;,
10217 ],
10218 &quot;routeAction&quot;: { # In response to a matching path, the load balancer
10219 # performs advanced routing actions, such as URL rewrites and header
10220 # transformations, before forwarding the request to the selected
10221 # backend.
10222 #
10223 #
10224 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
10225 #
10226 #
10227 # URL maps for classic Application Load Balancers only support
10228 # the urlRewrite action within a path rule&#x27;srouteAction.
10229 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
10230 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
10231 # property must be specified. This policy cannot be specified if any target
10232 # backend has Identity-Aware Proxy enabled.
10233 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
10234 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
10235 # header names can be specified. The cache is bypassed for all `cacheMode`
10236 # values.
10237 &quot;A String&quot;,
10238 ],
10239 &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
10240 # on the backend type: for Backend Services, the complete request URI is
10241 # used; for Backend Buckets, the request URI is used without the protocol or
10242 # host, and only query parameters known to Cloud Storage are included.
10243 # Policy defined on Route Action.
10244 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
10245 # parameters will be included. Either specify `excludedQueryParameters`
10246 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
10247 # encoded and not treated as delimiters.
10248 #
10249 # Note: This field applies to routes that use backend services. Attempting
10250 # to set it on a route that points exclusively to Backend Buckets will
10251 # result in a configuration error. For routes that point to a Backend
10252 # Bucket, use `includedQueryParameters` to define which parameters should
10253 # be part of the cache key.
10254 &quot;A String&quot;,
10255 ],
10256 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
10257 #
10258 # Note: This setting is only applicable to routes that use a Backend
10259 # Service. It does not affect requests served by a Backend Bucket, as the
10260 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
10261 # it on a route that points exclusively to Backend Buckets will result in a
10262 # configuration error.
10263 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
10264 #
10265 # Note: This setting is only applicable to routes that use a Backend
10266 # Service. It does not affect requests served by a Backend Bucket, as the
10267 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
10268 # set on a route that points exclusively to Backend Buckets will result in
10269 # a configuration error.
10270 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
10271 # `includedQueryParameters` and `excludedQueryParameters`. If neither
10272 # is set, the entire query string will be included. If false, the query
10273 # string will be excluded from the cache key entirely.
10274 #
10275 # Note: This field applies to routes that use backend services. Attempting
10276 # to set it on a route that points exclusively to Backend Buckets will
10277 # result in a configuration error. For routes that point to a Backend
10278 # Bucket, use `includedQueryParameters` to define which parameters should
10279 # be part of the cache key.
10280 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
10281 # The name=value pair will be used in the cache key Cloud CDN generates.
10282 #
10283 # Note: This setting is only applicable to routes that use a Backend
10284 # Service. It does not affect requests served by a Backend Bucket.
10285 # Attempting to set it on a route that points exclusively to Backend
10286 # Buckets will result in a configuration error. Up to 5 cookie names can be
10287 # specified.
10288 &quot;A String&quot;,
10289 ],
10290 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
10291 &quot;A String&quot;,
10292 ],
10293 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
10294 # parameters will be excluded. Either specify `includedQueryParameters`
10295 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
10296 # encoded and not treated as delimiters.
10297 &quot;A String&quot;,
10298 ],
10299 },
10300 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
10301 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
10302 &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
10303 # content. This is used to clamp the max-age (or Expires) value sent to the
10304 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
10305 # is used for the response max-age directive, along with a &quot;public&quot;
10306 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
10307 # clamps the max-age from the origin (if specified), or else sets the
10308 # response max-age directive to the lesser of the `clientTtl` and
10309 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
10310 # present. The maximum allowed value is 31,622,400s (1 year). If not
10311 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
10312 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
10313 # `USE_ORIGIN_HEADERS`.
10314 # as a count of seconds and fractions of seconds at nanosecond
10315 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10316 # or &quot;month&quot;. Range is approximately 10,000 years.
10317 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10318 # Durations less than one second are represented with a 0
10319 # `seconds` field and a positive `nanos` field. Must be from 0
10320 # to 999,999,999 inclusive.
10321 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10322 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10323 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10324 },
10325 &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
10326 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
10327 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
10328 # greater than that of `maxTtl`. When the `cacheMode` is set to
10329 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
10330 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
10331 # accessed objects may be evicted from the cache before the defined TTL. If
10332 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
10333 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
10334 # `USE_ORIGIN_HEADERS`.
10335 # as a count of seconds and fractions of seconds at nanosecond
10336 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10337 # or &quot;month&quot;. Range is approximately 10,000 years.
10338 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10339 # Durations less than one second are represented with a 0
10340 # `seconds` field and a positive `nanos` field. Must be from 0
10341 # to 999,999,999 inclusive.
10342 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10343 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10344 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10345 },
10346 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
10347 # attempt to set a max-age or s-maxage higher than this, or an Expires header
10348 # more than `maxTtl` seconds in the future will be capped at the value of
10349 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
10350 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
10351 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
10352 # Infrequently accessed objects may be evicted from the cache before the
10353 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
10354 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
10355 # mode.
10356 # as a count of seconds and fractions of seconds at nanosecond
10357 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10358 # or &quot;month&quot;. Range is approximately 10,000 years.
10359 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10360 # Durations less than one second are represented with a 0
10361 # `seconds` field and a positive `nanos` field. Must be from 0
10362 # to 999,999,999 inclusive.
10363 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10364 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10365 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10366 },
10367 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
10368 # to apply fine-grained caching for common errors or redirects.
10369 # This can reduce the load on your origin and improve end-user
10370 # experience by reducing response latency.
10371 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
10372 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
10373 # the specified response code that lack any Cache-Control, Expires, or
10374 # Pragma: no-cache directives. When the `cacheMode` is set to
10375 # `FORCE_CACHE_ALL`, negative caching applies to all responses
10376 # with the specified response code, and overrides any caching headers. By
10377 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
10378 #
10379 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
10380 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
10381 # * 405 (Method Not Found), 501 (Not Implemented): 60s
10382 #
10383 # These defaults can be overridden in `negativeCachingPolicy`.
10384 # If not specified, Cloud CDN applies negative caching by default.
10385 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
10386 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
10387 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
10388 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
10389 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
10390 # all response codes that you wish to cache. Cloud CDN will not apply any
10391 # default negative caching when a policy exists.
10392 { # Specify CDN TTLs for response error codes.
10393 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
10394 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
10395 # specified as values, and you cannot specify a status code more than
10396 # once.
10397 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
10398 # corresponding status code.
10399 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
10400 # objects may be evicted from the cache before the defined TTL.
10401 # as a count of seconds and fractions of seconds at nanosecond
10402 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10403 # or &quot;month&quot;. Range is approximately 10,000 years.
10404 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10405 # Durations less than one second are represented with a 0
10406 # `seconds` field and a positive `nanos` field. Must be from 0
10407 # to 999,999,999 inclusive.
10408 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10409 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10410 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10411 },
10412 },
10413 ],
10414 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
10415 # requests into a small number of requests to the origin. If not specified,
10416 # Cloud CDN applies request coalescing by default.
10417 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
10418 # content with the origin, or when an error is encountered when refreshing
10419 # the cache.
10420 # This setting defines the default &quot;max-stale&quot; duration for any cached
10421 # responses that do not specify a max-stale directive. Stale responses that
10422 # exceed the TTL configured here will not be served. The default limit
10423 # (max-stale) is 86400s (1 day), which will allow stale content to be
10424 # served up to this limit beyond the max-age (or s-maxage) of a cached
10425 # response.
10426 # The maximum allowed value is 604800 (1 week).
10427 # Set this to zero (0) to disable serve-while-stale.
10428 # as a count of seconds and fractions of seconds at nanosecond
10429 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10430 # or &quot;month&quot;. Range is approximately 10,000 years.
10431 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10432 # Durations less than one second are represented with a 0
10433 # `seconds` field and a positive `nanos` field. Must be from 0
10434 # to 999,999,999 inclusive.
10435 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10436 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10437 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10438 },
10439 },
10440 &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
10441 # information about the W3C recommendation for cross-origin resource sharing
10442 # (CORS), see Fetch API Living
10443 # Standard.
10444 #
10445 # Not supported when the URL map is bound to a target gRPC proxy.
10446 # information about the W3C recommendation for cross-origin resource sharing
10447 # (CORS), see Fetch API Living
10448 # Standard.
10449 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
10450 # indicates that
10451 # the actual request can include user credentials. This field translates to
10452 # the Access-Control-Allow-Credentials header.
10453 #
10454 # Default is false.
10455 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
10456 # header.
10457 &quot;A String&quot;,
10458 ],
10459 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
10460 # header.
10461 &quot;A String&quot;,
10462 ],
10463 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
10464 # more information, see regular expression syntax.
10465 #
10466 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
10467 #
10468 # Regular expressions can only be used when the loadBalancingScheme is
10469 # set to INTERNAL_SELF_MANAGED.
10470 &quot;A String&quot;,
10471 ],
10472 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
10473 #
10474 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
10475 &quot;A String&quot;,
10476 ],
10477 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
10478 # The default value is false, which indicates that the CORS
10479 # policy is in effect.
10480 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
10481 # header.
10482 &quot;A String&quot;,
10483 ],
10484 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
10485 # seconds. This field translates to the Access-Control-Max-Age
10486 # header.
10487 },
10488 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
10489 # the resiliency of clients to backend service failure. As part of fault
10490 # injection, when clients send requests to a backend service, delays can be
10491 # introduced by a load balancer on a percentage of requests before sending
10492 # those requests to the backend service. Similarly requests from clients can
10493 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
10494 # that are configured with a fault_injection_policy if:
10495 # 1. The traffic is generated by fault injection AND
10496 # 2. The fault injection is not a delay fault injection.
10497 # Fault injection is not supported with the classic Application Load Balancer
10498 # . To see which load balancers support fault injection,
10499 # see Load
10500 # balancing: Routing and traffic management features.
10501 # the resiliency of clients to backend service failure. As part of fault
10502 # injection, when clients send requests to a backend service, delays can be
10503 # introduced by the load balancer on a percentage of requests before sending
10504 # those request to the backend service. Similarly requests from clients can be
10505 # aborted by the load balancer for a percentage of requests.
10506 &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
10507 # injection.
10508 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
10509 #
10510 # The value must be from 200 to 599 inclusive.
10511 #
10512 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
10513 # according to this
10514 # mapping table. HTTP status 200 is mapped to gRPC status
10515 # UNKNOWN. Injecting an OK status is currently not supported by
10516 # Traffic Director.
10517 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
10518 # that is aborted as part of fault injection.
10519 #
10520 # The value must be from 0.0 to 100.0 inclusive.
10521 },
10522 &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
10523 # injection, before being sent to a backend service.
10524 # request to the backend service as part of fault injection.
10525 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
10526 # as a count of seconds and fractions of seconds at nanosecond
10527 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10528 # or &quot;month&quot;. Range is approximately 10,000 years.
10529 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10530 # Durations less than one second are represented with a 0
10531 # `seconds` field and a positive `nanos` field. Must be from 0
10532 # to 999,999,999 inclusive.
10533 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10534 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10535 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10536 },
10537 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
10538 # which a delay is introduced as part of fault injection.
10539 #
10540 # The value must be from 0.0 to 100.0 inclusive.
10541 },
10542 },
10543 &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
10544 # Global EXTERNAL_MANAGED load balancer schemes.
10545 # Either Cloud CDN must be enabled on the backend service or backend bucket
10546 # serving the route, or cache policy must be configured on the same route
10547 # dynamically processes and delivers images from the network edge.
10548 # Image Optimization is only available for Global External Application Load
10549 # Balancers.
10550 # Either Cloud CDN must be enabled on the backend service or backend bucket
10551 # serving the route, or cache policy must be configured on the same route.
10552 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
10553 },
10554 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
10555 # Unlike the timeout field where the timeout duration starts
10556 # from the time the request has been fully processed (known as*end-of-stream*),
10557 # the duration in this field is computed from the beginning of the stream
10558 # until the response has been processed, including all retries. A
10559 # stream that does not complete in this duration is closed.
10560 #
10561 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
10562 # with the route.
10563 #
10564 # This field is only allowed if the Url map is used with backend services
10565 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
10566 # as a count of seconds and fractions of seconds at nanosecond
10567 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10568 # or &quot;month&quot;. Range is approximately 10,000 years.
10569 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10570 # Durations less than one second are represented with a 0
10571 # `seconds` field and a positive `nanos` field. Must be from 0
10572 # to 999,999,999 inclusive.
10573 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10574 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10575 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10576 },
10577 &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
10578 # are shadowed to a separate mirrored backend service. The load balancer does
10579 # not wait for responses from the shadow service. Before sending traffic
10580 # to the shadow service, the host / authority header is suffixed with-shadow.
10581 #
10582 # Not supported when the URL map is bound to a target gRPC proxy that
10583 # has the validateForProxyless field set to true.
10584 # are shadowed to a separate mirrored backend service. The load balancer
10585 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
10586 # to the shadow service, the host or authority header is suffixed with-shadow.
10587 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
10588 # mirrored to.
10589 #
10590 # The backend service configured for a mirroring
10591 # policy must reference backends that are of the same type as the original
10592 # backend service matched in the URL map.
10593 #
10594 # Serverless NEG backends are not currently supported as a mirrored
10595 # backend service.
10596 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
10597 },
10598 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
10599 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
10600 # If not specified, defaults to 1.
10601 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
10602 #
10603 # If not specified, will use the timeout set in theHttpRouteAction field.
10604 # If timeout in the HttpRouteAction field is not set, this field
10605 # uses the largest timeout
10606 # among all backend services associated with the route.
10607 #
10608 # Not supported when the URL map is bound to a target gRPC proxy that
10609 # has the validateForProxyless field set to true.
10610 # as a count of seconds and fractions of seconds at nanosecond
10611 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10612 # or &quot;month&quot;. Range is approximately 10,000 years.
10613 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10614 # Durations less than one second are represented with a 0
10615 # `seconds` field and a positive `nanos` field. Must be from 0
10616 # to 999,999,999 inclusive.
10617 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10618 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10619 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10620 },
10621 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
10622 # values are:
10623 #
10624 # - 5xx: retry is attempted if the instance or endpoint
10625 # responds with any 5xx response code, or if the instance or
10626 # endpoint does not respond at all. For example, disconnects, reset, read
10627 # timeout, connection failure, and refused streams.
10628 # - gateway-error: Similar to 5xx, but only
10629 # applies to response codes 502, 503 or504.
10630 # - connect-failure: a retry is attempted on failures
10631 # connecting to the instance or endpoint. For example, connection
10632 # timeouts.
10633 # - retriable-4xx: a retry is attempted if the instance
10634 # or endpoint responds with a 4xx response code.
10635 # The only error that you can retry is error code 409.
10636 # - refused-stream: a retry is attempted if the instance
10637 # or endpoint resets the stream with a REFUSED_STREAM error
10638 # code. This reset type indicates that it is safe to retry.
10639 # - cancelled: a retry is attempted if the gRPC status
10640 # code in the response header is set to cancelled.
10641 # - deadline-exceeded: a retry is attempted if the gRPC
10642 # status code in the response header is set todeadline-exceeded.
10643 # - internal: a retry is attempted if the gRPC
10644 # status code in the response header is set tointernal.
10645 # - resource-exhausted: a retry is attempted if the gRPC
10646 # status code in the response header is set toresource-exhausted.
10647 # - unavailable: a retry is attempted if the gRPC
10648 # status code in the response header is set tounavailable.
10649 #
10650 # Only the following codes are supported when the URL map is bound to
10651 # target gRPC proxy that has validateForProxyless field set to true.
10652 #
10653 # - cancelled
10654 # - deadline-exceeded
10655 # - internal
10656 # - resource-exhausted
10657 # - unavailable
10658 &quot;A String&quot;,
10659 ],
10660 },
10661 &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
10662 # time the request has been fully processed (known as *end-of-stream*)
10663 # up until the response has been processed. Timeout includes
10664 # all retries.
10665 #
10666 # If not specified, this field uses the largest timeout among all backend
10667 # services associated with the route.
10668 #
10669 # Not supported when the URL map is bound to a target gRPC proxy that
10670 # has validateForProxyless field set to true.
10671 # as a count of seconds and fractions of seconds at nanosecond
10672 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
10673 # or &quot;month&quot;. Range is approximately 10,000 years.
10674 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
10675 # Durations less than one second are represented with a 0
10676 # `seconds` field and a positive `nanos` field. Must be from 0
10677 # to 999,999,999 inclusive.
10678 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
10679 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
10680 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
10681 },
10682 &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
10683 # to the matched service.
10684 #
10685 # urlRewrite is the only action supported in UrlMaps
10686 # for classic Application Load Balancers.
10687 #
10688 # Not supported when the URL map is bound to a target gRPC proxy that
10689 # has the validateForProxyless field set to true.
10690 # backend service.
10691 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
10692 # host header is replaced with contents of hostRewrite.
10693 #
10694 # The value must be from 1 to 255 characters.
10695 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
10696 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
10697 #
10698 # The value must be from 1 to 1024 characters.
10699 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
10700 # header) using the HTTP template syntax.
10701 #
10702 # A corresponding
10703 # path_template_match must be specified. Any template variables must exist in
10704 # the path_template_match field.
10705 #
10706 #
10707 # - -At least one variable must be specified in the path_template_match
10708 # field
10709 # - You can omit variables from the rewritten URL
10710 # - The * and ** operators cannot be matched
10711 # unless they have a corresponding variable name - e.g.
10712 # {format=*} or {var=**}.
10713 #
10714 # For example, a path_template_match of /static/{format=**}
10715 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
10716 # rewrite, so that /{country}/{format}/{suffix=**} can be
10717 # rewritten as /content/{format}/{country}/{suffix}.
10718 #
10719 # At least
10720 # one non-empty routeRules[].matchRules[].path_template_match is
10721 # required.
10722 #
10723 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
10724 },
10725 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
10726 # occurs. The weights determine the fraction of traffic that flows to
10727 # their corresponding backend service. If all traffic needs to
10728 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
10729 #
10730 # After a backend service is identified and before forwarding
10731 # the request to
10732 # the backend service, advanced routing actions such as URL rewrites and
10733 # header transformations are applied depending on additional settings
10734 # specified in this HttpRouteAction.
10735 { # In contrast to a single BackendService in
10736 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
10737 # multiple backend services. The volume of traffic for each
10738 # backend service is proportional to the weight specified
10739 # in each WeightedBackendService
10740 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
10741 # resource. Before
10742 # forwarding the request to backendService, the load balancer
10743 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
10744 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
10745 # effect for the selected backendService.
10746 #
10747 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
10748 #
10749 # headerAction is not supported for load balancers that have
10750 # their loadBalancingScheme set to EXTERNAL.
10751 #
10752 # Not supported when the URL map is bound to a target gRPC proxy that
10753 # has validateForProxyless field set to true.
10754 # the request is passed along to the selected backendService.
10755 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
10756 { # Specification determining how headers are added to requests or responses.
10757 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
10758 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
10759 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
10760 # that already
10761 # exist for the header. If true, headerValue is set for the
10762 # header, discarding any values that were set for that header.
10763 #
10764 # The default value is true,
10765 # unless a variable is present in headerValue,
10766 # in which case the default value is false.
10767 # .
10768 },
10769 ],
10770 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
10771 # request before forwarding the request to the backendService.
10772 &quot;A String&quot;,
10773 ],
10774 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
10775 # client.
10776 { # Specification determining how headers are added to requests or responses.
10777 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
10778 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
10779 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
10780 # that already
10781 # exist for the header. If true, headerValue is set for the
10782 # header, discarding any values that were set for that header.
10783 #
10784 # The default value is true,
10785 # unless a variable is present in headerValue,
10786 # in which case the default value is false.
10787 # .
10788 },
10789 ],
10790 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
10791 # response before sending the response back to the client.
10792 &quot;A String&quot;,
10793 ],
10794 },
10795 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
10796 # computed asweight / (sum of all weightedBackendService weights in routeAction).
10797 #
10798 # The selection of a backend service is determined only for new traffic.
10799 # Once a user&#x27;s request has been directed to a backend service,
10800 # subsequent requests are sent to the same backend service as
10801 # determined by the backend service&#x27;s session affinity policy.
10802 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
10803 # splitting. If you do, the weighted traffic splitting configuration takes
10804 # precedence.
10805 #
10806 # The value must be from 0 to 1000.
10807 },
10808 ],
10809 },
10810 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
10811 # is directed if this rule is matched. If routeAction is
10812 # also specified, advanced routing actions, such as URL rewrites,
10813 # take effect before sending the request to the backend.
10814 #
10815 #
10816 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
10817 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
10818 # specified by urlRedirect.
10819 #
10820 #
10821 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
10822 #
10823 #
10824 # Not supported when the URL map is bound to a target gRPC proxy.
10825 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
10826 # was supplied in the request.
10827 #
10828 # The value must be from 1 to 255
10829 # characters.
10830 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
10831 # set to HTTPS.
10832 # If set to false, the URL scheme of the redirected request
10833 # remains the same as that of the request.
10834 #
10835 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
10836 #
10837 # The default is set to false.
10838 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
10839 # that was supplied in the request.
10840 #
10841 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
10842 # supplied, the path of the original request is used for the redirect.
10843 #
10844 # The value must be from 1 to 1024 characters.
10845 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
10846 # the HttpRouteRuleMatch, retaining the remaining portion
10847 # of the URL before redirecting the request.
10848 #
10849 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
10850 # supplied, the path of the original request is used for the redirect.
10851 #
10852 # The value must be from 1 to 1024 characters.
10853 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
10854 #
10855 # Supported values are:
10856 #
10857 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
10858 # to 301.
10859 # - FOUND, which corresponds to 302.
10860 # - SEE_OTHER which corresponds to 303.
10861 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
10862 # method is retained.
10863 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
10864 # method is retained.
10865 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
10866 # URL is
10867 # removed before redirecting the request. If set to false, the
10868 # query portion of the original URL is retained.
10869 #
10870 # The default is set to false.
10871 },
10872 },
10873 ],
10874 &quot;routeRules&quot;: [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
10875 # desired. routeRules are evaluated in order of priority, from
10876 # the lowest to highest number.
10877 #
10878 # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
10879 { # The HttpRouteRule setting specifies how to match an HTTP request
10880 # and the corresponding routing action that load balancing proxies perform.
10881 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
10882 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
10883 #
10884 # If a policy for an
10885 # error code is not configured for the RouteRule, a policy for
10886 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
10887 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
10888 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
10889 # effect.
10890 #
10891 # For example, consider a UrlMap with the following configuration:
10892 #
10893 #
10894 # - UrlMap.defaultCustomErrorResponsePolicy are configured
10895 # with policies for 5xx and 4xx errors
10896 # - A RouteRule for /coming_soon/ is configured for the
10897 # error code 404.
10898 #
10899 # 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
10900 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
10901 # the policy in RouteRule.customErrorResponsePolicy takes
10902 # effect. If any of the requests in this example encounter a 500
10903 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
10904 #
10905 # When
10906 # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
10907 # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
10908 # a retry, if load balancer is successful in reaching the
10909 # service, the customErrorResponsePolicy is ignored and
10910 # the response from the service is returned to the client.
10911 #
10912 # customErrorResponsePolicy is supported only for
10913 # global external Application Load Balancers.
10914 # backend service or backend bucket responds with an error.
10915 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
10916 #
10917 # In a given policy, if you specify rules for both a range of error codes
10918 # as well as rules for specific error codes then rules with specific error
10919 # codes have a higher priority. For example, assume that you configure a rule
10920 # for 401 (Un-authorized) code, and another for all 4 series
10921 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
10922 # However if the backend service returns a 403, the rule for4xx takes effect.
10923 { # Specifies the mapping between the response code that will be returned along
10924 # with the custom error content and the response code returned by the backend
10925 # service.
10926 &quot;matchResponseCodes&quot;: [ # Valid values include:
10927 #
10928 #
10929 # - A number between 400 and 599: For example
10930 # 401 or 503, in which case the load balancer
10931 # applies the policy if the error code exactly matches this value.
10932 # - 5xx: Load Balancer will apply the policy if the
10933 # backend service responds with any response code in the range of
10934 # 500 to 599.
10935 # - 4xx: Load
10936 # Balancer will apply the policy if the backend service responds with any
10937 # response code in the range of 400 to
10938 # 499.
10939 #
10940 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
10941 &quot;A String&quot;,
10942 ],
10943 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
10944 # error content. If overrideResponseCode is not supplied, the
10945 # same response code returned by the original backend bucket or backend
10946 # service is returned to the client.
10947 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
10948 #
10949 # path must start
10950 # with a leading slash. path cannot have trailing slashes.
10951 #
10952 # If the file is not available in backendBucket or the
10953 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
10954 #
10955 # The value must
10956 # be from 1 to 1024 characters
10957 },
10958 ],
10959 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
10960 # contains the custom error content. Examples are:
10961 #
10962 #
10963 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
10964 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
10965 # - global/backendBuckets/myBackendBucket
10966 #
10967 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
10968 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
10969 #
10970 # If load balancer cannot reach
10971 # the backendBucket, a simple Not Found Error will
10972 # be returned, with the original response code (oroverrideResponseCode if configured).
10973 #
10974 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
10975 },
10976 &quot;description&quot;: &quot;A String&quot;, # The short description conveying the intent of this routeRule.
10977 #
10978 #
10979 # The description can have a maximum length of 1024 characters.
10980 &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
10981 # for the selected backendService.
10982 #
10983 # The headerAction value specified here is applied before the
10984 # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
10985 #
10986 # HeaderAction is not supported for load balancers
10987 # that have
10988 # their loadBalancingScheme set to EXTERNAL.
10989 #
10990 # Not supported when the URL map is bound to a target gRPC proxy that
10991 # has validateForProxyless field set to true.
10992 # the request is passed along to the selected backendService.
10993 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
10994 { # Specification determining how headers are added to requests or responses.
10995 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
10996 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
10997 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
10998 # that already
10999 # exist for the header. If true, headerValue is set for the
11000 # header, discarding any values that were set for that header.
11001 #
11002 # The default value is true,
11003 # unless a variable is present in headerValue,
11004 # in which case the default value is false.
11005 # .
11006 },
11007 ],
11008 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
11009 # request before forwarding the request to the backendService.
11010 &quot;A String&quot;,
11011 ],
11012 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
11013 # client.
11014 { # Specification determining how headers are added to requests or responses.
11015 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
11016 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
11017 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
11018 # that already
11019 # exist for the header. If true, headerValue is set for the
11020 # header, discarding any values that were set for that header.
11021 #
11022 # The default value is true,
11023 # unless a variable is present in headerValue,
11024 # in which case the default value is false.
11025 # .
11026 },
11027 ],
11028 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
11029 # response before sending the response back to the client.
11030 &quot;A String&quot;,
11031 ],
11032 },
11033 &quot;httpFilterConfigs&quot;: [ # Outbound route specific configuration fornetworkservices.HttpFilter resources enabled by Traffic
11034 # Director. httpFilterConfigs only applies for load balancers
11035 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
11036 # more details.
11037 #
11038 # Not supported when the URL map is bound to a target gRPC proxy that
11039 # has validateForProxyless field set to true.
11040 { # HttpFilterConfiguration supplies additional contextual settings
11041 # for networkservices.HttpFilter resources enabled by Traffic
11042 # Director.
11043 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
11044 # YAML formatted and only contain fields defined in the protobuf identified
11045 # in configTypeUrl
11046 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
11047 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
11048 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
11049 # configuration belongs to. This name must be known to the xDS client.
11050 # Example: envoy.wasm
11051 },
11052 ],
11053 &quot;httpFilterMetadata&quot;: [ # Outbound route specific metadata supplied tonetworkservices.HttpFilter resources enabled by Traffic
11054 # Director. httpFilterMetadata only applies for load balancers
11055 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
11056 # more details.
11057 #
11058 # The only configTypeUrl supported istype.googleapis.com/google.protobuf.Struct
11059 #
11060 # Not supported when the URL map is bound to a target gRPC proxy that
11061 # has validateForProxyless field set to true.
11062 { # HttpFilterConfiguration supplies additional contextual settings
11063 # for networkservices.HttpFilter resources enabled by Traffic
11064 # Director.
11065 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
11066 # YAML formatted and only contain fields defined in the protobuf identified
11067 # in configTypeUrl
11068 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
11069 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
11070 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
11071 # configuration belongs to. This name must be known to the xDS client.
11072 # Example: envoy.wasm
11073 },
11074 ],
11075 &quot;matchRules&quot;: [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
11076 # this routeRule when any of thematchRules are satisfied. However predicates within
11077 # a given matchRule have AND semantics. All predicates
11078 # within a matchRule must match for the request to
11079 # match the rule.
11080 { # HttpRouteRuleMatch specifies a set of criteria for matching
11081 # requests to an HttpRouteRule. All specified criteria must
11082 # be satisfied for a match to occur.
11083 &quot;fullPathMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
11084 # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
11085 # that may be part of the original URL.
11086 #
11087 # fullPathMatch must be from 1 to 1024 characters.
11088 #
11089 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
11090 # specified.
11091 &quot;headerMatches&quot;: [ # Specifies a list of header match criteria, all of which must match
11092 # corresponding headers in the request.
11093 { # matchRule criteria for request header matches.
11094 &quot;exactMatch&quot;: &quot;A String&quot;, # The value should exactly match contents of exactMatch.
11095 #
11096 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
11097 &quot;headerName&quot;: &quot;A String&quot;, # The name of the HTTP header to match.
11098 #
11099 # For matching against the HTTP request&#x27;s authority, use a headerMatch
11100 # with the header name &quot;:authority&quot;.
11101 #
11102 # For matching a request&#x27;s method, use the headerName &quot;:method&quot;.
11103 #
11104 # When the URL map is bound to a target gRPC proxy that has
11105 # the validateForProxyless field set to true, only
11106 # non-binary
11107 # user-specified custom metadata and the `content-type` header are supported.
11108 # The following transport-level headers cannot be used in header matching
11109 # rules:
11110 # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
11111 # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
11112 # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
11113 # `grpc-timeout` and `grpc-trace-bin`.
11114 &quot;invertMatch&quot;: True or False, # If set to false, the headerMatch is considered a
11115 # match if the preceding match criteria are met. If set to true,
11116 # the headerMatch is considered a match if the preceding
11117 # match criteria are NOT met.
11118 #
11119 # The default setting is false.
11120 &quot;prefixMatch&quot;: &quot;A String&quot;, # The value of the header must start with the contents ofprefixMatch.
11121 #
11122 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
11123 &quot;presentMatch&quot;: True or False, # A header with the contents of headerName must exist. The
11124 # match takes place whether or not the request&#x27;s header has a value.
11125 #
11126 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
11127 &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
11128 # specified in rangeMatch. If the header does not contain an
11129 # integer, number or is empty, the match fails.
11130 #
11131 # For example for a range [-5, 0]
11132 #
11133 #
11134 # - -3 will match.
11135 # - 0 will not match.
11136 # - 0.25 will not match.
11137 # - -3someString will not match.
11138 #
11139 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
11140 #
11141 # rangeMatch is not supported for load balancers
11142 # that have loadBalancingScheme set to EXTERNAL.
11143 # within the specified integer range.
11144 &quot;rangeEnd&quot;: &quot;A String&quot;, # The end of the range (exclusive) in signed long integer format.
11145 &quot;rangeStart&quot;: &quot;A String&quot;, # The start of the range (inclusive) in signed long integer format.
11146 },
11147 &quot;regexMatch&quot;: &quot;A String&quot;, # The value of the header must match the regular expression specified inregexMatch.
11148 # For more information about regular expression syntax, see Syntax.
11149 #
11150 # For matching against a port specified in the HTTP request, use a
11151 # headerMatch with headerName set to PORT and a regular expression that
11152 # satisfies the RFC2616 Host header&#x27;s port specifier.
11153 #
11154 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
11155 #
11156 # Regular expressions can only be used when the loadBalancingScheme is
11157 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
11158 # (regional scope) or INTERNAL_MANAGED.
11159 &quot;suffixMatch&quot;: &quot;A String&quot;, # The value of the header must end with the contents ofsuffixMatch.
11160 #
11161 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
11162 },
11163 ],
11164 &quot;ignoreCase&quot;: True or False, # Specifies that prefixMatch and fullPathMatch
11165 # matches are case sensitive.
11166 #
11167 # The default value is false.
11168 #
11169 # ignoreCase must not be used with regexMatch.
11170 #
11171 # Not supported when the URL map is bound to a target gRPC proxy.
11172 &quot;metadataFilters&quot;: [ # Opaque filter criteria used by the load balancer to restrict routing
11173 # configuration to a limited set of xDS
11174 # compliant clients. In their xDS requests to the load balancer, xDS clients
11175 # present node
11176 # metadata. When there is a match, the relevant routing configuration
11177 # is made available to those proxies.
11178 #
11179 # 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
11180 # the metadata. If its filterMatchCriteria is set to
11181 # MATCH_ALL, then all of its filterLabels must match with
11182 # corresponding labels provided in the metadata. If multiple
11183 # metadata filters are specified, all of them need to be
11184 # satisfied in order to be considered a match.
11185 #
11186 # metadataFilters specified here is applied after those
11187 # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
11188 #
11189 # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
11190 #
11191 # Not supported when the URL map is bound to a target gRPC proxy that
11192 # has validateForProxyless field set to true.
11193 { # Opaque filter criteria used by load balancers to restrict routing
11194 # configuration to a limited set of load balancing proxies. Proxies and
11195 # sidecars involved in load balancing would typically present metadata to the
11196 # load balancers that need to match criteria specified here. If a match takes
11197 # place, the relevant configuration is made available to those
11198 # proxies.
11199 #
11200 # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
11201 # one of thefilterLabels must match the corresponding label provided in
11202 # the metadata. If its filterMatchCriteria is set to
11203 # MATCH_ALL, then all of its filterLabels must match with
11204 # corresponding labels provided in the metadata.
11205 #
11206 # An example for using metadataFilters would be: if
11207 # load balancing involves
11208 # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in of their XDS requests to loadbalancers.
11209 &quot;filterLabels&quot;: [ # The list of label value pairs that must match labels in the provided
11210 # metadata based on filterMatchCriteria
11211 #
11212 # This list must not be empty and can have at the most 64 entries.
11213 { # MetadataFilter label name value pairs that are expected
11214 # to match corresponding labels presented as metadata to the load balancer.
11215 &quot;name&quot;: &quot;A String&quot;, # Name of metadata label.
11216 #
11217 # The name can have a maximum length of 1024 characters and must be at
11218 # least 1 character long.
11219 &quot;value&quot;: &quot;A String&quot;, # The value of the label must match the specified value.
11220 #
11221 # value can have a maximum length of 1024 characters.
11222 },
11223 ],
11224 &quot;filterMatchCriteria&quot;: &quot;A String&quot;, # Specifies how individual filter label matches
11225 # within the list of filterLabels and contributes toward the
11226 # overall metadataFilter match.
11227 #
11228 # Supported values are:
11229 #
11230 # - MATCH_ANY: at least one of the filterLabels
11231 # must have a matching label in the provided metadata.
11232 # - MATCH_ALL: all filterLabels must have
11233 # matching labels in the provided metadata.
11234 },
11235 ],
11236 &quot;pathTemplateMatch&quot;: &quot;A String&quot;, # If specified, this field defines a path template pattern that must match
11237 # the :path header after the query string is removed.
11238 #
11239 # A path template pattern can include variables and wildcards.
11240 # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
11241 # matches a single path segment, and ** that matches zero or
11242 # more path segments. The pattern must follow these rules:
11243 #
11244 #
11245 # - The value must be between 1 and 1024 characters.
11246 # - The pattern must start with a leading slash (&quot;/&quot;).
11247 # - No more than 5 operators (variables or wildcards) may appear in
11248 # the pattern.
11249 #
11250 # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
11251 # set.
11252 &quot;prefixMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the request&#x27;s
11253 # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
11254 #
11255 # The value must be from 1 to 1024 characters.
11256 #
11257 # The * character inside a prefix match is
11258 # treated as a literal character, not as a wildcard.
11259 #
11260 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
11261 # used within a matchRule.
11262 &quot;queryParameterMatches&quot;: [ # Specifies a list of query parameter match criteria, all of which must
11263 # match corresponding query parameters in the request.
11264 #
11265 # Not supported when the URL map is bound to a target gRPC proxy.
11266 { # HttpRouteRuleMatch criteria for a request&#x27;s query parameter.
11267 &quot;exactMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
11268 # parameter exactly matches the contents of exactMatch.
11269 #
11270 # Only one of presentMatch, exactMatch, orregexMatch must be set.
11271 &quot;name&quot;: &quot;A String&quot;, # The name of the query parameter to match. The query parameter must exist in
11272 # the request, in the absence of which the request match fails.
11273 &quot;presentMatch&quot;: True or False, # Specifies that the queryParameterMatch matches if the
11274 # request contains the query parameter, irrespective of whether the
11275 # parameter has a value or not.
11276 #
11277 # Only one of presentMatch, exactMatch, orregexMatch must be set.
11278 &quot;regexMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
11279 # parameter matches the regular expression specified byregexMatch. For
11280 # more information about regular expression syntax, see Syntax.
11281 #
11282 # Only one of presentMatch, exactMatch, orregexMatch must be set.
11283 #
11284 # Regular expressions can only be used when the loadBalancingScheme is
11285 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
11286 # (regional scope) or INTERNAL_MANAGED.
11287 },
11288 ],
11289 &quot;regexMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
11290 # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
11291 # supplied with the original URL. For
11292 # more information about regular expression syntax, see Syntax.
11293 #
11294 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
11295 # specified.
11296 #
11297 # Regular expressions can only be used when the loadBalancingScheme is
11298 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
11299 # (regional scope) or INTERNAL_MANAGED.
11300 },
11301 ],
11302 &quot;priority&quot;: 42, # For routeRules within a given pathMatcher,
11303 # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
11304 # of priority, from the lowest to highest number. The priority of a
11305 # rule decreases as its number increases (1, 2, 3, N+1). The first rule
11306 # that matches the request is applied.
11307 #
11308 #
11309 # You cannot configure two or more routeRules with the same priority.
11310 # Priority for each rule must be set to a number from 0 to 2147483647
11311 # inclusive.
11312 #
11313 #
11314 # Priority numbers can have gaps, which enable you to add or remove rules
11315 # in the future without affecting the rest of the rules. For example, 1, 2,
11316 # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
11317 # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
11318 # without any impact on existing rules.
11319 &quot;routeAction&quot;: { # In response to a matching matchRule, the load balancer
11320 # performs advanced routing actions, such as URL rewrites and header
11321 # transformations, before forwarding the request to the selected backend.
11322 #
11323 #
11324 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
11325 #
11326 #
11327 # URL maps for classic Application Load Balancers only support
11328 # the urlRewrite action within a route rule&#x27;srouteAction.
11329 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
11330 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
11331 # property must be specified. This policy cannot be specified if any target
11332 # backend has Identity-Aware Proxy enabled.
11333 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
11334 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
11335 # header names can be specified. The cache is bypassed for all `cacheMode`
11336 # values.
11337 &quot;A String&quot;,
11338 ],
11339 &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
11340 # on the backend type: for Backend Services, the complete request URI is
11341 # used; for Backend Buckets, the request URI is used without the protocol or
11342 # host, and only query parameters known to Cloud Storage are included.
11343 # Policy defined on Route Action.
11344 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
11345 # parameters will be included. Either specify `excludedQueryParameters`
11346 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
11347 # encoded and not treated as delimiters.
11348 #
11349 # Note: This field applies to routes that use backend services. Attempting
11350 # to set it on a route that points exclusively to Backend Buckets will
11351 # result in a configuration error. For routes that point to a Backend
11352 # Bucket, use `includedQueryParameters` to define which parameters should
11353 # be part of the cache key.
11354 &quot;A String&quot;,
11355 ],
11356 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
11357 #
11358 # Note: This setting is only applicable to routes that use a Backend
11359 # Service. It does not affect requests served by a Backend Bucket, as the
11360 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
11361 # it on a route that points exclusively to Backend Buckets will result in a
11362 # configuration error.
11363 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
11364 #
11365 # Note: This setting is only applicable to routes that use a Backend
11366 # Service. It does not affect requests served by a Backend Bucket, as the
11367 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
11368 # set on a route that points exclusively to Backend Buckets will result in
11369 # a configuration error.
11370 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
11371 # `includedQueryParameters` and `excludedQueryParameters`. If neither
11372 # is set, the entire query string will be included. If false, the query
11373 # string will be excluded from the cache key entirely.
11374 #
11375 # Note: This field applies to routes that use backend services. Attempting
11376 # to set it on a route that points exclusively to Backend Buckets will
11377 # result in a configuration error. For routes that point to a Backend
11378 # Bucket, use `includedQueryParameters` to define which parameters should
11379 # be part of the cache key.
11380 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
11381 # The name=value pair will be used in the cache key Cloud CDN generates.
11382 #
11383 # Note: This setting is only applicable to routes that use a Backend
11384 # Service. It does not affect requests served by a Backend Bucket.
11385 # Attempting to set it on a route that points exclusively to Backend
11386 # Buckets will result in a configuration error. Up to 5 cookie names can be
11387 # specified.
11388 &quot;A String&quot;,
11389 ],
11390 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
11391 &quot;A String&quot;,
11392 ],
11393 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
11394 # parameters will be excluded. Either specify `includedQueryParameters`
11395 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
11396 # encoded and not treated as delimiters.
11397 &quot;A String&quot;,
11398 ],
11399 },
11400 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
11401 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
11402 &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
11403 # content. This is used to clamp the max-age (or Expires) value sent to the
11404 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
11405 # is used for the response max-age directive, along with a &quot;public&quot;
11406 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
11407 # clamps the max-age from the origin (if specified), or else sets the
11408 # response max-age directive to the lesser of the `clientTtl` and
11409 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
11410 # present. The maximum allowed value is 31,622,400s (1 year). If not
11411 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
11412 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
11413 # `USE_ORIGIN_HEADERS`.
11414 # as a count of seconds and fractions of seconds at nanosecond
11415 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
11416 # or &quot;month&quot;. Range is approximately 10,000 years.
11417 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
11418 # Durations less than one second are represented with a 0
11419 # `seconds` field and a positive `nanos` field. Must be from 0
11420 # to 999,999,999 inclusive.
11421 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
11422 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
11423 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
11424 },
11425 &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
11426 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
11427 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
11428 # greater than that of `maxTtl`. When the `cacheMode` is set to
11429 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
11430 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
11431 # accessed objects may be evicted from the cache before the defined TTL. If
11432 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
11433 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
11434 # `USE_ORIGIN_HEADERS`.
11435 # as a count of seconds and fractions of seconds at nanosecond
11436 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
11437 # or &quot;month&quot;. Range is approximately 10,000 years.
11438 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
11439 # Durations less than one second are represented with a 0
11440 # `seconds` field and a positive `nanos` field. Must be from 0
11441 # to 999,999,999 inclusive.
11442 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
11443 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
11444 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
11445 },
11446 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
11447 # attempt to set a max-age or s-maxage higher than this, or an Expires header
11448 # more than `maxTtl` seconds in the future will be capped at the value of
11449 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
11450 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
11451 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
11452 # Infrequently accessed objects may be evicted from the cache before the
11453 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
11454 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
11455 # mode.
11456 # as a count of seconds and fractions of seconds at nanosecond
11457 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
11458 # or &quot;month&quot;. Range is approximately 10,000 years.
11459 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
11460 # Durations less than one second are represented with a 0
11461 # `seconds` field and a positive `nanos` field. Must be from 0
11462 # to 999,999,999 inclusive.
11463 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
11464 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
11465 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
11466 },
11467 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
11468 # to apply fine-grained caching for common errors or redirects.
11469 # This can reduce the load on your origin and improve end-user
11470 # experience by reducing response latency.
11471 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
11472 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
11473 # the specified response code that lack any Cache-Control, Expires, or
11474 # Pragma: no-cache directives. When the `cacheMode` is set to
11475 # `FORCE_CACHE_ALL`, negative caching applies to all responses
11476 # with the specified response code, and overrides any caching headers. By
11477 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
11478 #
11479 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
11480 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
11481 # * 405 (Method Not Found), 501 (Not Implemented): 60s
11482 #
11483 # These defaults can be overridden in `negativeCachingPolicy`.
11484 # If not specified, Cloud CDN applies negative caching by default.
11485 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
11486 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
11487 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
11488 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
11489 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
11490 # all response codes that you wish to cache. Cloud CDN will not apply any
11491 # default negative caching when a policy exists.
11492 { # Specify CDN TTLs for response error codes.
11493 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
11494 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
11495 # specified as values, and you cannot specify a status code more than
11496 # once.
11497 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
11498 # corresponding status code.
11499 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
11500 # objects may be evicted from the cache before the defined TTL.
11501 # as a count of seconds and fractions of seconds at nanosecond
11502 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
11503 # or &quot;month&quot;. Range is approximately 10,000 years.
11504 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
11505 # Durations less than one second are represented with a 0
11506 # `seconds` field and a positive `nanos` field. Must be from 0
11507 # to 999,999,999 inclusive.
11508 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
11509 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
11510 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
11511 },
11512 },
11513 ],
11514 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
11515 # requests into a small number of requests to the origin. If not specified,
11516 # Cloud CDN applies request coalescing by default.
11517 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
11518 # content with the origin, or when an error is encountered when refreshing
11519 # the cache.
11520 # This setting defines the default &quot;max-stale&quot; duration for any cached
11521 # responses that do not specify a max-stale directive. Stale responses that
11522 # exceed the TTL configured here will not be served. The default limit
11523 # (max-stale) is 86400s (1 day), which will allow stale content to be
11524 # served up to this limit beyond the max-age (or s-maxage) of a cached
11525 # response.
11526 # The maximum allowed value is 604800 (1 week).
11527 # Set this to zero (0) to disable serve-while-stale.
11528 # as a count of seconds and fractions of seconds at nanosecond
11529 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
11530 # or &quot;month&quot;. Range is approximately 10,000 years.
11531 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
11532 # Durations less than one second are represented with a 0
11533 # `seconds` field and a positive `nanos` field. Must be from 0
11534 # to 999,999,999 inclusive.
11535 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
11536 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
11537 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
11538 },
11539 },
11540 &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
11541 # information about the W3C recommendation for cross-origin resource sharing
11542 # (CORS), see Fetch API Living
11543 # Standard.
11544 #
11545 # Not supported when the URL map is bound to a target gRPC proxy.
11546 # information about the W3C recommendation for cross-origin resource sharing
11547 # (CORS), see Fetch API Living
11548 # Standard.
11549 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
11550 # indicates that
11551 # the actual request can include user credentials. This field translates to
11552 # the Access-Control-Allow-Credentials header.
11553 #
11554 # Default is false.
11555 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
11556 # header.
11557 &quot;A String&quot;,
11558 ],
11559 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
11560 # header.
11561 &quot;A String&quot;,
11562 ],
11563 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
11564 # more information, see regular expression syntax.
11565 #
11566 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
11567 #
11568 # Regular expressions can only be used when the loadBalancingScheme is
11569 # set to INTERNAL_SELF_MANAGED.
11570 &quot;A String&quot;,
11571 ],
11572 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
11573 #
11574 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
11575 &quot;A String&quot;,
11576 ],
11577 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
11578 # The default value is false, which indicates that the CORS
11579 # policy is in effect.
11580 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
11581 # header.
11582 &quot;A String&quot;,
11583 ],
11584 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
11585 # seconds. This field translates to the Access-Control-Max-Age
11586 # header.
11587 },
11588 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
11589 # the resiliency of clients to backend service failure. As part of fault
11590 # injection, when clients send requests to a backend service, delays can be
11591 # introduced by a load balancer on a percentage of requests before sending
11592 # those requests to the backend service. Similarly requests from clients can
11593 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
11594 # that are configured with a fault_injection_policy if:
11595 # 1. The traffic is generated by fault injection AND
11596 # 2. The fault injection is not a delay fault injection.
11597 # Fault injection is not supported with the classic Application Load Balancer
11598 # . To see which load balancers support fault injection,
11599 # see Load
11600 # balancing: Routing and traffic management features.
11601 # the resiliency of clients to backend service failure. As part of fault
11602 # injection, when clients send requests to a backend service, delays can be
11603 # introduced by the load balancer on a percentage of requests before sending
11604 # those request to the backend service. Similarly requests from clients can be
11605 # aborted by the load balancer for a percentage of requests.
11606 &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
11607 # injection.
11608 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
11609 #
11610 # The value must be from 200 to 599 inclusive.
11611 #
11612 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
11613 # according to this
11614 # mapping table. HTTP status 200 is mapped to gRPC status
11615 # UNKNOWN. Injecting an OK status is currently not supported by
11616 # Traffic Director.
11617 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
11618 # that is aborted as part of fault injection.
11619 #
11620 # The value must be from 0.0 to 100.0 inclusive.
11621 },
11622 &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
11623 # injection, before being sent to a backend service.
11624 # request to the backend service as part of fault injection.
11625 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
11626 # as a count of seconds and fractions of seconds at nanosecond
11627 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
11628 # or &quot;month&quot;. Range is approximately 10,000 years.
11629 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
11630 # Durations less than one second are represented with a 0
11631 # `seconds` field and a positive `nanos` field. Must be from 0
11632 # to 999,999,999 inclusive.
11633 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
11634 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
11635 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
11636 },
11637 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
11638 # which a delay is introduced as part of fault injection.
11639 #
11640 # The value must be from 0.0 to 100.0 inclusive.
11641 },
11642 },
11643 &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
11644 # Global EXTERNAL_MANAGED load balancer schemes.
11645 # Either Cloud CDN must be enabled on the backend service or backend bucket
11646 # serving the route, or cache policy must be configured on the same route
11647 # dynamically processes and delivers images from the network edge.
11648 # Image Optimization is only available for Global External Application Load
11649 # Balancers.
11650 # Either Cloud CDN must be enabled on the backend service or backend bucket
11651 # serving the route, or cache policy must be configured on the same route.
11652 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
11653 },
11654 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
11655 # Unlike the timeout field where the timeout duration starts
11656 # from the time the request has been fully processed (known as*end-of-stream*),
11657 # the duration in this field is computed from the beginning of the stream
11658 # until the response has been processed, including all retries. A
11659 # stream that does not complete in this duration is closed.
11660 #
11661 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
11662 # with the route.
11663 #
11664 # This field is only allowed if the Url map is used with backend services
11665 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
11666 # as a count of seconds and fractions of seconds at nanosecond
11667 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
11668 # or &quot;month&quot;. Range is approximately 10,000 years.
11669 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
11670 # Durations less than one second are represented with a 0
11671 # `seconds` field and a positive `nanos` field. Must be from 0
11672 # to 999,999,999 inclusive.
11673 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
11674 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
11675 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
11676 },
11677 &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
11678 # are shadowed to a separate mirrored backend service. The load balancer does
11679 # not wait for responses from the shadow service. Before sending traffic
11680 # to the shadow service, the host / authority header is suffixed with-shadow.
11681 #
11682 # Not supported when the URL map is bound to a target gRPC proxy that
11683 # has the validateForProxyless field set to true.
11684 # are shadowed to a separate mirrored backend service. The load balancer
11685 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
11686 # to the shadow service, the host or authority header is suffixed with-shadow.
11687 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
11688 # mirrored to.
11689 #
11690 # The backend service configured for a mirroring
11691 # policy must reference backends that are of the same type as the original
11692 # backend service matched in the URL map.
11693 #
11694 # Serverless NEG backends are not currently supported as a mirrored
11695 # backend service.
11696 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
11697 },
11698 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
11699 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
11700 # If not specified, defaults to 1.
11701 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
11702 #
11703 # If not specified, will use the timeout set in theHttpRouteAction field.
11704 # If timeout in the HttpRouteAction field is not set, this field
11705 # uses the largest timeout
11706 # among all backend services associated with the route.
11707 #
11708 # Not supported when the URL map is bound to a target gRPC proxy that
11709 # has the validateForProxyless field set to true.
11710 # as a count of seconds and fractions of seconds at nanosecond
11711 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
11712 # or &quot;month&quot;. Range is approximately 10,000 years.
11713 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
11714 # Durations less than one second are represented with a 0
11715 # `seconds` field and a positive `nanos` field. Must be from 0
11716 # to 999,999,999 inclusive.
11717 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
11718 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
11719 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
11720 },
11721 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
11722 # values are:
11723 #
11724 # - 5xx: retry is attempted if the instance or endpoint
11725 # responds with any 5xx response code, or if the instance or
11726 # endpoint does not respond at all. For example, disconnects, reset, read
11727 # timeout, connection failure, and refused streams.
11728 # - gateway-error: Similar to 5xx, but only
11729 # applies to response codes 502, 503 or504.
11730 # - connect-failure: a retry is attempted on failures
11731 # connecting to the instance or endpoint. For example, connection
11732 # timeouts.
11733 # - retriable-4xx: a retry is attempted if the instance
11734 # or endpoint responds with a 4xx response code.
11735 # The only error that you can retry is error code 409.
11736 # - refused-stream: a retry is attempted if the instance
11737 # or endpoint resets the stream with a REFUSED_STREAM error
11738 # code. This reset type indicates that it is safe to retry.
11739 # - cancelled: a retry is attempted if the gRPC status
11740 # code in the response header is set to cancelled.
11741 # - deadline-exceeded: a retry is attempted if the gRPC
11742 # status code in the response header is set todeadline-exceeded.
11743 # - internal: a retry is attempted if the gRPC
11744 # status code in the response header is set tointernal.
11745 # - resource-exhausted: a retry is attempted if the gRPC
11746 # status code in the response header is set toresource-exhausted.
11747 # - unavailable: a retry is attempted if the gRPC
11748 # status code in the response header is set tounavailable.
11749 #
11750 # Only the following codes are supported when the URL map is bound to
11751 # target gRPC proxy that has validateForProxyless field set to true.
11752 #
11753 # - cancelled
11754 # - deadline-exceeded
11755 # - internal
11756 # - resource-exhausted
11757 # - unavailable
11758 &quot;A String&quot;,
11759 ],
11760 },
11761 &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
11762 # time the request has been fully processed (known as *end-of-stream*)
11763 # up until the response has been processed. Timeout includes
11764 # all retries.
11765 #
11766 # If not specified, this field uses the largest timeout among all backend
11767 # services associated with the route.
11768 #
11769 # Not supported when the URL map is bound to a target gRPC proxy that
11770 # has validateForProxyless field set to true.
11771 # as a count of seconds and fractions of seconds at nanosecond
11772 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
11773 # or &quot;month&quot;. Range is approximately 10,000 years.
11774 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
11775 # Durations less than one second are represented with a 0
11776 # `seconds` field and a positive `nanos` field. Must be from 0
11777 # to 999,999,999 inclusive.
11778 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
11779 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
11780 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
11781 },
11782 &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
11783 # to the matched service.
11784 #
11785 # urlRewrite is the only action supported in UrlMaps
11786 # for classic Application Load Balancers.
11787 #
11788 # Not supported when the URL map is bound to a target gRPC proxy that
11789 # has the validateForProxyless field set to true.
11790 # backend service.
11791 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
11792 # host header is replaced with contents of hostRewrite.
11793 #
11794 # The value must be from 1 to 255 characters.
11795 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
11796 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
11797 #
11798 # The value must be from 1 to 1024 characters.
11799 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
11800 # header) using the HTTP template syntax.
11801 #
11802 # A corresponding
11803 # path_template_match must be specified. Any template variables must exist in
11804 # the path_template_match field.
11805 #
11806 #
11807 # - -At least one variable must be specified in the path_template_match
11808 # field
11809 # - You can omit variables from the rewritten URL
11810 # - The * and ** operators cannot be matched
11811 # unless they have a corresponding variable name - e.g.
11812 # {format=*} or {var=**}.
11813 #
11814 # For example, a path_template_match of /static/{format=**}
11815 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
11816 # rewrite, so that /{country}/{format}/{suffix=**} can be
11817 # rewritten as /content/{format}/{country}/{suffix}.
11818 #
11819 # At least
11820 # one non-empty routeRules[].matchRules[].path_template_match is
11821 # required.
11822 #
11823 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
11824 },
11825 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
11826 # occurs. The weights determine the fraction of traffic that flows to
11827 # their corresponding backend service. If all traffic needs to
11828 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
11829 #
11830 # After a backend service is identified and before forwarding
11831 # the request to
11832 # the backend service, advanced routing actions such as URL rewrites and
11833 # header transformations are applied depending on additional settings
11834 # specified in this HttpRouteAction.
11835 { # In contrast to a single BackendService in
11836 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
11837 # multiple backend services. The volume of traffic for each
11838 # backend service is proportional to the weight specified
11839 # in each WeightedBackendService
11840 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
11841 # resource. Before
11842 # forwarding the request to backendService, the load balancer
11843 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
11844 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
11845 # effect for the selected backendService.
11846 #
11847 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
11848 #
11849 # headerAction is not supported for load balancers that have
11850 # their loadBalancingScheme set to EXTERNAL.
11851 #
11852 # Not supported when the URL map is bound to a target gRPC proxy that
11853 # has validateForProxyless field set to true.
11854 # the request is passed along to the selected backendService.
11855 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
11856 { # Specification determining how headers are added to requests or responses.
11857 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
11858 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
11859 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
11860 # that already
11861 # exist for the header. If true, headerValue is set for the
11862 # header, discarding any values that were set for that header.
11863 #
11864 # The default value is true,
11865 # unless a variable is present in headerValue,
11866 # in which case the default value is false.
11867 # .
11868 },
11869 ],
11870 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
11871 # request before forwarding the request to the backendService.
11872 &quot;A String&quot;,
11873 ],
11874 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
11875 # client.
11876 { # Specification determining how headers are added to requests or responses.
11877 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
11878 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
11879 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
11880 # that already
11881 # exist for the header. If true, headerValue is set for the
11882 # header, discarding any values that were set for that header.
11883 #
11884 # The default value is true,
11885 # unless a variable is present in headerValue,
11886 # in which case the default value is false.
11887 # .
11888 },
11889 ],
11890 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
11891 # response before sending the response back to the client.
11892 &quot;A String&quot;,
11893 ],
11894 },
11895 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
11896 # computed asweight / (sum of all weightedBackendService weights in routeAction).
11897 #
11898 # The selection of a backend service is determined only for new traffic.
11899 # Once a user&#x27;s request has been directed to a backend service,
11900 # subsequent requests are sent to the same backend service as
11901 # determined by the backend service&#x27;s session affinity policy.
11902 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
11903 # splitting. If you do, the weighted traffic splitting configuration takes
11904 # precedence.
11905 #
11906 # The value must be from 0 to 1000.
11907 },
11908 ],
11909 },
11910 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
11911 # is directed if this rule is matched. If routeAction is
11912 # also specified, advanced routing actions, such as URL rewrites,
11913 # take effect before sending the request to the backend.
11914 #
11915 #
11916 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
11917 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
11918 # specified by urlRedirect.
11919 #
11920 #
11921 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
11922 #
11923 #
11924 # Not supported when the URL map is bound to a target gRPC proxy.
11925 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
11926 # was supplied in the request.
11927 #
11928 # The value must be from 1 to 255
11929 # characters.
11930 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
11931 # set to HTTPS.
11932 # If set to false, the URL scheme of the redirected request
11933 # remains the same as that of the request.
11934 #
11935 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
11936 #
11937 # The default is set to false.
11938 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
11939 # that was supplied in the request.
11940 #
11941 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
11942 # supplied, the path of the original request is used for the redirect.
11943 #
11944 # The value must be from 1 to 1024 characters.
11945 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
11946 # the HttpRouteRuleMatch, retaining the remaining portion
11947 # of the URL before redirecting the request.
11948 #
11949 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
11950 # supplied, the path of the original request is used for the redirect.
11951 #
11952 # The value must be from 1 to 1024 characters.
11953 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
11954 #
11955 # Supported values are:
11956 #
11957 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
11958 # to 301.
11959 # - FOUND, which corresponds to 302.
11960 # - SEE_OTHER which corresponds to 303.
11961 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
11962 # method is retained.
11963 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
11964 # method is retained.
11965 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
11966 # URL is
11967 # removed before redirecting the request. If set to false, the
11968 # query portion of the original URL is retained.
11969 #
11970 # The default is set to false.
11971 },
11972 },
11973 ],
11974 },
11975 ],
11976 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the regional URL map resides.
11977 # This field is not applicable to global URL maps.
11978 # You must specify this field as part of the HTTP request URL. It is
11979 # not settable as a field in the request body.
11980 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
11981 &quot;status&quot;: { # [Output Only] The status of the URL map. # Output only. [Output Only] The status of the URL map.
11982 &quot;quotaUsage&quot;: { # Message representing the quota usage for a UrlMap. # Output only. Summary of quota usage for given UrlMap.
11983 &quot;forwardingRules&quot;: 42, # Output only. The number of forwarding rules that uses this UrlMap.
11984 &quot;units&quot;: &quot;A String&quot;, # Output only. The number of quota units calculated for this UrlMap.
11985 },
11986 },
11987 &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
11988 # maximum of 100 tests per UrlMap.
11989 #
11990 # Not supported when the URL map is bound to a target gRPC proxy that
11991 # has validateForProxyless field set to true.
11992 { # Message for the expected URL mappings.
11993 &quot;description&quot;: &quot;A String&quot;, # Description of this test case.
11994 &quot;expectedOutputUrl&quot;: &quot;A String&quot;, # The expected output URL evaluated by the load balancer
11995 # containing the scheme, host, path and query parameters.
11996 #
11997 # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
11998 # the load balancer to backends. For rules with urlRewrite,
11999 # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
12000 #
12001 # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer&#x27;s
12002 # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
12003 # If urlRedirect specifies strip_query, the test
12004 # passes only if expectedOutputUrl does not contain any query
12005 # parameters.
12006 #
12007 # expectedOutputUrl is optional whenservice is specified.
12008 &quot;expectedRedirectResponseCode&quot;: 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
12009 # load balancer&#x27;s redirect response.
12010 #
12011 # expectedRedirectResponseCode cannot be set whenservice is set.
12012 &quot;headers&quot;: [ # HTTP headers for this request. If headers contains
12013 # a host header, then host must also match the header value.
12014 { # HTTP headers used in UrlMapTests.
12015 &quot;name&quot;: &quot;A String&quot;, # Header name.
12016 &quot;value&quot;: &quot;A String&quot;, # Header value.
12017 },
12018 ],
12019 &quot;host&quot;: &quot;A String&quot;, # Host portion of the URL. If headers contains a host header,
12020 # then host must also match the header value.
12021 &quot;path&quot;: &quot;A String&quot;, # Path portion of the URL.
12022 &quot;service&quot;: &quot;A String&quot;, # Expected BackendService or BackendBucket resource
12023 # the given URL should be mapped to.
12024 #
12025 # The service field cannot
12026 # be set if expectedRedirectResponseCode is set.
12027 },
12028 ],
12029 },
12030 ],
12031 &quot;kind&quot;: &quot;compute#urlMapList&quot;, # Output only. Type of resource.
12032 &quot;nextPageToken&quot;: &quot;A String&quot;, # [Output Only] This token allows you to get the next page of results for
12033 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
12034 # the query parameter pageToken in the next list request.
12035 # Subsequent list requests will have their own nextPageToken to
12036 # continue paging through the results.
12037 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource.
12038 &quot;warning&quot;: { # [Output Only] Informational warning message.
12039 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
12040 # Engine returns NO_RESULTS_ON_PAGE if there
12041 # are no results in the response.
12042 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
12043 # value format. For example:
12044 #
12045 # &quot;data&quot;: [
12046 # {
12047 # &quot;key&quot;: &quot;scope&quot;,
12048 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
12049 # }
12050 {
12051 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
12052 # returned. For example, for warnings where there are no results in a list
12053 # request for a particular zone, this key might be scope and
12054 # the key value might be the zone name. Other examples might be a key
12055 # indicating a deprecated resource and a suggested replacement, or a
12056 # warning about invalid network settings (for example, if an instance
12057 # attempts to perform IP forwarding but is not enabled for IP forwarding).
12058 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
12059 },
12060 ],
12061 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
12062 },
12063 }</pre>
12064 </div>
12065
12066 <div class="method">
12067 <code class="details" id="list_next">list_next()</code>
12068 <pre>Retrieves the next page of results.
12069
12070 Args:
12071 previous_request: The request for the previous page. (required)
12072 previous_response: The response from the request for the previous page. (required)
12073
12074 Returns:
12075 A request object that you can call &#x27;execute()&#x27; on to request the next
12076 page. Returns None if there are no more items in the collection.
12077 </pre>
12078 </div>
12079
12080 <div class="method">
12081 <code class="details" id="patch">patch(project, region, urlMap, body=None, requestId=None, x__xgafv=None)</code>
12082 <pre>Patches the specified UrlMap resource with the data included in the
12083 request. This method supportsPATCH
12084 semantics and usesJSON merge
12085 patch format and processing rules.
12086
12087 Args:
12088 project: string, Project ID for this request. (required)
12089 region: string, Name of the region scoping this request. (required)
12090 urlMap: string, Name of the UrlMap resource to patch. (required)
12091 body: object, The request body.
12092 The object takes the form of:
12093
12094 { # Represents a URL Map resource.
12095 #
12096 # Compute Engine has two URL Map resources:
12097 #
12098 # * [Global](/compute/docs/reference/rest/beta/urlMaps)
12099 # * [Regional](/compute/docs/reference/rest/beta/regionUrlMaps)
12100 #
12101 # A URL map resource is a component of certain types of cloud load balancers
12102 # and Traffic Director:
12103 #
12104 # * urlMaps are used by global external Application Load
12105 # Balancers, classic Application Load Balancers, and cross-region internal
12106 # Application Load Balancers.
12107 # * regionUrlMaps are used by internal Application Load Balancers,
12108 # regional external Application Load Balancers and regional internal
12109 # Application Load Balancers.
12110 #
12111 # For a list of supported URL map features by the load balancer type, see the
12112 # Load balancing features: Routing and traffic management table.
12113 #
12114 # For a list of supported URL map features for Traffic Director, see the
12115 # Traffic Director features: Routing and traffic management table.
12116 #
12117 # This resource defines mappings from hostnames and URL paths to either a
12118 # backend service or a backend bucket.
12119 #
12120 # To use the global urlMaps resource, the backend service must
12121 # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
12122 # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
12123 # information, read URL
12124 # Map Concepts.
12125 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
12126 # text format.
12127 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
12128 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
12129 #
12130 # This policy takes
12131 # effect at the load balancer level and applies only when no policy has been
12132 # defined for the error code at lower levels like PathMatcher, RouteRule and
12133 # PathRule within this UrlMap.
12134 #
12135 # For example, consider a UrlMap with the
12136 # following configuration:
12137 #
12138 #
12139 # - defaultCustomErrorResponsePolicy containing policies for
12140 # responding to 5xx and 4xx errors
12141 # - A PathMatcher configured for *.example.com has
12142 # defaultCustomErrorResponsePolicy for 4xx.
12143 #
12144 # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
12145 # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
12146 # a request that does not match any host in *.example.com such
12147 # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
12148 # takes effect.
12149 #
12150 # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
12151 # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
12152 # a retry, if load balancer is successful in reaching the
12153 # service, the defaultCustomErrorResponsePolicy is ignored and
12154 # the response from the service is returned to the client.
12155 #
12156 # defaultCustomErrorResponsePolicy is supported only for
12157 # global external Application Load Balancers.
12158 # backend service or backend bucket responds with an error.
12159 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
12160 #
12161 # In a given policy, if you specify rules for both a range of error codes
12162 # as well as rules for specific error codes then rules with specific error
12163 # codes have a higher priority. For example, assume that you configure a rule
12164 # for 401 (Un-authorized) code, and another for all 4 series
12165 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
12166 # However if the backend service returns a 403, the rule for4xx takes effect.
12167 { # Specifies the mapping between the response code that will be returned along
12168 # with the custom error content and the response code returned by the backend
12169 # service.
12170 &quot;matchResponseCodes&quot;: [ # Valid values include:
12171 #
12172 #
12173 # - A number between 400 and 599: For example
12174 # 401 or 503, in which case the load balancer
12175 # applies the policy if the error code exactly matches this value.
12176 # - 5xx: Load Balancer will apply the policy if the
12177 # backend service responds with any response code in the range of
12178 # 500 to 599.
12179 # - 4xx: Load
12180 # Balancer will apply the policy if the backend service responds with any
12181 # response code in the range of 400 to
12182 # 499.
12183 #
12184 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
12185 &quot;A String&quot;,
12186 ],
12187 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
12188 # error content. If overrideResponseCode is not supplied, the
12189 # same response code returned by the original backend bucket or backend
12190 # service is returned to the client.
12191 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
12192 #
12193 # path must start
12194 # with a leading slash. path cannot have trailing slashes.
12195 #
12196 # If the file is not available in backendBucket or the
12197 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
12198 #
12199 # The value must
12200 # be from 1 to 1024 characters
12201 },
12202 ],
12203 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
12204 # contains the custom error content. Examples are:
12205 #
12206 #
12207 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
12208 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
12209 # - global/backendBuckets/myBackendBucket
12210 #
12211 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
12212 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
12213 #
12214 # If load balancer cannot reach
12215 # the backendBucket, a simple Not Found Error will
12216 # be returned, with the original response code (oroverrideResponseCode if configured).
12217 #
12218 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
12219 },
12220 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
12221 # hostRules match. The load balancer performs advanced routing
12222 # actions, such as URL rewrites and header transformations, before forwarding
12223 # the request to the selected backend.
12224 #
12225 #
12226 # Only one of defaultUrlRedirect, defaultService
12227 # or defaultRouteAction.weightedBackendService can be set.
12228 #
12229 #
12230 # URL maps for classic Application Load Balancers only support
12231 # the urlRewrite action within defaultRouteAction.
12232 #
12233 #
12234 # defaultRouteAction has no effect when the URL map is bound
12235 # to a target gRPC proxy that has the validateForProxyless field
12236 # set to true.
12237 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
12238 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
12239 # property must be specified. This policy cannot be specified if any target
12240 # backend has Identity-Aware Proxy enabled.
12241 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
12242 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
12243 # header names can be specified. The cache is bypassed for all `cacheMode`
12244 # values.
12245 &quot;A String&quot;,
12246 ],
12247 &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
12248 # on the backend type: for Backend Services, the complete request URI is
12249 # used; for Backend Buckets, the request URI is used without the protocol or
12250 # host, and only query parameters known to Cloud Storage are included.
12251 # Policy defined on Route Action.
12252 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
12253 # parameters will be included. Either specify `excludedQueryParameters`
12254 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
12255 # encoded and not treated as delimiters.
12256 #
12257 # Note: This field applies to routes that use backend services. Attempting
12258 # to set it on a route that points exclusively to Backend Buckets will
12259 # result in a configuration error. For routes that point to a Backend
12260 # Bucket, use `includedQueryParameters` to define which parameters should
12261 # be part of the cache key.
12262 &quot;A String&quot;,
12263 ],
12264 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
12265 #
12266 # Note: This setting is only applicable to routes that use a Backend
12267 # Service. It does not affect requests served by a Backend Bucket, as the
12268 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
12269 # it on a route that points exclusively to Backend Buckets will result in a
12270 # configuration error.
12271 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
12272 #
12273 # Note: This setting is only applicable to routes that use a Backend
12274 # Service. It does not affect requests served by a Backend Bucket, as the
12275 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
12276 # set on a route that points exclusively to Backend Buckets will result in
12277 # a configuration error.
12278 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
12279 # `includedQueryParameters` and `excludedQueryParameters`. If neither
12280 # is set, the entire query string will be included. If false, the query
12281 # string will be excluded from the cache key entirely.
12282 #
12283 # Note: This field applies to routes that use backend services. Attempting
12284 # to set it on a route that points exclusively to Backend Buckets will
12285 # result in a configuration error. For routes that point to a Backend
12286 # Bucket, use `includedQueryParameters` to define which parameters should
12287 # be part of the cache key.
12288 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
12289 # The name=value pair will be used in the cache key Cloud CDN generates.
12290 #
12291 # Note: This setting is only applicable to routes that use a Backend
12292 # Service. It does not affect requests served by a Backend Bucket.
12293 # Attempting to set it on a route that points exclusively to Backend
12294 # Buckets will result in a configuration error. Up to 5 cookie names can be
12295 # specified.
12296 &quot;A String&quot;,
12297 ],
12298 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
12299 &quot;A String&quot;,
12300 ],
12301 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
12302 # parameters will be excluded. Either specify `includedQueryParameters`
12303 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
12304 # encoded and not treated as delimiters.
12305 &quot;A String&quot;,
12306 ],
12307 },
12308 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
12309 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
12310 &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
12311 # content. This is used to clamp the max-age (or Expires) value sent to the
12312 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
12313 # is used for the response max-age directive, along with a &quot;public&quot;
12314 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
12315 # clamps the max-age from the origin (if specified), or else sets the
12316 # response max-age directive to the lesser of the `clientTtl` and
12317 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
12318 # present. The maximum allowed value is 31,622,400s (1 year). If not
12319 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
12320 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
12321 # `USE_ORIGIN_HEADERS`.
12322 # as a count of seconds and fractions of seconds at nanosecond
12323 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12324 # or &quot;month&quot;. Range is approximately 10,000 years.
12325 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12326 # Durations less than one second are represented with a 0
12327 # `seconds` field and a positive `nanos` field. Must be from 0
12328 # to 999,999,999 inclusive.
12329 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12330 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12331 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12332 },
12333 &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
12334 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
12335 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
12336 # greater than that of `maxTtl`. When the `cacheMode` is set to
12337 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
12338 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
12339 # accessed objects may be evicted from the cache before the defined TTL. If
12340 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
12341 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
12342 # `USE_ORIGIN_HEADERS`.
12343 # as a count of seconds and fractions of seconds at nanosecond
12344 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12345 # or &quot;month&quot;. Range is approximately 10,000 years.
12346 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12347 # Durations less than one second are represented with a 0
12348 # `seconds` field and a positive `nanos` field. Must be from 0
12349 # to 999,999,999 inclusive.
12350 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12351 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12352 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12353 },
12354 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
12355 # attempt to set a max-age or s-maxage higher than this, or an Expires header
12356 # more than `maxTtl` seconds in the future will be capped at the value of
12357 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
12358 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
12359 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
12360 # Infrequently accessed objects may be evicted from the cache before the
12361 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
12362 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
12363 # mode.
12364 # as a count of seconds and fractions of seconds at nanosecond
12365 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12366 # or &quot;month&quot;. Range is approximately 10,000 years.
12367 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12368 # Durations less than one second are represented with a 0
12369 # `seconds` field and a positive `nanos` field. Must be from 0
12370 # to 999,999,999 inclusive.
12371 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12372 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12373 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12374 },
12375 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
12376 # to apply fine-grained caching for common errors or redirects.
12377 # This can reduce the load on your origin and improve end-user
12378 # experience by reducing response latency.
12379 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
12380 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
12381 # the specified response code that lack any Cache-Control, Expires, or
12382 # Pragma: no-cache directives. When the `cacheMode` is set to
12383 # `FORCE_CACHE_ALL`, negative caching applies to all responses
12384 # with the specified response code, and overrides any caching headers. By
12385 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
12386 #
12387 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
12388 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
12389 # * 405 (Method Not Found), 501 (Not Implemented): 60s
12390 #
12391 # These defaults can be overridden in `negativeCachingPolicy`.
12392 # If not specified, Cloud CDN applies negative caching by default.
12393 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
12394 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
12395 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
12396 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
12397 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
12398 # all response codes that you wish to cache. Cloud CDN will not apply any
12399 # default negative caching when a policy exists.
12400 { # Specify CDN TTLs for response error codes.
12401 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
12402 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
12403 # specified as values, and you cannot specify a status code more than
12404 # once.
12405 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
12406 # corresponding status code.
12407 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
12408 # objects may be evicted from the cache before the defined TTL.
12409 # as a count of seconds and fractions of seconds at nanosecond
12410 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12411 # or &quot;month&quot;. Range is approximately 10,000 years.
12412 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12413 # Durations less than one second are represented with a 0
12414 # `seconds` field and a positive `nanos` field. Must be from 0
12415 # to 999,999,999 inclusive.
12416 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12417 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12418 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12419 },
12420 },
12421 ],
12422 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
12423 # requests into a small number of requests to the origin. If not specified,
12424 # Cloud CDN applies request coalescing by default.
12425 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
12426 # content with the origin, or when an error is encountered when refreshing
12427 # the cache.
12428 # This setting defines the default &quot;max-stale&quot; duration for any cached
12429 # responses that do not specify a max-stale directive. Stale responses that
12430 # exceed the TTL configured here will not be served. The default limit
12431 # (max-stale) is 86400s (1 day), which will allow stale content to be
12432 # served up to this limit beyond the max-age (or s-maxage) of a cached
12433 # response.
12434 # The maximum allowed value is 604800 (1 week).
12435 # Set this to zero (0) to disable serve-while-stale.
12436 # as a count of seconds and fractions of seconds at nanosecond
12437 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12438 # or &quot;month&quot;. Range is approximately 10,000 years.
12439 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12440 # Durations less than one second are represented with a 0
12441 # `seconds` field and a positive `nanos` field. Must be from 0
12442 # to 999,999,999 inclusive.
12443 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12444 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12445 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12446 },
12447 },
12448 &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
12449 # information about the W3C recommendation for cross-origin resource sharing
12450 # (CORS), see Fetch API Living
12451 # Standard.
12452 #
12453 # Not supported when the URL map is bound to a target gRPC proxy.
12454 # information about the W3C recommendation for cross-origin resource sharing
12455 # (CORS), see Fetch API Living
12456 # Standard.
12457 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
12458 # indicates that
12459 # the actual request can include user credentials. This field translates to
12460 # the Access-Control-Allow-Credentials header.
12461 #
12462 # Default is false.
12463 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
12464 # header.
12465 &quot;A String&quot;,
12466 ],
12467 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
12468 # header.
12469 &quot;A String&quot;,
12470 ],
12471 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
12472 # more information, see regular expression syntax.
12473 #
12474 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
12475 #
12476 # Regular expressions can only be used when the loadBalancingScheme is
12477 # set to INTERNAL_SELF_MANAGED.
12478 &quot;A String&quot;,
12479 ],
12480 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
12481 #
12482 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
12483 &quot;A String&quot;,
12484 ],
12485 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
12486 # The default value is false, which indicates that the CORS
12487 # policy is in effect.
12488 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
12489 # header.
12490 &quot;A String&quot;,
12491 ],
12492 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
12493 # seconds. This field translates to the Access-Control-Max-Age
12494 # header.
12495 },
12496 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
12497 # the resiliency of clients to backend service failure. As part of fault
12498 # injection, when clients send requests to a backend service, delays can be
12499 # introduced by a load balancer on a percentage of requests before sending
12500 # those requests to the backend service. Similarly requests from clients can
12501 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
12502 # that are configured with a fault_injection_policy if:
12503 # 1. The traffic is generated by fault injection AND
12504 # 2. The fault injection is not a delay fault injection.
12505 # Fault injection is not supported with the classic Application Load Balancer
12506 # . To see which load balancers support fault injection,
12507 # see Load
12508 # balancing: Routing and traffic management features.
12509 # the resiliency of clients to backend service failure. As part of fault
12510 # injection, when clients send requests to a backend service, delays can be
12511 # introduced by the load balancer on a percentage of requests before sending
12512 # those request to the backend service. Similarly requests from clients can be
12513 # aborted by the load balancer for a percentage of requests.
12514 &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
12515 # injection.
12516 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
12517 #
12518 # The value must be from 200 to 599 inclusive.
12519 #
12520 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
12521 # according to this
12522 # mapping table. HTTP status 200 is mapped to gRPC status
12523 # UNKNOWN. Injecting an OK status is currently not supported by
12524 # Traffic Director.
12525 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
12526 # that is aborted as part of fault injection.
12527 #
12528 # The value must be from 0.0 to 100.0 inclusive.
12529 },
12530 &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
12531 # injection, before being sent to a backend service.
12532 # request to the backend service as part of fault injection.
12533 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
12534 # as a count of seconds and fractions of seconds at nanosecond
12535 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12536 # or &quot;month&quot;. Range is approximately 10,000 years.
12537 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12538 # Durations less than one second are represented with a 0
12539 # `seconds` field and a positive `nanos` field. Must be from 0
12540 # to 999,999,999 inclusive.
12541 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12542 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12543 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12544 },
12545 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
12546 # which a delay is introduced as part of fault injection.
12547 #
12548 # The value must be from 0.0 to 100.0 inclusive.
12549 },
12550 },
12551 &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
12552 # Global EXTERNAL_MANAGED load balancer schemes.
12553 # Either Cloud CDN must be enabled on the backend service or backend bucket
12554 # serving the route, or cache policy must be configured on the same route
12555 # dynamically processes and delivers images from the network edge.
12556 # Image Optimization is only available for Global External Application Load
12557 # Balancers.
12558 # Either Cloud CDN must be enabled on the backend service or backend bucket
12559 # serving the route, or cache policy must be configured on the same route.
12560 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
12561 },
12562 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
12563 # Unlike the timeout field where the timeout duration starts
12564 # from the time the request has been fully processed (known as*end-of-stream*),
12565 # the duration in this field is computed from the beginning of the stream
12566 # until the response has been processed, including all retries. A
12567 # stream that does not complete in this duration is closed.
12568 #
12569 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
12570 # with the route.
12571 #
12572 # This field is only allowed if the Url map is used with backend services
12573 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
12574 # as a count of seconds and fractions of seconds at nanosecond
12575 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12576 # or &quot;month&quot;. Range is approximately 10,000 years.
12577 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12578 # Durations less than one second are represented with a 0
12579 # `seconds` field and a positive `nanos` field. Must be from 0
12580 # to 999,999,999 inclusive.
12581 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12582 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12583 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12584 },
12585 &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
12586 # are shadowed to a separate mirrored backend service. The load balancer does
12587 # not wait for responses from the shadow service. Before sending traffic
12588 # to the shadow service, the host / authority header is suffixed with-shadow.
12589 #
12590 # Not supported when the URL map is bound to a target gRPC proxy that
12591 # has the validateForProxyless field set to true.
12592 # are shadowed to a separate mirrored backend service. The load balancer
12593 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
12594 # to the shadow service, the host or authority header is suffixed with-shadow.
12595 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
12596 # mirrored to.
12597 #
12598 # The backend service configured for a mirroring
12599 # policy must reference backends that are of the same type as the original
12600 # backend service matched in the URL map.
12601 #
12602 # Serverless NEG backends are not currently supported as a mirrored
12603 # backend service.
12604 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
12605 },
12606 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
12607 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
12608 # If not specified, defaults to 1.
12609 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
12610 #
12611 # If not specified, will use the timeout set in theHttpRouteAction field.
12612 # If timeout in the HttpRouteAction field is not set, this field
12613 # uses the largest timeout
12614 # among all backend services associated with the route.
12615 #
12616 # Not supported when the URL map is bound to a target gRPC proxy that
12617 # has the validateForProxyless field set to true.
12618 # as a count of seconds and fractions of seconds at nanosecond
12619 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12620 # or &quot;month&quot;. Range is approximately 10,000 years.
12621 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12622 # Durations less than one second are represented with a 0
12623 # `seconds` field and a positive `nanos` field. Must be from 0
12624 # to 999,999,999 inclusive.
12625 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12626 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12627 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12628 },
12629 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
12630 # values are:
12631 #
12632 # - 5xx: retry is attempted if the instance or endpoint
12633 # responds with any 5xx response code, or if the instance or
12634 # endpoint does not respond at all. For example, disconnects, reset, read
12635 # timeout, connection failure, and refused streams.
12636 # - gateway-error: Similar to 5xx, but only
12637 # applies to response codes 502, 503 or504.
12638 # - connect-failure: a retry is attempted on failures
12639 # connecting to the instance or endpoint. For example, connection
12640 # timeouts.
12641 # - retriable-4xx: a retry is attempted if the instance
12642 # or endpoint responds with a 4xx response code.
12643 # The only error that you can retry is error code 409.
12644 # - refused-stream: a retry is attempted if the instance
12645 # or endpoint resets the stream with a REFUSED_STREAM error
12646 # code. This reset type indicates that it is safe to retry.
12647 # - cancelled: a retry is attempted if the gRPC status
12648 # code in the response header is set to cancelled.
12649 # - deadline-exceeded: a retry is attempted if the gRPC
12650 # status code in the response header is set todeadline-exceeded.
12651 # - internal: a retry is attempted if the gRPC
12652 # status code in the response header is set tointernal.
12653 # - resource-exhausted: a retry is attempted if the gRPC
12654 # status code in the response header is set toresource-exhausted.
12655 # - unavailable: a retry is attempted if the gRPC
12656 # status code in the response header is set tounavailable.
12657 #
12658 # Only the following codes are supported when the URL map is bound to
12659 # target gRPC proxy that has validateForProxyless field set to true.
12660 #
12661 # - cancelled
12662 # - deadline-exceeded
12663 # - internal
12664 # - resource-exhausted
12665 # - unavailable
12666 &quot;A String&quot;,
12667 ],
12668 },
12669 &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
12670 # time the request has been fully processed (known as *end-of-stream*)
12671 # up until the response has been processed. Timeout includes
12672 # all retries.
12673 #
12674 # If not specified, this field uses the largest timeout among all backend
12675 # services associated with the route.
12676 #
12677 # Not supported when the URL map is bound to a target gRPC proxy that
12678 # has validateForProxyless field set to true.
12679 # as a count of seconds and fractions of seconds at nanosecond
12680 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12681 # or &quot;month&quot;. Range is approximately 10,000 years.
12682 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12683 # Durations less than one second are represented with a 0
12684 # `seconds` field and a positive `nanos` field. Must be from 0
12685 # to 999,999,999 inclusive.
12686 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12687 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12688 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12689 },
12690 &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
12691 # to the matched service.
12692 #
12693 # urlRewrite is the only action supported in UrlMaps
12694 # for classic Application Load Balancers.
12695 #
12696 # Not supported when the URL map is bound to a target gRPC proxy that
12697 # has the validateForProxyless field set to true.
12698 # backend service.
12699 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
12700 # host header is replaced with contents of hostRewrite.
12701 #
12702 # The value must be from 1 to 255 characters.
12703 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
12704 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
12705 #
12706 # The value must be from 1 to 1024 characters.
12707 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
12708 # header) using the HTTP template syntax.
12709 #
12710 # A corresponding
12711 # path_template_match must be specified. Any template variables must exist in
12712 # the path_template_match field.
12713 #
12714 #
12715 # - -At least one variable must be specified in the path_template_match
12716 # field
12717 # - You can omit variables from the rewritten URL
12718 # - The * and ** operators cannot be matched
12719 # unless they have a corresponding variable name - e.g.
12720 # {format=*} or {var=**}.
12721 #
12722 # For example, a path_template_match of /static/{format=**}
12723 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
12724 # rewrite, so that /{country}/{format}/{suffix=**} can be
12725 # rewritten as /content/{format}/{country}/{suffix}.
12726 #
12727 # At least
12728 # one non-empty routeRules[].matchRules[].path_template_match is
12729 # required.
12730 #
12731 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
12732 },
12733 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
12734 # occurs. The weights determine the fraction of traffic that flows to
12735 # their corresponding backend service. If all traffic needs to
12736 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
12737 #
12738 # After a backend service is identified and before forwarding
12739 # the request to
12740 # the backend service, advanced routing actions such as URL rewrites and
12741 # header transformations are applied depending on additional settings
12742 # specified in this HttpRouteAction.
12743 { # In contrast to a single BackendService in
12744 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
12745 # multiple backend services. The volume of traffic for each
12746 # backend service is proportional to the weight specified
12747 # in each WeightedBackendService
12748 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
12749 # resource. Before
12750 # forwarding the request to backendService, the load balancer
12751 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
12752 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
12753 # effect for the selected backendService.
12754 #
12755 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
12756 #
12757 # headerAction is not supported for load balancers that have
12758 # their loadBalancingScheme set to EXTERNAL.
12759 #
12760 # Not supported when the URL map is bound to a target gRPC proxy that
12761 # has validateForProxyless field set to true.
12762 # the request is passed along to the selected backendService.
12763 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
12764 { # Specification determining how headers are added to requests or responses.
12765 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
12766 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
12767 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
12768 # that already
12769 # exist for the header. If true, headerValue is set for the
12770 # header, discarding any values that were set for that header.
12771 #
12772 # The default value is true,
12773 # unless a variable is present in headerValue,
12774 # in which case the default value is false.
12775 # .
12776 },
12777 ],
12778 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
12779 # request before forwarding the request to the backendService.
12780 &quot;A String&quot;,
12781 ],
12782 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
12783 # client.
12784 { # Specification determining how headers are added to requests or responses.
12785 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
12786 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
12787 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
12788 # that already
12789 # exist for the header. If true, headerValue is set for the
12790 # header, discarding any values that were set for that header.
12791 #
12792 # The default value is true,
12793 # unless a variable is present in headerValue,
12794 # in which case the default value is false.
12795 # .
12796 },
12797 ],
12798 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
12799 # response before sending the response back to the client.
12800 &quot;A String&quot;,
12801 ],
12802 },
12803 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
12804 # computed asweight / (sum of all weightedBackendService weights in routeAction).
12805 #
12806 # The selection of a backend service is determined only for new traffic.
12807 # Once a user&#x27;s request has been directed to a backend service,
12808 # subsequent requests are sent to the same backend service as
12809 # determined by the backend service&#x27;s session affinity policy.
12810 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
12811 # splitting. If you do, the weighted traffic splitting configuration takes
12812 # precedence.
12813 #
12814 # The value must be from 0 to 1000.
12815 },
12816 ],
12817 },
12818 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL of the defaultService resource to
12819 # which traffic is directed if none of the hostRules match.
12820 # If defaultRouteAction is also specified, advanced
12821 # routing actions, such as URL rewrites, take effect before sending the
12822 # request to the backend.
12823 #
12824 #
12825 # Only one of defaultUrlRedirect, defaultService
12826 # or defaultRouteAction.weightedBackendService can be set.
12827 #
12828 #
12829 # defaultService has no effect when the URL map is bound
12830 # to a target gRPC proxy that has the validateForProxyless field
12831 # set to true.
12832 &quot;defaultUrlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
12833 # is redirected to a URL specified by defaultUrlRedirect.
12834 #
12835 #
12836 # Only one of defaultUrlRedirect, defaultService
12837 # or defaultRouteAction.weightedBackendService can be set.
12838 #
12839 #
12840 # Not supported when the URL map is bound to a target gRPC proxy.
12841 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
12842 # was supplied in the request.
12843 #
12844 # The value must be from 1 to 255
12845 # characters.
12846 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
12847 # set to HTTPS.
12848 # If set to false, the URL scheme of the redirected request
12849 # remains the same as that of the request.
12850 #
12851 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
12852 #
12853 # The default is set to false.
12854 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
12855 # that was supplied in the request.
12856 #
12857 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
12858 # supplied, the path of the original request is used for the redirect.
12859 #
12860 # The value must be from 1 to 1024 characters.
12861 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
12862 # the HttpRouteRuleMatch, retaining the remaining portion
12863 # of the URL before redirecting the request.
12864 #
12865 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
12866 # supplied, the path of the original request is used for the redirect.
12867 #
12868 # The value must be from 1 to 1024 characters.
12869 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
12870 #
12871 # Supported values are:
12872 #
12873 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
12874 # to 301.
12875 # - FOUND, which corresponds to 302.
12876 # - SEE_OTHER which corresponds to 303.
12877 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
12878 # method is retained.
12879 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
12880 # method is retained.
12881 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
12882 # URL is
12883 # removed before redirecting the request. If set to false, the
12884 # query portion of the original URL is retained.
12885 #
12886 # The default is set to false.
12887 },
12888 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
12889 # create the resource.
12890 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. A hash of the contents stored in this object.
12891 # This field is used in optimistic locking. This field is ignored when
12892 # inserting a UrlMap. An up-to-date fingerprint must be provided
12893 # in order to update the UrlMap, otherwise the request will
12894 # fail with error 412 conditionNotMet.
12895 #
12896 # To see the latest fingerprint, make a get() request to
12897 # retrieve a UrlMap.
12898 &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
12899 # for the selected backendService.
12900 #
12901 # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
12902 #
12903 # headerAction is not supported for load balancers
12904 # that have
12905 # their loadBalancingScheme set to EXTERNAL.
12906 #
12907 # Not supported when the URL map is bound to a target gRPC proxy that
12908 # has validateForProxyless field set to true.
12909 # the request is passed along to the selected backendService.
12910 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
12911 { # Specification determining how headers are added to requests or responses.
12912 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
12913 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
12914 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
12915 # that already
12916 # exist for the header. If true, headerValue is set for the
12917 # header, discarding any values that were set for that header.
12918 #
12919 # The default value is true,
12920 # unless a variable is present in headerValue,
12921 # in which case the default value is false.
12922 # .
12923 },
12924 ],
12925 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
12926 # request before forwarding the request to the backendService.
12927 &quot;A String&quot;,
12928 ],
12929 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
12930 # client.
12931 { # Specification determining how headers are added to requests or responses.
12932 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
12933 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
12934 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
12935 # that already
12936 # exist for the header. If true, headerValue is set for the
12937 # header, discarding any values that were set for that header.
12938 #
12939 # The default value is true,
12940 # unless a variable is present in headerValue,
12941 # in which case the default value is false.
12942 # .
12943 },
12944 ],
12945 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
12946 # response before sending the response back to the client.
12947 &quot;A String&quot;,
12948 ],
12949 },
12950 &quot;hostRules&quot;: [ # The list of host rules to use against the URL.
12951 { # UrlMaps
12952 # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
12953 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
12954 # create the resource.
12955 &quot;hosts&quot;: [ # The list of host patterns to match. They must be valid hostnames with
12956 # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
12957 # that case, * must be the first character, and if followed by
12958 # anything, the immediate following character must be either -
12959 # or ..
12960 #
12961 # * based matching is not supported when the URL map is bound
12962 # to a target gRPC proxy that has the validateForProxyless field
12963 # set to true.
12964 &quot;A String&quot;,
12965 ],
12966 &quot;pathMatcher&quot;: &quot;A String&quot;, # The name of the PathMatcher to use to match the path portion
12967 # of the URL if the hostRule matches the URL&#x27;s host portion.
12968 },
12969 ],
12970 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the resource. This identifier is
12971 # defined by the server.
12972 &quot;kind&quot;: &quot;compute#urlMap&quot;, # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
12973 # url maps.
12974 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
12975 # The name must be 1-63 characters long, and comply withRFC1035.
12976 # Specifically, the name must be 1-63 characters long and match the regular
12977 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
12978 # character must be a lowercase letter, and all following characters must
12979 # be a dash, lowercase letter, or digit, except the last character, which
12980 # cannot be a dash.
12981 &quot;pathMatchers&quot;: [ # The list of named PathMatchers to use against the URL.
12982 { # A matcher for the path portion of the URL. The BackendService
12983 # from the longest-matched rule will serve the URL. If no rule was matched, the
12984 # default service is used.
12985 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
12986 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
12987 #
12988 # This policy takes
12989 # effect at the PathMatcher level and applies only when no
12990 # 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
12991 # in defaultCustomErrorResponsePolicy, then a policy defined for
12992 # the error code in UrlMap.defaultCustomErrorResponsePolicy
12993 # takes effect.
12994 #
12995 # For example, consider a UrlMap with the following
12996 # configuration:
12997 #
12998 #
12999 # - UrlMap.defaultCustomErrorResponsePolicy is configured
13000 # with policies for 5xx and 4xx errors
13001 # - A RouteRule for /coming_soon/ is configured for the
13002 # error code 404.
13003 #
13004 # 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
13005 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
13006 # the policy in RouteRule.customErrorResponsePolicy takes
13007 # effect. If any of the requests in this example encounter a 500
13008 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
13009 #
13010 # When
13011 # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
13012 # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
13013 # a retry, if load balancer is successful in reaching the
13014 # service, the defaultCustomErrorResponsePolicy is ignored and
13015 # the response from the service is returned to the client.
13016 #
13017 # defaultCustomErrorResponsePolicy is supported only for
13018 # global external Application Load Balancers.
13019 # backend service or backend bucket responds with an error.
13020 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
13021 #
13022 # In a given policy, if you specify rules for both a range of error codes
13023 # as well as rules for specific error codes then rules with specific error
13024 # codes have a higher priority. For example, assume that you configure a rule
13025 # for 401 (Un-authorized) code, and another for all 4 series
13026 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
13027 # However if the backend service returns a 403, the rule for4xx takes effect.
13028 { # Specifies the mapping between the response code that will be returned along
13029 # with the custom error content and the response code returned by the backend
13030 # service.
13031 &quot;matchResponseCodes&quot;: [ # Valid values include:
13032 #
13033 #
13034 # - A number between 400 and 599: For example
13035 # 401 or 503, in which case the load balancer
13036 # applies the policy if the error code exactly matches this value.
13037 # - 5xx: Load Balancer will apply the policy if the
13038 # backend service responds with any response code in the range of
13039 # 500 to 599.
13040 # - 4xx: Load
13041 # Balancer will apply the policy if the backend service responds with any
13042 # response code in the range of 400 to
13043 # 499.
13044 #
13045 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
13046 &quot;A String&quot;,
13047 ],
13048 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
13049 # error content. If overrideResponseCode is not supplied, the
13050 # same response code returned by the original backend bucket or backend
13051 # service is returned to the client.
13052 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
13053 #
13054 # path must start
13055 # with a leading slash. path cannot have trailing slashes.
13056 #
13057 # If the file is not available in backendBucket or the
13058 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
13059 #
13060 # The value must
13061 # be from 1 to 1024 characters
13062 },
13063 ],
13064 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
13065 # contains the custom error content. Examples are:
13066 #
13067 #
13068 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
13069 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
13070 # - global/backendBuckets/myBackendBucket
13071 #
13072 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
13073 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
13074 #
13075 # If load balancer cannot reach
13076 # the backendBucket, a simple Not Found Error will
13077 # be returned, with the original response code (oroverrideResponseCode if configured).
13078 #
13079 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
13080 },
13081 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
13082 # pathRules or routeRules match. The load balancer
13083 # performs advanced routing actions, such as URL rewrites and
13084 # header transformations, before forwarding the request to the
13085 # selected backend.
13086 #
13087 #
13088 # Only one of defaultUrlRedirect, defaultService
13089 # or defaultRouteAction.weightedBackendService can be set.
13090 #
13091 #
13092 # URL maps for classic Application Load Balancers only support
13093 # the urlRewrite action within a path matcher&#x27;sdefaultRouteAction.
13094 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
13095 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
13096 # property must be specified. This policy cannot be specified if any target
13097 # backend has Identity-Aware Proxy enabled.
13098 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
13099 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
13100 # header names can be specified. The cache is bypassed for all `cacheMode`
13101 # values.
13102 &quot;A String&quot;,
13103 ],
13104 &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
13105 # on the backend type: for Backend Services, the complete request URI is
13106 # used; for Backend Buckets, the request URI is used without the protocol or
13107 # host, and only query parameters known to Cloud Storage are included.
13108 # Policy defined on Route Action.
13109 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
13110 # parameters will be included. Either specify `excludedQueryParameters`
13111 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
13112 # encoded and not treated as delimiters.
13113 #
13114 # Note: This field applies to routes that use backend services. Attempting
13115 # to set it on a route that points exclusively to Backend Buckets will
13116 # result in a configuration error. For routes that point to a Backend
13117 # Bucket, use `includedQueryParameters` to define which parameters should
13118 # be part of the cache key.
13119 &quot;A String&quot;,
13120 ],
13121 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
13122 #
13123 # Note: This setting is only applicable to routes that use a Backend
13124 # Service. It does not affect requests served by a Backend Bucket, as the
13125 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
13126 # it on a route that points exclusively to Backend Buckets will result in a
13127 # configuration error.
13128 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
13129 #
13130 # Note: This setting is only applicable to routes that use a Backend
13131 # Service. It does not affect requests served by a Backend Bucket, as the
13132 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
13133 # set on a route that points exclusively to Backend Buckets will result in
13134 # a configuration error.
13135 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
13136 # `includedQueryParameters` and `excludedQueryParameters`. If neither
13137 # is set, the entire query string will be included. If false, the query
13138 # string will be excluded from the cache key entirely.
13139 #
13140 # Note: This field applies to routes that use backend services. Attempting
13141 # to set it on a route that points exclusively to Backend Buckets will
13142 # result in a configuration error. For routes that point to a Backend
13143 # Bucket, use `includedQueryParameters` to define which parameters should
13144 # be part of the cache key.
13145 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
13146 # The name=value pair will be used in the cache key Cloud CDN generates.
13147 #
13148 # Note: This setting is only applicable to routes that use a Backend
13149 # Service. It does not affect requests served by a Backend Bucket.
13150 # Attempting to set it on a route that points exclusively to Backend
13151 # Buckets will result in a configuration error. Up to 5 cookie names can be
13152 # specified.
13153 &quot;A String&quot;,
13154 ],
13155 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
13156 &quot;A String&quot;,
13157 ],
13158 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
13159 # parameters will be excluded. Either specify `includedQueryParameters`
13160 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
13161 # encoded and not treated as delimiters.
13162 &quot;A String&quot;,
13163 ],
13164 },
13165 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
13166 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
13167 &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
13168 # content. This is used to clamp the max-age (or Expires) value sent to the
13169 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
13170 # is used for the response max-age directive, along with a &quot;public&quot;
13171 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
13172 # clamps the max-age from the origin (if specified), or else sets the
13173 # response max-age directive to the lesser of the `clientTtl` and
13174 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
13175 # present. The maximum allowed value is 31,622,400s (1 year). If not
13176 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
13177 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
13178 # `USE_ORIGIN_HEADERS`.
13179 # as a count of seconds and fractions of seconds at nanosecond
13180 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13181 # or &quot;month&quot;. Range is approximately 10,000 years.
13182 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13183 # Durations less than one second are represented with a 0
13184 # `seconds` field and a positive `nanos` field. Must be from 0
13185 # to 999,999,999 inclusive.
13186 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13187 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13188 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13189 },
13190 &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
13191 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
13192 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
13193 # greater than that of `maxTtl`. When the `cacheMode` is set to
13194 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
13195 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
13196 # accessed objects may be evicted from the cache before the defined TTL. If
13197 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
13198 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
13199 # `USE_ORIGIN_HEADERS`.
13200 # as a count of seconds and fractions of seconds at nanosecond
13201 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13202 # or &quot;month&quot;. Range is approximately 10,000 years.
13203 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13204 # Durations less than one second are represented with a 0
13205 # `seconds` field and a positive `nanos` field. Must be from 0
13206 # to 999,999,999 inclusive.
13207 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13208 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13209 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13210 },
13211 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
13212 # attempt to set a max-age or s-maxage higher than this, or an Expires header
13213 # more than `maxTtl` seconds in the future will be capped at the value of
13214 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
13215 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
13216 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
13217 # Infrequently accessed objects may be evicted from the cache before the
13218 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
13219 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
13220 # mode.
13221 # as a count of seconds and fractions of seconds at nanosecond
13222 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13223 # or &quot;month&quot;. Range is approximately 10,000 years.
13224 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13225 # Durations less than one second are represented with a 0
13226 # `seconds` field and a positive `nanos` field. Must be from 0
13227 # to 999,999,999 inclusive.
13228 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13229 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13230 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13231 },
13232 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
13233 # to apply fine-grained caching for common errors or redirects.
13234 # This can reduce the load on your origin and improve end-user
13235 # experience by reducing response latency.
13236 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
13237 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
13238 # the specified response code that lack any Cache-Control, Expires, or
13239 # Pragma: no-cache directives. When the `cacheMode` is set to
13240 # `FORCE_CACHE_ALL`, negative caching applies to all responses
13241 # with the specified response code, and overrides any caching headers. By
13242 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
13243 #
13244 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
13245 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
13246 # * 405 (Method Not Found), 501 (Not Implemented): 60s
13247 #
13248 # These defaults can be overridden in `negativeCachingPolicy`.
13249 # If not specified, Cloud CDN applies negative caching by default.
13250 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
13251 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
13252 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
13253 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
13254 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
13255 # all response codes that you wish to cache. Cloud CDN will not apply any
13256 # default negative caching when a policy exists.
13257 { # Specify CDN TTLs for response error codes.
13258 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
13259 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
13260 # specified as values, and you cannot specify a status code more than
13261 # once.
13262 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
13263 # corresponding status code.
13264 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
13265 # objects may be evicted from the cache before the defined TTL.
13266 # as a count of seconds and fractions of seconds at nanosecond
13267 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13268 # or &quot;month&quot;. Range is approximately 10,000 years.
13269 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13270 # Durations less than one second are represented with a 0
13271 # `seconds` field and a positive `nanos` field. Must be from 0
13272 # to 999,999,999 inclusive.
13273 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13274 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13275 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13276 },
13277 },
13278 ],
13279 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
13280 # requests into a small number of requests to the origin. If not specified,
13281 # Cloud CDN applies request coalescing by default.
13282 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
13283 # content with the origin, or when an error is encountered when refreshing
13284 # the cache.
13285 # This setting defines the default &quot;max-stale&quot; duration for any cached
13286 # responses that do not specify a max-stale directive. Stale responses that
13287 # exceed the TTL configured here will not be served. The default limit
13288 # (max-stale) is 86400s (1 day), which will allow stale content to be
13289 # served up to this limit beyond the max-age (or s-maxage) of a cached
13290 # response.
13291 # The maximum allowed value is 604800 (1 week).
13292 # Set this to zero (0) to disable serve-while-stale.
13293 # as a count of seconds and fractions of seconds at nanosecond
13294 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13295 # or &quot;month&quot;. Range is approximately 10,000 years.
13296 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13297 # Durations less than one second are represented with a 0
13298 # `seconds` field and a positive `nanos` field. Must be from 0
13299 # to 999,999,999 inclusive.
13300 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13301 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13302 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13303 },
13304 },
13305 &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
13306 # information about the W3C recommendation for cross-origin resource sharing
13307 # (CORS), see Fetch API Living
13308 # Standard.
13309 #
13310 # Not supported when the URL map is bound to a target gRPC proxy.
13311 # information about the W3C recommendation for cross-origin resource sharing
13312 # (CORS), see Fetch API Living
13313 # Standard.
13314 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
13315 # indicates that
13316 # the actual request can include user credentials. This field translates to
13317 # the Access-Control-Allow-Credentials header.
13318 #
13319 # Default is false.
13320 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
13321 # header.
13322 &quot;A String&quot;,
13323 ],
13324 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
13325 # header.
13326 &quot;A String&quot;,
13327 ],
13328 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
13329 # more information, see regular expression syntax.
13330 #
13331 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
13332 #
13333 # Regular expressions can only be used when the loadBalancingScheme is
13334 # set to INTERNAL_SELF_MANAGED.
13335 &quot;A String&quot;,
13336 ],
13337 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
13338 #
13339 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
13340 &quot;A String&quot;,
13341 ],
13342 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
13343 # The default value is false, which indicates that the CORS
13344 # policy is in effect.
13345 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
13346 # header.
13347 &quot;A String&quot;,
13348 ],
13349 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
13350 # seconds. This field translates to the Access-Control-Max-Age
13351 # header.
13352 },
13353 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
13354 # the resiliency of clients to backend service failure. As part of fault
13355 # injection, when clients send requests to a backend service, delays can be
13356 # introduced by a load balancer on a percentage of requests before sending
13357 # those requests to the backend service. Similarly requests from clients can
13358 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
13359 # that are configured with a fault_injection_policy if:
13360 # 1. The traffic is generated by fault injection AND
13361 # 2. The fault injection is not a delay fault injection.
13362 # Fault injection is not supported with the classic Application Load Balancer
13363 # . To see which load balancers support fault injection,
13364 # see Load
13365 # balancing: Routing and traffic management features.
13366 # the resiliency of clients to backend service failure. As part of fault
13367 # injection, when clients send requests to a backend service, delays can be
13368 # introduced by the load balancer on a percentage of requests before sending
13369 # those request to the backend service. Similarly requests from clients can be
13370 # aborted by the load balancer for a percentage of requests.
13371 &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
13372 # injection.
13373 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
13374 #
13375 # The value must be from 200 to 599 inclusive.
13376 #
13377 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
13378 # according to this
13379 # mapping table. HTTP status 200 is mapped to gRPC status
13380 # UNKNOWN. Injecting an OK status is currently not supported by
13381 # Traffic Director.
13382 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
13383 # that is aborted as part of fault injection.
13384 #
13385 # The value must be from 0.0 to 100.0 inclusive.
13386 },
13387 &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
13388 # injection, before being sent to a backend service.
13389 # request to the backend service as part of fault injection.
13390 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
13391 # as a count of seconds and fractions of seconds at nanosecond
13392 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13393 # or &quot;month&quot;. Range is approximately 10,000 years.
13394 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13395 # Durations less than one second are represented with a 0
13396 # `seconds` field and a positive `nanos` field. Must be from 0
13397 # to 999,999,999 inclusive.
13398 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13399 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13400 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13401 },
13402 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
13403 # which a delay is introduced as part of fault injection.
13404 #
13405 # The value must be from 0.0 to 100.0 inclusive.
13406 },
13407 },
13408 &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
13409 # Global EXTERNAL_MANAGED load balancer schemes.
13410 # Either Cloud CDN must be enabled on the backend service or backend bucket
13411 # serving the route, or cache policy must be configured on the same route
13412 # dynamically processes and delivers images from the network edge.
13413 # Image Optimization is only available for Global External Application Load
13414 # Balancers.
13415 # Either Cloud CDN must be enabled on the backend service or backend bucket
13416 # serving the route, or cache policy must be configured on the same route.
13417 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
13418 },
13419 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
13420 # Unlike the timeout field where the timeout duration starts
13421 # from the time the request has been fully processed (known as*end-of-stream*),
13422 # the duration in this field is computed from the beginning of the stream
13423 # until the response has been processed, including all retries. A
13424 # stream that does not complete in this duration is closed.
13425 #
13426 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
13427 # with the route.
13428 #
13429 # This field is only allowed if the Url map is used with backend services
13430 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
13431 # as a count of seconds and fractions of seconds at nanosecond
13432 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13433 # or &quot;month&quot;. Range is approximately 10,000 years.
13434 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13435 # Durations less than one second are represented with a 0
13436 # `seconds` field and a positive `nanos` field. Must be from 0
13437 # to 999,999,999 inclusive.
13438 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13439 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13440 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13441 },
13442 &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
13443 # are shadowed to a separate mirrored backend service. The load balancer does
13444 # not wait for responses from the shadow service. Before sending traffic
13445 # to the shadow service, the host / authority header is suffixed with-shadow.
13446 #
13447 # Not supported when the URL map is bound to a target gRPC proxy that
13448 # has the validateForProxyless field set to true.
13449 # are shadowed to a separate mirrored backend service. The load balancer
13450 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
13451 # to the shadow service, the host or authority header is suffixed with-shadow.
13452 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
13453 # mirrored to.
13454 #
13455 # The backend service configured for a mirroring
13456 # policy must reference backends that are of the same type as the original
13457 # backend service matched in the URL map.
13458 #
13459 # Serverless NEG backends are not currently supported as a mirrored
13460 # backend service.
13461 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
13462 },
13463 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
13464 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
13465 # If not specified, defaults to 1.
13466 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
13467 #
13468 # If not specified, will use the timeout set in theHttpRouteAction field.
13469 # If timeout in the HttpRouteAction field is not set, this field
13470 # uses the largest timeout
13471 # among all backend services associated with the route.
13472 #
13473 # Not supported when the URL map is bound to a target gRPC proxy that
13474 # has the validateForProxyless field set to true.
13475 # as a count of seconds and fractions of seconds at nanosecond
13476 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13477 # or &quot;month&quot;. Range is approximately 10,000 years.
13478 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13479 # Durations less than one second are represented with a 0
13480 # `seconds` field and a positive `nanos` field. Must be from 0
13481 # to 999,999,999 inclusive.
13482 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13483 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13484 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13485 },
13486 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
13487 # values are:
13488 #
13489 # - 5xx: retry is attempted if the instance or endpoint
13490 # responds with any 5xx response code, or if the instance or
13491 # endpoint does not respond at all. For example, disconnects, reset, read
13492 # timeout, connection failure, and refused streams.
13493 # - gateway-error: Similar to 5xx, but only
13494 # applies to response codes 502, 503 or504.
13495 # - connect-failure: a retry is attempted on failures
13496 # connecting to the instance or endpoint. For example, connection
13497 # timeouts.
13498 # - retriable-4xx: a retry is attempted if the instance
13499 # or endpoint responds with a 4xx response code.
13500 # The only error that you can retry is error code 409.
13501 # - refused-stream: a retry is attempted if the instance
13502 # or endpoint resets the stream with a REFUSED_STREAM error
13503 # code. This reset type indicates that it is safe to retry.
13504 # - cancelled: a retry is attempted if the gRPC status
13505 # code in the response header is set to cancelled.
13506 # - deadline-exceeded: a retry is attempted if the gRPC
13507 # status code in the response header is set todeadline-exceeded.
13508 # - internal: a retry is attempted if the gRPC
13509 # status code in the response header is set tointernal.
13510 # - resource-exhausted: a retry is attempted if the gRPC
13511 # status code in the response header is set toresource-exhausted.
13512 # - unavailable: a retry is attempted if the gRPC
13513 # status code in the response header is set tounavailable.
13514 #
13515 # Only the following codes are supported when the URL map is bound to
13516 # target gRPC proxy that has validateForProxyless field set to true.
13517 #
13518 # - cancelled
13519 # - deadline-exceeded
13520 # - internal
13521 # - resource-exhausted
13522 # - unavailable
13523 &quot;A String&quot;,
13524 ],
13525 },
13526 &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
13527 # time the request has been fully processed (known as *end-of-stream*)
13528 # up until the response has been processed. Timeout includes
13529 # all retries.
13530 #
13531 # If not specified, this field uses the largest timeout among all backend
13532 # services associated with the route.
13533 #
13534 # Not supported when the URL map is bound to a target gRPC proxy that
13535 # has validateForProxyless field set to true.
13536 # as a count of seconds and fractions of seconds at nanosecond
13537 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
13538 # or &quot;month&quot;. Range is approximately 10,000 years.
13539 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
13540 # Durations less than one second are represented with a 0
13541 # `seconds` field and a positive `nanos` field. Must be from 0
13542 # to 999,999,999 inclusive.
13543 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
13544 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
13545 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
13546 },
13547 &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
13548 # to the matched service.
13549 #
13550 # urlRewrite is the only action supported in UrlMaps
13551 # for classic Application Load Balancers.
13552 #
13553 # Not supported when the URL map is bound to a target gRPC proxy that
13554 # has the validateForProxyless field set to true.
13555 # backend service.
13556 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
13557 # host header is replaced with contents of hostRewrite.
13558 #
13559 # The value must be from 1 to 255 characters.
13560 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
13561 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
13562 #
13563 # The value must be from 1 to 1024 characters.
13564 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
13565 # header) using the HTTP template syntax.
13566 #
13567 # A corresponding
13568 # path_template_match must be specified. Any template variables must exist in
13569 # the path_template_match field.
13570 #
13571 #
13572 # - -At least one variable must be specified in the path_template_match
13573 # field
13574 # - You can omit variables from the rewritten URL
13575 # - The * and ** operators cannot be matched
13576 # unless they have a corresponding variable name - e.g.
13577 # {format=*} or {var=**}.
13578 #
13579 # For example, a path_template_match of /static/{format=**}
13580 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
13581 # rewrite, so that /{country}/{format}/{suffix=**} can be
13582 # rewritten as /content/{format}/{country}/{suffix}.
13583 #
13584 # At least
13585 # one non-empty routeRules[].matchRules[].path_template_match is
13586 # required.
13587 #
13588 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
13589 },
13590 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
13591 # occurs. The weights determine the fraction of traffic that flows to
13592 # their corresponding backend service. If all traffic needs to
13593 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
13594 #
13595 # After a backend service is identified and before forwarding
13596 # the request to
13597 # the backend service, advanced routing actions such as URL rewrites and
13598 # header transformations are applied depending on additional settings
13599 # specified in this HttpRouteAction.
13600 { # In contrast to a single BackendService in
13601 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
13602 # multiple backend services. The volume of traffic for each
13603 # backend service is proportional to the weight specified
13604 # in each WeightedBackendService
13605 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
13606 # resource. Before
13607 # forwarding the request to backendService, the load balancer
13608 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
13609 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
13610 # effect for the selected backendService.
13611 #
13612 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
13613 #
13614 # headerAction is not supported for load balancers that have
13615 # their loadBalancingScheme set to EXTERNAL.
13616 #
13617 # Not supported when the URL map is bound to a target gRPC proxy that
13618 # has validateForProxyless field set to true.
13619 # the request is passed along to the selected backendService.
13620 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
13621 { # Specification determining how headers are added to requests or responses.
13622 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
13623 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
13624 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
13625 # that already
13626 # exist for the header. If true, headerValue is set for the
13627 # header, discarding any values that were set for that header.
13628 #
13629 # The default value is true,
13630 # unless a variable is present in headerValue,
13631 # in which case the default value is false.
13632 # .
13633 },
13634 ],
13635 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
13636 # request before forwarding the request to the backendService.
13637 &quot;A String&quot;,
13638 ],
13639 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
13640 # client.
13641 { # Specification determining how headers are added to requests or responses.
13642 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
13643 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
13644 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
13645 # that already
13646 # exist for the header. If true, headerValue is set for the
13647 # header, discarding any values that were set for that header.
13648 #
13649 # The default value is true,
13650 # unless a variable is present in headerValue,
13651 # in which case the default value is false.
13652 # .
13653 },
13654 ],
13655 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
13656 # response before sending the response back to the client.
13657 &quot;A String&quot;,
13658 ],
13659 },
13660 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
13661 # computed asweight / (sum of all weightedBackendService weights in routeAction).
13662 #
13663 # The selection of a backend service is determined only for new traffic.
13664 # Once a user&#x27;s request has been directed to a backend service,
13665 # subsequent requests are sent to the same backend service as
13666 # determined by the backend service&#x27;s session affinity policy.
13667 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
13668 # splitting. If you do, the weighted traffic splitting configuration takes
13669 # precedence.
13670 #
13671 # The value must be from 0 to 1000.
13672 },
13673 ],
13674 },
13675 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource. This
13676 # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
13677 # matched. For example, the
13678 # following are all valid URLs to a BackendService resource:
13679 #
13680 #
13681 # - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
13682 # - compute/v1/projects/project/global/backendServices/backendService
13683 # - global/backendServices/backendService
13684 #
13685 #
13686 # If defaultRouteAction is also specified, advanced
13687 # routing actions, such as URL rewrites, take effect before sending the
13688 # request to the backend.
13689 #
13690 #
13691 # Only one of defaultUrlRedirect, defaultService
13692 # or defaultRouteAction.weightedBackendService can be set.
13693 #
13694 #
13695 # Authorization requires one or more of the following Google IAM permissions on the
13696 # specified resource default_service:
13697 #
13698 #
13699 # - compute.backendBuckets.use
13700 # - compute.backendServices.use
13701 &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
13702 # by defaultUrlRedirect.
13703 #
13704 #
13705 # Only one of defaultUrlRedirect, defaultService
13706 # or defaultRouteAction.weightedBackendService can be set.
13707 #
13708 #
13709 # Not supported when the URL map is bound to a target gRPC proxy.
13710 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
13711 # was supplied in the request.
13712 #
13713 # The value must be from 1 to 255
13714 # characters.
13715 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
13716 # set to HTTPS.
13717 # If set to false, the URL scheme of the redirected request
13718 # remains the same as that of the request.
13719 #
13720 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
13721 #
13722 # The default is set to false.
13723 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
13724 # that was supplied in the request.
13725 #
13726 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
13727 # supplied, the path of the original request is used for the redirect.
13728 #
13729 # The value must be from 1 to 1024 characters.
13730 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
13731 # the HttpRouteRuleMatch, retaining the remaining portion
13732 # of the URL before redirecting the request.
13733 #
13734 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
13735 # supplied, the path of the original request is used for the redirect.
13736 #
13737 # The value must be from 1 to 1024 characters.
13738 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
13739 #
13740 # Supported values are:
13741 #
13742 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
13743 # to 301.
13744 # - FOUND, which corresponds to 302.
13745 # - SEE_OTHER which corresponds to 303.
13746 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
13747 # method is retained.
13748 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
13749 # method is retained.
13750 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
13751 # URL is
13752 # removed before redirecting the request. If set to false, the
13753 # query portion of the original URL is retained.
13754 #
13755 # The default is set to false.
13756 },
13757 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
13758 # create the resource.
13759 &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
13760 # for the selected backend service.
13761 #
13762 # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
13763 #
13764 # HeaderAction is not supported for load balancers
13765 # that have
13766 # their loadBalancingScheme set to EXTERNAL.
13767 #
13768 # Not supported when the URL map is bound to a target gRPC proxy that
13769 # has validateForProxyless field set to true.
13770 # the request is passed along to the selected backendService.
13771 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
13772 { # Specification determining how headers are added to requests or responses.
13773 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
13774 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
13775 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
13776 # that already
13777 # exist for the header. If true, headerValue is set for the
13778 # header, discarding any values that were set for that header.
13779 #
13780 # The default value is true,
13781 # unless a variable is present in headerValue,
13782 # in which case the default value is false.
13783 # .
13784 },
13785 ],
13786 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
13787 # request before forwarding the request to the backendService.
13788 &quot;A String&quot;,
13789 ],
13790 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
13791 # client.
13792 { # Specification determining how headers are added to requests or responses.
13793 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
13794 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
13795 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
13796 # that already
13797 # exist for the header. If true, headerValue is set for the
13798 # header, discarding any values that were set for that header.
13799 #
13800 # The default value is true,
13801 # unless a variable is present in headerValue,
13802 # in which case the default value is false.
13803 # .
13804 },
13805 ],
13806 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
13807 # response before sending the response back to the client.
13808 &quot;A String&quot;,
13809 ],
13810 },
13811 &quot;name&quot;: &quot;A String&quot;, # The name to which this PathMatcher is referred by theHostRule.
13812 &quot;pathRules&quot;: [ # The list of path rules. Use this list instead of routeRules
13813 # when routing based on simple path matching is all that&#x27;s required. A path
13814 # rule can only include a wildcard character (*) after a
13815 # forward slash character (&quot;/&quot;).
13816 #
13817 # The order by which path rules are specified does not matter.
13818 # Matches are always done on the longest-path-first basis.
13819 #
13820 # For example: a pathRule with a path /a/b/c/* will match
13821 # before /a/b/* irrespective of the order in which those paths appear in this
13822 # list.
13823 #
13824 # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
13825 { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
13826 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
13827 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
13828 #
13829 # If a policy for an
13830 # error code is not configured for the PathRule, a policy for
13831 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
13832 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
13833 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
13834 # effect.
13835 #
13836 # For example, consider a UrlMap with the following configuration:
13837 #
13838 #
13839 # - UrlMap.defaultCustomErrorResponsePolicy are configured
13840 # with policies for 5xx and 4xx errors
13841 # - A PathRule for /coming_soon/ is configured for the error
13842 # code 404.
13843 #
13844 # 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
13845 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
13846 # the policy in PathRule.customErrorResponsePolicy takes
13847 # effect. If any of the requests in this example encounter a 500
13848 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
13849 #
13850 # customErrorResponsePolicy is supported only for
13851 # global external Application Load Balancers.
13852 # backend service or backend bucket responds with an error.
13853 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
13854 #
13855 # In a given policy, if you specify rules for both a range of error codes
13856 # as well as rules for specific error codes then rules with specific error
13857 # codes have a higher priority. For example, assume that you configure a rule
13858 # for 401 (Un-authorized) code, and another for all 4 series
13859 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
13860 # However if the backend service returns a 403, the rule for4xx takes effect.
13861 { # Specifies the mapping between the response code that will be returned along
13862 # with the custom error content and the response code returned by the backend
13863 # service.
13864 &quot;matchResponseCodes&quot;: [ # Valid values include:
13865 #
13866 #
13867 # - A number between 400 and 599: For example
13868 # 401 or 503, in which case the load balancer
13869 # applies the policy if the error code exactly matches this value.
13870 # - 5xx: Load Balancer will apply the policy if the
13871 # backend service responds with any response code in the range of
13872 # 500 to 599.
13873 # - 4xx: Load
13874 # Balancer will apply the policy if the backend service responds with any
13875 # response code in the range of 400 to
13876 # 499.
13877 #
13878 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
13879 &quot;A String&quot;,
13880 ],
13881 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
13882 # error content. If overrideResponseCode is not supplied, the
13883 # same response code returned by the original backend bucket or backend
13884 # service is returned to the client.
13885 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
13886 #
13887 # path must start
13888 # with a leading slash. path cannot have trailing slashes.
13889 #
13890 # If the file is not available in backendBucket or the
13891 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
13892 #
13893 # The value must
13894 # be from 1 to 1024 characters
13895 },
13896 ],
13897 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
13898 # contains the custom error content. Examples are:
13899 #
13900 #
13901 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
13902 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
13903 # - global/backendBuckets/myBackendBucket
13904 #
13905 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
13906 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
13907 #
13908 # If load balancer cannot reach
13909 # the backendBucket, a simple Not Found Error will
13910 # be returned, with the original response code (oroverrideResponseCode if configured).
13911 #
13912 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
13913 },
13914 &quot;paths&quot;: [ # The list of path patterns to match. Each must start with /
13915 # and the only place a * is allowed is at the end following
13916 # a /. The string fed to the path matcher does not include
13917 # any text after the first ? or #, and
13918 # those chars are not allowed here.
13919 &quot;A String&quot;,
13920 ],
13921 &quot;routeAction&quot;: { # In response to a matching path, the load balancer
13922 # performs advanced routing actions, such as URL rewrites and header
13923 # transformations, before forwarding the request to the selected
13924 # backend.
13925 #
13926 #
13927 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
13928 #
13929 #
13930 # URL maps for classic Application Load Balancers only support
13931 # the urlRewrite action within a path rule&#x27;srouteAction.
13932 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
13933 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
13934 # property must be specified. This policy cannot be specified if any target
13935 # backend has Identity-Aware Proxy enabled.
13936 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
13937 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
13938 # header names can be specified. The cache is bypassed for all `cacheMode`
13939 # values.
13940 &quot;A String&quot;,
13941 ],
13942 &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
13943 # on the backend type: for Backend Services, the complete request URI is
13944 # used; for Backend Buckets, the request URI is used without the protocol or
13945 # host, and only query parameters known to Cloud Storage are included.
13946 # Policy defined on Route Action.
13947 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
13948 # parameters will be included. Either specify `excludedQueryParameters`
13949 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
13950 # encoded and not treated as delimiters.
13951 #
13952 # Note: This field applies to routes that use backend services. Attempting
13953 # to set it on a route that points exclusively to Backend Buckets will
13954 # result in a configuration error. For routes that point to a Backend
13955 # Bucket, use `includedQueryParameters` to define which parameters should
13956 # be part of the cache key.
13957 &quot;A String&quot;,
13958 ],
13959 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
13960 #
13961 # Note: This setting is only applicable to routes that use a Backend
13962 # Service. It does not affect requests served by a Backend Bucket, as the
13963 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
13964 # it on a route that points exclusively to Backend Buckets will result in a
13965 # configuration error.
13966 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
13967 #
13968 # Note: This setting is only applicable to routes that use a Backend
13969 # Service. It does not affect requests served by a Backend Bucket, as the
13970 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
13971 # set on a route that points exclusively to Backend Buckets will result in
13972 # a configuration error.
13973 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
13974 # `includedQueryParameters` and `excludedQueryParameters`. If neither
13975 # is set, the entire query string will be included. If false, the query
13976 # string will be excluded from the cache key entirely.
13977 #
13978 # Note: This field applies to routes that use backend services. Attempting
13979 # to set it on a route that points exclusively to Backend Buckets will
13980 # result in a configuration error. For routes that point to a Backend
13981 # Bucket, use `includedQueryParameters` to define which parameters should
13982 # be part of the cache key.
13983 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
13984 # The name=value pair will be used in the cache key Cloud CDN generates.
13985 #
13986 # Note: This setting is only applicable to routes that use a Backend
13987 # Service. It does not affect requests served by a Backend Bucket.
13988 # Attempting to set it on a route that points exclusively to Backend
13989 # Buckets will result in a configuration error. Up to 5 cookie names can be
13990 # specified.
13991 &quot;A String&quot;,
13992 ],
13993 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
13994 &quot;A String&quot;,
13995 ],
13996 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
13997 # parameters will be excluded. Either specify `includedQueryParameters`
13998 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
13999 # encoded and not treated as delimiters.
14000 &quot;A String&quot;,
14001 ],
14002 },
14003 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
14004 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
14005 &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
14006 # content. This is used to clamp the max-age (or Expires) value sent to the
14007 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
14008 # is used for the response max-age directive, along with a &quot;public&quot;
14009 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
14010 # clamps the max-age from the origin (if specified), or else sets the
14011 # response max-age directive to the lesser of the `clientTtl` and
14012 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
14013 # present. The maximum allowed value is 31,622,400s (1 year). If not
14014 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
14015 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
14016 # `USE_ORIGIN_HEADERS`.
14017 # as a count of seconds and fractions of seconds at nanosecond
14018 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14019 # or &quot;month&quot;. Range is approximately 10,000 years.
14020 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14021 # Durations less than one second are represented with a 0
14022 # `seconds` field and a positive `nanos` field. Must be from 0
14023 # to 999,999,999 inclusive.
14024 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14025 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14026 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14027 },
14028 &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
14029 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
14030 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
14031 # greater than that of `maxTtl`. When the `cacheMode` is set to
14032 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
14033 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
14034 # accessed objects may be evicted from the cache before the defined TTL. If
14035 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
14036 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
14037 # `USE_ORIGIN_HEADERS`.
14038 # as a count of seconds and fractions of seconds at nanosecond
14039 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14040 # or &quot;month&quot;. Range is approximately 10,000 years.
14041 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14042 # Durations less than one second are represented with a 0
14043 # `seconds` field and a positive `nanos` field. Must be from 0
14044 # to 999,999,999 inclusive.
14045 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14046 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14047 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14048 },
14049 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
14050 # attempt to set a max-age or s-maxage higher than this, or an Expires header
14051 # more than `maxTtl` seconds in the future will be capped at the value of
14052 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
14053 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
14054 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
14055 # Infrequently accessed objects may be evicted from the cache before the
14056 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
14057 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
14058 # mode.
14059 # as a count of seconds and fractions of seconds at nanosecond
14060 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14061 # or &quot;month&quot;. Range is approximately 10,000 years.
14062 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14063 # Durations less than one second are represented with a 0
14064 # `seconds` field and a positive `nanos` field. Must be from 0
14065 # to 999,999,999 inclusive.
14066 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14067 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14068 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14069 },
14070 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
14071 # to apply fine-grained caching for common errors or redirects.
14072 # This can reduce the load on your origin and improve end-user
14073 # experience by reducing response latency.
14074 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
14075 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
14076 # the specified response code that lack any Cache-Control, Expires, or
14077 # Pragma: no-cache directives. When the `cacheMode` is set to
14078 # `FORCE_CACHE_ALL`, negative caching applies to all responses
14079 # with the specified response code, and overrides any caching headers. By
14080 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
14081 #
14082 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
14083 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
14084 # * 405 (Method Not Found), 501 (Not Implemented): 60s
14085 #
14086 # These defaults can be overridden in `negativeCachingPolicy`.
14087 # If not specified, Cloud CDN applies negative caching by default.
14088 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
14089 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
14090 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
14091 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
14092 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
14093 # all response codes that you wish to cache. Cloud CDN will not apply any
14094 # default negative caching when a policy exists.
14095 { # Specify CDN TTLs for response error codes.
14096 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
14097 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
14098 # specified as values, and you cannot specify a status code more than
14099 # once.
14100 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
14101 # corresponding status code.
14102 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
14103 # objects may be evicted from the cache before the defined TTL.
14104 # as a count of seconds and fractions of seconds at nanosecond
14105 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14106 # or &quot;month&quot;. Range is approximately 10,000 years.
14107 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14108 # Durations less than one second are represented with a 0
14109 # `seconds` field and a positive `nanos` field. Must be from 0
14110 # to 999,999,999 inclusive.
14111 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14112 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14113 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14114 },
14115 },
14116 ],
14117 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
14118 # requests into a small number of requests to the origin. If not specified,
14119 # Cloud CDN applies request coalescing by default.
14120 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
14121 # content with the origin, or when an error is encountered when refreshing
14122 # the cache.
14123 # This setting defines the default &quot;max-stale&quot; duration for any cached
14124 # responses that do not specify a max-stale directive. Stale responses that
14125 # exceed the TTL configured here will not be served. The default limit
14126 # (max-stale) is 86400s (1 day), which will allow stale content to be
14127 # served up to this limit beyond the max-age (or s-maxage) of a cached
14128 # response.
14129 # The maximum allowed value is 604800 (1 week).
14130 # Set this to zero (0) to disable serve-while-stale.
14131 # as a count of seconds and fractions of seconds at nanosecond
14132 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14133 # or &quot;month&quot;. Range is approximately 10,000 years.
14134 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14135 # Durations less than one second are represented with a 0
14136 # `seconds` field and a positive `nanos` field. Must be from 0
14137 # to 999,999,999 inclusive.
14138 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14139 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14140 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14141 },
14142 },
14143 &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
14144 # information about the W3C recommendation for cross-origin resource sharing
14145 # (CORS), see Fetch API Living
14146 # Standard.
14147 #
14148 # Not supported when the URL map is bound to a target gRPC proxy.
14149 # information about the W3C recommendation for cross-origin resource sharing
14150 # (CORS), see Fetch API Living
14151 # Standard.
14152 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
14153 # indicates that
14154 # the actual request can include user credentials. This field translates to
14155 # the Access-Control-Allow-Credentials header.
14156 #
14157 # Default is false.
14158 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
14159 # header.
14160 &quot;A String&quot;,
14161 ],
14162 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
14163 # header.
14164 &quot;A String&quot;,
14165 ],
14166 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
14167 # more information, see regular expression syntax.
14168 #
14169 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
14170 #
14171 # Regular expressions can only be used when the loadBalancingScheme is
14172 # set to INTERNAL_SELF_MANAGED.
14173 &quot;A String&quot;,
14174 ],
14175 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
14176 #
14177 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
14178 &quot;A String&quot;,
14179 ],
14180 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
14181 # The default value is false, which indicates that the CORS
14182 # policy is in effect.
14183 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
14184 # header.
14185 &quot;A String&quot;,
14186 ],
14187 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
14188 # seconds. This field translates to the Access-Control-Max-Age
14189 # header.
14190 },
14191 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
14192 # the resiliency of clients to backend service failure. As part of fault
14193 # injection, when clients send requests to a backend service, delays can be
14194 # introduced by a load balancer on a percentage of requests before sending
14195 # those requests to the backend service. Similarly requests from clients can
14196 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
14197 # that are configured with a fault_injection_policy if:
14198 # 1. The traffic is generated by fault injection AND
14199 # 2. The fault injection is not a delay fault injection.
14200 # Fault injection is not supported with the classic Application Load Balancer
14201 # . To see which load balancers support fault injection,
14202 # see Load
14203 # balancing: Routing and traffic management features.
14204 # the resiliency of clients to backend service failure. As part of fault
14205 # injection, when clients send requests to a backend service, delays can be
14206 # introduced by the load balancer on a percentage of requests before sending
14207 # those request to the backend service. Similarly requests from clients can be
14208 # aborted by the load balancer for a percentage of requests.
14209 &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
14210 # injection.
14211 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
14212 #
14213 # The value must be from 200 to 599 inclusive.
14214 #
14215 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
14216 # according to this
14217 # mapping table. HTTP status 200 is mapped to gRPC status
14218 # UNKNOWN. Injecting an OK status is currently not supported by
14219 # Traffic Director.
14220 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
14221 # that is aborted as part of fault injection.
14222 #
14223 # The value must be from 0.0 to 100.0 inclusive.
14224 },
14225 &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
14226 # injection, before being sent to a backend service.
14227 # request to the backend service as part of fault injection.
14228 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
14229 # as a count of seconds and fractions of seconds at nanosecond
14230 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14231 # or &quot;month&quot;. Range is approximately 10,000 years.
14232 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14233 # Durations less than one second are represented with a 0
14234 # `seconds` field and a positive `nanos` field. Must be from 0
14235 # to 999,999,999 inclusive.
14236 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14237 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14238 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14239 },
14240 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
14241 # which a delay is introduced as part of fault injection.
14242 #
14243 # The value must be from 0.0 to 100.0 inclusive.
14244 },
14245 },
14246 &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
14247 # Global EXTERNAL_MANAGED load balancer schemes.
14248 # Either Cloud CDN must be enabled on the backend service or backend bucket
14249 # serving the route, or cache policy must be configured on the same route
14250 # dynamically processes and delivers images from the network edge.
14251 # Image Optimization is only available for Global External Application Load
14252 # Balancers.
14253 # Either Cloud CDN must be enabled on the backend service or backend bucket
14254 # serving the route, or cache policy must be configured on the same route.
14255 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
14256 },
14257 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
14258 # Unlike the timeout field where the timeout duration starts
14259 # from the time the request has been fully processed (known as*end-of-stream*),
14260 # the duration in this field is computed from the beginning of the stream
14261 # until the response has been processed, including all retries. A
14262 # stream that does not complete in this duration is closed.
14263 #
14264 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
14265 # with the route.
14266 #
14267 # This field is only allowed if the Url map is used with backend services
14268 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
14269 # as a count of seconds and fractions of seconds at nanosecond
14270 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14271 # or &quot;month&quot;. Range is approximately 10,000 years.
14272 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14273 # Durations less than one second are represented with a 0
14274 # `seconds` field and a positive `nanos` field. Must be from 0
14275 # to 999,999,999 inclusive.
14276 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14277 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14278 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14279 },
14280 &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
14281 # are shadowed to a separate mirrored backend service. The load balancer does
14282 # not wait for responses from the shadow service. Before sending traffic
14283 # to the shadow service, the host / authority header is suffixed with-shadow.
14284 #
14285 # Not supported when the URL map is bound to a target gRPC proxy that
14286 # has the validateForProxyless field set to true.
14287 # are shadowed to a separate mirrored backend service. The load balancer
14288 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
14289 # to the shadow service, the host or authority header is suffixed with-shadow.
14290 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
14291 # mirrored to.
14292 #
14293 # The backend service configured for a mirroring
14294 # policy must reference backends that are of the same type as the original
14295 # backend service matched in the URL map.
14296 #
14297 # Serverless NEG backends are not currently supported as a mirrored
14298 # backend service.
14299 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
14300 },
14301 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
14302 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
14303 # If not specified, defaults to 1.
14304 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
14305 #
14306 # If not specified, will use the timeout set in theHttpRouteAction field.
14307 # If timeout in the HttpRouteAction field is not set, this field
14308 # uses the largest timeout
14309 # among all backend services associated with the route.
14310 #
14311 # Not supported when the URL map is bound to a target gRPC proxy that
14312 # has the validateForProxyless field set to true.
14313 # as a count of seconds and fractions of seconds at nanosecond
14314 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14315 # or &quot;month&quot;. Range is approximately 10,000 years.
14316 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14317 # Durations less than one second are represented with a 0
14318 # `seconds` field and a positive `nanos` field. Must be from 0
14319 # to 999,999,999 inclusive.
14320 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14321 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14322 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14323 },
14324 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
14325 # values are:
14326 #
14327 # - 5xx: retry is attempted if the instance or endpoint
14328 # responds with any 5xx response code, or if the instance or
14329 # endpoint does not respond at all. For example, disconnects, reset, read
14330 # timeout, connection failure, and refused streams.
14331 # - gateway-error: Similar to 5xx, but only
14332 # applies to response codes 502, 503 or504.
14333 # - connect-failure: a retry is attempted on failures
14334 # connecting to the instance or endpoint. For example, connection
14335 # timeouts.
14336 # - retriable-4xx: a retry is attempted if the instance
14337 # or endpoint responds with a 4xx response code.
14338 # The only error that you can retry is error code 409.
14339 # - refused-stream: a retry is attempted if the instance
14340 # or endpoint resets the stream with a REFUSED_STREAM error
14341 # code. This reset type indicates that it is safe to retry.
14342 # - cancelled: a retry is attempted if the gRPC status
14343 # code in the response header is set to cancelled.
14344 # - deadline-exceeded: a retry is attempted if the gRPC
14345 # status code in the response header is set todeadline-exceeded.
14346 # - internal: a retry is attempted if the gRPC
14347 # status code in the response header is set tointernal.
14348 # - resource-exhausted: a retry is attempted if the gRPC
14349 # status code in the response header is set toresource-exhausted.
14350 # - unavailable: a retry is attempted if the gRPC
14351 # status code in the response header is set tounavailable.
14352 #
14353 # Only the following codes are supported when the URL map is bound to
14354 # target gRPC proxy that has validateForProxyless field set to true.
14355 #
14356 # - cancelled
14357 # - deadline-exceeded
14358 # - internal
14359 # - resource-exhausted
14360 # - unavailable
14361 &quot;A String&quot;,
14362 ],
14363 },
14364 &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
14365 # time the request has been fully processed (known as *end-of-stream*)
14366 # up until the response has been processed. Timeout includes
14367 # all retries.
14368 #
14369 # If not specified, this field uses the largest timeout among all backend
14370 # services associated with the route.
14371 #
14372 # Not supported when the URL map is bound to a target gRPC proxy that
14373 # has validateForProxyless field set to true.
14374 # as a count of seconds and fractions of seconds at nanosecond
14375 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
14376 # or &quot;month&quot;. Range is approximately 10,000 years.
14377 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
14378 # Durations less than one second are represented with a 0
14379 # `seconds` field and a positive `nanos` field. Must be from 0
14380 # to 999,999,999 inclusive.
14381 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
14382 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
14383 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
14384 },
14385 &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
14386 # to the matched service.
14387 #
14388 # urlRewrite is the only action supported in UrlMaps
14389 # for classic Application Load Balancers.
14390 #
14391 # Not supported when the URL map is bound to a target gRPC proxy that
14392 # has the validateForProxyless field set to true.
14393 # backend service.
14394 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
14395 # host header is replaced with contents of hostRewrite.
14396 #
14397 # The value must be from 1 to 255 characters.
14398 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
14399 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
14400 #
14401 # The value must be from 1 to 1024 characters.
14402 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
14403 # header) using the HTTP template syntax.
14404 #
14405 # A corresponding
14406 # path_template_match must be specified. Any template variables must exist in
14407 # the path_template_match field.
14408 #
14409 #
14410 # - -At least one variable must be specified in the path_template_match
14411 # field
14412 # - You can omit variables from the rewritten URL
14413 # - The * and ** operators cannot be matched
14414 # unless they have a corresponding variable name - e.g.
14415 # {format=*} or {var=**}.
14416 #
14417 # For example, a path_template_match of /static/{format=**}
14418 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
14419 # rewrite, so that /{country}/{format}/{suffix=**} can be
14420 # rewritten as /content/{format}/{country}/{suffix}.
14421 #
14422 # At least
14423 # one non-empty routeRules[].matchRules[].path_template_match is
14424 # required.
14425 #
14426 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
14427 },
14428 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
14429 # occurs. The weights determine the fraction of traffic that flows to
14430 # their corresponding backend service. If all traffic needs to
14431 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
14432 #
14433 # After a backend service is identified and before forwarding
14434 # the request to
14435 # the backend service, advanced routing actions such as URL rewrites and
14436 # header transformations are applied depending on additional settings
14437 # specified in this HttpRouteAction.
14438 { # In contrast to a single BackendService in
14439 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
14440 # multiple backend services. The volume of traffic for each
14441 # backend service is proportional to the weight specified
14442 # in each WeightedBackendService
14443 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
14444 # resource. Before
14445 # forwarding the request to backendService, the load balancer
14446 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
14447 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
14448 # effect for the selected backendService.
14449 #
14450 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
14451 #
14452 # headerAction is not supported for load balancers that have
14453 # their loadBalancingScheme set to EXTERNAL.
14454 #
14455 # Not supported when the URL map is bound to a target gRPC proxy that
14456 # has validateForProxyless field set to true.
14457 # the request is passed along to the selected backendService.
14458 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
14459 { # Specification determining how headers are added to requests or responses.
14460 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
14461 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
14462 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
14463 # that already
14464 # exist for the header. If true, headerValue is set for the
14465 # header, discarding any values that were set for that header.
14466 #
14467 # The default value is true,
14468 # unless a variable is present in headerValue,
14469 # in which case the default value is false.
14470 # .
14471 },
14472 ],
14473 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
14474 # request before forwarding the request to the backendService.
14475 &quot;A String&quot;,
14476 ],
14477 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
14478 # client.
14479 { # Specification determining how headers are added to requests or responses.
14480 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
14481 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
14482 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
14483 # that already
14484 # exist for the header. If true, headerValue is set for the
14485 # header, discarding any values that were set for that header.
14486 #
14487 # The default value is true,
14488 # unless a variable is present in headerValue,
14489 # in which case the default value is false.
14490 # .
14491 },
14492 ],
14493 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
14494 # response before sending the response back to the client.
14495 &quot;A String&quot;,
14496 ],
14497 },
14498 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
14499 # computed asweight / (sum of all weightedBackendService weights in routeAction).
14500 #
14501 # The selection of a backend service is determined only for new traffic.
14502 # Once a user&#x27;s request has been directed to a backend service,
14503 # subsequent requests are sent to the same backend service as
14504 # determined by the backend service&#x27;s session affinity policy.
14505 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
14506 # splitting. If you do, the weighted traffic splitting configuration takes
14507 # precedence.
14508 #
14509 # The value must be from 0 to 1000.
14510 },
14511 ],
14512 },
14513 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
14514 # is directed if this rule is matched. If routeAction is
14515 # also specified, advanced routing actions, such as URL rewrites,
14516 # take effect before sending the request to the backend.
14517 #
14518 #
14519 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
14520 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
14521 # specified by urlRedirect.
14522 #
14523 #
14524 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
14525 #
14526 #
14527 # Not supported when the URL map is bound to a target gRPC proxy.
14528 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
14529 # was supplied in the request.
14530 #
14531 # The value must be from 1 to 255
14532 # characters.
14533 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
14534 # set to HTTPS.
14535 # If set to false, the URL scheme of the redirected request
14536 # remains the same as that of the request.
14537 #
14538 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
14539 #
14540 # The default is set to false.
14541 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
14542 # that was supplied in the request.
14543 #
14544 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
14545 # supplied, the path of the original request is used for the redirect.
14546 #
14547 # The value must be from 1 to 1024 characters.
14548 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
14549 # the HttpRouteRuleMatch, retaining the remaining portion
14550 # of the URL before redirecting the request.
14551 #
14552 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
14553 # supplied, the path of the original request is used for the redirect.
14554 #
14555 # The value must be from 1 to 1024 characters.
14556 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
14557 #
14558 # Supported values are:
14559 #
14560 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
14561 # to 301.
14562 # - FOUND, which corresponds to 302.
14563 # - SEE_OTHER which corresponds to 303.
14564 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
14565 # method is retained.
14566 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
14567 # method is retained.
14568 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
14569 # URL is
14570 # removed before redirecting the request. If set to false, the
14571 # query portion of the original URL is retained.
14572 #
14573 # The default is set to false.
14574 },
14575 },
14576 ],
14577 &quot;routeRules&quot;: [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
14578 # desired. routeRules are evaluated in order of priority, from
14579 # the lowest to highest number.
14580 #
14581 # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
14582 { # The HttpRouteRule setting specifies how to match an HTTP request
14583 # and the corresponding routing action that load balancing proxies perform.
14584 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
14585 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
14586 #
14587 # If a policy for an
14588 # error code is not configured for the RouteRule, a policy for
14589 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
14590 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
14591 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
14592 # effect.
14593 #
14594 # For example, consider a UrlMap with the following configuration:
14595 #
14596 #
14597 # - UrlMap.defaultCustomErrorResponsePolicy are configured
14598 # with policies for 5xx and 4xx errors
14599 # - A RouteRule for /coming_soon/ is configured for the
14600 # error code 404.
14601 #
14602 # 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
14603 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
14604 # the policy in RouteRule.customErrorResponsePolicy takes
14605 # effect. If any of the requests in this example encounter a 500
14606 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
14607 #
14608 # When
14609 # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
14610 # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
14611 # a retry, if load balancer is successful in reaching the
14612 # service, the customErrorResponsePolicy is ignored and
14613 # the response from the service is returned to the client.
14614 #
14615 # customErrorResponsePolicy is supported only for
14616 # global external Application Load Balancers.
14617 # backend service or backend bucket responds with an error.
14618 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
14619 #
14620 # In a given policy, if you specify rules for both a range of error codes
14621 # as well as rules for specific error codes then rules with specific error
14622 # codes have a higher priority. For example, assume that you configure a rule
14623 # for 401 (Un-authorized) code, and another for all 4 series
14624 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
14625 # However if the backend service returns a 403, the rule for4xx takes effect.
14626 { # Specifies the mapping between the response code that will be returned along
14627 # with the custom error content and the response code returned by the backend
14628 # service.
14629 &quot;matchResponseCodes&quot;: [ # Valid values include:
14630 #
14631 #
14632 # - A number between 400 and 599: For example
14633 # 401 or 503, in which case the load balancer
14634 # applies the policy if the error code exactly matches this value.
14635 # - 5xx: Load Balancer will apply the policy if the
14636 # backend service responds with any response code in the range of
14637 # 500 to 599.
14638 # - 4xx: Load
14639 # Balancer will apply the policy if the backend service responds with any
14640 # response code in the range of 400 to
14641 # 499.
14642 #
14643 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
14644 &quot;A String&quot;,
14645 ],
14646 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
14647 # error content. If overrideResponseCode is not supplied, the
14648 # same response code returned by the original backend bucket or backend
14649 # service is returned to the client.
14650 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
14651 #
14652 # path must start
14653 # with a leading slash. path cannot have trailing slashes.
14654 #
14655 # If the file is not available in backendBucket or the
14656 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
14657 #
14658 # The value must
14659 # be from 1 to 1024 characters
14660 },
14661 ],
14662 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
14663 # contains the custom error content. Examples are:
14664 #
14665 #
14666 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
14667 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
14668 # - global/backendBuckets/myBackendBucket
14669 #
14670 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
14671 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
14672 #
14673 # If load balancer cannot reach
14674 # the backendBucket, a simple Not Found Error will
14675 # be returned, with the original response code (oroverrideResponseCode if configured).
14676 #
14677 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
14678 },
14679 &quot;description&quot;: &quot;A String&quot;, # The short description conveying the intent of this routeRule.
14680 #
14681 #
14682 # The description can have a maximum length of 1024 characters.
14683 &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
14684 # for the selected backendService.
14685 #
14686 # The headerAction value specified here is applied before the
14687 # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
14688 #
14689 # HeaderAction is not supported for load balancers
14690 # that have
14691 # their loadBalancingScheme set to EXTERNAL.
14692 #
14693 # Not supported when the URL map is bound to a target gRPC proxy that
14694 # has validateForProxyless field set to true.
14695 # the request is passed along to the selected backendService.
14696 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
14697 { # Specification determining how headers are added to requests or responses.
14698 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
14699 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
14700 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
14701 # that already
14702 # exist for the header. If true, headerValue is set for the
14703 # header, discarding any values that were set for that header.
14704 #
14705 # The default value is true,
14706 # unless a variable is present in headerValue,
14707 # in which case the default value is false.
14708 # .
14709 },
14710 ],
14711 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
14712 # request before forwarding the request to the backendService.
14713 &quot;A String&quot;,
14714 ],
14715 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
14716 # client.
14717 { # Specification determining how headers are added to requests or responses.
14718 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
14719 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
14720 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
14721 # that already
14722 # exist for the header. If true, headerValue is set for the
14723 # header, discarding any values that were set for that header.
14724 #
14725 # The default value is true,
14726 # unless a variable is present in headerValue,
14727 # in which case the default value is false.
14728 # .
14729 },
14730 ],
14731 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
14732 # response before sending the response back to the client.
14733 &quot;A String&quot;,
14734 ],
14735 },
14736 &quot;httpFilterConfigs&quot;: [ # Outbound route specific configuration fornetworkservices.HttpFilter resources enabled by Traffic
14737 # Director. httpFilterConfigs only applies for load balancers
14738 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
14739 # more details.
14740 #
14741 # Not supported when the URL map is bound to a target gRPC proxy that
14742 # has validateForProxyless field set to true.
14743 { # HttpFilterConfiguration supplies additional contextual settings
14744 # for networkservices.HttpFilter resources enabled by Traffic
14745 # Director.
14746 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
14747 # YAML formatted and only contain fields defined in the protobuf identified
14748 # in configTypeUrl
14749 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
14750 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
14751 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
14752 # configuration belongs to. This name must be known to the xDS client.
14753 # Example: envoy.wasm
14754 },
14755 ],
14756 &quot;httpFilterMetadata&quot;: [ # Outbound route specific metadata supplied tonetworkservices.HttpFilter resources enabled by Traffic
14757 # Director. httpFilterMetadata only applies for load balancers
14758 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
14759 # more details.
14760 #
14761 # The only configTypeUrl supported istype.googleapis.com/google.protobuf.Struct
14762 #
14763 # Not supported when the URL map is bound to a target gRPC proxy that
14764 # has validateForProxyless field set to true.
14765 { # HttpFilterConfiguration supplies additional contextual settings
14766 # for networkservices.HttpFilter resources enabled by Traffic
14767 # Director.
14768 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
14769 # YAML formatted and only contain fields defined in the protobuf identified
14770 # in configTypeUrl
14771 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
14772 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
14773 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
14774 # configuration belongs to. This name must be known to the xDS client.
14775 # Example: envoy.wasm
14776 },
14777 ],
14778 &quot;matchRules&quot;: [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
14779 # this routeRule when any of thematchRules are satisfied. However predicates within
14780 # a given matchRule have AND semantics. All predicates
14781 # within a matchRule must match for the request to
14782 # match the rule.
14783 { # HttpRouteRuleMatch specifies a set of criteria for matching
14784 # requests to an HttpRouteRule. All specified criteria must
14785 # be satisfied for a match to occur.
14786 &quot;fullPathMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
14787 # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
14788 # that may be part of the original URL.
14789 #
14790 # fullPathMatch must be from 1 to 1024 characters.
14791 #
14792 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
14793 # specified.
14794 &quot;headerMatches&quot;: [ # Specifies a list of header match criteria, all of which must match
14795 # corresponding headers in the request.
14796 { # matchRule criteria for request header matches.
14797 &quot;exactMatch&quot;: &quot;A String&quot;, # The value should exactly match contents of exactMatch.
14798 #
14799 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
14800 &quot;headerName&quot;: &quot;A String&quot;, # The name of the HTTP header to match.
14801 #
14802 # For matching against the HTTP request&#x27;s authority, use a headerMatch
14803 # with the header name &quot;:authority&quot;.
14804 #
14805 # For matching a request&#x27;s method, use the headerName &quot;:method&quot;.
14806 #
14807 # When the URL map is bound to a target gRPC proxy that has
14808 # the validateForProxyless field set to true, only
14809 # non-binary
14810 # user-specified custom metadata and the `content-type` header are supported.
14811 # The following transport-level headers cannot be used in header matching
14812 # rules:
14813 # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
14814 # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
14815 # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
14816 # `grpc-timeout` and `grpc-trace-bin`.
14817 &quot;invertMatch&quot;: True or False, # If set to false, the headerMatch is considered a
14818 # match if the preceding match criteria are met. If set to true,
14819 # the headerMatch is considered a match if the preceding
14820 # match criteria are NOT met.
14821 #
14822 # The default setting is false.
14823 &quot;prefixMatch&quot;: &quot;A String&quot;, # The value of the header must start with the contents ofprefixMatch.
14824 #
14825 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
14826 &quot;presentMatch&quot;: True or False, # A header with the contents of headerName must exist. The
14827 # match takes place whether or not the request&#x27;s header has a value.
14828 #
14829 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
14830 &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
14831 # specified in rangeMatch. If the header does not contain an
14832 # integer, number or is empty, the match fails.
14833 #
14834 # For example for a range [-5, 0]
14835 #
14836 #
14837 # - -3 will match.
14838 # - 0 will not match.
14839 # - 0.25 will not match.
14840 # - -3someString will not match.
14841 #
14842 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
14843 #
14844 # rangeMatch is not supported for load balancers
14845 # that have loadBalancingScheme set to EXTERNAL.
14846 # within the specified integer range.
14847 &quot;rangeEnd&quot;: &quot;A String&quot;, # The end of the range (exclusive) in signed long integer format.
14848 &quot;rangeStart&quot;: &quot;A String&quot;, # The start of the range (inclusive) in signed long integer format.
14849 },
14850 &quot;regexMatch&quot;: &quot;A String&quot;, # The value of the header must match the regular expression specified inregexMatch.
14851 # For more information about regular expression syntax, see Syntax.
14852 #
14853 # For matching against a port specified in the HTTP request, use a
14854 # headerMatch with headerName set to PORT and a regular expression that
14855 # satisfies the RFC2616 Host header&#x27;s port specifier.
14856 #
14857 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
14858 #
14859 # Regular expressions can only be used when the loadBalancingScheme is
14860 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
14861 # (regional scope) or INTERNAL_MANAGED.
14862 &quot;suffixMatch&quot;: &quot;A String&quot;, # The value of the header must end with the contents ofsuffixMatch.
14863 #
14864 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
14865 },
14866 ],
14867 &quot;ignoreCase&quot;: True or False, # Specifies that prefixMatch and fullPathMatch
14868 # matches are case sensitive.
14869 #
14870 # The default value is false.
14871 #
14872 # ignoreCase must not be used with regexMatch.
14873 #
14874 # Not supported when the URL map is bound to a target gRPC proxy.
14875 &quot;metadataFilters&quot;: [ # Opaque filter criteria used by the load balancer to restrict routing
14876 # configuration to a limited set of xDS
14877 # compliant clients. In their xDS requests to the load balancer, xDS clients
14878 # present node
14879 # metadata. When there is a match, the relevant routing configuration
14880 # is made available to those proxies.
14881 #
14882 # 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
14883 # the metadata. If its filterMatchCriteria is set to
14884 # MATCH_ALL, then all of its filterLabels must match with
14885 # corresponding labels provided in the metadata. If multiple
14886 # metadata filters are specified, all of them need to be
14887 # satisfied in order to be considered a match.
14888 #
14889 # metadataFilters specified here is applied after those
14890 # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
14891 #
14892 # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
14893 #
14894 # Not supported when the URL map is bound to a target gRPC proxy that
14895 # has validateForProxyless field set to true.
14896 { # Opaque filter criteria used by load balancers to restrict routing
14897 # configuration to a limited set of load balancing proxies. Proxies and
14898 # sidecars involved in load balancing would typically present metadata to the
14899 # load balancers that need to match criteria specified here. If a match takes
14900 # place, the relevant configuration is made available to those
14901 # proxies.
14902 #
14903 # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
14904 # one of thefilterLabels must match the corresponding label provided in
14905 # the metadata. If its filterMatchCriteria is set to
14906 # MATCH_ALL, then all of its filterLabels must match with
14907 # corresponding labels provided in the metadata.
14908 #
14909 # An example for using metadataFilters would be: if
14910 # load balancing involves
14911 # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in of their XDS requests to loadbalancers.
14912 &quot;filterLabels&quot;: [ # The list of label value pairs that must match labels in the provided
14913 # metadata based on filterMatchCriteria
14914 #
14915 # This list must not be empty and can have at the most 64 entries.
14916 { # MetadataFilter label name value pairs that are expected
14917 # to match corresponding labels presented as metadata to the load balancer.
14918 &quot;name&quot;: &quot;A String&quot;, # Name of metadata label.
14919 #
14920 # The name can have a maximum length of 1024 characters and must be at
14921 # least 1 character long.
14922 &quot;value&quot;: &quot;A String&quot;, # The value of the label must match the specified value.
14923 #
14924 # value can have a maximum length of 1024 characters.
14925 },
14926 ],
14927 &quot;filterMatchCriteria&quot;: &quot;A String&quot;, # Specifies how individual filter label matches
14928 # within the list of filterLabels and contributes toward the
14929 # overall metadataFilter match.
14930 #
14931 # Supported values are:
14932 #
14933 # - MATCH_ANY: at least one of the filterLabels
14934 # must have a matching label in the provided metadata.
14935 # - MATCH_ALL: all filterLabels must have
14936 # matching labels in the provided metadata.
14937 },
14938 ],
14939 &quot;pathTemplateMatch&quot;: &quot;A String&quot;, # If specified, this field defines a path template pattern that must match
14940 # the :path header after the query string is removed.
14941 #
14942 # A path template pattern can include variables and wildcards.
14943 # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
14944 # matches a single path segment, and ** that matches zero or
14945 # more path segments. The pattern must follow these rules:
14946 #
14947 #
14948 # - The value must be between 1 and 1024 characters.
14949 # - The pattern must start with a leading slash (&quot;/&quot;).
14950 # - No more than 5 operators (variables or wildcards) may appear in
14951 # the pattern.
14952 #
14953 # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
14954 # set.
14955 &quot;prefixMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the request&#x27;s
14956 # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
14957 #
14958 # The value must be from 1 to 1024 characters.
14959 #
14960 # The * character inside a prefix match is
14961 # treated as a literal character, not as a wildcard.
14962 #
14963 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
14964 # used within a matchRule.
14965 &quot;queryParameterMatches&quot;: [ # Specifies a list of query parameter match criteria, all of which must
14966 # match corresponding query parameters in the request.
14967 #
14968 # Not supported when the URL map is bound to a target gRPC proxy.
14969 { # HttpRouteRuleMatch criteria for a request&#x27;s query parameter.
14970 &quot;exactMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
14971 # parameter exactly matches the contents of exactMatch.
14972 #
14973 # Only one of presentMatch, exactMatch, orregexMatch must be set.
14974 &quot;name&quot;: &quot;A String&quot;, # The name of the query parameter to match. The query parameter must exist in
14975 # the request, in the absence of which the request match fails.
14976 &quot;presentMatch&quot;: True or False, # Specifies that the queryParameterMatch matches if the
14977 # request contains the query parameter, irrespective of whether the
14978 # parameter has a value or not.
14979 #
14980 # Only one of presentMatch, exactMatch, orregexMatch must be set.
14981 &quot;regexMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
14982 # parameter matches the regular expression specified byregexMatch. For
14983 # more information about regular expression syntax, see Syntax.
14984 #
14985 # Only one of presentMatch, exactMatch, orregexMatch must be set.
14986 #
14987 # Regular expressions can only be used when the loadBalancingScheme is
14988 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
14989 # (regional scope) or INTERNAL_MANAGED.
14990 },
14991 ],
14992 &quot;regexMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
14993 # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
14994 # supplied with the original URL. For
14995 # more information about regular expression syntax, see Syntax.
14996 #
14997 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
14998 # specified.
14999 #
15000 # Regular expressions can only be used when the loadBalancingScheme is
15001 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
15002 # (regional scope) or INTERNAL_MANAGED.
15003 },
15004 ],
15005 &quot;priority&quot;: 42, # For routeRules within a given pathMatcher,
15006 # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
15007 # of priority, from the lowest to highest number. The priority of a
15008 # rule decreases as its number increases (1, 2, 3, N+1). The first rule
15009 # that matches the request is applied.
15010 #
15011 #
15012 # You cannot configure two or more routeRules with the same priority.
15013 # Priority for each rule must be set to a number from 0 to 2147483647
15014 # inclusive.
15015 #
15016 #
15017 # Priority numbers can have gaps, which enable you to add or remove rules
15018 # in the future without affecting the rest of the rules. For example, 1, 2,
15019 # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
15020 # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
15021 # without any impact on existing rules.
15022 &quot;routeAction&quot;: { # In response to a matching matchRule, the load balancer
15023 # performs advanced routing actions, such as URL rewrites and header
15024 # transformations, before forwarding the request to the selected backend.
15025 #
15026 #
15027 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
15028 #
15029 #
15030 # URL maps for classic Application Load Balancers only support
15031 # the urlRewrite action within a route rule&#x27;srouteAction.
15032 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
15033 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
15034 # property must be specified. This policy cannot be specified if any target
15035 # backend has Identity-Aware Proxy enabled.
15036 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
15037 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
15038 # header names can be specified. The cache is bypassed for all `cacheMode`
15039 # values.
15040 &quot;A String&quot;,
15041 ],
15042 &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
15043 # on the backend type: for Backend Services, the complete request URI is
15044 # used; for Backend Buckets, the request URI is used without the protocol or
15045 # host, and only query parameters known to Cloud Storage are included.
15046 # Policy defined on Route Action.
15047 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
15048 # parameters will be included. Either specify `excludedQueryParameters`
15049 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
15050 # encoded and not treated as delimiters.
15051 #
15052 # Note: This field applies to routes that use backend services. Attempting
15053 # to set it on a route that points exclusively to Backend Buckets will
15054 # result in a configuration error. For routes that point to a Backend
15055 # Bucket, use `includedQueryParameters` to define which parameters should
15056 # be part of the cache key.
15057 &quot;A String&quot;,
15058 ],
15059 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
15060 #
15061 # Note: This setting is only applicable to routes that use a Backend
15062 # Service. It does not affect requests served by a Backend Bucket, as the
15063 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
15064 # it on a route that points exclusively to Backend Buckets will result in a
15065 # configuration error.
15066 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
15067 #
15068 # Note: This setting is only applicable to routes that use a Backend
15069 # Service. It does not affect requests served by a Backend Bucket, as the
15070 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
15071 # set on a route that points exclusively to Backend Buckets will result in
15072 # a configuration error.
15073 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
15074 # `includedQueryParameters` and `excludedQueryParameters`. If neither
15075 # is set, the entire query string will be included. If false, the query
15076 # string will be excluded from the cache key entirely.
15077 #
15078 # Note: This field applies to routes that use backend services. Attempting
15079 # to set it on a route that points exclusively to Backend Buckets will
15080 # result in a configuration error. For routes that point to a Backend
15081 # Bucket, use `includedQueryParameters` to define which parameters should
15082 # be part of the cache key.
15083 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
15084 # The name=value pair will be used in the cache key Cloud CDN generates.
15085 #
15086 # Note: This setting is only applicable to routes that use a Backend
15087 # Service. It does not affect requests served by a Backend Bucket.
15088 # Attempting to set it on a route that points exclusively to Backend
15089 # Buckets will result in a configuration error. Up to 5 cookie names can be
15090 # specified.
15091 &quot;A String&quot;,
15092 ],
15093 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
15094 &quot;A String&quot;,
15095 ],
15096 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
15097 # parameters will be excluded. Either specify `includedQueryParameters`
15098 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
15099 # encoded and not treated as delimiters.
15100 &quot;A String&quot;,
15101 ],
15102 },
15103 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
15104 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
15105 &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
15106 # content. This is used to clamp the max-age (or Expires) value sent to the
15107 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
15108 # is used for the response max-age directive, along with a &quot;public&quot;
15109 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
15110 # clamps the max-age from the origin (if specified), or else sets the
15111 # response max-age directive to the lesser of the `clientTtl` and
15112 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
15113 # present. The maximum allowed value is 31,622,400s (1 year). If not
15114 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
15115 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
15116 # `USE_ORIGIN_HEADERS`.
15117 # as a count of seconds and fractions of seconds at nanosecond
15118 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15119 # or &quot;month&quot;. Range is approximately 10,000 years.
15120 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15121 # Durations less than one second are represented with a 0
15122 # `seconds` field and a positive `nanos` field. Must be from 0
15123 # to 999,999,999 inclusive.
15124 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15125 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15126 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15127 },
15128 &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
15129 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
15130 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
15131 # greater than that of `maxTtl`. When the `cacheMode` is set to
15132 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
15133 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
15134 # accessed objects may be evicted from the cache before the defined TTL. If
15135 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
15136 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
15137 # `USE_ORIGIN_HEADERS`.
15138 # as a count of seconds and fractions of seconds at nanosecond
15139 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15140 # or &quot;month&quot;. Range is approximately 10,000 years.
15141 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15142 # Durations less than one second are represented with a 0
15143 # `seconds` field and a positive `nanos` field. Must be from 0
15144 # to 999,999,999 inclusive.
15145 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15146 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15147 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15148 },
15149 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
15150 # attempt to set a max-age or s-maxage higher than this, or an Expires header
15151 # more than `maxTtl` seconds in the future will be capped at the value of
15152 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
15153 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
15154 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
15155 # Infrequently accessed objects may be evicted from the cache before the
15156 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
15157 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
15158 # mode.
15159 # as a count of seconds and fractions of seconds at nanosecond
15160 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15161 # or &quot;month&quot;. Range is approximately 10,000 years.
15162 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15163 # Durations less than one second are represented with a 0
15164 # `seconds` field and a positive `nanos` field. Must be from 0
15165 # to 999,999,999 inclusive.
15166 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15167 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15168 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15169 },
15170 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
15171 # to apply fine-grained caching for common errors or redirects.
15172 # This can reduce the load on your origin and improve end-user
15173 # experience by reducing response latency.
15174 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
15175 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
15176 # the specified response code that lack any Cache-Control, Expires, or
15177 # Pragma: no-cache directives. When the `cacheMode` is set to
15178 # `FORCE_CACHE_ALL`, negative caching applies to all responses
15179 # with the specified response code, and overrides any caching headers. By
15180 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
15181 #
15182 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
15183 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
15184 # * 405 (Method Not Found), 501 (Not Implemented): 60s
15185 #
15186 # These defaults can be overridden in `negativeCachingPolicy`.
15187 # If not specified, Cloud CDN applies negative caching by default.
15188 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
15189 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
15190 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
15191 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
15192 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
15193 # all response codes that you wish to cache. Cloud CDN will not apply any
15194 # default negative caching when a policy exists.
15195 { # Specify CDN TTLs for response error codes.
15196 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
15197 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
15198 # specified as values, and you cannot specify a status code more than
15199 # once.
15200 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
15201 # corresponding status code.
15202 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
15203 # objects may be evicted from the cache before the defined TTL.
15204 # as a count of seconds and fractions of seconds at nanosecond
15205 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15206 # or &quot;month&quot;. Range is approximately 10,000 years.
15207 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15208 # Durations less than one second are represented with a 0
15209 # `seconds` field and a positive `nanos` field. Must be from 0
15210 # to 999,999,999 inclusive.
15211 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15212 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15213 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15214 },
15215 },
15216 ],
15217 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
15218 # requests into a small number of requests to the origin. If not specified,
15219 # Cloud CDN applies request coalescing by default.
15220 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
15221 # content with the origin, or when an error is encountered when refreshing
15222 # the cache.
15223 # This setting defines the default &quot;max-stale&quot; duration for any cached
15224 # responses that do not specify a max-stale directive. Stale responses that
15225 # exceed the TTL configured here will not be served. The default limit
15226 # (max-stale) is 86400s (1 day), which will allow stale content to be
15227 # served up to this limit beyond the max-age (or s-maxage) of a cached
15228 # response.
15229 # The maximum allowed value is 604800 (1 week).
15230 # Set this to zero (0) to disable serve-while-stale.
15231 # as a count of seconds and fractions of seconds at nanosecond
15232 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15233 # or &quot;month&quot;. Range is approximately 10,000 years.
15234 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15235 # Durations less than one second are represented with a 0
15236 # `seconds` field and a positive `nanos` field. Must be from 0
15237 # to 999,999,999 inclusive.
15238 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15239 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15240 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15241 },
15242 },
15243 &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
15244 # information about the W3C recommendation for cross-origin resource sharing
15245 # (CORS), see Fetch API Living
15246 # Standard.
15247 #
15248 # Not supported when the URL map is bound to a target gRPC proxy.
15249 # information about the W3C recommendation for cross-origin resource sharing
15250 # (CORS), see Fetch API Living
15251 # Standard.
15252 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
15253 # indicates that
15254 # the actual request can include user credentials. This field translates to
15255 # the Access-Control-Allow-Credentials header.
15256 #
15257 # Default is false.
15258 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
15259 # header.
15260 &quot;A String&quot;,
15261 ],
15262 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
15263 # header.
15264 &quot;A String&quot;,
15265 ],
15266 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
15267 # more information, see regular expression syntax.
15268 #
15269 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
15270 #
15271 # Regular expressions can only be used when the loadBalancingScheme is
15272 # set to INTERNAL_SELF_MANAGED.
15273 &quot;A String&quot;,
15274 ],
15275 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
15276 #
15277 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
15278 &quot;A String&quot;,
15279 ],
15280 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
15281 # The default value is false, which indicates that the CORS
15282 # policy is in effect.
15283 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
15284 # header.
15285 &quot;A String&quot;,
15286 ],
15287 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
15288 # seconds. This field translates to the Access-Control-Max-Age
15289 # header.
15290 },
15291 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
15292 # the resiliency of clients to backend service failure. As part of fault
15293 # injection, when clients send requests to a backend service, delays can be
15294 # introduced by a load balancer on a percentage of requests before sending
15295 # those requests to the backend service. Similarly requests from clients can
15296 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
15297 # that are configured with a fault_injection_policy if:
15298 # 1. The traffic is generated by fault injection AND
15299 # 2. The fault injection is not a delay fault injection.
15300 # Fault injection is not supported with the classic Application Load Balancer
15301 # . To see which load balancers support fault injection,
15302 # see Load
15303 # balancing: Routing and traffic management features.
15304 # the resiliency of clients to backend service failure. As part of fault
15305 # injection, when clients send requests to a backend service, delays can be
15306 # introduced by the load balancer on a percentage of requests before sending
15307 # those request to the backend service. Similarly requests from clients can be
15308 # aborted by the load balancer for a percentage of requests.
15309 &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
15310 # injection.
15311 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
15312 #
15313 # The value must be from 200 to 599 inclusive.
15314 #
15315 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
15316 # according to this
15317 # mapping table. HTTP status 200 is mapped to gRPC status
15318 # UNKNOWN. Injecting an OK status is currently not supported by
15319 # Traffic Director.
15320 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
15321 # that is aborted as part of fault injection.
15322 #
15323 # The value must be from 0.0 to 100.0 inclusive.
15324 },
15325 &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
15326 # injection, before being sent to a backend service.
15327 # request to the backend service as part of fault injection.
15328 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
15329 # as a count of seconds and fractions of seconds at nanosecond
15330 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15331 # or &quot;month&quot;. Range is approximately 10,000 years.
15332 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15333 # Durations less than one second are represented with a 0
15334 # `seconds` field and a positive `nanos` field. Must be from 0
15335 # to 999,999,999 inclusive.
15336 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15337 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15338 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15339 },
15340 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
15341 # which a delay is introduced as part of fault injection.
15342 #
15343 # The value must be from 0.0 to 100.0 inclusive.
15344 },
15345 },
15346 &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
15347 # Global EXTERNAL_MANAGED load balancer schemes.
15348 # Either Cloud CDN must be enabled on the backend service or backend bucket
15349 # serving the route, or cache policy must be configured on the same route
15350 # dynamically processes and delivers images from the network edge.
15351 # Image Optimization is only available for Global External Application Load
15352 # Balancers.
15353 # Either Cloud CDN must be enabled on the backend service or backend bucket
15354 # serving the route, or cache policy must be configured on the same route.
15355 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
15356 },
15357 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
15358 # Unlike the timeout field where the timeout duration starts
15359 # from the time the request has been fully processed (known as*end-of-stream*),
15360 # the duration in this field is computed from the beginning of the stream
15361 # until the response has been processed, including all retries. A
15362 # stream that does not complete in this duration is closed.
15363 #
15364 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
15365 # with the route.
15366 #
15367 # This field is only allowed if the Url map is used with backend services
15368 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
15369 # as a count of seconds and fractions of seconds at nanosecond
15370 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15371 # or &quot;month&quot;. Range is approximately 10,000 years.
15372 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15373 # Durations less than one second are represented with a 0
15374 # `seconds` field and a positive `nanos` field. Must be from 0
15375 # to 999,999,999 inclusive.
15376 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15377 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15378 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15379 },
15380 &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
15381 # are shadowed to a separate mirrored backend service. The load balancer does
15382 # not wait for responses from the shadow service. Before sending traffic
15383 # to the shadow service, the host / authority header is suffixed with-shadow.
15384 #
15385 # Not supported when the URL map is bound to a target gRPC proxy that
15386 # has the validateForProxyless field set to true.
15387 # are shadowed to a separate mirrored backend service. The load balancer
15388 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
15389 # to the shadow service, the host or authority header is suffixed with-shadow.
15390 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
15391 # mirrored to.
15392 #
15393 # The backend service configured for a mirroring
15394 # policy must reference backends that are of the same type as the original
15395 # backend service matched in the URL map.
15396 #
15397 # Serverless NEG backends are not currently supported as a mirrored
15398 # backend service.
15399 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
15400 },
15401 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
15402 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
15403 # If not specified, defaults to 1.
15404 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
15405 #
15406 # If not specified, will use the timeout set in theHttpRouteAction field.
15407 # If timeout in the HttpRouteAction field is not set, this field
15408 # uses the largest timeout
15409 # among all backend services associated with the route.
15410 #
15411 # Not supported when the URL map is bound to a target gRPC proxy that
15412 # has the validateForProxyless field set to true.
15413 # as a count of seconds and fractions of seconds at nanosecond
15414 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15415 # or &quot;month&quot;. Range is approximately 10,000 years.
15416 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15417 # Durations less than one second are represented with a 0
15418 # `seconds` field and a positive `nanos` field. Must be from 0
15419 # to 999,999,999 inclusive.
15420 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15421 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15422 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15423 },
15424 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
15425 # values are:
15426 #
15427 # - 5xx: retry is attempted if the instance or endpoint
15428 # responds with any 5xx response code, or if the instance or
15429 # endpoint does not respond at all. For example, disconnects, reset, read
15430 # timeout, connection failure, and refused streams.
15431 # - gateway-error: Similar to 5xx, but only
15432 # applies to response codes 502, 503 or504.
15433 # - connect-failure: a retry is attempted on failures
15434 # connecting to the instance or endpoint. For example, connection
15435 # timeouts.
15436 # - retriable-4xx: a retry is attempted if the instance
15437 # or endpoint responds with a 4xx response code.
15438 # The only error that you can retry is error code 409.
15439 # - refused-stream: a retry is attempted if the instance
15440 # or endpoint resets the stream with a REFUSED_STREAM error
15441 # code. This reset type indicates that it is safe to retry.
15442 # - cancelled: a retry is attempted if the gRPC status
15443 # code in the response header is set to cancelled.
15444 # - deadline-exceeded: a retry is attempted if the gRPC
15445 # status code in the response header is set todeadline-exceeded.
15446 # - internal: a retry is attempted if the gRPC
15447 # status code in the response header is set tointernal.
15448 # - resource-exhausted: a retry is attempted if the gRPC
15449 # status code in the response header is set toresource-exhausted.
15450 # - unavailable: a retry is attempted if the gRPC
15451 # status code in the response header is set tounavailable.
15452 #
15453 # Only the following codes are supported when the URL map is bound to
15454 # target gRPC proxy that has validateForProxyless field set to true.
15455 #
15456 # - cancelled
15457 # - deadline-exceeded
15458 # - internal
15459 # - resource-exhausted
15460 # - unavailable
15461 &quot;A String&quot;,
15462 ],
15463 },
15464 &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
15465 # time the request has been fully processed (known as *end-of-stream*)
15466 # up until the response has been processed. Timeout includes
15467 # all retries.
15468 #
15469 # If not specified, this field uses the largest timeout among all backend
15470 # services associated with the route.
15471 #
15472 # Not supported when the URL map is bound to a target gRPC proxy that
15473 # has validateForProxyless field set to true.
15474 # as a count of seconds and fractions of seconds at nanosecond
15475 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
15476 # or &quot;month&quot;. Range is approximately 10,000 years.
15477 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
15478 # Durations less than one second are represented with a 0
15479 # `seconds` field and a positive `nanos` field. Must be from 0
15480 # to 999,999,999 inclusive.
15481 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
15482 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
15483 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
15484 },
15485 &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
15486 # to the matched service.
15487 #
15488 # urlRewrite is the only action supported in UrlMaps
15489 # for classic Application Load Balancers.
15490 #
15491 # Not supported when the URL map is bound to a target gRPC proxy that
15492 # has the validateForProxyless field set to true.
15493 # backend service.
15494 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
15495 # host header is replaced with contents of hostRewrite.
15496 #
15497 # The value must be from 1 to 255 characters.
15498 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
15499 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
15500 #
15501 # The value must be from 1 to 1024 characters.
15502 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
15503 # header) using the HTTP template syntax.
15504 #
15505 # A corresponding
15506 # path_template_match must be specified. Any template variables must exist in
15507 # the path_template_match field.
15508 #
15509 #
15510 # - -At least one variable must be specified in the path_template_match
15511 # field
15512 # - You can omit variables from the rewritten URL
15513 # - The * and ** operators cannot be matched
15514 # unless they have a corresponding variable name - e.g.
15515 # {format=*} or {var=**}.
15516 #
15517 # For example, a path_template_match of /static/{format=**}
15518 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
15519 # rewrite, so that /{country}/{format}/{suffix=**} can be
15520 # rewritten as /content/{format}/{country}/{suffix}.
15521 #
15522 # At least
15523 # one non-empty routeRules[].matchRules[].path_template_match is
15524 # required.
15525 #
15526 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
15527 },
15528 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
15529 # occurs. The weights determine the fraction of traffic that flows to
15530 # their corresponding backend service. If all traffic needs to
15531 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
15532 #
15533 # After a backend service is identified and before forwarding
15534 # the request to
15535 # the backend service, advanced routing actions such as URL rewrites and
15536 # header transformations are applied depending on additional settings
15537 # specified in this HttpRouteAction.
15538 { # In contrast to a single BackendService in
15539 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
15540 # multiple backend services. The volume of traffic for each
15541 # backend service is proportional to the weight specified
15542 # in each WeightedBackendService
15543 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
15544 # resource. Before
15545 # forwarding the request to backendService, the load balancer
15546 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
15547 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
15548 # effect for the selected backendService.
15549 #
15550 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
15551 #
15552 # headerAction is not supported for load balancers that have
15553 # their loadBalancingScheme set to EXTERNAL.
15554 #
15555 # Not supported when the URL map is bound to a target gRPC proxy that
15556 # has validateForProxyless field set to true.
15557 # the request is passed along to the selected backendService.
15558 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
15559 { # Specification determining how headers are added to requests or responses.
15560 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
15561 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
15562 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
15563 # that already
15564 # exist for the header. If true, headerValue is set for the
15565 # header, discarding any values that were set for that header.
15566 #
15567 # The default value is true,
15568 # unless a variable is present in headerValue,
15569 # in which case the default value is false.
15570 # .
15571 },
15572 ],
15573 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
15574 # request before forwarding the request to the backendService.
15575 &quot;A String&quot;,
15576 ],
15577 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
15578 # client.
15579 { # Specification determining how headers are added to requests or responses.
15580 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
15581 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
15582 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
15583 # that already
15584 # exist for the header. If true, headerValue is set for the
15585 # header, discarding any values that were set for that header.
15586 #
15587 # The default value is true,
15588 # unless a variable is present in headerValue,
15589 # in which case the default value is false.
15590 # .
15591 },
15592 ],
15593 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
15594 # response before sending the response back to the client.
15595 &quot;A String&quot;,
15596 ],
15597 },
15598 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
15599 # computed asweight / (sum of all weightedBackendService weights in routeAction).
15600 #
15601 # The selection of a backend service is determined only for new traffic.
15602 # Once a user&#x27;s request has been directed to a backend service,
15603 # subsequent requests are sent to the same backend service as
15604 # determined by the backend service&#x27;s session affinity policy.
15605 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
15606 # splitting. If you do, the weighted traffic splitting configuration takes
15607 # precedence.
15608 #
15609 # The value must be from 0 to 1000.
15610 },
15611 ],
15612 },
15613 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
15614 # is directed if this rule is matched. If routeAction is
15615 # also specified, advanced routing actions, such as URL rewrites,
15616 # take effect before sending the request to the backend.
15617 #
15618 #
15619 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
15620 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
15621 # specified by urlRedirect.
15622 #
15623 #
15624 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
15625 #
15626 #
15627 # Not supported when the URL map is bound to a target gRPC proxy.
15628 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
15629 # was supplied in the request.
15630 #
15631 # The value must be from 1 to 255
15632 # characters.
15633 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
15634 # set to HTTPS.
15635 # If set to false, the URL scheme of the redirected request
15636 # remains the same as that of the request.
15637 #
15638 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
15639 #
15640 # The default is set to false.
15641 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
15642 # that was supplied in the request.
15643 #
15644 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
15645 # supplied, the path of the original request is used for the redirect.
15646 #
15647 # The value must be from 1 to 1024 characters.
15648 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
15649 # the HttpRouteRuleMatch, retaining the remaining portion
15650 # of the URL before redirecting the request.
15651 #
15652 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
15653 # supplied, the path of the original request is used for the redirect.
15654 #
15655 # The value must be from 1 to 1024 characters.
15656 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
15657 #
15658 # Supported values are:
15659 #
15660 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
15661 # to 301.
15662 # - FOUND, which corresponds to 302.
15663 # - SEE_OTHER which corresponds to 303.
15664 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
15665 # method is retained.
15666 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
15667 # method is retained.
15668 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
15669 # URL is
15670 # removed before redirecting the request. If set to false, the
15671 # query portion of the original URL is retained.
15672 #
15673 # The default is set to false.
15674 },
15675 },
15676 ],
15677 },
15678 ],
15679 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the regional URL map resides.
15680 # This field is not applicable to global URL maps.
15681 # You must specify this field as part of the HTTP request URL. It is
15682 # not settable as a field in the request body.
15683 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
15684 &quot;status&quot;: { # [Output Only] The status of the URL map. # Output only. [Output Only] The status of the URL map.
15685 &quot;quotaUsage&quot;: { # Message representing the quota usage for a UrlMap. # Output only. Summary of quota usage for given UrlMap.
15686 &quot;forwardingRules&quot;: 42, # Output only. The number of forwarding rules that uses this UrlMap.
15687 &quot;units&quot;: &quot;A String&quot;, # Output only. The number of quota units calculated for this UrlMap.
15688 },
15689 },
15690 &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
15691 # maximum of 100 tests per UrlMap.
15692 #
15693 # Not supported when the URL map is bound to a target gRPC proxy that
15694 # has validateForProxyless field set to true.
15695 { # Message for the expected URL mappings.
15696 &quot;description&quot;: &quot;A String&quot;, # Description of this test case.
15697 &quot;expectedOutputUrl&quot;: &quot;A String&quot;, # The expected output URL evaluated by the load balancer
15698 # containing the scheme, host, path and query parameters.
15699 #
15700 # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
15701 # the load balancer to backends. For rules with urlRewrite,
15702 # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
15703 #
15704 # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer&#x27;s
15705 # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
15706 # If urlRedirect specifies strip_query, the test
15707 # passes only if expectedOutputUrl does not contain any query
15708 # parameters.
15709 #
15710 # expectedOutputUrl is optional whenservice is specified.
15711 &quot;expectedRedirectResponseCode&quot;: 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
15712 # load balancer&#x27;s redirect response.
15713 #
15714 # expectedRedirectResponseCode cannot be set whenservice is set.
15715 &quot;headers&quot;: [ # HTTP headers for this request. If headers contains
15716 # a host header, then host must also match the header value.
15717 { # HTTP headers used in UrlMapTests.
15718 &quot;name&quot;: &quot;A String&quot;, # Header name.
15719 &quot;value&quot;: &quot;A String&quot;, # Header value.
15720 },
15721 ],
15722 &quot;host&quot;: &quot;A String&quot;, # Host portion of the URL. If headers contains a host header,
15723 # then host must also match the header value.
15724 &quot;path&quot;: &quot;A String&quot;, # Path portion of the URL.
15725 &quot;service&quot;: &quot;A String&quot;, # Expected BackendService or BackendBucket resource
15726 # the given URL should be mapped to.
15727 #
15728 # The service field cannot
15729 # be set if expectedRedirectResponseCode is set.
15730 },
15731 ],
15732 }
15733
15734 requestId: string, begin_interface: MixerMutationRequestBuilder
15735 Request ID to support idempotency.
15736 x__xgafv: string, V1 error format.
15737 Allowed values
15738 1 - v1 error format
15739 2 - v2 error format
15740
15741 Returns:
15742 An object of the form:
15743
15744 { # Represents an Operation resource.
15745 #
15746 # Google Compute Engine has three Operation resources:
15747 #
15748 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
15749 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
15750 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
15751 #
15752 # You can use an operation resource to manage asynchronous API requests.
15753 # For more information, readHandling
15754 # API responses.
15755 #
15756 # Operations can be global, regional or zonal.
15757 #
15758 # - For global operations, use the `globalOperations`
15759 # resource.
15760 # - For regional operations, use the
15761 # `regionOperations` resource.
15762 # - For zonal operations, use
15763 # the `zoneOperations` resource.
15764 #
15765 #
15766 #
15767 # For more information, read
15768 # Global, Regional, and Zonal Resources.
15769 #
15770 # Note that completed Operation resources have a limited
15771 # retention period.
15772 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
15773 # Not present otherwise.
15774 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
15775 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
15776 # set when the operation is created.
15777 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
15778 # text format.
15779 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
15780 # this field will be populated.
15781 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
15782 # operation.
15783 {
15784 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
15785 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
15786 # details. There is a set of defined message types to use for providing
15787 # details.The syntax depends on the error code. For example,
15788 # QuotaExceededInfo will have details when the error code is
15789 # QUOTA_EXCEEDED.
15790 {
15791 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
15792 #
15793 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
15794 # is not enabled:
15795 #
15796 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
15797 # &quot;domain&quot;: &quot;googleapis.com&quot;
15798 # &quot;metadata&quot;: {
15799 # &quot;resource&quot;: &quot;projects/123&quot;,
15800 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
15801 # }
15802 # }
15803 #
15804 # This response indicates that the pubsub.googleapis.com API is not enabled.
15805 #
15806 # Example of an error that is returned when attempting to create a Spanner
15807 # instance in a region that is out of stock:
15808 #
15809 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
15810 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
15811 # &quot;metadata&quot;: {
15812 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
15813 # }
15814 # }
15815 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
15816 # is typically the registered service name of the tool or product that
15817 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
15818 # generated by some common infrastructure, the error domain must be a
15819 # globally unique value that identifies the infrastructure. For Google API
15820 # infrastructure, the error domain is &quot;googleapis.com&quot;.
15821 &quot;metadatas&quot;: { # Additional structured details about this error.
15822 #
15823 # Keys must match a regular expression of `a-z+` but should
15824 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
15825 # length. When identifying the current value of an exceeded limit, the units
15826 # should be contained in the key, not the value. For example, rather than
15827 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
15828 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
15829 # instances that can be created in a single (batch) request.
15830 &quot;a_key&quot;: &quot;A String&quot;,
15831 },
15832 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
15833 # proximate cause of the error. Error reasons are unique within a particular
15834 # domain of errors. This should be at most 63 characters and match a
15835 # regular expression of `A-Z+[A-Z0-9]`, which represents
15836 # UPPER_SNAKE_CASE.
15837 },
15838 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
15839 #
15840 # For example, if a quota check failed with an error indicating the calling
15841 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
15842 # directly to the right place in the developer console to flip the bit.
15843 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
15844 { # Describes a URL link.
15845 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
15846 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
15847 },
15848 ],
15849 },
15850 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
15851 # which can be attached to an RPC error.
15852 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
15853 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
15854 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
15855 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
15856 },
15857 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
15858 &quot;dimensions&quot;: { # The map holding related quota dimensions.
15859 &quot;a_key&quot;: &quot;A String&quot;,
15860 },
15861 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
15862 # type or metric.
15863 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
15864 # or metric.
15865 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
15866 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
15867 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
15868 },
15869 },
15870 ],
15871 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
15872 # This property is optional.
15873 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
15874 },
15875 ],
15876 },
15877 &quot;getVersionOperationMetadata&quot;: {
15878 &quot;inlineSbomInfo&quot;: {
15879 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
15880 # appropriate identifiers.
15881 &quot;a_key&quot;: &quot;A String&quot;,
15882 },
15883 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
15884 # identifiers.
15885 &quot;a_key&quot;: &quot;A String&quot;,
15886 },
15887 },
15888 },
15889 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
15890 # message that was returned, such as `NOT FOUND`.
15891 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
15892 # status code that was returned. For example, a `404` means the
15893 # resource was not found.
15894 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
15895 # defined by the server.
15896 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
15897 # This value is inRFC3339
15898 # text format.
15899 &quot;instancesBulkInsertOperationMetadata&quot;: {
15900 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
15901 # Example key: zones/us-central1-a
15902 &quot;a_key&quot;: {
15903 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
15904 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
15905 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
15906 # error.
15907 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
15908 # if the flow is rolling forward or rolling back.
15909 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
15910 },
15911 },
15912 },
15913 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
15914 # Operation resources.
15915 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
15916 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
15917 # group of operations results from a `bulkInsert` API request.
15918 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
15919 # `update`, or `delete`, and so on.
15920 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
15921 # There is no requirement that this be linear or support any granularity of
15922 # operations. This should not be used to guess when the operation will be
15923 # complete. This number should monotonically increase as the operation
15924 # progresses.
15925 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
15926 # applicable when performing regional operations.
15927 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
15928 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
15929 # this field will contain information on all underlying zonal actions and
15930 # their state.
15931 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
15932 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
15933 # Example key: zones/us-central1-a
15934 &quot;a_key&quot;: {
15935 &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
15936 # populated.
15937 # different programming environments, including REST APIs and RPC APIs. It is
15938 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
15939 # three pieces of data: error code, error message, and error details.
15940 #
15941 # You can find out more about this error model and how to work with it in the
15942 # [API Design Guide](https://cloud.google.com/apis/design/errors).
15943 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
15944 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
15945 # message types for APIs to use.
15946 {
15947 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
15948 },
15949 ],
15950 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
15951 # user-facing error message should be localized and sent in the
15952 # google.rpc.Status.details field, or localized by the client.
15953 },
15954 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
15955 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
15956 },
15957 },
15958 },
15959 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
15960 # This value is inRFC3339
15961 # text format.
15962 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
15963 # following:
15964 # `PENDING`, `RUNNING`, or `DONE`.
15965 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
15966 # operation.
15967 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
15968 # of the target resource.
15969 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
15970 # operations related to creating a snapshot, this points to the disk
15971 # that the snapshot was created from.
15972 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
15973 # `[email protected]` or
15974 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
15975 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
15976 # operation, this field will be populated.
15977 {
15978 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
15979 # Engine returns NO_RESULTS_ON_PAGE if there
15980 # are no results in the response.
15981 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
15982 # value format. For example:
15983 #
15984 # &quot;data&quot;: [
15985 # {
15986 # &quot;key&quot;: &quot;scope&quot;,
15987 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
15988 # }
15989 {
15990 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
15991 # returned. For example, for warnings where there are no results in a list
15992 # request for a particular zone, this key might be scope and
15993 # the key value might be the zone name. Other examples might be a key
15994 # indicating a deprecated resource and a suggested replacement, or a
15995 # warning about invalid network settings (for example, if an instance
15996 # attempts to perform IP forwarding but is not enabled for IP forwarding).
15997 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
15998 },
15999 ],
16000 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
16001 },
16002 ],
16003 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
16004 # applicable when performing per-zone operations.
16005 }</pre>
16006 </div>
16007
16008 <div class="method">
16009 <code class="details" id="testIamPermissions">testIamPermissions(project, region, resource, body=None, x__xgafv=None)</code>
16010 <pre>Returns permissions that a caller has on the specified resource.
16011
16012 Args:
16013 project: string, Project ID for this request. (required)
16014 region: string, The name of the region for this request. (required)
16015 resource: string, Name or id of the resource for this request. (required)
16016 body: object, The request body.
16017 The object takes the form of:
16018
16019 {
16020 &quot;permissions&quot;: [ # The set of permissions to check for the &#x27;resource&#x27;. Permissions with
16021 # wildcards (such as &#x27;*&#x27; or &#x27;storage.*&#x27;) are not allowed.
16022 &quot;A String&quot;,
16023 ],
16024 }
16025
16026 x__xgafv: string, V1 error format.
16027 Allowed values
16028 1 - v1 error format
16029 2 - v2 error format
16030
16031 Returns:
16032 An object of the form:
16033
16034 {
16035 &quot;permissions&quot;: [ # A subset of `TestPermissionsRequest.permissions` that the caller is
16036 # allowed.
16037 &quot;A String&quot;,
16038 ],
16039 }</pre>
16040 </div>
16041
16042 <div class="method">
16043 <code class="details" id="update">update(project, region, urlMap, body=None, requestId=None, x__xgafv=None)</code>
16044 <pre>Updates the specified UrlMap resource with the data included in the
16045 request.
16046
16047 Args:
16048 project: string, Project ID for this request. (required)
16049 region: string, Name of the region scoping this request. (required)
16050 urlMap: string, Name of the UrlMap resource to update. (required)
16051 body: object, The request body.
16052 The object takes the form of:
16053
16054 { # Represents a URL Map resource.
16055 #
16056 # Compute Engine has two URL Map resources:
16057 #
16058 # * [Global](/compute/docs/reference/rest/beta/urlMaps)
16059 # * [Regional](/compute/docs/reference/rest/beta/regionUrlMaps)
16060 #
16061 # A URL map resource is a component of certain types of cloud load balancers
16062 # and Traffic Director:
16063 #
16064 # * urlMaps are used by global external Application Load
16065 # Balancers, classic Application Load Balancers, and cross-region internal
16066 # Application Load Balancers.
16067 # * regionUrlMaps are used by internal Application Load Balancers,
16068 # regional external Application Load Balancers and regional internal
16069 # Application Load Balancers.
16070 #
16071 # For a list of supported URL map features by the load balancer type, see the
16072 # Load balancing features: Routing and traffic management table.
16073 #
16074 # For a list of supported URL map features for Traffic Director, see the
16075 # Traffic Director features: Routing and traffic management table.
16076 #
16077 # This resource defines mappings from hostnames and URL paths to either a
16078 # backend service or a backend bucket.
16079 #
16080 # To use the global urlMaps resource, the backend service must
16081 # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
16082 # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
16083 # information, read URL
16084 # Map Concepts.
16085 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
16086 # text format.
16087 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
16088 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
16089 #
16090 # This policy takes
16091 # effect at the load balancer level and applies only when no policy has been
16092 # defined for the error code at lower levels like PathMatcher, RouteRule and
16093 # PathRule within this UrlMap.
16094 #
16095 # For example, consider a UrlMap with the
16096 # following configuration:
16097 #
16098 #
16099 # - defaultCustomErrorResponsePolicy containing policies for
16100 # responding to 5xx and 4xx errors
16101 # - A PathMatcher configured for *.example.com has
16102 # defaultCustomErrorResponsePolicy for 4xx.
16103 #
16104 # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
16105 # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
16106 # a request that does not match any host in *.example.com such
16107 # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
16108 # takes effect.
16109 #
16110 # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
16111 # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
16112 # a retry, if load balancer is successful in reaching the
16113 # service, the defaultCustomErrorResponsePolicy is ignored and
16114 # the response from the service is returned to the client.
16115 #
16116 # defaultCustomErrorResponsePolicy is supported only for
16117 # global external Application Load Balancers.
16118 # backend service or backend bucket responds with an error.
16119 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
16120 #
16121 # In a given policy, if you specify rules for both a range of error codes
16122 # as well as rules for specific error codes then rules with specific error
16123 # codes have a higher priority. For example, assume that you configure a rule
16124 # for 401 (Un-authorized) code, and another for all 4 series
16125 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
16126 # However if the backend service returns a 403, the rule for4xx takes effect.
16127 { # Specifies the mapping between the response code that will be returned along
16128 # with the custom error content and the response code returned by the backend
16129 # service.
16130 &quot;matchResponseCodes&quot;: [ # Valid values include:
16131 #
16132 #
16133 # - A number between 400 and 599: For example
16134 # 401 or 503, in which case the load balancer
16135 # applies the policy if the error code exactly matches this value.
16136 # - 5xx: Load Balancer will apply the policy if the
16137 # backend service responds with any response code in the range of
16138 # 500 to 599.
16139 # - 4xx: Load
16140 # Balancer will apply the policy if the backend service responds with any
16141 # response code in the range of 400 to
16142 # 499.
16143 #
16144 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
16145 &quot;A String&quot;,
16146 ],
16147 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
16148 # error content. If overrideResponseCode is not supplied, the
16149 # same response code returned by the original backend bucket or backend
16150 # service is returned to the client.
16151 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
16152 #
16153 # path must start
16154 # with a leading slash. path cannot have trailing slashes.
16155 #
16156 # If the file is not available in backendBucket or the
16157 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
16158 #
16159 # The value must
16160 # be from 1 to 1024 characters
16161 },
16162 ],
16163 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
16164 # contains the custom error content. Examples are:
16165 #
16166 #
16167 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
16168 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
16169 # - global/backendBuckets/myBackendBucket
16170 #
16171 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
16172 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
16173 #
16174 # If load balancer cannot reach
16175 # the backendBucket, a simple Not Found Error will
16176 # be returned, with the original response code (oroverrideResponseCode if configured).
16177 #
16178 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
16179 },
16180 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
16181 # hostRules match. The load balancer performs advanced routing
16182 # actions, such as URL rewrites and header transformations, before forwarding
16183 # the request to the selected backend.
16184 #
16185 #
16186 # Only one of defaultUrlRedirect, defaultService
16187 # or defaultRouteAction.weightedBackendService can be set.
16188 #
16189 #
16190 # URL maps for classic Application Load Balancers only support
16191 # the urlRewrite action within defaultRouteAction.
16192 #
16193 #
16194 # defaultRouteAction has no effect when the URL map is bound
16195 # to a target gRPC proxy that has the validateForProxyless field
16196 # set to true.
16197 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
16198 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
16199 # property must be specified. This policy cannot be specified if any target
16200 # backend has Identity-Aware Proxy enabled.
16201 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
16202 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
16203 # header names can be specified. The cache is bypassed for all `cacheMode`
16204 # values.
16205 &quot;A String&quot;,
16206 ],
16207 &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
16208 # on the backend type: for Backend Services, the complete request URI is
16209 # used; for Backend Buckets, the request URI is used without the protocol or
16210 # host, and only query parameters known to Cloud Storage are included.
16211 # Policy defined on Route Action.
16212 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
16213 # parameters will be included. Either specify `excludedQueryParameters`
16214 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
16215 # encoded and not treated as delimiters.
16216 #
16217 # Note: This field applies to routes that use backend services. Attempting
16218 # to set it on a route that points exclusively to Backend Buckets will
16219 # result in a configuration error. For routes that point to a Backend
16220 # Bucket, use `includedQueryParameters` to define which parameters should
16221 # be part of the cache key.
16222 &quot;A String&quot;,
16223 ],
16224 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
16225 #
16226 # Note: This setting is only applicable to routes that use a Backend
16227 # Service. It does not affect requests served by a Backend Bucket, as the
16228 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
16229 # it on a route that points exclusively to Backend Buckets will result in a
16230 # configuration error.
16231 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
16232 #
16233 # Note: This setting is only applicable to routes that use a Backend
16234 # Service. It does not affect requests served by a Backend Bucket, as the
16235 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
16236 # set on a route that points exclusively to Backend Buckets will result in
16237 # a configuration error.
16238 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
16239 # `includedQueryParameters` and `excludedQueryParameters`. If neither
16240 # is set, the entire query string will be included. If false, the query
16241 # string will be excluded from the cache key entirely.
16242 #
16243 # Note: This field applies to routes that use backend services. Attempting
16244 # to set it on a route that points exclusively to Backend Buckets will
16245 # result in a configuration error. For routes that point to a Backend
16246 # Bucket, use `includedQueryParameters` to define which parameters should
16247 # be part of the cache key.
16248 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
16249 # The name=value pair will be used in the cache key Cloud CDN generates.
16250 #
16251 # Note: This setting is only applicable to routes that use a Backend
16252 # Service. It does not affect requests served by a Backend Bucket.
16253 # Attempting to set it on a route that points exclusively to Backend
16254 # Buckets will result in a configuration error. Up to 5 cookie names can be
16255 # specified.
16256 &quot;A String&quot;,
16257 ],
16258 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
16259 &quot;A String&quot;,
16260 ],
16261 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
16262 # parameters will be excluded. Either specify `includedQueryParameters`
16263 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
16264 # encoded and not treated as delimiters.
16265 &quot;A String&quot;,
16266 ],
16267 },
16268 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
16269 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
16270 &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
16271 # content. This is used to clamp the max-age (or Expires) value sent to the
16272 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
16273 # is used for the response max-age directive, along with a &quot;public&quot;
16274 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
16275 # clamps the max-age from the origin (if specified), or else sets the
16276 # response max-age directive to the lesser of the `clientTtl` and
16277 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
16278 # present. The maximum allowed value is 31,622,400s (1 year). If not
16279 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
16280 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
16281 # `USE_ORIGIN_HEADERS`.
16282 # as a count of seconds and fractions of seconds at nanosecond
16283 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16284 # or &quot;month&quot;. Range is approximately 10,000 years.
16285 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16286 # Durations less than one second are represented with a 0
16287 # `seconds` field and a positive `nanos` field. Must be from 0
16288 # to 999,999,999 inclusive.
16289 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16290 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16291 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16292 },
16293 &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
16294 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
16295 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
16296 # greater than that of `maxTtl`. When the `cacheMode` is set to
16297 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
16298 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
16299 # accessed objects may be evicted from the cache before the defined TTL. If
16300 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
16301 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
16302 # `USE_ORIGIN_HEADERS`.
16303 # as a count of seconds and fractions of seconds at nanosecond
16304 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16305 # or &quot;month&quot;. Range is approximately 10,000 years.
16306 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16307 # Durations less than one second are represented with a 0
16308 # `seconds` field and a positive `nanos` field. Must be from 0
16309 # to 999,999,999 inclusive.
16310 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16311 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16312 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16313 },
16314 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
16315 # attempt to set a max-age or s-maxage higher than this, or an Expires header
16316 # more than `maxTtl` seconds in the future will be capped at the value of
16317 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
16318 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
16319 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
16320 # Infrequently accessed objects may be evicted from the cache before the
16321 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
16322 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
16323 # mode.
16324 # as a count of seconds and fractions of seconds at nanosecond
16325 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16326 # or &quot;month&quot;. Range is approximately 10,000 years.
16327 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16328 # Durations less than one second are represented with a 0
16329 # `seconds` field and a positive `nanos` field. Must be from 0
16330 # to 999,999,999 inclusive.
16331 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16332 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16333 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16334 },
16335 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
16336 # to apply fine-grained caching for common errors or redirects.
16337 # This can reduce the load on your origin and improve end-user
16338 # experience by reducing response latency.
16339 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
16340 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
16341 # the specified response code that lack any Cache-Control, Expires, or
16342 # Pragma: no-cache directives. When the `cacheMode` is set to
16343 # `FORCE_CACHE_ALL`, negative caching applies to all responses
16344 # with the specified response code, and overrides any caching headers. By
16345 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
16346 #
16347 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
16348 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
16349 # * 405 (Method Not Found), 501 (Not Implemented): 60s
16350 #
16351 # These defaults can be overridden in `negativeCachingPolicy`.
16352 # If not specified, Cloud CDN applies negative caching by default.
16353 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
16354 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
16355 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
16356 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
16357 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
16358 # all response codes that you wish to cache. Cloud CDN will not apply any
16359 # default negative caching when a policy exists.
16360 { # Specify CDN TTLs for response error codes.
16361 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
16362 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
16363 # specified as values, and you cannot specify a status code more than
16364 # once.
16365 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
16366 # corresponding status code.
16367 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
16368 # objects may be evicted from the cache before the defined TTL.
16369 # as a count of seconds and fractions of seconds at nanosecond
16370 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16371 # or &quot;month&quot;. Range is approximately 10,000 years.
16372 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16373 # Durations less than one second are represented with a 0
16374 # `seconds` field and a positive `nanos` field. Must be from 0
16375 # to 999,999,999 inclusive.
16376 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16377 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16378 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16379 },
16380 },
16381 ],
16382 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
16383 # requests into a small number of requests to the origin. If not specified,
16384 # Cloud CDN applies request coalescing by default.
16385 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
16386 # content with the origin, or when an error is encountered when refreshing
16387 # the cache.
16388 # This setting defines the default &quot;max-stale&quot; duration for any cached
16389 # responses that do not specify a max-stale directive. Stale responses that
16390 # exceed the TTL configured here will not be served. The default limit
16391 # (max-stale) is 86400s (1 day), which will allow stale content to be
16392 # served up to this limit beyond the max-age (or s-maxage) of a cached
16393 # response.
16394 # The maximum allowed value is 604800 (1 week).
16395 # Set this to zero (0) to disable serve-while-stale.
16396 # as a count of seconds and fractions of seconds at nanosecond
16397 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16398 # or &quot;month&quot;. Range is approximately 10,000 years.
16399 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16400 # Durations less than one second are represented with a 0
16401 # `seconds` field and a positive `nanos` field. Must be from 0
16402 # to 999,999,999 inclusive.
16403 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16404 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16405 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16406 },
16407 },
16408 &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
16409 # information about the W3C recommendation for cross-origin resource sharing
16410 # (CORS), see Fetch API Living
16411 # Standard.
16412 #
16413 # Not supported when the URL map is bound to a target gRPC proxy.
16414 # information about the W3C recommendation for cross-origin resource sharing
16415 # (CORS), see Fetch API Living
16416 # Standard.
16417 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
16418 # indicates that
16419 # the actual request can include user credentials. This field translates to
16420 # the Access-Control-Allow-Credentials header.
16421 #
16422 # Default is false.
16423 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
16424 # header.
16425 &quot;A String&quot;,
16426 ],
16427 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
16428 # header.
16429 &quot;A String&quot;,
16430 ],
16431 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
16432 # more information, see regular expression syntax.
16433 #
16434 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
16435 #
16436 # Regular expressions can only be used when the loadBalancingScheme is
16437 # set to INTERNAL_SELF_MANAGED.
16438 &quot;A String&quot;,
16439 ],
16440 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
16441 #
16442 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
16443 &quot;A String&quot;,
16444 ],
16445 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
16446 # The default value is false, which indicates that the CORS
16447 # policy is in effect.
16448 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
16449 # header.
16450 &quot;A String&quot;,
16451 ],
16452 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
16453 # seconds. This field translates to the Access-Control-Max-Age
16454 # header.
16455 },
16456 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
16457 # the resiliency of clients to backend service failure. As part of fault
16458 # injection, when clients send requests to a backend service, delays can be
16459 # introduced by a load balancer on a percentage of requests before sending
16460 # those requests to the backend service. Similarly requests from clients can
16461 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
16462 # that are configured with a fault_injection_policy if:
16463 # 1. The traffic is generated by fault injection AND
16464 # 2. The fault injection is not a delay fault injection.
16465 # Fault injection is not supported with the classic Application Load Balancer
16466 # . To see which load balancers support fault injection,
16467 # see Load
16468 # balancing: Routing and traffic management features.
16469 # the resiliency of clients to backend service failure. As part of fault
16470 # injection, when clients send requests to a backend service, delays can be
16471 # introduced by the load balancer on a percentage of requests before sending
16472 # those request to the backend service. Similarly requests from clients can be
16473 # aborted by the load balancer for a percentage of requests.
16474 &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
16475 # injection.
16476 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
16477 #
16478 # The value must be from 200 to 599 inclusive.
16479 #
16480 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
16481 # according to this
16482 # mapping table. HTTP status 200 is mapped to gRPC status
16483 # UNKNOWN. Injecting an OK status is currently not supported by
16484 # Traffic Director.
16485 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
16486 # that is aborted as part of fault injection.
16487 #
16488 # The value must be from 0.0 to 100.0 inclusive.
16489 },
16490 &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
16491 # injection, before being sent to a backend service.
16492 # request to the backend service as part of fault injection.
16493 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
16494 # as a count of seconds and fractions of seconds at nanosecond
16495 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16496 # or &quot;month&quot;. Range is approximately 10,000 years.
16497 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16498 # Durations less than one second are represented with a 0
16499 # `seconds` field and a positive `nanos` field. Must be from 0
16500 # to 999,999,999 inclusive.
16501 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16502 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16503 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16504 },
16505 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
16506 # which a delay is introduced as part of fault injection.
16507 #
16508 # The value must be from 0.0 to 100.0 inclusive.
16509 },
16510 },
16511 &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
16512 # Global EXTERNAL_MANAGED load balancer schemes.
16513 # Either Cloud CDN must be enabled on the backend service or backend bucket
16514 # serving the route, or cache policy must be configured on the same route
16515 # dynamically processes and delivers images from the network edge.
16516 # Image Optimization is only available for Global External Application Load
16517 # Balancers.
16518 # Either Cloud CDN must be enabled on the backend service or backend bucket
16519 # serving the route, or cache policy must be configured on the same route.
16520 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
16521 },
16522 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
16523 # Unlike the timeout field where the timeout duration starts
16524 # from the time the request has been fully processed (known as*end-of-stream*),
16525 # the duration in this field is computed from the beginning of the stream
16526 # until the response has been processed, including all retries. A
16527 # stream that does not complete in this duration is closed.
16528 #
16529 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
16530 # with the route.
16531 #
16532 # This field is only allowed if the Url map is used with backend services
16533 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
16534 # as a count of seconds and fractions of seconds at nanosecond
16535 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16536 # or &quot;month&quot;. Range is approximately 10,000 years.
16537 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16538 # Durations less than one second are represented with a 0
16539 # `seconds` field and a positive `nanos` field. Must be from 0
16540 # to 999,999,999 inclusive.
16541 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16542 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16543 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16544 },
16545 &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
16546 # are shadowed to a separate mirrored backend service. The load balancer does
16547 # not wait for responses from the shadow service. Before sending traffic
16548 # to the shadow service, the host / authority header is suffixed with-shadow.
16549 #
16550 # Not supported when the URL map is bound to a target gRPC proxy that
16551 # has the validateForProxyless field set to true.
16552 # are shadowed to a separate mirrored backend service. The load balancer
16553 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
16554 # to the shadow service, the host or authority header is suffixed with-shadow.
16555 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
16556 # mirrored to.
16557 #
16558 # The backend service configured for a mirroring
16559 # policy must reference backends that are of the same type as the original
16560 # backend service matched in the URL map.
16561 #
16562 # Serverless NEG backends are not currently supported as a mirrored
16563 # backend service.
16564 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
16565 },
16566 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
16567 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
16568 # If not specified, defaults to 1.
16569 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
16570 #
16571 # If not specified, will use the timeout set in theHttpRouteAction field.
16572 # If timeout in the HttpRouteAction field is not set, this field
16573 # uses the largest timeout
16574 # among all backend services associated with the route.
16575 #
16576 # Not supported when the URL map is bound to a target gRPC proxy that
16577 # has the validateForProxyless field set to true.
16578 # as a count of seconds and fractions of seconds at nanosecond
16579 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16580 # or &quot;month&quot;. Range is approximately 10,000 years.
16581 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16582 # Durations less than one second are represented with a 0
16583 # `seconds` field and a positive `nanos` field. Must be from 0
16584 # to 999,999,999 inclusive.
16585 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16586 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16587 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16588 },
16589 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
16590 # values are:
16591 #
16592 # - 5xx: retry is attempted if the instance or endpoint
16593 # responds with any 5xx response code, or if the instance or
16594 # endpoint does not respond at all. For example, disconnects, reset, read
16595 # timeout, connection failure, and refused streams.
16596 # - gateway-error: Similar to 5xx, but only
16597 # applies to response codes 502, 503 or504.
16598 # - connect-failure: a retry is attempted on failures
16599 # connecting to the instance or endpoint. For example, connection
16600 # timeouts.
16601 # - retriable-4xx: a retry is attempted if the instance
16602 # or endpoint responds with a 4xx response code.
16603 # The only error that you can retry is error code 409.
16604 # - refused-stream: a retry is attempted if the instance
16605 # or endpoint resets the stream with a REFUSED_STREAM error
16606 # code. This reset type indicates that it is safe to retry.
16607 # - cancelled: a retry is attempted if the gRPC status
16608 # code in the response header is set to cancelled.
16609 # - deadline-exceeded: a retry is attempted if the gRPC
16610 # status code in the response header is set todeadline-exceeded.
16611 # - internal: a retry is attempted if the gRPC
16612 # status code in the response header is set tointernal.
16613 # - resource-exhausted: a retry is attempted if the gRPC
16614 # status code in the response header is set toresource-exhausted.
16615 # - unavailable: a retry is attempted if the gRPC
16616 # status code in the response header is set tounavailable.
16617 #
16618 # Only the following codes are supported when the URL map is bound to
16619 # target gRPC proxy that has validateForProxyless field set to true.
16620 #
16621 # - cancelled
16622 # - deadline-exceeded
16623 # - internal
16624 # - resource-exhausted
16625 # - unavailable
16626 &quot;A String&quot;,
16627 ],
16628 },
16629 &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
16630 # time the request has been fully processed (known as *end-of-stream*)
16631 # up until the response has been processed. Timeout includes
16632 # all retries.
16633 #
16634 # If not specified, this field uses the largest timeout among all backend
16635 # services associated with the route.
16636 #
16637 # Not supported when the URL map is bound to a target gRPC proxy that
16638 # has validateForProxyless field set to true.
16639 # as a count of seconds and fractions of seconds at nanosecond
16640 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
16641 # or &quot;month&quot;. Range is approximately 10,000 years.
16642 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
16643 # Durations less than one second are represented with a 0
16644 # `seconds` field and a positive `nanos` field. Must be from 0
16645 # to 999,999,999 inclusive.
16646 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
16647 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
16648 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
16649 },
16650 &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
16651 # to the matched service.
16652 #
16653 # urlRewrite is the only action supported in UrlMaps
16654 # for classic Application Load Balancers.
16655 #
16656 # Not supported when the URL map is bound to a target gRPC proxy that
16657 # has the validateForProxyless field set to true.
16658 # backend service.
16659 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
16660 # host header is replaced with contents of hostRewrite.
16661 #
16662 # The value must be from 1 to 255 characters.
16663 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
16664 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
16665 #
16666 # The value must be from 1 to 1024 characters.
16667 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
16668 # header) using the HTTP template syntax.
16669 #
16670 # A corresponding
16671 # path_template_match must be specified. Any template variables must exist in
16672 # the path_template_match field.
16673 #
16674 #
16675 # - -At least one variable must be specified in the path_template_match
16676 # field
16677 # - You can omit variables from the rewritten URL
16678 # - The * and ** operators cannot be matched
16679 # unless they have a corresponding variable name - e.g.
16680 # {format=*} or {var=**}.
16681 #
16682 # For example, a path_template_match of /static/{format=**}
16683 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
16684 # rewrite, so that /{country}/{format}/{suffix=**} can be
16685 # rewritten as /content/{format}/{country}/{suffix}.
16686 #
16687 # At least
16688 # one non-empty routeRules[].matchRules[].path_template_match is
16689 # required.
16690 #
16691 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
16692 },
16693 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
16694 # occurs. The weights determine the fraction of traffic that flows to
16695 # their corresponding backend service. If all traffic needs to
16696 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
16697 #
16698 # After a backend service is identified and before forwarding
16699 # the request to
16700 # the backend service, advanced routing actions such as URL rewrites and
16701 # header transformations are applied depending on additional settings
16702 # specified in this HttpRouteAction.
16703 { # In contrast to a single BackendService in
16704 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
16705 # multiple backend services. The volume of traffic for each
16706 # backend service is proportional to the weight specified
16707 # in each WeightedBackendService
16708 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
16709 # resource. Before
16710 # forwarding the request to backendService, the load balancer
16711 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
16712 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
16713 # effect for the selected backendService.
16714 #
16715 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
16716 #
16717 # headerAction is not supported for load balancers that have
16718 # their loadBalancingScheme set to EXTERNAL.
16719 #
16720 # Not supported when the URL map is bound to a target gRPC proxy that
16721 # has validateForProxyless field set to true.
16722 # the request is passed along to the selected backendService.
16723 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
16724 { # Specification determining how headers are added to requests or responses.
16725 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
16726 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
16727 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
16728 # that already
16729 # exist for the header. If true, headerValue is set for the
16730 # header, discarding any values that were set for that header.
16731 #
16732 # The default value is true,
16733 # unless a variable is present in headerValue,
16734 # in which case the default value is false.
16735 # .
16736 },
16737 ],
16738 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
16739 # request before forwarding the request to the backendService.
16740 &quot;A String&quot;,
16741 ],
16742 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
16743 # client.
16744 { # Specification determining how headers are added to requests or responses.
16745 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
16746 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
16747 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
16748 # that already
16749 # exist for the header. If true, headerValue is set for the
16750 # header, discarding any values that were set for that header.
16751 #
16752 # The default value is true,
16753 # unless a variable is present in headerValue,
16754 # in which case the default value is false.
16755 # .
16756 },
16757 ],
16758 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
16759 # response before sending the response back to the client.
16760 &quot;A String&quot;,
16761 ],
16762 },
16763 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
16764 # computed asweight / (sum of all weightedBackendService weights in routeAction).
16765 #
16766 # The selection of a backend service is determined only for new traffic.
16767 # Once a user&#x27;s request has been directed to a backend service,
16768 # subsequent requests are sent to the same backend service as
16769 # determined by the backend service&#x27;s session affinity policy.
16770 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
16771 # splitting. If you do, the weighted traffic splitting configuration takes
16772 # precedence.
16773 #
16774 # The value must be from 0 to 1000.
16775 },
16776 ],
16777 },
16778 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL of the defaultService resource to
16779 # which traffic is directed if none of the hostRules match.
16780 # If defaultRouteAction is also specified, advanced
16781 # routing actions, such as URL rewrites, take effect before sending the
16782 # request to the backend.
16783 #
16784 #
16785 # Only one of defaultUrlRedirect, defaultService
16786 # or defaultRouteAction.weightedBackendService can be set.
16787 #
16788 #
16789 # defaultService has no effect when the URL map is bound
16790 # to a target gRPC proxy that has the validateForProxyless field
16791 # set to true.
16792 &quot;defaultUrlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
16793 # is redirected to a URL specified by defaultUrlRedirect.
16794 #
16795 #
16796 # Only one of defaultUrlRedirect, defaultService
16797 # or defaultRouteAction.weightedBackendService can be set.
16798 #
16799 #
16800 # Not supported when the URL map is bound to a target gRPC proxy.
16801 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
16802 # was supplied in the request.
16803 #
16804 # The value must be from 1 to 255
16805 # characters.
16806 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
16807 # set to HTTPS.
16808 # If set to false, the URL scheme of the redirected request
16809 # remains the same as that of the request.
16810 #
16811 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
16812 #
16813 # The default is set to false.
16814 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
16815 # that was supplied in the request.
16816 #
16817 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
16818 # supplied, the path of the original request is used for the redirect.
16819 #
16820 # The value must be from 1 to 1024 characters.
16821 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
16822 # the HttpRouteRuleMatch, retaining the remaining portion
16823 # of the URL before redirecting the request.
16824 #
16825 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
16826 # supplied, the path of the original request is used for the redirect.
16827 #
16828 # The value must be from 1 to 1024 characters.
16829 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
16830 #
16831 # Supported values are:
16832 #
16833 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
16834 # to 301.
16835 # - FOUND, which corresponds to 302.
16836 # - SEE_OTHER which corresponds to 303.
16837 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
16838 # method is retained.
16839 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
16840 # method is retained.
16841 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
16842 # URL is
16843 # removed before redirecting the request. If set to false, the
16844 # query portion of the original URL is retained.
16845 #
16846 # The default is set to false.
16847 },
16848 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
16849 # create the resource.
16850 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. A hash of the contents stored in this object.
16851 # This field is used in optimistic locking. This field is ignored when
16852 # inserting a UrlMap. An up-to-date fingerprint must be provided
16853 # in order to update the UrlMap, otherwise the request will
16854 # fail with error 412 conditionNotMet.
16855 #
16856 # To see the latest fingerprint, make a get() request to
16857 # retrieve a UrlMap.
16858 &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
16859 # for the selected backendService.
16860 #
16861 # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
16862 #
16863 # headerAction is not supported for load balancers
16864 # that have
16865 # their loadBalancingScheme set to EXTERNAL.
16866 #
16867 # Not supported when the URL map is bound to a target gRPC proxy that
16868 # has validateForProxyless field set to true.
16869 # the request is passed along to the selected backendService.
16870 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
16871 { # Specification determining how headers are added to requests or responses.
16872 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
16873 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
16874 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
16875 # that already
16876 # exist for the header. If true, headerValue is set for the
16877 # header, discarding any values that were set for that header.
16878 #
16879 # The default value is true,
16880 # unless a variable is present in headerValue,
16881 # in which case the default value is false.
16882 # .
16883 },
16884 ],
16885 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
16886 # request before forwarding the request to the backendService.
16887 &quot;A String&quot;,
16888 ],
16889 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
16890 # client.
16891 { # Specification determining how headers are added to requests or responses.
16892 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
16893 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
16894 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
16895 # that already
16896 # exist for the header. If true, headerValue is set for the
16897 # header, discarding any values that were set for that header.
16898 #
16899 # The default value is true,
16900 # unless a variable is present in headerValue,
16901 # in which case the default value is false.
16902 # .
16903 },
16904 ],
16905 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
16906 # response before sending the response back to the client.
16907 &quot;A String&quot;,
16908 ],
16909 },
16910 &quot;hostRules&quot;: [ # The list of host rules to use against the URL.
16911 { # UrlMaps
16912 # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
16913 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
16914 # create the resource.
16915 &quot;hosts&quot;: [ # The list of host patterns to match. They must be valid hostnames with
16916 # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
16917 # that case, * must be the first character, and if followed by
16918 # anything, the immediate following character must be either -
16919 # or ..
16920 #
16921 # * based matching is not supported when the URL map is bound
16922 # to a target gRPC proxy that has the validateForProxyless field
16923 # set to true.
16924 &quot;A String&quot;,
16925 ],
16926 &quot;pathMatcher&quot;: &quot;A String&quot;, # The name of the PathMatcher to use to match the path portion
16927 # of the URL if the hostRule matches the URL&#x27;s host portion.
16928 },
16929 ],
16930 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the resource. This identifier is
16931 # defined by the server.
16932 &quot;kind&quot;: &quot;compute#urlMap&quot;, # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
16933 # url maps.
16934 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
16935 # The name must be 1-63 characters long, and comply withRFC1035.
16936 # Specifically, the name must be 1-63 characters long and match the regular
16937 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
16938 # character must be a lowercase letter, and all following characters must
16939 # be a dash, lowercase letter, or digit, except the last character, which
16940 # cannot be a dash.
16941 &quot;pathMatchers&quot;: [ # The list of named PathMatchers to use against the URL.
16942 { # A matcher for the path portion of the URL. The BackendService
16943 # from the longest-matched rule will serve the URL. If no rule was matched, the
16944 # default service is used.
16945 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
16946 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
16947 #
16948 # This policy takes
16949 # effect at the PathMatcher level and applies only when no
16950 # 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
16951 # in defaultCustomErrorResponsePolicy, then a policy defined for
16952 # the error code in UrlMap.defaultCustomErrorResponsePolicy
16953 # takes effect.
16954 #
16955 # For example, consider a UrlMap with the following
16956 # configuration:
16957 #
16958 #
16959 # - UrlMap.defaultCustomErrorResponsePolicy is configured
16960 # with policies for 5xx and 4xx errors
16961 # - A RouteRule for /coming_soon/ is configured for the
16962 # error code 404.
16963 #
16964 # 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
16965 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
16966 # the policy in RouteRule.customErrorResponsePolicy takes
16967 # effect. If any of the requests in this example encounter a 500
16968 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
16969 #
16970 # When
16971 # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
16972 # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
16973 # a retry, if load balancer is successful in reaching the
16974 # service, the defaultCustomErrorResponsePolicy is ignored and
16975 # the response from the service is returned to the client.
16976 #
16977 # defaultCustomErrorResponsePolicy is supported only for
16978 # global external Application Load Balancers.
16979 # backend service or backend bucket responds with an error.
16980 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
16981 #
16982 # In a given policy, if you specify rules for both a range of error codes
16983 # as well as rules for specific error codes then rules with specific error
16984 # codes have a higher priority. For example, assume that you configure a rule
16985 # for 401 (Un-authorized) code, and another for all 4 series
16986 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
16987 # However if the backend service returns a 403, the rule for4xx takes effect.
16988 { # Specifies the mapping between the response code that will be returned along
16989 # with the custom error content and the response code returned by the backend
16990 # service.
16991 &quot;matchResponseCodes&quot;: [ # Valid values include:
16992 #
16993 #
16994 # - A number between 400 and 599: For example
16995 # 401 or 503, in which case the load balancer
16996 # applies the policy if the error code exactly matches this value.
16997 # - 5xx: Load Balancer will apply the policy if the
16998 # backend service responds with any response code in the range of
16999 # 500 to 599.
17000 # - 4xx: Load
17001 # Balancer will apply the policy if the backend service responds with any
17002 # response code in the range of 400 to
17003 # 499.
17004 #
17005 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
17006 &quot;A String&quot;,
17007 ],
17008 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
17009 # error content. If overrideResponseCode is not supplied, the
17010 # same response code returned by the original backend bucket or backend
17011 # service is returned to the client.
17012 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
17013 #
17014 # path must start
17015 # with a leading slash. path cannot have trailing slashes.
17016 #
17017 # If the file is not available in backendBucket or the
17018 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
17019 #
17020 # The value must
17021 # be from 1 to 1024 characters
17022 },
17023 ],
17024 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
17025 # contains the custom error content. Examples are:
17026 #
17027 #
17028 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
17029 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
17030 # - global/backendBuckets/myBackendBucket
17031 #
17032 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
17033 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
17034 #
17035 # If load balancer cannot reach
17036 # the backendBucket, a simple Not Found Error will
17037 # be returned, with the original response code (oroverrideResponseCode if configured).
17038 #
17039 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
17040 },
17041 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
17042 # pathRules or routeRules match. The load balancer
17043 # performs advanced routing actions, such as URL rewrites and
17044 # header transformations, before forwarding the request to the
17045 # selected backend.
17046 #
17047 #
17048 # Only one of defaultUrlRedirect, defaultService
17049 # or defaultRouteAction.weightedBackendService can be set.
17050 #
17051 #
17052 # URL maps for classic Application Load Balancers only support
17053 # the urlRewrite action within a path matcher&#x27;sdefaultRouteAction.
17054 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
17055 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
17056 # property must be specified. This policy cannot be specified if any target
17057 # backend has Identity-Aware Proxy enabled.
17058 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
17059 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
17060 # header names can be specified. The cache is bypassed for all `cacheMode`
17061 # values.
17062 &quot;A String&quot;,
17063 ],
17064 &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
17065 # on the backend type: for Backend Services, the complete request URI is
17066 # used; for Backend Buckets, the request URI is used without the protocol or
17067 # host, and only query parameters known to Cloud Storage are included.
17068 # Policy defined on Route Action.
17069 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
17070 # parameters will be included. Either specify `excludedQueryParameters`
17071 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
17072 # encoded and not treated as delimiters.
17073 #
17074 # Note: This field applies to routes that use backend services. Attempting
17075 # to set it on a route that points exclusively to Backend Buckets will
17076 # result in a configuration error. For routes that point to a Backend
17077 # Bucket, use `includedQueryParameters` to define which parameters should
17078 # be part of the cache key.
17079 &quot;A String&quot;,
17080 ],
17081 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
17082 #
17083 # Note: This setting is only applicable to routes that use a Backend
17084 # Service. It does not affect requests served by a Backend Bucket, as the
17085 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
17086 # it on a route that points exclusively to Backend Buckets will result in a
17087 # configuration error.
17088 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
17089 #
17090 # Note: This setting is only applicable to routes that use a Backend
17091 # Service. It does not affect requests served by a Backend Bucket, as the
17092 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
17093 # set on a route that points exclusively to Backend Buckets will result in
17094 # a configuration error.
17095 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
17096 # `includedQueryParameters` and `excludedQueryParameters`. If neither
17097 # is set, the entire query string will be included. If false, the query
17098 # string will be excluded from the cache key entirely.
17099 #
17100 # Note: This field applies to routes that use backend services. Attempting
17101 # to set it on a route that points exclusively to Backend Buckets will
17102 # result in a configuration error. For routes that point to a Backend
17103 # Bucket, use `includedQueryParameters` to define which parameters should
17104 # be part of the cache key.
17105 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
17106 # The name=value pair will be used in the cache key Cloud CDN generates.
17107 #
17108 # Note: This setting is only applicable to routes that use a Backend
17109 # Service. It does not affect requests served by a Backend Bucket.
17110 # Attempting to set it on a route that points exclusively to Backend
17111 # Buckets will result in a configuration error. Up to 5 cookie names can be
17112 # specified.
17113 &quot;A String&quot;,
17114 ],
17115 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
17116 &quot;A String&quot;,
17117 ],
17118 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
17119 # parameters will be excluded. Either specify `includedQueryParameters`
17120 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
17121 # encoded and not treated as delimiters.
17122 &quot;A String&quot;,
17123 ],
17124 },
17125 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
17126 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
17127 &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
17128 # content. This is used to clamp the max-age (or Expires) value sent to the
17129 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
17130 # is used for the response max-age directive, along with a &quot;public&quot;
17131 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
17132 # clamps the max-age from the origin (if specified), or else sets the
17133 # response max-age directive to the lesser of the `clientTtl` and
17134 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
17135 # present. The maximum allowed value is 31,622,400s (1 year). If not
17136 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
17137 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
17138 # `USE_ORIGIN_HEADERS`.
17139 # as a count of seconds and fractions of seconds at nanosecond
17140 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17141 # or &quot;month&quot;. Range is approximately 10,000 years.
17142 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17143 # Durations less than one second are represented with a 0
17144 # `seconds` field and a positive `nanos` field. Must be from 0
17145 # to 999,999,999 inclusive.
17146 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17147 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17148 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17149 },
17150 &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
17151 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
17152 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
17153 # greater than that of `maxTtl`. When the `cacheMode` is set to
17154 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
17155 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
17156 # accessed objects may be evicted from the cache before the defined TTL. If
17157 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
17158 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
17159 # `USE_ORIGIN_HEADERS`.
17160 # as a count of seconds and fractions of seconds at nanosecond
17161 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17162 # or &quot;month&quot;. Range is approximately 10,000 years.
17163 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17164 # Durations less than one second are represented with a 0
17165 # `seconds` field and a positive `nanos` field. Must be from 0
17166 # to 999,999,999 inclusive.
17167 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17168 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17169 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17170 },
17171 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
17172 # attempt to set a max-age or s-maxage higher than this, or an Expires header
17173 # more than `maxTtl` seconds in the future will be capped at the value of
17174 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
17175 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
17176 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
17177 # Infrequently accessed objects may be evicted from the cache before the
17178 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
17179 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
17180 # mode.
17181 # as a count of seconds and fractions of seconds at nanosecond
17182 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17183 # or &quot;month&quot;. Range is approximately 10,000 years.
17184 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17185 # Durations less than one second are represented with a 0
17186 # `seconds` field and a positive `nanos` field. Must be from 0
17187 # to 999,999,999 inclusive.
17188 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17189 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17190 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17191 },
17192 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
17193 # to apply fine-grained caching for common errors or redirects.
17194 # This can reduce the load on your origin and improve end-user
17195 # experience by reducing response latency.
17196 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
17197 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
17198 # the specified response code that lack any Cache-Control, Expires, or
17199 # Pragma: no-cache directives. When the `cacheMode` is set to
17200 # `FORCE_CACHE_ALL`, negative caching applies to all responses
17201 # with the specified response code, and overrides any caching headers. By
17202 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
17203 #
17204 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
17205 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
17206 # * 405 (Method Not Found), 501 (Not Implemented): 60s
17207 #
17208 # These defaults can be overridden in `negativeCachingPolicy`.
17209 # If not specified, Cloud CDN applies negative caching by default.
17210 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
17211 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
17212 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
17213 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
17214 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
17215 # all response codes that you wish to cache. Cloud CDN will not apply any
17216 # default negative caching when a policy exists.
17217 { # Specify CDN TTLs for response error codes.
17218 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
17219 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
17220 # specified as values, and you cannot specify a status code more than
17221 # once.
17222 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
17223 # corresponding status code.
17224 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
17225 # objects may be evicted from the cache before the defined TTL.
17226 # as a count of seconds and fractions of seconds at nanosecond
17227 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17228 # or &quot;month&quot;. Range is approximately 10,000 years.
17229 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17230 # Durations less than one second are represented with a 0
17231 # `seconds` field and a positive `nanos` field. Must be from 0
17232 # to 999,999,999 inclusive.
17233 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17234 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17235 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17236 },
17237 },
17238 ],
17239 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
17240 # requests into a small number of requests to the origin. If not specified,
17241 # Cloud CDN applies request coalescing by default.
17242 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
17243 # content with the origin, or when an error is encountered when refreshing
17244 # the cache.
17245 # This setting defines the default &quot;max-stale&quot; duration for any cached
17246 # responses that do not specify a max-stale directive. Stale responses that
17247 # exceed the TTL configured here will not be served. The default limit
17248 # (max-stale) is 86400s (1 day), which will allow stale content to be
17249 # served up to this limit beyond the max-age (or s-maxage) of a cached
17250 # response.
17251 # The maximum allowed value is 604800 (1 week).
17252 # Set this to zero (0) to disable serve-while-stale.
17253 # as a count of seconds and fractions of seconds at nanosecond
17254 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17255 # or &quot;month&quot;. Range is approximately 10,000 years.
17256 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17257 # Durations less than one second are represented with a 0
17258 # `seconds` field and a positive `nanos` field. Must be from 0
17259 # to 999,999,999 inclusive.
17260 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17261 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17262 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17263 },
17264 },
17265 &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
17266 # information about the W3C recommendation for cross-origin resource sharing
17267 # (CORS), see Fetch API Living
17268 # Standard.
17269 #
17270 # Not supported when the URL map is bound to a target gRPC proxy.
17271 # information about the W3C recommendation for cross-origin resource sharing
17272 # (CORS), see Fetch API Living
17273 # Standard.
17274 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
17275 # indicates that
17276 # the actual request can include user credentials. This field translates to
17277 # the Access-Control-Allow-Credentials header.
17278 #
17279 # Default is false.
17280 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
17281 # header.
17282 &quot;A String&quot;,
17283 ],
17284 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
17285 # header.
17286 &quot;A String&quot;,
17287 ],
17288 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
17289 # more information, see regular expression syntax.
17290 #
17291 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
17292 #
17293 # Regular expressions can only be used when the loadBalancingScheme is
17294 # set to INTERNAL_SELF_MANAGED.
17295 &quot;A String&quot;,
17296 ],
17297 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
17298 #
17299 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
17300 &quot;A String&quot;,
17301 ],
17302 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
17303 # The default value is false, which indicates that the CORS
17304 # policy is in effect.
17305 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
17306 # header.
17307 &quot;A String&quot;,
17308 ],
17309 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
17310 # seconds. This field translates to the Access-Control-Max-Age
17311 # header.
17312 },
17313 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
17314 # the resiliency of clients to backend service failure. As part of fault
17315 # injection, when clients send requests to a backend service, delays can be
17316 # introduced by a load balancer on a percentage of requests before sending
17317 # those requests to the backend service. Similarly requests from clients can
17318 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
17319 # that are configured with a fault_injection_policy if:
17320 # 1. The traffic is generated by fault injection AND
17321 # 2. The fault injection is not a delay fault injection.
17322 # Fault injection is not supported with the classic Application Load Balancer
17323 # . To see which load balancers support fault injection,
17324 # see Load
17325 # balancing: Routing and traffic management features.
17326 # the resiliency of clients to backend service failure. As part of fault
17327 # injection, when clients send requests to a backend service, delays can be
17328 # introduced by the load balancer on a percentage of requests before sending
17329 # those request to the backend service. Similarly requests from clients can be
17330 # aborted by the load balancer for a percentage of requests.
17331 &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
17332 # injection.
17333 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
17334 #
17335 # The value must be from 200 to 599 inclusive.
17336 #
17337 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
17338 # according to this
17339 # mapping table. HTTP status 200 is mapped to gRPC status
17340 # UNKNOWN. Injecting an OK status is currently not supported by
17341 # Traffic Director.
17342 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
17343 # that is aborted as part of fault injection.
17344 #
17345 # The value must be from 0.0 to 100.0 inclusive.
17346 },
17347 &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
17348 # injection, before being sent to a backend service.
17349 # request to the backend service as part of fault injection.
17350 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
17351 # as a count of seconds and fractions of seconds at nanosecond
17352 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17353 # or &quot;month&quot;. Range is approximately 10,000 years.
17354 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17355 # Durations less than one second are represented with a 0
17356 # `seconds` field and a positive `nanos` field. Must be from 0
17357 # to 999,999,999 inclusive.
17358 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17359 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17360 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17361 },
17362 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
17363 # which a delay is introduced as part of fault injection.
17364 #
17365 # The value must be from 0.0 to 100.0 inclusive.
17366 },
17367 },
17368 &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
17369 # Global EXTERNAL_MANAGED load balancer schemes.
17370 # Either Cloud CDN must be enabled on the backend service or backend bucket
17371 # serving the route, or cache policy must be configured on the same route
17372 # dynamically processes and delivers images from the network edge.
17373 # Image Optimization is only available for Global External Application Load
17374 # Balancers.
17375 # Either Cloud CDN must be enabled on the backend service or backend bucket
17376 # serving the route, or cache policy must be configured on the same route.
17377 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
17378 },
17379 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
17380 # Unlike the timeout field where the timeout duration starts
17381 # from the time the request has been fully processed (known as*end-of-stream*),
17382 # the duration in this field is computed from the beginning of the stream
17383 # until the response has been processed, including all retries. A
17384 # stream that does not complete in this duration is closed.
17385 #
17386 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
17387 # with the route.
17388 #
17389 # This field is only allowed if the Url map is used with backend services
17390 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
17391 # as a count of seconds and fractions of seconds at nanosecond
17392 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17393 # or &quot;month&quot;. Range is approximately 10,000 years.
17394 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17395 # Durations less than one second are represented with a 0
17396 # `seconds` field and a positive `nanos` field. Must be from 0
17397 # to 999,999,999 inclusive.
17398 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17399 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17400 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17401 },
17402 &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
17403 # are shadowed to a separate mirrored backend service. The load balancer does
17404 # not wait for responses from the shadow service. Before sending traffic
17405 # to the shadow service, the host / authority header is suffixed with-shadow.
17406 #
17407 # Not supported when the URL map is bound to a target gRPC proxy that
17408 # has the validateForProxyless field set to true.
17409 # are shadowed to a separate mirrored backend service. The load balancer
17410 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
17411 # to the shadow service, the host or authority header is suffixed with-shadow.
17412 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
17413 # mirrored to.
17414 #
17415 # The backend service configured for a mirroring
17416 # policy must reference backends that are of the same type as the original
17417 # backend service matched in the URL map.
17418 #
17419 # Serverless NEG backends are not currently supported as a mirrored
17420 # backend service.
17421 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
17422 },
17423 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
17424 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
17425 # If not specified, defaults to 1.
17426 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
17427 #
17428 # If not specified, will use the timeout set in theHttpRouteAction field.
17429 # If timeout in the HttpRouteAction field is not set, this field
17430 # uses the largest timeout
17431 # among all backend services associated with the route.
17432 #
17433 # Not supported when the URL map is bound to a target gRPC proxy that
17434 # has the validateForProxyless field set to true.
17435 # as a count of seconds and fractions of seconds at nanosecond
17436 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17437 # or &quot;month&quot;. Range is approximately 10,000 years.
17438 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17439 # Durations less than one second are represented with a 0
17440 # `seconds` field and a positive `nanos` field. Must be from 0
17441 # to 999,999,999 inclusive.
17442 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17443 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17444 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17445 },
17446 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
17447 # values are:
17448 #
17449 # - 5xx: retry is attempted if the instance or endpoint
17450 # responds with any 5xx response code, or if the instance or
17451 # endpoint does not respond at all. For example, disconnects, reset, read
17452 # timeout, connection failure, and refused streams.
17453 # - gateway-error: Similar to 5xx, but only
17454 # applies to response codes 502, 503 or504.
17455 # - connect-failure: a retry is attempted on failures
17456 # connecting to the instance or endpoint. For example, connection
17457 # timeouts.
17458 # - retriable-4xx: a retry is attempted if the instance
17459 # or endpoint responds with a 4xx response code.
17460 # The only error that you can retry is error code 409.
17461 # - refused-stream: a retry is attempted if the instance
17462 # or endpoint resets the stream with a REFUSED_STREAM error
17463 # code. This reset type indicates that it is safe to retry.
17464 # - cancelled: a retry is attempted if the gRPC status
17465 # code in the response header is set to cancelled.
17466 # - deadline-exceeded: a retry is attempted if the gRPC
17467 # status code in the response header is set todeadline-exceeded.
17468 # - internal: a retry is attempted if the gRPC
17469 # status code in the response header is set tointernal.
17470 # - resource-exhausted: a retry is attempted if the gRPC
17471 # status code in the response header is set toresource-exhausted.
17472 # - unavailable: a retry is attempted if the gRPC
17473 # status code in the response header is set tounavailable.
17474 #
17475 # Only the following codes are supported when the URL map is bound to
17476 # target gRPC proxy that has validateForProxyless field set to true.
17477 #
17478 # - cancelled
17479 # - deadline-exceeded
17480 # - internal
17481 # - resource-exhausted
17482 # - unavailable
17483 &quot;A String&quot;,
17484 ],
17485 },
17486 &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
17487 # time the request has been fully processed (known as *end-of-stream*)
17488 # up until the response has been processed. Timeout includes
17489 # all retries.
17490 #
17491 # If not specified, this field uses the largest timeout among all backend
17492 # services associated with the route.
17493 #
17494 # Not supported when the URL map is bound to a target gRPC proxy that
17495 # has validateForProxyless field set to true.
17496 # as a count of seconds and fractions of seconds at nanosecond
17497 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17498 # or &quot;month&quot;. Range is approximately 10,000 years.
17499 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17500 # Durations less than one second are represented with a 0
17501 # `seconds` field and a positive `nanos` field. Must be from 0
17502 # to 999,999,999 inclusive.
17503 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17504 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17505 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17506 },
17507 &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
17508 # to the matched service.
17509 #
17510 # urlRewrite is the only action supported in UrlMaps
17511 # for classic Application Load Balancers.
17512 #
17513 # Not supported when the URL map is bound to a target gRPC proxy that
17514 # has the validateForProxyless field set to true.
17515 # backend service.
17516 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
17517 # host header is replaced with contents of hostRewrite.
17518 #
17519 # The value must be from 1 to 255 characters.
17520 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
17521 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
17522 #
17523 # The value must be from 1 to 1024 characters.
17524 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
17525 # header) using the HTTP template syntax.
17526 #
17527 # A corresponding
17528 # path_template_match must be specified. Any template variables must exist in
17529 # the path_template_match field.
17530 #
17531 #
17532 # - -At least one variable must be specified in the path_template_match
17533 # field
17534 # - You can omit variables from the rewritten URL
17535 # - The * and ** operators cannot be matched
17536 # unless they have a corresponding variable name - e.g.
17537 # {format=*} or {var=**}.
17538 #
17539 # For example, a path_template_match of /static/{format=**}
17540 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
17541 # rewrite, so that /{country}/{format}/{suffix=**} can be
17542 # rewritten as /content/{format}/{country}/{suffix}.
17543 #
17544 # At least
17545 # one non-empty routeRules[].matchRules[].path_template_match is
17546 # required.
17547 #
17548 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
17549 },
17550 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
17551 # occurs. The weights determine the fraction of traffic that flows to
17552 # their corresponding backend service. If all traffic needs to
17553 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
17554 #
17555 # After a backend service is identified and before forwarding
17556 # the request to
17557 # the backend service, advanced routing actions such as URL rewrites and
17558 # header transformations are applied depending on additional settings
17559 # specified in this HttpRouteAction.
17560 { # In contrast to a single BackendService in
17561 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
17562 # multiple backend services. The volume of traffic for each
17563 # backend service is proportional to the weight specified
17564 # in each WeightedBackendService
17565 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
17566 # resource. Before
17567 # forwarding the request to backendService, the load balancer
17568 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
17569 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
17570 # effect for the selected backendService.
17571 #
17572 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
17573 #
17574 # headerAction is not supported for load balancers that have
17575 # their loadBalancingScheme set to EXTERNAL.
17576 #
17577 # Not supported when the URL map is bound to a target gRPC proxy that
17578 # has validateForProxyless field set to true.
17579 # the request is passed along to the selected backendService.
17580 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
17581 { # Specification determining how headers are added to requests or responses.
17582 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
17583 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
17584 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
17585 # that already
17586 # exist for the header. If true, headerValue is set for the
17587 # header, discarding any values that were set for that header.
17588 #
17589 # The default value is true,
17590 # unless a variable is present in headerValue,
17591 # in which case the default value is false.
17592 # .
17593 },
17594 ],
17595 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
17596 # request before forwarding the request to the backendService.
17597 &quot;A String&quot;,
17598 ],
17599 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
17600 # client.
17601 { # Specification determining how headers are added to requests or responses.
17602 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
17603 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
17604 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
17605 # that already
17606 # exist for the header. If true, headerValue is set for the
17607 # header, discarding any values that were set for that header.
17608 #
17609 # The default value is true,
17610 # unless a variable is present in headerValue,
17611 # in which case the default value is false.
17612 # .
17613 },
17614 ],
17615 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
17616 # response before sending the response back to the client.
17617 &quot;A String&quot;,
17618 ],
17619 },
17620 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
17621 # computed asweight / (sum of all weightedBackendService weights in routeAction).
17622 #
17623 # The selection of a backend service is determined only for new traffic.
17624 # Once a user&#x27;s request has been directed to a backend service,
17625 # subsequent requests are sent to the same backend service as
17626 # determined by the backend service&#x27;s session affinity policy.
17627 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
17628 # splitting. If you do, the weighted traffic splitting configuration takes
17629 # precedence.
17630 #
17631 # The value must be from 0 to 1000.
17632 },
17633 ],
17634 },
17635 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource. This
17636 # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
17637 # matched. For example, the
17638 # following are all valid URLs to a BackendService resource:
17639 #
17640 #
17641 # - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
17642 # - compute/v1/projects/project/global/backendServices/backendService
17643 # - global/backendServices/backendService
17644 #
17645 #
17646 # If defaultRouteAction is also specified, advanced
17647 # routing actions, such as URL rewrites, take effect before sending the
17648 # request to the backend.
17649 #
17650 #
17651 # Only one of defaultUrlRedirect, defaultService
17652 # or defaultRouteAction.weightedBackendService can be set.
17653 #
17654 #
17655 # Authorization requires one or more of the following Google IAM permissions on the
17656 # specified resource default_service:
17657 #
17658 #
17659 # - compute.backendBuckets.use
17660 # - compute.backendServices.use
17661 &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
17662 # by defaultUrlRedirect.
17663 #
17664 #
17665 # Only one of defaultUrlRedirect, defaultService
17666 # or defaultRouteAction.weightedBackendService can be set.
17667 #
17668 #
17669 # Not supported when the URL map is bound to a target gRPC proxy.
17670 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
17671 # was supplied in the request.
17672 #
17673 # The value must be from 1 to 255
17674 # characters.
17675 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
17676 # set to HTTPS.
17677 # If set to false, the URL scheme of the redirected request
17678 # remains the same as that of the request.
17679 #
17680 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
17681 #
17682 # The default is set to false.
17683 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
17684 # that was supplied in the request.
17685 #
17686 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
17687 # supplied, the path of the original request is used for the redirect.
17688 #
17689 # The value must be from 1 to 1024 characters.
17690 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
17691 # the HttpRouteRuleMatch, retaining the remaining portion
17692 # of the URL before redirecting the request.
17693 #
17694 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
17695 # supplied, the path of the original request is used for the redirect.
17696 #
17697 # The value must be from 1 to 1024 characters.
17698 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
17699 #
17700 # Supported values are:
17701 #
17702 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
17703 # to 301.
17704 # - FOUND, which corresponds to 302.
17705 # - SEE_OTHER which corresponds to 303.
17706 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
17707 # method is retained.
17708 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
17709 # method is retained.
17710 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
17711 # URL is
17712 # removed before redirecting the request. If set to false, the
17713 # query portion of the original URL is retained.
17714 #
17715 # The default is set to false.
17716 },
17717 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
17718 # create the resource.
17719 &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
17720 # for the selected backend service.
17721 #
17722 # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
17723 #
17724 # HeaderAction is not supported for load balancers
17725 # that have
17726 # their loadBalancingScheme set to EXTERNAL.
17727 #
17728 # Not supported when the URL map is bound to a target gRPC proxy that
17729 # has validateForProxyless field set to true.
17730 # the request is passed along to the selected backendService.
17731 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
17732 { # Specification determining how headers are added to requests or responses.
17733 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
17734 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
17735 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
17736 # that already
17737 # exist for the header. If true, headerValue is set for the
17738 # header, discarding any values that were set for that header.
17739 #
17740 # The default value is true,
17741 # unless a variable is present in headerValue,
17742 # in which case the default value is false.
17743 # .
17744 },
17745 ],
17746 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
17747 # request before forwarding the request to the backendService.
17748 &quot;A String&quot;,
17749 ],
17750 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
17751 # client.
17752 { # Specification determining how headers are added to requests or responses.
17753 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
17754 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
17755 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
17756 # that already
17757 # exist for the header. If true, headerValue is set for the
17758 # header, discarding any values that were set for that header.
17759 #
17760 # The default value is true,
17761 # unless a variable is present in headerValue,
17762 # in which case the default value is false.
17763 # .
17764 },
17765 ],
17766 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
17767 # response before sending the response back to the client.
17768 &quot;A String&quot;,
17769 ],
17770 },
17771 &quot;name&quot;: &quot;A String&quot;, # The name to which this PathMatcher is referred by theHostRule.
17772 &quot;pathRules&quot;: [ # The list of path rules. Use this list instead of routeRules
17773 # when routing based on simple path matching is all that&#x27;s required. A path
17774 # rule can only include a wildcard character (*) after a
17775 # forward slash character (&quot;/&quot;).
17776 #
17777 # The order by which path rules are specified does not matter.
17778 # Matches are always done on the longest-path-first basis.
17779 #
17780 # For example: a pathRule with a path /a/b/c/* will match
17781 # before /a/b/* irrespective of the order in which those paths appear in this
17782 # list.
17783 #
17784 # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
17785 { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
17786 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
17787 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
17788 #
17789 # If a policy for an
17790 # error code is not configured for the PathRule, a policy for
17791 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
17792 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
17793 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
17794 # effect.
17795 #
17796 # For example, consider a UrlMap with the following configuration:
17797 #
17798 #
17799 # - UrlMap.defaultCustomErrorResponsePolicy are configured
17800 # with policies for 5xx and 4xx errors
17801 # - A PathRule for /coming_soon/ is configured for the error
17802 # code 404.
17803 #
17804 # 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
17805 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
17806 # the policy in PathRule.customErrorResponsePolicy takes
17807 # effect. If any of the requests in this example encounter a 500
17808 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
17809 #
17810 # customErrorResponsePolicy is supported only for
17811 # global external Application Load Balancers.
17812 # backend service or backend bucket responds with an error.
17813 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
17814 #
17815 # In a given policy, if you specify rules for both a range of error codes
17816 # as well as rules for specific error codes then rules with specific error
17817 # codes have a higher priority. For example, assume that you configure a rule
17818 # for 401 (Un-authorized) code, and another for all 4 series
17819 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
17820 # However if the backend service returns a 403, the rule for4xx takes effect.
17821 { # Specifies the mapping between the response code that will be returned along
17822 # with the custom error content and the response code returned by the backend
17823 # service.
17824 &quot;matchResponseCodes&quot;: [ # Valid values include:
17825 #
17826 #
17827 # - A number between 400 and 599: For example
17828 # 401 or 503, in which case the load balancer
17829 # applies the policy if the error code exactly matches this value.
17830 # - 5xx: Load Balancer will apply the policy if the
17831 # backend service responds with any response code in the range of
17832 # 500 to 599.
17833 # - 4xx: Load
17834 # Balancer will apply the policy if the backend service responds with any
17835 # response code in the range of 400 to
17836 # 499.
17837 #
17838 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
17839 &quot;A String&quot;,
17840 ],
17841 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
17842 # error content. If overrideResponseCode is not supplied, the
17843 # same response code returned by the original backend bucket or backend
17844 # service is returned to the client.
17845 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
17846 #
17847 # path must start
17848 # with a leading slash. path cannot have trailing slashes.
17849 #
17850 # If the file is not available in backendBucket or the
17851 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
17852 #
17853 # The value must
17854 # be from 1 to 1024 characters
17855 },
17856 ],
17857 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
17858 # contains the custom error content. Examples are:
17859 #
17860 #
17861 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
17862 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
17863 # - global/backendBuckets/myBackendBucket
17864 #
17865 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
17866 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
17867 #
17868 # If load balancer cannot reach
17869 # the backendBucket, a simple Not Found Error will
17870 # be returned, with the original response code (oroverrideResponseCode if configured).
17871 #
17872 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
17873 },
17874 &quot;paths&quot;: [ # The list of path patterns to match. Each must start with /
17875 # and the only place a * is allowed is at the end following
17876 # a /. The string fed to the path matcher does not include
17877 # any text after the first ? or #, and
17878 # those chars are not allowed here.
17879 &quot;A String&quot;,
17880 ],
17881 &quot;routeAction&quot;: { # In response to a matching path, the load balancer
17882 # performs advanced routing actions, such as URL rewrites and header
17883 # transformations, before forwarding the request to the selected
17884 # backend.
17885 #
17886 #
17887 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
17888 #
17889 #
17890 # URL maps for classic Application Load Balancers only support
17891 # the urlRewrite action within a path rule&#x27;srouteAction.
17892 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
17893 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
17894 # property must be specified. This policy cannot be specified if any target
17895 # backend has Identity-Aware Proxy enabled.
17896 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
17897 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
17898 # header names can be specified. The cache is bypassed for all `cacheMode`
17899 # values.
17900 &quot;A String&quot;,
17901 ],
17902 &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
17903 # on the backend type: for Backend Services, the complete request URI is
17904 # used; for Backend Buckets, the request URI is used without the protocol or
17905 # host, and only query parameters known to Cloud Storage are included.
17906 # Policy defined on Route Action.
17907 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
17908 # parameters will be included. Either specify `excludedQueryParameters`
17909 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
17910 # encoded and not treated as delimiters.
17911 #
17912 # Note: This field applies to routes that use backend services. Attempting
17913 # to set it on a route that points exclusively to Backend Buckets will
17914 # result in a configuration error. For routes that point to a Backend
17915 # Bucket, use `includedQueryParameters` to define which parameters should
17916 # be part of the cache key.
17917 &quot;A String&quot;,
17918 ],
17919 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
17920 #
17921 # Note: This setting is only applicable to routes that use a Backend
17922 # Service. It does not affect requests served by a Backend Bucket, as the
17923 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
17924 # it on a route that points exclusively to Backend Buckets will result in a
17925 # configuration error.
17926 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
17927 #
17928 # Note: This setting is only applicable to routes that use a Backend
17929 # Service. It does not affect requests served by a Backend Bucket, as the
17930 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
17931 # set on a route that points exclusively to Backend Buckets will result in
17932 # a configuration error.
17933 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
17934 # `includedQueryParameters` and `excludedQueryParameters`. If neither
17935 # is set, the entire query string will be included. If false, the query
17936 # string will be excluded from the cache key entirely.
17937 #
17938 # Note: This field applies to routes that use backend services. Attempting
17939 # to set it on a route that points exclusively to Backend Buckets will
17940 # result in a configuration error. For routes that point to a Backend
17941 # Bucket, use `includedQueryParameters` to define which parameters should
17942 # be part of the cache key.
17943 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
17944 # The name=value pair will be used in the cache key Cloud CDN generates.
17945 #
17946 # Note: This setting is only applicable to routes that use a Backend
17947 # Service. It does not affect requests served by a Backend Bucket.
17948 # Attempting to set it on a route that points exclusively to Backend
17949 # Buckets will result in a configuration error. Up to 5 cookie names can be
17950 # specified.
17951 &quot;A String&quot;,
17952 ],
17953 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
17954 &quot;A String&quot;,
17955 ],
17956 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
17957 # parameters will be excluded. Either specify `includedQueryParameters`
17958 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
17959 # encoded and not treated as delimiters.
17960 &quot;A String&quot;,
17961 ],
17962 },
17963 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
17964 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
17965 &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
17966 # content. This is used to clamp the max-age (or Expires) value sent to the
17967 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
17968 # is used for the response max-age directive, along with a &quot;public&quot;
17969 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
17970 # clamps the max-age from the origin (if specified), or else sets the
17971 # response max-age directive to the lesser of the `clientTtl` and
17972 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
17973 # present. The maximum allowed value is 31,622,400s (1 year). If not
17974 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
17975 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
17976 # `USE_ORIGIN_HEADERS`.
17977 # as a count of seconds and fractions of seconds at nanosecond
17978 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
17979 # or &quot;month&quot;. Range is approximately 10,000 years.
17980 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
17981 # Durations less than one second are represented with a 0
17982 # `seconds` field and a positive `nanos` field. Must be from 0
17983 # to 999,999,999 inclusive.
17984 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
17985 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
17986 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
17987 },
17988 &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
17989 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
17990 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
17991 # greater than that of `maxTtl`. When the `cacheMode` is set to
17992 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
17993 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
17994 # accessed objects may be evicted from the cache before the defined TTL. If
17995 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
17996 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
17997 # `USE_ORIGIN_HEADERS`.
17998 # as a count of seconds and fractions of seconds at nanosecond
17999 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18000 # or &quot;month&quot;. Range is approximately 10,000 years.
18001 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18002 # Durations less than one second are represented with a 0
18003 # `seconds` field and a positive `nanos` field. Must be from 0
18004 # to 999,999,999 inclusive.
18005 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18006 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18007 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18008 },
18009 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
18010 # attempt to set a max-age or s-maxage higher than this, or an Expires header
18011 # more than `maxTtl` seconds in the future will be capped at the value of
18012 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
18013 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
18014 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
18015 # Infrequently accessed objects may be evicted from the cache before the
18016 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
18017 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
18018 # mode.
18019 # as a count of seconds and fractions of seconds at nanosecond
18020 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18021 # or &quot;month&quot;. Range is approximately 10,000 years.
18022 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18023 # Durations less than one second are represented with a 0
18024 # `seconds` field and a positive `nanos` field. Must be from 0
18025 # to 999,999,999 inclusive.
18026 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18027 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18028 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18029 },
18030 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
18031 # to apply fine-grained caching for common errors or redirects.
18032 # This can reduce the load on your origin and improve end-user
18033 # experience by reducing response latency.
18034 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
18035 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
18036 # the specified response code that lack any Cache-Control, Expires, or
18037 # Pragma: no-cache directives. When the `cacheMode` is set to
18038 # `FORCE_CACHE_ALL`, negative caching applies to all responses
18039 # with the specified response code, and overrides any caching headers. By
18040 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
18041 #
18042 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
18043 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
18044 # * 405 (Method Not Found), 501 (Not Implemented): 60s
18045 #
18046 # These defaults can be overridden in `negativeCachingPolicy`.
18047 # If not specified, Cloud CDN applies negative caching by default.
18048 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
18049 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
18050 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
18051 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
18052 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
18053 # all response codes that you wish to cache. Cloud CDN will not apply any
18054 # default negative caching when a policy exists.
18055 { # Specify CDN TTLs for response error codes.
18056 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
18057 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
18058 # specified as values, and you cannot specify a status code more than
18059 # once.
18060 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
18061 # corresponding status code.
18062 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
18063 # objects may be evicted from the cache before the defined TTL.
18064 # as a count of seconds and fractions of seconds at nanosecond
18065 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18066 # or &quot;month&quot;. Range is approximately 10,000 years.
18067 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18068 # Durations less than one second are represented with a 0
18069 # `seconds` field and a positive `nanos` field. Must be from 0
18070 # to 999,999,999 inclusive.
18071 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18072 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18073 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18074 },
18075 },
18076 ],
18077 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
18078 # requests into a small number of requests to the origin. If not specified,
18079 # Cloud CDN applies request coalescing by default.
18080 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
18081 # content with the origin, or when an error is encountered when refreshing
18082 # the cache.
18083 # This setting defines the default &quot;max-stale&quot; duration for any cached
18084 # responses that do not specify a max-stale directive. Stale responses that
18085 # exceed the TTL configured here will not be served. The default limit
18086 # (max-stale) is 86400s (1 day), which will allow stale content to be
18087 # served up to this limit beyond the max-age (or s-maxage) of a cached
18088 # response.
18089 # The maximum allowed value is 604800 (1 week).
18090 # Set this to zero (0) to disable serve-while-stale.
18091 # as a count of seconds and fractions of seconds at nanosecond
18092 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18093 # or &quot;month&quot;. Range is approximately 10,000 years.
18094 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18095 # Durations less than one second are represented with a 0
18096 # `seconds` field and a positive `nanos` field. Must be from 0
18097 # to 999,999,999 inclusive.
18098 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18099 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18100 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18101 },
18102 },
18103 &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
18104 # information about the W3C recommendation for cross-origin resource sharing
18105 # (CORS), see Fetch API Living
18106 # Standard.
18107 #
18108 # Not supported when the URL map is bound to a target gRPC proxy.
18109 # information about the W3C recommendation for cross-origin resource sharing
18110 # (CORS), see Fetch API Living
18111 # Standard.
18112 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
18113 # indicates that
18114 # the actual request can include user credentials. This field translates to
18115 # the Access-Control-Allow-Credentials header.
18116 #
18117 # Default is false.
18118 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
18119 # header.
18120 &quot;A String&quot;,
18121 ],
18122 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
18123 # header.
18124 &quot;A String&quot;,
18125 ],
18126 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
18127 # more information, see regular expression syntax.
18128 #
18129 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
18130 #
18131 # Regular expressions can only be used when the loadBalancingScheme is
18132 # set to INTERNAL_SELF_MANAGED.
18133 &quot;A String&quot;,
18134 ],
18135 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
18136 #
18137 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
18138 &quot;A String&quot;,
18139 ],
18140 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
18141 # The default value is false, which indicates that the CORS
18142 # policy is in effect.
18143 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
18144 # header.
18145 &quot;A String&quot;,
18146 ],
18147 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
18148 # seconds. This field translates to the Access-Control-Max-Age
18149 # header.
18150 },
18151 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
18152 # the resiliency of clients to backend service failure. As part of fault
18153 # injection, when clients send requests to a backend service, delays can be
18154 # introduced by a load balancer on a percentage of requests before sending
18155 # those requests to the backend service. Similarly requests from clients can
18156 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
18157 # that are configured with a fault_injection_policy if:
18158 # 1. The traffic is generated by fault injection AND
18159 # 2. The fault injection is not a delay fault injection.
18160 # Fault injection is not supported with the classic Application Load Balancer
18161 # . To see which load balancers support fault injection,
18162 # see Load
18163 # balancing: Routing and traffic management features.
18164 # the resiliency of clients to backend service failure. As part of fault
18165 # injection, when clients send requests to a backend service, delays can be
18166 # introduced by the load balancer on a percentage of requests before sending
18167 # those request to the backend service. Similarly requests from clients can be
18168 # aborted by the load balancer for a percentage of requests.
18169 &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
18170 # injection.
18171 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
18172 #
18173 # The value must be from 200 to 599 inclusive.
18174 #
18175 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
18176 # according to this
18177 # mapping table. HTTP status 200 is mapped to gRPC status
18178 # UNKNOWN. Injecting an OK status is currently not supported by
18179 # Traffic Director.
18180 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
18181 # that is aborted as part of fault injection.
18182 #
18183 # The value must be from 0.0 to 100.0 inclusive.
18184 },
18185 &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
18186 # injection, before being sent to a backend service.
18187 # request to the backend service as part of fault injection.
18188 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
18189 # as a count of seconds and fractions of seconds at nanosecond
18190 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18191 # or &quot;month&quot;. Range is approximately 10,000 years.
18192 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18193 # Durations less than one second are represented with a 0
18194 # `seconds` field and a positive `nanos` field. Must be from 0
18195 # to 999,999,999 inclusive.
18196 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18197 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18198 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18199 },
18200 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
18201 # which a delay is introduced as part of fault injection.
18202 #
18203 # The value must be from 0.0 to 100.0 inclusive.
18204 },
18205 },
18206 &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
18207 # Global EXTERNAL_MANAGED load balancer schemes.
18208 # Either Cloud CDN must be enabled on the backend service or backend bucket
18209 # serving the route, or cache policy must be configured on the same route
18210 # dynamically processes and delivers images from the network edge.
18211 # Image Optimization is only available for Global External Application Load
18212 # Balancers.
18213 # Either Cloud CDN must be enabled on the backend service or backend bucket
18214 # serving the route, or cache policy must be configured on the same route.
18215 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
18216 },
18217 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
18218 # Unlike the timeout field where the timeout duration starts
18219 # from the time the request has been fully processed (known as*end-of-stream*),
18220 # the duration in this field is computed from the beginning of the stream
18221 # until the response has been processed, including all retries. A
18222 # stream that does not complete in this duration is closed.
18223 #
18224 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
18225 # with the route.
18226 #
18227 # This field is only allowed if the Url map is used with backend services
18228 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
18229 # as a count of seconds and fractions of seconds at nanosecond
18230 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18231 # or &quot;month&quot;. Range is approximately 10,000 years.
18232 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18233 # Durations less than one second are represented with a 0
18234 # `seconds` field and a positive `nanos` field. Must be from 0
18235 # to 999,999,999 inclusive.
18236 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18237 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18238 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18239 },
18240 &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
18241 # are shadowed to a separate mirrored backend service. The load balancer does
18242 # not wait for responses from the shadow service. Before sending traffic
18243 # to the shadow service, the host / authority header is suffixed with-shadow.
18244 #
18245 # Not supported when the URL map is bound to a target gRPC proxy that
18246 # has the validateForProxyless field set to true.
18247 # are shadowed to a separate mirrored backend service. The load balancer
18248 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
18249 # to the shadow service, the host or authority header is suffixed with-shadow.
18250 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
18251 # mirrored to.
18252 #
18253 # The backend service configured for a mirroring
18254 # policy must reference backends that are of the same type as the original
18255 # backend service matched in the URL map.
18256 #
18257 # Serverless NEG backends are not currently supported as a mirrored
18258 # backend service.
18259 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
18260 },
18261 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
18262 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
18263 # If not specified, defaults to 1.
18264 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
18265 #
18266 # If not specified, will use the timeout set in theHttpRouteAction field.
18267 # If timeout in the HttpRouteAction field is not set, this field
18268 # uses the largest timeout
18269 # among all backend services associated with the route.
18270 #
18271 # Not supported when the URL map is bound to a target gRPC proxy that
18272 # has the validateForProxyless field set to true.
18273 # as a count of seconds and fractions of seconds at nanosecond
18274 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18275 # or &quot;month&quot;. Range is approximately 10,000 years.
18276 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18277 # Durations less than one second are represented with a 0
18278 # `seconds` field and a positive `nanos` field. Must be from 0
18279 # to 999,999,999 inclusive.
18280 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18281 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18282 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18283 },
18284 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
18285 # values are:
18286 #
18287 # - 5xx: retry is attempted if the instance or endpoint
18288 # responds with any 5xx response code, or if the instance or
18289 # endpoint does not respond at all. For example, disconnects, reset, read
18290 # timeout, connection failure, and refused streams.
18291 # - gateway-error: Similar to 5xx, but only
18292 # applies to response codes 502, 503 or504.
18293 # - connect-failure: a retry is attempted on failures
18294 # connecting to the instance or endpoint. For example, connection
18295 # timeouts.
18296 # - retriable-4xx: a retry is attempted if the instance
18297 # or endpoint responds with a 4xx response code.
18298 # The only error that you can retry is error code 409.
18299 # - refused-stream: a retry is attempted if the instance
18300 # or endpoint resets the stream with a REFUSED_STREAM error
18301 # code. This reset type indicates that it is safe to retry.
18302 # - cancelled: a retry is attempted if the gRPC status
18303 # code in the response header is set to cancelled.
18304 # - deadline-exceeded: a retry is attempted if the gRPC
18305 # status code in the response header is set todeadline-exceeded.
18306 # - internal: a retry is attempted if the gRPC
18307 # status code in the response header is set tointernal.
18308 # - resource-exhausted: a retry is attempted if the gRPC
18309 # status code in the response header is set toresource-exhausted.
18310 # - unavailable: a retry is attempted if the gRPC
18311 # status code in the response header is set tounavailable.
18312 #
18313 # Only the following codes are supported when the URL map is bound to
18314 # target gRPC proxy that has validateForProxyless field set to true.
18315 #
18316 # - cancelled
18317 # - deadline-exceeded
18318 # - internal
18319 # - resource-exhausted
18320 # - unavailable
18321 &quot;A String&quot;,
18322 ],
18323 },
18324 &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
18325 # time the request has been fully processed (known as *end-of-stream*)
18326 # up until the response has been processed. Timeout includes
18327 # all retries.
18328 #
18329 # If not specified, this field uses the largest timeout among all backend
18330 # services associated with the route.
18331 #
18332 # Not supported when the URL map is bound to a target gRPC proxy that
18333 # has validateForProxyless field set to true.
18334 # as a count of seconds and fractions of seconds at nanosecond
18335 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
18336 # or &quot;month&quot;. Range is approximately 10,000 years.
18337 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
18338 # Durations less than one second are represented with a 0
18339 # `seconds` field and a positive `nanos` field. Must be from 0
18340 # to 999,999,999 inclusive.
18341 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
18342 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
18343 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
18344 },
18345 &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
18346 # to the matched service.
18347 #
18348 # urlRewrite is the only action supported in UrlMaps
18349 # for classic Application Load Balancers.
18350 #
18351 # Not supported when the URL map is bound to a target gRPC proxy that
18352 # has the validateForProxyless field set to true.
18353 # backend service.
18354 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
18355 # host header is replaced with contents of hostRewrite.
18356 #
18357 # The value must be from 1 to 255 characters.
18358 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
18359 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
18360 #
18361 # The value must be from 1 to 1024 characters.
18362 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
18363 # header) using the HTTP template syntax.
18364 #
18365 # A corresponding
18366 # path_template_match must be specified. Any template variables must exist in
18367 # the path_template_match field.
18368 #
18369 #
18370 # - -At least one variable must be specified in the path_template_match
18371 # field
18372 # - You can omit variables from the rewritten URL
18373 # - The * and ** operators cannot be matched
18374 # unless they have a corresponding variable name - e.g.
18375 # {format=*} or {var=**}.
18376 #
18377 # For example, a path_template_match of /static/{format=**}
18378 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
18379 # rewrite, so that /{country}/{format}/{suffix=**} can be
18380 # rewritten as /content/{format}/{country}/{suffix}.
18381 #
18382 # At least
18383 # one non-empty routeRules[].matchRules[].path_template_match is
18384 # required.
18385 #
18386 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
18387 },
18388 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
18389 # occurs. The weights determine the fraction of traffic that flows to
18390 # their corresponding backend service. If all traffic needs to
18391 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
18392 #
18393 # After a backend service is identified and before forwarding
18394 # the request to
18395 # the backend service, advanced routing actions such as URL rewrites and
18396 # header transformations are applied depending on additional settings
18397 # specified in this HttpRouteAction.
18398 { # In contrast to a single BackendService in
18399 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
18400 # multiple backend services. The volume of traffic for each
18401 # backend service is proportional to the weight specified
18402 # in each WeightedBackendService
18403 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
18404 # resource. Before
18405 # forwarding the request to backendService, the load balancer
18406 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
18407 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
18408 # effect for the selected backendService.
18409 #
18410 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
18411 #
18412 # headerAction is not supported for load balancers that have
18413 # their loadBalancingScheme set to EXTERNAL.
18414 #
18415 # Not supported when the URL map is bound to a target gRPC proxy that
18416 # has validateForProxyless field set to true.
18417 # the request is passed along to the selected backendService.
18418 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
18419 { # Specification determining how headers are added to requests or responses.
18420 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
18421 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
18422 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
18423 # that already
18424 # exist for the header. If true, headerValue is set for the
18425 # header, discarding any values that were set for that header.
18426 #
18427 # The default value is true,
18428 # unless a variable is present in headerValue,
18429 # in which case the default value is false.
18430 # .
18431 },
18432 ],
18433 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
18434 # request before forwarding the request to the backendService.
18435 &quot;A String&quot;,
18436 ],
18437 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
18438 # client.
18439 { # Specification determining how headers are added to requests or responses.
18440 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
18441 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
18442 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
18443 # that already
18444 # exist for the header. If true, headerValue is set for the
18445 # header, discarding any values that were set for that header.
18446 #
18447 # The default value is true,
18448 # unless a variable is present in headerValue,
18449 # in which case the default value is false.
18450 # .
18451 },
18452 ],
18453 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
18454 # response before sending the response back to the client.
18455 &quot;A String&quot;,
18456 ],
18457 },
18458 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
18459 # computed asweight / (sum of all weightedBackendService weights in routeAction).
18460 #
18461 # The selection of a backend service is determined only for new traffic.
18462 # Once a user&#x27;s request has been directed to a backend service,
18463 # subsequent requests are sent to the same backend service as
18464 # determined by the backend service&#x27;s session affinity policy.
18465 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
18466 # splitting. If you do, the weighted traffic splitting configuration takes
18467 # precedence.
18468 #
18469 # The value must be from 0 to 1000.
18470 },
18471 ],
18472 },
18473 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
18474 # is directed if this rule is matched. If routeAction is
18475 # also specified, advanced routing actions, such as URL rewrites,
18476 # take effect before sending the request to the backend.
18477 #
18478 #
18479 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
18480 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
18481 # specified by urlRedirect.
18482 #
18483 #
18484 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
18485 #
18486 #
18487 # Not supported when the URL map is bound to a target gRPC proxy.
18488 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
18489 # was supplied in the request.
18490 #
18491 # The value must be from 1 to 255
18492 # characters.
18493 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
18494 # set to HTTPS.
18495 # If set to false, the URL scheme of the redirected request
18496 # remains the same as that of the request.
18497 #
18498 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
18499 #
18500 # The default is set to false.
18501 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
18502 # that was supplied in the request.
18503 #
18504 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
18505 # supplied, the path of the original request is used for the redirect.
18506 #
18507 # The value must be from 1 to 1024 characters.
18508 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
18509 # the HttpRouteRuleMatch, retaining the remaining portion
18510 # of the URL before redirecting the request.
18511 #
18512 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
18513 # supplied, the path of the original request is used for the redirect.
18514 #
18515 # The value must be from 1 to 1024 characters.
18516 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
18517 #
18518 # Supported values are:
18519 #
18520 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
18521 # to 301.
18522 # - FOUND, which corresponds to 302.
18523 # - SEE_OTHER which corresponds to 303.
18524 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
18525 # method is retained.
18526 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
18527 # method is retained.
18528 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
18529 # URL is
18530 # removed before redirecting the request. If set to false, the
18531 # query portion of the original URL is retained.
18532 #
18533 # The default is set to false.
18534 },
18535 },
18536 ],
18537 &quot;routeRules&quot;: [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
18538 # desired. routeRules are evaluated in order of priority, from
18539 # the lowest to highest number.
18540 #
18541 # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
18542 { # The HttpRouteRule setting specifies how to match an HTTP request
18543 # and the corresponding routing action that load balancing proxies perform.
18544 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
18545 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
18546 #
18547 # If a policy for an
18548 # error code is not configured for the RouteRule, a policy for
18549 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
18550 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
18551 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
18552 # effect.
18553 #
18554 # For example, consider a UrlMap with the following configuration:
18555 #
18556 #
18557 # - UrlMap.defaultCustomErrorResponsePolicy are configured
18558 # with policies for 5xx and 4xx errors
18559 # - A RouteRule for /coming_soon/ is configured for the
18560 # error code 404.
18561 #
18562 # 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
18563 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
18564 # the policy in RouteRule.customErrorResponsePolicy takes
18565 # effect. If any of the requests in this example encounter a 500
18566 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
18567 #
18568 # When
18569 # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
18570 # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
18571 # a retry, if load balancer is successful in reaching the
18572 # service, the customErrorResponsePolicy is ignored and
18573 # the response from the service is returned to the client.
18574 #
18575 # customErrorResponsePolicy is supported only for
18576 # global external Application Load Balancers.
18577 # backend service or backend bucket responds with an error.
18578 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
18579 #
18580 # In a given policy, if you specify rules for both a range of error codes
18581 # as well as rules for specific error codes then rules with specific error
18582 # codes have a higher priority. For example, assume that you configure a rule
18583 # for 401 (Un-authorized) code, and another for all 4 series
18584 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
18585 # However if the backend service returns a 403, the rule for4xx takes effect.
18586 { # Specifies the mapping between the response code that will be returned along
18587 # with the custom error content and the response code returned by the backend
18588 # service.
18589 &quot;matchResponseCodes&quot;: [ # Valid values include:
18590 #
18591 #
18592 # - A number between 400 and 599: For example
18593 # 401 or 503, in which case the load balancer
18594 # applies the policy if the error code exactly matches this value.
18595 # - 5xx: Load Balancer will apply the policy if the
18596 # backend service responds with any response code in the range of
18597 # 500 to 599.
18598 # - 4xx: Load
18599 # Balancer will apply the policy if the backend service responds with any
18600 # response code in the range of 400 to
18601 # 499.
18602 #
18603 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
18604 &quot;A String&quot;,
18605 ],
18606 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
18607 # error content. If overrideResponseCode is not supplied, the
18608 # same response code returned by the original backend bucket or backend
18609 # service is returned to the client.
18610 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
18611 #
18612 # path must start
18613 # with a leading slash. path cannot have trailing slashes.
18614 #
18615 # If the file is not available in backendBucket or the
18616 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
18617 #
18618 # The value must
18619 # be from 1 to 1024 characters
18620 },
18621 ],
18622 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
18623 # contains the custom error content. Examples are:
18624 #
18625 #
18626 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
18627 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
18628 # - global/backendBuckets/myBackendBucket
18629 #
18630 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
18631 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
18632 #
18633 # If load balancer cannot reach
18634 # the backendBucket, a simple Not Found Error will
18635 # be returned, with the original response code (oroverrideResponseCode if configured).
18636 #
18637 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
18638 },
18639 &quot;description&quot;: &quot;A String&quot;, # The short description conveying the intent of this routeRule.
18640 #
18641 #
18642 # The description can have a maximum length of 1024 characters.
18643 &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
18644 # for the selected backendService.
18645 #
18646 # The headerAction value specified here is applied before the
18647 # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
18648 #
18649 # HeaderAction is not supported for load balancers
18650 # that have
18651 # their loadBalancingScheme set to EXTERNAL.
18652 #
18653 # Not supported when the URL map is bound to a target gRPC proxy that
18654 # has validateForProxyless field set to true.
18655 # the request is passed along to the selected backendService.
18656 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
18657 { # Specification determining how headers are added to requests or responses.
18658 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
18659 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
18660 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
18661 # that already
18662 # exist for the header. If true, headerValue is set for the
18663 # header, discarding any values that were set for that header.
18664 #
18665 # The default value is true,
18666 # unless a variable is present in headerValue,
18667 # in which case the default value is false.
18668 # .
18669 },
18670 ],
18671 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
18672 # request before forwarding the request to the backendService.
18673 &quot;A String&quot;,
18674 ],
18675 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
18676 # client.
18677 { # Specification determining how headers are added to requests or responses.
18678 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
18679 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
18680 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
18681 # that already
18682 # exist for the header. If true, headerValue is set for the
18683 # header, discarding any values that were set for that header.
18684 #
18685 # The default value is true,
18686 # unless a variable is present in headerValue,
18687 # in which case the default value is false.
18688 # .
18689 },
18690 ],
18691 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
18692 # response before sending the response back to the client.
18693 &quot;A String&quot;,
18694 ],
18695 },
18696 &quot;httpFilterConfigs&quot;: [ # Outbound route specific configuration fornetworkservices.HttpFilter resources enabled by Traffic
18697 # Director. httpFilterConfigs only applies for load balancers
18698 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
18699 # more details.
18700 #
18701 # Not supported when the URL map is bound to a target gRPC proxy that
18702 # has validateForProxyless field set to true.
18703 { # HttpFilterConfiguration supplies additional contextual settings
18704 # for networkservices.HttpFilter resources enabled by Traffic
18705 # Director.
18706 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
18707 # YAML formatted and only contain fields defined in the protobuf identified
18708 # in configTypeUrl
18709 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
18710 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
18711 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
18712 # configuration belongs to. This name must be known to the xDS client.
18713 # Example: envoy.wasm
18714 },
18715 ],
18716 &quot;httpFilterMetadata&quot;: [ # Outbound route specific metadata supplied tonetworkservices.HttpFilter resources enabled by Traffic
18717 # Director. httpFilterMetadata only applies for load balancers
18718 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
18719 # more details.
18720 #
18721 # The only configTypeUrl supported istype.googleapis.com/google.protobuf.Struct
18722 #
18723 # Not supported when the URL map is bound to a target gRPC proxy that
18724 # has validateForProxyless field set to true.
18725 { # HttpFilterConfiguration supplies additional contextual settings
18726 # for networkservices.HttpFilter resources enabled by Traffic
18727 # Director.
18728 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
18729 # YAML formatted and only contain fields defined in the protobuf identified
18730 # in configTypeUrl
18731 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
18732 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
18733 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
18734 # configuration belongs to. This name must be known to the xDS client.
18735 # Example: envoy.wasm
18736 },
18737 ],
18738 &quot;matchRules&quot;: [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
18739 # this routeRule when any of thematchRules are satisfied. However predicates within
18740 # a given matchRule have AND semantics. All predicates
18741 # within a matchRule must match for the request to
18742 # match the rule.
18743 { # HttpRouteRuleMatch specifies a set of criteria for matching
18744 # requests to an HttpRouteRule. All specified criteria must
18745 # be satisfied for a match to occur.
18746 &quot;fullPathMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
18747 # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
18748 # that may be part of the original URL.
18749 #
18750 # fullPathMatch must be from 1 to 1024 characters.
18751 #
18752 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
18753 # specified.
18754 &quot;headerMatches&quot;: [ # Specifies a list of header match criteria, all of which must match
18755 # corresponding headers in the request.
18756 { # matchRule criteria for request header matches.
18757 &quot;exactMatch&quot;: &quot;A String&quot;, # The value should exactly match contents of exactMatch.
18758 #
18759 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
18760 &quot;headerName&quot;: &quot;A String&quot;, # The name of the HTTP header to match.
18761 #
18762 # For matching against the HTTP request&#x27;s authority, use a headerMatch
18763 # with the header name &quot;:authority&quot;.
18764 #
18765 # For matching a request&#x27;s method, use the headerName &quot;:method&quot;.
18766 #
18767 # When the URL map is bound to a target gRPC proxy that has
18768 # the validateForProxyless field set to true, only
18769 # non-binary
18770 # user-specified custom metadata and the `content-type` header are supported.
18771 # The following transport-level headers cannot be used in header matching
18772 # rules:
18773 # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
18774 # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
18775 # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
18776 # `grpc-timeout` and `grpc-trace-bin`.
18777 &quot;invertMatch&quot;: True or False, # If set to false, the headerMatch is considered a
18778 # match if the preceding match criteria are met. If set to true,
18779 # the headerMatch is considered a match if the preceding
18780 # match criteria are NOT met.
18781 #
18782 # The default setting is false.
18783 &quot;prefixMatch&quot;: &quot;A String&quot;, # The value of the header must start with the contents ofprefixMatch.
18784 #
18785 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
18786 &quot;presentMatch&quot;: True or False, # A header with the contents of headerName must exist. The
18787 # match takes place whether or not the request&#x27;s header has a value.
18788 #
18789 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
18790 &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
18791 # specified in rangeMatch. If the header does not contain an
18792 # integer, number or is empty, the match fails.
18793 #
18794 # For example for a range [-5, 0]
18795 #
18796 #
18797 # - -3 will match.
18798 # - 0 will not match.
18799 # - 0.25 will not match.
18800 # - -3someString will not match.
18801 #
18802 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
18803 #
18804 # rangeMatch is not supported for load balancers
18805 # that have loadBalancingScheme set to EXTERNAL.
18806 # within the specified integer range.
18807 &quot;rangeEnd&quot;: &quot;A String&quot;, # The end of the range (exclusive) in signed long integer format.
18808 &quot;rangeStart&quot;: &quot;A String&quot;, # The start of the range (inclusive) in signed long integer format.
18809 },
18810 &quot;regexMatch&quot;: &quot;A String&quot;, # The value of the header must match the regular expression specified inregexMatch.
18811 # For more information about regular expression syntax, see Syntax.
18812 #
18813 # For matching against a port specified in the HTTP request, use a
18814 # headerMatch with headerName set to PORT and a regular expression that
18815 # satisfies the RFC2616 Host header&#x27;s port specifier.
18816 #
18817 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
18818 #
18819 # Regular expressions can only be used when the loadBalancingScheme is
18820 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
18821 # (regional scope) or INTERNAL_MANAGED.
18822 &quot;suffixMatch&quot;: &quot;A String&quot;, # The value of the header must end with the contents ofsuffixMatch.
18823 #
18824 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
18825 },
18826 ],
18827 &quot;ignoreCase&quot;: True or False, # Specifies that prefixMatch and fullPathMatch
18828 # matches are case sensitive.
18829 #
18830 # The default value is false.
18831 #
18832 # ignoreCase must not be used with regexMatch.
18833 #
18834 # Not supported when the URL map is bound to a target gRPC proxy.
18835 &quot;metadataFilters&quot;: [ # Opaque filter criteria used by the load balancer to restrict routing
18836 # configuration to a limited set of xDS
18837 # compliant clients. In their xDS requests to the load balancer, xDS clients
18838 # present node
18839 # metadata. When there is a match, the relevant routing configuration
18840 # is made available to those proxies.
18841 #
18842 # 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
18843 # the metadata. If its filterMatchCriteria is set to
18844 # MATCH_ALL, then all of its filterLabels must match with
18845 # corresponding labels provided in the metadata. If multiple
18846 # metadata filters are specified, all of them need to be
18847 # satisfied in order to be considered a match.
18848 #
18849 # metadataFilters specified here is applied after those
18850 # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
18851 #
18852 # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
18853 #
18854 # Not supported when the URL map is bound to a target gRPC proxy that
18855 # has validateForProxyless field set to true.
18856 { # Opaque filter criteria used by load balancers to restrict routing
18857 # configuration to a limited set of load balancing proxies. Proxies and
18858 # sidecars involved in load balancing would typically present metadata to the
18859 # load balancers that need to match criteria specified here. If a match takes
18860 # place, the relevant configuration is made available to those
18861 # proxies.
18862 #
18863 # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
18864 # one of thefilterLabels must match the corresponding label provided in
18865 # the metadata. If its filterMatchCriteria is set to
18866 # MATCH_ALL, then all of its filterLabels must match with
18867 # corresponding labels provided in the metadata.
18868 #
18869 # An example for using metadataFilters would be: if
18870 # load balancing involves
18871 # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in of their XDS requests to loadbalancers.
18872 &quot;filterLabels&quot;: [ # The list of label value pairs that must match labels in the provided
18873 # metadata based on filterMatchCriteria
18874 #
18875 # This list must not be empty and can have at the most 64 entries.
18876 { # MetadataFilter label name value pairs that are expected
18877 # to match corresponding labels presented as metadata to the load balancer.
18878 &quot;name&quot;: &quot;A String&quot;, # Name of metadata label.
18879 #
18880 # The name can have a maximum length of 1024 characters and must be at
18881 # least 1 character long.
18882 &quot;value&quot;: &quot;A String&quot;, # The value of the label must match the specified value.
18883 #
18884 # value can have a maximum length of 1024 characters.
18885 },
18886 ],
18887 &quot;filterMatchCriteria&quot;: &quot;A String&quot;, # Specifies how individual filter label matches
18888 # within the list of filterLabels and contributes toward the
18889 # overall metadataFilter match.
18890 #
18891 # Supported values are:
18892 #
18893 # - MATCH_ANY: at least one of the filterLabels
18894 # must have a matching label in the provided metadata.
18895 # - MATCH_ALL: all filterLabels must have
18896 # matching labels in the provided metadata.
18897 },
18898 ],
18899 &quot;pathTemplateMatch&quot;: &quot;A String&quot;, # If specified, this field defines a path template pattern that must match
18900 # the :path header after the query string is removed.
18901 #
18902 # A path template pattern can include variables and wildcards.
18903 # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
18904 # matches a single path segment, and ** that matches zero or
18905 # more path segments. The pattern must follow these rules:
18906 #
18907 #
18908 # - The value must be between 1 and 1024 characters.
18909 # - The pattern must start with a leading slash (&quot;/&quot;).
18910 # - No more than 5 operators (variables or wildcards) may appear in
18911 # the pattern.
18912 #
18913 # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
18914 # set.
18915 &quot;prefixMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the request&#x27;s
18916 # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
18917 #
18918 # The value must be from 1 to 1024 characters.
18919 #
18920 # The * character inside a prefix match is
18921 # treated as a literal character, not as a wildcard.
18922 #
18923 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
18924 # used within a matchRule.
18925 &quot;queryParameterMatches&quot;: [ # Specifies a list of query parameter match criteria, all of which must
18926 # match corresponding query parameters in the request.
18927 #
18928 # Not supported when the URL map is bound to a target gRPC proxy.
18929 { # HttpRouteRuleMatch criteria for a request&#x27;s query parameter.
18930 &quot;exactMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
18931 # parameter exactly matches the contents of exactMatch.
18932 #
18933 # Only one of presentMatch, exactMatch, orregexMatch must be set.
18934 &quot;name&quot;: &quot;A String&quot;, # The name of the query parameter to match. The query parameter must exist in
18935 # the request, in the absence of which the request match fails.
18936 &quot;presentMatch&quot;: True or False, # Specifies that the queryParameterMatch matches if the
18937 # request contains the query parameter, irrespective of whether the
18938 # parameter has a value or not.
18939 #
18940 # Only one of presentMatch, exactMatch, orregexMatch must be set.
18941 &quot;regexMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
18942 # parameter matches the regular expression specified byregexMatch. For
18943 # more information about regular expression syntax, see Syntax.
18944 #
18945 # Only one of presentMatch, exactMatch, orregexMatch must be set.
18946 #
18947 # Regular expressions can only be used when the loadBalancingScheme is
18948 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
18949 # (regional scope) or INTERNAL_MANAGED.
18950 },
18951 ],
18952 &quot;regexMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
18953 # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
18954 # supplied with the original URL. For
18955 # more information about regular expression syntax, see Syntax.
18956 #
18957 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
18958 # specified.
18959 #
18960 # Regular expressions can only be used when the loadBalancingScheme is
18961 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
18962 # (regional scope) or INTERNAL_MANAGED.
18963 },
18964 ],
18965 &quot;priority&quot;: 42, # For routeRules within a given pathMatcher,
18966 # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
18967 # of priority, from the lowest to highest number. The priority of a
18968 # rule decreases as its number increases (1, 2, 3, N+1). The first rule
18969 # that matches the request is applied.
18970 #
18971 #
18972 # You cannot configure two or more routeRules with the same priority.
18973 # Priority for each rule must be set to a number from 0 to 2147483647
18974 # inclusive.
18975 #
18976 #
18977 # Priority numbers can have gaps, which enable you to add or remove rules
18978 # in the future without affecting the rest of the rules. For example, 1, 2,
18979 # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
18980 # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
18981 # without any impact on existing rules.
18982 &quot;routeAction&quot;: { # In response to a matching matchRule, the load balancer
18983 # performs advanced routing actions, such as URL rewrites and header
18984 # transformations, before forwarding the request to the selected backend.
18985 #
18986 #
18987 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
18988 #
18989 #
18990 # URL maps for classic Application Load Balancers only support
18991 # the urlRewrite action within a route rule&#x27;srouteAction.
18992 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
18993 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
18994 # property must be specified. This policy cannot be specified if any target
18995 # backend has Identity-Aware Proxy enabled.
18996 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
18997 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
18998 # header names can be specified. The cache is bypassed for all `cacheMode`
18999 # values.
19000 &quot;A String&quot;,
19001 ],
19002 &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
19003 # on the backend type: for Backend Services, the complete request URI is
19004 # used; for Backend Buckets, the request URI is used without the protocol or
19005 # host, and only query parameters known to Cloud Storage are included.
19006 # Policy defined on Route Action.
19007 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
19008 # parameters will be included. Either specify `excludedQueryParameters`
19009 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
19010 # encoded and not treated as delimiters.
19011 #
19012 # Note: This field applies to routes that use backend services. Attempting
19013 # to set it on a route that points exclusively to Backend Buckets will
19014 # result in a configuration error. For routes that point to a Backend
19015 # Bucket, use `includedQueryParameters` to define which parameters should
19016 # be part of the cache key.
19017 &quot;A String&quot;,
19018 ],
19019 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
19020 #
19021 # Note: This setting is only applicable to routes that use a Backend
19022 # Service. It does not affect requests served by a Backend Bucket, as the
19023 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
19024 # it on a route that points exclusively to Backend Buckets will result in a
19025 # configuration error.
19026 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
19027 #
19028 # Note: This setting is only applicable to routes that use a Backend
19029 # Service. It does not affect requests served by a Backend Bucket, as the
19030 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
19031 # set on a route that points exclusively to Backend Buckets will result in
19032 # a configuration error.
19033 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
19034 # `includedQueryParameters` and `excludedQueryParameters`. If neither
19035 # is set, the entire query string will be included. If false, the query
19036 # string will be excluded from the cache key entirely.
19037 #
19038 # Note: This field applies to routes that use backend services. Attempting
19039 # to set it on a route that points exclusively to Backend Buckets will
19040 # result in a configuration error. For routes that point to a Backend
19041 # Bucket, use `includedQueryParameters` to define which parameters should
19042 # be part of the cache key.
19043 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
19044 # The name=value pair will be used in the cache key Cloud CDN generates.
19045 #
19046 # Note: This setting is only applicable to routes that use a Backend
19047 # Service. It does not affect requests served by a Backend Bucket.
19048 # Attempting to set it on a route that points exclusively to Backend
19049 # Buckets will result in a configuration error. Up to 5 cookie names can be
19050 # specified.
19051 &quot;A String&quot;,
19052 ],
19053 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
19054 &quot;A String&quot;,
19055 ],
19056 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
19057 # parameters will be excluded. Either specify `includedQueryParameters`
19058 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
19059 # encoded and not treated as delimiters.
19060 &quot;A String&quot;,
19061 ],
19062 },
19063 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
19064 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
19065 &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
19066 # content. This is used to clamp the max-age (or Expires) value sent to the
19067 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
19068 # is used for the response max-age directive, along with a &quot;public&quot;
19069 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
19070 # clamps the max-age from the origin (if specified), or else sets the
19071 # response max-age directive to the lesser of the `clientTtl` and
19072 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
19073 # present. The maximum allowed value is 31,622,400s (1 year). If not
19074 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
19075 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
19076 # `USE_ORIGIN_HEADERS`.
19077 # as a count of seconds and fractions of seconds at nanosecond
19078 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19079 # or &quot;month&quot;. Range is approximately 10,000 years.
19080 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19081 # Durations less than one second are represented with a 0
19082 # `seconds` field and a positive `nanos` field. Must be from 0
19083 # to 999,999,999 inclusive.
19084 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19085 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19086 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19087 },
19088 &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
19089 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
19090 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
19091 # greater than that of `maxTtl`. When the `cacheMode` is set to
19092 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
19093 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
19094 # accessed objects may be evicted from the cache before the defined TTL. If
19095 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
19096 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
19097 # `USE_ORIGIN_HEADERS`.
19098 # as a count of seconds and fractions of seconds at nanosecond
19099 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19100 # or &quot;month&quot;. Range is approximately 10,000 years.
19101 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19102 # Durations less than one second are represented with a 0
19103 # `seconds` field and a positive `nanos` field. Must be from 0
19104 # to 999,999,999 inclusive.
19105 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19106 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19107 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19108 },
19109 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
19110 # attempt to set a max-age or s-maxage higher than this, or an Expires header
19111 # more than `maxTtl` seconds in the future will be capped at the value of
19112 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
19113 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
19114 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
19115 # Infrequently accessed objects may be evicted from the cache before the
19116 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
19117 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
19118 # mode.
19119 # as a count of seconds and fractions of seconds at nanosecond
19120 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19121 # or &quot;month&quot;. Range is approximately 10,000 years.
19122 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19123 # Durations less than one second are represented with a 0
19124 # `seconds` field and a positive `nanos` field. Must be from 0
19125 # to 999,999,999 inclusive.
19126 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19127 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19128 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19129 },
19130 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
19131 # to apply fine-grained caching for common errors or redirects.
19132 # This can reduce the load on your origin and improve end-user
19133 # experience by reducing response latency.
19134 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
19135 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
19136 # the specified response code that lack any Cache-Control, Expires, or
19137 # Pragma: no-cache directives. When the `cacheMode` is set to
19138 # `FORCE_CACHE_ALL`, negative caching applies to all responses
19139 # with the specified response code, and overrides any caching headers. By
19140 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
19141 #
19142 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
19143 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
19144 # * 405 (Method Not Found), 501 (Not Implemented): 60s
19145 #
19146 # These defaults can be overridden in `negativeCachingPolicy`.
19147 # If not specified, Cloud CDN applies negative caching by default.
19148 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
19149 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
19150 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
19151 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
19152 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
19153 # all response codes that you wish to cache. Cloud CDN will not apply any
19154 # default negative caching when a policy exists.
19155 { # Specify CDN TTLs for response error codes.
19156 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
19157 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
19158 # specified as values, and you cannot specify a status code more than
19159 # once.
19160 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
19161 # corresponding status code.
19162 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
19163 # objects may be evicted from the cache before the defined TTL.
19164 # as a count of seconds and fractions of seconds at nanosecond
19165 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19166 # or &quot;month&quot;. Range is approximately 10,000 years.
19167 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19168 # Durations less than one second are represented with a 0
19169 # `seconds` field and a positive `nanos` field. Must be from 0
19170 # to 999,999,999 inclusive.
19171 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19172 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19173 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19174 },
19175 },
19176 ],
19177 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
19178 # requests into a small number of requests to the origin. If not specified,
19179 # Cloud CDN applies request coalescing by default.
19180 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
19181 # content with the origin, or when an error is encountered when refreshing
19182 # the cache.
19183 # This setting defines the default &quot;max-stale&quot; duration for any cached
19184 # responses that do not specify a max-stale directive. Stale responses that
19185 # exceed the TTL configured here will not be served. The default limit
19186 # (max-stale) is 86400s (1 day), which will allow stale content to be
19187 # served up to this limit beyond the max-age (or s-maxage) of a cached
19188 # response.
19189 # The maximum allowed value is 604800 (1 week).
19190 # Set this to zero (0) to disable serve-while-stale.
19191 # as a count of seconds and fractions of seconds at nanosecond
19192 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19193 # or &quot;month&quot;. Range is approximately 10,000 years.
19194 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19195 # Durations less than one second are represented with a 0
19196 # `seconds` field and a positive `nanos` field. Must be from 0
19197 # to 999,999,999 inclusive.
19198 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19199 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19200 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19201 },
19202 },
19203 &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
19204 # information about the W3C recommendation for cross-origin resource sharing
19205 # (CORS), see Fetch API Living
19206 # Standard.
19207 #
19208 # Not supported when the URL map is bound to a target gRPC proxy.
19209 # information about the W3C recommendation for cross-origin resource sharing
19210 # (CORS), see Fetch API Living
19211 # Standard.
19212 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
19213 # indicates that
19214 # the actual request can include user credentials. This field translates to
19215 # the Access-Control-Allow-Credentials header.
19216 #
19217 # Default is false.
19218 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
19219 # header.
19220 &quot;A String&quot;,
19221 ],
19222 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
19223 # header.
19224 &quot;A String&quot;,
19225 ],
19226 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
19227 # more information, see regular expression syntax.
19228 #
19229 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
19230 #
19231 # Regular expressions can only be used when the loadBalancingScheme is
19232 # set to INTERNAL_SELF_MANAGED.
19233 &quot;A String&quot;,
19234 ],
19235 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
19236 #
19237 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
19238 &quot;A String&quot;,
19239 ],
19240 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
19241 # The default value is false, which indicates that the CORS
19242 # policy is in effect.
19243 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
19244 # header.
19245 &quot;A String&quot;,
19246 ],
19247 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
19248 # seconds. This field translates to the Access-Control-Max-Age
19249 # header.
19250 },
19251 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
19252 # the resiliency of clients to backend service failure. As part of fault
19253 # injection, when clients send requests to a backend service, delays can be
19254 # introduced by a load balancer on a percentage of requests before sending
19255 # those requests to the backend service. Similarly requests from clients can
19256 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
19257 # that are configured with a fault_injection_policy if:
19258 # 1. The traffic is generated by fault injection AND
19259 # 2. The fault injection is not a delay fault injection.
19260 # Fault injection is not supported with the classic Application Load Balancer
19261 # . To see which load balancers support fault injection,
19262 # see Load
19263 # balancing: Routing and traffic management features.
19264 # the resiliency of clients to backend service failure. As part of fault
19265 # injection, when clients send requests to a backend service, delays can be
19266 # introduced by the load balancer on a percentage of requests before sending
19267 # those request to the backend service. Similarly requests from clients can be
19268 # aborted by the load balancer for a percentage of requests.
19269 &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
19270 # injection.
19271 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
19272 #
19273 # The value must be from 200 to 599 inclusive.
19274 #
19275 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
19276 # according to this
19277 # mapping table. HTTP status 200 is mapped to gRPC status
19278 # UNKNOWN. Injecting an OK status is currently not supported by
19279 # Traffic Director.
19280 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
19281 # that is aborted as part of fault injection.
19282 #
19283 # The value must be from 0.0 to 100.0 inclusive.
19284 },
19285 &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
19286 # injection, before being sent to a backend service.
19287 # request to the backend service as part of fault injection.
19288 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
19289 # as a count of seconds and fractions of seconds at nanosecond
19290 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19291 # or &quot;month&quot;. Range is approximately 10,000 years.
19292 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19293 # Durations less than one second are represented with a 0
19294 # `seconds` field and a positive `nanos` field. Must be from 0
19295 # to 999,999,999 inclusive.
19296 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19297 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19298 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19299 },
19300 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
19301 # which a delay is introduced as part of fault injection.
19302 #
19303 # The value must be from 0.0 to 100.0 inclusive.
19304 },
19305 },
19306 &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
19307 # Global EXTERNAL_MANAGED load balancer schemes.
19308 # Either Cloud CDN must be enabled on the backend service or backend bucket
19309 # serving the route, or cache policy must be configured on the same route
19310 # dynamically processes and delivers images from the network edge.
19311 # Image Optimization is only available for Global External Application Load
19312 # Balancers.
19313 # Either Cloud CDN must be enabled on the backend service or backend bucket
19314 # serving the route, or cache policy must be configured on the same route.
19315 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
19316 },
19317 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
19318 # Unlike the timeout field where the timeout duration starts
19319 # from the time the request has been fully processed (known as*end-of-stream*),
19320 # the duration in this field is computed from the beginning of the stream
19321 # until the response has been processed, including all retries. A
19322 # stream that does not complete in this duration is closed.
19323 #
19324 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
19325 # with the route.
19326 #
19327 # This field is only allowed if the Url map is used with backend services
19328 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
19329 # as a count of seconds and fractions of seconds at nanosecond
19330 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19331 # or &quot;month&quot;. Range is approximately 10,000 years.
19332 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19333 # Durations less than one second are represented with a 0
19334 # `seconds` field and a positive `nanos` field. Must be from 0
19335 # to 999,999,999 inclusive.
19336 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19337 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19338 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19339 },
19340 &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
19341 # are shadowed to a separate mirrored backend service. The load balancer does
19342 # not wait for responses from the shadow service. Before sending traffic
19343 # to the shadow service, the host / authority header is suffixed with-shadow.
19344 #
19345 # Not supported when the URL map is bound to a target gRPC proxy that
19346 # has the validateForProxyless field set to true.
19347 # are shadowed to a separate mirrored backend service. The load balancer
19348 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
19349 # to the shadow service, the host or authority header is suffixed with-shadow.
19350 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
19351 # mirrored to.
19352 #
19353 # The backend service configured for a mirroring
19354 # policy must reference backends that are of the same type as the original
19355 # backend service matched in the URL map.
19356 #
19357 # Serverless NEG backends are not currently supported as a mirrored
19358 # backend service.
19359 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
19360 },
19361 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
19362 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
19363 # If not specified, defaults to 1.
19364 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
19365 #
19366 # If not specified, will use the timeout set in theHttpRouteAction field.
19367 # If timeout in the HttpRouteAction field is not set, this field
19368 # uses the largest timeout
19369 # among all backend services associated with the route.
19370 #
19371 # Not supported when the URL map is bound to a target gRPC proxy that
19372 # has the validateForProxyless field set to true.
19373 # as a count of seconds and fractions of seconds at nanosecond
19374 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19375 # or &quot;month&quot;. Range is approximately 10,000 years.
19376 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19377 # Durations less than one second are represented with a 0
19378 # `seconds` field and a positive `nanos` field. Must be from 0
19379 # to 999,999,999 inclusive.
19380 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19381 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19382 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19383 },
19384 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
19385 # values are:
19386 #
19387 # - 5xx: retry is attempted if the instance or endpoint
19388 # responds with any 5xx response code, or if the instance or
19389 # endpoint does not respond at all. For example, disconnects, reset, read
19390 # timeout, connection failure, and refused streams.
19391 # - gateway-error: Similar to 5xx, but only
19392 # applies to response codes 502, 503 or504.
19393 # - connect-failure: a retry is attempted on failures
19394 # connecting to the instance or endpoint. For example, connection
19395 # timeouts.
19396 # - retriable-4xx: a retry is attempted if the instance
19397 # or endpoint responds with a 4xx response code.
19398 # The only error that you can retry is error code 409.
19399 # - refused-stream: a retry is attempted if the instance
19400 # or endpoint resets the stream with a REFUSED_STREAM error
19401 # code. This reset type indicates that it is safe to retry.
19402 # - cancelled: a retry is attempted if the gRPC status
19403 # code in the response header is set to cancelled.
19404 # - deadline-exceeded: a retry is attempted if the gRPC
19405 # status code in the response header is set todeadline-exceeded.
19406 # - internal: a retry is attempted if the gRPC
19407 # status code in the response header is set tointernal.
19408 # - resource-exhausted: a retry is attempted if the gRPC
19409 # status code in the response header is set toresource-exhausted.
19410 # - unavailable: a retry is attempted if the gRPC
19411 # status code in the response header is set tounavailable.
19412 #
19413 # Only the following codes are supported when the URL map is bound to
19414 # target gRPC proxy that has validateForProxyless field set to true.
19415 #
19416 # - cancelled
19417 # - deadline-exceeded
19418 # - internal
19419 # - resource-exhausted
19420 # - unavailable
19421 &quot;A String&quot;,
19422 ],
19423 },
19424 &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
19425 # time the request has been fully processed (known as *end-of-stream*)
19426 # up until the response has been processed. Timeout includes
19427 # all retries.
19428 #
19429 # If not specified, this field uses the largest timeout among all backend
19430 # services associated with the route.
19431 #
19432 # Not supported when the URL map is bound to a target gRPC proxy that
19433 # has validateForProxyless field set to true.
19434 # as a count of seconds and fractions of seconds at nanosecond
19435 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
19436 # or &quot;month&quot;. Range is approximately 10,000 years.
19437 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
19438 # Durations less than one second are represented with a 0
19439 # `seconds` field and a positive `nanos` field. Must be from 0
19440 # to 999,999,999 inclusive.
19441 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
19442 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
19443 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
19444 },
19445 &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
19446 # to the matched service.
19447 #
19448 # urlRewrite is the only action supported in UrlMaps
19449 # for classic Application Load Balancers.
19450 #
19451 # Not supported when the URL map is bound to a target gRPC proxy that
19452 # has the validateForProxyless field set to true.
19453 # backend service.
19454 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
19455 # host header is replaced with contents of hostRewrite.
19456 #
19457 # The value must be from 1 to 255 characters.
19458 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
19459 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
19460 #
19461 # The value must be from 1 to 1024 characters.
19462 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
19463 # header) using the HTTP template syntax.
19464 #
19465 # A corresponding
19466 # path_template_match must be specified. Any template variables must exist in
19467 # the path_template_match field.
19468 #
19469 #
19470 # - -At least one variable must be specified in the path_template_match
19471 # field
19472 # - You can omit variables from the rewritten URL
19473 # - The * and ** operators cannot be matched
19474 # unless they have a corresponding variable name - e.g.
19475 # {format=*} or {var=**}.
19476 #
19477 # For example, a path_template_match of /static/{format=**}
19478 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
19479 # rewrite, so that /{country}/{format}/{suffix=**} can be
19480 # rewritten as /content/{format}/{country}/{suffix}.
19481 #
19482 # At least
19483 # one non-empty routeRules[].matchRules[].path_template_match is
19484 # required.
19485 #
19486 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
19487 },
19488 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
19489 # occurs. The weights determine the fraction of traffic that flows to
19490 # their corresponding backend service. If all traffic needs to
19491 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
19492 #
19493 # After a backend service is identified and before forwarding
19494 # the request to
19495 # the backend service, advanced routing actions such as URL rewrites and
19496 # header transformations are applied depending on additional settings
19497 # specified in this HttpRouteAction.
19498 { # In contrast to a single BackendService in
19499 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
19500 # multiple backend services. The volume of traffic for each
19501 # backend service is proportional to the weight specified
19502 # in each WeightedBackendService
19503 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
19504 # resource. Before
19505 # forwarding the request to backendService, the load balancer
19506 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
19507 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
19508 # effect for the selected backendService.
19509 #
19510 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
19511 #
19512 # headerAction is not supported for load balancers that have
19513 # their loadBalancingScheme set to EXTERNAL.
19514 #
19515 # Not supported when the URL map is bound to a target gRPC proxy that
19516 # has validateForProxyless field set to true.
19517 # the request is passed along to the selected backendService.
19518 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
19519 { # Specification determining how headers are added to requests or responses.
19520 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
19521 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
19522 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
19523 # that already
19524 # exist for the header. If true, headerValue is set for the
19525 # header, discarding any values that were set for that header.
19526 #
19527 # The default value is true,
19528 # unless a variable is present in headerValue,
19529 # in which case the default value is false.
19530 # .
19531 },
19532 ],
19533 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
19534 # request before forwarding the request to the backendService.
19535 &quot;A String&quot;,
19536 ],
19537 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
19538 # client.
19539 { # Specification determining how headers are added to requests or responses.
19540 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
19541 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
19542 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
19543 # that already
19544 # exist for the header. If true, headerValue is set for the
19545 # header, discarding any values that were set for that header.
19546 #
19547 # The default value is true,
19548 # unless a variable is present in headerValue,
19549 # in which case the default value is false.
19550 # .
19551 },
19552 ],
19553 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
19554 # response before sending the response back to the client.
19555 &quot;A String&quot;,
19556 ],
19557 },
19558 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
19559 # computed asweight / (sum of all weightedBackendService weights in routeAction).
19560 #
19561 # The selection of a backend service is determined only for new traffic.
19562 # Once a user&#x27;s request has been directed to a backend service,
19563 # subsequent requests are sent to the same backend service as
19564 # determined by the backend service&#x27;s session affinity policy.
19565 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
19566 # splitting. If you do, the weighted traffic splitting configuration takes
19567 # precedence.
19568 #
19569 # The value must be from 0 to 1000.
19570 },
19571 ],
19572 },
19573 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
19574 # is directed if this rule is matched. If routeAction is
19575 # also specified, advanced routing actions, such as URL rewrites,
19576 # take effect before sending the request to the backend.
19577 #
19578 #
19579 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
19580 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
19581 # specified by urlRedirect.
19582 #
19583 #
19584 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
19585 #
19586 #
19587 # Not supported when the URL map is bound to a target gRPC proxy.
19588 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
19589 # was supplied in the request.
19590 #
19591 # The value must be from 1 to 255
19592 # characters.
19593 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
19594 # set to HTTPS.
19595 # If set to false, the URL scheme of the redirected request
19596 # remains the same as that of the request.
19597 #
19598 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
19599 #
19600 # The default is set to false.
19601 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
19602 # that was supplied in the request.
19603 #
19604 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
19605 # supplied, the path of the original request is used for the redirect.
19606 #
19607 # The value must be from 1 to 1024 characters.
19608 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
19609 # the HttpRouteRuleMatch, retaining the remaining portion
19610 # of the URL before redirecting the request.
19611 #
19612 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
19613 # supplied, the path of the original request is used for the redirect.
19614 #
19615 # The value must be from 1 to 1024 characters.
19616 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
19617 #
19618 # Supported values are:
19619 #
19620 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
19621 # to 301.
19622 # - FOUND, which corresponds to 302.
19623 # - SEE_OTHER which corresponds to 303.
19624 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
19625 # method is retained.
19626 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
19627 # method is retained.
19628 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
19629 # URL is
19630 # removed before redirecting the request. If set to false, the
19631 # query portion of the original URL is retained.
19632 #
19633 # The default is set to false.
19634 },
19635 },
19636 ],
19637 },
19638 ],
19639 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the regional URL map resides.
19640 # This field is not applicable to global URL maps.
19641 # You must specify this field as part of the HTTP request URL. It is
19642 # not settable as a field in the request body.
19643 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
19644 &quot;status&quot;: { # [Output Only] The status of the URL map. # Output only. [Output Only] The status of the URL map.
19645 &quot;quotaUsage&quot;: { # Message representing the quota usage for a UrlMap. # Output only. Summary of quota usage for given UrlMap.
19646 &quot;forwardingRules&quot;: 42, # Output only. The number of forwarding rules that uses this UrlMap.
19647 &quot;units&quot;: &quot;A String&quot;, # Output only. The number of quota units calculated for this UrlMap.
19648 },
19649 },
19650 &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
19651 # maximum of 100 tests per UrlMap.
19652 #
19653 # Not supported when the URL map is bound to a target gRPC proxy that
19654 # has validateForProxyless field set to true.
19655 { # Message for the expected URL mappings.
19656 &quot;description&quot;: &quot;A String&quot;, # Description of this test case.
19657 &quot;expectedOutputUrl&quot;: &quot;A String&quot;, # The expected output URL evaluated by the load balancer
19658 # containing the scheme, host, path and query parameters.
19659 #
19660 # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
19661 # the load balancer to backends. For rules with urlRewrite,
19662 # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
19663 #
19664 # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer&#x27;s
19665 # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
19666 # If urlRedirect specifies strip_query, the test
19667 # passes only if expectedOutputUrl does not contain any query
19668 # parameters.
19669 #
19670 # expectedOutputUrl is optional whenservice is specified.
19671 &quot;expectedRedirectResponseCode&quot;: 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
19672 # load balancer&#x27;s redirect response.
19673 #
19674 # expectedRedirectResponseCode cannot be set whenservice is set.
19675 &quot;headers&quot;: [ # HTTP headers for this request. If headers contains
19676 # a host header, then host must also match the header value.
19677 { # HTTP headers used in UrlMapTests.
19678 &quot;name&quot;: &quot;A String&quot;, # Header name.
19679 &quot;value&quot;: &quot;A String&quot;, # Header value.
19680 },
19681 ],
19682 &quot;host&quot;: &quot;A String&quot;, # Host portion of the URL. If headers contains a host header,
19683 # then host must also match the header value.
19684 &quot;path&quot;: &quot;A String&quot;, # Path portion of the URL.
19685 &quot;service&quot;: &quot;A String&quot;, # Expected BackendService or BackendBucket resource
19686 # the given URL should be mapped to.
19687 #
19688 # The service field cannot
19689 # be set if expectedRedirectResponseCode is set.
19690 },
19691 ],
19692 }
19693
19694 requestId: string, begin_interface: MixerMutationRequestBuilder
19695 Request ID to support idempotency.
19696 x__xgafv: string, V1 error format.
19697 Allowed values
19698 1 - v1 error format
19699 2 - v2 error format
19700
19701 Returns:
19702 An object of the form:
19703
19704 { # Represents an Operation resource.
19705 #
19706 # Google Compute Engine has three Operation resources:
19707 #
19708 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
19709 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
19710 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
19711 #
19712 # You can use an operation resource to manage asynchronous API requests.
19713 # For more information, readHandling
19714 # API responses.
19715 #
19716 # Operations can be global, regional or zonal.
19717 #
19718 # - For global operations, use the `globalOperations`
19719 # resource.
19720 # - For regional operations, use the
19721 # `regionOperations` resource.
19722 # - For zonal operations, use
19723 # the `zoneOperations` resource.
19724 #
19725 #
19726 #
19727 # For more information, read
19728 # Global, Regional, and Zonal Resources.
19729 #
19730 # Note that completed Operation resources have a limited
19731 # retention period.
19732 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
19733 # Not present otherwise.
19734 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
19735 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
19736 # set when the operation is created.
19737 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
19738 # text format.
19739 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
19740 # this field will be populated.
19741 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
19742 # operation.
19743 {
19744 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
19745 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
19746 # details. There is a set of defined message types to use for providing
19747 # details.The syntax depends on the error code. For example,
19748 # QuotaExceededInfo will have details when the error code is
19749 # QUOTA_EXCEEDED.
19750 {
19751 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
19752 #
19753 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
19754 # is not enabled:
19755 #
19756 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
19757 # &quot;domain&quot;: &quot;googleapis.com&quot;
19758 # &quot;metadata&quot;: {
19759 # &quot;resource&quot;: &quot;projects/123&quot;,
19760 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
19761 # }
19762 # }
19763 #
19764 # This response indicates that the pubsub.googleapis.com API is not enabled.
19765 #
19766 # Example of an error that is returned when attempting to create a Spanner
19767 # instance in a region that is out of stock:
19768 #
19769 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
19770 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
19771 # &quot;metadata&quot;: {
19772 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
19773 # }
19774 # }
19775 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
19776 # is typically the registered service name of the tool or product that
19777 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
19778 # generated by some common infrastructure, the error domain must be a
19779 # globally unique value that identifies the infrastructure. For Google API
19780 # infrastructure, the error domain is &quot;googleapis.com&quot;.
19781 &quot;metadatas&quot;: { # Additional structured details about this error.
19782 #
19783 # Keys must match a regular expression of `a-z+` but should
19784 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
19785 # length. When identifying the current value of an exceeded limit, the units
19786 # should be contained in the key, not the value. For example, rather than
19787 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
19788 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
19789 # instances that can be created in a single (batch) request.
19790 &quot;a_key&quot;: &quot;A String&quot;,
19791 },
19792 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
19793 # proximate cause of the error. Error reasons are unique within a particular
19794 # domain of errors. This should be at most 63 characters and match a
19795 # regular expression of `A-Z+[A-Z0-9]`, which represents
19796 # UPPER_SNAKE_CASE.
19797 },
19798 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
19799 #
19800 # For example, if a quota check failed with an error indicating the calling
19801 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
19802 # directly to the right place in the developer console to flip the bit.
19803 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
19804 { # Describes a URL link.
19805 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
19806 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
19807 },
19808 ],
19809 },
19810 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
19811 # which can be attached to an RPC error.
19812 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
19813 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
19814 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
19815 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
19816 },
19817 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
19818 &quot;dimensions&quot;: { # The map holding related quota dimensions.
19819 &quot;a_key&quot;: &quot;A String&quot;,
19820 },
19821 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
19822 # type or metric.
19823 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
19824 # or metric.
19825 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
19826 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
19827 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
19828 },
19829 },
19830 ],
19831 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
19832 # This property is optional.
19833 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
19834 },
19835 ],
19836 },
19837 &quot;getVersionOperationMetadata&quot;: {
19838 &quot;inlineSbomInfo&quot;: {
19839 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
19840 # appropriate identifiers.
19841 &quot;a_key&quot;: &quot;A String&quot;,
19842 },
19843 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
19844 # identifiers.
19845 &quot;a_key&quot;: &quot;A String&quot;,
19846 },
19847 },
19848 },
19849 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
19850 # message that was returned, such as `NOT FOUND`.
19851 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
19852 # status code that was returned. For example, a `404` means the
19853 # resource was not found.
19854 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
19855 # defined by the server.
19856 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
19857 # This value is inRFC3339
19858 # text format.
19859 &quot;instancesBulkInsertOperationMetadata&quot;: {
19860 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
19861 # Example key: zones/us-central1-a
19862 &quot;a_key&quot;: {
19863 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
19864 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
19865 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
19866 # error.
19867 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
19868 # if the flow is rolling forward or rolling back.
19869 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
19870 },
19871 },
19872 },
19873 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
19874 # Operation resources.
19875 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
19876 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
19877 # group of operations results from a `bulkInsert` API request.
19878 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
19879 # `update`, or `delete`, and so on.
19880 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
19881 # There is no requirement that this be linear or support any granularity of
19882 # operations. This should not be used to guess when the operation will be
19883 # complete. This number should monotonically increase as the operation
19884 # progresses.
19885 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
19886 # applicable when performing regional operations.
19887 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
19888 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
19889 # this field will contain information on all underlying zonal actions and
19890 # their state.
19891 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
19892 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
19893 # Example key: zones/us-central1-a
19894 &quot;a_key&quot;: {
19895 &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
19896 # populated.
19897 # different programming environments, including REST APIs and RPC APIs. It is
19898 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
19899 # three pieces of data: error code, error message, and error details.
19900 #
19901 # You can find out more about this error model and how to work with it in the
19902 # [API Design Guide](https://cloud.google.com/apis/design/errors).
19903 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
19904 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
19905 # message types for APIs to use.
19906 {
19907 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
19908 },
19909 ],
19910 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
19911 # user-facing error message should be localized and sent in the
19912 # google.rpc.Status.details field, or localized by the client.
19913 },
19914 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
19915 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
19916 },
19917 },
19918 },
19919 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
19920 # This value is inRFC3339
19921 # text format.
19922 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
19923 # following:
19924 # `PENDING`, `RUNNING`, or `DONE`.
19925 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
19926 # operation.
19927 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
19928 # of the target resource.
19929 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
19930 # operations related to creating a snapshot, this points to the disk
19931 # that the snapshot was created from.
19932 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
19933 # `[email protected]` or
19934 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
19935 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
19936 # operation, this field will be populated.
19937 {
19938 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
19939 # Engine returns NO_RESULTS_ON_PAGE if there
19940 # are no results in the response.
19941 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
19942 # value format. For example:
19943 #
19944 # &quot;data&quot;: [
19945 # {
19946 # &quot;key&quot;: &quot;scope&quot;,
19947 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
19948 # }
19949 {
19950 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
19951 # returned. For example, for warnings where there are no results in a list
19952 # request for a particular zone, this key might be scope and
19953 # the key value might be the zone name. Other examples might be a key
19954 # indicating a deprecated resource and a suggested replacement, or a
19955 # warning about invalid network settings (for example, if an instance
19956 # attempts to perform IP forwarding but is not enabled for IP forwarding).
19957 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
19958 },
19959 ],
19960 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
19961 },
19962 ],
19963 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
19964 # applicable when performing per-zone operations.
19965 }</pre>
19966 </div>
19967
19968 <div class="method">
19969 <code class="details" id="validate">validate(project, region, urlMap, body=None, x__xgafv=None)</code>
19970 <pre>Runs static validation for the UrlMap. In particular, the tests of the
19971 provided UrlMap will be run. Calling this method does NOT create the
19972 UrlMap.
19973
19974 Args:
19975 project: string, Project ID for this request. (required)
19976 region: string, Name of the region scoping this request. (required)
19977 urlMap: string, Name of the UrlMap resource to be validated as. (required)
19978 body: object, The request body.
19979 The object takes the form of:
19980
19981 {
19982 &quot;resource&quot;: { # Represents a URL Map resource. # Content of the UrlMap to be validated.
19983 #
19984 # Compute Engine has two URL Map resources:
19985 #
19986 # * [Global](/compute/docs/reference/rest/beta/urlMaps)
19987 # * [Regional](/compute/docs/reference/rest/beta/regionUrlMaps)
19988 #
19989 # A URL map resource is a component of certain types of cloud load balancers
19990 # and Traffic Director:
19991 #
19992 # * urlMaps are used by global external Application Load
19993 # Balancers, classic Application Load Balancers, and cross-region internal
19994 # Application Load Balancers.
19995 # * regionUrlMaps are used by internal Application Load Balancers,
19996 # regional external Application Load Balancers and regional internal
19997 # Application Load Balancers.
19998 #
19999 # For a list of supported URL map features by the load balancer type, see the
20000 # Load balancing features: Routing and traffic management table.
20001 #
20002 # For a list of supported URL map features for Traffic Director, see the
20003 # Traffic Director features: Routing and traffic management table.
20004 #
20005 # This resource defines mappings from hostnames and URL paths to either a
20006 # backend service or a backend bucket.
20007 #
20008 # To use the global urlMaps resource, the backend service must
20009 # have a loadBalancingScheme of either EXTERNAL,EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use
20010 # the regionUrlMaps resource, the backend service must have aloadBalancingScheme of INTERNAL_MANAGED. For more
20011 # information, read URL
20012 # Map Concepts.
20013 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
20014 # text format.
20015 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
20016 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
20017 #
20018 # This policy takes
20019 # effect at the load balancer level and applies only when no policy has been
20020 # defined for the error code at lower levels like PathMatcher, RouteRule and
20021 # PathRule within this UrlMap.
20022 #
20023 # For example, consider a UrlMap with the
20024 # following configuration:
20025 #
20026 #
20027 # - defaultCustomErrorResponsePolicy containing policies for
20028 # responding to 5xx and 4xx errors
20029 # - A PathMatcher configured for *.example.com has
20030 # defaultCustomErrorResponsePolicy for 4xx.
20031 #
20032 # If a request for http://www.example.com/ encounters a404, the policy inpathMatcher.defaultCustomErrorResponsePolicy will be enforced.
20033 # When the request for http://www.example.com/ encounters a502, the policy inUrlMap.defaultCustomErrorResponsePolicy will be enforced. When
20034 # a request that does not match any host in *.example.com such
20035 # as http://www.myotherexample.com/, encounters a404, UrlMap.defaultCustomErrorResponsePolicy
20036 # takes effect.
20037 #
20038 # When used in conjunction withdefaultRouteAction.retryPolicy, retries take precedence. Only
20039 # once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
20040 # a retry, if load balancer is successful in reaching the
20041 # service, the defaultCustomErrorResponsePolicy is ignored and
20042 # the response from the service is returned to the client.
20043 #
20044 # defaultCustomErrorResponsePolicy is supported only for
20045 # global external Application Load Balancers.
20046 # backend service or backend bucket responds with an error.
20047 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
20048 #
20049 # In a given policy, if you specify rules for both a range of error codes
20050 # as well as rules for specific error codes then rules with specific error
20051 # codes have a higher priority. For example, assume that you configure a rule
20052 # for 401 (Un-authorized) code, and another for all 4 series
20053 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
20054 # However if the backend service returns a 403, the rule for4xx takes effect.
20055 { # Specifies the mapping between the response code that will be returned along
20056 # with the custom error content and the response code returned by the backend
20057 # service.
20058 &quot;matchResponseCodes&quot;: [ # Valid values include:
20059 #
20060 #
20061 # - A number between 400 and 599: For example
20062 # 401 or 503, in which case the load balancer
20063 # applies the policy if the error code exactly matches this value.
20064 # - 5xx: Load Balancer will apply the policy if the
20065 # backend service responds with any response code in the range of
20066 # 500 to 599.
20067 # - 4xx: Load
20068 # Balancer will apply the policy if the backend service responds with any
20069 # response code in the range of 400 to
20070 # 499.
20071 #
20072 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
20073 &quot;A String&quot;,
20074 ],
20075 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
20076 # error content. If overrideResponseCode is not supplied, the
20077 # same response code returned by the original backend bucket or backend
20078 # service is returned to the client.
20079 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
20080 #
20081 # path must start
20082 # with a leading slash. path cannot have trailing slashes.
20083 #
20084 # If the file is not available in backendBucket or the
20085 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
20086 #
20087 # The value must
20088 # be from 1 to 1024 characters
20089 },
20090 ],
20091 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
20092 # contains the custom error content. Examples are:
20093 #
20094 #
20095 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
20096 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
20097 # - global/backendBuckets/myBackendBucket
20098 #
20099 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
20100 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
20101 #
20102 # If load balancer cannot reach
20103 # the backendBucket, a simple Not Found Error will
20104 # be returned, with the original response code (oroverrideResponseCode if configured).
20105 #
20106 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
20107 },
20108 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
20109 # hostRules match. The load balancer performs advanced routing
20110 # actions, such as URL rewrites and header transformations, before forwarding
20111 # the request to the selected backend.
20112 #
20113 #
20114 # Only one of defaultUrlRedirect, defaultService
20115 # or defaultRouteAction.weightedBackendService can be set.
20116 #
20117 #
20118 # URL maps for classic Application Load Balancers only support
20119 # the urlRewrite action within defaultRouteAction.
20120 #
20121 #
20122 # defaultRouteAction has no effect when the URL map is bound
20123 # to a target gRPC proxy that has the validateForProxyless field
20124 # set to true.
20125 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
20126 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
20127 # property must be specified. This policy cannot be specified if any target
20128 # backend has Identity-Aware Proxy enabled.
20129 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
20130 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
20131 # header names can be specified. The cache is bypassed for all `cacheMode`
20132 # values.
20133 &quot;A String&quot;,
20134 ],
20135 &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
20136 # on the backend type: for Backend Services, the complete request URI is
20137 # used; for Backend Buckets, the request URI is used without the protocol or
20138 # host, and only query parameters known to Cloud Storage are included.
20139 # Policy defined on Route Action.
20140 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
20141 # parameters will be included. Either specify `excludedQueryParameters`
20142 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
20143 # encoded and not treated as delimiters.
20144 #
20145 # Note: This field applies to routes that use backend services. Attempting
20146 # to set it on a route that points exclusively to Backend Buckets will
20147 # result in a configuration error. For routes that point to a Backend
20148 # Bucket, use `includedQueryParameters` to define which parameters should
20149 # be part of the cache key.
20150 &quot;A String&quot;,
20151 ],
20152 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
20153 #
20154 # Note: This setting is only applicable to routes that use a Backend
20155 # Service. It does not affect requests served by a Backend Bucket, as the
20156 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
20157 # it on a route that points exclusively to Backend Buckets will result in a
20158 # configuration error.
20159 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
20160 #
20161 # Note: This setting is only applicable to routes that use a Backend
20162 # Service. It does not affect requests served by a Backend Bucket, as the
20163 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
20164 # set on a route that points exclusively to Backend Buckets will result in
20165 # a configuration error.
20166 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
20167 # `includedQueryParameters` and `excludedQueryParameters`. If neither
20168 # is set, the entire query string will be included. If false, the query
20169 # string will be excluded from the cache key entirely.
20170 #
20171 # Note: This field applies to routes that use backend services. Attempting
20172 # to set it on a route that points exclusively to Backend Buckets will
20173 # result in a configuration error. For routes that point to a Backend
20174 # Bucket, use `includedQueryParameters` to define which parameters should
20175 # be part of the cache key.
20176 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
20177 # The name=value pair will be used in the cache key Cloud CDN generates.
20178 #
20179 # Note: This setting is only applicable to routes that use a Backend
20180 # Service. It does not affect requests served by a Backend Bucket.
20181 # Attempting to set it on a route that points exclusively to Backend
20182 # Buckets will result in a configuration error. Up to 5 cookie names can be
20183 # specified.
20184 &quot;A String&quot;,
20185 ],
20186 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
20187 &quot;A String&quot;,
20188 ],
20189 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
20190 # parameters will be excluded. Either specify `includedQueryParameters`
20191 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
20192 # encoded and not treated as delimiters.
20193 &quot;A String&quot;,
20194 ],
20195 },
20196 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
20197 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
20198 &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
20199 # content. This is used to clamp the max-age (or Expires) value sent to the
20200 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
20201 # is used for the response max-age directive, along with a &quot;public&quot;
20202 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
20203 # clamps the max-age from the origin (if specified), or else sets the
20204 # response max-age directive to the lesser of the `clientTtl` and
20205 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
20206 # present. The maximum allowed value is 31,622,400s (1 year). If not
20207 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
20208 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
20209 # `USE_ORIGIN_HEADERS`.
20210 # as a count of seconds and fractions of seconds at nanosecond
20211 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
20212 # or &quot;month&quot;. Range is approximately 10,000 years.
20213 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
20214 # Durations less than one second are represented with a 0
20215 # `seconds` field and a positive `nanos` field. Must be from 0
20216 # to 999,999,999 inclusive.
20217 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
20218 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
20219 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
20220 },
20221 &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
20222 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
20223 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
20224 # greater than that of `maxTtl`. When the `cacheMode` is set to
20225 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
20226 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
20227 # accessed objects may be evicted from the cache before the defined TTL. If
20228 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
20229 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
20230 # `USE_ORIGIN_HEADERS`.
20231 # as a count of seconds and fractions of seconds at nanosecond
20232 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
20233 # or &quot;month&quot;. Range is approximately 10,000 years.
20234 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
20235 # Durations less than one second are represented with a 0
20236 # `seconds` field and a positive `nanos` field. Must be from 0
20237 # to 999,999,999 inclusive.
20238 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
20239 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
20240 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
20241 },
20242 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
20243 # attempt to set a max-age or s-maxage higher than this, or an Expires header
20244 # more than `maxTtl` seconds in the future will be capped at the value of
20245 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
20246 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
20247 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
20248 # Infrequently accessed objects may be evicted from the cache before the
20249 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
20250 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
20251 # mode.
20252 # as a count of seconds and fractions of seconds at nanosecond
20253 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
20254 # or &quot;month&quot;. Range is approximately 10,000 years.
20255 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
20256 # Durations less than one second are represented with a 0
20257 # `seconds` field and a positive `nanos` field. Must be from 0
20258 # to 999,999,999 inclusive.
20259 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
20260 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
20261 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
20262 },
20263 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
20264 # to apply fine-grained caching for common errors or redirects.
20265 # This can reduce the load on your origin and improve end-user
20266 # experience by reducing response latency.
20267 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
20268 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
20269 # the specified response code that lack any Cache-Control, Expires, or
20270 # Pragma: no-cache directives. When the `cacheMode` is set to
20271 # `FORCE_CACHE_ALL`, negative caching applies to all responses
20272 # with the specified response code, and overrides any caching headers. By
20273 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
20274 #
20275 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
20276 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
20277 # * 405 (Method Not Found), 501 (Not Implemented): 60s
20278 #
20279 # These defaults can be overridden in `negativeCachingPolicy`.
20280 # If not specified, Cloud CDN applies negative caching by default.
20281 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
20282 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
20283 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
20284 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
20285 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
20286 # all response codes that you wish to cache. Cloud CDN will not apply any
20287 # default negative caching when a policy exists.
20288 { # Specify CDN TTLs for response error codes.
20289 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
20290 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
20291 # specified as values, and you cannot specify a status code more than
20292 # once.
20293 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
20294 # corresponding status code.
20295 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
20296 # objects may be evicted from the cache before the defined TTL.
20297 # as a count of seconds and fractions of seconds at nanosecond
20298 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
20299 # or &quot;month&quot;. Range is approximately 10,000 years.
20300 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
20301 # Durations less than one second are represented with a 0
20302 # `seconds` field and a positive `nanos` field. Must be from 0
20303 # to 999,999,999 inclusive.
20304 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
20305 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
20306 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
20307 },
20308 },
20309 ],
20310 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
20311 # requests into a small number of requests to the origin. If not specified,
20312 # Cloud CDN applies request coalescing by default.
20313 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
20314 # content with the origin, or when an error is encountered when refreshing
20315 # the cache.
20316 # This setting defines the default &quot;max-stale&quot; duration for any cached
20317 # responses that do not specify a max-stale directive. Stale responses that
20318 # exceed the TTL configured here will not be served. The default limit
20319 # (max-stale) is 86400s (1 day), which will allow stale content to be
20320 # served up to this limit beyond the max-age (or s-maxage) of a cached
20321 # response.
20322 # The maximum allowed value is 604800 (1 week).
20323 # Set this to zero (0) to disable serve-while-stale.
20324 # as a count of seconds and fractions of seconds at nanosecond
20325 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
20326 # or &quot;month&quot;. Range is approximately 10,000 years.
20327 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
20328 # Durations less than one second are represented with a 0
20329 # `seconds` field and a positive `nanos` field. Must be from 0
20330 # to 999,999,999 inclusive.
20331 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
20332 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
20333 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
20334 },
20335 },
20336 &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
20337 # information about the W3C recommendation for cross-origin resource sharing
20338 # (CORS), see Fetch API Living
20339 # Standard.
20340 #
20341 # Not supported when the URL map is bound to a target gRPC proxy.
20342 # information about the W3C recommendation for cross-origin resource sharing
20343 # (CORS), see Fetch API Living
20344 # Standard.
20345 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
20346 # indicates that
20347 # the actual request can include user credentials. This field translates to
20348 # the Access-Control-Allow-Credentials header.
20349 #
20350 # Default is false.
20351 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
20352 # header.
20353 &quot;A String&quot;,
20354 ],
20355 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
20356 # header.
20357 &quot;A String&quot;,
20358 ],
20359 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
20360 # more information, see regular expression syntax.
20361 #
20362 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
20363 #
20364 # Regular expressions can only be used when the loadBalancingScheme is
20365 # set to INTERNAL_SELF_MANAGED.
20366 &quot;A String&quot;,
20367 ],
20368 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
20369 #
20370 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
20371 &quot;A String&quot;,
20372 ],
20373 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
20374 # The default value is false, which indicates that the CORS
20375 # policy is in effect.
20376 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
20377 # header.
20378 &quot;A String&quot;,
20379 ],
20380 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
20381 # seconds. This field translates to the Access-Control-Max-Age
20382 # header.
20383 },
20384 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
20385 # the resiliency of clients to backend service failure. As part of fault
20386 # injection, when clients send requests to a backend service, delays can be
20387 # introduced by a load balancer on a percentage of requests before sending
20388 # those requests to the backend service. Similarly requests from clients can
20389 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
20390 # that are configured with a fault_injection_policy if:
20391 # 1. The traffic is generated by fault injection AND
20392 # 2. The fault injection is not a delay fault injection.
20393 # Fault injection is not supported with the classic Application Load Balancer
20394 # . To see which load balancers support fault injection,
20395 # see Load
20396 # balancing: Routing and traffic management features.
20397 # the resiliency of clients to backend service failure. As part of fault
20398 # injection, when clients send requests to a backend service, delays can be
20399 # introduced by the load balancer on a percentage of requests before sending
20400 # those request to the backend service. Similarly requests from clients can be
20401 # aborted by the load balancer for a percentage of requests.
20402 &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
20403 # injection.
20404 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
20405 #
20406 # The value must be from 200 to 599 inclusive.
20407 #
20408 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
20409 # according to this
20410 # mapping table. HTTP status 200 is mapped to gRPC status
20411 # UNKNOWN. Injecting an OK status is currently not supported by
20412 # Traffic Director.
20413 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
20414 # that is aborted as part of fault injection.
20415 #
20416 # The value must be from 0.0 to 100.0 inclusive.
20417 },
20418 &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
20419 # injection, before being sent to a backend service.
20420 # request to the backend service as part of fault injection.
20421 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
20422 # as a count of seconds and fractions of seconds at nanosecond
20423 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
20424 # or &quot;month&quot;. Range is approximately 10,000 years.
20425 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
20426 # Durations less than one second are represented with a 0
20427 # `seconds` field and a positive `nanos` field. Must be from 0
20428 # to 999,999,999 inclusive.
20429 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
20430 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
20431 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
20432 },
20433 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
20434 # which a delay is introduced as part of fault injection.
20435 #
20436 # The value must be from 0.0 to 100.0 inclusive.
20437 },
20438 },
20439 &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
20440 # Global EXTERNAL_MANAGED load balancer schemes.
20441 # Either Cloud CDN must be enabled on the backend service or backend bucket
20442 # serving the route, or cache policy must be configured on the same route
20443 # dynamically processes and delivers images from the network edge.
20444 # Image Optimization is only available for Global External Application Load
20445 # Balancers.
20446 # Either Cloud CDN must be enabled on the backend service or backend bucket
20447 # serving the route, or cache policy must be configured on the same route.
20448 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
20449 },
20450 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
20451 # Unlike the timeout field where the timeout duration starts
20452 # from the time the request has been fully processed (known as*end-of-stream*),
20453 # the duration in this field is computed from the beginning of the stream
20454 # until the response has been processed, including all retries. A
20455 # stream that does not complete in this duration is closed.
20456 #
20457 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
20458 # with the route.
20459 #
20460 # This field is only allowed if the Url map is used with backend services
20461 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
20462 # as a count of seconds and fractions of seconds at nanosecond
20463 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
20464 # or &quot;month&quot;. Range is approximately 10,000 years.
20465 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
20466 # Durations less than one second are represented with a 0
20467 # `seconds` field and a positive `nanos` field. Must be from 0
20468 # to 999,999,999 inclusive.
20469 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
20470 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
20471 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
20472 },
20473 &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
20474 # are shadowed to a separate mirrored backend service. The load balancer does
20475 # not wait for responses from the shadow service. Before sending traffic
20476 # to the shadow service, the host / authority header is suffixed with-shadow.
20477 #
20478 # Not supported when the URL map is bound to a target gRPC proxy that
20479 # has the validateForProxyless field set to true.
20480 # are shadowed to a separate mirrored backend service. The load balancer
20481 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
20482 # to the shadow service, the host or authority header is suffixed with-shadow.
20483 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
20484 # mirrored to.
20485 #
20486 # The backend service configured for a mirroring
20487 # policy must reference backends that are of the same type as the original
20488 # backend service matched in the URL map.
20489 #
20490 # Serverless NEG backends are not currently supported as a mirrored
20491 # backend service.
20492 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
20493 },
20494 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
20495 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
20496 # If not specified, defaults to 1.
20497 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
20498 #
20499 # If not specified, will use the timeout set in theHttpRouteAction field.
20500 # If timeout in the HttpRouteAction field is not set, this field
20501 # uses the largest timeout
20502 # among all backend services associated with the route.
20503 #
20504 # Not supported when the URL map is bound to a target gRPC proxy that
20505 # has the validateForProxyless field set to true.
20506 # as a count of seconds and fractions of seconds at nanosecond
20507 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
20508 # or &quot;month&quot;. Range is approximately 10,000 years.
20509 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
20510 # Durations less than one second are represented with a 0
20511 # `seconds` field and a positive `nanos` field. Must be from 0
20512 # to 999,999,999 inclusive.
20513 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
20514 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
20515 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
20516 },
20517 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
20518 # values are:
20519 #
20520 # - 5xx: retry is attempted if the instance or endpoint
20521 # responds with any 5xx response code, or if the instance or
20522 # endpoint does not respond at all. For example, disconnects, reset, read
20523 # timeout, connection failure, and refused streams.
20524 # - gateway-error: Similar to 5xx, but only
20525 # applies to response codes 502, 503 or504.
20526 # - connect-failure: a retry is attempted on failures
20527 # connecting to the instance or endpoint. For example, connection
20528 # timeouts.
20529 # - retriable-4xx: a retry is attempted if the instance
20530 # or endpoint responds with a 4xx response code.
20531 # The only error that you can retry is error code 409.
20532 # - refused-stream: a retry is attempted if the instance
20533 # or endpoint resets the stream with a REFUSED_STREAM error
20534 # code. This reset type indicates that it is safe to retry.
20535 # - cancelled: a retry is attempted if the gRPC status
20536 # code in the response header is set to cancelled.
20537 # - deadline-exceeded: a retry is attempted if the gRPC
20538 # status code in the response header is set todeadline-exceeded.
20539 # - internal: a retry is attempted if the gRPC
20540 # status code in the response header is set tointernal.
20541 # - resource-exhausted: a retry is attempted if the gRPC
20542 # status code in the response header is set toresource-exhausted.
20543 # - unavailable: a retry is attempted if the gRPC
20544 # status code in the response header is set tounavailable.
20545 #
20546 # Only the following codes are supported when the URL map is bound to
20547 # target gRPC proxy that has validateForProxyless field set to true.
20548 #
20549 # - cancelled
20550 # - deadline-exceeded
20551 # - internal
20552 # - resource-exhausted
20553 # - unavailable
20554 &quot;A String&quot;,
20555 ],
20556 },
20557 &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
20558 # time the request has been fully processed (known as *end-of-stream*)
20559 # up until the response has been processed. Timeout includes
20560 # all retries.
20561 #
20562 # If not specified, this field uses the largest timeout among all backend
20563 # services associated with the route.
20564 #
20565 # Not supported when the URL map is bound to a target gRPC proxy that
20566 # has validateForProxyless field set to true.
20567 # as a count of seconds and fractions of seconds at nanosecond
20568 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
20569 # or &quot;month&quot;. Range is approximately 10,000 years.
20570 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
20571 # Durations less than one second are represented with a 0
20572 # `seconds` field and a positive `nanos` field. Must be from 0
20573 # to 999,999,999 inclusive.
20574 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
20575 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
20576 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
20577 },
20578 &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
20579 # to the matched service.
20580 #
20581 # urlRewrite is the only action supported in UrlMaps
20582 # for classic Application Load Balancers.
20583 #
20584 # Not supported when the URL map is bound to a target gRPC proxy that
20585 # has the validateForProxyless field set to true.
20586 # backend service.
20587 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
20588 # host header is replaced with contents of hostRewrite.
20589 #
20590 # The value must be from 1 to 255 characters.
20591 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
20592 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
20593 #
20594 # The value must be from 1 to 1024 characters.
20595 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
20596 # header) using the HTTP template syntax.
20597 #
20598 # A corresponding
20599 # path_template_match must be specified. Any template variables must exist in
20600 # the path_template_match field.
20601 #
20602 #
20603 # - -At least one variable must be specified in the path_template_match
20604 # field
20605 # - You can omit variables from the rewritten URL
20606 # - The * and ** operators cannot be matched
20607 # unless they have a corresponding variable name - e.g.
20608 # {format=*} or {var=**}.
20609 #
20610 # For example, a path_template_match of /static/{format=**}
20611 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
20612 # rewrite, so that /{country}/{format}/{suffix=**} can be
20613 # rewritten as /content/{format}/{country}/{suffix}.
20614 #
20615 # At least
20616 # one non-empty routeRules[].matchRules[].path_template_match is
20617 # required.
20618 #
20619 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
20620 },
20621 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
20622 # occurs. The weights determine the fraction of traffic that flows to
20623 # their corresponding backend service. If all traffic needs to
20624 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
20625 #
20626 # After a backend service is identified and before forwarding
20627 # the request to
20628 # the backend service, advanced routing actions such as URL rewrites and
20629 # header transformations are applied depending on additional settings
20630 # specified in this HttpRouteAction.
20631 { # In contrast to a single BackendService in
20632 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
20633 # multiple backend services. The volume of traffic for each
20634 # backend service is proportional to the weight specified
20635 # in each WeightedBackendService
20636 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
20637 # resource. Before
20638 # forwarding the request to backendService, the load balancer
20639 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
20640 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
20641 # effect for the selected backendService.
20642 #
20643 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
20644 #
20645 # headerAction is not supported for load balancers that have
20646 # their loadBalancingScheme set to EXTERNAL.
20647 #
20648 # Not supported when the URL map is bound to a target gRPC proxy that
20649 # has validateForProxyless field set to true.
20650 # the request is passed along to the selected backendService.
20651 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
20652 { # Specification determining how headers are added to requests or responses.
20653 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
20654 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
20655 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
20656 # that already
20657 # exist for the header. If true, headerValue is set for the
20658 # header, discarding any values that were set for that header.
20659 #
20660 # The default value is true,
20661 # unless a variable is present in headerValue,
20662 # in which case the default value is false.
20663 # .
20664 },
20665 ],
20666 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
20667 # request before forwarding the request to the backendService.
20668 &quot;A String&quot;,
20669 ],
20670 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
20671 # client.
20672 { # Specification determining how headers are added to requests or responses.
20673 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
20674 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
20675 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
20676 # that already
20677 # exist for the header. If true, headerValue is set for the
20678 # header, discarding any values that were set for that header.
20679 #
20680 # The default value is true,
20681 # unless a variable is present in headerValue,
20682 # in which case the default value is false.
20683 # .
20684 },
20685 ],
20686 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
20687 # response before sending the response back to the client.
20688 &quot;A String&quot;,
20689 ],
20690 },
20691 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
20692 # computed asweight / (sum of all weightedBackendService weights in routeAction).
20693 #
20694 # The selection of a backend service is determined only for new traffic.
20695 # Once a user&#x27;s request has been directed to a backend service,
20696 # subsequent requests are sent to the same backend service as
20697 # determined by the backend service&#x27;s session affinity policy.
20698 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
20699 # splitting. If you do, the weighted traffic splitting configuration takes
20700 # precedence.
20701 #
20702 # The value must be from 0 to 1000.
20703 },
20704 ],
20705 },
20706 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL of the defaultService resource to
20707 # which traffic is directed if none of the hostRules match.
20708 # If defaultRouteAction is also specified, advanced
20709 # routing actions, such as URL rewrites, take effect before sending the
20710 # request to the backend.
20711 #
20712 #
20713 # Only one of defaultUrlRedirect, defaultService
20714 # or defaultRouteAction.weightedBackendService can be set.
20715 #
20716 #
20717 # defaultService has no effect when the URL map is bound
20718 # to a target gRPC proxy that has the validateForProxyless field
20719 # set to true.
20720 &quot;defaultUrlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When none of the specified hostRules match, the request
20721 # is redirected to a URL specified by defaultUrlRedirect.
20722 #
20723 #
20724 # Only one of defaultUrlRedirect, defaultService
20725 # or defaultRouteAction.weightedBackendService can be set.
20726 #
20727 #
20728 # Not supported when the URL map is bound to a target gRPC proxy.
20729 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
20730 # was supplied in the request.
20731 #
20732 # The value must be from 1 to 255
20733 # characters.
20734 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
20735 # set to HTTPS.
20736 # If set to false, the URL scheme of the redirected request
20737 # remains the same as that of the request.
20738 #
20739 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
20740 #
20741 # The default is set to false.
20742 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
20743 # that was supplied in the request.
20744 #
20745 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
20746 # supplied, the path of the original request is used for the redirect.
20747 #
20748 # The value must be from 1 to 1024 characters.
20749 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
20750 # the HttpRouteRuleMatch, retaining the remaining portion
20751 # of the URL before redirecting the request.
20752 #
20753 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
20754 # supplied, the path of the original request is used for the redirect.
20755 #
20756 # The value must be from 1 to 1024 characters.
20757 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
20758 #
20759 # Supported values are:
20760 #
20761 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
20762 # to 301.
20763 # - FOUND, which corresponds to 302.
20764 # - SEE_OTHER which corresponds to 303.
20765 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
20766 # method is retained.
20767 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
20768 # method is retained.
20769 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
20770 # URL is
20771 # removed before redirecting the request. If set to false, the
20772 # query portion of the original URL is retained.
20773 #
20774 # The default is set to false.
20775 },
20776 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
20777 # create the resource.
20778 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. A hash of the contents stored in this object.
20779 # This field is used in optimistic locking. This field is ignored when
20780 # inserting a UrlMap. An up-to-date fingerprint must be provided
20781 # in order to update the UrlMap, otherwise the request will
20782 # fail with error 412 conditionNotMet.
20783 #
20784 # To see the latest fingerprint, make a get() request to
20785 # retrieve a UrlMap.
20786 &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
20787 # for the selected backendService.
20788 #
20789 # The headerAction specified here take effect afterheaderAction specified under pathMatcher.
20790 #
20791 # headerAction is not supported for load balancers
20792 # that have
20793 # their loadBalancingScheme set to EXTERNAL.
20794 #
20795 # Not supported when the URL map is bound to a target gRPC proxy that
20796 # has validateForProxyless field set to true.
20797 # the request is passed along to the selected backendService.
20798 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
20799 { # Specification determining how headers are added to requests or responses.
20800 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
20801 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
20802 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
20803 # that already
20804 # exist for the header. If true, headerValue is set for the
20805 # header, discarding any values that were set for that header.
20806 #
20807 # The default value is true,
20808 # unless a variable is present in headerValue,
20809 # in which case the default value is false.
20810 # .
20811 },
20812 ],
20813 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
20814 # request before forwarding the request to the backendService.
20815 &quot;A String&quot;,
20816 ],
20817 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
20818 # client.
20819 { # Specification determining how headers are added to requests or responses.
20820 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
20821 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
20822 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
20823 # that already
20824 # exist for the header. If true, headerValue is set for the
20825 # header, discarding any values that were set for that header.
20826 #
20827 # The default value is true,
20828 # unless a variable is present in headerValue,
20829 # in which case the default value is false.
20830 # .
20831 },
20832 ],
20833 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
20834 # response before sending the response back to the client.
20835 &quot;A String&quot;,
20836 ],
20837 },
20838 &quot;hostRules&quot;: [ # The list of host rules to use against the URL.
20839 { # UrlMaps
20840 # A host-matching rule for a URL. If matched, will use the namedPathMatcher to select the BackendService.
20841 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
20842 # create the resource.
20843 &quot;hosts&quot;: [ # The list of host patterns to match. They must be valid hostnames with
20844 # optional port numbers in the format host:port.* matches any string of ([a-z0-9-.]*). In
20845 # that case, * must be the first character, and if followed by
20846 # anything, the immediate following character must be either -
20847 # or ..
20848 #
20849 # * based matching is not supported when the URL map is bound
20850 # to a target gRPC proxy that has the validateForProxyless field
20851 # set to true.
20852 &quot;A String&quot;,
20853 ],
20854 &quot;pathMatcher&quot;: &quot;A String&quot;, # The name of the PathMatcher to use to match the path portion
20855 # of the URL if the hostRule matches the URL&#x27;s host portion.
20856 },
20857 ],
20858 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the resource. This identifier is
20859 # defined by the server.
20860 &quot;kind&quot;: &quot;compute#urlMap&quot;, # Output only. [Output Only] Type of the resource. Always compute#urlMaps for
20861 # url maps.
20862 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
20863 # The name must be 1-63 characters long, and comply withRFC1035.
20864 # Specifically, the name must be 1-63 characters long and match the regular
20865 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
20866 # character must be a lowercase letter, and all following characters must
20867 # be a dash, lowercase letter, or digit, except the last character, which
20868 # cannot be a dash.
20869 &quot;pathMatchers&quot;: [ # The list of named PathMatchers to use against the URL.
20870 { # A matcher for the path portion of the URL. The BackendService
20871 # from the longest-matched rule will serve the URL. If no rule was matched, the
20872 # default service is used.
20873 &quot;defaultCustomErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # defaultCustomErrorResponsePolicy specifies how the Load
20874 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
20875 #
20876 # This policy takes
20877 # effect at the PathMatcher level and applies only when no
20878 # 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
20879 # in defaultCustomErrorResponsePolicy, then a policy defined for
20880 # the error code in UrlMap.defaultCustomErrorResponsePolicy
20881 # takes effect.
20882 #
20883 # For example, consider a UrlMap with the following
20884 # configuration:
20885 #
20886 #
20887 # - UrlMap.defaultCustomErrorResponsePolicy is configured
20888 # with policies for 5xx and 4xx errors
20889 # - A RouteRule for /coming_soon/ is configured for the
20890 # error code 404.
20891 #
20892 # 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
20893 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
20894 # the policy in RouteRule.customErrorResponsePolicy takes
20895 # effect. If any of the requests in this example encounter a 500
20896 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
20897 #
20898 # When
20899 # used in conjunction withpathMatcher.defaultRouteAction.retryPolicy, retries take
20900 # precedence. Only once all retries are exhausted, thedefaultCustomErrorResponsePolicy is applied. While attempting
20901 # a retry, if load balancer is successful in reaching the
20902 # service, the defaultCustomErrorResponsePolicy is ignored and
20903 # the response from the service is returned to the client.
20904 #
20905 # defaultCustomErrorResponsePolicy is supported only for
20906 # global external Application Load Balancers.
20907 # backend service or backend bucket responds with an error.
20908 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
20909 #
20910 # In a given policy, if you specify rules for both a range of error codes
20911 # as well as rules for specific error codes then rules with specific error
20912 # codes have a higher priority. For example, assume that you configure a rule
20913 # for 401 (Un-authorized) code, and another for all 4 series
20914 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
20915 # However if the backend service returns a 403, the rule for4xx takes effect.
20916 { # Specifies the mapping between the response code that will be returned along
20917 # with the custom error content and the response code returned by the backend
20918 # service.
20919 &quot;matchResponseCodes&quot;: [ # Valid values include:
20920 #
20921 #
20922 # - A number between 400 and 599: For example
20923 # 401 or 503, in which case the load balancer
20924 # applies the policy if the error code exactly matches this value.
20925 # - 5xx: Load Balancer will apply the policy if the
20926 # backend service responds with any response code in the range of
20927 # 500 to 599.
20928 # - 4xx: Load
20929 # Balancer will apply the policy if the backend service responds with any
20930 # response code in the range of 400 to
20931 # 499.
20932 #
20933 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
20934 &quot;A String&quot;,
20935 ],
20936 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
20937 # error content. If overrideResponseCode is not supplied, the
20938 # same response code returned by the original backend bucket or backend
20939 # service is returned to the client.
20940 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
20941 #
20942 # path must start
20943 # with a leading slash. path cannot have trailing slashes.
20944 #
20945 # If the file is not available in backendBucket or the
20946 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
20947 #
20948 # The value must
20949 # be from 1 to 1024 characters
20950 },
20951 ],
20952 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
20953 # contains the custom error content. Examples are:
20954 #
20955 #
20956 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
20957 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
20958 # - global/backendBuckets/myBackendBucket
20959 #
20960 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
20961 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
20962 #
20963 # If load balancer cannot reach
20964 # the backendBucket, a simple Not Found Error will
20965 # be returned, with the original response code (oroverrideResponseCode if configured).
20966 #
20967 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
20968 },
20969 &quot;defaultRouteAction&quot;: { # defaultRouteAction takes effect when none of the
20970 # pathRules or routeRules match. The load balancer
20971 # performs advanced routing actions, such as URL rewrites and
20972 # header transformations, before forwarding the request to the
20973 # selected backend.
20974 #
20975 #
20976 # Only one of defaultUrlRedirect, defaultService
20977 # or defaultRouteAction.weightedBackendService can be set.
20978 #
20979 #
20980 # URL maps for classic Application Load Balancers only support
20981 # the urlRewrite action within a path matcher&#x27;sdefaultRouteAction.
20982 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
20983 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
20984 # property must be specified. This policy cannot be specified if any target
20985 # backend has Identity-Aware Proxy enabled.
20986 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
20987 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
20988 # header names can be specified. The cache is bypassed for all `cacheMode`
20989 # values.
20990 &quot;A String&quot;,
20991 ],
20992 &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
20993 # on the backend type: for Backend Services, the complete request URI is
20994 # used; for Backend Buckets, the request URI is used without the protocol or
20995 # host, and only query parameters known to Cloud Storage are included.
20996 # Policy defined on Route Action.
20997 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
20998 # parameters will be included. Either specify `excludedQueryParameters`
20999 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
21000 # encoded and not treated as delimiters.
21001 #
21002 # Note: This field applies to routes that use backend services. Attempting
21003 # to set it on a route that points exclusively to Backend Buckets will
21004 # result in a configuration error. For routes that point to a Backend
21005 # Bucket, use `includedQueryParameters` to define which parameters should
21006 # be part of the cache key.
21007 &quot;A String&quot;,
21008 ],
21009 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
21010 #
21011 # Note: This setting is only applicable to routes that use a Backend
21012 # Service. It does not affect requests served by a Backend Bucket, as the
21013 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
21014 # it on a route that points exclusively to Backend Buckets will result in a
21015 # configuration error.
21016 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
21017 #
21018 # Note: This setting is only applicable to routes that use a Backend
21019 # Service. It does not affect requests served by a Backend Bucket, as the
21020 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
21021 # set on a route that points exclusively to Backend Buckets will result in
21022 # a configuration error.
21023 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
21024 # `includedQueryParameters` and `excludedQueryParameters`. If neither
21025 # is set, the entire query string will be included. If false, the query
21026 # string will be excluded from the cache key entirely.
21027 #
21028 # Note: This field applies to routes that use backend services. Attempting
21029 # to set it on a route that points exclusively to Backend Buckets will
21030 # result in a configuration error. For routes that point to a Backend
21031 # Bucket, use `includedQueryParameters` to define which parameters should
21032 # be part of the cache key.
21033 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
21034 # The name=value pair will be used in the cache key Cloud CDN generates.
21035 #
21036 # Note: This setting is only applicable to routes that use a Backend
21037 # Service. It does not affect requests served by a Backend Bucket.
21038 # Attempting to set it on a route that points exclusively to Backend
21039 # Buckets will result in a configuration error. Up to 5 cookie names can be
21040 # specified.
21041 &quot;A String&quot;,
21042 ],
21043 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
21044 &quot;A String&quot;,
21045 ],
21046 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
21047 # parameters will be excluded. Either specify `includedQueryParameters`
21048 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
21049 # encoded and not treated as delimiters.
21050 &quot;A String&quot;,
21051 ],
21052 },
21053 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
21054 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
21055 &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
21056 # content. This is used to clamp the max-age (or Expires) value sent to the
21057 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
21058 # is used for the response max-age directive, along with a &quot;public&quot;
21059 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
21060 # clamps the max-age from the origin (if specified), or else sets the
21061 # response max-age directive to the lesser of the `clientTtl` and
21062 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
21063 # present. The maximum allowed value is 31,622,400s (1 year). If not
21064 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
21065 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
21066 # `USE_ORIGIN_HEADERS`.
21067 # as a count of seconds and fractions of seconds at nanosecond
21068 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21069 # or &quot;month&quot;. Range is approximately 10,000 years.
21070 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21071 # Durations less than one second are represented with a 0
21072 # `seconds` field and a positive `nanos` field. Must be from 0
21073 # to 999,999,999 inclusive.
21074 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21075 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21076 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21077 },
21078 &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
21079 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
21080 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
21081 # greater than that of `maxTtl`. When the `cacheMode` is set to
21082 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
21083 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
21084 # accessed objects may be evicted from the cache before the defined TTL. If
21085 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
21086 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
21087 # `USE_ORIGIN_HEADERS`.
21088 # as a count of seconds and fractions of seconds at nanosecond
21089 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21090 # or &quot;month&quot;. Range is approximately 10,000 years.
21091 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21092 # Durations less than one second are represented with a 0
21093 # `seconds` field and a positive `nanos` field. Must be from 0
21094 # to 999,999,999 inclusive.
21095 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21096 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21097 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21098 },
21099 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
21100 # attempt to set a max-age or s-maxage higher than this, or an Expires header
21101 # more than `maxTtl` seconds in the future will be capped at the value of
21102 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
21103 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
21104 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
21105 # Infrequently accessed objects may be evicted from the cache before the
21106 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
21107 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
21108 # mode.
21109 # as a count of seconds and fractions of seconds at nanosecond
21110 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21111 # or &quot;month&quot;. Range is approximately 10,000 years.
21112 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21113 # Durations less than one second are represented with a 0
21114 # `seconds` field and a positive `nanos` field. Must be from 0
21115 # to 999,999,999 inclusive.
21116 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21117 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21118 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21119 },
21120 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
21121 # to apply fine-grained caching for common errors or redirects.
21122 # This can reduce the load on your origin and improve end-user
21123 # experience by reducing response latency.
21124 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
21125 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
21126 # the specified response code that lack any Cache-Control, Expires, or
21127 # Pragma: no-cache directives. When the `cacheMode` is set to
21128 # `FORCE_CACHE_ALL`, negative caching applies to all responses
21129 # with the specified response code, and overrides any caching headers. By
21130 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
21131 #
21132 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
21133 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
21134 # * 405 (Method Not Found), 501 (Not Implemented): 60s
21135 #
21136 # These defaults can be overridden in `negativeCachingPolicy`.
21137 # If not specified, Cloud CDN applies negative caching by default.
21138 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
21139 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
21140 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
21141 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
21142 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
21143 # all response codes that you wish to cache. Cloud CDN will not apply any
21144 # default negative caching when a policy exists.
21145 { # Specify CDN TTLs for response error codes.
21146 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
21147 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
21148 # specified as values, and you cannot specify a status code more than
21149 # once.
21150 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
21151 # corresponding status code.
21152 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
21153 # objects may be evicted from the cache before the defined TTL.
21154 # as a count of seconds and fractions of seconds at nanosecond
21155 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21156 # or &quot;month&quot;. Range is approximately 10,000 years.
21157 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21158 # Durations less than one second are represented with a 0
21159 # `seconds` field and a positive `nanos` field. Must be from 0
21160 # to 999,999,999 inclusive.
21161 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21162 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21163 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21164 },
21165 },
21166 ],
21167 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
21168 # requests into a small number of requests to the origin. If not specified,
21169 # Cloud CDN applies request coalescing by default.
21170 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
21171 # content with the origin, or when an error is encountered when refreshing
21172 # the cache.
21173 # This setting defines the default &quot;max-stale&quot; duration for any cached
21174 # responses that do not specify a max-stale directive. Stale responses that
21175 # exceed the TTL configured here will not be served. The default limit
21176 # (max-stale) is 86400s (1 day), which will allow stale content to be
21177 # served up to this limit beyond the max-age (or s-maxage) of a cached
21178 # response.
21179 # The maximum allowed value is 604800 (1 week).
21180 # Set this to zero (0) to disable serve-while-stale.
21181 # as a count of seconds and fractions of seconds at nanosecond
21182 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21183 # or &quot;month&quot;. Range is approximately 10,000 years.
21184 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21185 # Durations less than one second are represented with a 0
21186 # `seconds` field and a positive `nanos` field. Must be from 0
21187 # to 999,999,999 inclusive.
21188 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21189 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21190 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21191 },
21192 },
21193 &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
21194 # information about the W3C recommendation for cross-origin resource sharing
21195 # (CORS), see Fetch API Living
21196 # Standard.
21197 #
21198 # Not supported when the URL map is bound to a target gRPC proxy.
21199 # information about the W3C recommendation for cross-origin resource sharing
21200 # (CORS), see Fetch API Living
21201 # Standard.
21202 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
21203 # indicates that
21204 # the actual request can include user credentials. This field translates to
21205 # the Access-Control-Allow-Credentials header.
21206 #
21207 # Default is false.
21208 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
21209 # header.
21210 &quot;A String&quot;,
21211 ],
21212 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
21213 # header.
21214 &quot;A String&quot;,
21215 ],
21216 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
21217 # more information, see regular expression syntax.
21218 #
21219 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
21220 #
21221 # Regular expressions can only be used when the loadBalancingScheme is
21222 # set to INTERNAL_SELF_MANAGED.
21223 &quot;A String&quot;,
21224 ],
21225 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
21226 #
21227 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
21228 &quot;A String&quot;,
21229 ],
21230 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
21231 # The default value is false, which indicates that the CORS
21232 # policy is in effect.
21233 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
21234 # header.
21235 &quot;A String&quot;,
21236 ],
21237 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
21238 # seconds. This field translates to the Access-Control-Max-Age
21239 # header.
21240 },
21241 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
21242 # the resiliency of clients to backend service failure. As part of fault
21243 # injection, when clients send requests to a backend service, delays can be
21244 # introduced by a load balancer on a percentage of requests before sending
21245 # those requests to the backend service. Similarly requests from clients can
21246 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
21247 # that are configured with a fault_injection_policy if:
21248 # 1. The traffic is generated by fault injection AND
21249 # 2. The fault injection is not a delay fault injection.
21250 # Fault injection is not supported with the classic Application Load Balancer
21251 # . To see which load balancers support fault injection,
21252 # see Load
21253 # balancing: Routing and traffic management features.
21254 # the resiliency of clients to backend service failure. As part of fault
21255 # injection, when clients send requests to a backend service, delays can be
21256 # introduced by the load balancer on a percentage of requests before sending
21257 # those request to the backend service. Similarly requests from clients can be
21258 # aborted by the load balancer for a percentage of requests.
21259 &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
21260 # injection.
21261 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
21262 #
21263 # The value must be from 200 to 599 inclusive.
21264 #
21265 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
21266 # according to this
21267 # mapping table. HTTP status 200 is mapped to gRPC status
21268 # UNKNOWN. Injecting an OK status is currently not supported by
21269 # Traffic Director.
21270 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
21271 # that is aborted as part of fault injection.
21272 #
21273 # The value must be from 0.0 to 100.0 inclusive.
21274 },
21275 &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
21276 # injection, before being sent to a backend service.
21277 # request to the backend service as part of fault injection.
21278 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
21279 # as a count of seconds and fractions of seconds at nanosecond
21280 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21281 # or &quot;month&quot;. Range is approximately 10,000 years.
21282 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21283 # Durations less than one second are represented with a 0
21284 # `seconds` field and a positive `nanos` field. Must be from 0
21285 # to 999,999,999 inclusive.
21286 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21287 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21288 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21289 },
21290 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
21291 # which a delay is introduced as part of fault injection.
21292 #
21293 # The value must be from 0.0 to 100.0 inclusive.
21294 },
21295 },
21296 &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
21297 # Global EXTERNAL_MANAGED load balancer schemes.
21298 # Either Cloud CDN must be enabled on the backend service or backend bucket
21299 # serving the route, or cache policy must be configured on the same route
21300 # dynamically processes and delivers images from the network edge.
21301 # Image Optimization is only available for Global External Application Load
21302 # Balancers.
21303 # Either Cloud CDN must be enabled on the backend service or backend bucket
21304 # serving the route, or cache policy must be configured on the same route.
21305 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
21306 },
21307 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
21308 # Unlike the timeout field where the timeout duration starts
21309 # from the time the request has been fully processed (known as*end-of-stream*),
21310 # the duration in this field is computed from the beginning of the stream
21311 # until the response has been processed, including all retries. A
21312 # stream that does not complete in this duration is closed.
21313 #
21314 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
21315 # with the route.
21316 #
21317 # This field is only allowed if the Url map is used with backend services
21318 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
21319 # as a count of seconds and fractions of seconds at nanosecond
21320 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21321 # or &quot;month&quot;. Range is approximately 10,000 years.
21322 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21323 # Durations less than one second are represented with a 0
21324 # `seconds` field and a positive `nanos` field. Must be from 0
21325 # to 999,999,999 inclusive.
21326 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21327 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21328 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21329 },
21330 &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
21331 # are shadowed to a separate mirrored backend service. The load balancer does
21332 # not wait for responses from the shadow service. Before sending traffic
21333 # to the shadow service, the host / authority header is suffixed with-shadow.
21334 #
21335 # Not supported when the URL map is bound to a target gRPC proxy that
21336 # has the validateForProxyless field set to true.
21337 # are shadowed to a separate mirrored backend service. The load balancer
21338 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
21339 # to the shadow service, the host or authority header is suffixed with-shadow.
21340 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
21341 # mirrored to.
21342 #
21343 # The backend service configured for a mirroring
21344 # policy must reference backends that are of the same type as the original
21345 # backend service matched in the URL map.
21346 #
21347 # Serverless NEG backends are not currently supported as a mirrored
21348 # backend service.
21349 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
21350 },
21351 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
21352 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
21353 # If not specified, defaults to 1.
21354 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
21355 #
21356 # If not specified, will use the timeout set in theHttpRouteAction field.
21357 # If timeout in the HttpRouteAction field is not set, this field
21358 # uses the largest timeout
21359 # among all backend services associated with the route.
21360 #
21361 # Not supported when the URL map is bound to a target gRPC proxy that
21362 # has the validateForProxyless field set to true.
21363 # as a count of seconds and fractions of seconds at nanosecond
21364 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21365 # or &quot;month&quot;. Range is approximately 10,000 years.
21366 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21367 # Durations less than one second are represented with a 0
21368 # `seconds` field and a positive `nanos` field. Must be from 0
21369 # to 999,999,999 inclusive.
21370 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21371 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21372 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21373 },
21374 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
21375 # values are:
21376 #
21377 # - 5xx: retry is attempted if the instance or endpoint
21378 # responds with any 5xx response code, or if the instance or
21379 # endpoint does not respond at all. For example, disconnects, reset, read
21380 # timeout, connection failure, and refused streams.
21381 # - gateway-error: Similar to 5xx, but only
21382 # applies to response codes 502, 503 or504.
21383 # - connect-failure: a retry is attempted on failures
21384 # connecting to the instance or endpoint. For example, connection
21385 # timeouts.
21386 # - retriable-4xx: a retry is attempted if the instance
21387 # or endpoint responds with a 4xx response code.
21388 # The only error that you can retry is error code 409.
21389 # - refused-stream: a retry is attempted if the instance
21390 # or endpoint resets the stream with a REFUSED_STREAM error
21391 # code. This reset type indicates that it is safe to retry.
21392 # - cancelled: a retry is attempted if the gRPC status
21393 # code in the response header is set to cancelled.
21394 # - deadline-exceeded: a retry is attempted if the gRPC
21395 # status code in the response header is set todeadline-exceeded.
21396 # - internal: a retry is attempted if the gRPC
21397 # status code in the response header is set tointernal.
21398 # - resource-exhausted: a retry is attempted if the gRPC
21399 # status code in the response header is set toresource-exhausted.
21400 # - unavailable: a retry is attempted if the gRPC
21401 # status code in the response header is set tounavailable.
21402 #
21403 # Only the following codes are supported when the URL map is bound to
21404 # target gRPC proxy that has validateForProxyless field set to true.
21405 #
21406 # - cancelled
21407 # - deadline-exceeded
21408 # - internal
21409 # - resource-exhausted
21410 # - unavailable
21411 &quot;A String&quot;,
21412 ],
21413 },
21414 &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
21415 # time the request has been fully processed (known as *end-of-stream*)
21416 # up until the response has been processed. Timeout includes
21417 # all retries.
21418 #
21419 # If not specified, this field uses the largest timeout among all backend
21420 # services associated with the route.
21421 #
21422 # Not supported when the URL map is bound to a target gRPC proxy that
21423 # has validateForProxyless field set to true.
21424 # as a count of seconds and fractions of seconds at nanosecond
21425 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21426 # or &quot;month&quot;. Range is approximately 10,000 years.
21427 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21428 # Durations less than one second are represented with a 0
21429 # `seconds` field and a positive `nanos` field. Must be from 0
21430 # to 999,999,999 inclusive.
21431 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21432 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21433 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21434 },
21435 &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
21436 # to the matched service.
21437 #
21438 # urlRewrite is the only action supported in UrlMaps
21439 # for classic Application Load Balancers.
21440 #
21441 # Not supported when the URL map is bound to a target gRPC proxy that
21442 # has the validateForProxyless field set to true.
21443 # backend service.
21444 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
21445 # host header is replaced with contents of hostRewrite.
21446 #
21447 # The value must be from 1 to 255 characters.
21448 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
21449 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
21450 #
21451 # The value must be from 1 to 1024 characters.
21452 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
21453 # header) using the HTTP template syntax.
21454 #
21455 # A corresponding
21456 # path_template_match must be specified. Any template variables must exist in
21457 # the path_template_match field.
21458 #
21459 #
21460 # - -At least one variable must be specified in the path_template_match
21461 # field
21462 # - You can omit variables from the rewritten URL
21463 # - The * and ** operators cannot be matched
21464 # unless they have a corresponding variable name - e.g.
21465 # {format=*} or {var=**}.
21466 #
21467 # For example, a path_template_match of /static/{format=**}
21468 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
21469 # rewrite, so that /{country}/{format}/{suffix=**} can be
21470 # rewritten as /content/{format}/{country}/{suffix}.
21471 #
21472 # At least
21473 # one non-empty routeRules[].matchRules[].path_template_match is
21474 # required.
21475 #
21476 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
21477 },
21478 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
21479 # occurs. The weights determine the fraction of traffic that flows to
21480 # their corresponding backend service. If all traffic needs to
21481 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
21482 #
21483 # After a backend service is identified and before forwarding
21484 # the request to
21485 # the backend service, advanced routing actions such as URL rewrites and
21486 # header transformations are applied depending on additional settings
21487 # specified in this HttpRouteAction.
21488 { # In contrast to a single BackendService in
21489 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
21490 # multiple backend services. The volume of traffic for each
21491 # backend service is proportional to the weight specified
21492 # in each WeightedBackendService
21493 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
21494 # resource. Before
21495 # forwarding the request to backendService, the load balancer
21496 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
21497 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
21498 # effect for the selected backendService.
21499 #
21500 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
21501 #
21502 # headerAction is not supported for load balancers that have
21503 # their loadBalancingScheme set to EXTERNAL.
21504 #
21505 # Not supported when the URL map is bound to a target gRPC proxy that
21506 # has validateForProxyless field set to true.
21507 # the request is passed along to the selected backendService.
21508 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
21509 { # Specification determining how headers are added to requests or responses.
21510 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
21511 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
21512 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
21513 # that already
21514 # exist for the header. If true, headerValue is set for the
21515 # header, discarding any values that were set for that header.
21516 #
21517 # The default value is true,
21518 # unless a variable is present in headerValue,
21519 # in which case the default value is false.
21520 # .
21521 },
21522 ],
21523 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
21524 # request before forwarding the request to the backendService.
21525 &quot;A String&quot;,
21526 ],
21527 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
21528 # client.
21529 { # Specification determining how headers are added to requests or responses.
21530 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
21531 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
21532 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
21533 # that already
21534 # exist for the header. If true, headerValue is set for the
21535 # header, discarding any values that were set for that header.
21536 #
21537 # The default value is true,
21538 # unless a variable is present in headerValue,
21539 # in which case the default value is false.
21540 # .
21541 },
21542 ],
21543 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
21544 # response before sending the response back to the client.
21545 &quot;A String&quot;,
21546 ],
21547 },
21548 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
21549 # computed asweight / (sum of all weightedBackendService weights in routeAction).
21550 #
21551 # The selection of a backend service is determined only for new traffic.
21552 # Once a user&#x27;s request has been directed to a backend service,
21553 # subsequent requests are sent to the same backend service as
21554 # determined by the backend service&#x27;s session affinity policy.
21555 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
21556 # splitting. If you do, the weighted traffic splitting configuration takes
21557 # precedence.
21558 #
21559 # The value must be from 0 to 1000.
21560 },
21561 ],
21562 },
21563 &quot;defaultService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource. This
21564 # URL is used if none of the pathRules orrouteRules defined by this PathMatcher are
21565 # matched. For example, the
21566 # following are all valid URLs to a BackendService resource:
21567 #
21568 #
21569 # - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
21570 # - compute/v1/projects/project/global/backendServices/backendService
21571 # - global/backendServices/backendService
21572 #
21573 #
21574 # If defaultRouteAction is also specified, advanced
21575 # routing actions, such as URL rewrites, take effect before sending the
21576 # request to the backend.
21577 #
21578 #
21579 # Only one of defaultUrlRedirect, defaultService
21580 # or defaultRouteAction.weightedBackendService can be set.
21581 #
21582 #
21583 # Authorization requires one or more of the following Google IAM permissions on the
21584 # specified resource default_service:
21585 #
21586 #
21587 # - compute.backendBuckets.use
21588 # - compute.backendServices.use
21589 &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
21590 # by defaultUrlRedirect.
21591 #
21592 #
21593 # Only one of defaultUrlRedirect, defaultService
21594 # or defaultRouteAction.weightedBackendService can be set.
21595 #
21596 #
21597 # Not supported when the URL map is bound to a target gRPC proxy.
21598 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
21599 # was supplied in the request.
21600 #
21601 # The value must be from 1 to 255
21602 # characters.
21603 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
21604 # set to HTTPS.
21605 # If set to false, the URL scheme of the redirected request
21606 # remains the same as that of the request.
21607 #
21608 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
21609 #
21610 # The default is set to false.
21611 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
21612 # that was supplied in the request.
21613 #
21614 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
21615 # supplied, the path of the original request is used for the redirect.
21616 #
21617 # The value must be from 1 to 1024 characters.
21618 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
21619 # the HttpRouteRuleMatch, retaining the remaining portion
21620 # of the URL before redirecting the request.
21621 #
21622 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
21623 # supplied, the path of the original request is used for the redirect.
21624 #
21625 # The value must be from 1 to 1024 characters.
21626 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
21627 #
21628 # Supported values are:
21629 #
21630 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
21631 # to 301.
21632 # - FOUND, which corresponds to 302.
21633 # - SEE_OTHER which corresponds to 303.
21634 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
21635 # method is retained.
21636 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
21637 # method is retained.
21638 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
21639 # URL is
21640 # removed before redirecting the request. If set to false, the
21641 # query portion of the original URL is retained.
21642 #
21643 # The default is set to false.
21644 },
21645 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
21646 # create the resource.
21647 &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
21648 # for the selected backend service.
21649 #
21650 # HeaderAction specified here are applied after the matchingHttpRouteRule HeaderAction and before theHeaderAction in the UrlMap
21651 #
21652 # HeaderAction is not supported for load balancers
21653 # that have
21654 # their loadBalancingScheme set to EXTERNAL.
21655 #
21656 # Not supported when the URL map is bound to a target gRPC proxy that
21657 # has validateForProxyless field set to true.
21658 # the request is passed along to the selected backendService.
21659 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
21660 { # Specification determining how headers are added to requests or responses.
21661 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
21662 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
21663 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
21664 # that already
21665 # exist for the header. If true, headerValue is set for the
21666 # header, discarding any values that were set for that header.
21667 #
21668 # The default value is true,
21669 # unless a variable is present in headerValue,
21670 # in which case the default value is false.
21671 # .
21672 },
21673 ],
21674 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
21675 # request before forwarding the request to the backendService.
21676 &quot;A String&quot;,
21677 ],
21678 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
21679 # client.
21680 { # Specification determining how headers are added to requests or responses.
21681 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
21682 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
21683 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
21684 # that already
21685 # exist for the header. If true, headerValue is set for the
21686 # header, discarding any values that were set for that header.
21687 #
21688 # The default value is true,
21689 # unless a variable is present in headerValue,
21690 # in which case the default value is false.
21691 # .
21692 },
21693 ],
21694 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
21695 # response before sending the response back to the client.
21696 &quot;A String&quot;,
21697 ],
21698 },
21699 &quot;name&quot;: &quot;A String&quot;, # The name to which this PathMatcher is referred by theHostRule.
21700 &quot;pathRules&quot;: [ # The list of path rules. Use this list instead of routeRules
21701 # when routing based on simple path matching is all that&#x27;s required. A path
21702 # rule can only include a wildcard character (*) after a
21703 # forward slash character (&quot;/&quot;).
21704 #
21705 # The order by which path rules are specified does not matter.
21706 # Matches are always done on the longest-path-first basis.
21707 #
21708 # For example: a pathRule with a path /a/b/c/* will match
21709 # before /a/b/* irrespective of the order in which those paths appear in this
21710 # list.
21711 #
21712 # Within a given pathMatcher, only one ofpathRules or routeRules must be set.
21713 { # A path-matching rule for a URL. If matched, will use the specifiedBackendService to handle the traffic arriving at this URL.
21714 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
21715 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
21716 #
21717 # If a policy for an
21718 # error code is not configured for the PathRule, a policy for
21719 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
21720 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
21721 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
21722 # effect.
21723 #
21724 # For example, consider a UrlMap with the following configuration:
21725 #
21726 #
21727 # - UrlMap.defaultCustomErrorResponsePolicy are configured
21728 # with policies for 5xx and 4xx errors
21729 # - A PathRule for /coming_soon/ is configured for the error
21730 # code 404.
21731 #
21732 # 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
21733 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
21734 # the policy in PathRule.customErrorResponsePolicy takes
21735 # effect. If any of the requests in this example encounter a 500
21736 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
21737 #
21738 # customErrorResponsePolicy is supported only for
21739 # global external Application Load Balancers.
21740 # backend service or backend bucket responds with an error.
21741 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
21742 #
21743 # In a given policy, if you specify rules for both a range of error codes
21744 # as well as rules for specific error codes then rules with specific error
21745 # codes have a higher priority. For example, assume that you configure a rule
21746 # for 401 (Un-authorized) code, and another for all 4 series
21747 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
21748 # However if the backend service returns a 403, the rule for4xx takes effect.
21749 { # Specifies the mapping between the response code that will be returned along
21750 # with the custom error content and the response code returned by the backend
21751 # service.
21752 &quot;matchResponseCodes&quot;: [ # Valid values include:
21753 #
21754 #
21755 # - A number between 400 and 599: For example
21756 # 401 or 503, in which case the load balancer
21757 # applies the policy if the error code exactly matches this value.
21758 # - 5xx: Load Balancer will apply the policy if the
21759 # backend service responds with any response code in the range of
21760 # 500 to 599.
21761 # - 4xx: Load
21762 # Balancer will apply the policy if the backend service responds with any
21763 # response code in the range of 400 to
21764 # 499.
21765 #
21766 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
21767 &quot;A String&quot;,
21768 ],
21769 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
21770 # error content. If overrideResponseCode is not supplied, the
21771 # same response code returned by the original backend bucket or backend
21772 # service is returned to the client.
21773 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
21774 #
21775 # path must start
21776 # with a leading slash. path cannot have trailing slashes.
21777 #
21778 # If the file is not available in backendBucket or the
21779 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
21780 #
21781 # The value must
21782 # be from 1 to 1024 characters
21783 },
21784 ],
21785 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
21786 # contains the custom error content. Examples are:
21787 #
21788 #
21789 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
21790 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
21791 # - global/backendBuckets/myBackendBucket
21792 #
21793 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
21794 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
21795 #
21796 # If load balancer cannot reach
21797 # the backendBucket, a simple Not Found Error will
21798 # be returned, with the original response code (oroverrideResponseCode if configured).
21799 #
21800 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
21801 },
21802 &quot;paths&quot;: [ # The list of path patterns to match. Each must start with /
21803 # and the only place a * is allowed is at the end following
21804 # a /. The string fed to the path matcher does not include
21805 # any text after the first ? or #, and
21806 # those chars are not allowed here.
21807 &quot;A String&quot;,
21808 ],
21809 &quot;routeAction&quot;: { # In response to a matching path, the load balancer
21810 # performs advanced routing actions, such as URL rewrites and header
21811 # transformations, before forwarding the request to the selected
21812 # backend.
21813 #
21814 #
21815 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
21816 #
21817 #
21818 # URL maps for classic Application Load Balancers only support
21819 # the urlRewrite action within a path rule&#x27;srouteAction.
21820 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
21821 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
21822 # property must be specified. This policy cannot be specified if any target
21823 # backend has Identity-Aware Proxy enabled.
21824 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
21825 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
21826 # header names can be specified. The cache is bypassed for all `cacheMode`
21827 # values.
21828 &quot;A String&quot;,
21829 ],
21830 &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
21831 # on the backend type: for Backend Services, the complete request URI is
21832 # used; for Backend Buckets, the request URI is used without the protocol or
21833 # host, and only query parameters known to Cloud Storage are included.
21834 # Policy defined on Route Action.
21835 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
21836 # parameters will be included. Either specify `excludedQueryParameters`
21837 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
21838 # encoded and not treated as delimiters.
21839 #
21840 # Note: This field applies to routes that use backend services. Attempting
21841 # to set it on a route that points exclusively to Backend Buckets will
21842 # result in a configuration error. For routes that point to a Backend
21843 # Bucket, use `includedQueryParameters` to define which parameters should
21844 # be part of the cache key.
21845 &quot;A String&quot;,
21846 ],
21847 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
21848 #
21849 # Note: This setting is only applicable to routes that use a Backend
21850 # Service. It does not affect requests served by a Backend Bucket, as the
21851 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
21852 # it on a route that points exclusively to Backend Buckets will result in a
21853 # configuration error.
21854 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
21855 #
21856 # Note: This setting is only applicable to routes that use a Backend
21857 # Service. It does not affect requests served by a Backend Bucket, as the
21858 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
21859 # set on a route that points exclusively to Backend Buckets will result in
21860 # a configuration error.
21861 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
21862 # `includedQueryParameters` and `excludedQueryParameters`. If neither
21863 # is set, the entire query string will be included. If false, the query
21864 # string will be excluded from the cache key entirely.
21865 #
21866 # Note: This field applies to routes that use backend services. Attempting
21867 # to set it on a route that points exclusively to Backend Buckets will
21868 # result in a configuration error. For routes that point to a Backend
21869 # Bucket, use `includedQueryParameters` to define which parameters should
21870 # be part of the cache key.
21871 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
21872 # The name=value pair will be used in the cache key Cloud CDN generates.
21873 #
21874 # Note: This setting is only applicable to routes that use a Backend
21875 # Service. It does not affect requests served by a Backend Bucket.
21876 # Attempting to set it on a route that points exclusively to Backend
21877 # Buckets will result in a configuration error. Up to 5 cookie names can be
21878 # specified.
21879 &quot;A String&quot;,
21880 ],
21881 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
21882 &quot;A String&quot;,
21883 ],
21884 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
21885 # parameters will be excluded. Either specify `includedQueryParameters`
21886 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
21887 # encoded and not treated as delimiters.
21888 &quot;A String&quot;,
21889 ],
21890 },
21891 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
21892 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
21893 &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
21894 # content. This is used to clamp the max-age (or Expires) value sent to the
21895 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
21896 # is used for the response max-age directive, along with a &quot;public&quot;
21897 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
21898 # clamps the max-age from the origin (if specified), or else sets the
21899 # response max-age directive to the lesser of the `clientTtl` and
21900 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
21901 # present. The maximum allowed value is 31,622,400s (1 year). If not
21902 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
21903 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
21904 # `USE_ORIGIN_HEADERS`.
21905 # as a count of seconds and fractions of seconds at nanosecond
21906 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21907 # or &quot;month&quot;. Range is approximately 10,000 years.
21908 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21909 # Durations less than one second are represented with a 0
21910 # `seconds` field and a positive `nanos` field. Must be from 0
21911 # to 999,999,999 inclusive.
21912 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21913 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21914 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21915 },
21916 &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
21917 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
21918 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
21919 # greater than that of `maxTtl`. When the `cacheMode` is set to
21920 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
21921 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
21922 # accessed objects may be evicted from the cache before the defined TTL. If
21923 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
21924 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
21925 # `USE_ORIGIN_HEADERS`.
21926 # as a count of seconds and fractions of seconds at nanosecond
21927 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21928 # or &quot;month&quot;. Range is approximately 10,000 years.
21929 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21930 # Durations less than one second are represented with a 0
21931 # `seconds` field and a positive `nanos` field. Must be from 0
21932 # to 999,999,999 inclusive.
21933 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21934 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21935 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21936 },
21937 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
21938 # attempt to set a max-age or s-maxage higher than this, or an Expires header
21939 # more than `maxTtl` seconds in the future will be capped at the value of
21940 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
21941 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
21942 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
21943 # Infrequently accessed objects may be evicted from the cache before the
21944 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
21945 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
21946 # mode.
21947 # as a count of seconds and fractions of seconds at nanosecond
21948 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21949 # or &quot;month&quot;. Range is approximately 10,000 years.
21950 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21951 # Durations less than one second are represented with a 0
21952 # `seconds` field and a positive `nanos` field. Must be from 0
21953 # to 999,999,999 inclusive.
21954 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
21955 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
21956 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
21957 },
21958 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
21959 # to apply fine-grained caching for common errors or redirects.
21960 # This can reduce the load on your origin and improve end-user
21961 # experience by reducing response latency.
21962 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
21963 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
21964 # the specified response code that lack any Cache-Control, Expires, or
21965 # Pragma: no-cache directives. When the `cacheMode` is set to
21966 # `FORCE_CACHE_ALL`, negative caching applies to all responses
21967 # with the specified response code, and overrides any caching headers. By
21968 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
21969 #
21970 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
21971 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
21972 # * 405 (Method Not Found), 501 (Not Implemented): 60s
21973 #
21974 # These defaults can be overridden in `negativeCachingPolicy`.
21975 # If not specified, Cloud CDN applies negative caching by default.
21976 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
21977 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
21978 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
21979 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
21980 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
21981 # all response codes that you wish to cache. Cloud CDN will not apply any
21982 # default negative caching when a policy exists.
21983 { # Specify CDN TTLs for response error codes.
21984 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
21985 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
21986 # specified as values, and you cannot specify a status code more than
21987 # once.
21988 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
21989 # corresponding status code.
21990 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
21991 # objects may be evicted from the cache before the defined TTL.
21992 # as a count of seconds and fractions of seconds at nanosecond
21993 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
21994 # or &quot;month&quot;. Range is approximately 10,000 years.
21995 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
21996 # Durations less than one second are represented with a 0
21997 # `seconds` field and a positive `nanos` field. Must be from 0
21998 # to 999,999,999 inclusive.
21999 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22000 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22001 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22002 },
22003 },
22004 ],
22005 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
22006 # requests into a small number of requests to the origin. If not specified,
22007 # Cloud CDN applies request coalescing by default.
22008 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
22009 # content with the origin, or when an error is encountered when refreshing
22010 # the cache.
22011 # This setting defines the default &quot;max-stale&quot; duration for any cached
22012 # responses that do not specify a max-stale directive. Stale responses that
22013 # exceed the TTL configured here will not be served. The default limit
22014 # (max-stale) is 86400s (1 day), which will allow stale content to be
22015 # served up to this limit beyond the max-age (or s-maxage) of a cached
22016 # response.
22017 # The maximum allowed value is 604800 (1 week).
22018 # Set this to zero (0) to disable serve-while-stale.
22019 # as a count of seconds and fractions of seconds at nanosecond
22020 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
22021 # or &quot;month&quot;. Range is approximately 10,000 years.
22022 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
22023 # Durations less than one second are represented with a 0
22024 # `seconds` field and a positive `nanos` field. Must be from 0
22025 # to 999,999,999 inclusive.
22026 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22027 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22028 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22029 },
22030 },
22031 &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
22032 # information about the W3C recommendation for cross-origin resource sharing
22033 # (CORS), see Fetch API Living
22034 # Standard.
22035 #
22036 # Not supported when the URL map is bound to a target gRPC proxy.
22037 # information about the W3C recommendation for cross-origin resource sharing
22038 # (CORS), see Fetch API Living
22039 # Standard.
22040 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
22041 # indicates that
22042 # the actual request can include user credentials. This field translates to
22043 # the Access-Control-Allow-Credentials header.
22044 #
22045 # Default is false.
22046 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
22047 # header.
22048 &quot;A String&quot;,
22049 ],
22050 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
22051 # header.
22052 &quot;A String&quot;,
22053 ],
22054 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
22055 # more information, see regular expression syntax.
22056 #
22057 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
22058 #
22059 # Regular expressions can only be used when the loadBalancingScheme is
22060 # set to INTERNAL_SELF_MANAGED.
22061 &quot;A String&quot;,
22062 ],
22063 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
22064 #
22065 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
22066 &quot;A String&quot;,
22067 ],
22068 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
22069 # The default value is false, which indicates that the CORS
22070 # policy is in effect.
22071 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
22072 # header.
22073 &quot;A String&quot;,
22074 ],
22075 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
22076 # seconds. This field translates to the Access-Control-Max-Age
22077 # header.
22078 },
22079 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
22080 # the resiliency of clients to backend service failure. As part of fault
22081 # injection, when clients send requests to a backend service, delays can be
22082 # introduced by a load balancer on a percentage of requests before sending
22083 # those requests to the backend service. Similarly requests from clients can
22084 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
22085 # that are configured with a fault_injection_policy if:
22086 # 1. The traffic is generated by fault injection AND
22087 # 2. The fault injection is not a delay fault injection.
22088 # Fault injection is not supported with the classic Application Load Balancer
22089 # . To see which load balancers support fault injection,
22090 # see Load
22091 # balancing: Routing and traffic management features.
22092 # the resiliency of clients to backend service failure. As part of fault
22093 # injection, when clients send requests to a backend service, delays can be
22094 # introduced by the load balancer on a percentage of requests before sending
22095 # those request to the backend service. Similarly requests from clients can be
22096 # aborted by the load balancer for a percentage of requests.
22097 &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
22098 # injection.
22099 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
22100 #
22101 # The value must be from 200 to 599 inclusive.
22102 #
22103 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
22104 # according to this
22105 # mapping table. HTTP status 200 is mapped to gRPC status
22106 # UNKNOWN. Injecting an OK status is currently not supported by
22107 # Traffic Director.
22108 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
22109 # that is aborted as part of fault injection.
22110 #
22111 # The value must be from 0.0 to 100.0 inclusive.
22112 },
22113 &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
22114 # injection, before being sent to a backend service.
22115 # request to the backend service as part of fault injection.
22116 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
22117 # as a count of seconds and fractions of seconds at nanosecond
22118 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
22119 # or &quot;month&quot;. Range is approximately 10,000 years.
22120 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
22121 # Durations less than one second are represented with a 0
22122 # `seconds` field and a positive `nanos` field. Must be from 0
22123 # to 999,999,999 inclusive.
22124 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22125 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22126 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22127 },
22128 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
22129 # which a delay is introduced as part of fault injection.
22130 #
22131 # The value must be from 0.0 to 100.0 inclusive.
22132 },
22133 },
22134 &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
22135 # Global EXTERNAL_MANAGED load balancer schemes.
22136 # Either Cloud CDN must be enabled on the backend service or backend bucket
22137 # serving the route, or cache policy must be configured on the same route
22138 # dynamically processes and delivers images from the network edge.
22139 # Image Optimization is only available for Global External Application Load
22140 # Balancers.
22141 # Either Cloud CDN must be enabled on the backend service or backend bucket
22142 # serving the route, or cache policy must be configured on the same route.
22143 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
22144 },
22145 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
22146 # Unlike the timeout field where the timeout duration starts
22147 # from the time the request has been fully processed (known as*end-of-stream*),
22148 # the duration in this field is computed from the beginning of the stream
22149 # until the response has been processed, including all retries. A
22150 # stream that does not complete in this duration is closed.
22151 #
22152 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
22153 # with the route.
22154 #
22155 # This field is only allowed if the Url map is used with backend services
22156 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
22157 # as a count of seconds and fractions of seconds at nanosecond
22158 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
22159 # or &quot;month&quot;. Range is approximately 10,000 years.
22160 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
22161 # Durations less than one second are represented with a 0
22162 # `seconds` field and a positive `nanos` field. Must be from 0
22163 # to 999,999,999 inclusive.
22164 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22165 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22166 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22167 },
22168 &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
22169 # are shadowed to a separate mirrored backend service. The load balancer does
22170 # not wait for responses from the shadow service. Before sending traffic
22171 # to the shadow service, the host / authority header is suffixed with-shadow.
22172 #
22173 # Not supported when the URL map is bound to a target gRPC proxy that
22174 # has the validateForProxyless field set to true.
22175 # are shadowed to a separate mirrored backend service. The load balancer
22176 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
22177 # to the shadow service, the host or authority header is suffixed with-shadow.
22178 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
22179 # mirrored to.
22180 #
22181 # The backend service configured for a mirroring
22182 # policy must reference backends that are of the same type as the original
22183 # backend service matched in the URL map.
22184 #
22185 # Serverless NEG backends are not currently supported as a mirrored
22186 # backend service.
22187 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
22188 },
22189 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
22190 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
22191 # If not specified, defaults to 1.
22192 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
22193 #
22194 # If not specified, will use the timeout set in theHttpRouteAction field.
22195 # If timeout in the HttpRouteAction field is not set, this field
22196 # uses the largest timeout
22197 # among all backend services associated with the route.
22198 #
22199 # Not supported when the URL map is bound to a target gRPC proxy that
22200 # has the validateForProxyless field set to true.
22201 # as a count of seconds and fractions of seconds at nanosecond
22202 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
22203 # or &quot;month&quot;. Range is approximately 10,000 years.
22204 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
22205 # Durations less than one second are represented with a 0
22206 # `seconds` field and a positive `nanos` field. Must be from 0
22207 # to 999,999,999 inclusive.
22208 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22209 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22210 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22211 },
22212 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
22213 # values are:
22214 #
22215 # - 5xx: retry is attempted if the instance or endpoint
22216 # responds with any 5xx response code, or if the instance or
22217 # endpoint does not respond at all. For example, disconnects, reset, read
22218 # timeout, connection failure, and refused streams.
22219 # - gateway-error: Similar to 5xx, but only
22220 # applies to response codes 502, 503 or504.
22221 # - connect-failure: a retry is attempted on failures
22222 # connecting to the instance or endpoint. For example, connection
22223 # timeouts.
22224 # - retriable-4xx: a retry is attempted if the instance
22225 # or endpoint responds with a 4xx response code.
22226 # The only error that you can retry is error code 409.
22227 # - refused-stream: a retry is attempted if the instance
22228 # or endpoint resets the stream with a REFUSED_STREAM error
22229 # code. This reset type indicates that it is safe to retry.
22230 # - cancelled: a retry is attempted if the gRPC status
22231 # code in the response header is set to cancelled.
22232 # - deadline-exceeded: a retry is attempted if the gRPC
22233 # status code in the response header is set todeadline-exceeded.
22234 # - internal: a retry is attempted if the gRPC
22235 # status code in the response header is set tointernal.
22236 # - resource-exhausted: a retry is attempted if the gRPC
22237 # status code in the response header is set toresource-exhausted.
22238 # - unavailable: a retry is attempted if the gRPC
22239 # status code in the response header is set tounavailable.
22240 #
22241 # Only the following codes are supported when the URL map is bound to
22242 # target gRPC proxy that has validateForProxyless field set to true.
22243 #
22244 # - cancelled
22245 # - deadline-exceeded
22246 # - internal
22247 # - resource-exhausted
22248 # - unavailable
22249 &quot;A String&quot;,
22250 ],
22251 },
22252 &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
22253 # time the request has been fully processed (known as *end-of-stream*)
22254 # up until the response has been processed. Timeout includes
22255 # all retries.
22256 #
22257 # If not specified, this field uses the largest timeout among all backend
22258 # services associated with the route.
22259 #
22260 # Not supported when the URL map is bound to a target gRPC proxy that
22261 # has validateForProxyless field set to true.
22262 # as a count of seconds and fractions of seconds at nanosecond
22263 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
22264 # or &quot;month&quot;. Range is approximately 10,000 years.
22265 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
22266 # Durations less than one second are represented with a 0
22267 # `seconds` field and a positive `nanos` field. Must be from 0
22268 # to 999,999,999 inclusive.
22269 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
22270 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
22271 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
22272 },
22273 &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
22274 # to the matched service.
22275 #
22276 # urlRewrite is the only action supported in UrlMaps
22277 # for classic Application Load Balancers.
22278 #
22279 # Not supported when the URL map is bound to a target gRPC proxy that
22280 # has the validateForProxyless field set to true.
22281 # backend service.
22282 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
22283 # host header is replaced with contents of hostRewrite.
22284 #
22285 # The value must be from 1 to 255 characters.
22286 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
22287 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
22288 #
22289 # The value must be from 1 to 1024 characters.
22290 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
22291 # header) using the HTTP template syntax.
22292 #
22293 # A corresponding
22294 # path_template_match must be specified. Any template variables must exist in
22295 # the path_template_match field.
22296 #
22297 #
22298 # - -At least one variable must be specified in the path_template_match
22299 # field
22300 # - You can omit variables from the rewritten URL
22301 # - The * and ** operators cannot be matched
22302 # unless they have a corresponding variable name - e.g.
22303 # {format=*} or {var=**}.
22304 #
22305 # For example, a path_template_match of /static/{format=**}
22306 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
22307 # rewrite, so that /{country}/{format}/{suffix=**} can be
22308 # rewritten as /content/{format}/{country}/{suffix}.
22309 #
22310 # At least
22311 # one non-empty routeRules[].matchRules[].path_template_match is
22312 # required.
22313 #
22314 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
22315 },
22316 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
22317 # occurs. The weights determine the fraction of traffic that flows to
22318 # their corresponding backend service. If all traffic needs to
22319 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
22320 #
22321 # After a backend service is identified and before forwarding
22322 # the request to
22323 # the backend service, advanced routing actions such as URL rewrites and
22324 # header transformations are applied depending on additional settings
22325 # specified in this HttpRouteAction.
22326 { # In contrast to a single BackendService in
22327 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
22328 # multiple backend services. The volume of traffic for each
22329 # backend service is proportional to the weight specified
22330 # in each WeightedBackendService
22331 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
22332 # resource. Before
22333 # forwarding the request to backendService, the load balancer
22334 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
22335 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
22336 # effect for the selected backendService.
22337 #
22338 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
22339 #
22340 # headerAction is not supported for load balancers that have
22341 # their loadBalancingScheme set to EXTERNAL.
22342 #
22343 # Not supported when the URL map is bound to a target gRPC proxy that
22344 # has validateForProxyless field set to true.
22345 # the request is passed along to the selected backendService.
22346 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
22347 { # Specification determining how headers are added to requests or responses.
22348 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
22349 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
22350 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
22351 # that already
22352 # exist for the header. If true, headerValue is set for the
22353 # header, discarding any values that were set for that header.
22354 #
22355 # The default value is true,
22356 # unless a variable is present in headerValue,
22357 # in which case the default value is false.
22358 # .
22359 },
22360 ],
22361 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
22362 # request before forwarding the request to the backendService.
22363 &quot;A String&quot;,
22364 ],
22365 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
22366 # client.
22367 { # Specification determining how headers are added to requests or responses.
22368 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
22369 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
22370 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
22371 # that already
22372 # exist for the header. If true, headerValue is set for the
22373 # header, discarding any values that were set for that header.
22374 #
22375 # The default value is true,
22376 # unless a variable is present in headerValue,
22377 # in which case the default value is false.
22378 # .
22379 },
22380 ],
22381 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
22382 # response before sending the response back to the client.
22383 &quot;A String&quot;,
22384 ],
22385 },
22386 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
22387 # computed asweight / (sum of all weightedBackendService weights in routeAction).
22388 #
22389 # The selection of a backend service is determined only for new traffic.
22390 # Once a user&#x27;s request has been directed to a backend service,
22391 # subsequent requests are sent to the same backend service as
22392 # determined by the backend service&#x27;s session affinity policy.
22393 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
22394 # splitting. If you do, the weighted traffic splitting configuration takes
22395 # precedence.
22396 #
22397 # The value must be from 0 to 1000.
22398 },
22399 ],
22400 },
22401 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
22402 # is directed if this rule is matched. If routeAction is
22403 # also specified, advanced routing actions, such as URL rewrites,
22404 # take effect before sending the request to the backend.
22405 #
22406 #
22407 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
22408 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When a path pattern is matched, the request is redirected to a URL
22409 # specified by urlRedirect.
22410 #
22411 #
22412 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
22413 #
22414 #
22415 # Not supported when the URL map is bound to a target gRPC proxy.
22416 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
22417 # was supplied in the request.
22418 #
22419 # The value must be from 1 to 255
22420 # characters.
22421 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
22422 # set to HTTPS.
22423 # If set to false, the URL scheme of the redirected request
22424 # remains the same as that of the request.
22425 #
22426 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
22427 #
22428 # The default is set to false.
22429 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
22430 # that was supplied in the request.
22431 #
22432 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
22433 # supplied, the path of the original request is used for the redirect.
22434 #
22435 # The value must be from 1 to 1024 characters.
22436 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
22437 # the HttpRouteRuleMatch, retaining the remaining portion
22438 # of the URL before redirecting the request.
22439 #
22440 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
22441 # supplied, the path of the original request is used for the redirect.
22442 #
22443 # The value must be from 1 to 1024 characters.
22444 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
22445 #
22446 # Supported values are:
22447 #
22448 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
22449 # to 301.
22450 # - FOUND, which corresponds to 302.
22451 # - SEE_OTHER which corresponds to 303.
22452 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
22453 # method is retained.
22454 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
22455 # method is retained.
22456 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
22457 # URL is
22458 # removed before redirecting the request. If set to false, the
22459 # query portion of the original URL is retained.
22460 #
22461 # The default is set to false.
22462 },
22463 },
22464 ],
22465 &quot;routeRules&quot;: [ # The list of HTTP route rules. Use this list instead ofpathRules when advanced route matching and routing actions are
22466 # desired. routeRules are evaluated in order of priority, from
22467 # the lowest to highest number.
22468 #
22469 # Within a given pathMatcher, you can set only one ofpathRules or routeRules.
22470 { # The HttpRouteRule setting specifies how to match an HTTP request
22471 # and the corresponding routing action that load balancing proxies perform.
22472 &quot;customErrorResponsePolicy&quot;: { # Specifies the custom error response policy that must be applied when the # customErrorResponsePolicy specifies how the Load
22473 # Balancer returns error responses when BackendServiceorBackendBucket responds with an error.
22474 #
22475 # If a policy for an
22476 # error code is not configured for the RouteRule, a policy for
22477 # the error code configured inpathMatcher.defaultCustomErrorResponsePolicy is applied. If
22478 # one is not specified inpathMatcher.defaultCustomErrorResponsePolicy, the policy
22479 # configured in UrlMap.defaultCustomErrorResponsePolicy takes
22480 # effect.
22481 #
22482 # For example, consider a UrlMap with the following configuration:
22483 #
22484 #
22485 # - UrlMap.defaultCustomErrorResponsePolicy are configured
22486 # with policies for 5xx and 4xx errors
22487 # - A RouteRule for /coming_soon/ is configured for the
22488 # error code 404.
22489 #
22490 # 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
22491 # takes effect. If however, the request forwww.example.com/coming_soon/ encounters a 404,
22492 # the policy in RouteRule.customErrorResponsePolicy takes
22493 # effect. If any of the requests in this example encounter a 500
22494 # error code, the policy atUrlMap.defaultCustomErrorResponsePolicy takes effect.
22495 #
22496 # When
22497 # used in conjunction withrouteRules.routeAction.retryPolicy, retries take
22498 # precedence. Only once all retries are exhausted, thecustomErrorResponsePolicy is applied. While attempting
22499 # a retry, if load balancer is successful in reaching the
22500 # service, the customErrorResponsePolicy is ignored and
22501 # the response from the service is returned to the client.
22502 #
22503 # customErrorResponsePolicy is supported only for
22504 # global external Application Load Balancers.
22505 # backend service or backend bucket responds with an error.
22506 &quot;errorResponseRules&quot;: [ # Specifies rules for returning error responses.
22507 #
22508 # In a given policy, if you specify rules for both a range of error codes
22509 # as well as rules for specific error codes then rules with specific error
22510 # codes have a higher priority. For example, assume that you configure a rule
22511 # for 401 (Un-authorized) code, and another for all 4 series
22512 # error codes (4XX). If the backend service returns a401, then the rule for 401 will be applied.
22513 # However if the backend service returns a 403, the rule for4xx takes effect.
22514 { # Specifies the mapping between the response code that will be returned along
22515 # with the custom error content and the response code returned by the backend
22516 # service.
22517 &quot;matchResponseCodes&quot;: [ # Valid values include:
22518 #
22519 #
22520 # - A number between 400 and 599: For example
22521 # 401 or 503, in which case the load balancer
22522 # applies the policy if the error code exactly matches this value.
22523 # - 5xx: Load Balancer will apply the policy if the
22524 # backend service responds with any response code in the range of
22525 # 500 to 599.
22526 # - 4xx: Load
22527 # Balancer will apply the policy if the backend service responds with any
22528 # response code in the range of 400 to
22529 # 499.
22530 #
22531 # Values must be unique within matchResponseCodes and across allerrorResponseRules ofCustomErrorResponsePolicy.
22532 &quot;A String&quot;,
22533 ],
22534 &quot;overrideResponseCode&quot;: 42, # The HTTP status code returned with the response containing the custom
22535 # error content. If overrideResponseCode is not supplied, the
22536 # same response code returned by the original backend bucket or backend
22537 # service is returned to the client.
22538 &quot;path&quot;: &quot;A String&quot;, # The full path to a file within backendBucket . For example:/errors/defaultError.html
22539 #
22540 # path must start
22541 # with a leading slash. path cannot have trailing slashes.
22542 #
22543 # If the file is not available in backendBucket or the
22544 # load balancer cannot reach the BackendBucket, a simpleNot Found Error is returned to the client.
22545 #
22546 # The value must
22547 # be from 1 to 1024 characters
22548 },
22549 ],
22550 &quot;errorService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendBucket resource that
22551 # contains the custom error content. Examples are:
22552 #
22553 #
22554 # - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket
22555 # - compute/v1/projects/project/global/backendBuckets/myBackendBucket
22556 # - global/backendBuckets/myBackendBucket
22557 #
22558 # If errorService is not specified at lower levels likepathMatcher, pathRule and routeRule,
22559 # an errorService specified at a higher level in theUrlMap will be used. IfUrlMap.defaultCustomErrorResponsePolicy contains one or moreerrorResponseRules[], it must specifyerrorService.
22560 #
22561 # If load balancer cannot reach
22562 # the backendBucket, a simple Not Found Error will
22563 # be returned, with the original response code (oroverrideResponseCode if configured).
22564 #
22565 # errorService is not supported for internal or regionalHTTP/HTTPS load balancers.
22566 },
22567 &quot;description&quot;: &quot;A String&quot;, # The short description conveying the intent of this routeRule.
22568 #
22569 #
22570 # The description can have a maximum length of 1024 characters.
22571 &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
22572 # for the selected backendService.
22573 #
22574 # The headerAction value specified here is applied before the
22575 # matching pathMatchers[].headerAction and afterpathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction
22576 #
22577 # HeaderAction is not supported for load balancers
22578 # that have
22579 # their loadBalancingScheme set to EXTERNAL.
22580 #
22581 # Not supported when the URL map is bound to a target gRPC proxy that
22582 # has validateForProxyless field set to true.
22583 # the request is passed along to the selected backendService.
22584 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
22585 { # Specification determining how headers are added to requests or responses.
22586 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
22587 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
22588 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
22589 # that already
22590 # exist for the header. If true, headerValue is set for the
22591 # header, discarding any values that were set for that header.
22592 #
22593 # The default value is true,
22594 # unless a variable is present in headerValue,
22595 # in which case the default value is false.
22596 # .
22597 },
22598 ],
22599 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
22600 # request before forwarding the request to the backendService.
22601 &quot;A String&quot;,
22602 ],
22603 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
22604 # client.
22605 { # Specification determining how headers are added to requests or responses.
22606 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
22607 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
22608 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
22609 # that already
22610 # exist for the header. If true, headerValue is set for the
22611 # header, discarding any values that were set for that header.
22612 #
22613 # The default value is true,
22614 # unless a variable is present in headerValue,
22615 # in which case the default value is false.
22616 # .
22617 },
22618 ],
22619 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
22620 # response before sending the response back to the client.
22621 &quot;A String&quot;,
22622 ],
22623 },
22624 &quot;httpFilterConfigs&quot;: [ # Outbound route specific configuration fornetworkservices.HttpFilter resources enabled by Traffic
22625 # Director. httpFilterConfigs only applies for load balancers
22626 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
22627 # more details.
22628 #
22629 # Not supported when the URL map is bound to a target gRPC proxy that
22630 # has validateForProxyless field set to true.
22631 { # HttpFilterConfiguration supplies additional contextual settings
22632 # for networkservices.HttpFilter resources enabled by Traffic
22633 # Director.
22634 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
22635 # YAML formatted and only contain fields defined in the protobuf identified
22636 # in configTypeUrl
22637 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
22638 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
22639 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
22640 # configuration belongs to. This name must be known to the xDS client.
22641 # Example: envoy.wasm
22642 },
22643 ],
22644 &quot;httpFilterMetadata&quot;: [ # Outbound route specific metadata supplied tonetworkservices.HttpFilter resources enabled by Traffic
22645 # Director. httpFilterMetadata only applies for load balancers
22646 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED. See ForwardingRule for
22647 # more details.
22648 #
22649 # The only configTypeUrl supported istype.googleapis.com/google.protobuf.Struct
22650 #
22651 # Not supported when the URL map is bound to a target gRPC proxy that
22652 # has validateForProxyless field set to true.
22653 { # HttpFilterConfiguration supplies additional contextual settings
22654 # for networkservices.HttpFilter resources enabled by Traffic
22655 # Director.
22656 &quot;config&quot;: &quot;A String&quot;, # The configuration needed to enable thenetworkservices.HttpFilter resource. The configuration must be
22657 # YAML formatted and only contain fields defined in the protobuf identified
22658 # in configTypeUrl
22659 &quot;configTypeUrl&quot;: &quot;A String&quot;, # The fully qualified versioned proto3 type url of the protobuf that the
22660 # filter expects for its contextual settings, for example:type.googleapis.com/google.protobuf.Struct
22661 &quot;filterName&quot;: &quot;A String&quot;, # Name of the networkservices.HttpFilter resource this
22662 # configuration belongs to. This name must be known to the xDS client.
22663 # Example: envoy.wasm
22664 },
22665 ],
22666 &quot;matchRules&quot;: [ # The list of criteria for matching attributes of a request to thisrouteRule. This list has OR semantics: the request matches
22667 # this routeRule when any of thematchRules are satisfied. However predicates within
22668 # a given matchRule have AND semantics. All predicates
22669 # within a matchRule must match for the request to
22670 # match the rule.
22671 { # HttpRouteRuleMatch specifies a set of criteria for matching
22672 # requests to an HttpRouteRule. All specified criteria must
22673 # be satisfied for a match to occur.
22674 &quot;fullPathMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
22675 # request must exactly match the value specified infullPathMatch after removing any query parameters and anchor
22676 # that may be part of the original URL.
22677 #
22678 # fullPathMatch must be from 1 to 1024 characters.
22679 #
22680 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
22681 # specified.
22682 &quot;headerMatches&quot;: [ # Specifies a list of header match criteria, all of which must match
22683 # corresponding headers in the request.
22684 { # matchRule criteria for request header matches.
22685 &quot;exactMatch&quot;: &quot;A String&quot;, # The value should exactly match contents of exactMatch.
22686 #
22687 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
22688 &quot;headerName&quot;: &quot;A String&quot;, # The name of the HTTP header to match.
22689 #
22690 # For matching against the HTTP request&#x27;s authority, use a headerMatch
22691 # with the header name &quot;:authority&quot;.
22692 #
22693 # For matching a request&#x27;s method, use the headerName &quot;:method&quot;.
22694 #
22695 # When the URL map is bound to a target gRPC proxy that has
22696 # the validateForProxyless field set to true, only
22697 # non-binary
22698 # user-specified custom metadata and the `content-type` header are supported.
22699 # The following transport-level headers cannot be used in header matching
22700 # rules:
22701 # `:authority`, `:method`, `:path`, `:scheme`, `user-agent`,
22702 # `accept-encoding`, `content-encoding`, `grpc-accept-encoding`,
22703 # `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`,
22704 # `grpc-timeout` and `grpc-trace-bin`.
22705 &quot;invertMatch&quot;: True or False, # If set to false, the headerMatch is considered a
22706 # match if the preceding match criteria are met. If set to true,
22707 # the headerMatch is considered a match if the preceding
22708 # match criteria are NOT met.
22709 #
22710 # The default setting is false.
22711 &quot;prefixMatch&quot;: &quot;A String&quot;, # The value of the header must start with the contents ofprefixMatch.
22712 #
22713 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
22714 &quot;presentMatch&quot;: True or False, # A header with the contents of headerName must exist. The
22715 # match takes place whether or not the request&#x27;s header has a value.
22716 #
22717 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
22718 &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
22719 # specified in rangeMatch. If the header does not contain an
22720 # integer, number or is empty, the match fails.
22721 #
22722 # For example for a range [-5, 0]
22723 #
22724 #
22725 # - -3 will match.
22726 # - 0 will not match.
22727 # - 0.25 will not match.
22728 # - -3someString will not match.
22729 #
22730 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
22731 #
22732 # rangeMatch is not supported for load balancers
22733 # that have loadBalancingScheme set to EXTERNAL.
22734 # within the specified integer range.
22735 &quot;rangeEnd&quot;: &quot;A String&quot;, # The end of the range (exclusive) in signed long integer format.
22736 &quot;rangeStart&quot;: &quot;A String&quot;, # The start of the range (inclusive) in signed long integer format.
22737 },
22738 &quot;regexMatch&quot;: &quot;A String&quot;, # The value of the header must match the regular expression specified inregexMatch.
22739 # For more information about regular expression syntax, see Syntax.
22740 #
22741 # For matching against a port specified in the HTTP request, use a
22742 # headerMatch with headerName set to PORT and a regular expression that
22743 # satisfies the RFC2616 Host header&#x27;s port specifier.
22744 #
22745 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
22746 #
22747 # Regular expressions can only be used when the loadBalancingScheme is
22748 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
22749 # (regional scope) or INTERNAL_MANAGED.
22750 &quot;suffixMatch&quot;: &quot;A String&quot;, # The value of the header must end with the contents ofsuffixMatch.
22751 #
22752 # Only one of exactMatch, prefixMatch,suffixMatch, regexMatch,presentMatch or rangeMatch must be set.
22753 },
22754 ],
22755 &quot;ignoreCase&quot;: True or False, # Specifies that prefixMatch and fullPathMatch
22756 # matches are case sensitive.
22757 #
22758 # The default value is false.
22759 #
22760 # ignoreCase must not be used with regexMatch.
22761 #
22762 # Not supported when the URL map is bound to a target gRPC proxy.
22763 &quot;metadataFilters&quot;: [ # Opaque filter criteria used by the load balancer to restrict routing
22764 # configuration to a limited set of xDS
22765 # compliant clients. In their xDS requests to the load balancer, xDS clients
22766 # present node
22767 # metadata. When there is a match, the relevant routing configuration
22768 # is made available to those proxies.
22769 #
22770 # 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
22771 # the metadata. If its filterMatchCriteria is set to
22772 # MATCH_ALL, then all of its filterLabels must match with
22773 # corresponding labels provided in the metadata. If multiple
22774 # metadata filters are specified, all of them need to be
22775 # satisfied in order to be considered a match.
22776 #
22777 # metadataFilters specified here is applied after those
22778 # specified in ForwardingRule that refers to theUrlMap this HttpRouteRuleMatch belongs to.
22779 #
22780 # metadataFilters only applies to load balancers that haveloadBalancingScheme set toINTERNAL_SELF_MANAGED.
22781 #
22782 # Not supported when the URL map is bound to a target gRPC proxy that
22783 # has validateForProxyless field set to true.
22784 { # Opaque filter criteria used by load balancers to restrict routing
22785 # configuration to a limited set of load balancing proxies. Proxies and
22786 # sidecars involved in load balancing would typically present metadata to the
22787 # load balancers that need to match criteria specified here. If a match takes
22788 # place, the relevant configuration is made available to those
22789 # proxies.
22790 #
22791 # For each metadataFilter in this list, if itsfilterMatchCriteria is set to MATCH_ANY, at least
22792 # one of thefilterLabels must match the corresponding label provided in
22793 # the metadata. If its filterMatchCriteria is set to
22794 # MATCH_ALL, then all of its filterLabels must match with
22795 # corresponding labels provided in the metadata.
22796 #
22797 # An example for using metadataFilters would be: if
22798 # load balancing involves
22799 # Envoys, they receive routing configuration when values inmetadataFilters match values supplied in of their XDS requests to loadbalancers.
22800 &quot;filterLabels&quot;: [ # The list of label value pairs that must match labels in the provided
22801 # metadata based on filterMatchCriteria
22802 #
22803 # This list must not be empty and can have at the most 64 entries.
22804 { # MetadataFilter label name value pairs that are expected
22805 # to match corresponding labels presented as metadata to the load balancer.
22806 &quot;name&quot;: &quot;A String&quot;, # Name of metadata label.
22807 #
22808 # The name can have a maximum length of 1024 characters and must be at
22809 # least 1 character long.
22810 &quot;value&quot;: &quot;A String&quot;, # The value of the label must match the specified value.
22811 #
22812 # value can have a maximum length of 1024 characters.
22813 },
22814 ],
22815 &quot;filterMatchCriteria&quot;: &quot;A String&quot;, # Specifies how individual filter label matches
22816 # within the list of filterLabels and contributes toward the
22817 # overall metadataFilter match.
22818 #
22819 # Supported values are:
22820 #
22821 # - MATCH_ANY: at least one of the filterLabels
22822 # must have a matching label in the provided metadata.
22823 # - MATCH_ALL: all filterLabels must have
22824 # matching labels in the provided metadata.
22825 },
22826 ],
22827 &quot;pathTemplateMatch&quot;: &quot;A String&quot;, # If specified, this field defines a path template pattern that must match
22828 # the :path header after the query string is removed.
22829 #
22830 # A path template pattern can include variables and wildcards.
22831 # Variables are enclosed in curly braces, for example{variable_name}. Wildcards include * that
22832 # matches a single path segment, and ** that matches zero or
22833 # more path segments. The pattern must follow these rules:
22834 #
22835 #
22836 # - The value must be between 1 and 1024 characters.
22837 # - The pattern must start with a leading slash (&quot;/&quot;).
22838 # - No more than 5 operators (variables or wildcards) may appear in
22839 # the pattern.
22840 #
22841 # Precisely one ofprefixMatch, fullPathMatch,regexMatch, or pathTemplateMatch must be
22842 # set.
22843 &quot;prefixMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the request&#x27;s
22844 # path must begin with the specified prefixMatch.prefixMatch must begin with a /.
22845 #
22846 # The value must be from 1 to 1024 characters.
22847 #
22848 # The * character inside a prefix match is
22849 # treated as a literal character, not as a wildcard.
22850 #
22851 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match can be
22852 # used within a matchRule.
22853 &quot;queryParameterMatches&quot;: [ # Specifies a list of query parameter match criteria, all of which must
22854 # match corresponding query parameters in the request.
22855 #
22856 # Not supported when the URL map is bound to a target gRPC proxy.
22857 { # HttpRouteRuleMatch criteria for a request&#x27;s query parameter.
22858 &quot;exactMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
22859 # parameter exactly matches the contents of exactMatch.
22860 #
22861 # Only one of presentMatch, exactMatch, orregexMatch must be set.
22862 &quot;name&quot;: &quot;A String&quot;, # The name of the query parameter to match. The query parameter must exist in
22863 # the request, in the absence of which the request match fails.
22864 &quot;presentMatch&quot;: True or False, # Specifies that the queryParameterMatch matches if the
22865 # request contains the query parameter, irrespective of whether the
22866 # parameter has a value or not.
22867 #
22868 # Only one of presentMatch, exactMatch, orregexMatch must be set.
22869 &quot;regexMatch&quot;: &quot;A String&quot;, # The queryParameterMatch matches if the value of the
22870 # parameter matches the regular expression specified byregexMatch. For
22871 # more information about regular expression syntax, see Syntax.
22872 #
22873 # Only one of presentMatch, exactMatch, orregexMatch must be set.
22874 #
22875 # Regular expressions can only be used when the loadBalancingScheme is
22876 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
22877 # (regional scope) or INTERNAL_MANAGED.
22878 },
22879 ],
22880 &quot;regexMatch&quot;: &quot;A String&quot;, # For satisfying the matchRule condition, the path of the
22881 # request must satisfy the regular expression specified inregexMatch after removing any query parameters and anchor
22882 # supplied with the original URL. For
22883 # more information about regular expression syntax, see Syntax.
22884 #
22885 # Only one of prefixMatch, fullPathMatch,regexMatch or path_template_match must be
22886 # specified.
22887 #
22888 # Regular expressions can only be used when the loadBalancingScheme is
22889 # set to INTERNAL_SELF_MANAGED, EXTERNAL_MANAGED
22890 # (regional scope) or INTERNAL_MANAGED.
22891 },
22892 ],
22893 &quot;priority&quot;: 42, # For routeRules within a given pathMatcher,
22894 # priority determines the order in which a load balancer interpretsrouteRules. RouteRules are evaluated in order
22895 # of priority, from the lowest to highest number. The priority of a
22896 # rule decreases as its number increases (1, 2, 3, N+1). The first rule
22897 # that matches the request is applied.
22898 #
22899 #
22900 # You cannot configure two or more routeRules with the same priority.
22901 # Priority for each rule must be set to a number from 0 to 2147483647
22902 # inclusive.
22903 #
22904 #
22905 # Priority numbers can have gaps, which enable you to add or remove rules
22906 # in the future without affecting the rest of the rules. For example, 1, 2,
22907 # 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you
22908 # could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future
22909 # without any impact on existing rules.
22910 &quot;routeAction&quot;: { # In response to a matching matchRule, the load balancer
22911 # performs advanced routing actions, such as URL rewrites and header
22912 # transformations, before forwarding the request to the selected backend.
22913 #
22914 #
22915 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
22916 #
22917 #
22918 # URL maps for classic Application Load Balancers only support
22919 # the urlRewrite action within a route rule&#x27;srouteAction.
22920 &quot;cachePolicy&quot;: { # Message containing CachePolicy configuration for URL Map&#x27;s Route Action. # Specifies the cache policy configuration for matched traffic. Available
22921 # only for Global `EXTERNAL_MANAGED` load balancer schemes. At least one
22922 # property must be specified. This policy cannot be specified if any target
22923 # backend has Identity-Aware Proxy enabled.
22924 &quot;cacheBypassRequestHeaderNames&quot;: [ # Bypass the cache when the specified request headers are matched by name,
22925 # e.g. Pragma or Authorization headers. Values are case-insensitive. Up to 5
22926 # header names can be specified. The cache is bypassed for all `cacheMode`
22927 # values.
22928 &quot;A String&quot;,
22929 ],
22930 &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
22931 # on the backend type: for Backend Services, the complete request URI is
22932 # used; for Backend Buckets, the request URI is used without the protocol or
22933 # host, and only query parameters known to Cloud Storage are included.
22934 # Policy defined on Route Action.
22935 &quot;excludedQueryParameters&quot;: [ # Names of query string parameters to exclude in cache keys. All other
22936 # parameters will be included. Either specify `excludedQueryParameters`
22937 # or `includedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
22938 # encoded and not treated as delimiters.
22939 #
22940 # Note: This field applies to routes that use backend services. Attempting
22941 # to set it on a route that points exclusively to Backend Buckets will
22942 # result in a configuration error. For routes that point to a Backend
22943 # Bucket, use `includedQueryParameters` to define which parameters should
22944 # be part of the cache key.
22945 &quot;A String&quot;,
22946 ],
22947 &quot;includeHost&quot;: True or False, # If true, requests to different hosts will be cached separately.
22948 #
22949 # Note: This setting is only applicable to routes that use a Backend
22950 # Service. It does not affect requests served by a Backend Bucket, as the
22951 # host is never included in a Backend Bucket&#x27;s cache key. Attempting to set
22952 # it on a route that points exclusively to Backend Buckets will result in a
22953 # configuration error.
22954 &quot;includeProtocol&quot;: True or False, # If true, http and https requests will be cached separately.
22955 #
22956 # Note: This setting is only applicable to routes that use a Backend
22957 # Service. It does not affect requests served by a Backend Bucket, as the
22958 # protocol is never included in a Backend Bucket&#x27;s cache key. Attempting to
22959 # set on a route that points exclusively to Backend Buckets will result in
22960 # a configuration error.
22961 &quot;includeQueryString&quot;: True or False, # If true, include query string parameters in the cache key according to
22962 # `includedQueryParameters` and `excludedQueryParameters`. If neither
22963 # is set, the entire query string will be included. If false, the query
22964 # string will be excluded from the cache key entirely.
22965 #
22966 # Note: This field applies to routes that use backend services. Attempting
22967 # to set it on a route that points exclusively to Backend Buckets will
22968 # result in a configuration error. For routes that point to a Backend
22969 # Bucket, use `includedQueryParameters` to define which parameters should
22970 # be part of the cache key.
22971 &quot;includedCookieNames&quot;: [ # Allows HTTP cookies (by name) to be used in the cache key.
22972 # The name=value pair will be used in the cache key Cloud CDN generates.
22973 #
22974 # Note: This setting is only applicable to routes that use a Backend
22975 # Service. It does not affect requests served by a Backend Bucket.
22976 # Attempting to set it on a route that points exclusively to Backend
22977 # Buckets will result in a configuration error. Up to 5 cookie names can be
22978 # specified.
22979 &quot;A String&quot;,
22980 ],
22981 &quot;includedHeaderNames&quot;: [ # Allows HTTP request headers (by name) to be used in the cache key.
22982 &quot;A String&quot;,
22983 ],
22984 &quot;includedQueryParameters&quot;: [ # Names of query string parameters to include in cache keys. All other
22985 # parameters will be excluded. Either specify `includedQueryParameters`
22986 # or `excludedQueryParameters`, not both. &#x27;&amp;&#x27; and &#x27;=&#x27; will be percent
22987 # encoded and not treated as delimiters.
22988 &quot;A String&quot;,
22989 ],
22990 },
22991 &quot;cacheMode&quot;: &quot;A String&quot;, # Specifies the cache setting for all responses from this route. If not
22992 # specified, Cloud CDN uses `CACHE_ALL_STATIC` mode.
22993 &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
22994 # content. This is used to clamp the max-age (or Expires) value sent to the
22995 # client. With `FORCE_CACHE_ALL`, the lesser of `clientTtl` and `defaultTtl`
22996 # is used for the response max-age directive, along with a &quot;public&quot;
22997 # directive. For cacheable content in `CACHE_ALL_STATIC` mode, `clientTtl`
22998 # clamps the max-age from the origin (if specified), or else sets the
22999 # response max-age directive to the lesser of the `clientTtl` and
23000 # `defaultTtl`, and also ensures a &quot;public&quot; cache-control directive is
23001 # present. The maximum allowed value is 31,622,400s (1 year). If not
23002 # specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` mode.
23003 # Cannot exceed `maxTtl`. Cannot be specified when `cacheMode` is
23004 # `USE_ORIGIN_HEADERS`.
23005 # as a count of seconds and fractions of seconds at nanosecond
23006 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
23007 # or &quot;month&quot;. Range is approximately 10,000 years.
23008 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
23009 # Durations less than one second are represented with a 0
23010 # `seconds` field and a positive `nanos` field. Must be from 0
23011 # to 999,999,999 inclusive.
23012 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
23013 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
23014 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
23015 },
23016 &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
23017 # an existing valid TTL (max-age or s-maxage). Setting a TTL of &quot;0&quot; means
23018 # &quot;always revalidate&quot;. The value of `defaultTtl` cannot be set to a value
23019 # greater than that of `maxTtl`. When the `cacheMode` is set to
23020 # `FORCE_CACHE_ALL`, the `defaultTtl` will overwrite the TTL set in all
23021 # responses. The maximum allowed value is 31,622,400s (1 year). Infrequently
23022 # accessed objects may be evicted from the cache before the defined TTL. If
23023 # not specified, Cloud CDN uses 3600s (1 hour) for `CACHE_ALL_STATIC` and
23024 # `FORCE_CACHE_ALL` modes. Cannot be specified when `cacheMode` is
23025 # `USE_ORIGIN_HEADERS`.
23026 # as a count of seconds and fractions of seconds at nanosecond
23027 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
23028 # or &quot;month&quot;. Range is approximately 10,000 years.
23029 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
23030 # Durations less than one second are represented with a 0
23031 # `seconds` field and a positive `nanos` field. Must be from 0
23032 # to 999,999,999 inclusive.
23033 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
23034 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
23035 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
23036 },
23037 &quot;maxTtl&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum allowed TTL for cached content. Cache directives that
23038 # attempt to set a max-age or s-maxage higher than this, or an Expires header
23039 # more than `maxTtl` seconds in the future will be capped at the value of
23040 # `maxTtl`, as if it were the value of an s-maxage Cache-Control directive.
23041 # Headers sent to the client will not be modified. Setting a TTL of &quot;0&quot; means
23042 # &quot;always revalidate&quot;. The maximum allowed value is 31,622,400s (1 year).
23043 # Infrequently accessed objects may be evicted from the cache before the
23044 # defined TTL. If not specified, Cloud CDN uses 86400s (1 day) for
23045 # `CACHE_ALL_STATIC` mode. Can be specified only for `CACHE_ALL_STATIC` cache
23046 # mode.
23047 # as a count of seconds and fractions of seconds at nanosecond
23048 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
23049 # or &quot;month&quot;. Range is approximately 10,000 years.
23050 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
23051 # Durations less than one second are represented with a 0
23052 # `seconds` field and a positive `nanos` field. Must be from 0
23053 # to 999,999,999 inclusive.
23054 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
23055 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
23056 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
23057 },
23058 &quot;negativeCaching&quot;: True or False, # Negative caching allows per-status code TTLs to be set, in order
23059 # to apply fine-grained caching for common errors or redirects.
23060 # This can reduce the load on your origin and improve end-user
23061 # experience by reducing response latency.
23062 # When the `cacheMode` is set to `CACHE_ALL_STATIC` or
23063 # `USE_ORIGIN_HEADERS`, negative caching applies to responses with
23064 # the specified response code that lack any Cache-Control, Expires, or
23065 # Pragma: no-cache directives. When the `cacheMode` is set to
23066 # `FORCE_CACHE_ALL`, negative caching applies to all responses
23067 # with the specified response code, and overrides any caching headers. By
23068 # default, Cloud CDN applies the following TTLs to these HTTP status codes:
23069 #
23070 # * 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m
23071 # * 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s
23072 # * 405 (Method Not Found), 501 (Not Implemented): 60s
23073 #
23074 # These defaults can be overridden in `negativeCachingPolicy`.
23075 # If not specified, Cloud CDN applies negative caching by default.
23076 &quot;negativeCachingPolicy&quot;: [ # Sets a cache TTL for the specified HTTP status code.
23077 # `negativeCaching` must be enabled to configure `negativeCachingPolicy`.
23078 # Omitting the policy and leaving `negativeCaching` enabled will use Cloud
23079 # CDN&#x27;s default cache TTLs. Note that when specifying an explicit
23080 # `negativeCachingPolicy`, you should take care to specify a cache TTL for
23081 # all response codes that you wish to cache. Cloud CDN will not apply any
23082 # default negative caching when a policy exists.
23083 { # Specify CDN TTLs for response error codes.
23084 &quot;code&quot;: 42, # The HTTP status code to define a TTL against. Only HTTP status codes
23085 # 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 can be
23086 # specified as values, and you cannot specify a status code more than
23087 # once.
23088 &quot;ttl&quot;: { # A Duration represents a fixed-length span of time represented # The TTL (in seconds) for which to cache responses with the
23089 # corresponding status code.
23090 # The maximum allowed value is 1800s (30 minutes). Infrequently accessed
23091 # objects may be evicted from the cache before the defined TTL.
23092 # as a count of seconds and fractions of seconds at nanosecond
23093 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
23094 # or &quot;month&quot;. Range is approximately 10,000 years.
23095 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
23096 # Durations less than one second are represented with a 0
23097 # `seconds` field and a positive `nanos` field. Must be from 0
23098 # to 999,999,999 inclusive.
23099 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
23100 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
23101 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
23102 },
23103 },
23104 ],
23105 &quot;requestCoalescing&quot;: True or False, # If true then Cloud CDN will combine multiple concurrent cache fill
23106 # requests into a small number of requests to the origin. If not specified,
23107 # Cloud CDN applies request coalescing by default.
23108 &quot;serveWhileStale&quot;: { # A Duration represents a fixed-length span of time represented # Serve existing content from the cache (if available) when revalidating
23109 # content with the origin, or when an error is encountered when refreshing
23110 # the cache.
23111 # This setting defines the default &quot;max-stale&quot; duration for any cached
23112 # responses that do not specify a max-stale directive. Stale responses that
23113 # exceed the TTL configured here will not be served. The default limit
23114 # (max-stale) is 86400s (1 day), which will allow stale content to be
23115 # served up to this limit beyond the max-age (or s-maxage) of a cached
23116 # response.
23117 # The maximum allowed value is 604800 (1 week).
23118 # Set this to zero (0) to disable serve-while-stale.
23119 # as a count of seconds and fractions of seconds at nanosecond
23120 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
23121 # or &quot;month&quot;. Range is approximately 10,000 years.
23122 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
23123 # Durations less than one second are represented with a 0
23124 # `seconds` field and a positive `nanos` field. Must be from 0
23125 # to 999,999,999 inclusive.
23126 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
23127 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
23128 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
23129 },
23130 },
23131 &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
23132 # information about the W3C recommendation for cross-origin resource sharing
23133 # (CORS), see Fetch API Living
23134 # Standard.
23135 #
23136 # Not supported when the URL map is bound to a target gRPC proxy.
23137 # information about the W3C recommendation for cross-origin resource sharing
23138 # (CORS), see Fetch API Living
23139 # Standard.
23140 &quot;allowCredentials&quot;: True or False, # In response to a preflight request, setting this to true
23141 # indicates that
23142 # the actual request can include user credentials. This field translates to
23143 # the Access-Control-Allow-Credentials header.
23144 #
23145 # Default is false.
23146 &quot;allowHeaders&quot;: [ # Specifies the content for the Access-Control-Allow-Headers
23147 # header.
23148 &quot;A String&quot;,
23149 ],
23150 &quot;allowMethods&quot;: [ # Specifies the content for the Access-Control-Allow-Methods
23151 # header.
23152 &quot;A String&quot;,
23153 ],
23154 &quot;allowOriginRegexes&quot;: [ # Specifies a regular expression that matches allowed origins. For
23155 # more information, see regular expression syntax.
23156 #
23157 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
23158 #
23159 # Regular expressions can only be used when the loadBalancingScheme is
23160 # set to INTERNAL_SELF_MANAGED.
23161 &quot;A String&quot;,
23162 ],
23163 &quot;allowOrigins&quot;: [ # Specifies the list of origins that is allowed to do CORS requests.
23164 #
23165 # An origin is allowed if it matches either an item inallowOrigins or an item inallowOriginRegexes.
23166 &quot;A String&quot;,
23167 ],
23168 &quot;disabled&quot;: True or False, # If true, disables the CORS policy.
23169 # The default value is false, which indicates that the CORS
23170 # policy is in effect.
23171 &quot;exposeHeaders&quot;: [ # Specifies the content for the Access-Control-Expose-Headers
23172 # header.
23173 &quot;A String&quot;,
23174 ],
23175 &quot;maxAge&quot;: 42, # Specifies how long results of a preflight request can be cached in
23176 # seconds. This field translates to the Access-Control-Max-Age
23177 # header.
23178 },
23179 &quot;faultInjectionPolicy&quot;: { # The specification for fault injection introduced into traffic to test # The specification for fault injection introduced into traffic to test
23180 # the resiliency of clients to backend service failure. As part of fault
23181 # injection, when clients send requests to a backend service, delays can be
23182 # introduced by a load balancer on a percentage of requests before sending
23183 # those requests to the backend service. Similarly requests from clients can
23184 # be aborted by the load balancer for a percentage of requests.timeout and retry_policy is ignored by clients
23185 # that are configured with a fault_injection_policy if:
23186 # 1. The traffic is generated by fault injection AND
23187 # 2. The fault injection is not a delay fault injection.
23188 # Fault injection is not supported with the classic Application Load Balancer
23189 # . To see which load balancers support fault injection,
23190 # see Load
23191 # balancing: Routing and traffic management features.
23192 # the resiliency of clients to backend service failure. As part of fault
23193 # injection, when clients send requests to a backend service, delays can be
23194 # introduced by the load balancer on a percentage of requests before sending
23195 # those request to the backend service. Similarly requests from clients can be
23196 # aborted by the load balancer for a percentage of requests.
23197 &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
23198 # injection.
23199 &quot;httpStatus&quot;: 42, # The HTTP status code used to abort the request.
23200 #
23201 # The value must be from 200 to 599 inclusive.
23202 #
23203 # For gRPC protocol, the gRPC status code is mapped to HTTP status code
23204 # according to this
23205 # mapping table. HTTP status 200 is mapped to gRPC status
23206 # UNKNOWN. Injecting an OK status is currently not supported by
23207 # Traffic Director.
23208 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests
23209 # that is aborted as part of fault injection.
23210 #
23211 # The value must be from 0.0 to 100.0 inclusive.
23212 },
23213 &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
23214 # injection, before being sent to a backend service.
23215 # request to the backend service as part of fault injection.
23216 &quot;fixedDelay&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the value of the fixed delay interval.
23217 # as a count of seconds and fractions of seconds at nanosecond
23218 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
23219 # or &quot;month&quot;. Range is approximately 10,000 years.
23220 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
23221 # Durations less than one second are represented with a 0
23222 # `seconds` field and a positive `nanos` field. Must be from 0
23223 # to 999,999,999 inclusive.
23224 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
23225 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
23226 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
23227 },
23228 &quot;percentage&quot;: 3.14, # The percentage of traffic for connections, operations, or requests for
23229 # which a delay is introduced as part of fault injection.
23230 #
23231 # The value must be from 0.0 to 100.0 inclusive.
23232 },
23233 },
23234 &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
23235 # Global EXTERNAL_MANAGED load balancer schemes.
23236 # Either Cloud CDN must be enabled on the backend service or backend bucket
23237 # serving the route, or cache policy must be configured on the same route
23238 # dynamically processes and delivers images from the network edge.
23239 # Image Optimization is only available for Global External Application Load
23240 # Balancers.
23241 # Either Cloud CDN must be enabled on the backend service or backend bucket
23242 # serving the route, or cache policy must be configured on the same route.
23243 &quot;queryParameterInterpretation&quot;: &quot;A String&quot;, # Specifies whether to interpret query parameters for image optimization.
23244 },
23245 &quot;maxStreamDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum duration (timeout) for streams on the selected route.
23246 # Unlike the timeout field where the timeout duration starts
23247 # from the time the request has been fully processed (known as*end-of-stream*),
23248 # the duration in this field is computed from the beginning of the stream
23249 # until the response has been processed, including all retries. A
23250 # stream that does not complete in this duration is closed.
23251 #
23252 # If not specified, this field uses the maximummaxStreamDuration value among all backend services associated
23253 # with the route.
23254 #
23255 # This field is only allowed if the Url map is used with backend services
23256 # with loadBalancingScheme set toINTERNAL_SELF_MANAGED.
23257 # as a count of seconds and fractions of seconds at nanosecond
23258 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
23259 # or &quot;month&quot;. Range is approximately 10,000 years.
23260 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
23261 # Durations less than one second are represented with a 0
23262 # `seconds` field and a positive `nanos` field. Must be from 0
23263 # to 999,999,999 inclusive.
23264 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
23265 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
23266 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
23267 },
23268 &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
23269 # are shadowed to a separate mirrored backend service. The load balancer does
23270 # not wait for responses from the shadow service. Before sending traffic
23271 # to the shadow service, the host / authority header is suffixed with-shadow.
23272 #
23273 # Not supported when the URL map is bound to a target gRPC proxy that
23274 # has the validateForProxyless field set to true.
23275 # are shadowed to a separate mirrored backend service. The load balancer
23276 # doesn&#x27;t wait for responses from the shadow service. Before sending traffic
23277 # to the shadow service, the host or authority header is suffixed with-shadow.
23278 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the BackendService resource being
23279 # mirrored to.
23280 #
23281 # The backend service configured for a mirroring
23282 # policy must reference backends that are of the same type as the original
23283 # backend service matched in the URL map.
23284 #
23285 # Serverless NEG backends are not currently supported as a mirrored
23286 # backend service.
23287 &quot;mirrorPercent&quot;: 3.14, # The percentage of requests to be mirrored to `backend_service`.
23288 },
23289 &quot;retryPolicy&quot;: { # The retry policy associates with HttpRouteRule # Specifies the retry policy associated with this route.
23290 &quot;numRetries&quot;: 42, # Specifies the allowed number retries. This number must be &gt; 0.
23291 # If not specified, defaults to 1.
23292 &quot;perTryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies a non-zero timeout per retry attempt.
23293 #
23294 # If not specified, will use the timeout set in theHttpRouteAction field.
23295 # If timeout in the HttpRouteAction field is not set, this field
23296 # uses the largest timeout
23297 # among all backend services associated with the route.
23298 #
23299 # Not supported when the URL map is bound to a target gRPC proxy that
23300 # has the validateForProxyless field set to true.
23301 # as a count of seconds and fractions of seconds at nanosecond
23302 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
23303 # or &quot;month&quot;. Range is approximately 10,000 years.
23304 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
23305 # Durations less than one second are represented with a 0
23306 # `seconds` field and a positive `nanos` field. Must be from 0
23307 # to 999,999,999 inclusive.
23308 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
23309 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
23310 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
23311 },
23312 &quot;retryConditions&quot;: [ # Specifies one or more conditions when this retry policy applies. Valid
23313 # values are:
23314 #
23315 # - 5xx: retry is attempted if the instance or endpoint
23316 # responds with any 5xx response code, or if the instance or
23317 # endpoint does not respond at all. For example, disconnects, reset, read
23318 # timeout, connection failure, and refused streams.
23319 # - gateway-error: Similar to 5xx, but only
23320 # applies to response codes 502, 503 or504.
23321 # - connect-failure: a retry is attempted on failures
23322 # connecting to the instance or endpoint. For example, connection
23323 # timeouts.
23324 # - retriable-4xx: a retry is attempted if the instance
23325 # or endpoint responds with a 4xx response code.
23326 # The only error that you can retry is error code 409.
23327 # - refused-stream: a retry is attempted if the instance
23328 # or endpoint resets the stream with a REFUSED_STREAM error
23329 # code. This reset type indicates that it is safe to retry.
23330 # - cancelled: a retry is attempted if the gRPC status
23331 # code in the response header is set to cancelled.
23332 # - deadline-exceeded: a retry is attempted if the gRPC
23333 # status code in the response header is set todeadline-exceeded.
23334 # - internal: a retry is attempted if the gRPC
23335 # status code in the response header is set tointernal.
23336 # - resource-exhausted: a retry is attempted if the gRPC
23337 # status code in the response header is set toresource-exhausted.
23338 # - unavailable: a retry is attempted if the gRPC
23339 # status code in the response header is set tounavailable.
23340 #
23341 # Only the following codes are supported when the URL map is bound to
23342 # target gRPC proxy that has validateForProxyless field set to true.
23343 #
23344 # - cancelled
23345 # - deadline-exceeded
23346 # - internal
23347 # - resource-exhausted
23348 # - unavailable
23349 &quot;A String&quot;,
23350 ],
23351 },
23352 &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
23353 # time the request has been fully processed (known as *end-of-stream*)
23354 # up until the response has been processed. Timeout includes
23355 # all retries.
23356 #
23357 # If not specified, this field uses the largest timeout among all backend
23358 # services associated with the route.
23359 #
23360 # Not supported when the URL map is bound to a target gRPC proxy that
23361 # has validateForProxyless field set to true.
23362 # as a count of seconds and fractions of seconds at nanosecond
23363 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
23364 # or &quot;month&quot;. Range is approximately 10,000 years.
23365 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
23366 # Durations less than one second are represented with a 0
23367 # `seconds` field and a positive `nanos` field. Must be from 0
23368 # to 999,999,999 inclusive.
23369 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
23370 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
23371 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
23372 },
23373 &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
23374 # to the matched service.
23375 #
23376 # urlRewrite is the only action supported in UrlMaps
23377 # for classic Application Load Balancers.
23378 #
23379 # Not supported when the URL map is bound to a target gRPC proxy that
23380 # has the validateForProxyless field set to true.
23381 # backend service.
23382 &quot;hostRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected service, the request&#x27;s
23383 # host header is replaced with contents of hostRewrite.
23384 #
23385 # The value must be from 1 to 255 characters.
23386 &quot;pathPrefixRewrite&quot;: &quot;A String&quot;, # Before forwarding the request to the selected backend service, the
23387 # matching portion of the request&#x27;s path is replaced bypathPrefixRewrite.
23388 #
23389 # The value must be from 1 to 1024 characters.
23390 &quot;pathTemplateRewrite&quot;: &quot;A String&quot;, # If specified, the pattern rewrites the URL path (based on the :path
23391 # header) using the HTTP template syntax.
23392 #
23393 # A corresponding
23394 # path_template_match must be specified. Any template variables must exist in
23395 # the path_template_match field.
23396 #
23397 #
23398 # - -At least one variable must be specified in the path_template_match
23399 # field
23400 # - You can omit variables from the rewritten URL
23401 # - The * and ** operators cannot be matched
23402 # unless they have a corresponding variable name - e.g.
23403 # {format=*} or {var=**}.
23404 #
23405 # For example, a path_template_match of /static/{format=**}
23406 # could be rewritten as /static/content/{format} to prefix/content to the URL. Variables can also be re-ordered in a
23407 # rewrite, so that /{country}/{format}/{suffix=**} can be
23408 # rewritten as /content/{format}/{country}/{suffix}.
23409 #
23410 # At least
23411 # one non-empty routeRules[].matchRules[].path_template_match is
23412 # required.
23413 #
23414 # Only one of path_prefix_rewrite orpath_template_rewrite may be specified.
23415 },
23416 &quot;weightedBackendServices&quot;: [ # A list of weighted backend services to send traffic to when a route match
23417 # occurs. The weights determine the fraction of traffic that flows to
23418 # their corresponding backend service. If all traffic needs to
23419 # go to a single backend service, there must be oneweightedBackendService with weight set to a non-zero number.
23420 #
23421 # After a backend service is identified and before forwarding
23422 # the request to
23423 # the backend service, advanced routing actions such as URL rewrites and
23424 # header transformations are applied depending on additional settings
23425 # specified in this HttpRouteAction.
23426 { # In contrast to a single BackendService in
23427 # HttpRouteAction to which all matching traffic is directed to,WeightedBackendService allows traffic to be split across
23428 # multiple backend services. The volume of traffic for each
23429 # backend service is proportional to the weight specified
23430 # in each WeightedBackendService
23431 &quot;backendService&quot;: &quot;A String&quot;, # The full or partial URL to the default BackendService
23432 # resource. Before
23433 # forwarding the request to backendService, the load balancer
23434 # applies any relevant headerActions specified as part of thisbackendServiceWeight.
23435 &quot;headerAction&quot;: { # The request and response header transformations that take effect before # Specifies changes to request and response headers that need to take
23436 # effect for the selected backendService.
23437 #
23438 # headerAction specified here take effect beforeheaderAction in the enclosing HttpRouteRule,PathMatcher and UrlMap.
23439 #
23440 # headerAction is not supported for load balancers that have
23441 # their loadBalancingScheme set to EXTERNAL.
23442 #
23443 # Not supported when the URL map is bound to a target gRPC proxy that
23444 # has validateForProxyless field set to true.
23445 # the request is passed along to the selected backendService.
23446 &quot;requestHeadersToAdd&quot;: [ # Headers to add to a matching request before forwarding the request to thebackendService.
23447 { # Specification determining how headers are added to requests or responses.
23448 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
23449 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
23450 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
23451 # that already
23452 # exist for the header. If true, headerValue is set for the
23453 # header, discarding any values that were set for that header.
23454 #
23455 # The default value is true,
23456 # unless a variable is present in headerValue,
23457 # in which case the default value is false.
23458 # .
23459 },
23460 ],
23461 &quot;requestHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
23462 # request before forwarding the request to the backendService.
23463 &quot;A String&quot;,
23464 ],
23465 &quot;responseHeadersToAdd&quot;: [ # Headers to add the response before sending the response back to the
23466 # client.
23467 { # Specification determining how headers are added to requests or responses.
23468 &quot;headerName&quot;: &quot;A String&quot;, # The name of the header.
23469 &quot;headerValue&quot;: &quot;A String&quot;, # The value of the header to add.
23470 &quot;replace&quot;: True or False, # If false, headerValue is appended to any values
23471 # that already
23472 # exist for the header. If true, headerValue is set for the
23473 # header, discarding any values that were set for that header.
23474 #
23475 # The default value is true,
23476 # unless a variable is present in headerValue,
23477 # in which case the default value is false.
23478 # .
23479 },
23480 ],
23481 &quot;responseHeadersToRemove&quot;: [ # A list of header names for headers that need to be removed from the
23482 # response before sending the response back to the client.
23483 &quot;A String&quot;,
23484 ],
23485 },
23486 &quot;weight&quot;: 42, # Specifies the fraction of traffic sent to a backend service,
23487 # computed asweight / (sum of all weightedBackendService weights in routeAction).
23488 #
23489 # The selection of a backend service is determined only for new traffic.
23490 # Once a user&#x27;s request has been directed to a backend service,
23491 # subsequent requests are sent to the same backend service as
23492 # determined by the backend service&#x27;s session affinity policy.
23493 # Don&#x27;t configure session affinity if you&#x27;re using weighted traffic
23494 # splitting. If you do, the weighted traffic splitting configuration takes
23495 # precedence.
23496 #
23497 # The value must be from 0 to 1000.
23498 },
23499 ],
23500 },
23501 &quot;service&quot;: &quot;A String&quot;, # The full or partial URL of the backend service resource to which traffic
23502 # is directed if this rule is matched. If routeAction is
23503 # also specified, advanced routing actions, such as URL rewrites,
23504 # take effect before sending the request to the backend.
23505 #
23506 #
23507 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
23508 &quot;urlRedirect&quot;: { # Specifies settings for an HTTP redirect. # When this rule is matched, the request is redirected to a URL
23509 # specified by urlRedirect.
23510 #
23511 #
23512 # Only one of urlRedirect, service orrouteAction.weightedBackendService can be set.
23513 #
23514 #
23515 # Not supported when the URL map is bound to a target gRPC proxy.
23516 &quot;hostRedirect&quot;: &quot;A String&quot;, # The host that is used in the redirect response instead of the one that
23517 # was supplied in the request.
23518 #
23519 # The value must be from 1 to 255
23520 # characters.
23521 &quot;httpsRedirect&quot;: True or False, # If set to true, the URL scheme in the redirected request is
23522 # set to HTTPS.
23523 # If set to false, the URL scheme of the redirected request
23524 # remains the same as that of the request.
23525 #
23526 # This must only be set for URL maps used inTargetHttpProxys. Setting this true forTargetHttpsProxy is not permitted.
23527 #
23528 # The default is set to false.
23529 &quot;pathRedirect&quot;: &quot;A String&quot;, # The path that is used in the redirect response instead of the one
23530 # that was supplied in the request.
23531 #
23532 # pathRedirect cannot be supplied together withprefixRedirect. Supply one alone or neither. If neither is
23533 # supplied, the path of the original request is used for the redirect.
23534 #
23535 # The value must be from 1 to 1024 characters.
23536 &quot;prefixRedirect&quot;: &quot;A String&quot;, # The prefix that replaces the prefixMatch specified in
23537 # the HttpRouteRuleMatch, retaining the remaining portion
23538 # of the URL before redirecting the request.
23539 #
23540 # prefixRedirect cannot be supplied together withpathRedirect. Supply one alone or neither. If neither is
23541 # supplied, the path of the original request is used for the redirect.
23542 #
23543 # The value must be from 1 to 1024 characters.
23544 &quot;redirectResponseCode&quot;: &quot;A String&quot;, # The HTTP Status code to use for this RedirectAction.
23545 #
23546 # Supported values are:
23547 #
23548 # - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds
23549 # to 301.
23550 # - FOUND, which corresponds to 302.
23551 # - SEE_OTHER which corresponds to 303.
23552 # - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request
23553 # method is retained.
23554 # - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request
23555 # method is retained.
23556 &quot;stripQuery&quot;: True or False, # If set to true, any accompanying query portion of the original
23557 # URL is
23558 # removed before redirecting the request. If set to false, the
23559 # query portion of the original URL is retained.
23560 #
23561 # The default is set to false.
23562 },
23563 },
23564 ],
23565 },
23566 ],
23567 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the regional URL map resides.
23568 # This field is not applicable to global URL maps.
23569 # You must specify this field as part of the HTTP request URL. It is
23570 # not settable as a field in the request body.
23571 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
23572 &quot;status&quot;: { # [Output Only] The status of the URL map. # Output only. [Output Only] The status of the URL map.
23573 &quot;quotaUsage&quot;: { # Message representing the quota usage for a UrlMap. # Output only. Summary of quota usage for given UrlMap.
23574 &quot;forwardingRules&quot;: 42, # Output only. The number of forwarding rules that uses this UrlMap.
23575 &quot;units&quot;: &quot;A String&quot;, # Output only. The number of quota units calculated for this UrlMap.
23576 },
23577 },
23578 &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
23579 # maximum of 100 tests per UrlMap.
23580 #
23581 # Not supported when the URL map is bound to a target gRPC proxy that
23582 # has validateForProxyless field set to true.
23583 { # Message for the expected URL mappings.
23584 &quot;description&quot;: &quot;A String&quot;, # Description of this test case.
23585 &quot;expectedOutputUrl&quot;: &quot;A String&quot;, # The expected output URL evaluated by the load balancer
23586 # containing the scheme, host, path and query parameters.
23587 #
23588 # For rules that forward requests to backends, the test passes only whenexpectedOutputUrl matches the request forwarded by
23589 # the load balancer to backends. For rules with urlRewrite,
23590 # the test verifies that the forwarded request matcheshostRewrite and pathPrefixRewrite in theurlRewrite action. When service is specified,expectedOutputUrl`s scheme is ignored.
23591 #
23592 # For rules with urlRedirect, the test passes only ifexpectedOutputUrl matches the URL in the load balancer&#x27;s
23593 # redirect response. If urlRedirect specifieshttps_redirect, the test passes only if the scheme inexpectedOutputUrl is also set to HTTPS.
23594 # If urlRedirect specifies strip_query, the test
23595 # passes only if expectedOutputUrl does not contain any query
23596 # parameters.
23597 #
23598 # expectedOutputUrl is optional whenservice is specified.
23599 &quot;expectedRedirectResponseCode&quot;: 42, # For rules with urlRedirect, the test passes only ifexpectedRedirectResponseCode matches the HTTP status code in
23600 # load balancer&#x27;s redirect response.
23601 #
23602 # expectedRedirectResponseCode cannot be set whenservice is set.
23603 &quot;headers&quot;: [ # HTTP headers for this request. If headers contains
23604 # a host header, then host must also match the header value.
23605 { # HTTP headers used in UrlMapTests.
23606 &quot;name&quot;: &quot;A String&quot;, # Header name.
23607 &quot;value&quot;: &quot;A String&quot;, # Header value.
23608 },
23609 ],
23610 &quot;host&quot;: &quot;A String&quot;, # Host portion of the URL. If headers contains a host header,
23611 # then host must also match the header value.
23612 &quot;path&quot;: &quot;A String&quot;, # Path portion of the URL.
23613 &quot;service&quot;: &quot;A String&quot;, # Expected BackendService or BackendBucket resource
23614 # the given URL should be mapped to.
23615 #
23616 # The service field cannot
23617 # be set if expectedRedirectResponseCode is set.
23618 },
23619 ],
23620 },
23621 }
23622
23623 x__xgafv: string, V1 error format.
23624 Allowed values
23625 1 - v1 error format
23626 2 - v2 error format
23627
23628 Returns:
23629 An object of the form:
23630
23631 {
23632 &quot;result&quot;: { # Message representing the validation result for a UrlMap.
23633 &quot;loadErrors&quot;: [
23634 &quot;A String&quot;,
23635 ],
23636 &quot;loadSucceeded&quot;: True or False, # Whether the given UrlMap can be successfully loaded.
23637 # If false, &#x27;loadErrors&#x27; indicates the reasons.
23638 &quot;quotaUsage&quot;: { # Message representing the quota usage for a UrlMap. # Output only. Summary of quota usage for given UrlMap.
23639 &quot;forwardingRules&quot;: 42, # Output only. The number of forwarding rules that uses this UrlMap.
23640 &quot;units&quot;: &quot;A String&quot;, # Output only. The number of quota units calculated for this UrlMap.
23641 },
23642 &quot;testFailures&quot;: [
23643 {
23644 &quot;actualOutputUrl&quot;: &quot;A String&quot;, # The actual output URL evaluated by a load balancer containing the scheme,
23645 # host, path and query parameters.
23646 &quot;actualRedirectResponseCode&quot;: 42, # Actual HTTP status code for rule with `urlRedirect`
23647 # calculated by load balancer
23648 &quot;actualService&quot;: &quot;A String&quot;, # BackendService or BackendBucket returned by load
23649 # balancer.
23650 &quot;expectedOutputUrl&quot;: &quot;A String&quot;, # The expected output URL evaluated by a load balancer containing the scheme,
23651 # host, path and query parameters.
23652 &quot;expectedRedirectResponseCode&quot;: 42, # Expected HTTP status code for rule with `urlRedirect`
23653 # calculated by load balancer
23654 &quot;expectedService&quot;: &quot;A String&quot;, # Expected BackendService or BackendBucket resource
23655 # the given URL should be mapped to.
23656 &quot;headers&quot;: [ # HTTP headers of the request.
23657 { # HTTP headers used in UrlMapTests.
23658 &quot;name&quot;: &quot;A String&quot;, # Header name.
23659 &quot;value&quot;: &quot;A String&quot;, # Header value.
23660 },
23661 ],
23662 &quot;host&quot;: &quot;A String&quot;, # Host portion of the URL.
23663 &quot;path&quot;: &quot;A String&quot;, # Path portion including query parameters in the URL.
23664 },
23665 ],
23666 &quot;testPassed&quot;: True or False, # If successfully loaded, this field indicates whether the test passed.
23667 # If false, &#x27;testFailures&#x27;s indicate the reason of failure.
23668 },
23669 }</pre>
23670 </div>
23671
23672 </body></html>