gcloud-help/gcloud/alpha/compute/backend-services/remove-backend

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
          : --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
    (ALPHA) gcloud alpha 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
              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.

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.

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
    This command is currently in alpha and might change without notice. If this
    command fails with API permission errors despite specifying the correct
    project, you might be trying to access an API with an invitation-only early
    access allowlist. These variants are also available:

        $ gcloud compute backend-services remove-backend

        $ gcloud beta compute backend-services remove-backend