gcloud alpha compute tpus queued-resources create - create a Queued Resource

gcloud alpha compute tpus queued-resources create(QUEUED_RESOURCE :--zone=ZONE)--runtime-version=RUNTIME_VERSION(--accelerator-type=ACCELERATOR_TYPE    |--topology=TOPOLOGY--type=TYPE)(--node-id=NODE_ID    | [--node-count=NODE_COUNT :--node-prefix=NODE_PREFIX--workload-type=WORKLOAD_TYPE])[--async][--autocheckpoint-enabled][--best-effort][--boot-disk=[KEY=VALUE,…]][--data-disk=[mode=MODE],[source=SOURCE]][--description=DESCRIPTION][--guaranteed][--labels=[KEY=VALUE,…]][--max-run-duration=MAX_RUN_DURATION][--metadata=[KEY=VALUE,…]][--metadata-from-file=[KEY=VALUE,…]][--provisioning-model=PROVISIONING_MODEL][--range=RANGE][--reserved][--scopes=[SCOPES,…]][--service-account=SERVICE_ACCOUNT][--shielded-secure-boot][--spot][--tags=[TAGS,…]][--valid-after-duration=VALID_AFTER_DURATION][--valid-after-time=VALID_AFTER_TIME][--valid-until-duration=VALID_UNTIL_DURATION][--valid-until-time=VALID_UNTIL_TIME][--network-config=[external-ips=EXTERNAL-IPS],[network=NETWORK],[subnetwork=SUBNETWORK]    |--internal-ips--network=NETWORK; default="default"--subnetwork=SUBNETWORK][--reservation=RESERVATION    |--reservation-host-folder=RESERVATION_HOST_FOLDER--reservation-host-organization=RESERVATION_HOST_ORGANIZATION--reservation-host-project=RESERVATION_HOST_PROJECT][GCLOUD_WIDE_FLAG …]

gcloudalphacomputetpusqueued-resourcescreatemy-queued-resource--accelerator-type=v4-8--runtime-version=v2-alpha-tpuv4--node-id=my-node-001--zone=us-central2-b--project=my-project

To create a Queued Resource with multiple nodes, run:

gcloudalphacomputetpusqueued-resourcescreatemy-queued-resource--accelerator-type=v4-8--runtime-version=v2-alpha-tpuv4--node-count=2--zone=us-central2-b--project=my-project

Queued resource resource - The Queued Resource you want to create. The argumentsin 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 otherways.

To set theproject attribute:

• provide the argumentqueued_resource on the command line with afully specified name;
• provide the argument--project on the command line;
• set the propertycore/project.

This must be specified.

QUEUED_RESOURCE

ID of the queued_resource or fully qualified identifier for the queued_resource.

To set thequeued_resource attribute:

• provide the argumentqueued_resource on the command line.

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

--zone=ZONE

The compute/zone of the Cloud TPU.

If not specified, will usedefault compute/zone.To set thezone attribute:

• provide the argumentqueued_resource on the command line with afully specified name;
• provide the argument--zone on the command line;
• set the propertycompute/zone.

--runtime-version=RUNTIME_VERSION

Runtime version for the TPU, such astpu-ubuntu2204-base.

Specify a chip-based or core-based TPU node.

Exactly one of these must be specified:

Core-based TPU configuration

--accelerator-type=ACCELERATOR_TYPE

Accelerator type for the TPU.

Chip-based TPU configuration

--topology=TOPOLOGY

Chip topology for TPU.

This flag argument must be specified if any of the other arguments in this groupare specified.

--type=TYPE

Type of TPU.TYPE must be one of:v2,v3,v4,v5litepod,v5p,v6e.

This flag argument must be specified if any of the other arguments in this groupare specified.

Specify TPU node(s) with either a single node id or a node count and an optionalnode prefix

Exactly one of these must be specified:

Single node creation

--node-id=NODE_ID

Unqualified node identifier used to identify the node in the project onceprovisioned.

To request a resource with multiple nodes, in place of--node-id,use--node-count to specify the number of nodes and optionally use--node-prefix to specify the prefix for each node.

Multinode creation

--node-count=NODE_COUNT

The number of nodes in a multislice provision, also used to generate thequalified name for nodes in the provision. Value must be greater than 1.

This flag argument must be specified if any of the other arguments in this groupare specified.

--node-prefix=NODE_PREFIX

Node prefix used to generate the qualified name of each node the multislice nodeprovision. If not supplied, the queued resource id will be used as the prefix.

Must also specify--node-count.

--workload-type=WORKLOAD_TYPE

Specifies the workload type for the multi-node TPUs.

--async

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

--autocheckpoint-enabled

Specifies that the TPU node(s) are created with the Autocheckpoint featureenabled.

--best-effort

If provided, the Node requested here may be scheduled at the 'best effort' tier.

--boot-disk=[KEY=VALUE,…]

Specifies the boot disk configuration.

gcloudalphacomputetpusqueued-resourcescreate--boot-diskconfidential-compute=True,kms-key=<full_kms_key_name_here>

The following keys are allowed:

confidential-compute

Create the boot disk in confidential compute mode. CMEK layer is required.

kms-key

