Euca2ools Guide / EC2-Compatible Commands |
Show information about instance status and scheduled events.
euca-describe-instance-status [--hide-healthy] [--include-all-instances] [--show-empty-fields] [-U URL] [--region USER@REGION] [-I KEY_ID] [-S KEY] [--security-token TOKEN] [--filter name=value] [--debug] [--debugger] [--version] [-h] [instance_id [instance_id ...]]
Option | Description | Required |
---|---|---|
instance_id | Limit results to the specified instance(s). | No |
--hide-healthy | Hide instances where all status checks pass | No |
--include-all-instances | Show all instances, not just those that are running. | No |
--filter name=value | Restrict results to those that meet the specified filter criteria (see below). | 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 |
You can add filters to your request so that the response includes information for only certain instances. For example, you can use a filter to specify that you want to find instances launched with a specific status. Some tips for using filters with this command:
The following are the available filters for euca-describe-instance-status:
Filter | Description |
---|---|
availability-zone | Availability zone of the instance |
event.code | Code identifying the type of event |
event.description | Description of the event. |
event.not-after | Event's latest possible end time |
event.not-before | Event's earliest possible start time |
instance-state-code | Numeric code identifying instance state |
instance-state-name | Instance state |
instance-status.status | Instance's status |
instance-status.reachability | Instance's reachability status |
system-status.status | Instance's system status |
system-status.reachability | Public DNS name of the instance. |
group-id | Instance's system reachability status |
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. |
The following example shows the request and output for a simple command.
euca-describe-instance-status INSTANCE i-65c77b9e one running 16 ok ok active SYSTEMSTATUS reachability passed INSTANCESTATUS reachability passed