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 ParametersThe 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
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.
Examples ExampleThis example request creates an Export VM task that makes a Windows instance available as an OVA.
Sample Requesthttps://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 AWS SDKs, see the following:
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4