CreateInstanceExportTask - Amazon Elastic Compute Cloud


Exports a running or stopped instance to an Amazon S3 bucket.

For information about the prerequisites for your Amazon S3 bucket, 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 characters.

Type: String

Required: No


The format and location for an export instance task.

Type: ExportToS3TaskSpecification object

Required: Yes


The ID of the instance.

Type: String

Required: Yes


The tags to apply to the export instance task during creation.

Type: Array of TagSpecification objects

Required: No


The target virtualization environment.

Type: String

Valid Values: citrix | vmware | microsoft

Required: Yes

Response Elements

The following elements are returned by the service.


Information about the export instance 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 error codes.



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: