Amazon Elastic Compute Cloud
API Reference (API Version 2013-02-01)
AWS Documentation » Amazon EC2 » API Reference » Actions » ImportVolume
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Did this page help you?  Yes | No |  Tell us about it...

ImportVolume

Description

Creates a new import volume task using metadata from the specified disk image. After importing the image, you then upload it using the ec2-upload-disk-image command in the EC2 command line tools. 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.

Request Parameters

AvailabilityZone

The Availability Zone for the resulting Amazon EBS volume.

Type: String

Default: None

Required: Yes

Image.Format

The file format of the disk image.

Type: String

Default: None

Valid values: VMDK | RAW | VHD

Required: Yes

Image.Bytes

The number of bytes in the disk image.

Type: Long

Default: None

Required: Yes

Image.ImportManifestUrl

The manifest for the disk image, stored in Amazon S3 and presented here as an Amazon S3 presigned URL. For information about creating a presigned URL for an Amazon S3 object, read the "Signing and Authenticating REST Requests" section of the Signing and Authenticating REST Requests topic in the Amazon Simple Storage Service Developer Guide.

Type: String

Default: None

Required: Yes

Description

An optional description of the volume being imported.

Type: String

Default: None

Required: No

Volume.Size

The size, in GB (2^30 bytes), of an Amazon EBS volume to hold the converted image.

Type: Integer

Default: None

Required: Yes

Response Elements

The following elements are returned in an ImportVolumeResponse element.

conversionTask

Information about the import volume task.

Type: ConversionTaskType

Examples

Example Request

This example creates an import volume task that migrates a Windows Server 2008 SP2 (32-bit) volume into the AWS us-east-1 region.

https://ec2.amazonaws.com/?Action=ImportVolume
&AvailabilityZone=us-east-1c
&Image.Format=VMDK
&Image.Bytes=128696320
&Image.ImportManifestUrl=https://s3.amazonaws.com/myawsbucket/​a3a5e1b6-590d-43cc-97c1-15c7325d3f41/​Win_2008_Server_Data_Center_SP2_32-bit.​vmdkmanifest.xml?AWSAccessKeyId=​AKIAIOSFODNN7EXAMPLE&​Expires=1294855591&​Signature=5snej01TlTtL0uR7KExtEXAMPLE%3D
&VolumeSize=8
&AUTHPARAMS

Example Response

<ImportVolumeResponse xmlns="http://ec2.amazonaws.com/doc/2013-02-01/">
   <conversionTask>
     <conversionTaskId>import-i-fh95npoc</conversionTaskId>
     <expirationTime>2010-12-22T12:01Z</expirationTime>
     <importVolume>
        <bytesConverted>0</bytesConverted>
        <availabilityZone>us-east-1c</availabilityZone>
        <description/>
        <image>
            <format>VDMK</format>
            <size>128696320</size>
            <importManifestUrl>
               https://s3.amazonaws.com/myawsbucket/​a3a5e1b6-590d-43cc-97c1-15c7325d3f41/​Win_2008_Server_Data_Center_SP2_32-bit.​vmdkmanifest.xml?AWSAccessKeyId=​AKIAIOSFODNN7EXAMPLE&​Expires=1294855591&​Signature=5snej01TlTtL0uR7KExtEXAMPLE%3D
            </importManifestUrl>
            <checksum>ccb1b0536a4a70e86016b85229b5c6b10b14a4eb</checksum>
        </image>
        <volume>
           <size>8</size>
           <id>vol-34d8a2ff</id>
        </volume>
     </importVolume>
     <state>active</state>
     <statusMessage/>
  </conversionTask>
</ImportVolumeResponse>
Document Conventions« PreviousNext »
Terms of UseDid this page help you?  Yes | No |  Tell us about it...