Compute V1 Client - Class BackendServiceFailoverPolicy (1.21.0)

Reference documentation and code samples for the Compute V1 Client class BackendServiceFailoverPolicy.

For load balancers that have configurable failover: Internal passthrough Network Load Balancers and external passthrough Network Load Balancers. On failover or failback, this field indicates whether connection draining will be honored. Google Cloud has a fixed connection draining timeout of 10 minutes. A setting of true terminates existing TCP connections to the active pool during failover and failback, immediately draining traffic. A setting of false allows existing TCP connections to persist, even on VMs no longer in the active pool, for up to the duration of the connection draining timeout (10 minutes).

Generated from protobuf message google.cloud.compute.v1.BackendServiceFailoverPolicy

Namespace

Google \ Cloud \ Compute \ V1

Methods

__construct

Constructor.

Parameters
Name Description
data array

Optional. Data for populating the Message object.

↳ disable_connection_drain_on_failover bool

This can be set to true only if the protocol is TCP. The default is false.

↳ drop_traffic_if_unhealthy bool

If set to true, connections to the load balancer are dropped when all primary and all backup backend VMs are unhealthy.If set to false, connections are distributed among all primary VMs when all primary and all backup backend VMs are unhealthy. For load balancers that have configurable failover: Internal passthrough Network Load Balancers and external passthrough Network Load Balancers. The default is false.

↳ failover_ratio float

The value of the field must be in the range [0, 1]. If the value is 0, the load balancer performs a failover when the number of healthy primary VMs equals zero. For all other values, the load balancer performs a failover when the total number of healthy primary VMs is less than this ratio. For load balancers that have configurable failover: Internal TCP/UDP Load Balancing and external TCP/UDP Load Balancing.

getDisableConnectionDrainOnFailover

This can be set to true only if the protocol is TCP. The default is false.

Returns
Type Description
bool

hasDisableConnectionDrainOnFailover

clearDisableConnectionDrainOnFailover

setDisableConnectionDrainOnFailover

This can be set to true only if the protocol is TCP. The default is false.

Parameter
Name Description
var bool
Returns
Type Description
$this

getDropTrafficIfUnhealthy

If set to true, connections to the load balancer are dropped when all primary and all backup backend VMs are unhealthy.If set to false, connections are distributed among all primary VMs when all primary and all backup backend VMs are unhealthy. For load balancers that have configurable failover: Internal passthrough Network Load Balancers and external passthrough Network Load Balancers. The default is false.

Returns
Type Description
bool

hasDropTrafficIfUnhealthy

clearDropTrafficIfUnhealthy

setDropTrafficIfUnhealthy

If set to true, connections to the load balancer are dropped when all primary and all backup backend VMs are unhealthy.If set to false, connections are distributed among all primary VMs when all primary and all backup backend VMs are unhealthy. For load balancers that have configurable failover: Internal passthrough Network Load Balancers and external passthrough Network Load Balancers. The default is false.

Parameter
Name Description
var bool
Returns
Type Description
$this

getFailoverRatio

The value of the field must be in the range [0, 1]. If the value is 0, the load balancer performs a failover when the number of healthy primary VMs equals zero. For all other values, the load balancer performs a failover when the total number of healthy primary VMs is less than this ratio. For load balancers that have configurable failover: Internal TCP/UDP Load Balancing and external TCP/UDP Load Balancing.

Returns
Type Description
float

hasFailoverRatio

clearFailoverRatio

setFailoverRatio

The value of the field must be in the range [0, 1]. If the value is 0, the load balancer performs a failover when the number of healthy primary VMs equals zero. For all other values, the load balancer performs a failover when the total number of healthy primary VMs is less than this ratio. For load balancers that have configurable failover: Internal TCP/UDP Load Balancing and external TCP/UDP Load Balancing.

Parameter
Name Description
var float
Returns
Type Description
$this