 | Documentation Feedback |  |
Copies a bundled AMI from one Region to another.
![[Note]](images/note.png) | Note |
|---|---|
This tool replaces ec2-migrate-bundle. This tool does not work with AMIs backed by Amazon EBS. |
ec2-migrate-image --private-key
private_key --cert cert -U
url --owner-akid access_key_id
--owner-sak secret_access_key --bucket
source_s3_bucket --destination-bucket
destination_s3_bucket --manifest
manifest_path --acl acl
--location {US | EU} --ec2cert ec2_cert_path [--kernel
kernel-id] [--ramdisk
ramdisk_id] {--no-mapping} --region
mapping_region_name
| Name | Description | Required |
|---|---|---|
|
|
The path to your PEM-encoded RSA key file. Type: String Default: Uses EC2_PRIVATE_KEY environment variable Example: None |
No |
|
|
The user's PEM encoded RSA public key certificate file. Type: String Default: Uses EC2_CERT environment variable Example: cert-HKZYKTAIG2ECMXYIBH3HXV4ZBZQ55CLO.pem |
No |
|
|
Specifies the URL to use as the web service URL. Type: String Default: https://ec2.amazonaws.com Example: https://ec2.amazonaws.com |
No |
|
|
Access key ID of the bucket owner. Type: String Default: None Example: 157SZTMZQT516NAZ7CR2 |
Yes |
|
|
Secret access key of the bucket owner. Type: String Default: None Example: eW91dHViZS5jb20vd2F0Y2g/dj1SU3NKMTlzeTNKSQ== |
Yes |
|
|
The source Amazon S3 bucket where the AMI is located, followed by an optional '/'-delimited path prefix. Type: String Default: None Example: my-us-bucket |
Yes |
|
|
The destination Amazon S3 bucket, followed by an optional '/'-delimited path prefix. If the destination bucket does not exist, it is created. Type: String Default: None Example: my-eu-bucket |
Yes |
|
|
The location of the Amazon S3 source manifest. Type: String Default: None Example: my-ami.manifest.xml |
Yes |
|
|
The location of the destination Amazon S3 bucket. Type: String Valid Values: Default: US Example: EU |
No |
|
|
The access control list policy of the bundled image. Type: String Valid Values: Default: None Example: public-read |
Yes |
|
|
The ID of the kernel to select. Type: String Default: None Example: aki-ba3adfd3 |
No |
|
|
The ID of the RAM disk to select. Some kernels require additional drivers at launch. Check the kernel requirements for information on whether you need to specify a RAM disk. To find kernel requirements, refer to the Resource Center and search for the kernel ID. Type: String Default: None Example: ari-badbad00 |
No |
|
|
Disables automatic mapping of kernels and RAM disks. Type: String Default: Mapping is enabled. Example: my-ami.manifest.xml |
No |
|
|
Region to look up in the mapping file. Type: String Default: Amazon EC2 attempts to determine the Region from the location of the Amazon S3 bucket. Example: eu-west-1 |
No |
The command returns a table that contains the following information:
Status messages describing the stages and status of the migration
Amazon EC2 displays errors on stderr.
This example copies the AMI specified in the my-ami.manifest.xml manifest
from the US to the EU.
PROMPT>ec2-migrate-image --cert cert-THUMBPRINT.pem --privatekey pk-THUMBPRINT.pem --access-key AKIADQKE4SARGYLE --secret-key eW91dHViZS5jb20vd2F0Y2g/dj1SU3NKMTlzeTNKSQ== --bucket my-us-bucket --destination-bucket my-eu-bucket --manifest my-ami.manifest.xml --location EUCopying 'my-ami.part.00'...Copying 'my-ami.part.01'...Copying 'my-ami.part.02'...Copying 'my-ami.part.03'...Copying 'my-ami.part.04'...Copying 'my-ami.part.05'...Copying 'my-ami.part.06'...Copying 'my-ami.part.07'...Copying 'my-ami.part.08'...Copying 'my-ami.part.09'...Copying 'my-ami.part.10'...Your new bundle is in S3 at the following location:my-eu-bucket/my-ami.manifest.xml
