- INFORMATION
-
gcloud preview compute disks start-async-replicationis supported in universe domainuniverse; however, some of the values used in the help text may not be available. Command examples may not work as-is and may requires changes before execution. - NAME
-
- gcloud preview compute disks start-async-replication - start asynchronous replication on a Compute Engine persistent disk
- SYNOPSIS
-
-
gcloud preview compute disks start-async-replicationDISK_NAME--secondary-disk=SECONDARY_DISK(--region=REGION|--zone=ZONE) (--secondary-disk-region=SECONDARY_DISK_REGION|--secondary-disk-zone=SECONDARY_DISK_ZONE) [--secondary-disk-project=SECONDARY_DISK_PROJECT] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
-
(PREVIEW)gcloud preview compute disks start-async-replicationstarts async replication on a Compute Engine persistent disk. This command must be invoked on the primary disk and--secondary-diskmust be provided. - 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:
gcloud preview compute disks start-async-replication my-disk-1 --zone=us-east1-a --secondary-disk=my-disk-2 --secondary-disk-zone=us-west1-a - POSITIONAL ARGUMENTS
-
DISK_NAME- Name of the disk to operate on.
- REQUIRED FLAGS
-
--secondary-disk=SECONDARY_DISK- Secondary disk for asynchronous replication. This flag is required when starting replication.
-
Exactly one of these must be specified:
--region=REGION-
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
property:compute/regiongcloud config set compute/region REGIONA list of regions can be fetched by running:
gcloud compute regions listTo unset the property, run:
gcloud config unset compute/regionAlternatively, the region can be stored in the environment variable
.CLOUDSDK_COMPUTE_REGION --zone=ZONE-
Zone of the disk to operate on. If not specified and the
property isn't set, you might be prompted to select a zone (interactive mode only).compute/zoneTo avoid prompting when this flag is omitted, you can set the
property:compute/zonegcloud config set compute/zone ZONEA list of zones can be fetched by running:
gcloud compute zones listTo unset the property, run:
gcloud config unset compute/zoneAlternatively, the zone can be stored in the environment variable
.CLOUDSDK_COMPUTE_ZONE
-
Exactly one of these must be specified:
--secondary-disk-region=SECONDARY_DISK_REGION-
Region of the secondary disk for asynchronous replication. Overrides the default
compute/regionproperty value for this command invocation. --secondary-disk-zone=SECONDARY_DISK_ZONE-
Zone of the secondary disk for asynchronous replication. Overrides the default
compute/zoneproperty value for this command invocation.
- SECONDARY DISK FLAGS
-
--secondary-disk-project=SECONDARY_DISK_PROJECT- Project of the secondary disk for asynchronous replication.
- 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 helpfor details. - NOTES
-
This command is currently in DEVELOPER PREVIEW and may 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. These variants are also available:
gcloud compute disks start-async-replicationgcloud alpha compute disks start-async-replicationgcloud beta compute disks start-async-replication
gcloud preview compute disks start-async-replication
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-04-14 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2026-04-14 UTC."],[],[]]