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
- 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.
