gcloud-help/gcloud/alpha/compute/tpus/tpu-vm/update

NAME
    gcloud alpha compute tpus tpu-vm update - update a Cloud TPU VM node

SYNOPSIS
    gcloud alpha compute tpus tpu-vm update (TPU : --zone=ZONE)
        [--add-tags=[TAGS,...]] [--async] [--update-labels=[KEY=VALUE,...]]
        [--clear-labels | --remove-labels=[KEY,...]]
        [--clear-tags | --remove-tags=[TAG,...]] [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
    (ALPHA) Update a Cloud TPU VM node.

EXAMPLES
    To modify a TPU VM node with ID my-tpu in the default user project, network
    and compute/zone (with other defaults supplied by API) by adding labels k0,
    with value value0 and label k1 with value value1 and removing labels with
    key k2, run:

        $ gcloud alpha compute tpus tpu-vm update my-tpu \
            --update-labels=k0=value0,k1=value1 --remove-labels=k2

    Labels can be used to identify the TPU VM node. To list TPU VM nodes with
    the k1:value1 label, run:

        $ gcloud alpha compute tpus tpu-vm list --filter='labels.k1=value1'

    To list only the labels when describing a resource, use --format to filter
    the result:

        $ gcloud alpha compute tpus tpu-vm describe my-tpu \
            --format="default(labels)"

POSITIONAL ARGUMENTS
     Tpu resource - Name of the Cloud TPU VM node to update. The arguments in
     this group can be used to specify the attributes of this resource. (NOTE)
     Some attributes are not given arguments in this group but can be set in
     other ways.

     To set the project attribute:
      ◆ provide the argument tpu on the command line with a fully specified
        name;
      ◆ provide the argument --project on the command line;
      ◆ set the property core/project.

     This must be specified.

       TPU
          ID of the tpu or fully qualified identifier for the tpu.

          To set the tpu attribute:
          ▸ provide the argument tpu on the command line.

          This positional argument must be specified if any of the other
          arguments in this group are specified.

       --zone=ZONE
          Zone of the Cloud TPU.

          If not specified, will use default compute/zone.

          To set the zone attribute:
          ▸ provide the argument tpu on the command line with a fully
            specified name;
          ▸ provide the argument --zone on the command line;
          ▸ set the property compute/zone.

FLAGS
     --add-tags=[TAGS,...]
        Tags to add to the TPU Node. Tags are used to identify valid sources or
        targets for network firewalls. See
        https://cloud.google.com/vpc/docs/add-remove-network-tags for more
        details.

     --async
        Return immediately, without waiting for the operation in progress to
        complete.

     --update-labels=[KEY=VALUE,...]
        Resource labels to update that represent user-provided metadata. If a
        label exists, its value is modified. Otherwise, a new label is created.
        See https://cloud.google.com/compute/docs/labeling-resources for
        details.

     At most one of these can be specified:

       --clear-labels
          Remove all labels. If --update-labels is also specified then
          --clear-labels is applied first.

          For example, to remove all labels:

              $ gcloud alpha compute tpus tpu-vm update --clear-labels

          To remove all existing labels and create two new labels, 'foo' and
          'baz':

              $ gcloud alpha compute tpus tpu-vm update --clear-labels \
                  --update-labels foo=bar,baz=qux

       --remove-labels=[KEY,...]
          List of label keys to remove. If a label does not exist it is
          silently ignored. If --update-labels is also specified then
          --update-labels is applied first.

     At most one of these can be specified:

       --clear-tags
          Remove all tags. If --add-tags is also specified then --clear-tags is
          applied first.

          For example, to remove all tags:

              $ gcloud alpha compute tpus tpu-vm update --clear-tags

          To remove all existing tags and create two new tags, 'foo' and 'bar':

              $ gcloud alpha compute tpus tpu-vm update --clear-tags \
                  --add-tags foo,bar

       --remove-tags=[TAG,...]
          List of tags to remove. If a tag does not exist it is silently
          ignored. If --add-tags is also specified then --add-tags is applied
          first.

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.

API REFERENCE
    This command uses the tpu/v2alpha1 API. The full documentation for this API
    can be found at: https://cloud.google.com/tpu/

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.