- NAME
-
- gcloud compute backend-services remove-backend - remove a backend from a backend service
- SYNOPSIS
-
-
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 …
]
-
- DESCRIPTION
-
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'.
- 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. 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/region
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
property isn't set, you might be prompted to select a zone (interactive mode only).compute/zone
To avoid prompting when this flag is omitted, you can set the
property:compute/zone
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
property:compute/region
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
property isn't set, you might be prompted to select a zone (interactive mode only).compute/zone
To avoid prompting when this flag is omitted, you can set the
property:compute/zone
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 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.
-
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 help
for details. - NOTES
-
These variants are also available:
gcloud alpha 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 2024-05-21 UTC.
[{
"type": "thumb-down",
"id": "hardToUnderstand",
"label":"Hard to understand"
},{
"type": "thumb-down",
"id": "incorrectInformationOrSampleCode",
"label":"Incorrect information or sample code"
},{
"type": "thumb-down",
"id": "missingTheInformationSamplesINeed",
"label":"Missing the information/samples I need"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Other"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Easy to understand"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Solved my problem"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Other"
}]
{
"last_modified": "Last updated 2024-05-21 UTC.",
"state": ""
}