Copying AWS CloudHSM cluster backups across AWS Regions
You can copy AWS CloudHSM cluster backups across Regions for many reasons, including
cross-region resilience, global workloads, and disaster
recovery. After you copy backups, they appear in the destination region with a
CREATE_IN_PROGRESS
status. Upon successful completion of the copy, the
status of the backup changes to READY
. If the copy fails, the status of the
backup changes to DELETED
. Check your input parameters for errors and ensure
that the specified source backup is not in a DELETED
state before rerunning the
operation. For information about backups or how to create a cluster from a backup, see Cluster backups or Creating clusters from backups.
Note the following:
-
To copy a cluster backup to a destination region, your account must have the proper IAM policy permissions. In order to copy the backup to a different region, your IAM policy must allow access to the source region in which the backup is located. Once copied across regions, your IAM policy must allow access to the destination region in order to interact with the copied backup, which includes using the CreateCluster operation. For more information, see Create IAM administrators.
-
The original cluster and the cluster that may be built from a backup in the destination region are not linked. You must manage each of these clusters independently. For more information, see Clusters.
-
Backups cannot be copied between AWS restricted regions and standard regions. Backups can be copied between the AWS GovCloud (US-East) and AWS GovCloud (US-West) regions.
Copy backups to different Regions (console)
To copy backups to different Regions (console)
Open the AWS CloudHSM console at https://console.aws.amazon.com/cloudhsm/home
. -
To change the AWS Region, use the Region selector in the upper-right corner of the page.
-
In the navigation pane, choose Backups.
-
Choose a backup to copy to a different region.
-
To copy the selected backup, choose Actions, Copy backup to another region.
The Copy backup to another region dialog box appears.
-
In Destination region, choose a region from Select a region.
-
(Optional) Type a tag key and an optional tag value. To add more than one tag to the cluster, choose Add tag.
-
Choose Copy backup.
Copy backups to different Regions (AWS CLI)
To determine the backup ID, run the describe-backups command.
To copy backups to different regions (AWS CLI)
-
At a command prompt, run the copy-backup-to-region command. Specify the destination region and the backup ID of the source backup. If you specify a backup ID, the associated backup is copied.
$
aws cloudhsmv2 copy-backup-to-region --destination-region
<destination region>
\ --backup-id<backup ID>
Copy backups to different Regions (AWS CloudHSM API)
Refer to the following topic to learn how to copy backups to different regions by using the API.