Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Copy an AMI

You can copy an Amazon Machine Image (AMI) within or across Amazon Regions. You can copy both Amazon EBS-backed AMIs and instance-store-backed AMIs. You can copy AMIs with encrypted snapshots and also change encryption status during the copy process. You can copy AMIs that are shared with you.

Copying a source AMI results in an identical but distinct target AMI with its own unique identifier. You can change or deregister the source AMI with no effect on the target AMI. The reverse is also true.

With an Amazon EBS-backed AMI, each of its backing snapshots is copied to an identical but distinct target snapshot. If you copy an AMI to a new Region, the snapshots are complete (non-incremental) copies. If you encrypt unencrypted backing snapshots or encrypt them to a new KMS key, the snapshots are complete (non-incremental) copies. Subsequent copy operations of an AMI result in incremental copies of the backing snapshots.

Considerations

Costs

There are no charges for copying an AMI. However, standard storage and data transfer rates apply. If you copy an EBS-backed AMI, you will incur charges for the storage of any additional EBS snapshots.

Permissions for copying an instance store-backed AMI

To copy an instance store-backed AMI, the user must have the following Amazon S3 permissions: s3:CreateBucket, s3:GetBucketAcl, s3:ListAllMyBuckets, s3:GetObject, s3:PutObject, and s3:PutObjectAcl.

The following example policy allows the user to copy the AMI source in the specified bucket to the specified Region.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "s3:ListAllMyBuckets",
            "Resource": [
                "arn:aws:s3:::*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": "s3:GetObject",
            "Resource": [
                "arn:aws:s3:::ami-source-bucket/*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
              "s3:CreateBucket",
              "s3:GetBucketAcl",
              "s3:PutObjectAcl",
              "s3:PutObject"
            ],
            "Resource": [
                "arn:aws:s3:::amis-for-123456789012-in-us-east-1*"
            ]
        }
    ]
}

To find the Amazon Resource Name (ARN) of the AMI source bucket, open the Amazon EC2 console at https://console.amazonaws.cn/ec2/, in the navigation pane choose AMIs, and locate the bucket name in the Source column.

Copy an AMI

You can copy an AMI using the Amazon Web Services Management Console, the Amazon Command Line Interface or SDKs, or the Amazon EC2 API, all of which support the CopyImage action.

Prerequisite

Create or obtain an AMI backed by an Amazon EBS snapshot. Note that you can use the Amazon EC2 console to search a wide variety of AMIs provided by Amazon. For more information, see Create a custom Windows AMI and Finding an AMI.

New console

To copy an AMI using the console

1. Open the Amazon EC2 console at https://console.amazonaws.cn/ec2/.

2. From the console navigation bar, select the Region that contains the AMI.

3. In the navigation pane, choose Images, AMIs to display the list of AMIs available to you in the Region.

4. Select the AMI to copy and choose Actions, Copy AMI.

5. On the Copy AMI page, specify the following information:

   • AMI copy name: A name for the new AMI. You can include operating system information in the name, as we do not provide this information when displaying details about the AMI.

   • AMI copy description: By default, the description includes information about the source AMI so that you can distinguish a copy from its original. You can change this description as needed.

   • Destination Region: The Region in which to copy the AMI. For more information, see Cross-Region copying.

   • Copy tags: Select this check box to include your user-defined AMI tags when copying the AMI. System tags (prefixed with aws:) and user-defined tags that are attached by other Amazon Web Services accounts will not be copied.

   • Encrypt EBS snapshots of AMI copy: Select this check box to encrypt the target snapshots, or to re-encrypt them using a different key. If you have enabled encryption by default, the Encrypt EBS snapshots of AMI copy check box is selected and cannot be cleared. For more information, see Encryption and copying.

   • KMS key: The KMS key to used to encrypt the target snapshots.

6. Choose Copy AMI.

   The initial status of the new AMI is Pending. The AMI copy operation is complete when the status is Available.

Old console

To copy an AMI using the console

1. Open the Amazon EC2 console at https://console.amazonaws.cn/ec2/.

2. From the console navigation bar, select the Region that contains the AMI. In the navigation pane, choose Images, AMIs to display the list of AMIs available to you in the Region.

3. Select the AMI to copy and choose Actions, Copy AMI.

4. In the Copy AMI dialog box, specify the following information and then choose Copy AMI:

   • Destination region: The Region in which to copy the AMI. For more information, see Cross-Region copying.

   • Name: A name for the new AMI. You can include operating system information in the name, as we do not provide this information when displaying details about the AMI.

   • Description: By default, the description includes information about the source AMI so that you can distinguish a copy from its original. You can change this description as needed.

   • Encryption: Select this field to encrypt the target snapshots, or to re-encrypt them using a different key. If you have enabled encryption by default, the Encryption option is set and cannot be unset. For more information, see Encryption and copying.

   • KMS Key: The KMS key to used to encrypt the target snapshots.

5. We display a confirmation page to let you know that the copy operation has been initiated and to provide you with the ID of the new AMI.

   To check on the progress of the copy operation immediately, follow the provided link. To check on the progress later, choose Done, and then when you are ready, use the navigation bar to switch to the target Region (if applicable) and locate your AMI in the list of AMIs.

   The initial status of the target AMI is pending and the operation is complete when the status is available.

To copy an AMI using the Amazon CLI

