Reference documentation and code samples for the Compute V1 Client class HttpRouteAction.
Generated from protobuf message google.cloud.compute.v1.HttpRouteAction
Methods
__construct
Constructor.
| Parameters | |
|---|---|
| Name | Description |
data |
array
Optional. Data for populating the Message object. |
↳ cors_policy |
Google\Cloud\Compute\V1\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. |
↳ fault_injection_policy |
Google\Cloud\Compute\V1\HttpFaultInjection
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. timeout and retry_policy is ignored by clients that are configured with a fault_injection_policy if: 1. The traffic is generated by fault injection AND 2. The fault injection is not a delay fault injection. Fault injection is not supported with the global external HTTP(S) load balancer (classic). To see which load balancers support fault injection, see Load balancing: Routing and traffic management features. |
↳ max_stream_duration |
Google\Cloud\Compute\V1\Duration
Specifies the maximum duration (timeout) for streams on the selected route. Unlike the timeout field where the timeout duration starts from the time the request has been fully processed (known as end-of-stream), the duration in this field is computed from the beginning of the stream until the response has been processed, including all retries. A stream that does not complete in this duration is closed. If not specified, this field uses the maximum maxStreamDuration value among all backend services associated with the route. This field is only allowed if the Url map is used with backend services with loadBalancingScheme set to INTERNAL_SELF_MANAGED. |
↳ request_mirror_policy |
Google\Cloud\Compute\V1\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 -shadow. Not supported when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true. |
↳ retry_policy |
Google\Cloud\Compute\V1\HttpRetryPolicy
Specifies the retry policy associated with this route. |
↳ timeout |
Google\Cloud\Compute\V1\Duration
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 validateForProxyless field set to true. |
↳ url_rewrite |
Google\Cloud\Compute\V1\UrlRewrite
The spec to modify the URL of the request, before forwarding the request to the matched service. urlRewrite is the only action supported in UrlMaps for external HTTP(S) load balancers. Not supported when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true. |
↳ weighted_backend_services |
array<Google\Cloud\Compute\V1\WeightedBackendService>
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 backend service. If all traffic needs to go to a single backend service, there must be one weightedBackendService with weight set to a non-zero number. 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 HttpRouteAction. |
getCorsPolicy
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.
Generated from protobuf field optional .google.cloud.compute.v1.CorsPolicy cors_policy = 398943748;
| Returns | |
|---|---|
| Type | Description |
Google\Cloud\Compute\V1\CorsPolicy|null | |
hasCorsPolicy
clearCorsPolicy
setCorsPolicy
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.
Generated from protobuf field optional .google.cloud.compute.v1.CorsPolicy cors_policy = 398943748;
| Parameter | |
|---|---|
| Name | Description |
var |
Google\Cloud\Compute\V1\CorsPolicy
|
| Returns | |
|---|---|
| Type | Description |
$this | |
getFaultInjectionPolicy
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. timeout and retry_policy is ignored by clients that are configured with a fault_injection_policy if: 1. The traffic is generated by fault injection AND 2. The fault injection is not a delay fault injection. Fault injection is not supported with the global external HTTP(S) load balancer (classic). To see which load balancers support fault injection, see Load balancing: Routing and traffic management features.
Generated from protobuf field optional .google.cloud.compute.v1.HttpFaultInjection fault_injection_policy = 412781079;
| Returns | |
|---|---|
| Type | Description |
Google\Cloud\Compute\V1\HttpFaultInjection|null | |
hasFaultInjectionPolicy
clearFaultInjectionPolicy
setFaultInjectionPolicy
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. timeout and retry_policy is ignored by clients that are configured with a fault_injection_policy if: 1. The traffic is generated by fault injection AND 2. The fault injection is not a delay fault injection. Fault injection is not supported with the global external HTTP(S) load balancer (classic). To see which load balancers support fault injection, see Load balancing: Routing and traffic management features.
Generated from protobuf field optional .google.cloud.compute.v1.HttpFaultInjection fault_injection_policy = 412781079;
| Parameter | |
|---|---|
| Name | Description |
var |
Google\Cloud\Compute\V1\HttpFaultInjection
|
| Returns | |
|---|---|
| Type | Description |
$this | |
getMaxStreamDuration
Specifies the maximum duration (timeout) for streams on the selected route. Unlike the timeout field where the timeout duration starts from the time the request has been fully processed (known as end-of-stream), the duration in this field is computed from the beginning of the stream until the response has been processed, including all retries. A stream that does not complete in this duration is closed. If not specified, this field uses the maximum maxStreamDuration value among all backend services associated with the route. This field is only allowed if the Url map is used with backend services with loadBalancingScheme set to INTERNAL_SELF_MANAGED.
Generated from protobuf field optional .google.cloud.compute.v1.Duration max_stream_duration = 61428376;
| Returns | |
|---|---|
| Type | Description |
Google\Cloud\Compute\V1\Duration|null | |
hasMaxStreamDuration
clearMaxStreamDuration
setMaxStreamDuration
Specifies the maximum duration (timeout) for streams on the selected route. Unlike the timeout field where the timeout duration starts from the time the request has been fully processed (known as end-of-stream), the duration in this field is computed from the beginning of the stream until the response has been processed, including all retries. A stream that does not complete in this duration is closed. If not specified, this field uses the maximum maxStreamDuration value among all backend services associated with the route. This field is only allowed if the Url map is used with backend services with loadBalancingScheme set to INTERNAL_SELF_MANAGED.
Generated from protobuf field optional .google.cloud.compute.v1.Duration max_stream_duration = 61428376;
| Parameter | |
|---|---|
| Name | Description |
var |
Google\Cloud\Compute\V1\Duration
|
| Returns | |
|---|---|
| Type | Description |
$this | |
getRequestMirrorPolicy
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 -shadow. Not supported when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true.
Generated from protobuf field optional .google.cloud.compute.v1.RequestMirrorPolicy request_mirror_policy = 220196866;
| Returns | |
|---|---|
| Type | Description |
Google\Cloud\Compute\V1\RequestMirrorPolicy|null | |
hasRequestMirrorPolicy
clearRequestMirrorPolicy
setRequestMirrorPolicy
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 -shadow. Not supported when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true.
Generated from protobuf field optional .google.cloud.compute.v1.RequestMirrorPolicy request_mirror_policy = 220196866;
| Parameter | |
|---|---|
| Name | Description |
var |
Google\Cloud\Compute\V1\RequestMirrorPolicy
|
| Returns | |
|---|---|
| Type | Description |
$this | |
getRetryPolicy
Specifies the retry policy associated with this route.
Generated from protobuf field optional .google.cloud.compute.v1.HttpRetryPolicy retry_policy = 56799913;
| Returns | |
|---|---|
| Type | Description |
Google\Cloud\Compute\V1\HttpRetryPolicy|null | |
hasRetryPolicy
clearRetryPolicy
setRetryPolicy
Specifies the retry policy associated with this route.
Generated from protobuf field optional .google.cloud.compute.v1.HttpRetryPolicy retry_policy = 56799913;
| Parameter | |
|---|---|
| Name | Description |
var |
Google\Cloud\Compute\V1\HttpRetryPolicy
|
| Returns | |
|---|---|
| Type | Description |
$this | |
getTimeout
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 validateForProxyless field set to true.
Generated from protobuf field optional .google.cloud.compute.v1.Duration timeout = 296701281;
| Returns | |
|---|---|
| Type | Description |
Google\Cloud\Compute\V1\Duration|null | |
hasTimeout
clearTimeout
setTimeout
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 validateForProxyless field set to true.
Generated from protobuf field optional .google.cloud.compute.v1.Duration timeout = 296701281;
| Parameter | |
|---|---|
| Name | Description |
var |
Google\Cloud\Compute\V1\Duration
|
| Returns | |
|---|---|
| Type | Description |
$this | |
getUrlRewrite
The spec to modify the URL of the request, before forwarding the request to the matched service. urlRewrite is the only action supported in UrlMaps for external HTTP(S) load balancers. Not supported when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true.
Generated from protobuf field optional .google.cloud.compute.v1.UrlRewrite url_rewrite = 273333948;
| Returns | |
|---|---|
| Type | Description |
Google\Cloud\Compute\V1\UrlRewrite|null | |
hasUrlRewrite
clearUrlRewrite
setUrlRewrite
The spec to modify the URL of the request, before forwarding the request to the matched service. urlRewrite is the only action supported in UrlMaps for external HTTP(S) load balancers. Not supported when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true.
Generated from protobuf field optional .google.cloud.compute.v1.UrlRewrite url_rewrite = 273333948;
| Parameter | |
|---|---|
| Name | Description |
var |
Google\Cloud\Compute\V1\UrlRewrite
|
| Returns | |
|---|---|
| Type | Description |
$this | |
getWeightedBackendServices
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 backend service. If all traffic needs to go to a single backend service, there must be one weightedBackendService with weight set to a non-zero number. 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 HttpRouteAction.
Generated from protobuf field repeated .google.cloud.compute.v1.WeightedBackendService weighted_backend_services = 337028049;
| Returns | |
|---|---|
| Type | Description |
Google\Protobuf\Internal\RepeatedField | |
setWeightedBackendServices
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 backend service. If all traffic needs to go to a single backend service, there must be one weightedBackendService with weight set to a non-zero number. 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 HttpRouteAction.
Generated from protobuf field repeated .google.cloud.compute.v1.WeightedBackendService weighted_backend_services = 337028049;
| Parameter | |
|---|---|
| Name | Description |
var |
array<Google\Cloud\Compute\V1\WeightedBackendService>
|
| Returns | |
|---|---|
| Type | Description |
$this | |