Describes currently submitted bundle tasks and their states.
Syntax
euca-describe-bundle-tasks [bundle ...] [[--filter "name=value"] ...]
Options
| Option |
Description |
Required |
| bundle |
Identifier of the bundle task to describe. If you do not specify
a bundle task ID, all bundle tasks are returned. |
No |
| -F, --filter name=value |
Filter for limiting the results. See the table in the Available Filters section for a
list of filters. Use quotation marks if the value has a space ("name=value example"). On a Windows system, use quotation marks even without a space in the value ("name=value"). |
No |
Available Filters
You can add filters to your request so that the response includes information for
only certain bundle tasks. For example, you can use a filter to return only the
bundle tasks in the complete state. Some tips for using filters with this
command:
- You can use multiple values for a filter. Eucalyptus responds with information
for a bundle task only if it matches at least one of the filter values that you
specified.
- You can use multiple filters. For example, you can specify bundles that are
stored in a specific bucket and are in the complete state. Eucalyptus responds
with the information for a bundle task only if it matches all the filters that
you specified. If there is no match, Eucalyptus returns an empty response.
- You can use wildcards in a filter value. Use an asterisk (*) to match zero or
more characters. Use a question mark (?) to match exactly one character. To
escape special characters, use a backslash (\) before the character. For
example, a value of \*eucalyptus\?\\ searches for the literal string
*eucalyptus?\.
The following are the available filters for
euca-describe-bundle-tasks:
| Filter |
Description |
| bundle-id |
ID of the bundle task |
| error-code |
If the task failed, returns the error code |
| error-message |
If the task failed, returns the error message |
| instance-id |
Instance ID that was bundled |
| progress |
Level of task completion, in percent (for example, 20%) |
| s3-bucket |
Bucket where the EMI will be stored |
| s3-prefix |
Beginning of the AMI name |
| start-time |
Time the task started |
| state |
State of the task |
| update-time |
Time of the most recent update for the task |
Common Options
| Option |
Description |
| --show-empty-fields |
Show empty fields as "(nil)". |
| --region user@region |
Region and/or user name to search when looking up config file data. Only valid for EC2
endpoints. |
| -U,--url url |
URL of the cloud service to connect to. For administrative commands, this should be <ip_address>:8773/services/Empyrean. |
| -I,--access-key-id key_id |
User's access key ID. |
| -S,--secret-key secret_key |
User's secret key. |
| --security-token token |
User's security token. |
| --debug |
Prints what the command sends to the server
and what it receives from the server. Use when
you're trying to debug Euca2ools. |
| --debugger |
Enable interactive debugger on error. |
| -h,--help |
Display the manual page for the
command. |
| --version |
Display the version of this tool. |
Output
- Output type identifier ("BUNDLE")
- Bundle ID
- Instance ID
- Bucket name
- Image prefix
- Start time
- Update time
- Bundle state (pending, waiting-for-shutdown, bundling, storing, cancelling,
complete, failed)
- Percentage progress, if state is "bundling"
Example
euca-describe-bundle-tasks
BUNDLE bun-CFF03DFA i-E7AC420A mah-bukkit winemi pending
2012-01-01T00:00:00.000Z 2012-01-01T00:00:00.000Z