gcloud: Wed Jun 29 09:00:05 UTC 2022

gcloud/alpha/bigtable/backups/copy

@@ -0,0 +1,145 @@
+NAME
+    gcloud alpha bigtable backups copy - copy a Cloud Bigtable backup to a new
+        backup
+
+SYNOPSIS
+    gcloud alpha bigtable backups copy
+        (--destination=DESTINATION : --destination-cluster=DESTINATION_CLUSTER
+          --destination-instance=DESTINATION_INSTANCE)
+        (--expiration-date=EXPIRATION_DATE
+          | --retention-period=RETENTION_PERIOD)
+        (--source=SOURCE
+          : --source-cluster=SOURCE_CLUSTER --source-instance=SOURCE_INSTANCE)
+        [--async] [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    (ALPHA) This command copies a Cloud Bigtable backup to a new backup.
+
+EXAMPLES
+    To copy backup SOURCE_BACKUP to DESTINATION_BACKUP, run:
+
+        $ gcloud alpha bigtable backups copy \
+            --source-instance=SOURCE_INSTANCE \
+            --source-cluster=SOURCE_CLUSTER --source=SOURCE_BACKUP \
+            --destination-instance=DESTINATION_INSTANCE \
+            --destination-cluster=DESTINATION_CLUSTER \
+            --destination=DESTINATION_BACKUP \
+            --expiration-date=2022-08-01T10:49:41Z
+
+    To copy backup SOURCE_BACKUP to DESTINATION_BACKUP using relative names,
+    run:
+
+        $ gcloud alpha bigtable backups copy \
+            --source=projects/SOURCE_PROJECT/instances/SOURCE_INSTANCE/\
+        clusters/SOURCE_CLUSTER/backups/SOURCE_BACKUP \
+            --destination=projects/DESTINATION_PROJECT/instances/\
+        DESTINATION_INSTANCE/clusters/DESTINATION_CLUSTER/backups/\
+        DESTINATION_BACKUP --expiration-date=2022-08-01T10:49:41Z
+
+    To set retention period and run asyncronously, run:
+
+        $ gcloud alpha bigtable backups copy \
+            --source=projects/SOURCE_PROJECT/instances/SOURCE_INSTANCE/\
+        clusters/SOURCE_CLUSTER/backups/SOURCE_BACKUP \
+            --destination=projects/DESTINATION_PROJECT/instances/\
+        DESTINATION_INSTANCE/clusters/DESTINATION_CLUSTER/backups/\
+        DESTINATION_BACKUP --retention-period=2w --async
+
+REQUIRED FLAGS
+     Backup resource - The destination to copy to. The arguments in this group
+     can be used to specify the attributes of this resource. (NOTE) Some
+     attributes are not given arguments in this group but can be set in other
+     ways. To set the project attribute:
+      ◆ provide the argument --destination on the command line with a fully
+        specified name;
+      ◆ provide the argument --project on the command line;
+      ◆ set the property core/project.
+
+     This must be specified.
+
+       --destination=DESTINATION
+          ID of the backup or fully qualified identifier for the backup. To set
+          the source attribute:
+          ▸ provide the argument --destination on the command line.
+
+          This flag must be specified if any of the other arguments in this
+          group are specified.
+
+       --destination-cluster=DESTINATION_CLUSTER
+          The name of the Cloud Bigtable cluster. To set the cluster attribute:
+          ▸ provide the argument --destination on the command line with a
+            fully specified name;
+          ▸ provide the argument --destination-cluster on the command line.
+
+       --destination-instance=DESTINATION_INSTANCE
+          The name of the Cloud Bigtable instance. To set the instance
+          attribute:
+          ▸ provide the argument --destination on the command line with a
+            fully specified name;
+          ▸ provide the argument --destination-instance on the command line;
+          ▸ provide the argument --source-instance on the command line.
+
+     Exactly one of these must be specified:
+
+       --expiration-date=EXPIRATION_DATE
+          Expiration time of the backup, must be at least 6 hours and at most
+          30 days from the time the request is received. 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 30 days. See $ gcloud topic datetimes for
+          information on duration formats.
+
+     Backup resource - The source to copy from. The arguments in this group can
+     be used to specify the attributes of this resource. (NOTE) Some attributes
+     are not given arguments in this group but can be set in other ways. To set
+     the project attribute:
+      ◆ provide the argument --source on the command line with a fully
+        specified name;
+      ◆ provide the argument --project on the command line;
+      ◆ set the property core/project.
+
+     This must be specified.
+
+       --source=SOURCE
+          ID of the backup or fully qualified identifier for the backup. To set
+          the source attribute:
+          ▸ provide the argument --source on the command line.
+
+          This flag must be specified if any of the other arguments in this
+          group are specified.
+
+       --source-cluster=SOURCE_CLUSTER
+          The name of the Cloud Bigtable cluster. To set the cluster attribute:
+          ▸ provide the argument --source on the command line with a fully
+            specified name;
+          ▸ provide the argument --source-cluster on the command line.
+
+       --source-instance=SOURCE_INSTANCE
+          The name of the Cloud Bigtable instance. To set the instance
+          attribute:
+          ▸ provide the argument --source on the command line with a fully
+            specified name;
+          ▸ provide the argument --source-instance on the command line;
+          ▸ provide the argument --destination-instance on the command line.
+
+OPTIONAL FLAGS
+     --async
+        Return immediately, without waiting for the operation in progress to
+        complete.
+
+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/bigtable/backups/help

@@ -18,6 +18,9 @@ COMMANDS
      add-iam-policy-binding
         (ALPHA) Add an IAM policy binding to a Cloud Bigtable Backup.
 
+     copy
+        (ALPHA) Copy a Cloud Bigtable backup to a new backup.
+
      create
         (ALPHA) Creates a backup of a Cloud Bigtable table.