gcloud: Wed May 14 10:45:02 UTC 2025

gcloud/spanner/instance-partitions/delete

@@ -1,13 +1,15 @@
 NAME
     gcloud spanner instance-partitions delete - delete a Spanner instance
-        partition
+        partition. You can't delete the default instance partition using this
+        command
 
 SYNOPSIS
     gcloud spanner instance-partitions delete
         (INSTANCE_PARTITION : --instance=INSTANCE) [GCLOUD_WIDE_FLAG ...]
 
 DESCRIPTION
-    Delete a Spanner instance partition.
+    Delete a Spanner instance partition. You can't delete the default instance
+    partition using this command.
 
 EXAMPLES
     To delete a Spanner instance partition, run:

gcloud/spanner/instance-partitions/describe

@@ -0,0 +1,65 @@
+NAME
+    gcloud spanner instance-partitions describe - describe a Spanner instance
+        partition
+
+SYNOPSIS
+    gcloud spanner instance-partitions describe
+        (INSTANCE_PARTITION : --instance=INSTANCE) [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    Describe a Spanner instance partition.
+
+EXAMPLES
+    To describe a Spanner instance partition, run:
+
+        $ gcloud spanner instance-partitions describe \
+            my-instance-partition-id --instance=my-instance-id
+
+POSITIONAL ARGUMENTS
+     Instance partition resource - The Spanner instance partition to describe.
+     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 instance_partition 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.
+
+       INSTANCE_PARTITION
+          ID of the instance partition or fully qualified identifier for the
+          instance partition.
+
+          To set the instance partition attribute:
+          ▸ provide the argument instance_partition on the command line.
+
+          This positional argument must be specified if any of the other
+          arguments in this group are specified.
+
+       --instance=INSTANCE
+          The Cloud Spanner instance for the instance partition.
+
+          To set the instance attribute:
+          ▸ provide the argument instance_partition on the command line with
+            a fully specified name;
+          ▸ provide the argument --instance on the command line;
+          ▸ set the property spanner/instance.
+
+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
+    These variants are also available:
+
+        $ gcloud alpha spanner instance-partitions describe
+
+        $ gcloud beta spanner instance-partitions describe
+

gcloud/spanner/instance-partitions/help

@@ -19,7 +19,19 @@ COMMANDS
         Create a Spanner instance partition.
 
      delete
-        Delete a Spanner instance partition.
+        Delete a Spanner instance partition. You can't delete the default
+        instance partition using this command.
+
+     describe
+        Describe a Spanner instance partition.
+
+     list
+        List the Spanner instance partitions contained within the given
+        instance.
+
+     update
+        Update a Spanner instance partition. You can't update the default
+        instance partition using this command.
 
 NOTES
     These variants are also available:

gcloud/spanner/instance-partitions/list

@@ -0,0 +1,76 @@
+NAME
+    gcloud spanner instance-partitions list - list the Spanner instance
+        partitions contained within the given instance
+
+SYNOPSIS
+    gcloud spanner instance-partitions list [--instance=INSTANCE]
+        [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri]
+        [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    List the Spanner instance partitions contained within the given instance.
+
+EXAMPLES
+    To list all Spanner instances partitions in an instance, run:
+
+        $ gcloud spanner instance-partitions list --instance=my-instance-id
+
+FLAGS
+     Instance resource - The Cloud Spanner instance in which to list instance
+     partitions. This represents a Cloud 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 --instance on the command line with a fully
+        specified name;
+      ◆ set the property spanner/instance with a fully specified name;
+      ◆ provide the argument --project on the command line;
+      ◆ set the property core/project.
+
+       --instance=INSTANCE
+          ID of the instance or fully qualified identifier for the instance.
+
+          To set the instance attribute:
+          ▸ provide the argument --instance on the command line;
+          ▸ set the property spanner/instance.
+
+LIST COMMAND FLAGS
+     --limit=LIMIT
+        Maximum number of resources to list. The default is unlimited. This
+        flag interacts with other flags that are applied in this order:
+        --flatten, --sort-by, --filter, --limit.
+
+     --page-size=PAGE_SIZE
+        Some services group resource list output into pages. This flag
+        specifies the maximum number of resources per page. The default is
+        determined by the service if it supports paging, otherwise it is
+        unlimited (no paging). Paging may be applied before or after --filter
+        and --limit depending on the service.
+
+     --sort-by=[FIELD,...]
+        Comma-separated list of resource field key names to sort by. The
+        default order is ascending. Prefix a field with ``~'' for descending
+        order on that field. This flag interacts with other flags that are
+        applied in this order: --flatten, --sort-by, --filter, --limit.
+
+     --uri
+        Print a list of resource URIs instead of the default output, and change
+        the command output to a list of URIs. If this flag is used with
+        --format, the formatting is applied on this URI list. To display URIs
+        alongside other keys instead, use the uri() transform.
+
+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
+    These variants are also available:
+
+        $ gcloud alpha spanner instance-partitions list
+
+        $ gcloud beta spanner instance-partitions list
+

gcloud/spanner/instance-partitions/update

@@ -0,0 +1,92 @@
+NAME
+    gcloud spanner instance-partitions update - update a Spanner instance
+        partition. You can't update the default instance partition using this
+        command
+
+SYNOPSIS
+    gcloud spanner instance-partitions update
+        (INSTANCE_PARTITION : --instance=INSTANCE) [--async]
+        [--description=DESCRIPTION]
+        [--nodes=NODES | --processing-units=PROCESSING_UNITS]
+        [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    Update a Spanner instance partition. You can't update the default instance
+    partition using this command.
+
+EXAMPLES
+    To update the display name of a Spanner instance partition, run:
+
+        $ gcloud spanner instance-partitions update \
+            my-instance-partition-id --instance=my-instance-id \
+            --description=my-new-display-name
+
+    To update the node count of a Spanner instance partition, run:
+
+        $ gcloud spanner instance-partitions update \
+            my-instance-partition-id --instance=my-instance-id --nodes=1
+
+POSITIONAL ARGUMENTS
+     Instance partition resource - The Spanner instance partition to update.
+     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 instance_partition 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.
+
+       INSTANCE_PARTITION
+          ID of the instance partition or fully qualified identifier for the
+          instance partition.
+
+          To set the instance partition attribute:
+          ▸ provide the argument instance_partition on the command line.
+
+          This positional argument must be specified if any of the other
+          arguments in this group are specified.
+
+       --instance=INSTANCE
+          The Cloud Spanner instance for the instance partition.
+
+          To set the instance attribute:
+          ▸ provide the argument instance_partition on the command line with
+            a fully specified name;
+          ▸ provide the argument --instance on the command line;
+          ▸ set the property spanner/instance.
+
+FLAGS
+     --async
+        Return immediately, without waiting for the operation in progress to
+        complete.
+
+     --description=DESCRIPTION
+        Description of the instance partition.
+
+     At most one of these can be specified:
+
+       --nodes=NODES
+          Number of nodes for the instance partition.
+
+       --processing-units=PROCESSING_UNITS
+          Number of processing units for the instance partition.
+
+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
+    These variants are also available:
+
+        $ gcloud alpha spanner instance-partitions update
+
+        $ gcloud beta spanner instance-partitions update
+

gcloud/spanner/instances/move

@@ -41,7 +41,7 @@ OPTIONAL FLAGS
         KMS keys. Sets target_database_move_configs value.
 
          database-id
-            Required, Sets database-id value.
+            Required, sets database-id value.
 
          kms-key-names
             Sets kms-key-names value.

gcloud/spanner/operations/cancel

@@ -4,7 +4,8 @@ NAME
 SYNOPSIS
     gcloud spanner operations cancel OPERATION-ID
         (--instance=INSTANCE | --instance-config=INSTANCE_CONFIG)
-        [--backup=BACKUP] [--database=DATABASE] [GCLOUD_WIDE_FLAG ...]
+        [--backup=BACKUP] [--database=DATABASE]
+        [--instance-partition=INSTANCE_PARTITION] [GCLOUD_WIDE_FLAG ...]
 
 DESCRIPTION
     Cancel a Cloud Spanner operation.
@@ -25,6 +26,11 @@ EXAMPLES
         $ gcloud spanner operations cancel _auto_12345 \
             --instance=my-instance-id --backup=my-backup-id
 
+    To cancel an instance partition operation with ID auto_12345, run:
+
+        $ gcloud spanner operations cancel auto_12345 \
+            --instance=my-instance-id --instance-partition=my-partition-id
+
 POSITIONAL ARGUMENTS
      OPERATION-ID
         ID of the operation
@@ -47,6 +53,10 @@ OPTIONAL FLAGS
         For a database operation, the name of the database the operation is
         executing on.
 
+     --instance-partition=INSTANCE_PARTITION
+        For an instance partition operation, the name of the instance partition
+        the operation is executing on.
+
 GCLOUD WIDE FLAGS
     These flags are available to all commands: --access-token-file, --account,
     --billing-project, --configuration, --flags-file, --flatten, --format,

gcloud/spanner/operations/list

@@ -4,7 +4,8 @@ NAME
 SYNOPSIS
     gcloud spanner operations list
         (--instance=INSTANCE | --instance-config=INSTANCE_CONFIG)
-        [--backup=BACKUP] [--database=DATABASE] [--type=TYPE]
+        [--backup=BACKUP] [--database=DATABASE]
+        [--instance-partition=INSTANCE_PARTITION] [--type=TYPE]
         [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE]
         [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...]
 
@@ -42,6 +43,17 @@ EXAMPLES
         $ gcloud spanner operations list --instance=my-instance-id \
             --backup=my-backup-id --type=BACKUP
 
+    To list instance partition operations for an instance partition, run:
+
+        $ gcloud spanner operations list --instance=my-instance-id \
+            --instance-partition=my-partition-id --type=INSTANCE_PARTITION
+
+    To list instance partition operations for all instance partitions belonging
+    to this instance, run:
+
+        $ gcloud spanner operations list --instance=my-instance-id \
+            --type=INSTANCE_PARTITION
+
 REQUIRED FLAGS
      Exactly one of these must be specified:
 
@@ -60,6 +72,10 @@ FLAGS
         For database operations, the name of the database the operations are
         executing on.
 
+     --instance-partition=INSTANCE_PARTITION
+        For instance partition operations, the name of the instance partition
+        the operation is executing on.
+
      --type=TYPE
         (optional) List only the operations of the given type. TYPE must be one
         of:
@@ -99,6 +115,12 @@ FLAGS
          INSTANCE_CONFIG_UPDATE
             Instance configuration update operations are returned for the given
             instance configuration (--instance-config).
+         INSTANCE_PARTITION
+            If only the instance is specified (--instance), returns all
+            instance partition operations associated with instance partitions
+            in the instance. When an instance partition is specified
+            (--instance-partition), only the instance partition operations for
+            the given instance partition are returned.
 
 LIST COMMAND FLAGS
      --filter=EXPRESSION