CancelBundleTask

Amazon Elastic Compute Cloud: 2009-10-31

previous page next page

CancelBundleTask

Description

Cancels an Amazon EC2 bundling operation. For more information, go to the

Amazon Elastic Compute Cloud Developer Guide or Amazon Elastic Compute Cloud Getting Started Guide.

Request Parameters

Name Description Required

CancelBundleTaskType

CancelBundleTaskType element.

Type: CancelBundleTaskType

Ancestor: None

Children: bundleId

bundleId

The ID of the bundle task to cancel.

Type: xsd:string

Default: None

Ancestor: CancelBundleTaskType

Children: None

Yes

Response Elements

Name Description

CancelBundleTaskResponseType

CancelBundleTaskResponseType element.

Type: CancelBundleTaskResponseType

Ancestor: None

Children: requestId, bundleInstanceTask

requestId

The ID of the request.

Type: xsd:string

Ancestor: CancelBundleTaskResponseType

Children: None

bundleInstanceTask

Bundle task to cancel.

Type: BundleInstanceTaskType

Ancestor: CancelBundleTaskResponseType

Children: instanceId, bundleId, state, startTime, updateTime, storage, progress, and error

instanceId

Instance associated with this bundle task.

Type: xsd:string

Ancestor: bundleInstanceTask

Children: None

bundleId

Identifier for this task.

Type: xsd:string

Ancestor: bundleInstanceTask

Children: None

state

The state of the task.

Type: xsd:string

Valid Values: pending | waiting-for-shutdown | storing | canceling | complete | failed

Ancestor: bundleInstanceTask

Children: None

startTime

The time this task started.

Type: xsd:dateTime

Ancestor: bundleInstanceTask

Children: None

updateTime

The time of the most recent update for the task.

Type: xsd:dateTime

Ancestor: bundleInstanceTask

Children: None

storage

Amazon S3 storage locations.

Type: BundleInstanceTaskStorageType

Ancestor: bundleInstanceTask

Children: S3

S3

Amazon S3 storage location.

Type: BundleInstanceS3StorageType

Ancestor: storage

Children: bucket, prefix, awsAccessKeyId, uploadPolicy, and uploadPolicySignature

bucket

The bucket in which to store the AMI. You can specify a bucket that you already own or a new bucket that Amazon EC2 creates on your behalf. If you specify a bucket that belongs to someone else, Amazon EC2 returns an error.

Type: xsd:string

Ancestor: S3

Children: None

prefix

Specifies the beginning of the file name of the AMI.

Type: xsd:string

Ancestor: S3

Children: None

awsAccessKeyId

The Access Key ID of the owner of the Amazon S3 bucket.

Type: xsd:string

Ancestor: S3

Children: None

uploadPolicy

A Base64-encoded Amazon S3 upload policy that gives Amazon EC2 permission to upload items into Amazon S3 on the user's behalf.

Type: xsd:string

Ancestor: S3

Children: None

uploadPolicySignature

The signature of the Base64 encoded JSON document.

Type: xsd:string

Ancestor: S3

Children: None

progress

The level of task completion, in percent (e.g., 20%).

Type: xsd:string

Ancestor: bundleInstanceTask

Children: None

error

If the task fails, a description of the error.

Type: BundleInstanceTaskErrorType

Ancestor: bundleInstanceTask

Children: code, message

code

Error code.

Type: xsd:string

Ancestor: error

Children: None

message

Error message.

Type: xsd:string

Ancestor: error

Children: None

Examples

Example Request

This example cancels the bun-cla322b9 bundle task.

<CancelBundleTask xmlns="http://ec2.amazonaws.com/doc/2009-10-31/">
   <bundleId>bun-cla322b9</bundleId>
</CancelBundleTask>

Example Response

<CancelBundleTaskResponse xmlns="http://ec2.amazonaws.com/doc/2009-10-31/">
  <bundleInstanceTask>
      <instanceId>i-12345678</instanceId>
      <bundleId>bun-cla322b9</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>
previous page start next page