| « PreviousNext » | |
![]() ![]() | Did this page help you? Yes | No | Tell us about it... |
Copies a bundled AMI from one region to another.
Important
This tool does not work with AMIs backed by Amazon EBS.
Note
This tool replaces ec2-migrate-bundle.
The short version of this command is ec2mim.
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 |
|---|---|
|
|
The path to your PEM-encoded RSA key file. Type: String Default: Uses the Required: No |
|
|
The user's PEM encoded RSA public key certificate file. Type: String Default: Uses the Required: No Example: -C cert-HKZYKTAIG2ECMXYIBH3HXV4ZBEXAMPLE.pem |
|
|
The URL to use as the web service URL. Type: String Default: https://ec2.amazonaws.com Required: No Example: -U https://ec2.amazonaws.com |
|
|
The access key ID of the bucket owner. Type: String Default: None Required: Yes Example: -o AKIAIOSFODNN7EXAMPLE |
|
|
The secret access key of the bucket owner. Type: String Default: None Required: Yes Example: -w wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY |
|
|
The source Amazon S3 bucket where the AMI is located, followed by an optional '/'-delimited path prefix. Type: String Default: None Required: Yes Example: --bucket myawsbucket |
|
|
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 Required: Yes Example: --destination-bucket myotherawsbucket |
|
|
The location of the Amazon S3 source manifest. Type: String Default: None Required: Yes Example: --manifest my-ami.manifest.xml |
|
|
The location of the destination Amazon S3 bucket. Type: String Valid values: Default: US Required: No Example: --location EU |
|
|
The access control list policy of the bundled image. Type: String Valid values: Default: None Required: Yes Example: --acl public-read |
|
|
The ID of the kernel to select. Type: String Default: None Required: No Example: --kernel aki-ba3adfd3 |
|
|
The ID of the RAM disk to select. Important 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. Type: String Default: None Required: No Example: --ramdisk ari-badbad00 |
|
|
Disables automatic mapping of kernels and RAM disks. Type: String Default: Mapping is enabled. Required: No Example: --no-mapping |
|
|
The 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. Required: No Example: --region eu-west-1 |
| Option | Description |
|---|---|
|
|
Overrides the region specified by the Default: The value of the Example: |
|
|
The uniform resource locator (URL) of the Amazon EC2 web service entry point. Default: The value of the Example: |
|
|
The private key that identifies you to Amazon EC2. For more information, see Tell the Tools Who You Are. Default: The value of the Example: |
|
|
The X.509 certificate that identifies you to Amazon EC2. Default: The value of the Example: |
|
|
The access key ID associated with your AWS account. For more information, see Tell the Tools Who You Are. Default: The value of the Example: Note For more information, see the following section, Deprecated Options. |
|
|
The secret access key associated with your AWS account. Default: The value of the Example: Note For more information, see the following section, Deprecated Options. |
|
|
The AWS delegation token. Default: The value of the environment variable (if set). |
|
|
The connection timeout, in seconds. Example: |
|
|
The request timeout, in seconds. Example: |
|
|
Displays verbose output, including the API request and response on the command line. This is useful if you are building tools to talk directly to our Query API. |
|
|
Includes column headers in the command output. |
|
|
Shows empty columns as |
|
|
Omits tags for tagged resources. |
|
|
Displays internal debugging information. This can assist us when helping you troubleshooting problems. |
|
|
Displays usage information for the command. |
|
|
Reads arguments from standard input. This is useful when piping the output from one command to the input of another. Example: |
For a limited time, you can still use the private key and X.509 certificate instead of your access key ID and secret access key. However, we recommend that you start using your access key ID (-O, --aws-access-key) and secret access key (-W, --aws-secret-key) now, as the private key (-K, --private-key) and X.509 certificate (-C, --cert) won't be supported after the transition period elapses. For more information, see Tell the Tools Who You Are.
| Option | Description |
|---|---|
|
|
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: |
This 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.
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 --private-key pk-THUMBPRINT.pem --owner-akid AKIAIOSFODNN7EXAMPLE --owner-sak wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY --bucket myawsbucket --destination-bucket my-eu-bucket --manifest my-ami.manifest.xml --acl aws-exec-read --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
There is no underlying API action for this command.