gcloud: Wed Mar 12 10:54:38 UTC 2025

2026-07-18 23:08:48 +00:00 · 2025-03-12 10:54:38 +00:00 · 2025-03-12 10:54:38 +00:00 · a459a88a5f
commit a459a88a5f
parent 6dc93282df
152 changed files with 2634 additions and 1748 deletions
--- a/gcloud/beta/compute/snapshots/add-labels
+++ b/gcloud/beta/compute/snapshots/add-labels
@ -4,7 +4,8 @@ NAME

 SYNOPSIS
    gcloud beta compute snapshots add-labels SNAPSHOT_NAME
-        --labels=[KEY=VALUE,...] [GCLOUD_WIDE_FLAG ...]
+        --labels=[KEY=VALUE,...] [--global | --region=REGION]
+        [GCLOUD_WIDE_FLAG ...]

 DESCRIPTION
    (BETA) gcloud beta compute snapshots add-labels adds labels to a Google
@ -34,6 +35,16 @@ REQUIRED FLAGS
     --labels=[KEY=VALUE,...]
        A list of labels to add.

+OPTIONAL FLAGS
+     At most one of these can be specified:
+
+       --global
+          If set, the snapshot is global.
+
+       --region=REGION
+          Region of the snapshot to operate on. Overrides the default
+          compute/region property value for this command invocation.
+
 GCLOUD WIDE FLAGS
    These flags are available to all commands: --access-token-file, --account,
    --billing-project, --configuration, --flags-file, --flatten, --format,
--- a/gcloud/beta/compute/snapshots/create
+++ b/gcloud/beta/compute/snapshots/create
@ -11,6 +11,9 @@ SYNOPSIS
        [--source-disk-key-file=FILE]
        [--source-instant-snapshot=SOURCE_INSTANT_SNAPSHOT]
        [--source-instant-snapshot-key-file=FILE] [--storage-location=LOCATION]
