Show information about instance status and scheduled events.


euca-describe-instance-status [--hide-healthy]
	[--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

Available Filters

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

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.


The following example shows the request and output for a simple command.

INSTANCE	i-65c77b9e	one	running	16	ok	ok	active
SYSTEMSTATUS	reachability	passed
INSTANCESTATUS	reachability	passed