.TH "GCLOUD_BETA_BIGTABLE_BACKUPS_COPY" 1



.SH "NAME"
.HP
gcloud beta bigtable backups copy \- copy a Cloud Bigtable backup to a new backup



.SH "SYNOPSIS"
.HP
\f5gcloud beta bigtable backups copy\fR (\fB\-\-destination\-backup\fR=\fIDESTINATION_BACKUP\fR\ :\ \fB\-\-destination\-cluster\fR=\fIDESTINATION_CLUSTER\fR\ \fB\-\-destination\-instance\fR=\fIDESTINATION_INSTANCE\fR\ \fB\-\-destination\-project\fR=\fIDESTINATION_PROJECT\fR) (\fB\-\-expiration\-date\fR=\fIEXPIRATION_DATE\fR\ |\ \fB\-\-retention\-period\fR=\fIRETENTION_PERIOD\fR) (\fB\-\-source\-backup\fR=\fISOURCE_BACKUP\fR\ :\ \fB\-\-source\-cluster\fR=\fISOURCE_CLUSTER\fR\ \fB\-\-source\-instance\fR=\fISOURCE_INSTANCE\fR\ \fB\-\-source\-project\fR=\fISOURCE_PROJECT\fR) [\fB\-\-async\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(BETA)\fR This command creates a copy of a Cloud Bigtable backup.



.SH "EXAMPLES"

To copy a backup within the same project, run:

.RS 2m
$ gcloud beta bigtable backups copy \e
    \-\-source\-instance=SOURCE_INSTANCE \e
    \-\-source\-cluster=SOURCE_CLUSTER \-\-source\-backup=SOURCE_BACKUP \e
    \-\-destination\-instance=DESTINATION_INSTANCE \e
    \-\-destination\-cluster=DESTINATION_CLUSTER \e
    \-\-destination\-backup=DESTINATION_BACKUP \e
    \-\-expiration\-date=2023\-09\-01T10:49:41Z
.RE

To copy a backup to a different project, run:

.RS 2m
$ gcloud beta bigtable backups copy \e
    \-\-source\-backup=projects/SOURCE_PROJECT/instances/\e
SOURCE_INSTANCE/clusters/SOURCE_CLUSTER/backups/SOURCE_BACKUP \e
    \-\-destination\-backup=projects/DESTINATION_PROJECT/instances/\e
DESTINATION_INSTANCE/clusters/DESTINATION_CLUSTER/backups/\e
DESTINATION_BACKUP \-\-expiration\-date=2022\-08\-01T10:49:41Z
.RE

To set retention period and run asyncronously, run:

.RS 2m
$ gcloud beta bigtable backups copy \e
    \-\-source\-backup=projects/SOURCE_PROJECT/instances/\e
SOURCE_INSTANCE/clusters/SOURCE_CLUSTER/backups/SOURCE_BACKUP \e
    \-\-destination\-backup=projects/DESTINATION_PROJECT/instances/\e
DESTINATION_INSTANCE/clusters/DESTINATION_CLUSTER/backups/\e
DESTINATION_BACKUP \-\-retention\-period=2w \-\-async
.RE



.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m

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.


.RS 2m
.TP 2m
\fB\-\-destination\-backup\fR=\fIDESTINATION_BACKUP\fR

ID of the backup or fully qualified identifier for the backup.

To set the \f5backup\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5\-\-destination\-backup\fR on the command line.
.RE
.sp

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

.TP 2m
\fB\-\-destination\-cluster\fR=\fIDESTINATION_CLUSTER\fR

Bigtable cluster for the backup.

To set the \f5cluster\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5\-\-destination\-backup\fR on the command line with a
fully specified name;
.IP "\(bu" 2m
provide the argument \f5\-\-destination\-cluster\fR on the command line.
.RE
.sp

.TP 2m
\fB\-\-destination\-instance\fR=\fIDESTINATION_INSTANCE\fR

Bigtable instance for the backup.

To set the \f5instance\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5\-\-destination\-backup\fR on the command line with a
fully specified name;
.IP "\(bu" 2m
provide the argument \f5\-\-destination\-instance\fR on the command line;
.IP "\(bu" 2m
provide the argument \f5\-\-source\-instance\fR on the command line.
.RE
.sp

.TP 2m
\fB\-\-destination\-project\fR=\fIDESTINATION_PROJECT\fR

Project ID of the Google Cloud project for the backup.

To set the \f5project\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5\-\-destination\-backup\fR on the command line with a
fully specified name;
.IP "\(bu" 2m
provide the argument \f5\-\-destination\-project\fR on the command line;
.IP "\(bu" 2m
provide the argument \f5\-\-source\-project\fR on the command line;
.IP "\(bu" 2m
provide the argument \f5\-\-project\fR on the command line;
.IP "\(bu" 2m
set the property \f5core/project\fR.
.RE
.sp

.RE
.sp
.TP 2m

Exactly one of these must be specified:


.RS 2m
.TP 2m
\fB\-\-expiration\-date\fR=\fIEXPIRATION_DATE\fR

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 \f5$ gcloud topic datetimes\fR for
information on date/time formats.

.TP 2m
\fB\-\-retention\-period\fR=\fIRETENTION_PERIOD\fR

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 \f5$ gcloud
topic datetimes\fR for information on duration formats.

.RE
.sp
.TP 2m

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.


.RS 2m
.TP 2m
\fB\-\-source\-backup\fR=\fISOURCE_BACKUP\fR

ID of the backup or fully qualified identifier for the backup.

To set the \f5backup\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5\-\-source\-backup\fR on the command line.
.RE
.sp

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

.TP 2m
\fB\-\-source\-cluster\fR=\fISOURCE_CLUSTER\fR

Bigtable cluster for the backup.

To set the \f5cluster\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5\-\-source\-backup\fR on the command line with a fully
specified name;
.IP "\(bu" 2m
provide the argument \f5\-\-source\-cluster\fR on the command line.
.RE
.sp

.TP 2m
\fB\-\-source\-instance\fR=\fISOURCE_INSTANCE\fR

Bigtable instance for the backup.

To set the \f5instance\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5\-\-source\-backup\fR on the command line with a fully
specified name;
.IP "\(bu" 2m
provide the argument \f5\-\-source\-instance\fR on the command line;
.IP "\(bu" 2m
provide the argument \f5\-\-destination\-instance\fR on the command line.
.RE
.sp

.TP 2m
\fB\-\-source\-project\fR=\fISOURCE_PROJECT\fR

Project ID of the Google Cloud project for the backup.

To set the \f5project\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5\-\-source\-backup\fR on the command line with a fully
specified name;
.IP "\(bu" 2m
provide the argument \f5\-\-source\-project\fR on the command line;
.IP "\(bu" 2m
provide the argument \f5\-\-destination\-project\fR on the command line;
.IP "\(bu" 2m
provide the argument \f5\-\-project\fR on the command line;
.IP "\(bu" 2m
set the property \f5core/project\fR.
.RE
.sp


.RE
.RE
.sp

.SH "OPTIONAL FLAGS"

.RS 2m
.TP 2m
\fB\-\-async\fR

Return immediately, without waiting for the operation in progress to complete.


.RE
.sp

.SH "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 \fB$ gcloud help\fR for details.



.SH "NOTES"

This command is currently in beta and might change without notice. These
variants are also available:

.RS 2m
$ gcloud bigtable backups copy
.RE

.RS 2m
$ gcloud alpha bigtable backups copy
.RE