+        [--global | --region=REGION]
+        [--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING
+          --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT]
        [--source-disk-region=SOURCE_DISK_REGION
          | --source-disk-zone=SOURCE_DISK_ZONE]
        [--source-instant-snapshot-region=SOURCE_INSTANT_SNAPSHOT_REGION
@ -118,6 +121,57 @@ FLAGS
        snapshot content is to be stored. If absent, a nearby regional or
        multi-regional location is chosen automatically.

+     Scope for snapshot.
+
+     At most one of these can be specified:
+
+       --global
+          If set, the snapshot will be created in the global scope
+
+       --region=REGION
+          If set, the snapshot will be created in the regional scope
+
+     Key resource - The Cloud KMS (Key Management Service) cryptokey that will
+     be used to protect the snapshot. The 'Compute Engine Service Agent'
+     service account must hold permission 'Cloud KMS CryptoKey
+     Encrypter/Decrypter'. The arguments in this group can be used to specify
+     the attributes of this resource.
+
+       --kms-key=KMS_KEY
+          ID of the key or fully qualified identifier for the key.
+
+          To set the kms-key attribute:
+          ▸ provide the argument --kms-key on the command line.
+
+          This flag argument must be specified if any of the other arguments in
+          this group are specified.
+
+       --kms-keyring=KMS_KEYRING
+          The KMS keyring of the key.
+
+          To set the kms-keyring attribute:
+          ▸ provide the argument --kms-key on the command line with a fully
+            specified name;
+          ▸ provide the argument --kms-keyring on the command line.
+
+       --kms-location=KMS_LOCATION
+          The Google Cloud location for the key.
+
+          To set the kms-location attribute:
+          ▸ provide the argument --kms-key on the command line with a fully
+            specified name;
+          ▸ provide the argument --kms-location on the command line;
+          ▸ provide the argument --region on the command line.
+
+       --kms-project=KMS_PROJECT
+          The Google Cloud project for the key.
+
+          To set the kms-project attribute:
+          ▸ provide the argument --kms-key on the command line with a fully
+            specified name;
+          ▸ provide the argument --kms-project on the command line;
+          ▸ set the property core/project.
+
     At most one of these can be specified:

       --source-disk-region=SOURCE_DISK_REGION
--- a/gcloud/beta/compute/snapshots/delete
+++ b/gcloud/beta/compute/snapshots/delete
@ -3,11 +3,10 @@ NAME

 SYNOPSIS
    gcloud beta compute snapshots delete SNAPSHOT_NAME [SNAPSHOT_NAME ...]
-        [GCLOUD_WIDE_FLAG ...]
+        [--global | --region=REGION] [GCLOUD_WIDE_FLAG ...]

 DESCRIPTION
-    (BETA) gcloud beta compute snapshots delete deletes one or more Compute
-    Engine snapshots.
+    (BETA) Delete Compute Engine snapshots.

 EXAMPLES
    To delete Compute Engine snapshots with the names 'snapshot-1' and
@ -28,6 +27,16 @@ POSITIONAL ARGUMENTS
     SNAPSHOT_NAME [SNAPSHOT_NAME ...]
        Names of the snapshots to delete.

+FLAGS
+     At most one of these can be specified:
+
+       --global
+          If set, the snapshots are global.
+
+       --region=REGION
+          Region of the snapshots to delete. Overrides the default
+          compute/region property value for this command invocation.
+
 GCLOUD WIDE FLAGS
    These flags are available to all commands: --access-token-file, --account,
    --billing-project, --configuration, --flags-file, --flatten, --format,
--- a/gcloud/beta/compute/snapshots/describe
+++ b/gcloud/beta/compute/snapshots/describe
@ -2,7 +2,8 @@ NAME
    gcloud beta compute snapshots describe - describe a Compute Engine snapshot

 SYNOPSIS
-    gcloud beta compute snapshots describe SNAPSHOT_NAME [GCLOUD_WIDE_FLAG ...]
+    gcloud beta compute snapshots describe SNAPSHOT_NAME
+        [--global | --region=REGION] [GCLOUD_WIDE_FLAG ...]

 DESCRIPTION
    (BETA) gcloud beta compute snapshots describe displays all data associated
@ -40,6 +41,16 @@ POSITIONAL ARGUMENTS
     SNAPSHOT_NAME
        Name of the snapshot to describe.

+FLAGS
+     At most one of these can be specified:
+
+       --global
+          If set, the snapshot is global.
+
+       --region=REGION
+          Region of the snapshot to describe. Overrides the default
+          compute/region property value for this command invocation.
+
 GCLOUD WIDE FLAGS
    These flags are available to all commands: --access-token-file, --account,
    --billing-project, --configuration, --flags-file, --flatten, --format,
--- a/gcloud/beta/compute/snapshots/list
+++ b/gcloud/beta/compute/snapshots/list
@ -3,8 +3,9 @@ NAME

 SYNOPSIS
    gcloud beta compute snapshots list [NAME ...] [--regexp=REGEXP, -r REGEXP]
-        [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE]
-        [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...]
+        [--global | --regions=[REGION,...]] [--filter=EXPRESSION]
+        [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri]
+        [GCLOUD_WIDE_FLAG ...]

 DESCRIPTION
    (BETA) gcloud beta compute snapshots list displays all Google Compute
@ -35,6 +36,15 @@ FLAGS

        Flag --regexp is deprecated. Use --filter="name~'REGEXP'" instead.

+     At most one of these can be specified:
+
+       --global
+          If provided, only global resources are shown.
+
+       --regions=[REGION,...]
+          If provided, only regional resources are shown. If arguments are
+          provided, only resources from the given regions are shown.
+
 LIST COMMAND FLAGS
     --filter=EXPRESSION
        Apply a Boolean filter EXPRESSION to each resource item to be listed.
--- a/gcloud/beta/compute/snapshots/remove-labels
+++ b/gcloud/beta/compute/snapshots/remove-labels
@ -4,7 +4,8 @@ NAME

 SYNOPSIS
    gcloud beta compute snapshots remove-labels SNAPSHOT_NAME
-        (--all | --labels=KEY,[KEY,...]) [GCLOUD_WIDE_FLAG ...]
+        (--all | --labels=KEY,[KEY,...]) [--global | --region=REGION]
+        [GCLOUD_WIDE_FLAG ...]

 DESCRIPTION
    (BETA) gcloud beta compute snapshots remove-labels removes labels from a
@ -39,6 +40,16 @@ REQUIRED FLAGS
       --labels=KEY,[KEY,...]
          A comma-separated list of label keys to remove from the resource.

+OPTIONAL FLAGS
+     At most one of these can be specified:
+
+       --global
+          If set, the snapshot is global.
+
+       --region=REGION
+          Region of the snapshot to operate on. Overrides the default
+          compute/region property value for this command invocation.
+
 GCLOUD WIDE FLAGS
    These flags are available to all commands: --access-token-file, --account,
    --billing-project, --configuration, --flags-file, --flatten, --format,
--- a/gcloud/beta/compute/snapshots/update
+++ b/gcloud/beta/compute/snapshots/update
@ -4,11 +4,11 @@ NAME
 SYNOPSIS
    gcloud beta compute snapshots update SNAPSHOT_NAME
        [--update-labels=[KEY=VALUE,...]]
-        [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...]
+        [--clear-labels | --remove-labels=[KEY,...]]
+        [--global | --region=REGION] [GCLOUD_WIDE_FLAG ...]

 DESCRIPTION
-    (BETA) gcloud beta compute snapshots update updates labels for a Compute
-    Engine snapshot.
+    (BETA) Update a Compute Engine snapshot.

 EXAMPLES
    To update labels k0 and k1 and remove labels with key k3, run:
@ -61,6 +61,15 @@ FLAGS
          silently ignored. If --update-labels is also specified then
          --update-labels is applied first.

+     At most one of these can be specified:
+
+       --global
+          If set, the snapshot is global.
+
+       --region=REGION
+          Region of the snapshot to update. Overrides the default
+          compute/region property value for this command invocation.
+
 GCLOUD WIDE FLAGS
    These flags are available to all commands: --access-token-file, --account,
    --billing-project, --configuration, --flags-file, --flatten, --format,