gcloud alpha backup-dr backups restore disk Stay organized with collections Save and categorize content based on your preferences.
- NAME
- gcloud alpha backup-dr backups restore disk - restores a Compute Disk Backup
- SYNOPSIS
gcloud alpha backup-dr backups restore disk(BACKUP:--backup-vault=BACKUP_VAULT--data-source=DATA_SOURCE--location=LOCATION)--name=NAME--target-project=TARGET_PROJECT[--access-mode=ACCESS_MODE][--architecture=ARCHITECTURE][--async][--clear-encryption-key][--confidential-compute][--description=DESCRIPTION][--guest-os-features=[GUEST_OS_FEATURES,…]][--kms-key=KMS_KEY][--labels=[KEY=VALUE,…]][--licenses=LICENSE,[LICENSE,…]][--provisioned-iops=PROVISIONED_IOPS][--provisioned-throughput=PROVISIONED_THROUGHPUT][--replica-zones=ZONE,ZONE][--resource-policies=RESOURCE_POLICY,[…]][--size=SIZE][--storage-pool=STORAGE_POOL][--target-region=TARGET_REGION][--target-zone=TARGET_ZONE][--type=TYPE][GCLOUD_WIDE_FLAG …]
- DESCRIPTION
(ALPHA)Restores a Compute Disk Backup.- EXAMPLES
- To restore a backup
sample-backupin projectsample-projectand locationus-central1, withsample-data-storeandsample-backup-vault, andadditional target properties, run:gcloudalphabackup-drbackupsrestoredisksample-backup--project=sample-project--location=us-central1--backup-vault=sample-backup-vault--data-source=sample-data-source--<target-properties> - POSITIONAL ARGUMENTS
- Backup resource - The backup of a resource to be restored. The arguments in thisgroup can be used to specify the attributes of this resource. (NOTE) Someattributes are not given arguments in this group but can be set in other ways.
To set the
projectattribute:- provide the argument
backupon the command line with a fullyspecified name; - provide the argument
--projecton the command line; - set the property
core/project.
This must be specified.
BACKUP- ID of the Backup or fully qualified identifier for the Backup.
To set the
nameattribute:- provide the argument
backupon the command line.
This positional argument must be specified if any of the other arguments in thisgroup are specified.
- provide the argument
--backup-vault=BACKUP_VAULT- The ID of the Backup Vault.
To set the
backup-vaultattribute:- provide the argument
backupon the command line with a fullyspecified name; - provide the argument
--backup-vaulton the command line.
- provide the argument
--data-source=DATA_SOURCE- The ID of the Data Source.
To set the
data-sourceattribute:- provide the argument
backupon the command line with a fullyspecified name; - provide the argument
--data-sourceon the command line.
- provide the argument
--location=LOCATION- The location of the Backup.
To set the
locationattribute:- provide the argument
backupon the command line with a fullyspecified name; - provide the argument
--locationon the command line.
- provide the argument
- provide the argument
- Backup resource - The backup of a resource to be restored. The arguments in thisgroup can be used to specify the attributes of this resource. (NOTE) Someattributes are not given arguments in this group but can be set in other ways.
- REQUIRED FLAGS
--name=NAME- Name of the restored Disk.
--target-project=TARGET_PROJECT- Project where the restore should happen.
- OPTIONAL FLAGS
--access-mode=ACCESS_MODE- Specifies how VMs attached to the disk can access the data on the disk. To grantread-only access to multiple VMs attached to the disk, set access-mode toREAD_ONLY_MANY. To grant read-write access to only one VM attached to the disk,use READ_WRITE_SINGLE. READ_WRITE_SINGLE is used if omitted. ACCESS_MODE must beone of: READ_ONLY_MANY, READ_WRITE_MANY, READ_WRITE_SINGLE.
ACCESS_MODEmust be one of:READ_ONLY_MANY- The AccessMode means the disk can be attached to multiple instances in RW mode.
READ_WRITE_MANY- The AccessMode means the disk can be attached to multiple instances in RO mode.
READ_WRITE_SINGLE- The default AccessMode, means the disk can be attached to single instance in RWmode.
--architecture=ARCHITECTURE- Specifies the architecture or processor type that this disk can support. Foravailable processor types on Compute Engine, seehttps://cloud.google.com/compute/docs/cpu-platforms.ARCHITECTURE must be one of: ARM64, X86_64.
ARCHITECTUREmust be one of:ARM64- The disk can only be used with ARM64 machines.
X86_64- The disk can only be used with x86_64 machines.
--async- Return immediately, without waiting for the operation in progress to complete.The default is
True. Enabled by default, use--no-asyncto disable. --clear-encryption-key- The restored disk reverts to GMEK (CMEK is disabled).
--confidential-compute- Creates the disk with confidential compute mode enabled. Encryption with a CloudKMS key is required to enable this option.
--description=DESCRIPTION- Specifies a textual description of the restored disk.
--guest-os-features=[GUEST_OS_FEATURES,…]- Enables one or more features for VM instances that use the image for their bootdisks. See the descriptions of supported features at:https://cloud.google.com/compute/docs/images/create-delete-deprecate-private-images#guest-os-features.GUEST_OS_FEATURE must be one of: VIRTIO_SCSI_MULTIQUEUE, WINDOWS,MULTI_IP_SUBNET, UEFI_COMPATIBLE, SEV_CAPABLE, SEV_LIVE_MIGRATABLE,SEV_LIVE_MIGRATABLE_V2, SEV_SNP_CAPABLE, GVNIC, IDPF, TDX_CAPABLE,SUSPEND_RESUME_COMPATIBLE.
--kms-key=KMS_KEY- The Cloud KMS (Key Management Service) cryptokey that will be used to protectthe disk Provide the full resource name of the cryptokey in the format:projects/<project>/locations/<location>/keyRings/<key-ring>/cryptoKeys/<key>
--labels=[KEY=VALUE,…]- List of label KEY=VALUE pairs to add.
Keys must start with a lowercase character and contain only hyphens (-),underscores (
), lowercase characters, and numbers. Values mustcontain only hyphens (-), underscores (), lowercase characters, andnumbers. --licenses=LICENSE,[LICENSE,…]- A list of URIs to license resources. The provided licenses will be added ontothe created disks to indicate the licensing and billing policies.
--provisioned-iops=PROVISIONED_IOPS- Provisioned IOPS of disk to create. Only for use with disks of type pd-extremeand hyperdisk-extreme.
--provisioned-throughput=PROVISIONED_THROUGHPUT- Provisioned throughput of disk to create. The throughput unit is MB per sec.Only for use with disks of type hyperdisk-throughput.
--replica-zones=ZONE,ZONE- A comma-separated list of exactly 2 URLs of the zones where the disk should bereplicated to. Required when restoring to a regional disk. The zones must be inthe same region as specified in the --target-region flag. See available zoneswith gcloud compute zones list.
--resource-policies=RESOURCE_POLICY,[…]- A list of resource policy names to be added to the disk. The policies must existin the same region as the disk.
--size=SIZE- Size of the disk in GB. Disk size must be a multiple of 1 GB. If disk size isnot specified, the default size of 500GB for pd-standard disks, 100GB forpd-balanced disks, 100GB for pd-ssd disks, and 1000GB for pd-extreme disks willbe used. For details about disk size limits, refer to:https://cloud.google.com/compute/docs/disks
--storage-pool=STORAGE_POOL- Specifies the URI of the storage pool in which the disk is created.
--target-region=TARGET_REGION- Region where the target disk is restored. This flag is mutually exclusive with--target-zone.
--target-zone=TARGET_ZONE- Zone where the target disk is restored. This flag is mutually exclusive with--target-region.
--type=TYPE- URL of the disk type describing which disk type to use to restore the disk. Forexample: projects/project/zones/zone/diskTypes/pd-ssd. To get a list ofavailable disk types, run gcloud compute disk-types list. The default disk typeis pd-standard.
- 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. - BRIEF
- Restores the specified backup
- NOTES
- This command is currently in alpha and might change without notice. If thiscommand fails with API permission errors despite specifying the correct project,you might be trying to access an API with an invitation-only early accessallowlist. This variant is also available:
gcloudbackup-drbackupsrestoredisk
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-11-18 UTC.