gcloud: Wed Oct 30 10:13:17 UTC 2024

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

@@ -6,8 +6,8 @@ SYNOPSIS
     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]) [--async]
+        (--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,...]]
@@ -140,6 +140,9 @@ REQUIRED FLAGS
 
             Must also specify --node-count.
 
+         --workload-type=WORKLOAD_TYPE
+            Specifies the workload type for the multi-node TPUs.
+
 OPTIONAL FLAGS
      --async
         Return immediately, without waiting for the operation in progress to

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

@@ -28,6 +28,9 @@ COMMANDS
      list
         (ALPHA) List Queued Resources.
 
+     perform-maintenance
+        (ALPHA) Performs maintenance on a Cloud TPU Queued Resource.
+
      reset
         (ALPHA) Reset a Queued Resource.
 

gcloud/alpha/compute/tpus/queued-resources/perform-maintenance

@@ -0,0 +1,82 @@
+NAME
+    gcloud alpha compute tpus queued-resources perform-maintenance - performs
+        maintenance on a Cloud TPU Queued Resource
+
+SYNOPSIS
+    gcloud alpha compute tpus queued-resources perform-maintenance
+        (QUEUED_RESOURCE : --zone=ZONE) [--async]
+        [--node-names=[NODE_NAMES,...]] [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    (ALPHA) Performs maintenance on the list of nodes provided within the Cloud
+    TPU Queued Resource..
+
+EXAMPLES
+    The following example command performs maintenance on a Cloud TPU Cloud TPU
+    Queued Resource "my-resource" in zone "us-central1-b" of the default
+    project, targeting nodes "node-a" and "node-b".
+
+        $ gcloud alpha compute tpus queued-resources perform-maintenance \
+            my-resource --zone=us-central1-b --nodeames=node-a,node-b
+
+POSITIONAL ARGUMENTS
+     Queued resource resource - The Queued Resource you want to perform
+     maintenance on. 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 queued_resource 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.
+
+       QUEUED_RESOURCE
+          ID of the queued_resource or fully qualified identifier for the
+          queued_resource.
+
+          To set the queued_resource attribute:
+          ▸ provide the argument queued_resource on the command line.
+
+          This positional argument must be specified if any of the other
+          arguments in this group are specified.
+
+       --zone=ZONE
+          The compute/zone of the Cloud TPU.
+
+          If not specified, will use default compute/zone.
+
+          To set the zone attribute:
+          ▸ provide the argument queued_resource on the command line with a
+            fully specified name;
+          ▸ provide the argument --zone on the command line;
+          ▸ set the property compute/zone.
+
+FLAGS
+     --async
+        Return immediately, without waiting for the operation in progress to
+        complete.
+
+     --node-names=[NODE_NAMES,...]
+        The nodes you want to perform maintenance on.
+
+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.
+

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

@@ -49,6 +49,9 @@ COMMANDS
      list
         (ALPHA) List Cloud TPU VM nodes.
 
+     perform-maintenance
+        (ALPHA) perform maintenance on a Cloud TPU VM.
+
      scp
         (ALPHA) Copy files to and from a Cloud TPU VM via SCP.
 

gcloud/alpha/compute/tpus/tpu-vm/perform-maintenance

@@ -0,0 +1,75 @@
+NAME
+    gcloud alpha compute tpus tpu-vm perform-maintenance - perform maintenance
+        on a Cloud TPU VM
+
+SYNOPSIS
+    gcloud alpha compute tpus tpu-vm perform-maintenance (TPU : --zone=ZONE)
+        [--async] [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    (ALPHA) perform maintenance on a Cloud TPU VM.
+
+EXAMPLES
+    The following example command performs maintenance on a Cloud TPU named
+    "my-tpu" in the zone "us-central1-b" of the default project.
+
+        $ gcloud alpha compute tpus tpu-vm perform-maintenance my-tpu \
+            --zone=us-central1-b
+
+POSITIONAL ARGUMENTS
+     Tpu resource - The Cloud TPU on which to perform maintenance. 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 compute/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
+     --async
+        Return immediately, without waiting for the operation in progress to
+        complete.
+
+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.
+