Provided by: ec2-api-tools_1.6.12.0-0ubuntu1_all bug

NAME

       ec2-describe-instance-status  - Describe the status for instances and see if there are any
       associated events

SYNOPSIS

        ec2dins ([ec2-describe-instance-status])
        ec2dins [GENERAL OPTIONS] [-h] [INSTANCE [INSTANCE [...]]]

GENERAL NOTES

        Any command option/parameter may be passed a value of '-' to indicate
        that values for that option should be read from stdin.

DESCRIPTION

        Describe the status for one or more instances.
        Checks are performed on your instances to determine if they are
        in running order or not. Use this command to see the result of these
        instance checks so that you can take remedial action if possible.

        There are two types of checks performed: INSTANCE and SYSTEM.
        INSTANCE checks examine the health and reachability of the
        application environment. SYSTEM checks examine the health of
        the infrastructure surrounding your instance.

        How Retirement Works:
        ---------------------
        It may happen the instance host becomes unhealthy, requiring all
        instances on that host to be evicted at a future point in time.
        Your instance(s) will be marked as RETIRING, with the date of when
        they will be forcefully evicted from the host.

        Your instance will not be restarted if it is forcefully evicted from
        a retiring host. Avoid eviction by manually restarting your instance
        when it shows as RETIRING. This ensures your instance is started on
        a healthy host.

        How Events Work:
        ----------------
        An event is a reminder of an operation that will affect this instance.
        The fields NotBefore and NotAfter indicate the scheduled date that the
        event comes into effect:
         * NotBefore: the event will not occur before this time
         * NotAfter: the event will not occur after this time

GENERAL OPTIONS

        -O, --aws-access-key KEY
            AWS Access Key ID. Defaults to the value of the AWS_ACCESS_KEY
            environment variable (if set).

        -W, --aws-secret-key KEY
            AWS Secret Access Key. Defaults to the value of the AWS_SECRET_KEY
            environment variable (if set).

        -T, --security-token TOKEN
            AWS delegation token. Defaults to the value of the AWS_DELEGATION_TOKEN
            environment variable (if set).

        -K, --private-key KEY
            [DEPRECATED] Specify KEY as the private key to use. Defaults to the value of the
            EC2_PRIVATE_KEY environment variable (if set). Overrides the default.

        -C, --cert CERT
            [DEPRECATED] Specify CERT as the X509 certificate to use. Defaults to the value
            of the EC2_CERT environment variable (if set). Overrides the default.

        -U, --url URL
            Specify URL as the web service URL to use. Defaults to the value of
            'https://ec2.amazonaws.com' (us-east-1) or to that of the
            EC2_URL environment variable (if set). Overrides the default.

        --region REGION
            Specify REGION as the web service region to use.
            This option will override the URL specified by the "-U URL" option
            and EC2_URL environment variable.
            This option defaults to the region specified by the EC2_URL environment variable
            or us-east-1 if this environment variable is not set.

        -D, --auth-dry-run
            Check if you can perform the requested action rather than actually performing it.

        -v, --verbose
            Verbose output.

        -?, --help
            Display this help.

        -H, --headers
            Display column headers.

        --debug
            Display additional debugging information.

        --show-empty-fields
            Indicate empty fields.

        --hide-tags
            Do not display tags for tagged resources.

        --connection-timeout TIMEOUT
            Specify a connection timeout TIMEOUT (in seconds).

        --request-timeout TIMEOUT
            Specify a request timeout TIMEOUT (in seconds).

SPECIFIC OPTIONS

        -I, --hide-healthy
            Hide instances where all status checks pass.

        -A, --include-all-instances
            List all instances, not just those that are running.

        -F, --filter FILTER
            Add a filter criterion for the result-set.

SEE ALSO

         http://docs.amazonwebservices.com/AWSEC2/2013-10-15/CommandLineReference
         http://docs.amazonwebservices.com/AWSEC2/latest/CommandLineReference