DescribeBundleTasks

Amazon Elastic Compute Cloud: 2009-03-01

previous page next page

DescribeBundleTasks

The DescribeBundleTasks operation describes current bundling tasks. 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 DescribeBundleTasks. Parameter names are case sensitive.

Name	Description	Required
bundleId	The ID of the bundle task to describe. If no ID is specified, all bundle tasks are described. Type: String Default: none	No

Name

Description

Required

bundleId

The ID of the bundle task to describe. If no ID is specified, all bundle tasks are described.

Type: String

Default: none

Response Elements

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

Name	Description
`requestId`	The ID of the 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: DescribeBundleTasksTaskStorageType
`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: DescribeBundleTasksTaskErrorType

Sample Request

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

Sample Response

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

Related Operations

previous page start next page