Compute V1 Client - Class BackendServiceFailoverPolicy (1.5.0)

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

For load balancers that have configurable failover: Internal TCP/UDP Load Balancing and external TCP/UDP Load Balancing. 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

Methods

__construct

Constructor.

Parameters
NameDescription
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 TCP/UDP Load Balancing and external TCP/UDP Load Balancing. 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.

Generated from protobuf field optional bool disable_connection_drain_on_failover = 182150753;

Returns
TypeDescription
bool

hasDisableConnectionDrainOnFailover

clearDisableConnectionDrainOnFailover

setDisableConnectionDrainOnFailover

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

Generated from protobuf field optional bool disable_connection_drain_on_failover = 182150753;

Parameter
NameDescription
var bool
Returns
TypeDescription
$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 TCP/UDP Load Balancing and external TCP/UDP Load Balancing. The default is false.

Generated from protobuf field optional bool drop_traffic_if_unhealthy = 112289428;

Returns
TypeDescription
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 TCP/UDP Load Balancing and external TCP/UDP Load Balancing. The default is false.

Generated from protobuf field optional bool drop_traffic_if_unhealthy = 112289428;

Parameter
NameDescription
var bool
Returns
TypeDescription
$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.

Generated from protobuf field optional float failover_ratio = 212667006;

Returns
TypeDescription
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.

Generated from protobuf field optional float failover_ratio = 212667006;

Parameter
NameDescription
var float
Returns
TypeDescription
$this