gcloud: Wed Dec 18 10:08:20 UTC 2024

gcloud/alpha/bigtable/instances/tables/create

@@ -6,8 +6,9 @@ SYNOPSIS
     gcloud alpha bigtable instances tables create (TABLE : --instance=INSTANCE)
         --column-families=[COLUMN_FAMILIES,...]
         [--change-stream-retention-period=CHANGE_STREAM_RETENTION_PERIOD]
-        [--deletion-protection] [--enable-automated-backup]
-        [--splits=[SPLITS,...]] [GCLOUD_WIDE_FLAG ...]
+        [--deletion-protection] [--splits=[SPLITS,...]]
+        [--automated-backup-retention-period=AUTOMATED_BACKUP_RETENTION_PERIOD
+          | --enable-automated-backup] [GCLOUD_WIDE_FLAG ...]
 
 DESCRIPTION
     (ALPHA) Create a new Cloud Bigtable table.
@@ -60,14 +61,22 @@ EXAMPLES
             --instance=my-instance --column-families="my-family" \
             --no-deletion-protection
 
-    To create a table my-table with automated backup policy
-    (retention_period=72h, frequency=24h) enabled in instance my-instance with
-    a column family my-family, run:
+    To create a table my-table with the default automated backup policy
+    (retention_period=7d, frequency=1d) enabled in instance my-instance with a
+    column family my-family, run:
 
         $ gcloud alpha bigtable instances tables create my-table \
             --instance=my-instance --column-families="my-family" \
             --enable-automated-backup
 
+    To create a table my-table with a custom automated backup policy configured
+    to retain backups for 30 days in instance my-instance with a column family
+    my-family, run:
+
+        $ gcloud alpha bigtable instances tables create my-table \
+            --instance=my-instance --column-families="my-family" \
+            --automated-backup-retention_period=30d
+
 POSITIONAL ARGUMENTS
      Table resource - Cloud Bigtable table to create. The arguments in this
      group can be used to specify the attributes of this resource. (NOTE) Some
@@ -116,14 +125,21 @@ OPTIONAL FLAGS
      --deletion-protection
         Once specified, the table is deletion protected.
 
-     --enable-automated-backup
-        Once set, enables the default automated backup policy
-        (retention_period=72h, frequency=24h) for the table.
-
      --splits=[SPLITS,...]
         Row keys where the table should initially be split. For example:
         car,key
 
+     At most one of these can be specified:
+
+       --automated-backup-retention-period=AUTOMATED_BACKUP_RETENTION_PERIOD
+          The retention period of automated backup in the format of 30d for 30
+          days. Min retention period is 3d and max is 90d. Setting this flag
+          will enable automated backup for the table.
+
+       --enable-automated-backup
+          Once set, enables the default automated backup policy
+          (retention_period=7d, frequency=1d) for the table.
+
 GCLOUD WIDE FLAGS
     These flags are available to all commands: --access-token-file, --account,
     --billing-project, --configuration, --flags-file, --flatten, --format,

gcloud/alpha/bigtable/instances/tables/update

@@ -4,8 +4,9 @@ NAME
 
 SYNOPSIS
     gcloud alpha bigtable instances tables update (TABLE : --instance=INSTANCE)
-        [--async] [--deletion-protection] [--disable-automated-backup]
-        [--enable-automated-backup]
+        [--async] [--deletion-protection]
+        [--automated-backup-retention-period=AUTOMATED_BACKUP_RETENTION_PERIOD
+          | --disable-automated-backup | --enable-automated-backup]
         [--change-stream-retention-period=CHANGE_STREAM_RETENTION_PERIOD
           | --clear-change-stream-retention-period] [GCLOUD_WIDE_FLAG ...]
 
@@ -35,8 +36,8 @@ EXAMPLES
         $ gcloud alpha bigtable instances tables update my-table \
             --instance=my-instance --clear-change-stream-retention-period
 
-    To enable default automated backup policy (retention_period=72h,
-    frequency=24h), run:
+    To enable the default automated backup policy on a table, or update a table
+    to use the default policy (retention_period=7d, frequency=1d), run:
 
         $ gcloud alpha bigtable instances tables update my-table \
             --instance=my-instance --enable-automated-backup
@@ -46,6 +47,12 @@ EXAMPLES
         $ gcloud alpha bigtable instances tables update my-table \
             --instance=my-instance --disable-automated-backup
 
+    To enable or update a custom automated backup policy and configure it to
+    retain backups for 30 days, run:
+
+        $ gcloud alpha bigtable instances tables update my-table \
+            --instance=my-instance --automated-backup-retention_period=30d
+
 POSITIONAL ARGUMENTS
      Table resource - Cloud Bigtable table to update. The arguments in this
      group can be used to specify the attributes of this resource. (NOTE) Some
@@ -85,12 +92,21 @@ FLAGS
      --deletion-protection
         Once specified, the table is deletion protected.
 
-     --disable-automated-backup
-        Once set, disables automated backup policy for the table.
+     At most one of these can be specified:
 
-     --enable-automated-backup
-        Once set, enables the default automated backup policy
-        (retention_period=72h, frequency=24h) for the table.
+       --automated-backup-retention-period=AUTOMATED_BACKUP_RETENTION_PERIOD
+          The retention period of automated backup in the format of 30d for 30
+          days. Min retention period is 3d and max is 90d. Setting this flag
+          will enable automated backup for the table.
+
+       --disable-automated-backup
+          Once set, disables automated backup policy for the table.
+
+       --enable-automated-backup
+          Once set, enables the default automated backup policy
+          (retention_period=7d, frequency=1d) for the table. Note: If a table
+          has automated backup enabled, this flag resets it to the default
+          policy.
 
      At most one of these can be specified: