For load balancers that have configurable failover: Internal
passthrough Network Load
Balancers <https://cloud.google.com/load-balancing/docs/internal/failover-overview>
and external passthrough Network Load
Balancers <https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview>.
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).
bool
This can be set to true only if the protocol
is TCP. The default is false.
This field is a member of oneof_ _disable_connection_drain_on_failover.
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
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
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-11 UTC."],[],[],null,["# Class BackendServiceFailoverPolicy (1.35.0)\n\nVersion latestkeyboard_arrow_down\n\n- [1.35.0 (latest)](/python/docs/reference/compute/latest/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [1.34.0](/python/docs/reference/compute/1.34.0/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [1.33.0](/python/docs/reference/compute/1.33.0/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [1.32.0](/python/docs/reference/compute/1.32.0/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [1.31.0](/python/docs/reference/compute/1.31.0/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [1.30.0](/python/docs/reference/compute/1.30.0/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [1.29.0](/python/docs/reference/compute/1.29.0/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [1.28.0](/python/docs/reference/compute/1.28.0/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [1.27.0](/python/docs/reference/compute/1.27.0/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [1.26.0](/python/docs/reference/compute/1.26.0/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [1.25.0](/python/docs/reference/compute/1.25.0/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [1.24.0](/python/docs/reference/compute/1.24.0/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [1.23.0](/python/docs/reference/compute/1.23.0/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [1.22.0](/python/docs/reference/compute/1.22.0/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [1.21.0](/python/docs/reference/compute/1.21.0/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [1.20.1](/python/docs/reference/compute/1.20.1/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [1.19.2](/python/docs/reference/compute/1.19.2/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [1.18.0](/python/docs/reference/compute/1.18.0/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [1.17.0](/python/docs/reference/compute/1.17.0/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [1.16.1](/python/docs/reference/compute/1.16.1/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [1.15.0](/python/docs/reference/compute/1.15.0/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [1.14.1](/python/docs/reference/compute/1.14.1/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [1.13.0](/python/docs/reference/compute/1.13.0/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [1.12.1](/python/docs/reference/compute/1.12.1/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [1.11.0](/python/docs/reference/compute/1.11.0/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [1.10.1](/python/docs/reference/compute/1.10.1/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [1.9.0](/python/docs/reference/compute/1.9.0/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [1.8.0](/python/docs/reference/compute/1.8.0/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [1.7.0](/python/docs/reference/compute/1.7.0/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [1.6.1](/python/docs/reference/compute/1.6.1/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [1.5.2](/python/docs/reference/compute/1.5.2/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [1.4.0](/python/docs/reference/compute/1.4.0/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [1.3.2](/python/docs/reference/compute/1.3.2/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [1.2.0](/python/docs/reference/compute/1.2.0/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [1.1.0](/python/docs/reference/compute/1.1.0/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [1.0.0](/python/docs/reference/compute/1.0.0/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [0.9.0](/python/docs/reference/compute/0.9.0/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [0.8.0](/python/docs/reference/compute/0.8.0/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [0.7.0](/python/docs/reference/compute/0.7.0/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [0.6.0](/python/docs/reference/compute/0.6.0/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [0.5.0](/python/docs/reference/compute/0.5.0/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [0.4.2](/python/docs/reference/compute/0.4.2/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [0.3.0](/python/docs/reference/compute/0.3.0/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [0.2.1](/python/docs/reference/compute/0.2.1/google.cloud.compute_v1.types.BackendServiceFailoverPolicy)\n- [0.1.0](/python/docs/reference/compute/0.1.0/google.cloud.compute_v1.types.BackendServiceFailoverPolicy) \n\n BackendServiceFailoverPolicy(\n mapping=None, *, ignore_unknown_fields=False, **kwargs\n )\n\nFor load balancers that have configurable failover: `Internal\npassthrough Network Load\nBalancers \u003chttps://cloud.google.com/load-balancing/docs/internal/failover-overview\u003e`**and `external passthrough Network Load\nBalancers \u003chttps://cloud.google.com/load-balancing/docs/network/networklb-failover-overview\u003e`**.\nOn failover or failback, this field indicates whether connection\ndraining will be honored. Google Cloud has a fixed connection\ndraining timeout of 10 minutes. A setting of true terminates\nexisting TCP connections to the active pool during failover and\nfailback, immediately draining traffic. A setting of false allows\nexisting TCP connections to persist, even on VMs no longer in the\nactive pool, for up to the duration of the connection draining\ntimeout (10 minutes).\n\n.. _oneof: \u003chttps://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields\u003e"]]