gcloud alpha compute backend-services remove-backend - remove a backend from a backend service

gcloud alpha compute backend-services remove-backendBACKEND_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 …]

Before removing a backend, it is a good idea to "drain" the backend first. Abackend can be drained by setting its capacity scaler to zero through 'gcloudcompute 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 onvalid 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 groupare 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 notspecified, you might be prompted to select a region (interactive mode only).

To avoid prompting when this flag is omitted, you can set thecompute/region property:

gcloudconfigsetcompute/regionREGION

A list of regions can be fetched by running:

gcloudcomputeregionslist

To unset the property, run:

gcloudconfigunsetcompute/region

Alternatively, the region can be stored in the environment variableCLOUDSDK_COMPUTE_REGION.

--instance-group-zone=INSTANCE_GROUP_ZONE

Zone of the instance group to remove from the backend service. If not specifiedand thecompute/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 thecompute/zone property:

gcloudconfigsetcompute/zoneZONE

A list of zones can be fetched by running:

gcloudcomputezoneslist

To unset the property, run:

gcloudconfigunsetcompute/zone

Alternatively, the zone can be stored in the environment variableCLOUDSDK_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 groupare 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 notspecified, you might be prompted to select a region (interactive mode only).

To avoid prompting when this flag is omitted, you can set thecompute/region property:

gcloudconfigsetcompute/regionREGION

A list of regions can be fetched by running:

gcloudcomputeregionslist

To unset the property, run:

gcloudconfigunsetcompute/region

Alternatively, the region can be stored in the environment variableCLOUDSDK_COMPUTE_REGION.

--network-endpoint-group-zone=NETWORK_ENDPOINT_GROUP_ZONE

Zone of the network endpoint group to remove from the backend service. If notspecified and thecompute/zone propertyisn't set, you might be prompted to select a zone (interactive mode only).

To avoid prompting when this flag is omitted, you can set thecompute/zone property:

gcloudconfigsetcompute/zoneZONE

A list of zones can be fetched by running:

gcloudcomputezoneslist

To unset the property, run:

gcloudconfigunsetcompute/zone

Alternatively, the zone can be stored in the environment variableCLOUDSDK_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 defaultcompute/region property value for this command invocation.

Run$gcloud help for details.