- NAME
-
- gcloud beta compute backend-services remove-backend - remove a backend from a backend service
- SYNOPSIS
-
-
gcloud beta compute backend-services remove-backendBACKEND_SERVICE_NAME(--service=SERVICE| [--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 …]
-
- DESCRIPTION
-
(BETA)gcloud beta compute backend-services remove-backendis 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'.
- POSITIONAL ARGUMENTS
-
-
BACKEND_SERVICE_NAME - Name of the backend service to operate on.
-
- REQUIRED FLAGS
-
- Exactly one of these must be specified:
- Service Group
-
--service=SERVICE - The name or URI of a Google Cloud service to use as a backend.
- 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
property:compute/regiongcloud config set compute/region REGIONA list of regions can be fetched by running:
gcloud compute regions listTo unset the property, run:
gcloud config unset compute/regionAlternatively, 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
property isn't set, you might be prompted to select a zone (interactive mode only).compute/zoneTo avoid prompting when this flag is omitted, you can set the
property:compute/zonegcloud config set compute/zone ZONEA list of zones can be fetched by running:
gcloud compute zones listTo unset the property, run:
gcloud config unset compute/zoneAlternatively, 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
property:compute/regiongcloud config set compute/region REGIONA list of regions can be fetched by running:
gcloud compute regions listTo unset the property, run:
gcloud config unset compute/regionAlternatively, 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
property isn't set, you might be prompted to select a zone (interactive mode only).compute/zoneTo avoid prompting when this flag is omitted, you can set the
property:compute/zonegcloud config set compute/zone ZONEA list of zones can be fetched by running:
gcloud compute zones listTo unset the property, run:
gcloud config unset compute/zoneAlternatively, the zone can be stored in the environment variable
.CLOUDSDK_COMPUTE_ZONE
-
- Exactly one of these must be specified:
- OPTIONAL FLAGS
-
- 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/regionproperty value for this command invocation.
-
- At most one of these can be specified:
- 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 helpfor details. - NOTES
- This command is currently in beta and might change without notice. These
variants are also available:
gcloud compute backend-services remove-backendgcloud alpha compute backend-services remove-backendgcloud preview compute backend-services remove-backend
gcloud beta compute backend-services remove-backend
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-05-27 UTC.

