DescribeBundleTasks

Amazon Elastic Compute Cloud: 2009-10-31

previous page next page

DescribeBundleTasks

Description

Describes current bundling tasks. 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 describe.

Type: String

Default: If no ID is specified, all bundle tasks are described.

No

Response Elements

Name Description

DescribeBundleTasksResponseType

DescribeBundleTasksResponseType element.

Type: DescribeBundleTasksResponseType

Ancestor: None

Children: requestId, bundleInstanceTasksSet

requestId

The ID of the request.

Type: xsd:string

Ancestor: DescribeBundleTasksResponseType

Children: None

bundleInstanceTasksSet

Bundle task set.

Type: BundleInstanceTasksSetType

Ancestor: DescribeBundleTasksResponseType

Children: item

item

Bundle task.

Type: BundleInstanceTaskType

Ancestor: bundleInstanceTasksSet

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

instanceId

Instance associated with this bundle task.

Type: xsd:string

Ancestor: item

Children: None

bundleId

Identifier for this task.

Type: xsd:string

Ancestor: item

Children: None

state

The state of the task.

Type: xsd:string

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

Ancestor: item

Children: None

startTime

The time this task started.

Type: xsd:dateTime

Ancestor: item

Children: None

updateTime

The time of the most recent update for the task.

Type: xsd:dateTime

Ancestor: item

Children: None

storage

Amazon S3 storage locations.

Type: BundleInstanceTaskStorageType

Ancestor: item

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: item

Children: None

error

If the task fails, a description of the error.

Type: BundleInstanceTaskErrorType

Ancestor: item

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 describes the status of the bun-57a5403e bundle task.

https://ec2.amazonaws.com/?Action=DescribeBundleTasks&bundleId.0=bun-c1a540a8&AuthParams

Example Response

<DescribeBundleTasksResponse xmlns="http://ec2.amazonaws.com/doc/2009-10-31/">
  <bundleInstanceTasksSet>
    <item>
        <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>winami</prefix>
          </S3>
        </storage>
    </item>
  <bundleInstanceTasksSet>
</DescribeBundleTasksResponse>
previous page start next page