DescribeBundleTasks

Amazon Elastic Compute Cloud: 2009-04-04

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

DescribeBundleTasksResponse

DescribeBundleTasksResponse element.

Type: DescribeBundleTasksResponse

Ancestor: None

Children: requestId, bundleInstanceTasksSet

requestId

The ID of the request.

Type: xsd:string

Ancestor: DescribeBundleTasksResponse

Children: None

bundleInstanceTasksSet

Bundle task set.

Type: BundleInstanceTasksSetType

Ancestor: DescribeBundleTasksResponse

Children: bundleInstanceTask

bundleInstanceTask

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: 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 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-04-04/">
  <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