gcloud compute backend-services remove-backend - remove a backend from a backend service
gcloud 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 : --global-network-endpoint-group | --network-endpoint-group-region=NETWORK_ENDPOINT_GROUP_REGION | --network-endpoint-group-zone=NETWORK_ENDPOINT_GROUP_ZONE]) [--global | --region=REGION] [GCLOUD_WIDE_FLAG ...]
gcloud compute backend-services remove-backend is used to remove a backend from a backend service.
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'.
- BACKEND_SERVICE_NAME
Name of the backend service to operate on.
- Exactly one of these must be specified:
- Instance Group
- --instance-group=INSTANCE_GROUP
Name of the instance group to remove from the backend service. For details on valid instance names, refer to the criteria documented under the field 'name' at: https://cloud.google.com/compute/docs/reference/rest/v1/instances
This flag argument must be specified if any of the other arguments in this group are specified.
- At most one of these can be specified:
- --instance-group-region=INSTANCE_GROUP_REGION
Region of the instance group to remove from the backend service. 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.
- --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 might be prompted to select a zone (interactive mode only).
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 argument must be specified if any of the other arguments in this group are specified.
- At most one of these can be specified:
- --global-network-endpoint-group
If set, the network endpoint group is global.
- --network-endpoint-group-region=NETWORK_ENDPOINT_GROUP_REGION
Region of the network endpoint group to remove from the backend service. 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.
- --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 might be prompted to select a zone (interactive mode only).
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.
- At most one of these can 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.
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.
These variants are also available:
$ gcloud alpha compute backend-services remove-backend
$ gcloud beta compute backend-services remove-backend