| « PreviousNext » | |
![]() ![]() | Did this page help you? Yes | No | Tell us about it... |
Deprecated. Instead, use the ec2-import-instance and
ec2-import-volume commands (included in the command line tools as
of 2011-09-15) to create the import task and upload the image to Amazon EC2. For
more information, see Using the Command Line
Tools to Import Your Virtual Machine to Amazon EC2 in the
Amazon Elastic Compute Cloud User Guide.
Uploads the disk image associated with an import instance or an import volume task ID. Amazon EC2 supports import of VMDK, RAW, and VHD disk images.
If the upload task doesn't complete, use ec2-resume-import to resume
the import from where it was interrupted.
The short version of this command is ec2udi.
ec2-upload-disk-image -t
task_id -o owner -w
secret_key [-x days]
[--user-threads threads] [--part-size
partsize] [--dry-run] [--dont-verify-format]
disk_image
| Name | Description |
|---|---|
|
|
The local file name of the disk image that you want to upload. Type: String Default: None Required: Yes Example: WinSvr8-32-disk1.vmdk |
|
|
The conversion task ID for the upload. Type: String Default: None Required: Yes Example: -t import-i-ffvko9js |
|
|
The access key ID of the bucket owner. Type: String Default: None Required: Yes Example: AKIAIOSFODNN7EXAMPLE |
|
|
The secret access key of the bucket owner. Type: String Default: None Required: Yes Example: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY |
|
|
The validity period for the signed Amazon S3 URLs that allow Amazon EC2 to access your file. Type: String Default: 30 days Required: No Example: -x 10 |
|
|
The maximum number of threads to concurrently upload the file with. Type: String Default: 20 Required: No Example: --user-threads 15 |
|
|
The size of each individual file part (in MB) that will be
uploaded. The file will be split into multiple parts at most as
large as the Type: String Default: 8 Required: No Example: --part-size 3 |
|
|
Does not upload the file, only validates that the disk image matches a known type. Type: None Default: None Required: No Example: --dry-run |
|
|
Does not verify the file format. We don't recommend this option because it can result in a failed conversion. Type: None Default: None Required: No Example: --dont-verify-format |
| 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 the following information:
The disk image size and format
The converted volume size
The EBS volume size
The percentage of the upload completed
Amazon EC2 command line tools display errors on stderr.
This example uploads the corresponding disk image of the Windows Server 2008 (32-bit) VM you want to migrate.
PROMPT>ec2-upload-disk-image ./WinSvr8-32-disk1.vmdk -t import-i-ffvko9js -o AKIAIOSFODNN7EXAMPLE -w wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY