gcloud_alpha_compute_backend-services_remove-backend (1)
NAME
- gcloud alpha compute backend-services remove-backend - remove a backend from a backend service
SYNOPSIS
-
gcloud alpha 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
(ALPHA) gcloud alpha compute backend-services remove-backend is
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 ALPHA and may change without notice. If this command fails with API permission errors despite specifying the right project, you will have to apply for early access and have your projects registered on the API whitelist to use it. To do so, contact Support at cloud.google.com/support These variants are also available:
- $ gcloud compute backend-services remove-backend $ gcloud beta compute backend-services remove-backend