DescribeInstanceStatus#

Description#

Request to describe the instance status. You can request the statuses of either specific or all available instances.

Request Parameters#

  • Filter.N — One or more filters.

    • Type: List of Filter objects

    • Required: No

  • InstanceId.N — The instance IDs.

    • Type: Array of strings

    • Required: No

  • IncludeAllInstances — If True, the response will include the statuses of all instances matching the request parameters. If False, the response will include statuses only for the running instances.

    • Type: Boolean

    • Valid values: True | False

    • Required: No

    • Default value: False

Supported Filters#

  • availability-zone — The name of the availability zone.

  • instance-state-code — The state of the instance, as a 16-bit unsigned integer (0 — pending | 16 — running | 32 — shutting-down | 48 — terminated | 64 — stopping | 80 — stopped).

  • instance-state-name — The instance state (pending | running | shutting-down | terminated | stopping | stopped).

Response Elements#

  • instanceStatusSet — Information about the status.

  • requestId — The request ID.

    • Type: String

Examples#

c2-ec2 DescribeInstanceStatus

c2-ec2 DescribeInstanceStatus InstanceId.1 i-01234567

c2-ec2 DescribeInstanceStatus IncludeAllInstances True

c2-ec2 DescribeInstanceStatus Filter.1.Name <filter-name> Filter.1.Value.1 <filter-value>