gcloud_compute_target-pools_set-backup (1)
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
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.
-
-
Exactly one of these must be specified:
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 may be
prompted to select a region.
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: --account, --configuration, --flags-file, --flatten, --format, --help, --log-http, --project, --quiet, --trace-token, --user-output-enabled, --verbosity. Run $ gcloud help for details.
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
NOTES
These variants are also available:
- $ gcloud alpha compute target-pools set-backup $ gcloud beta compute target-pools set-backup