EUCA2OOLS(1)

NAME
euca2ools - Shows information about instances.

DESCRIPTION
Shows information about instances.

euca-describe-instances [-a, --access-key <access_key> ][-s, --secret-key

    <secret_key> ][--config <config_path> ][--debug][--debugger][-h, --help][--region <region_name> ][-U, --url <url> ][--version][--eucaauth] [--filter name=value] [ instance ]

OPTIONAL PARAMETERS

-a,--access-key
    User's Access Key ID.

-s,--secret-key
    User's Secret Key.

--config
    Read credentials and cloud settings from the specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc).

--debug
    Turn on debugging output.

--debugger
    Enable interactive debugger on error

-h,--help
    Display this help message.

--region
    region to direct requests to

-U,--url
    URL of the Cloud to connect to.

--version
    Display the version of this tool.

--euca-auth
    Use NC authentication mode

AVAILABLE FILTERS

architecture
    Instance architecture. Valid values are i386 | x86_64 | armhf

availability-zone
    Instance's Availability Zone

    block-device-mapping.attach-timeAttach time for an Amazon EBS volume mapped

    to the instance

    block-device-mapping.delete-on-terminationWhether the Amazon EBS volume is deleted on

    instance termination.

    block-device-mapping.device-nameDevice name (e.g., /dev/sdh) for an Amazon EBS

volume
    mapped to the

    image.

block-device-mapping.status
    Status for an Amazon EBS volume mapped to the instance. Valid Values: attaching | attached | detaching | detached

    block-device-mapping.volume-idID for an Amazon EBS volume mapped to the

    instance.

client-token
    Idempotency token you provided when you launched the instance.

dns-name
    Public DNS name of the instance.

group-id
    A security group the instance is in.

hypervisor
    Hypervisor type of the instance. Valid values are ovm | xen.

image-id
    ID of the imageID used to launch the instance

instance-id
    ID of the instance

instance-lifecycle
    Whether this is a Spot Instance.

instance-state-code
    Code identifying the state of the instance

instance-state-name
    State of the instance.

instance-type
    Type of the instance.

ip-address
    Public IP address of the instance.

kernel-id
    Kernel ID.

key-name
    Name of the key pair used when the instance was launched.

launch-index
    When launching multiple instances at once, this is the index for the instance in the launch group

launch-time
    Time instance was launched

monitoring-state
    Whether monitoring is enabled for the instance.

owner-id
    AWS account ID of the image owner.

placement-group-name
    Name of the placement group the instance is in

platform
    Use windows if you have Windows based AMIs; otherwise leave blank.

private-dns-name
    Private DNS name of the instance.

private-ip-address
    Private ip address of the instance.

product-code
    Product code associated with the AMI.

ramdisk-id
    The ramdisk ID.

reason
    Reason for the instance's current state.

requestor-id
    ID of the entity that launched the instance on your behalf.

reservation-id
    ID of the instance's reservation.

root-device-name
    Root device name of the AMI (e.g., /dev/sda1).

root-device-type
    Root device type the AMI uses. Valid Values: ebs | instance-store.

spot-instance-request-id
    ID of the Spot Instance request.

state-reason-code
    Reason code for the state change.

state-reason-message
    Message for the state change.

subnet-id
    ID of the subnet the instance is in (VPC).

tag-key
    Key of a tag assigned to the resource.

tag-value
    Value of a tag assigned to the resource.

tag:key
    Filters the results based on a specific tag/value combination.

virtualization-type
    Virtualization type of the instance. Valid values: paravirtual | hvm

vpc-id
    ID of the VPC the instance is in.