CreateInstanceExportTask - Amazon Elastic Compute Cloud
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

CreateInstanceExportTask

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.

Description

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

Type: String

Required: No

ExportToS3

The format and location for an export instance task.

Type: ExportToS3TaskSpecification object

Required: Yes

InstanceId

The ID of the instance.

Type: String

Required: Yes

TagSpecification.N

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

Type: Array of TagSpecification objects

Required: No

TargetEnvironment

The target virtualization environment.

Type: String

Valid Values: citrix | vmware | microsoft

Required: Yes

Response Elements

The following elements are returned by the service.

exportTask

Information about the export instance task.

Type: ExportTask object

requestId

The ID of the request.

Type: String

Errors

For information about the errors that are common to all actions, see Common client error codes.

Examples

Example

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

Sample Request

https://ec2.amazonaws.com/?Action=CreateInstanceExportTask &Description=Example%20for%20docs &InstanceId=i-1234567890abcdef0 &TargetEnvironment=VMWare &ExportToS3.DiskImageFormat=VMDK &ExportToS3.ContainerFormat=OVA &ExportToS3.S3bucket=amzn-s3-demo-for-exported-vm &ExportToS3.S3prefix=my-exports/ &AUTHPARAMS

Sample Response

<CreateInstanceExportTaskResponse xmlns="http://ec2.amazonaws.com/doc/2016-11-15/"> <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>amzn-s3-demo-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 Amazon SDKs, see the following: