gcloud: Wed Nov 20 10:03:22 UTC 2024

gcloud/alpha/storage/buckets/create

@@ -11,7 +11,7 @@ SYNOPSIS
         [--enable-hierarchical-namespace] [--enable-per-object-retention]
         [--ip-filter-file=IP_FILTER_FILE] [--location=LOCATION, -l LOCATION]
         [--[no-]pap, --[no-]public-access-prevention]
-        [--placement=REGION,REGION]
+        [--placement=[REGION,...]]
         [--recovery-point-objective=SETTING, --rpo=SETTING]
         [--retention-period=RETENTION_PERIOD]
         [--soft-delete-duration=SOFT_DELETE_DURATION]
@@ -95,9 +95,8 @@ FLAGS
         --public-access-prevention to enable and --no-public-access-prevention
         to disable.
 
-     --placement=REGION,REGION
-        A comma-separated list of exactly 2 regions that form the custom
-        [dual-region]
+     --placement=[REGION,...]
+        A comma-separated list of regions that form the custom [dual-region]
         (https://cloud.google.com/storage/docs/locations#location-dr). Only
         regions within the same continent are or will ever be valid. Invalid
         location pairs (such as mixed-continent, or with unsupported regions)

gcloud/alpha/storage/buckets/help

@@ -42,6 +42,9 @@ COMMANDS
      list
         (ALPHA) Lists Cloud Storage buckets.
 
+     relocate
+        (ALPHA) Relocates bucket between different locations.
+
      remove-iam-policy-binding
         (ALPHA) Remove an IAM policy binding from a bucket.
 

gcloud/alpha/storage/buckets/relocate

@@ -0,0 +1,110 @@
+NAME
+    gcloud alpha storage buckets relocate - relocates bucket between different
+        locations
+
+SYNOPSIS
+    gcloud alpha storage buckets relocate
+        ([URL --location=LOCATION : --placement=[REGION,...]
+          --dry-run] [--operation=OPERATION --finalize : --ttl=TTL])
+        [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    (ALPHA) Relocates a bucket between different locations.
+
+EXAMPLES
+    To move a bucket (gs://my-bucket) to the us-central1 location, use the
+    following command:
+
+        $ gcloud storage buckets relocate gs://my-bucket \
+          --location=us-central1
+
+    To move a bucket to a custom Dual-region, use the following command:
+
+        $ gcloud storage buckets relocate gs://my-bucket --location=us \
+          --placement=us-central1,us-east1
+
+    To validate the operation without actually moving the bucket, use the
+    following command:
+
+        $ gcloud storage buckets relocate gs://my-bucket \
+          --location=us-central1 --dry-run
+
+    To schedule a write lock for the move, with ttl for reverting the write
+    lock after 7h, if the relocation has not succeeded, use the following
+    command:
+
+        $ gcloud storage buckets relocate \
+          --operation=projects/_/buckets/my-bucket/operations/C894F35J \
+          --finalize --ttl=7h
+
+POSITIONAL ARGUMENTS
+     Exactly one of these must be specified:
+
+       Arguments for initiating the bucket relocate operation.
+
+         URL
+            The URL of the bucket to relocate.
+
+            This positional argument must be specified if any of the other
+            arguments in this group are specified.
+
+         --location=LOCATION
+            The final [location]
+            (https://cloud.google.com/storage/docs/locations) where the bucket
+            will be relocated to. If no location is provided, Cloud Storage
+            will use the default location, which is us.
+
+            This flag argument must be specified if any of the other arguments
+            in this group are specified.
+
+         --placement=[REGION,...]
+            A comma-separated list of regions that form the custom
+            [dual-region]
+            (https://cloud.google.com/storage/docs/locations#location-dr). Only
+            regions within the same continent are or will ever be valid.
+            Invalid location pairs (such as mixed-continent, or with
+            unsupported regions) will return an error.
+
+         --dry-run
+            Prints the operations that the relocate command would perform
+            without actually performing relocation. This is helpful to identify
+            any issues that need to be detected asynchronously.
+
+       Arguments for advancing the relocation operation.
+
+         --operation=OPERATION
+            Specify the relocation operation name to advance the relocation
+            operation.The relocation operation name must include the Cloud
+            Storage bucket and operation ID.
+
+            This flag argument must be specified if any of the other arguments
+            in this group are specified.
+
+         --finalize
+            Schedules the write lock to occur. Once activated, no further
+            writes will be allowed to the associated bucket. This helps
+            minimize disruption to bucket usage. For certain types of
+            moves(between Multi Region and Custom Dual Regions), finalize is
+            not required.
+
+            This flag argument must be specified if any of the other arguments
+            in this group are specified.
+
+         --ttl=TTL
+            Time to live for the relocation operation. Defaults to 12h if not
+            provided.
+
+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.
+

gcloud/alpha/storage/management-hub/enable

@@ -48,8 +48,8 @@ LOCATION FLAGS
 
        --exclude-locations=[EXCLUDE_LOCATIONS,...]
           Comma separated list of locations
-          (https://cloud.google.com/storage/docs/locations#available-locations)to
-          exclude in Management Hub filter. To clear excluded locations,
+          (https://cloud.google.com/storage/docs/locations#available-locations)
+          to exclude in Management Hub filter. To clear excluded locations,
           provide flag with empty list. e.g --exclude-locations="" or
           --exclude-locations= .
 
@@ -71,10 +71,10 @@ BUCKET_FILTER FLAGS
          --exclude-bucket-id-regexes=[EXCLUDE_BUCKET_ID_REGEXES,...]
             Sets filter for bucket id regexes to exclude. Accepts list of
             bucket id regexes in comma separated format. If the regex contains
-            special characters that may have a specific meaning in the shell
-            (like $, &, , etc.), escape them using backslashes(\). To clear
-            bucket id regexes list, provide flag with an empty list. e.g
-            --exclude-bucket-id-regexes="" or --exclude-bucket-id-regexes= .
+            special characters that may have a specific meaning in the shell,
+            escape them using backslashes(\). To clear bucket id regexes list,
+            provide flag with an empty list. e.g --exclude-bucket-id-regexes=""
+            or --exclude-bucket-id-regexes= .
 
          --exclude-bucket-ids=[EXCLUDE_BUCKET_IDS,...]
             Comma separated list of bucket ids to exclude in the management hub
@@ -89,10 +89,10 @@ BUCKET_FILTER FLAGS
          --include-bucket-id-regexes=[INCLUDE_BUCKET_ID_REGEXES,...]
             Sets filter for bucket id regexes to include. Accepts list of
             bucket id regexes in comma separated format. If the regex contains
-            special characters that may have a specific meaning in the shell
-            (like $, &, , etc.), escape them using backslashes(\). To clear
-            bucket id regexes list, provide flag with empty list. e.g
-            --include-bucket-id-regexes="" or --include-bucket-id-regexes= .
+            special characters that may have a specific meaning in the shell,
+            escape them using backslashes(\). To clear bucket id regexes list,
+            provide flag with empty list. e.g --include-bucket-id-regexes="" or
+            --include-bucket-id-regexes= .
 
          --include-bucket-ids=[INCLUDE_BUCKET_IDS,...]
             Comma separated list of bucket ids to include in the management hub

gcloud/alpha/storage/management-hub/update

@@ -82,10 +82,9 @@ REQUIRED FLAGS
               Sets filter for bucket id regexes to exclude. Accepts list of
               bucket id regexes in comma separated format. If the regex
               contains special characters that may have a specific meaning in
-              the shell (like $, &, , etc.), escape them using backslashes(\).
-              To clear bucket id regexes list, provide flag with an empty list.
-              e.g --exclude-bucket-id-regexes="" or
-              --exclude-bucket-id-regexes= .
+              the shell, escape them using backslashes(\). To clear bucket id
+              regexes list, provide flag with an empty list. e.g
+              --exclude-bucket-id-regexes="" or --exclude-bucket-id-regexes= .
 
            --exclude-bucket-ids=[EXCLUDE_BUCKET_IDS,...]
               Comma separated list of bucket ids to exclude in the management
@@ -101,10 +100,9 @@ REQUIRED FLAGS
               Sets filter for bucket id regexes to include. Accepts list of
               bucket id regexes in comma separated format. If the regex
               contains special characters that may have a specific meaning in
-              the shell (like $, &, , etc.), escape them using backslashes(\).
-              To clear bucket id regexes list, provide flag with empty list.
-              e.g --include-bucket-id-regexes="" or
-              --include-bucket-id-regexes= .
+              the shell, escape them using backslashes(\). To clear bucket id
+              regexes list, provide flag with empty list. e.g
+              --include-bucket-id-regexes="" or --include-bucket-id-regexes= .
 
            --include-bucket-ids=[INCLUDE_BUCKET_IDS,...]
               Comma separated list of bucket ids to include in the management
@@ -115,8 +113,8 @@ REQUIRED FLAGS
 
          --exclude-locations=[EXCLUDE_LOCATIONS,...]
             Comma separated list of locations
-            (https://cloud.google.com/storage/docs/locations#available-locations)to
-            exclude in Management Hub filter. To clear excluded locations,
+            (https://cloud.google.com/storage/docs/locations#available-locations)
+            to exclude in Management Hub filter. To clear excluded locations,
             provide flag with empty list. e.g --exclude-locations="" or
             --exclude-locations= .