| « PreviousNext » | |
![]() ![]() | Did this page help you? Yes | No | Tell us about it... |
Copies a bundled AMI from one region to another.
Important
This tool is replaced by ec2-migrate-image.
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, the DescribeRegions and DescribeImages operations
might be used to perform automated mappings. We recommend that you use PV-GRUB
instead of kernels and RAM disks. For more information, see
PV-GRUB: A New Amazon Kernel Image in the Amazon Elastic Compute Cloud User Guide. To get the AMI tools,
go to Amazon EC2 AMI Tools.
ec2-migrate-bundle -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 location] [--ec2cert
ec2_cert_path] [--kernel
kernel-id] [--ramdisk
ramdisk_id] [--no-mapping]
[--region mapping_region_name]
| Option | Description |
|---|---|
|
|
The path to the user's PEM-encoded RSA key file. Required: Yes Example: |
|
|
The user's PEM encoded RSA public key certificate file. Required: Yes Example: |
|
|
The AWS access key ID. Required: Yes Example: |
|
|
The AWS secret access key. Required: Yes Example: |
|
|
The source Amazon S3 bucket where the AMI is located, followed by an optional '/'-delimited path prefix. Required: Yes Example: |
|
|
The destination Amazon S3 bucket, followed by an optional '/'-delimited path prefix. If the destination bucket does not exist, it is created. Required: Yes Example: |
|
|
The location of the Amazon S3 source manifest. Default: None Required: Yes Example: |
|
|
The location of the destination Amazon S3 bucket. If the bucket exists and the location is specified, the tool exits with an error. if the specified location does not match the actual location. If the bucket exists and no location is specified, the tool uses the bucket's location. If the bucket does not exist and the location is specified, the tool creates the bucket in the specified location. If the bucket does not exist and location is not specified, the tool creates the bucket without a location constraint (in the US). Valid Values: Default: US Required: No Example: |
|
|
The access control list policy of the bundled image. Valid Values: Default:
Required: No Example: |
|
|
Automatically retries on all Amazon S3 errors, up to five times per operation. Required: No Example: |
|
|
The ID of the kernel to select. Required: No Example: |
|
|
The ID of the RAM disk to select. Note It is recommended that PV-GRUB be used instead of kernels and RAM disks. For more information, go to PV-GRUB: A New Amazon Kernel Image in the Amazon Elastic Compute Cloud User Guide. Required: No Example: |
|
|
Disables automatic mapping of kernels and RAM disks. Required: No Example:
|
|
|
Region to look up in the mapping file. If no region is specified, Amazon EC2 attempts to determine the region from the location of the Amazon S3 bucket. Required: No Example: |
Status messages describing the stages and status of the bundling process.
This example copies the AMI specified in the
my-ami.manifest.xml manifest from the US to the
EU.
$ec2-migrate-bundle --cert cert-THUMBPRINT.pem --privatekey pk-THUMBPRINT.pem --access-key AKIAIOSFODNN7EXAMPLE --secret-key wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY --bucket myawsbucket --destination-bucket myotherawsbucket --manifest my-ami.manifest.xml --location EUDownloading manifest my-ami.manifest.xml from myawsbucket to /tmp/ami-migration-my-ami.manifest.xml/my-ami.manifest.xml ... 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: myotherawsbucket/my-ami.manifest.xml