gcloud compute target-pools set-backup

NAME
gcloud compute target-pools set-backup - set a backup pool for a target pool
SYNOPSIS
gcloud compute target-pools set-backup NAME (--backup-pool=BACKUP_POOL     | --no-backup-pool) [--failover-ratio=FAILOVER_RATIO] [--region=REGION] [GCLOUD_WIDE_FLAG]
DESCRIPTION
gcloud compute target-pools set-backup is used to set a backup target pool for a primary target pool, which defines the fallback behavior of the primary pool. If the ratio of the healthy instances in the primary pool is at or below the specified --failover-ratio value, then traffic arriving at the load-balanced IP address will be directed to the backup pool.
EXAMPLES
To cause TARGET-POOL (in region us-central1) to fail over to BACKUP-POOL when more than half of the TARGET-POOL instances are unhealthy, run:
gcloud compute target-pools set-backup TARGET-POOL --backup-pool=BACKUP-POOL --failover-ratio=0.5 --region=us-central1

To remove BACKUP-POOL as a backup to TARGET-POOL, run:

gcloud compute target-pools set-backup TARGET-POOL --backup-pool='' --region=us-central1
POSITIONAL ARGUMENTS
NAME
The name of the target pool for which to set the backup pool.
REQUIRED FLAGS
Exactly one of these must be specified:
--backup-pool=BACKUP_POOL
Name of the target pool that will serve as backup.
--no-backup-pool
Unsets the backup pool. This disables failover.
OPTIONAL FLAGS
--failover-ratio=FAILOVER_RATIO
The new failover ratio value for the target pool. This must be a float in the range of [0, 1].
--region=REGION
Region of the target pool to set a backup pool for. If not specified, you might be prompted to select a region (interactive mode only).

To avoid prompting when this flag is omitted, you can set the compute/region property:

gcloud config set compute/region REGION

A list of regions can be fetched by running:

gcloud compute regions list

To unset the property, run:

gcloud config unset compute/region

Alternatively, the region can be stored in the environment variable CLOUDSDK_COMPUTE_REGION.

GCLOUD WIDE FLAGS
These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, --help, --impersonate-service-account, --log-http, --project, --quiet, --trace-token, --user-output-enabled, --verbosity.

Run $ gcloud help for details.

NOTES
These variants are also available:
gcloud alpha compute target-pools set-backup
gcloud beta compute target-pools set-backup