Specifies the fully qualified Cloud KMS cryptokey name which will be used toprotect the disk. KMS cryptokey name format:projects/<kms-project>/locations/<kms-location>/keyRings/<kms-keyring>/cryptoKeys/<key-name>

--data-disk=[mode=MODE],[source=SOURCE]

Additional data disks for the TPU VM.

This flag must be repeated to provide multiple data disks. For example:

gcloudalphacomputetpusqueued-resourcescreate--data-disksource=projects/my-project/zones/us-central1-c/disks/my-disk,mode=read-only

The following keys are allowed:

source

Specifies the full path to an existing disk. Required. The disk must be in thesame zone.

mode

Specifies the mode in which to attach this disk. Valid options are 'read-write','read-only'. If not specified, the default is 'read-write'.

--description=DESCRIPTION

Text description of the TPU.

--guaranteed

If provided, the Node requested here will only be scheduled at the 'guaranteed'tier.

--labels=[KEY=VALUE,…]

Resource labels to represent user-provided metadata. Seehttps://cloud.google.com/compute/docs/labeling-resourcesfor details.

--max-run-duration=MAX_RUN_DURATION

A duration after which the resource will be terminated. Used with flex-start.See $gcloud topic datetimesfor information on duration formats.

--metadata=[KEY=VALUE,…]

List of comma-separated metadata key-value pairs for the Cloud TPU VM node.Example:--metadata='key1=value1,key2=value2'

--metadata-from-file=[KEY=VALUE,…]

Same as--metadata except the value for the entry will be read froma local file. Example:--metadata-from-file='key1=value1.txt'

--provisioning-model=PROVISIONING_MODEL

If provided, the resource will be provisioned with the specified provisioningmodel.

--range=RANGE

CIDR range for the TPU.

The IP range that the TPU will select an IP address from. Must be in CIDRnotation and a/29 range, for example192.168.0.0/29.Errors will occur if the CIDR range has already been used for a currentlyexisting TPU, the CIDR range conflicts with any networks in the user's providednetwork, or the provided network is peered with another network that is usingthat CIDR range.

--reserved

Specifies the request should be scheduled on reserved capacity.

If--reservation-host-project,--reservation-host-folder, or--reservation-host-organization are present then this flag has noeffect.

--scopes=[SCOPES,…]

List of comma-separated scopes to be made available for the service account.

--service-account=SERVICE_ACCOUNT

Email address of the service account. If empty, default Google Compute Engineservice account will be used.

--shielded-secure-boot

Specifies that the TPU instances are created with secure boot enabled. Thisimplicitly makes them Shielded VM instances.

--spot

If provided, the Node requested here will be created as Spot VMs.

--tags=[TAGS,…]

Tags to apply to the TPU Node. Tags are used to identify valid sources ortargets for network firewalls. Seehttps://cloud.google.com/vpc/docs/add-remove-network-tagsfor more details.

--valid-after-duration=VALID_AFTER_DURATION

A duration before which the TPU must not be provisioned, relative to the currenttime. See $gcloud topicdatetimes for information on duration formats.

--valid-after-time=VALID_AFTER_TIME

An absolute time before which the TPU must not be provisioned. See $gcloud topic datetimes forinformation on duration formats.

--valid-until-duration=VALID_UNTIL_DURATION

A duration after which the TPU must not be provisioned, relative to the currenttime. See $gcloud topicdatetimes for information on duration formats.

--valid-until-time=VALID_UNTIL_TIME

An absolute time after which resources must not be created. See $gcloud topic datetimes forinformation on duration formats.

At most one of these can be specified:

--network-config=[external-ips=EXTERNAL-IPS],[network=NETWORK],[subnetwork=SUBNETWORK]

Specify a full network_config for the TPU. network or subnetwork must bespecified.

This flag may be repeated to provide multiple networks. For example:

gcloudalphacomputetpusqueued-resourcescreate--network-confignetwork=example_network,internal-ips=true

The following keys are allowed:

network

Specify the network to be used by this TPU.

subnetwork

Specify the network to be used by this TPU. If not specified, this defaults tothe subnetwork by the same name as the network.

external-ips

Indicate that the IP addresses for the node should be exteranl. The default willbe only internal IP addresses.

--internal-ips

Indicates that the IP addresses for the node should be internal. The default isthat external IP addresses will be associated with the TPU workers.

--network=NETWORK; default="default"

Network that this TPU will be a part of.

--subnetwork=SUBNETWORK

Subnetwork that this TPU will be a part of.

At most one of these can be specified:

--reservation=RESERVATION

The name of the reservation. This can either be the full name or just the name.

However, a full name is required if the reservation is not in the defaultproject.

Full reservation name format is:projects/<project>/locations/<location>/reservations/<reservation-name>,projects/<project>/zones/<zone>/reservations/<reservation-name>.

--reservation-host-folder=RESERVATION_HOST_FOLDER

The folder hosting the reservation that the TPU should use. Only one reservationhost entity may be specified.

--reservation-host-organization=RESERVATION_HOST_ORGANIZATION

The organization hosting the reservation that the TPU should use. Only onereservation host entity may be specified.

--reservation-host-project=RESERVATION_HOST_PROJECT

The project hosting the reservation that the TPU should use. Only onereservation host entity may be specified.

Run$gcloud help for details.