DescribeBundleTasks
Description
Describes current bundling tasks. For more information on bundling instances, go to the
Request Parameters
| Name | Description | Required |
|---|---|---|
|
|
Type: DescribeBundleTasksType Ancestor: None Children: |
|
|
Set of bundle tasks. Type: DescribeBundleTasksInfoType Ancestor: Children: |
|
|
Information for one bundle task. Type: DescribeBundleTasksItemType Ancestor: Children: |
|
|
The ID of the bundle task to describe. Type: xsd:string Default: If no ID is specified, all bundle tasks are described. Ancestor: Children: None |
No |
Response Elements
| Name | Description |
|---|---|
|
|
Type: DescribeBundleTasksResponseType Ancestor: None Children: |
|
The ID of the request. Type: xsd:string Ancestor: Children: None |
|
Bundle task set. Type: BundleInstanceTasksSetType Ancestor: Children: |
|
Bundle task. Type: BundleInstanceTaskType Ancestor: Children: |
|
Instance associated with this bundle task. Type: xsd:string Ancestor: Children: None |
|
Identifier for this task. Type: xsd:string Ancestor: Children: None |
|
The state of the task. Type: xsd:string Valid Values: Ancestor: Children: None |
|
The time this task started. Type: xsd:dateTime Ancestor: Children: None |
|
The time of the most recent update for the task. Type: xsd:dateTime Ancestor: Children: None |
|
Amazon S3 storage locations. Type: BundleInstanceTaskStorageType Ancestor: Children: |
|
Amazon S3 storage location. Type: BundleInstanceS3StorageType Ancestor: Children: |
|
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: Children: None |
|
Specifies the beginning of the file name of the AMI. Type: xsd:string Ancestor: Children: None |
|
The Access Key ID of the owner of the Amazon S3 bucket. Type: xsd:string Ancestor: Children: None |
|
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: Children: None |
|
The signature of the Base64 encoded JSON document. Type: xsd:string Ancestor: Children: None |
|
The level of task completion, in percent (e.g., 20%). Type: xsd:string Ancestor: Children: None |
|
If the task fails, a description of the error. Type: BundleInstanceTaskErrorType Ancestor: Children: |
|
Error code. Type: xsd:string Ancestor: Children: None |
|
Error message. Type: xsd:string Ancestor: Children: None |
Examples
Example Request
This example describes the status of the bun-57a5403e bundle task.
<DescribeBundleTasks xmlns="http://ec2.amazonaws.com/doc/2009-08-15/">
<bundlesSet>
<item>
<bundleId>bun-57a5403e</bundleId>
</item>
</bundlesSet>
</DescribeBundleTasks>
Example Response
<DescribeBundleTasksResponse xmlns="http://ec2.amazonaws.com/doc/2009-08-15/">
<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>