Amazon Elastic Compute Cloud
API Reference (API Version 2013-02-01)
« 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...

CancelExportTask

Description

Cancels an active export task. The command removes all artifacts of the export, including any partially created Amazon S3 objects. If the export task is complete or is in the process of transferring the final disk image, the command fails and returns an error.

Request Parameters

ExportTaskId

The ID of the export task.

Type: String

Default: None

Required: Yes

Response Elements

requestId

The ID of the request.

Type: xsd:string

return

Returns true if the request succeeds. Otherwise, returns an error.

Type: xsd:boolean

Examples

Example Request

This example cancels the export task with ID export-i-1234wxyz.

https://ec2.amazonaws.com/?Action=CancelExportTask
&exportTaskId=export-i-1234wxyz
&AUTHPARAMS

Example Response

<CancelExportTask xmlns="http://ec2.amazonaws.com/doc/EC2UserGuide">
<requestId>59dbff89-35bd-4eac-99ed-be587EXAMPLE</requestId>
<return>true</return>
</CancelExportTask>