- HTTP request
- Path parameters
- Request body
- Response body
- JSON representation
- JSON representation
- JSON representation
- JSON representation
- JSON representation
- JSON representation
- JSON representation
- JSON representation
- JSON representation
- JSON representation
- JSON representation
- JSON representation
- JSON representation
- JSON representation
- JSON representation
- JSON representation
- JSON representation
- JSON representation
- JSON representation
- JSON representation
- Authorization scopes
- IAM Permissions
- Try it!
Returns the specified UrlMap resource.
HTTP request
GET https://compute.googleapis.com/compute/beta/projects/{project}/regions/{region}/urlMaps/{urlMap}
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
project |
Project ID for this request. |
region |
Name of the region scoping this request. |
urlMap |
Name of the UrlMap resource to return. |
Request body
The request body must be empty.
Response body
Represents a URL Map resource.
Compute Engine has two URL Map resources:
A URL map resource is a component of certain types of cloud load balancers and Traffic Director:
urlMaps
are used by global external Application Load Balancers, classic Application Load Balancers, and cross-region internal Application Load Balancers.regionUrlMaps
are used by internal Application Load Balancers, regional external Application Load Balancers and regional internal Application Load Balancers.
For a list of supported URL map features by the load balancer type, see the Load balancing features: Routing and traffic management table.
For a list of supported URL map features for Traffic Director, see the Traffic Director features: Routing and traffic management table.
This resource defines mappings from hostnames and URL paths to either a backend service or a backend bucket.
To use the global urlMaps
resource, the backend service must have a loadBalancingScheme
of either EXTERNAL
, EXTERNAL_MANAGED
, or INTERNAL_SELF_MANAGED
. To use the regionUrlMaps
resource, the backend service must have a loadBalancingScheme
of INTERNAL_MANAGED
. For more information, read URL Map Concepts.
If successful, the response body contains data with the following structure:
JSON representation |
---|
{ "kind": string, "id": string, "creationTimestamp": string, "name": string, "description": string, "selfLink": string, "hostRules": [ { "description": string, "hosts": [ string ], "pathMatcher": string } ], "pathMatchers": [ { "name": string, "description": string, "defaultService": string, "defaultRouteAction": { "weightedBackendServices": [ { "backendService": string, "weight": integer, "headerAction": { "requestHeadersToRemove": [ string ], "requestHeadersToAdd": [ { "headerName": string, "headerValue": string, "replace": boolean } ], "responseHeadersToRemove": [ string ], "responseHeadersToAdd": [ { "headerName": string, "headerValue": string, "replace": boolean } ] } } ], "urlRewrite": { "pathPrefixRewrite": string, "hostRewrite": string, "pathTemplateRewrite": string }, "timeout": { "seconds": string, "nanos": integer }, "retryPolicy": { "retryConditions": [ string ], "numRetries": integer, "perTryTimeout": { "seconds": string, "nanos": integer } }, "requestMirrorPolicy": { "backendService": string, "mirrorPercent": number }, "corsPolicy": { "allowOrigins": [ string ], "allowOriginRegexes": [ string ], "allowMethods": [ string ], "allowHeaders": [ string ], "exposeHeaders": [ string ], "maxAge": integer, "allowCredentials": boolean, "disabled": boolean }, "faultInjectionPolicy": { "delay": { "fixedDelay": { "seconds": string, "nanos": integer }, "percentage": number }, "abort": { "httpStatus": integer, "percentage": number } }, "maxStreamDuration": { "seconds": string, "nanos": integer } }, "defaultUrlRedirect": { "hostRedirect": string, "pathRedirect": string, "prefixRedirect": string, "redirectResponseCode": enum, "httpsRedirect": boolean, "stripQuery": boolean }, "pathRules": [ { "service": string, "routeAction": { "weightedBackendServices": [ { "backendService": string, "weight": integer, "headerAction": { "requestHeadersToRemove": [ string ], "requestHeadersToAdd": [ { "headerName": string, "headerValue": string, "replace": boolean } ], "responseHeadersToRemove": [ string ], "responseHeadersToAdd": [ { "headerName": string, "headerValue": string, "replace": boolean } ] } } ], "urlRewrite": { "pathPrefixRewrite": string, "hostRewrite": string, "pathTemplateRewrite": string }, "timeout": { "seconds": string, "nanos": integer }, "retryPolicy": { "retryConditions": [ string ], "numRetries": integer, "perTryTimeout": { "seconds": string, "nanos": integer } }, "requestMirrorPolicy": { "backendService": string, "mirrorPercent": number }, "corsPolicy": { "allowOrigins": [ string ], "allowOriginRegexes": [ string ], "allowMethods": [ string ], "allowHeaders": [ string ], "exposeHeaders": [ string ], "maxAge": integer, "allowCredentials": boolean, "disabled": boolean }, "faultInjectionPolicy": { "delay": { "fixedDelay": { "seconds": string, "nanos": integer }, "percentage": number }, "abort": { "httpStatus": integer, "percentage": number } }, "maxStreamDuration": { "seconds": string, "nanos": integer } }, "urlRedirect": { "hostRedirect": string, "pathRedirect": string, "prefixRedirect": string, "redirectResponseCode": enum, "httpsRedirect": boolean, "stripQuery": boolean }, "paths": [ string ], "customErrorResponsePolicy": { "errorResponseRules": [ { "matchResponseCodes": [ string ], "path": string, "overrideResponseCode": integer } ], "errorService": string } } ], "routeRules": [ { "priority": integer, "description": string, "matchRules": [ { "prefixMatch": string, "fullPathMatch": string, "regexMatch": string, "ignoreCase": boolean, "headerMatches": [ { "headerName": string, "exactMatch": string, "regexMatch": string, "rangeMatch": { "rangeStart": string, "rangeEnd": string }, "presentMatch": boolean, "prefixMatch": string, "suffixMatch": string, "invertMatch": boolean } ], "queryParameterMatches": [ { "name": string, "presentMatch": boolean, "exactMatch": string, "regexMatch": string } ], "metadataFilters": [ { "filterMatchCriteria": enum, "filterLabels": [ { "name": string, "value": string } ] } ], "pathTemplateMatch": string } ], "service": string, "routeAction": { "weightedBackendServices": [ { "backendService": string, "weight": integer, "headerAction": { "requestHeadersToRemove": [ string ], "requestHeadersToAdd": [ { "headerName": string, "headerValue": string, "replace": boolean } ], "responseHeadersToRemove": [ string ], "responseHeadersToAdd": [ { "headerName": string, "headerValue": string, "replace": boolean } ] } } ], "urlRewrite": { "pathPrefixRewrite": string, "hostRewrite": string, "pathTemplateRewrite": string }, "timeout": { "seconds": string, "nanos": integer }, "retryPolicy": { "retryConditions": [ string ], "numRetries": integer, "perTryTimeout": { "seconds": string, "nanos": integer } }, "requestMirrorPolicy": { "backendService": string, "mirrorPercent": number }, "corsPolicy": { "allowOrigins": [ string ], "allowOriginRegexes": [ string ], "allowMethods": [ string ], "allowHeaders": [ string ], "exposeHeaders": [ string ], "maxAge": integer, "allowCredentials": boolean, "disabled": boolean }, "faultInjectionPolicy": { "delay": { "fixedDelay": { "seconds": string, "nanos": integer }, "percentage": number }, "abort": { "httpStatus": integer, "percentage": number } }, "maxStreamDuration": { "seconds": string, "nanos": integer } }, "urlRedirect": { "hostRedirect": string, "pathRedirect": string, "prefixRedirect": string, "redirectResponseCode": enum, "httpsRedirect": boolean, "stripQuery": boolean }, "headerAction": { "requestHeadersToRemove": [ string ], "requestHeadersToAdd": [ { "headerName": string, "headerValue": string, "replace": boolean } ], "responseHeadersToRemove": [ string ], "responseHeadersToAdd": [ { "headerName": string, "headerValue": string, "replace": boolean } ] }, "httpFilterConfigs": [ { "filterName": string, "configTypeUrl": string, "config": string } ], "httpFilterMetadata": [ { "filterName": string, "configTypeUrl": string, "config": string } ], "customErrorResponsePolicy": { "errorResponseRules": [ { "matchResponseCodes": [ string ], "path": string, "overrideResponseCode": integer } ], "errorService": string } } ], "headerAction": { "requestHeadersToRemove": [ string ], "requestHeadersToAdd": [ { "headerName": string, "headerValue": string, "replace": boolean } ], "responseHeadersToRemove": [ string ], "responseHeadersToAdd": [ { "headerName": string, "headerValue": string, "replace": boolean } ] }, "defaultCustomErrorResponsePolicy": { "errorResponseRules": [ { "matchResponseCodes": [ string ], "path": string, "overrideResponseCode": integer } ], "errorService": string } } ], "tests": [ { "description": string, "host": string, "path": string, "headers": [ { "name": string, "value": string } ], "service": string, "expectedOutputUrl": string, "expectedRedirectResponseCode": integer } ], "defaultService": string, "defaultRouteAction": { "weightedBackendServices": [ { "backendService": string, "weight": integer, "headerAction": { "requestHeadersToRemove": [ string ], "requestHeadersToAdd": [ { "headerName": string, "headerValue": string, "replace": boolean } ], "responseHeadersToRemove": [ string ], "responseHeadersToAdd": [ { "headerName": string, "headerValue": string, "replace": boolean } ] } } ], "urlRewrite": { "pathPrefixRewrite": string, "hostRewrite": string, "pathTemplateRewrite": string }, "timeout": { "seconds": string, "nanos": integer }, "retryPolicy": { "retryConditions": [ string ], "numRetries": integer, "perTryTimeout": { "seconds": string, "nanos": integer } }, "requestMirrorPolicy": { "backendService": string, "mirrorPercent": number }, "corsPolicy": { "allowOrigins": [ string ], "allowOriginRegexes": [ string ], "allowMethods": [ string ], "allowHeaders": [ string ], "exposeHeaders": [ string ], "maxAge": integer, "allowCredentials": boolean, "disabled": boolean }, "faultInjectionPolicy": { "delay": { "fixedDelay": { "seconds": string, "nanos": integer }, "percentage": number }, "abort": { "httpStatus": integer, "percentage": number } }, "maxStreamDuration": { "seconds": string, "nanos": integer } }, "defaultUrlRedirect": { "hostRedirect": string, "pathRedirect": string, "prefixRedirect": string, "redirectResponseCode": enum, "httpsRedirect": boolean, "stripQuery": boolean }, "headerAction": { "requestHeadersToRemove": [ string ], "requestHeadersToAdd": [ { "headerName": string, "headerValue": string, "replace": boolean } ], "responseHeadersToRemove": [ string ], "responseHeadersToAdd": [ { "headerName": string, "headerValue": string, "replace": boolean } ] }, "defaultCustomErrorResponsePolicy": { "errorResponseRules": [ { "matchResponseCodes": [ string ], "path": string, "overrideResponseCode": integer } ], "errorService": string }, "fingerprint": string, "region": string } |
Fields | |
---|---|
kind |
[Output Only] Type of the resource. Always |
id |
[Output Only] The unique identifier for the resource. This identifier is defined by the server. |
creationTimestamp |
[Output Only] Creation timestamp in RFC3339 text format. |
name |
Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression |
description |
An optional description of this resource. Provide this property when you create the resource. |
selfLink |
[Output Only] Server-defined URL for the resource. |
hostRules[] |
The list of host rules to use against the URL. |
hostRules[].description |
An optional description of this resource. Provide this property when you create the resource. |
hostRules[].hosts[] |
The list of host patterns to match. They must be valid hostnames with optional port numbers in the format
|
hostRules[].pathMatcher |
The name of the |
pathMatchers[] |
The list of named |
pathMatchers[].name |
The name to which this |
pathMatchers[].description |
An optional description of this resource. Provide this property when you create the resource. |
pathMatchers[].defaultService |
The full or partial URL to the
defaultRouteAction is also specified, advanced routing actions, such as URL rewrites, take effect before sending the request to the backend. However, if defaultService is specified, defaultRouteAction cannot contain any weightedBackendServices . Conversely, if defaultRouteAction specifies any weightedBackendServices , defaultService must not be specified. If Authorization requires one or more of the following Google IAM permissions on the specified resource defaultService:
|
pathMatchers[].defaultRouteAction |
If URL maps for classic Application Load Balancers only support the |
pathMatchers[].defaultRouteAction.weightedBackendServices[] |
A list of weighted backend services to send traffic to when a route match occurs. The weights determine the fraction of traffic that flows to their corresponding After a backend service is identified and before forwarding the request to the backend service, advanced routing actions such as URL rewrites and header transformations are applied depending on additional settings specified in this |
pathMatchers[].defaultRouteAction.weightedBackendServices[].backendService |
The full or partial URL to the default |
pathMatchers[].defaultRouteAction.weightedBackendServices[].weight |
Specifies the fraction of traffic sent to a backend service, computed as The selection of a backend service is determined only for new traffic. Once a user's request has been directed to a backend service, subsequent requests are sent to the same backend service as determined by the backend service's session affinity policy. Don't configure session affinity if you're using weighted traffic splitting. If you do, the weighted traffic splitting configuration takes precedence. The value must be from 0 to 1000. |
pathMatchers[].defaultRouteAction.weightedBackendServices[].headerAction |
Specifies changes to request and response headers that need to take effect for the selected
Not supported when the URL map is bound to a target gRPC proxy that has |
pathMatchers[].defaultRouteAction.weightedBackendServices[].headerAction.requestHeadersToRemove[] |
A list of header names for headers that need to be removed from the request before forwarding the request to the |
pathMatchers[].defaultRouteAction.weightedBackendServices[].headerAction.requestHeadersToAdd[] |
Headers to add to a matching request before forwarding the request to the |
pathMatchers[].defaultRouteAction.weightedBackendServices[].headerAction.requestHeadersToAdd[].headerName |
The name of the header. |
pathMatchers[].defaultRouteAction.weightedBackendServices[].headerAction.requestHeadersToAdd[].headerValue |
The value of the header to add. |
pathMatchers[].defaultRouteAction.weightedBackendServices[].headerAction.requestHeadersToAdd[].replace |
If The default value is |
pathMatchers[].defaultRouteAction.weightedBackendServices[].headerAction.responseHeadersToRemove[] |
A list of header names for headers that need to be removed from the response before sending the response back to the client. |
pathMatchers[].defaultRouteAction.weightedBackendServices[].headerAction.responseHeadersToAdd[] |
Headers to add the response before sending the response back to the client. |
pathMatchers[].defaultRouteAction.weightedBackendServices[].headerAction.responseHeadersToAdd[].headerName |
The name of the header. |
pathMatchers[].defaultRouteAction.weightedBackendServices[].headerAction.responseHeadersToAdd[].headerValue |
The value of the header to add. |
pathMatchers[].defaultRouteAction.weightedBackendServices[].headerAction.responseHeadersToAdd[].replace |
If The default value is |
pathMatchers[].defaultRouteAction.urlRewrite |
The spec to modify the URL of the request, before forwarding the request to the matched service. Not supported when the URL map is bound to a target gRPC proxy that has the |
pathMatchers[].defaultRouteAction.urlRewrite.pathPrefixRewrite |
Before forwarding the request to the selected backend service, the matching portion of the request's path is replaced by The value must be from 1 to 1024 characters. |
pathMatchers[].defaultRouteAction.urlRewrite.hostRewrite |
Before forwarding the request to the selected service, the request's host header is replaced with contents of The value must be from 1 to 255 characters. |
pathMatchers[].defaultRouteAction.urlRewrite.pathTemplateRewrite |
If specified, the pattern rewrites the URL path (based on the :path header) using the HTTP template syntax. A corresponding pathTemplateMatch must be specified. Any template variables must exist in the pathTemplateMatch field.
For example, a pathTemplateMatch of At least one non-empty Only one of |
pathMatchers[].defaultRouteAction.timeout |
Specifies the timeout for the selected route. Timeout is computed from the time the request has been fully processed (known as end-of-stream) up until the response has been processed. Timeout includes all retries. If not specified, this field uses the largest timeout among all backend services associated with the route. Not supported when the URL map is bound to a target gRPC proxy that has |
pathMatchers[].defaultRouteAction.timeout.seconds |
Span of time at a resolution of a second. Must be from 0 to 315,576,000,000 inclusive. Note: these bounds are computed from: 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years |
pathMatchers[].defaultRouteAction.timeout.nanos |
Span of time that's a fraction of a second at nanosecond resolution. Durations less than one second are represented with a 0 |
pathMatchers[].defaultRouteAction.retryPolicy |
Specifies the retry policy associated with this route. |
pathMatchers[].defaultRouteAction.retryPolicy.retryConditions[] |
Specifies one or more conditions when this retry policy applies. Valid values are:
Only the following codes are supported when the URL map is bound to target gRPC proxy that has validateForProxyless field set to true.
|
pathMatchers[].defaultRouteAction.retryPolicy.numRetries |
Specifies the allowed number retries. This number must be > 0. If not specified, defaults to 1. |
pathMatchers[].defaultRouteAction.retryPolicy.perTryTimeout |
Specifies a non-zero timeout per retry attempt. If not specified, will use the timeout set in the Not supported when the URL map is bound to a target gRPC proxy that has the |
pathMatchers[].defaultRouteAction.retryPolicy.perTryTimeout.seconds |
Span of time at a resolution of a second. Must be from 0 to 315,576,000,000 inclusive. Note: these bounds are computed from: 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years |
pathMatchers[].defaultRouteAction.retryPolicy.perTryTimeout.nanos |
Span of time that's a fraction of a second at nanosecond resolution. Durations less than one second are represented with a 0 |
pathMatchers[].defaultRouteAction.requestMirrorPolicy |
Specifies the policy on how requests intended for the route's backends are shadowed to a separate mirrored backend service. The load balancer does not wait for responses from the shadow service. Before sending traffic to the shadow service, the host / authority header is suffixed with Not supported when the URL map is bound to a target gRPC proxy that has the |
pathMatchers[].defaultRouteAction.requestMirrorPolicy.backendService |
The full or partial URL to the The backend service configured for a mirroring policy must reference backends that are of the same type as the original backend service matched in the URL map. Serverless NEG backends are not currently supported as a mirrored backend service. |
pathMatchers[].defaultRouteAction.requestMirrorPolicy.mirrorPercent |
The percentage of requests to be mirrored to |
pathMatchers[].defaultRouteAction.corsPolicy |
The specification for allowing client-side cross-origin requests. For more information about the W3C recommendation for cross-origin resource sharing (CORS), see Fetch API Living Standard. Not supported when the URL map is bound to a target gRPC proxy. |
pathMatchers[].defaultRouteAction.corsPolicy.allowOrigins[] |
Specifies the list of origins that is allowed to do CORS requests. An origin is allowed if it matches either an item in |
pathMatchers[].defaultRouteAction.corsPolicy.allowOriginRegexes[] |
Specifies a regular expression that matches allowed origins. For more information, see regular expression syntax . An origin is allowed if it matches either an item in Regular expressions can only be used when the loadBalancingScheme is set to |
pathMatchers[].defaultRouteAction.corsPolicy.allowMethods[] |
Specifies the content for the |
pathMatchers[].defaultRouteAction.corsPolicy.allowHeaders[] |
Specifies the content for the |
pathMatchers[].defaultRouteAction.corsPolicy.exposeHeaders[] |
Specifies the content for the |
pathMatchers[].defaultRouteAction.corsPolicy.maxAge |
Specifies how long results of a preflight request can be cached in seconds. This field translates to the |
pathMatchers[].defaultRouteAction.corsPolicy.allowCredentials |
In response to a preflight request, setting this to Default is |
pathMatchers[].defaultRouteAction.corsPolicy.disabled |
If |
pathMatchers[].defaultRouteAction.faultInjectionPolicy |
The specification for fault injection introduced into traffic to test the resiliency of clients to backend service failure. As part of fault injection, when clients send requests to a backend service, delays can be introduced by a load balancer on a percentage of requests before sending those requests to the backend service. Similarly requests from clients can be aborted by the load balancer for a percentage of requests. |
pathMatchers[].defaultRouteAction.faultInjectionPolicy.delay |
The specification for how client requests are delayed as part of fault injection, before being sent to a backend service. |
pathMatchers[].defaultRouteAction.faultInjectionPolicy.delay.fixedDelay |
Specifies the value of the fixed delay interval. |
pathMatchers[].defaultRouteAction.faultInjectionPolicy.delay.fixedDelay.seconds |
Span of time at a resolution of a second. Must be from 0 to 315,576,000,000 inclusive. Note: these bounds are computed from: 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years |
pathMatchers[].defaultRouteAction.faultInjectionPolicy.delay.fixedDelay.nanos |
Span of time that's a fraction of a second at nanosecond resolution. Durations less than one second are represented with a 0 |
pathMatchers[].defaultRouteAction.faultInjectionPolicy.delay.percentage |
The percentage of traffic for connections, operations, or requests for which a delay is introduced as part of fault injection. The value must be from 0.0 to 100.0 inclusive. |
pathMatchers[].defaultRouteAction.faultInjectionPolicy.abort |
The specification for how client requests are aborted as part of fault injection. |
pathMatchers[].defaultRouteAction.faultInjectionPolicy.abort.httpStatus |
The HTTP status code used to abort the request. The value must be from 200 to 599 inclusive. For gRPC protocol, the gRPC status code is mapped to HTTP status code according to this mapping table. HTTP status 200 is mapped to gRPC status UNKNOWN. Injecting an OK status is currently not supported by Traffic Director. |
pathMatchers[].defaultRouteAction.faultInjectionPolicy.abort.percentage |
The percentage of traffic for connections, operations, or requests that is aborted as part of fault injection. The value must be from 0.0 to 100.0 inclusive. |
pathMatchers[].defaultRouteAction.maxStreamDuration |
Specifies the maximum duration (timeout) for streams on the selected route. Unlike the If not specified, this field uses the maximum This field is only allowed if the Url map is used with backend services with |
pathMatchers[].defaultRouteAction.maxStreamDuration.seconds |
Span of time at a resolution of a second. Must be from 0 to 315,576,000,000 inclusive. Note: these bounds are computed from: 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years |
pathMatchers[].defaultRouteAction.maxStreamDuration.nanos |
Span of time that's a fraction of a second at nanosecond resolution. Durations less than one second are represented with a 0 |
pathMatchers[].defaultUrlRedirect |
When none of the specified If Not supported when the URL map is bound to a target gRPC proxy. |
pathMatchers[].defaultUrlRedirect.hostRedirect |
The host that is used in the redirect response instead of the one that was supplied in the request. The value must be from 1 to 255 characters. |
pathMatchers[].defaultUrlRedirect.pathRedirect |
The path that is used in the redirect response instead of the one that was supplied in the request.
The value must be from 1 to 1024 characters. |
pathMatchers[].defaultUrlRedirect.prefixRedirect |
The prefix that replaces the
The value must be from 1 to 1024 characters. |
pathMatchers[].defaultUrlRedirect.redirectResponseCode |
The HTTP Status code to use for this RedirectAction. Supported values are:
|
pathMatchers[].defaultUrlRedirect.httpsRedirect |
If set to This must only be set for URL maps used in The default is set to |
pathMatchers[].defaultUrlRedirect.stripQuery |
If set to The default is set to |
pathMatchers[].pathRules[] |
The list of path rules. Use this list instead of For example: a Within a given |
pathMatchers[].pathRules[].service |
The full or partial URL of the backend service resource to which traffic is directed if this rule is matched. If Only one of |
pathMatchers[].pathRules[].routeAction |
In response to a matching Only one of URL maps for classic Application Load Balancers only support the |
pathMatchers[].pathRules[].routeAction.weightedBackendServices[] |
A list of weighted backend services to send traffic to when a route match occurs. The weights determine the fraction of traffic that flows to their corresponding After a backend service is identified and before forwarding the request to the backend service, advanced routing actions such as URL rewrites and header transformations are applied depending on additional settings specified in this |
pathMatchers[].pathRules[].routeAction.weightedBackendServices[].backendService |
The full or partial URL to the default |
pathMatchers[].pathRules[].routeAction.weightedBackendServices[].weight |
Specifies the fraction of traffic sent to a backend service, computed as The selection of a backend service is determined only for new traffic. Once a user's request has been directed to a backend service, subsequent requests are sent to the same backend service as determined by the backend service's session affinity policy. Don't configure session affinity if you're using weighted traffic splitting. If you do, the weighted traffic splitting configuration takes precedence. The value must be from 0 to 1000. |
pathMatchers[].pathRules[].routeAction.weightedBackendServices[].headerAction |
Specifies changes to request and response headers that need to take effect for the selected
Not supported when the URL map is bound to a target gRPC proxy that has |
pathMatchers[].pathRules[].routeAction.weightedBackendServices[].headerAction.requestHeadersToRemove[] |
A list of header names for headers that need to be removed from the request before forwarding the request to the |
pathMatchers[].pathRules[].routeAction.weightedBackendServices[].headerAction.requestHeadersToAdd[] |
Headers to add to a matching request before forwarding the request to the |
pathMatchers[].pathRules[].routeAction.weightedBackendServices[].headerAction.requestHeadersToAdd[].headerName |
The name of the header. |
pathMatchers[].pathRules[].routeAction.weightedBackendServices[].headerAction.requestHeadersToAdd[].headerValue |
The value of the header to add. |
pathMatchers[].pathRules[].routeAction.weightedBackendServices[].headerAction.requestHeadersToAdd[].replace |
If The default value is |
pathMatchers[].pathRules[].routeAction.weightedBackendServices[].headerAction.responseHeadersToRemove[] |
A list of header names for headers that need to be removed from the response before sending the response back to the client. |
pathMatchers[].pathRules[].routeAction.weightedBackendServices[].headerAction.responseHeadersToAdd[] |
Headers to add the response before sending the response back to the client. |
pathMatchers[].pathRules[].routeAction.weightedBackendServices[].headerAction.responseHeadersToAdd[].headerName |
The name of the header. |
pathMatchers[].pathRules[].routeAction.weightedBackendServices[].headerAction.responseHeadersToAdd[].headerValue |
The value of the header to add. |
pathMatchers[].pathRules[].routeAction.weightedBackendServices[].headerAction.responseHeadersToAdd[].replace |
If The default value is |
pathMatchers[].pathRules[].routeAction.urlRewrite |
The spec to modify the URL of the request, before forwarding the request to the matched service. Not supported when the URL map is bound to a target gRPC proxy that has the |
pathMatchers[].pathRules[].routeAction.urlRewrite.pathPrefixRewrite |
Before forwarding the request to the selected backend service, the matching portion of the request's path is replaced by The value must be from 1 to 1024 characters. |
pathMatchers[].pathRules[].routeAction.urlRewrite.hostRewrite |
Before forwarding the request to the selected service, the request's host header is replaced with contents of The value must be from 1 to 255 characters. |
pathMatchers[].pathRules[].routeAction.urlRewrite.pathTemplateRewrite |
If specified, the pattern rewrites the URL path (based on the :path header) using the HTTP template syntax. A corresponding pathTemplateMatch must be specified. Any template variables must exist in the pathTemplateMatch field.
For example, a pathTemplateMatch of At least one non-empty Only one of |
pathMatchers[].pathRules[].routeAction.timeout |
Specifies the timeout for the selected route. Timeout is computed from the time the request has been fully processed (known as end-of-stream) up until the response has been processed. Timeout includes all retries. If not specified, this field uses the largest timeout among all backend services associated with the route. Not supported when the URL map is bound to a target gRPC proxy that has |
pathMatchers[].pathRules[].routeAction.timeout.seconds |
Span of time at a resolution of a second. Must be from 0 to 315,576,000,000 inclusive. Note: these bounds are computed from: 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years |
pathMatchers[].pathRules[].routeAction.timeout.nanos |
Span of time that's a fraction of a second at nanosecond resolution. Durations less than one second are represented with a 0 |
pathMatchers[].pathRules[].routeAction.retryPolicy |
Specifies the retry policy associated with this route. |
pathMatchers[].pathRules[].routeAction.retryPolicy.retryConditions[] |
Specifies one or more conditions when this retry policy applies. Valid values are:
Only the following codes are supported when the URL map is bound to target gRPC proxy that has validateForProxyless field set to true.
|
pathMatchers[].pathRules[].routeAction.retryPolicy.numRetries |
Specifies the allowed number retries. This number must be > 0. If not specified, defaults to 1. |
pathMatchers[].pathRules[].routeAction.retryPolicy.perTryTimeout |
Specifies a non-zero timeout per retry attempt. If not specified, will use the timeout set in the Not supported when the URL map is bound to a target gRPC proxy that has the |
pathMatchers[].pathRules[].routeAction.retryPolicy.perTryTimeout.seconds |
Span of time at a resolution of a second. Must be from 0 to 315,576,000,000 inclusive. Note: these bounds are computed from: 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years |
pathMatchers[].pathRules[].routeAction.retryPolicy.perTryTimeout.nanos |
Span of time that's a fraction of a second at nanosecond resolution. Durations less than one second are represented with a 0 |
pathMatchers[].pathRules[].routeAction.requestMirrorPolicy |
Specifies the policy on how requests intended for the route's backends are shadowed to a separate mirrored backend service. The load balancer does not wait for responses from the shadow service. Before sending traffic to the shadow service, the host / authority header is suffixed with Not supported when the URL map is bound to a target gRPC proxy that has the |
pathMatchers[].pathRules[].routeAction.requestMirrorPolicy.backendService |
The full or partial URL to the The backend service configured for a mirroring policy must reference backends that are of the same type as the original backend service matched in the URL map. Serverless NEG backends are not currently supported as a mirrored backend service. |
pathMatchers[].pathRules[].routeAction.requestMirrorPolicy.mirrorPercent |
The percentage of requests to be mirrored to |
pathMatchers[].pathRules[].routeAction.corsPolicy |
The specification for allowing client-side cross-origin requests. For more information about the W3C recommendation for cross-origin resource sharing (CORS), see Fetch API Living Standard. Not supported when the URL map is bound to a target gRPC proxy. |
pathMatchers[].pathRules[].routeAction.corsPolicy.allowOrigins[] |
Specifies the list of origins that is allowed to do CORS requests. An origin is allowed if it matches either an item in |
pathMatchers[].pathRules[].routeAction.corsPolicy.allowOriginRegexes[] |
Specifies a regular expression that matches allowed origins. For more information, see regular expression syntax . An origin is allowed if it matches either an item in Regular expressions can only be used when the loadBalancingScheme is set to |
pathMatchers[].pathRules[].routeAction.corsPolicy.allowMethods[] |
Specifies the content for the |
pathMatchers[].pathRules[].routeAction.corsPolicy.allowHeaders[] |
Specifies the content for the |
pathMatchers[].pathRules[].routeAction.corsPolicy.exposeHeaders[] |
Specifies the content for the |
pathMatchers[].pathRules[].routeAction.corsPolicy.maxAge |
Specifies how long results of a preflight request can be cached in seconds. This field translates to the |
pathMatchers[].pathRules[].routeAction.corsPolicy.allowCredentials |
In response to a preflight request, setting this to Default is |
pathMatchers[].pathRules[].routeAction.corsPolicy.disabled |
If |
pathMatchers[].pathRules[].routeAction.faultInjectionPolicy |
The specification for fault injection introduced into traffic to test the resiliency of clients to backend service failure. As part of fault injection, when clients send requests to a backend service, delays can be introduced by a load balancer on a percentage of requests before sending those requests to the backend service. Similarly requests from clients can be aborted by the load balancer for a percentage of requests. |
pathMatchers[].pathRules[].routeAction.faultInjectionPolicy.delay |
The specification for how client requests are delayed as part of fault injection, before being sent to a backend service. |
pathMatchers[].pathRules[].routeAction.faultInjectionPolicy.delay.fixedDelay |
Specifies the value of the fixed delay interval. |
pathMatchers[].pathRules[].routeAction.faultInjectionPolicy.delay.fixedDelay.seconds |
Span of time at a resolution of a second. Must be from 0 to 315,576,000,000 inclusive. Note: these bounds are computed from: 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years |
pathMatchers[].pathRules[].routeAction.faultInjectionPolicy.delay.fixedDelay.nanos |
Span of time that's a fraction of a second at nanosecond resolution. Durations less than one second are represented with a 0 |
pathMatchers[].pathRules[].routeAction.faultInjectionPolicy.delay.percentage |
The percentage of traffic for connections, operations, or requests for which a delay is introduced as part of fault injection. The value must be from 0.0 to 100.0 inclusive. |
pathMatchers[].pathRules[].routeAction.faultInjectionPolicy.abort |
The specification for how client requests are aborted as part of fault injection. |
pathMatchers[].pathRules[].routeAction.faultInjectionPolicy.abort.httpStatus |
The HTTP status code used to abort the request. The value must be from 200 to 599 inclusive. For gRPC protocol, the gRPC status code is mapped to HTTP status code according to this mapping table. HTTP status 200 is mapped to gRPC status UNKNOWN. Injecting an OK status is currently not supported by Traffic Director. |
pathMatchers[].pathRules[].routeAction.faultInjectionPolicy.abort.percentage |
The percentage of traffic for connections, operations, or requests that is aborted as part of fault injection. The value must be from 0.0 to 100.0 inclusive. |
pathMatchers[].pathRules[].routeAction.maxStreamDuration |
Specifies the maximum duration (timeout) for streams on the selected route. Unlike the If not specified, this field uses the maximum This field is only allowed if the Url map is used with backend services with |
pathMatchers[].pathRules[].routeAction.maxStreamDuration.seconds |
Span of time at a resolution of a second. Must be from 0 to 315,576,000,000 inclusive. Note: these bounds are computed from: 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years |
pathMatchers[].pathRules[].routeAction.maxStreamDuration.nanos |
Span of time that's a fraction of a second at nanosecond resolution. Durations less than one second are represented with a 0 |
pathMatchers[].pathRules[].urlRedirect |
When a path pattern is matched, the request is redirected to a URL specified by If Not supported when the URL map is bound to a target gRPC proxy. |
pathMatchers[].pathRules[].urlRedirect.hostRedirect |
The host that is used in the redirect response instead of the one that was supplied in the request. The value must be from 1 to 255 characters. |
pathMatchers[].pathRules[].urlRedirect.pathRedirect |
The path that is used in the redirect response instead of the one that was supplied in the request.
The value must be from 1 to 1024 characters. |
pathMatchers[].pathRules[].urlRedirect.prefixRedirect |
The prefix that replaces the
The value must be from 1 to 1024 characters. |
pathMatchers[].pathRules[].urlRedirect.redirectResponseCode |
The HTTP Status code to use for this RedirectAction. Supported values are:
|
pathMatchers[].pathRules[].urlRedirect.httpsRedirect |
If set to This must only be set for URL maps used in The default is set to |
pathMatchers[].pathRules[].urlRedirect.stripQuery |
If set to The default is set to |
pathMatchers[].pathRules[].paths[] |
The list of path patterns to match. Each must start with |
pathMatchers[].pathRules[].customErrorResponsePolicy |
If a policy for an error code is not configured for the For example, consider a UrlMap with the following configuration:
If the request is for
|
pathMatchers[].pathRules[].customErrorResponsePolicy.errorResponseRules[] |
Specifies rules for returning error responses. In a given policy, if you specify rules for both a range of error codes as well as rules for specific error codes then rules with specific error codes have a higher priority. For example, assume that you configure a rule for |
pathMatchers[].pathRules[].customErrorResponsePolicy.errorResponseRules[].matchResponseCodes[] |
Valid values include:
Values must be unique within matchResponseCodes and across all |
pathMatchers[].pathRules[].customErrorResponsePolicy.errorResponseRules[].path |
The full path to a file within
If the file is not available in The value must be from |
pathMatchers[].pathRules[].customErrorResponsePolicy.errorResponseRules[].overrideResponseCode |
The HTTP status code returned with the response containing the custom error content. If |
pathMatchers[].pathRules[].customErrorResponsePolicy.errorService |
The full or partial URL to the
If If
|
pathMatchers[].routeRules[] |
The list of HTTP route rules. Use this list instead of Within a given |
pathMatchers[].routeRules[].priority |
For You cannot configure two or more routeRules with the same priority. Priority for each rule must be set to a number from 0 to 2147483647 inclusive. Priority numbers can have gaps, which enable you to add or remove rules in the future without affecting the rest of the rules. For example, 1, 2, 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future without any impact on existing rules. |
pathMatchers[].routeRules[].description |
The short description conveying the intent of this The description can have a maximum length of 1024 characters. |
pathMatchers[].routeRules[].matchRules[] |
The list of criteria for matching attributes of a request to this |
pathMatchers[].routeRules[].matchRules[].prefixMatch |
For satisfying the The value must be from 1 to 1024 characters. Only one of prefixMatch, fullPathMatch or regexMatch must be specified. |
pathMatchers[].routeRules[].matchRules[].fullPathMatch |
For satisfying the
Only one of prefixMatch, fullPathMatch or regexMatch must be specified. |
pathMatchers[].routeRules[].matchRules[].regexMatch |
For satisfying the Only one of Regular expressions can only be used when the loadBalancingScheme is set to |
pathMatchers[].routeRules[].matchRules[].ignoreCase |
Specifies that The default value is false. ignoreCase must not be used with regexMatch. Not supported when the URL map is bound to a target gRPC proxy. |
pathMatchers[].routeRules[].matchRules[].headerMatches[] |
Specifies a list of header match criteria, all of which must match corresponding headers in the request. |
pathMatchers[].routeRules[].matchRules[].headerMatches[].headerName |
The name of the HTTP header to match. For matching against the HTTP request's authority, use a headerMatch with the header name ":authority". For matching a request's method, use the headerName ":method". When the URL map is bound to a target gRPC proxy that has the |
pathMatchers[].routeRules[].matchRules[].headerMatches[].exactMatch |
The value should exactly match contents of Only one of |
pathMatchers[].routeRules[].matchRules[].headerMatches[].regexMatch |
The value of the header must match the regular expression specified in For matching against a port specified in the HTTP request, use a headerMatch with headerName set to PORT and a regular expression that satisfies the RFC2616 Host header's port specifier. Only one of Regular expressions can only be used when the loadBalancingScheme is set to |
pathMatchers[].routeRules[].matchRules[].headerMatches[].rangeMatch |
The header value must be an integer and its value must be in the range specified in For example for a range [-5, 0]
Only one of
|
pathMatchers[].routeRules[].matchRules[].headerMatches[].rangeMatch.rangeStart |
The start of the range (inclusive) in signed long integer format. |
pathMatchers[].routeRules[].matchRules[].headerMatches[].rangeMatch.rangeEnd |
The end of the range (exclusive) in signed long integer format. |
pathMatchers[].routeRules[].matchRules[].headerMatches[].presentMatch |
A header with the contents of Only one of |
pathMatchers[].routeRules[].matchRules[].headerMatches[].prefixMatch |
The value of the header must start with the contents of Only one of |
pathMatchers[].routeRules[].matchRules[].headerMatches[].suffixMatch |
The value of the header must end with the contents of Only one of |
pathMatchers[].routeRules[].matchRules[].headerMatches[].invertMatch |
If set to The default setting is |
pathMatchers[].routeRules[].matchRules[].queryParameterMatches[] |
Specifies a list of query parameter match criteria, all of which must match corresponding query parameters in the request. Not supported when the URL map is bound to a target gRPC proxy. |
pathMatchers[].routeRules[].matchRules[].queryParameterMatches[].name |
The name of the query parameter to match. The query parameter must exist in the request, in the absence of which the request match fails. |
pathMatchers[].routeRules[].matchRules[].queryParameterMatches[].presentMatch |
Specifies that the Only one of |
pathMatchers[].routeRules[].matchRules[].queryParameterMatches[].exactMatch |
The Only one of |
pathMatchers[].routeRules[].matchRules[].queryParameterMatches[].regexMatch |
The Only one of Regular expressions can only be used when the loadBalancingScheme is set to |
pathMatchers[].routeRules[].matchRules[].metadataFilters[] |
Opaque filter criteria used by the load balancer to restrict routing configuration to a limited set of xDS compliant clients. In their xDS requests to the load balancer, xDS clients present node metadata. When there is a match, the relevant routing configuration is made available to those proxies. For each
Not supported when the URL map is bound to a target gRPC proxy that has |
pathMatchers[].routeRules[].matchRules[].metadataFilters[].filterMatchCriteria |
Specifies how individual filter label matches within the list of Supported values are:
|
pathMatchers[].routeRules[].matchRules[].metadataFilters[].filterLabels[] |
The list of label value pairs that must match labels in the provided metadata based on This list must not be empty and can have at the most 64 entries. |
pathMatchers[].routeRules[].matchRules[].metadataFilters[].filterLabels[].name |
Name of metadata label. The name can have a maximum length of 1024 characters and must be at least 1 character long. |
pathMatchers[].routeRules[].matchRules[].metadataFilters[].filterLabels[].value |
The value of the label must match the specified value. value can have a maximum length of 1024 characters. |
pathMatchers[].routeRules[].matchRules[].pathTemplateMatch |
If specified, the route is a pattern match expression that must match the :path header once the query string is removed. A pattern match allows you to match
Precisely one of |
pathMatchers[].routeRules[].service |
The full or partial URL of the backend service resource to which traffic is directed if this rule is matched. If Only one of |
pathMatchers[].routeRules[].routeAction |
In response to a matching Only one of URL maps for classic Application Load Balancers only support the |
pathMatchers[].routeRules[].routeAction.weightedBackendServices[] |
A list of weighted backend services to send traffic to when a route match occurs. The weights determine the fraction of traffic that flows to their corresponding After a backend service is identified and before forwarding the request to the backend service, advanced routing actions such as URL rewrites and header transformations are applied depending on additional settings specified in this |
pathMatchers[].routeRules[].routeAction.weightedBackendServices[].backendService |
The full or partial URL to the default |
pathMatchers[].routeRules[].routeAction.weightedBackendServices[].weight |
Specifies the fraction of traffic sent to a backend service, computed as The selection of a backend service is determined only for new traffic. Once a user's request has been directed to a backend service, subsequent requests are sent to the same backend service as determined by the backend service's session affinity policy. Don't configure session affinity if you're using weighted traffic splitting. If you do, the weighted traffic splitting configuration takes precedence. The value must be from 0 to 1000. |
pathMatchers[].routeRules[].routeAction.weightedBackendServices[].headerAction |
Specifies changes to request and response headers that need to take effect for the selected
Not supported when the URL map is bound to a target gRPC proxy that has |
pathMatchers[].routeRules[].routeAction.weightedBackendServices[].headerAction.requestHeadersToRemove[] |
A list of header names for headers that need to be removed from the request before forwarding the request to the |
pathMatchers[].routeRules[].routeAction.weightedBackendServices[].headerAction.requestHeadersToAdd[] |
Headers to add to a matching request before forwarding the request to the |
pathMatchers[].routeRules[].routeAction.weightedBackendServices[].headerAction.requestHeadersToAdd[].headerName |
The name of the header. |
pathMatchers[].routeRules[].routeAction.weightedBackendServices[].headerAction.requestHeadersToAdd[].headerValue |
The value of the header to add. |
pathMatchers[].routeRules[].routeAction.weightedBackendServices[].headerAction.requestHeadersToAdd[].replace |
If The default value is |
pathMatchers[].routeRules[].routeAction.weightedBackendServices[].headerAction.responseHeadersToRemove[] |
A list of header names for headers that need to be removed from the response before sending the response back to the client. |
pathMatchers[].routeRules[].routeAction.weightedBackendServices[].headerAction.responseHeadersToAdd[] |
Headers to add the response before sending the response back to the client. |
pathMatchers[].routeRules[].routeAction.weightedBackendServices[].headerAction.responseHeadersToAdd[].headerName |
The name of the header. |
pathMatchers[].routeRules[].routeAction.weightedBackendServices[].headerAction.responseHeadersToAdd[].headerValue |
The value of the header to add. |
pathMatchers[].routeRules[].routeAction.weightedBackendServices[].headerAction.responseHeadersToAdd[].replace |
If The default value is |
pathMatchers[].routeRules[].routeAction.urlRewrite |
The spec to modify the URL of the request, before forwarding the request to the matched service. Not supported when the URL map is bound to a target gRPC proxy that has the |
pathMatchers[].routeRules[].routeAction.urlRewrite.pathPrefixRewrite |
Before forwarding the request to the selected backend service, the matching portion of the request's path is replaced by The value must be from 1 to 1024 characters. |
pathMatchers[].routeRules[].routeAction.urlRewrite.hostRewrite |
Before forwarding the request to the selected service, the request's host header is replaced with contents of The value must be from 1 to 255 characters. |
pathMatchers[].routeRules[].routeAction.urlRewrite.pathTemplateRewrite |
If specified, the pattern rewrites the URL path (based on the :path header) using the HTTP template syntax. A corresponding pathTemplateMatch must be specified. Any template variables must exist in the pathTemplateMatch field.
For example, a pathTemplateMatch of At least one non-empty Only one of |
pathMatchers[].routeRules[].routeAction.timeout |
Specifies the timeout for the selected route. Timeout is computed from the time the request has been fully processed (known as end-of-stream) up until the response has been processed. Timeout includes all retries. If not specified, this field uses the largest timeout among all backend services associated with the route. Not supported when the URL map is bound to a target gRPC proxy that has |
pathMatchers[].routeRules[].routeAction.timeout.seconds |
Span of time at a resolution of a second. Must be from 0 to 315,576,000,000 inclusive. Note: these bounds are computed from: 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years |
pathMatchers[].routeRules[].routeAction.timeout.nanos |
Span of time that's a fraction of a second at nanosecond resolution. Durations less than one second are represented with a 0 |
pathMatchers[].routeRules[].routeAction.retryPolicy |
Specifies the retry policy associated with this route. |
pathMatchers[].routeRules[].routeAction.retryPolicy.retryConditions[] |
Specifies one or more conditions when this retry policy applies. Valid values are:
Only the following codes are supported when the URL map is bound to target gRPC proxy that has validateForProxyless field set to true.
|
pathMatchers[].routeRules[].routeAction.retryPolicy.numRetries |
Specifies the allowed number retries. This number must be > 0. If not specified, defaults to 1. |
pathMatchers[].routeRules[].routeAction.retryPolicy.perTryTimeout |
Specifies a non-zero timeout per retry attempt. If not specified, will use the timeout set in the Not supported when the URL map is bound to a target gRPC proxy that has the |
pathMatchers[].routeRules[].routeAction.retryPolicy.perTryTimeout.seconds |
Span of time at a resolution of a second. Must be from 0 to 315,576,000,000 inclusive. Note: these bounds are computed from: 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years |
pathMatchers[].routeRules[].routeAction.retryPolicy.perTryTimeout.nanos |
Span of time that's a fraction of a second at nanosecond resolution. Durations less than one second are represented with a 0 |
pathMatchers[].routeRules[].routeAction.requestMirrorPolicy |
Specifies the policy on how requests intended for the route's backends are shadowed to a separate mirrored backend service. The load balancer does not wait for responses from the shadow service. Before sending traffic to the shadow service, the host / authority header is suffixed with Not supported when the URL map is bound to a target gRPC proxy that has the |
pathMatchers[].routeRules[].routeAction.requestMirrorPolicy.backendService |
The full or partial URL to the The backend service configured for a mirroring policy must reference backends that are of the same type as the original backend service matched in the URL map. Serverless NEG backends are not currently supported as a mirrored backend service. |
pathMatchers[].routeRules[].routeAction.requestMirrorPolicy.mirrorPercent |
The percentage of requests to be mirrored to |
pathMatchers[].routeRules[].routeAction.corsPolicy |
The specification for allowing client-side cross-origin requests. For more information about the W3C recommendation for cross-origin resource sharing (CORS), see Fetch API Living Standard. Not supported when the URL map is bound to a target gRPC proxy. |
pathMatchers[].routeRules[].routeAction.corsPolicy.allowOrigins[] |
Specifies the list of origins that is allowed to do CORS requests. An origin is allowed if it matches either an item in |
pathMatchers[].routeRules[].routeAction.corsPolicy.allowOriginRegexes[] |
Specifies a regular expression that matches allowed origins. For more information, see regular expression syntax . An origin is allowed if it matches either an item in Regular expressions can only be used when the loadBalancingScheme is set to |
pathMatchers[].routeRules[].routeAction.corsPolicy.allowMethods[] |
Specifies the content for the |
pathMatchers[].routeRules[].routeAction.corsPolicy.allowHeaders[] |
Specifies the content for the |
pathMatchers[].routeRules[].routeAction.corsPolicy.exposeHeaders[] |
Specifies the content for the |
pathMatchers[].routeRules[].routeAction.corsPolicy.maxAge |
Specifies how long results of a preflight request can be cached in seconds. This field translates to the |
pathMatchers[].routeRules[].routeAction.corsPolicy.allowCredentials |
In response to a preflight request, setting this to Default is |
pathMatchers[].routeRules[].routeAction.corsPolicy.disabled |
If |
pathMatchers[].routeRules[].routeAction.faultInjectionPolicy |
The specification for fault injection introduced into traffic to test the resiliency of clients to backend service failure. As part of fault injection, when clients send requests to a backend service, delays can be introduced by a load balancer on a percentage of requests before sending those requests to the backend service. Similarly requests from clients can be aborted by the load balancer for a percentage of requests. |
pathMatchers[].routeRules[].routeAction.faultInjectionPolicy.delay |
The specification for how client requests are delayed as part of fault injection, before being sent to a backend service. |
pathMatchers[].routeRules[].routeAction.faultInjectionPolicy.delay.fixedDelay |
Specifies the value of the fixed delay interval. |
pathMatchers[].routeRules[].routeAction.faultInjectionPolicy.delay.fixedDelay.seconds |
Span of time at a resolution of a second. Must be from 0 to 315,576,000,000 inclusive. Note: these bounds are computed from: 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years |
pathMatchers[].routeRules[].routeAction.faultInjectionPolicy.delay.fixedDelay.nanos |
Span of time that's a fraction of a second at nanosecond resolution. Durations less than one second are represented with a 0 |
pathMatchers[].routeRules[].routeAction.faultInjectionPolicy.delay.percentage |
The percentage of traffic for connections, operations, or requests for which a delay is introduced as part of fault injection. The value must be from 0.0 to 100.0 inclusive. |
pathMatchers[].routeRules[].routeAction.faultInjectionPolicy.abort |
The specification for how client requests are aborted as part of fault injection. |
pathMatchers[].routeRules[].routeAction.faultInjectionPolicy.abort.httpStatus |
The HTTP status code used to abort the request. The value must be from 200 to 599 inclusive. For gRPC protocol, the gRPC status code is mapped to HTTP status code according to this mapping table. HTTP status 200 is mapped to gRPC status UNKNOWN. Injecting an OK status is currently not supported by Traffic Director. |
pathMatchers[].routeRules[].routeAction.faultInjectionPolicy.abort.percentage |
The percentage of traffic for connections, operations, or requests that is aborted as part of fault injection. The value must be from 0.0 to 100.0 inclusive. |
pathMatchers[].routeRules[].routeAction.maxStreamDuration |
Specifies the maximum duration (timeout) for streams on the selected route. Unlike the If not specified, this field uses the maximum This field is only allowed if the Url map is used with backend services with |
pathMatchers[].routeRules[].routeAction.maxStreamDuration.seconds |
Span of time at a resolution of a second. Must be from 0 to 315,576,000,000 inclusive. Note: these bounds are computed from: 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years |
pathMatchers[].routeRules[].routeAction.maxStreamDuration.nanos |
Span of time that's a fraction of a second at nanosecond resolution. Durations less than one second are represented with a 0 |
pathMatchers[].routeRules[].urlRedirect |
When this rule is matched, the request is redirected to a URL specified by If Not supported when the URL map is bound to a target gRPC proxy. |
pathMatchers[].routeRules[].urlRedirect.hostRedirect |
The host that is used in the redirect response instead of the one that was supplied in the request. The value must be from 1 to 255 characters. |
pathMatchers[].routeRules[].urlRedirect.pathRedirect |
The path that is used in the redirect response instead of the one that was supplied in the request.
The value must be from 1 to 1024 characters. |
pathMatchers[].routeRules[].urlRedirect.prefixRedirect |
The prefix that replaces the
The value must be from 1 to 1024 characters. |
pathMatchers[].routeRules[].urlRedirect.redirectResponseCode |
The HTTP Status code to use for this RedirectAction. Supported values are:
|
pathMatchers[].routeRules[].urlRedirect.httpsRedirect |
If set to This must only be set for URL maps used in The default is set to |
pathMatchers[].routeRules[].urlRedirect.stripQuery |
If set to The default is set to |
pathMatchers[].routeRules[].headerAction |
Specifies changes to request and response headers that need to take effect for the selected The
Not supported when the URL map is bound to a target gRPC proxy that has |
pathMatchers[].routeRules[].headerAction.requestHeadersToRemove[] |
A list of header names for headers that need to be removed from the request before forwarding the request to the |
pathMatchers[].routeRules[].headerAction.requestHeadersToAdd[] |
Headers to add to a matching request before forwarding the request to the |
pathMatchers[].routeRules[].headerAction.requestHeadersToAdd[].headerName |
The name of the header. |
pathMatchers[].routeRules[].headerAction.requestHeadersToAdd[].headerValue |
The value of the header to add. |
pathMatchers[].routeRules[].headerAction.requestHeadersToAdd[].replace |
If The default value is |
pathMatchers[].routeRules[].headerAction.responseHeadersToRemove[] |
A list of header names for headers that need to be removed from the response before sending the response back to the client. |
pathMatchers[].routeRules[].headerAction.responseHeadersToAdd[] |
Headers to add the response before sending the response back to the client. |
pathMatchers[].routeRules[].headerAction.responseHeadersToAdd[].headerName |
The name of the header. |
pathMatchers[].routeRules[].headerAction.responseHeadersToAdd[].headerValue |
The value of the header to add. |
pathMatchers[].routeRules[].headerAction.responseHeadersToAdd[].replace |
If The default value is |
pathMatchers[].routeRules[].httpFilterConfigs[] |
Outbound route specific configuration for Not supported when the URL map is bound to a target gRPC proxy that has |
pathMatchers[].routeRules[].httpFilterConfigs[].filterName |
Name of the |
pathMatchers[].routeRules[].httpFilterConfigs[].configTypeUrl |
The fully qualified versioned proto3 type url of the protobuf that the filter expects for its contextual settings, for example: |
pathMatchers[].routeRules[].httpFilterConfigs[].config |
The configuration needed to enable the |
pathMatchers[].routeRules[].httpFilterMetadata[] |
Outbound route specific metadata supplied to The only Not supported when the URL map is bound to a target gRPC proxy that has |
pathMatchers[].routeRules[].httpFilterMetadata[].filterName |
Name of the |
pathMatchers[].routeRules[].httpFilterMetadata[].configTypeUrl |
The fully qualified versioned proto3 type url of the protobuf that the filter expects for its contextual settings, for example: |
pathMatchers[].routeRules[].httpFilterMetadata[].config |
The configuration needed to enable the |
pathMatchers[].routeRules[].customErrorResponsePolicy |
If a policy for an error code is not configured for the For example, consider a UrlMap with the following configuration:
If the request is for When used in conjunction with
|
pathMatchers[].routeRules[].customErrorResponsePolicy.errorResponseRules[] |
Specifies rules for returning error responses. In a given policy, if you specify rules for both a range of error codes as well as rules for specific error codes then rules with specific error codes have a higher priority. For example, assume that you configure a rule for |
pathMatchers[].routeRules[].customErrorResponsePolicy.errorResponseRules[].matchResponseCodes[] |
Valid values include:
Values must be unique within matchResponseCodes and across all |
pathMatchers[].routeRules[].customErrorResponsePolicy.errorResponseRules[].path |
The full path to a file within
If the file is not available in The value must be from |
pathMatchers[].routeRules[].customErrorResponsePolicy.errorResponseRules[].overrideResponseCode |
The HTTP status code returned with the response containing the custom error content. If |
pathMatchers[].routeRules[].customErrorResponsePolicy.errorService |
The full or partial URL to the
If If
|
pathMatchers[].headerAction |
Specifies changes to request and response headers that need to take effect for the selected backend service. HeaderAction specified here are applied after the matching
Not supported when the URL map is bound to a target gRPC proxy that has |
pathMatchers[].headerAction.requestHeadersToRemove[] |
A list of header names for headers that need to be removed from the request before forwarding the request to the |
pathMatchers[].headerAction.requestHeadersToAdd[] |
Headers to add to a matching request before forwarding the request to the |
pathMatchers[].headerAction.requestHeadersToAdd[].headerName |
The name of the header. |
pathMatchers[].headerAction.requestHeadersToAdd[].headerValue |
The value of the header to add. |
pathMatchers[].headerAction.requestHeadersToAdd[].replace |
If The default value is |
pathMatchers[].headerAction.responseHeadersToRemove[] |
A list of header names for headers that need to be removed from the response before sending the response back to the client. |
pathMatchers[].headerAction.responseHeadersToAdd[] |
Headers to add the response before sending the response back to the client. |
pathMatchers[].headerAction.responseHeadersToAdd[].headerName |
The name of the header. |
pathMatchers[].headerAction.responseHeadersToAdd[].headerValue |
The value of the header to add. |
pathMatchers[].headerAction.responseHeadersToAdd[].replace |
If The default value is |
pathMatchers[].defaultCustomErrorResponsePolicy |
This policy takes effect at the For example, consider a UrlMap with the following configuration:
If the request is for When used in conjunction with
|
pathMatchers[].defaultCustomErrorResponsePolicy.errorResponseRules[] |
Specifies rules for returning error responses. In a given policy, if you specify rules for both a range of error codes as well as rules for specific error codes then rules with specific error codes have a higher priority. For example, assume that you configure a rule for |
pathMatchers[].defaultCustomErrorResponsePolicy.errorResponseRules[].matchResponseCodes[] |
Valid values include:
Values must be unique within matchResponseCodes and across all |
pathMatchers[].defaultCustomErrorResponsePolicy.errorResponseRules[].path |
The full path to a file within
If the file is not available in The value must be from |
pathMatchers[].defaultCustomErrorResponsePolicy.errorResponseRules[].overrideResponseCode |
The HTTP status code returned with the response containing the custom error content. If |
pathMatchers[].defaultCustomErrorResponsePolicy.errorService |
The full or partial URL to the
If If
|
tests[] |
The list of expected URL mapping tests. Request to update the Not supported when the URL map is bound to a target gRPC proxy that has |
tests[].description |
Description of this test case. |
tests[].host |
Host portion of the URL. If |
tests[].path |
Path portion of the URL. |
tests[].headers[] |
HTTP headers for this request. If |
tests[].headers[].name |
Header name. |
tests[].headers[].value |
Header value. |
tests[].service |
Expected The |
tests[].expectedOutputUrl |
The expected output URL evaluated by the load balancer containing the scheme, host, path and query parameters. For rules that forward requests to backends, the test passes only when For rules with
|
tests[].expectedRedirectResponseCode |
For rules with
|
defaultService |
The full or partial URL of the If
|
defaultRouteAction |
Only one of URL maps for classic Application Load Balancers only support the
|
defaultRouteAction.weightedBackendServices[] |
A list of weighted backend services to send traffic to when a route match occurs. The weights determine the fraction of traffic that flows to their corresponding After a backend service is identified and before forwarding the request to the backend service, advanced routing actions such as URL rewrites and header transformations are applied depending on additional settings specified in this |
defaultRouteAction.weightedBackendServices[].backendService |
The full or partial URL to the default |
defaultRouteAction.weightedBackendServices[].weight |
Specifies the fraction of traffic sent to a backend service, computed as The selection of a backend service is determined only for new traffic. Once a user's request has been directed to a backend service, subsequent requests are sent to the same backend service as determined by the backend service's session affinity policy. Don't configure session affinity if you're using weighted traffic splitting. If you do, the weighted traffic splitting configuration takes precedence. The value must be from 0 to 1000. |
defaultRouteAction.weightedBackendServices[].headerAction |
Specifies changes to request and response headers that need to take effect for the selected
Not supported when the URL map is bound to a target gRPC proxy that has |
defaultRouteAction.weightedBackendServices[].headerAction.requestHeadersToRemove[] |
A list of header names for headers that need to be removed from the request before forwarding the request to the |
defaultRouteAction.weightedBackendServices[].headerAction.requestHeadersToAdd[] |
Headers to add to a matching request before forwarding the request to the |
defaultRouteAction.weightedBackendServices[].headerAction.requestHeadersToAdd[].headerName |
The name of the header. |
defaultRouteAction.weightedBackendServices[].headerAction.requestHeadersToAdd[].headerValue |
The value of the header to add. |
defaultRouteAction.weightedBackendServices[].headerAction.requestHeadersToAdd[].replace |
If The default value is |
defaultRouteAction.weightedBackendServices[].headerAction.responseHeadersToRemove[] |
A list of header names for headers that need to be removed from the response before sending the response back to the client. |
defaultRouteAction.weightedBackendServices[].headerAction.responseHeadersToAdd[] |
Headers to add the response before sending the response back to the client. |
defaultRouteAction.weightedBackendServices[].headerAction.responseHeadersToAdd[].headerName |
The name of the header. |
defaultRouteAction.weightedBackendServices[].headerAction.responseHeadersToAdd[].headerValue |
The value of the header to add. |
defaultRouteAction.weightedBackendServices[].headerAction.responseHeadersToAdd[].replace |
If The default value is |
defaultRouteAction.urlRewrite |
The spec to modify the URL of the request, before forwarding the request to the matched service. Not supported when the URL map is bound to a target gRPC proxy that has the |
defaultRouteAction.urlRewrite.pathPrefixRewrite |
Before forwarding the request to the selected backend service, the matching portion of the request's path is replaced by The value must be from 1 to 1024 characters. |
defaultRouteAction.urlRewrite.hostRewrite |
Before forwarding the request to the selected service, the request's host header is replaced with contents of The value must be from 1 to 255 characters. |
defaultRouteAction.urlRewrite.pathTemplateRewrite |
If specified, the pattern rewrites the URL path (based on the :path header) using the HTTP template syntax. A corresponding pathTemplateMatch must be specified. Any template variables must exist in the pathTemplateMatch field.
For example, a pathTemplateMatch of At least one non-empty Only one of |
defaultRouteAction.timeout |
Specifies the timeout for the selected route. Timeout is computed from the time the request has been fully processed (known as end-of-stream) up until the response has been processed. Timeout includes all retries. If not specified, this field uses the largest timeout among all backend services associated with the route. Not supported when the URL map is bound to a target gRPC proxy that has |
defaultRouteAction.timeout.seconds |
Span of time at a resolution of a second. Must be from 0 to 315,576,000,000 inclusive. Note: these bounds are computed from: 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years |
defaultRouteAction.timeout.nanos |
Span of time that's a fraction of a second at nanosecond resolution. Durations less than one second are represented with a 0 |
defaultRouteAction.retryPolicy |
Specifies the retry policy associated with this route. |
defaultRouteAction.retryPolicy.retryConditions[] |
Specifies one or more conditions when this retry policy applies. Valid values are:
Only the following codes are supported when the URL map is bound to target gRPC proxy that has validateForProxyless field set to true.
|
defaultRouteAction.retryPolicy.numRetries |
Specifies the allowed number retries. This number must be > 0. If not specified, defaults to 1. |
defaultRouteAction.retryPolicy.perTryTimeout |
Specifies a non-zero timeout per retry attempt. If not specified, will use the timeout set in the Not supported when the URL map is bound to a target gRPC proxy that has the |
defaultRouteAction.retryPolicy.perTryTimeout.seconds |
Span of time at a resolution of a second. Must be from 0 to 315,576,000,000 inclusive. Note: these bounds are computed from: 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years |
defaultRouteAction.retryPolicy.perTryTimeout.nanos |
Span of time that's a fraction of a second at nanosecond resolution. Durations less than one second are represented with a 0 |
defaultRouteAction.requestMirrorPolicy |
Specifies the policy on how requests intended for the route's backends are shadowed to a separate mirrored backend service. The load balancer does not wait for responses from the shadow service. Before sending traffic to the shadow service, the host / authority header is suffixed with Not supported when the URL map is bound to a target gRPC proxy that has the |
defaultRouteAction.requestMirrorPolicy.backendService |
The full or partial URL to the The backend service configured for a mirroring policy must reference backends that are of the same type as the original backend service matched in the URL map. Serverless NEG backends are not currently supported as a mirrored backend service. |
defaultRouteAction.requestMirrorPolicy.mirrorPercent |
The percentage of requests to be mirrored to |
defaultRouteAction.corsPolicy |
The specification for allowing client-side cross-origin requests. For more information about the W3C recommendation for cross-origin resource sharing (CORS), see Fetch API Living Standard. Not supported when the URL map is bound to a target gRPC proxy. |
defaultRouteAction.corsPolicy.allowOrigins[] |
Specifies the list of origins that is allowed to do CORS requests. An origin is allowed if it matches either an item in |
defaultRouteAction.corsPolicy.allowOriginRegexes[] |
Specifies a regular expression that matches allowed origins. For more information, see regular expression syntax . An origin is allowed if it matches either an item in Regular expressions can only be used when the loadBalancingScheme is set to |
defaultRouteAction.corsPolicy.allowMethods[] |
Specifies the content for the |
defaultRouteAction.corsPolicy.allowHeaders[] |
Specifies the content for the |
defaultRouteAction.corsPolicy.exposeHeaders[] |
Specifies the content for the |
defaultRouteAction.corsPolicy.maxAge |
Specifies how long results of a preflight request can be cached in seconds. This field translates to the |
defaultRouteAction.corsPolicy.allowCredentials |
In response to a preflight request, setting this to Default is |
defaultRouteAction.corsPolicy.disabled |
If |
defaultRouteAction.faultInjectionPolicy |
The specification for fault injection introduced into traffic to test the resiliency of clients to backend service failure. As part of fault injection, when clients send requests to a backend service, delays can be introduced by a load balancer on a percentage of requests before sending those requests to the backend service. Similarly requests from clients can be aborted by the load balancer for a percentage of requests. |
defaultRouteAction.faultInjectionPolicy.delay |
The specification for how client requests are delayed as part of fault injection, before being sent to a backend service. |
defaultRouteAction.faultInjectionPolicy.delay.fixedDelay |
Specifies the value of the fixed delay interval. |
defaultRouteAction.faultInjectionPolicy.delay.fixedDelay.seconds |
Span of time at a resolution of a second. Must be from 0 to 315,576,000,000 inclusive. Note: these bounds are computed from: 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years |
defaultRouteAction.faultInjectionPolicy.delay.fixedDelay.nanos |
Span of time that's a fraction of a second at nanosecond resolution. Durations less than one second are represented with a 0 |
defaultRouteAction.faultInjectionPolicy.delay.percentage |
The percentage of traffic for connections, operations, or requests for which a delay is introduced as part of fault injection. The value must be from 0.0 to 100.0 inclusive. |
defaultRouteAction.faultInjectionPolicy.abort |
The specification for how client requests are aborted as part of fault injection. |
defaultRouteAction.faultInjectionPolicy.abort.httpStatus |
The HTTP status code used to abort the request. The value must be from 200 to 599 inclusive. For gRPC protocol, the gRPC status code is mapped to HTTP status code according to this mapping table. HTTP status 200 is mapped to gRPC status UNKNOWN. Injecting an OK status is currently not supported by Traffic Director. |
defaultRouteAction.faultInjectionPolicy.abort.percentage |
The percentage of traffic for connections, operations, or requests that is aborted as part of fault injection. The value must be from 0.0 to 100.0 inclusive. |
defaultRouteAction.maxStreamDuration |
Specifies the maximum duration (timeout) for streams on the selected route. Unlike the If not specified, this field uses the maximum This field is only allowed if the Url map is used with backend services with |
defaultRouteAction.maxStreamDuration.seconds |
Span of time at a resolution of a second. Must be from 0 to 315,576,000,000 inclusive. Note: these bounds are computed from: 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years |
defaultRouteAction.maxStreamDuration.nanos |
Span of time that's a fraction of a second at nanosecond resolution. Durations less than one second are represented with a 0 |
defaultUrlRedirect |
When none of the specified If Not supported when the URL map is bound to a target gRPC proxy. |
defaultUrlRedirect.hostRedirect |
The host that is used in the redirect response instead of the one that was supplied in the request. The value must be from 1 to 255 characters. |
defaultUrlRedirect.pathRedirect |
The path that is used in the redirect response instead of the one that was supplied in the request.
The value must be from 1 to 1024 characters. |
defaultUrlRedirect.prefixRedirect |
The prefix that replaces the
The value must be from 1 to 1024 characters. |
defaultUrlRedirect.redirectResponseCode |
The HTTP Status code to use for this RedirectAction. Supported values are:
|
defaultUrlRedirect.httpsRedirect |
If set to This must only be set for URL maps used in The default is set to |
defaultUrlRedirect.stripQuery |
If set to The default is set to |
headerAction |
Specifies changes to request and response headers that need to take effect for the selected The
Not supported when the URL map is bound to a target gRPC proxy that has |
headerAction.requestHeadersToRemove[] |
A list of header names for headers that need to be removed from the request before forwarding the request to the |
headerAction.requestHeadersToAdd[] |
Headers to add to a matching request before forwarding the request to the |
headerAction.requestHeadersToAdd[].headerName |
The name of the header. |
headerAction.requestHeadersToAdd[].headerValue |
The value of the header to add. |
headerAction.requestHeadersToAdd[].replace |
If The default value is |
headerAction.responseHeadersToRemove[] |
A list of header names for headers that need to be removed from the response before sending the response back to the client. |
headerAction.responseHeadersToAdd[] |
Headers to add the response before sending the response back to the client. |
headerAction.responseHeadersToAdd[].headerName |
The name of the header. |
headerAction.responseHeadersToAdd[].headerValue |
The value of the header to add. |
headerAction.responseHeadersToAdd[].replace |
If The default value is |
defaultCustomErrorResponsePolicy |
This policy takes effect at the load balancer level and applies only when no policy has been defined for the error code at lower levels like PathMatcher, RouteRule and PathRule within this UrlMap. For example, consider a UrlMap with the following configuration:
If a request for When used in conjunction with
|
defaultCustomErrorResponsePolicy.errorResponseRules[] |
Specifies rules for returning error responses. In a given policy, if you specify rules for both a range of error codes as well as rules for specific error codes then rules with specific error codes have a higher priority. For example, assume that you configure a rule for |
defaultCustomErrorResponsePolicy.errorResponseRules[].matchResponseCodes[] |
Valid values include:
Values must be unique within matchResponseCodes and across all |
defaultCustomErrorResponsePolicy.errorResponseRules[].path |
The full path to a file within
If the file is not available in The value must be from |
defaultCustomErrorResponsePolicy.errorResponseRules[].overrideResponseCode |
The HTTP status code returned with the response containing the custom error content. If |
defaultCustomErrorResponsePolicy.errorService |
The full or partial URL to the
If If
|
fingerprint |
Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field is ignored when inserting a To see the latest fingerprint, make a A base64-encoded string. |
region |
[Output Only] URL of the region where the regional URL map resides. This field is not applicable to global URL maps. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body. |
Authorization scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/compute.readonly
https://www.googleapis.com/auth/compute
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview.
IAM Permissions
In addition to any permissions specified on the fields above, authorization requires one or more of the following IAM permissions:
compute.regionUrlMaps.get
To find predefined roles that contain those permissions, see Compute Engine IAM Roles.