ec2-migrate-bundle
From Amazon Elastic Compute Cloud: 2009-08-15
ec2-migrate-bundle
Description
Copy a bundled AMI from one region to another. For information on regions, see
![[Note]](/ec2-clt-2009-08-15/note.png){kind=small} | Note |
|---|---|
After copying a bundled AMI to a new region, make sure to register it as a new AMI.
During migration, Amazon EC2 replaces the kernel and RAM disk in the manifest file with a kernel
and RAM disk designed for the destination region. Unless the --no-mapping parameter is given,
This tool is being deprecated and replaced by |
Syntax
ec2-migrate-bundle -K private_key
-k private_key
-c cert
-a access_key_id
-s secret_key
--bucket source_s3_bucket
--destination-bucket destination_s3_bucket
--manifest manifest_path
--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 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, go to the 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 |
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-bundle --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