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

gcloud/bigtable/backups/create

@@ -6,7 +6,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
     Creates a backup of a Cloud Bigtable table.
@@ -27,6 +28,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 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 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 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)
@@ -73,20 +99,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,