CreateInstanceExportTask - Amazon Elastic Compute Cloud


Exports a running or stopped instance to an S3 bucket.

For information about the supported operating systems, image formats, and known limitations for the types of instances you can export, see Exporting an Instance as a VM Using VM Import/Export in the VM Import/Export User Guide.

Request Parameters

The following parameters are for this specific action. For more information about required and optional parameters that are common to all actions, see Common Query Parameters.


A description for the conversion task or the resource being exported. The maximum length is 255 bytes.

Type: String

Required: No


The format and location for an instance export task.

Type: ExportToS3TaskSpecification object

Required: No


The ID of the instance.

Type: String

Required: Yes


The target virtualization environment.

Type: String

Valid Values: citrix | vmware | microsoft

Required: No

Response Elements

The following elements are returned by the service.


Information about the instance export task.

Type: ExportTask object


The ID of the request.

Type: String


For information about the errors that are common to all actions, see Common Client Errors.



This example request creates an Export VM task that makes a Windows instance available as an OVA.

Sample Request &Description=Example%20for%20docs &InstanceId=i-1234567890abcdef0 &TargetEnvironment=VMWare &ExportToS3.DiskImageFormat=VMDK &ExportToS3.ContainerFormat=OVA &ExportToS3.S3bucket=my-bucket-for-exported-vm &ExportToS3.S3prefix=my-exports/ &AUTHPARAMS

Sample Response

<CreateInstanceExportTaskResponse xmlns=""> <requestId>59dbff89-35bd-4eac-99ed-be587EXAMPLE</requestId> <exportTask> <exportTaskId>export-i-1234wxyz</exportTaskId> <description>Example for docs</description> <state>active</state> <statusMessage>Running</statusMessage> <instanceExport> <instanceId>i-1234567890abcdef0</instanceId> <targetEnvironment>VMWare</targetEnvironment> </instanceExport> <exportToS3> <diskImageFormat>VMDK</diskImageFormat> <containerFormat>OVA</containerFormat> <s3Bucket>my-bucket-for-exported-vm</s3Bucket> <s3Key>my-exports/ export-i-1234wxyz.ova</s3Key> </exportToS3> </exportTask> </CreateInstanceExportTaskResponse>

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: