gcloud: Wed May 18 08:41:01 UTC 2022

gcloud/alpha/compute/tpus/queued-resources/create

@@ -5,7 +5,7 @@ NAME
 SYNOPSIS
     gcloud alpha compute tpus queued-resources create
         (QUEUED_RESOURCE : --zone=ZONE) --accelerator-type=ACCELERATOR_TYPE
-        --node-id=NODE_ID --runtime-version=RUNTIME_VERSION [--async]
+        --node-id=[NODE_ID,...] --runtime-version=RUNTIME_VERSION [--async]
         [GCLOUD_WIDE_FLAG ...]
 
 DESCRIPTION
@@ -20,6 +20,13 @@ EXAMPLES
             --runtime-version=v2-alpha --node-id=my-node-001 \
             --zone=us-central1-b --project=my-project
 
+    To create a Queued Resource with multiple nodes, run:
+
+        $ gcloud alpha compute tpus queued-resources create \
+            my-queued-resource --accelerator-type=v2-8 \
+            --runtime-version=v2-alpha --node-id=my-node-001,my-node-002 \
+            --zone=us-central1-b --project=my-project
+
 POSITIONAL ARGUMENTS
      Queued resource resource - The Queued Resource you want to create. The
      arguments in this group can be used to specify the attributes of this
@@ -55,10 +62,13 @@ REQUIRED FLAGS
      --accelerator-type=ACCELERATOR_TYPE
         Accelerator type for the TPU.
 
-     --node-id=NODE_ID
+     --node-id=[NODE_ID,...]
         The unqualified Node identifier, used to identify the TPU in the Nodes
         collection once provisioned.
 
+        To request a resource with multiple nodes, enter multiple, unique,
+        unqualified Node identifiers as a comma delimited list.
+
      --runtime-version=RUNTIME_VERSION
         Runtime version for the TPU, such as 2.3.