CancelBundleTask

Amazon Elastic Compute Cloud: 2008-12-01

previous page next page

CancelBundleTask

The CancelBundleTask operation cancels an Amazon EC2 bundling operation. For more information on bundling instances, see Bundling a Windows AMI.

	Note
	This operation is for Windows instances only.

Request Parameters

The following table describes the request parameters for CancelBundleTask. Parameter names are case sensitive.

Name	Description	Required
bundleId	The ID of the bundle task to cancel. Type: String Default: none	Yes

Name

Description

Required

bundleId

The ID of the bundle task to cancel.

Type: String

Default: none

Yes

Response Elements

The following table describes the default response tags included in CancelBundleTask responses.

Name	Description
`requestId`	The ID of the bundling request. Type: xsd:string
`instanceId`	Instance associated with this bundle task. Type: xsd:string
`bundleId`	Identifier for this task. Type: xsd:string
`state`	The state of the task. Options include `pending`, `waiting-for-shutdown`, `bundling`, `storing`, `canceling`, `complete`, and `failed`. Type: xsd:string
`startTime`	The time this task was created. Type: xsd:dateTime
`updateTime`	The time of the most recent update for the task. Type: xsd:dateTime
`storage`	The storage description for the task. Type: CancelBundleTaskTaskStorageType
`progress`	A percentage description of the progress of the task, such as 20%. Type: xsd:string
`error`	If a task fails, a description of the error. Type: CancelBundleTaskTaskErrorType

Sample Request

<CancelBundleTask xmlns="http://ec2.amazonaws.com/doc/2008-12-01">
   <bundleId>bun-c1a540a8</bundleId>
<CancelBundleTask>

Sample Response

<CancelBundleTaskResponse xmlns="http://ec2.amazonaws.com/doc/2008-12-01">
  <bundleInstanceTask>
      <instanceId>i-12345678</instanceId>
      <bundleId>bun-c1a540a8</bundleId>
      <state>canceling</state>
      <startTime>2008-10-07T11:41:50.000Z</startTime>
      <updateTime>2008-10-07T11:51:50.000Z</updateTime>
      <progress>20%</progress>
      <storage>
        <S3>
          <bucket>my-bucket</bucket>
          <prefix>my-new-image</prefix>
        </S3>
      </storage>
  </bundleInstanceTask>
</CancelBundleTaskResponse>

Related Operations

previous page start next page