gcloud: Wed Oct 9 09:55:07 UTC 2024

gcloud/alpha/bigtable/backups/create

@@ -7,7 +7,8 @@ SYNOPSIS
         (BACKUP : --cluster=CLUSTER --instance=INSTANCE) --table=TABLE
         (--expiration-date=EXPIRATION_DATE
           | --retention-period=RETENTION_PERIOD) [--async]
-        [GCLOUD_WIDE_FLAG ...]
+        [--backup-type=BACKUP_TYPE]
+        [--hot-to-standard-time=HOT_TO_STANDARD_TIME] [GCLOUD_WIDE_FLAG ...]
 
 DESCRIPTION
     (ALPHA) Creates a backup of a Cloud Bigtable table.
@@ -28,6 +29,31 @@ EXAMPLES
             --instance=INSTANCE_NAME --cluster=CLUSTER_NAME \
             --table=TABLE_NAME --retention-period=2w
 
+    To create a hot backup 'BACKUP_NAME' from table 'TABLE_NAME' which expires
+    in 2 weeks from now, run:
+
+        $ gcloud alpha bigtable backups create BACKUP_NAME \
+            --instance=INSTANCE_NAME --cluster=CLUSTER_NAME \
+            --table=TABLE_NAME --retention-period=2w --backup-type=HOT
+
+    To create a hot backup 'BACKUP_NAME' from table 'TABLE_NAME' which will be
+    converted to a standard backup at '2019-03-31T10:49:41Z' and expires in 2
+    weeks from now, run:
+
+        $ gcloud alpha bigtable backups create BACKUP_NAME \
+            --instance=INSTANCE_NAME --cluster=CLUSTER_NAME \
+            --table=TABLE_NAME --retention-period=2w --backup-type=HOT \
+            --hot-to-standard-time=2019-03-31T10:49:41Z
+
+    To create a hot backup 'BACKUP_NAME' from table 'TABLE_NAME' which will be
+    converted to a standard backup in 1 week from now and expires in 2 weeks
+    from now, run:
+
+        $ gcloud alpha bigtable backups create BACKUP_NAME \
+            --instance=INSTANCE_NAME --cluster=CLUSTER_NAME \
+            --table=TABLE_NAME --retention-period=2w --backup-type=HOT \
+            --hot-to-standard-time=+P1w
+
 POSITIONAL ARGUMENTS
      Backup resource - The Cloud Bigtable backup to create. The arguments in
      this group can be used to specify the attributes of this resource. (NOTE)
@@ -74,20 +100,38 @@ REQUIRED FLAGS
      Exactly one of these must be specified:
 
        --expiration-date=EXPIRATION_DATE
-          Absolute expiration time of the backup; must be at least 6 hours and
-          at most 90 days from the time the request is received. See $ gcloud
-          topic datetimes for information on date/time formats.
+          Absolute expiration time of the backup. From the time the request is
+          received, must be:
+          ▸ At least 6 hours in the future
+          ▸ At most 90 days in the future
+
+          See $ gcloud topic datetimes for information on date/time formats.
 
        --retention-period=RETENTION_PERIOD
-          Retention period of the backup relative from now; must be at least 6
-          hours and at most 90 days. See $ gcloud topic datetimes for
-          information on duration formats.
+          Retention period of the backup relative from now; must be:
+          ▸ At least 6 hours
+          ▸ At most 90 days
+
+          See $ gcloud topic datetimes for information on duration formats.
 
 OPTIONAL FLAGS
      --async
         Return immediately, without waiting for the operation in progress to
         complete.
 
+     --backup-type=BACKUP_TYPE
+        Type of the backup; whether the backup is a standard backup or a hot
+        backup. BACKUP_TYPE must be one of: backup-type-unspecified, hot,
+        standard.
+
+     --hot-to-standard-time=HOT_TO_STANDARD_TIME
+        Time at which a hot backup will be converted to a standard backup
+        relative from now; must be:
+        ◆ At least 24 hours
+
+        Only applies for hot backups. See $ gcloud topic datetimes for
+        information on date/time formats.
+
 GCLOUD WIDE FLAGS
     These flags are available to all commands: --access-token-file, --account,
     --billing-project, --configuration, --flags-file, --flatten, --format,

gcloud/alpha/bigtable/backups/update

@@ -5,6 +5,7 @@ NAME
 SYNOPSIS
     gcloud alpha bigtable backups update
         (BACKUP : --cluster=CLUSTER --instance=INSTANCE)
+        [--hot-to-standard-time=HOT_TO_STANDARD_TIME]
         [--expiration-date=EXPIRATION_DATE
           | --retention-period=RETENTION_PERIOD] [GCLOUD_WIDE_FLAG ...]
 
@@ -19,6 +20,26 @@ EXAMPLES
             --instance=INSTANCE_NAME --cluster=CLUSTER_NAME \
             --retention-period=7d
 
+    To update the hot-to-standard time of backup 'BACKUP_NAME' to
+    '2019-03-31T10:49:41Z', run:
+
+        $ gcloud alpha bigtable backups update BACKUP_NAME \
+            --instance=INSTANCE_NAME --cluster=CLUSTER_NAME \
+            --hot-to-standard-time=2019-03-31T10:49:41Z
+
+    To update the hot-to-standard time of backup 'BACKUP_NAME' to 7 days from
+    now, run:
+
+        $ gcloud alpha bigtable backups update BACKUP_NAME \
+            --instance=INSTANCE_NAME --cluster=CLUSTER_NAME \
+            --hot-to-standard-time=+P7d
+
+    To clear the hot-to-standard time of backup 'BACKUP_NAME', run:
+
+        $ gcloud alpha bigtable backups update BACKUP_NAME \
+            --instance=INSTANCE_NAME --cluster=CLUSTER_NAME \
+            --hot-to-standard-time=''
+
 POSITIONAL ARGUMENTS
      Backup resource - Cloud Bigtable backup to update. The arguments in this
      group can be used to specify the attributes of this resource. (NOTE) Some
@@ -59,6 +80,12 @@ POSITIONAL ARGUMENTS
           ▸ provide the argument --instance on the command line.
 
 FLAGS
+     --hot-to-standard-time=HOT_TO_STANDARD_TIME
+        Time at which a hot backup will be converted to a standard backup; must
+        be at least 24 hours from backup creation time. Only applies for hot
+        backups. See $ gcloud topic datetimes for information on date/time
+        formats. See $ gcloud bigtable backups describe for creation time.
+
      At most one of these can be specified:
 
        --expiration-date=EXPIRATION_DATE