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