File: //snap/google-cloud-cli/current/help/man/man1/gcloud_compute_disks_start-async-replication.1
.TH "GCLOUD_COMPUTE_DISKS_START\-ASYNC\-REPLICATION" 1
.SH "NAME"
.HP
gcloud compute disks start\-async\-replication \- start asynchronous replication on a Compute Engine persistent disk
.SH "SYNOPSIS"
.HP
\f5gcloud compute disks start\-async\-replication\fR \fIDISK_NAME\fR \fB\-\-secondary\-disk\fR=\fISECONDARY_DISK\fR (\fB\-\-region\fR=\fIREGION\fR\ |\ \fB\-\-zone\fR=\fIZONE\fR) (\fB\-\-secondary\-disk\-region\fR=\fISECONDARY_DISK_REGION\fR\ |\ \fB\-\-secondary\-disk\-zone\fR=\fISECONDARY_DISK_ZONE\fR) [\fB\-\-secondary\-disk\-project\fR=\fISECONDARY_DISK_PROJECT\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]
.SH "DESCRIPTION"
\fBgcloud compute disks start\-async\-replication\fR starts async replication on
a Compute Engine persistent disk. This command must be invoked on the primary
disk and \f5\-\-secondary\-disk\fR must be provided.
.SH "EXAMPLES"
Start replication from the primary disk 'my\-disk\-1' in zone us\-east1\-a to
the secondary disk 'my\-disk\-2' in zone us\-west1\-a:
.RS 2m
$ gcloud compute disks start\-async\-replication my\-disk\-1 \e
\-\-zone=us\-east1\-a \-\-secondary\-disk=my\-disk\-2 \e
\-\-secondary\-disk\-zone=us\-west1\-a
.RE
.SH "POSITIONAL ARGUMENTS"
.RS 2m
.TP 2m
\fIDISK_NAME\fR
Name of the disk to operate on.
.RE
.sp
.SH "REQUIRED FLAGS"
.RS 2m
.TP 2m
\fB\-\-secondary\-disk\fR=\fISECONDARY_DISK\fR
Secondary disk for asynchronous replication. This flag is required when starting
replication.
.TP 2m
Exactly one of these must be specified:
.RS 2m
.TP 2m
\fB\-\-region\fR=\fIREGION\fR
Region of the disk to operate on. If not specified, you might be prompted to
select a region (interactive mode only).
To avoid prompting when this flag is omitted, you can set the
\f5\fIcompute/region\fR\fR property:
.RS 2m
$ gcloud config set compute/region REGION
.RE
A list of regions can be fetched by running:
.RS 2m
$ gcloud compute regions list
.RE
To unset the property, run:
.RS 2m
$ gcloud config unset compute/region
.RE
Alternatively, the region can be stored in the environment variable
\f5\fICLOUDSDK_COMPUTE_REGION\fR\fR.
.TP 2m
\fB\-\-zone\fR=\fIZONE\fR
Zone of the disk to operate on. If not specified and the
\f5\fIcompute/zone\fR\fR property isn't set, you might be prompted to select a
zone (interactive mode only).
To avoid prompting when this flag is omitted, you can set the
\f5\fIcompute/zone\fR\fR property:
.RS 2m
$ gcloud config set compute/zone ZONE
.RE
A list of zones can be fetched by running:
.RS 2m
$ gcloud compute zones list
.RE
To unset the property, run:
.RS 2m
$ gcloud config unset compute/zone
.RE
Alternatively, the zone can be stored in the environment variable
\f5\fICLOUDSDK_COMPUTE_ZONE\fR\fR.
.RE
.sp
.TP 2m
Exactly one of these must be specified:
.RS 2m
.TP 2m
\fB\-\-secondary\-disk\-region\fR=\fISECONDARY_DISK_REGION\fR
Region of the secondary disk for asynchronous replication. Overrides the default
\fBcompute/region\fR property value for this command invocation.
.TP 2m
\fB\-\-secondary\-disk\-zone\fR=\fISECONDARY_DISK_ZONE\fR
Zone of the secondary disk for asynchronous replication. Overrides the default
\fBcompute/zone\fR property value for this command invocation.
.RE
.RE
.sp
.SH "SECONDARY DISK FLAGS"
.RS 2m
.TP 2m
\fB\-\-secondary\-disk\-project\fR=\fISECONDARY_DISK_PROJECT\fR
Project of the secondary disk for asynchronous replication.
.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"
These variants are also available:
.RS 2m
$ gcloud alpha compute disks start\-async\-replication
.RE
.RS 2m
$ gcloud beta compute disks start\-async\-replication
.RE