You can copy an AMI using the copy-image command. You must specify both the source and destination Regions. You specify the source Region using the --source-region parameter. You can specify the destination Region using either the --region parameter or an environment variable. For more information, see Configuring the Amazon Command Line Interface.

When you encrypt a target snapshot during copying, you must specify these additional parameters: --encrypted and --kms-key-id.

For example commands, see the Examples under copy-image in the Amazon CLI Command Reference.

To copy an AMI using the Tools for Windows PowerShell

You can copy an AMI using the Copy-EC2Image command. You must specify both the source and destination Regions. You specify the source Region using the -SourceRegion parameter. You can specify the destination Region using either the -Region parameter or the Set-AWSDefaultRegion command. For more information, see Specifying Amazon Regions.

When you encrypt a target snapshot during copying, you must specify these additional parameters: -Encrypted and -KmsKeyId.

Stop a pending AMI copy operation

You can stop a pending AMI copy as follows.

New console

To stop an AMI copy operation using the console

1. Open the Amazon EC2 console at https://console.amazonaws.cn/ec2/.

2. From the navigation bar, select the destination Region from the Region selector.

3. In the navigation pane, choose AMIs.

4. Select the AMI to stop copying and choose Actions, Deregister AMI.

5. When asked for confirmation, choose Deregister AMI.

Old console

To stop an AMI copy operation using the console

1. Open the Amazon EC2 console at https://console.amazonaws.cn/ec2/.

2. From the navigation bar, select the destination Region from the Region selector.

3. In the navigation pane, choose AMIs.

4. Select the AMI to stop copying and choose Actions, Deregister.

5. When asked for confirmation, choose Continue.

Cross-Region copying

Copying an AMI across geographically diverse Regions provides the following benefits:

The following diagram shows the relations among a source AMI and two copied AMIs in different Regions, as well as the EC2 instances launched from each. When you launch an instance from an AMI, it resides in the same Region where the AMI resides. If you make changes to the source AMI and want those changes to be reflected in the AMIs in the target Regions, you must recopy the source AMI to the target Regions.

When you first copy an instance store-backed AMI to a Region, we create an Amazon S3 bucket for the AMIs copied to that Region. All instance store-backed AMIs that you copy to that Region are stored in this bucket. The bucket names have the following format: amis-for-account-in-region-hash. For example: amis-for-123456789012-in-us-west-2-yhjmxvp6.

Prerequisite

Prior to copying an AMI, you must ensure that the contents of the source AMI are updated to support running in a different Region. For example, you should update any database connection strings or similar application configuration data to point to the appropriate resources. Otherwise, instances launched from the new AMI in the destination Region may still use the resources from the source Region, which can impact performance and cost.

Cross-account copying

You can share an AMI with another Amazon account. Sharing an AMI does not affect the ownership of the AMI. The owning account is charged for the storage in the Region. For more information, see Share an AMI with specific Amazon accounts.

If you copy an AMI that has been shared with your account, you are the owner of the target AMI in your account. The owner of the source AMI is charged standard Amazon EBS or Amazon S3 transfer fees, and you are charged for the storage of the target AMI in the destination Region.

Resource permissions

To copy an AMI that was shared with you from another account, the owner of the source AMI must grant you read permissions for the storage that backs the AMI. The storage is either the associated EBS snapshot (for an Amazon EBS-backed AMI) or an associated S3 bucket (for an instance store-backed AMI). If the shared AMI has encrypted snapshots, the owner must share the key or keys with you as well. For more information about granting resource permissions, for EBS snapshots, see Share an Amazon EBS snapshot, and for S3 buckets, see Identity and access management in Amazon S3 in the Amazon Simple Storage Service User Guide.

Encryption and copying

The following table shows encryption support for various AMI-copying scenarios. While it is possible to copy an unencrypted snapshot to yield an encrypted snapshot, you cannot copy an encrypted snapshot to yield an unencrypted one.

By default (i.e., without specifying encryption parameters), the backing snapshot of an AMI is copied with its original encryption status. Copying an AMI backed by an unencrypted snapshot results in an identical target snapshot that is also unencrypted. If the source AMI is backed by an encrypted snapshot, copying it results in an identical target snapshot that is encrypted by the same Amazon KMS key. Copying an AMI backed by multiple snapshots preserves, by default, the source encryption status in each target snapshot.

If you specify encryption parameters while copying an AMI, you can encrypt or re-encrypt its backing snapshots. The following example shows a non-default case that supplies encryption parameters to the CopyImage action in order to change the target AMI's encryption state.

Copy an unencrypted source AMI to an encrypted target AMI

In this scenario, an AMI backed by an unencrypted root snapshot is copied to an AMI with an encrypted root snapshot. The CopyImage action is invoked with two encryption parameters, including a customer managed key. As a result, the encryption status of the root snapshot changes, so that the target AMI is backed by a root snapshot containing the same data as the source snapshot, but encrypted using the specified key. You incur storage costs for the snapshots in both AMIs, as well as charges for any instances you launch from either AMI.

Setting the Encrypted parameter encrypts the single snapshot for this instance. If you do not specify the KmsKeyId parameter, the default customer managed key is used to encrypt the snapshot copy.

For more information about copying AMIs with encrypted snapshots, see Use encryption with EBS-backed AMIs.