gcloud-help/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