gcloud: Wed Dec 11 10:18:23 UTC 2024

gcloud/alpha/compute/reservations/blocks/describe

@@ -1,13 +1,13 @@
 NAME
     gcloud alpha compute reservations blocks describe - describe a Compute
-        Engine image
+        Engine reservation block
 
 SYNOPSIS
     gcloud alpha compute reservations blocks describe RESERVATION
         --block-name=BLOCK_NAME [--zone=ZONE] [GCLOUD_WIDE_FLAG ...]
 
 DESCRIPTION
-    (ALPHA) Describe a Compute Engine image.
+    (ALPHA) Describe a Compute Engine reservation block.
 
 EXAMPLES
     To describe a reservation block in reservation exr1 in my-zone with block
@@ -58,5 +58,7 @@ 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.
+    access allowlist. This variant is also available:
+
+        $ gcloud beta compute reservations blocks describe
 

gcloud/alpha/compute/reservations/blocks/help

@@ -16,14 +16,19 @@ COMMANDS
     COMMAND is one of the following:
 
      describe
-        (ALPHA) Describe a Compute Engine image.
+        (ALPHA) Describe a Compute Engine reservation block.
 
      list
         (ALPHA) List Compute Engine reservation blocks.
 
+     perform-maintenance
+        (ALPHA) Perform maintenance on a reservation block.
+
 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.
+    access allowlist. This variant is also available:
+
+        $ gcloud beta compute reservations blocks
 

gcloud/alpha/compute/reservations/blocks/list

@@ -94,5 +94,7 @@ 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.
+    access allowlist. This variant is also available:
+
+        $ gcloud beta compute reservations blocks list
 

gcloud/alpha/compute/reservations/blocks/perform-maintenance

@@ -0,0 +1,77 @@
+NAME
+    gcloud alpha compute reservations blocks perform-maintenance - perform
+        maintenance on a reservation block
+
+SYNOPSIS
+    gcloud alpha compute reservations blocks perform-maintenance RESERVATION
+        --block-name=BLOCK_NAME [--scope=SCOPE] [--zone=ZONE]
+        [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    (ALPHA) Perform maintenance on a reservation block.
+
+EXAMPLES
+    To perform maintenance on a reservation block in reservation exr1 in
+    my-zone with block name block1 with scope all, run:
+
+        $ gcloud alpha compute reservations blocks perform-maintenance \
+            exr1 --zone=my-zone --block-name=block1 --scope=all
+
+POSITIONAL ARGUMENTS
+     RESERVATION
+        Name of the reservation to perform-maintenance.
+
+REQUIRED FLAGS
+     --block-name=BLOCK_NAME
+        The name of the reservation block.
+
+OPTIONAL FLAGS
+     --scope=SCOPE
+        The maintenance scope to set for the reservation block. SCOPE must be
+        one of:
+
+         all
+            Maintenance should be performed on all hosts in the reservation
+            block.
+         running
+            Maintenance should be performed only on the hosts in the
+            reservation block which have running VMs.
+         unused
+            Maintenance should be performed only on the hosts in the
+            reservation block which have no running VMs.
+
+     --zone=ZONE
+        Zone of the reservation to perform-maintenance. If not specified and
+        the compute/zone property isn't set, you might be prompted to select a
+        zone (interactive mode only).
+
+        To avoid prompting when this flag is omitted, you can set the
+        compute/zone property:
+
+            $ gcloud config set compute/zone ZONE
+
+        A list of zones can be fetched by running:
+
+            $ gcloud compute zones list
+
+        To unset the property, run:
+
+            $ gcloud config unset compute/zone
+
+        Alternatively, the zone can be stored in the environment variable
+        CLOUDSDK_COMPUTE_ZONE.
+
+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.
+