gcloud bigtable backups copy

NAME
gcloud bigtable backups copy - copy a Cloud Bigtable backup to a new backup
SYNOPSIS
gcloud bigtable backups copy (--destination-backup=DESTINATION_BACKUP : --destination-cluster=DESTINATION_CLUSTER --destination-instance=DESTINATION_INSTANCE --destination-project=DESTINATION_PROJECT) (--expiration-date=EXPIRATION_DATE     | --retention-period=RETENTION_PERIOD) (--source-backup=SOURCE_BACKUP : --source-cluster=SOURCE_CLUSTER --source-instance=SOURCE_INSTANCE --source-project=SOURCE_PROJECT) [--async] [GCLOUD_WIDE_FLAG]
DESCRIPTION
This command creates a copy of a Cloud Bigtable backup.
EXAMPLES
To copy a backup within the same project, run:
gcloud bigtable backups copy --source-instance=SOURCE_INSTANCE --source-cluster=SOURCE_CLUSTER --source-backup=SOURCE_BACKUP --destination-instance=DESTINATION_INSTANCE --destination-cluster=DESTINATION_CLUSTER --destination-backup=DESTINATION_BACKUP --expiration-date=2023-09-01T10:49:41Z

To copy a backup to a different project, run:

gcloud bigtable backups copy --source-backup=projects/SOURCE_PROJECT/instances/SOURCE_INSTANCE/clusters/SOURCE_CLUSTER/backups/SOURCE_BACKUP --destination-backup=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 bigtable backups copy --source-backup=projects/SOURCE_PROJECT/instances/SOURCE_INSTANCE/clusters/SOURCE_CLUSTER/backups/SOURCE_BACKUP --destination-backup=projects/DESTINATION_PROJECT/instances/DESTINATION_INSTANCE/clusters/DESTINATION_CLUSTER/backups/DESTINATION_BACKUP --retention-period=2w --async
REQUIRED FLAGS
Backup resource - The destination backup to copy to. The arguments in this group can be used to specify the attributes of this resource.

This must be specified.

--destination-backup=DESTINATION_BACKUP
ID of the backup or fully qualified identifier for the backup.

To set the backup attribute:

  • provide the argument --destination-backup on the command line.

This flag argument must be specified if any of the other arguments in this group are specified.

--destination-cluster=DESTINATION_CLUSTER
Cloud Bigtable cluster for the backup.

To set the cluster attribute:

  • provide the argument --destination-backup on the command line with a fully specified name;
  • provide the argument --destination-cluster on the command line.
--destination-instance=DESTINATION_INSTANCE
Cloud Bigtable instance for the backup.

To set the instance attribute:

  • provide the argument --destination-backup 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.
--destination-project=DESTINATION_PROJECT
Project ID of the Google Cloud project for the backup.

To set the project attribute:

  • provide the argument --destination-backup on the command line with a fully specified name;
  • provide the argument --destination-project on the command line;
  • provide the argument --source-project on the command line;
  • provide the argument --project on the command line;
  • set the property core/project.
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 source backup is created. 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 from the time the source backup is created. See $ gcloud topic datetimes for information on duration formats.
Backup resource - The source backup to copy from. The arguments in this group can be used to specify the attributes of this resource.

This must be specified.

--source-backup=SOURCE_BACKUP
ID of the backup or fully qualified identifier for the backup.

To set the backup attribute:

  • provide the argument --source-backup on the command line.

This flag argument must be specified if any of the other arguments in this group are specified.

--source-cluster=SOURCE_CLUSTER
Cloud Bigtable cluster for the backup.

To set the cluster attribute:

  • provide the argument --source-backup on the command line with a fully specified name;
  • provide the argument --source-cluster on the command line.
--source-instance=SOURCE_INSTANCE
Cloud Bigtable instance for the backup.

To set the instance attribute:

  • provide the argument --source-backup 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.
--source-project=SOURCE_PROJECT
Project ID of the Google Cloud project for the backup.

To set the project attribute:

  • provide the argument --source-backup on the command line with a fully specified name;
  • provide the argument --source-project on the command line;
  • provide the argument --destination-project on the command line;
  • provide the argument --project on the command line;
  • set the property core/project.
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
These variants are also available:
gcloud alpha bigtable backups copy
gcloud beta bigtable backups copy