mirror of
https://github.com/imjasonh/gcloud-help
synced 2026-07-11 15:39:42 +00:00
96 lines
3.3 KiB
Text
96 lines
3.3 KiB
Text
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.
|
|
|