CancelBundleTask

Amazon Elastic Compute Cloud: 2009-04-04

previous page next page

CancelBundleTask

Description

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

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

Request Parameters

Name Description Required

BundleId

The ID of the bundle task to cancel.

Type: String

Default: None

Yes

Response Elements

Name Description

CancelBundleTaskResponse

CancelBundleTaskResponse element.

Type: CancelBundleTaskResponse

Ancestor: None

Children: requestId, bundleInstanceTask

requestId

The ID of the request.

Type: xsd:string

Ancestor: CancelBundleTaskResponse

Children: None

bundleInstanceTask

Bundle task to cancel.

Type: BundleInstanceTaskType

Ancestor: CancelBundleTaskResponse

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

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: awsAccessKeyId, bucket, prefix, uploadPolicy, and uploadPolicySignature

awsAccessKeyId

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

Type: xsd:string

Ancestor: S3

Children: None

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

uploadPolicy

An Amazon S3 upload policy that gives Amazon EC2 permission to upload items into Amazon S3 on the user's behalf. For more information on bundling in Windows, go to the

Type: xsd:string

Ancestor: S3

Children: None

uploadPolicySignature

The signature of the Base64 encoded JSON document.

Type: xsd:string

Ancestor: S3

Children: None

progress

A percentage description of the progress of the task, such as 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.

https://ec2.amazonaws.com/?Action=CancelBundleTask&BundleId=bun-cla322b9&AuthParams

Example Response

<CancelBundleTaskResponse xmlns="http://ec2.amazonaws.com/doc/2009-04-04/">
  <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