gcloud_beta_compute_backend-services_remove-backend (1)
NAME
- gcloud beta compute backend-services remove-backend - remove a backend from a backend service
SYNOPSIS
-
gcloud beta compute backend-services remove-backend BACKEND_SERVICE_NAME ([--instance-group=INSTANCE_GROUP : --instance-group-region=INSTANCE_GROUP_REGION | --instance-group-zone=INSTANCE_GROUP_ZONE] | [--network-endpoint-group=NETWORK_ENDPOINT_GROUP : --network-endpoint-group-zone=NETWORK_ENDPOINT_GROUP_ZONE]) [--global | --region=REGION] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(BETA) gcloud beta compute backend-services remove-backend is used
Before removing a backend, it is a good idea to "drain" the backend first. A backend can be drained by setting its capacity scaler to zero through 'gcloud compute backend-services edit'.
POSITIONAL ARGUMENTS
-
- BACKEND_SERVICE_NAME
-
Name of the backend service to operate on.
REQUIRED FLAGS
-
-
Exactly one of these must be specified:
-
-
Instance Group
-
- --instance-group=INSTANCE_GROUP
-
Name of the instance group to remove from the backend service. This flag must be
specified if any of the other arguments in this group are specified.
-
At most one of these may be specified:
-
- --instance-group-region=INSTANCE_GROUP_REGION
-
Region of the instance group to remove from the backend service. 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.
- --instance-group-zone=INSTANCE_GROUP_ZONE
-
Zone of the instance group to remove from the backend service. If not specified
and the compute/zone property isn't set, you may be prompted to
select a zone.
To avoid prompting when this flag is omitted, you can set the compute/zone property:
- $ gcloud config set compute/zone ZONE
A list of zones can be fetched by running:
- $ gcloud compute zones list
To unset the property, run:
- $ gcloud config unset compute/zone
Alternatively, the zone can be stored in the environment variable CLOUDSDK_COMPUTE_ZONE.
-
-
-
Network Endpoint Group
-
- --network-endpoint-group=NETWORK_ENDPOINT_GROUP
-
Name of the network endpoint group to remove from the backend service. This flag
must be specified if any of the other arguments in this group are specified.
- --network-endpoint-group-zone=NETWORK_ENDPOINT_GROUP_ZONE
-
Zone of the network endpoint group to remove from the backend service. If not
specified and the compute/zone property isn't set, you may be
prompted to select a zone.
To avoid prompting when this flag is omitted, you can set the compute/zone property:
- $ gcloud config set compute/zone ZONE
A list of zones can be fetched by running:
- $ gcloud compute zones list
To unset the property, run:
- $ gcloud config unset compute/zone
Alternatively, the zone can be stored in the environment variable CLOUDSDK_COMPUTE_ZONE.
-
-
Instance Group
-
-
Exactly one of these must be specified:
OPTIONAL FLAGS
-
-
At most one of these may be specified:
-
- --global
-
If set, the backend service is global.
- --region=REGION
-
Region of the backend service to operate on. Overrides the default
compute/region property value for this command invocation.
-
-
At most one of these may be specified:
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.
NOTES
This command is currently in BETA and may change without notice. These variants are also available:
- $ gcloud compute backend-services remove-backend $ gcloud alpha compute backend-services remove-backend