         | Did this page help you? Yes No Tell us about it... |
ec2-migrate-image
Description
Copies a bundled AMI from one Region to another.
![[Note]](http://docs.amazonwebservices.com/docs-common/images/note.png) | Note |
|---|---|
This tool replaces ec2-migrate-bundle. This tool does not work with AMIs backed by Amazon EBS. |
The short version of this command is ec2mim.
Syntax
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
Options
| Name | Description | Required |
|---|---|---|
|
|
The path to your PEM-encoded RSA key file. Type: String Default: Uses EC2_PRIVATE_KEY environment variable |
No |
|
|
The user's PEM encoded RSA public key certificate file. Type: String Default: Uses EC2_CERT environment variable Example: -C cert-HKZYKTAIG2ECMXYIBH3HXV4ZBZQ55CLO.pem |
No |
|
|
Specifies the URL to use as the web service URL. Type: String Default: https://ec2.amazonaws.com Example: -U https://ec2.amazonaws.com |
No |
|
|
Access key ID of the bucket owner. Type: String Default: None Example: -o AKIADQKE4SARGYLE |
Yes |
|
|
Secret access key of the bucket owner. Type: String Default: None Example: -w 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: --bucket 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: --destination-bucket my-eu-bucket |
Yes |
|
|
The location of the Amazon S3 source manifest. Type: String Default: None Example: --manifest my-ami.manifest.xml |
Yes |
|
|
The location of the destination Amazon S3 bucket. Type: String Valid Values: Default: US Example: --location EU |
No |
|
|
The access control list policy of the bundled image. Type: String Valid Values: Default: None Example: --acl public-read |
Yes |
|
|
The ID of the kernel to select. Type: String Default: None Example: --kernel 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: --ramdisk ari-badbad00 |
No |
|
|
Disables automatic mapping of kernels and RAM disks. Type: String Default: Mapping is enabled. Example: --no-mapping |
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: --region eu-west-1 |
No |
Common Options
| Option | Description |
|---|---|
|
|
Overrides the Region specified in the Default: The Example: |
|
|
Default: The Example: |
|
|
The private key to use when constructing requests to Amazon EC2. Default: The value of the Example: |
|
|
The X.509 certificate to use when constructing requests to Amazon EC2. Default: The value of the Example: |
|
|
Specifies a connection timeout (in seconds). Example: --connection-timeout 30 |
|
|
Specifies a request timeout (in seconds). Example: --request-timeout 45 |
|
|
Displays verbose output by showing the SOAP request and response on the command line. This is particularly useful if you are building tools to talk directly to our SOAP API. |
|
|
Displays column headers in the output. |
|
|
Shows empty columns as |
|
|
Do not display tags for tagged resources. |
|
|
Prints internal debugging information. This is useful to assist us when troubleshooting problems. |
|
|
Displays Help. |
|
|
If Example: |
Output
The command returns a table that contains the following information:
Status messages describing the stages and status of the migration
Amazon EC2 command line tools display errors on stderr.
Examples
Example Request
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 --owner-akid AKIADQKE4SARGYLE --owner-sak 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
