ec2-migrate-image

Description

Copies a bundled AMI from one region to another. For information on regions, see

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
`-K, --private-key` `private_key`	The path to your PEM-encoded RSA key file. Type: String Default: Uses EC2_PRIVATE_KEY environment variable Example: None	No
`-C, --cert` `cert`	The user's PEM encoded RSA public key certificate file. Type: String Default: Uses EC2_CERT environment variable Example: cert-HKZYKTAIG2ECMXYIBH3HXV4ZBZQ55CLO.pem	No
`-U, --url` `url`	Specifies the URL to use as the web service URL. Type: String Default: https://ec2.amazonaws.com Example: https://ec2.amazonaws.com	No
`-o, --owner-akid` `access_key_id`	Access key ID of the bucket owner. Type: String Default: None Example: 157SZTMZQT516NAZ7CR2	Yes
`-w, --owner-sak` `secret_access_key`	Secret access key of the bucket owner. Type: String Default: None Example: eW91dHViZS5jb20vd2F0Y2g/dj1SU3NKMTlzeTNKSQ==	Yes
`--bucket` `source_s3_bucket`	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
`--destination-bucket` `destination_s3_bucket`	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
`--manifest` `manifest`	The location of the Amazon S3 source manifest. Type: String Default: None Example: my-ami.manifest.xml	Yes
`--location {US \| EU}`	The location of the destination Amazon S3 bucket. Type: String Valid Values: `US` \| `EU` Default: US Example: EU	No
`--acl` `acl`	The access control list policy of the bundled image. Type: String Valid Values: `public-read` \| `aws-exec-read` Default: None Example: public-read	Yes
`--kernel`	The ID of the kernel to select. Type: String Default: None Example: aki-ba3adfd3	No
`--ramdisk`	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, go to the Type: String Default: None Example: ari-badbad00	No
`--no-mapping`	Disables automatic mapping of kernels and RAM disks. Type: String Default: Mapping is enabled. Example: my-ami.manifest.xml	No
`--region` `region`	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

Output

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.

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 --access-key AKIADQKE4SARGYLE --secret-key eW91dHViZS5jb20vd2F0Y2g/dj1SU3NKMTlzeTNKSQ== --bucket my-us-bucket --destination-bucket my-eu-bucket --manifest my-ami.manifest.xml --location EU
Copying '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

ec2-migrate-image