gcloud alpha compute tpus tpu-vm attach-disk

NAME

gcloud alpha compute tpus tpu-vm attach-disk - attach disk to TPU VM

SYNOPSIS

gcloud alpha compute tpus tpu-vm attach-disk (TPU : --zone=ZONE) --disk=DISK [--mode=MODE; default="read-write"] [GCLOUD_WIDE_FLAG …]

DESCRIPTION

(ALPHA) gcloud alpha compute tpus tpu-vm attach-disk is used to attach a disk to a TPU VM. For example,

gcloud compute tpus tpu-vm attach-disk example-tpu --disk=example-disk --mode=read-only --zone=us-central1-a

attaches the disk named 'example-disk' to a TPU VM named 'example-tpu' in read-only mode in zone us-central1-a.

EXAMPLES

To attach a disk named 'my-disk' for read-only access to a TPU named 'my-tpu', run:

gcloud alpha compute tpus tpu-vm attach-disk my-tpu --disk=my-disk --mode=read-only

To attach a disk named 'my-read-write-disk' for read-write access to a TPU named 'my-tpu', run:

gcloud alpha compute tpus tpu-vm attach-disk my-tpu --disk=my-read-write-disk

To attach a regional disk named for read-write access to a TPU named 'my-tpu', run:

gcloud alpha compute tpus tpu-vm attach-disk my-tpu --disk=projects/tpu-test-env-one-vm/region/us-central1/disks/example-disk

POSITIONAL ARGUMENTS

TPU resource - The TPU function name to attach disk. 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

The Cloud zone for the TPU.

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.

REQUIRED FLAGS

--disk=DISK

The name of the disk to attach to the TPU VM.

OPTIONAL FLAGS

--mode=MODE; default="read-write"

Specifies the mode of the disk. MODE must be one of:

read-only

Read-only.

read-write

Read-write. It is an error to attach a disk in read-write mode to more than one TPU VM.

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.