Copying Backups Across Regions - AWS CloudHSM

Copying Backups Across Regions

You can copy 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 Managing 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 Managing 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)

  1. Open the AWS CloudHSM console at https://console.aws.amazon.com/cloudhsm/.

  2. To change the AWS Region, use the Region selector in the upper-right corner of the page.

  3. In the navigation pane, choose Backups.

  4. Choose a backup to copy to a different region.

  5. To copy the selected backup, choose Actions, Copy backup to another region.

    The Copy backup to another region dialog box appears.

  6. In Destination region, choose a region from Select a region.

  7. (Optional) Type a tag key and an optional tag value. To add more than one tag to the cluster, choose Add tag.

  8. Choose Copy backup.

Copy Backups to Different Regions (AWS CLI)

To determine the cluster ID or backup ID, run the describe-clusters or describe-backups command respectively.

To copy backups to different regions (AWS CLI)

  • At a command prompt, run the copy-backup-to-region command. Specify the destination region and either the cluster ID of the source cluster or the backup ID of the source backup. If you specify a backup ID, the associated backup is copied. If you specify a cluster ID, the most recent available backup of the associated cluster is copied. If you provide both, the backup ID provided is used by default.

    $ aws cloudhsmv2 copy-backup-to-region --destination-region <destination region> \ --backup-id <backup ID> { "DestinationBackup": { "CreateTimestamp": 1531742400, "SourceBackup": "backup-4kuraxsqetz", "SourceCluster": "cluster-kzlczlspnho", "SourceRegion": "us-east-1" } }

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.