ECLAT-LSINST
NAMESYNOPSIS
DESCRIPTION
FILTERS
OUTPUT
SEE ALSO
AUTHORS
BUG REPORTS
COPYRIGHT
NAME
eclat-lsinst, eclat-describe-instances - describe available EC2 instances
SYNOPSIS
eclat lsinst [FILTER...]
eclat lsinst --help
DESCRIPTION
This command lists your EC2 instances.
FILTERS
The following
filters are defined:
architecture=i386 | x86_64
The architecture of the instance.
availability-zone=string
The availability zone of the instance.
block-device-mapping.attach-time=date
The date/time when an EBS volume was attached to the instance.
block-device-mapping.delete-on-termination=boolean
Whether the device is deleted on termination of the instance.
block-device-mapping.device-name=string
The name of the device corresponding to an Amazon EBS volume.
block-device-mapping.status=string
The status of the device.
block-device-mapping.volume-id=string
The volume ID of the EBS volume.
client-token=string
The idempotency token provided when launching the instance.
dns-name=string
The public DNS name of the instance.
group-id=string
The ID of a EC2 security group the instance pertains to. For VPC security groups, see instance.group-id.
group-name=string
The name of a EC2 security group the instance pertains to. For VPC security groups, see instance.group-name.
image-id=string
The ID of the image used to create the instance.
instance-id=string
The ID of the instance.
instance-lifecycle=spot
Matches only Spot Instances.
instance-state-code=number
An integer code representing the state of the instance. Allowed values for number are: 0 (pending), 16 (running), 32 (shutting-down), 48 (terminated), 64 (stopping), 80 (stopped).
instance-state-name=state
The state of the instance. Allowed values for state are: pending, running, shutting-down, terminated, stopping, stopped.
instance-type=string
The type of instance (e.g., m1.small).
instance.group-id=string
The ID of a VPC security group the instance pertains to.
instance.group-name=string
Tha name of a VPC security group the instance pertains to.
ip-address=string
The public IP address of the instance.
kernel-id=string
The kernel ID.
key-name=string
The name of the key pair used when the instance was launched.
launch-index=string
The zero-based index of the instance in the launch group, if multiple instances were launched.
launch-time=date
Date/time when the instance was launched.
monitoring-state=disabled | enabled
Instance monitoring state.
owner-id=string
The ID of the instance owner.
placement-group-name=string
The name of the placement group the instance is in.
private-dns-name=string
Private DNS name of the instance.
private-ip-address=string
Private IP address of the instance.
product-code=string
The product code associated with the AMI used to launch the instance.
product-code.type=devpay | marketplace
The type of product code.
ramdisk-id=string
The ID of the RAM disk.
reason=string
The reason why the instance is in its current state.
requester-id=string
The ID of the entity that launched the instance on your behalf (for example, AWS Management Console, Auto Scaling, and so on).
reservation-id=string
The ID of the instance reservation. It is created any time an instance or a group of instances is launched. Depending on this a single reservation ID can correspond to a single or to multiple instances.
root-device-name=string
The name of the root device.
root-device-type=ebs | instance-store
The type of the root device.
source-dest-check=boolean
Indicates whether the instance performs source/destination checking. It must be false for the instance to perform NAT in a VPC.
spot-instance-request-id=string
The ID of the Spot Instance request.
state-reason-code=string
The reason code for the state change.
state-reason-message=string
A message describing the state change.
tag-key=string
The key of a tag assigned to the instance, regardless of its value. Note, that this filter works independently of the tag-value filter, i.e. tag-key=foo tag-value=bar will match all instances that have the tag foo defined as well as those that have bar as a value of any of their tags. To request instances that have the tag foo set to the value bar see the tag:KEY filter below.
tag-value=string
The value of a tag assigned to the instance, regardless of the tag’s key. See the comment above.
tag:key=string
Selects the instances having the specified tag KEY set to the value VAL.
virtualization-type=paravirtual | hvm
The virtualization type of the instance.
hypervisor=ovm | xen
The hypervisor type of the instance.
VPC
FILTERS
The following filters are valid only if using Amazon Virtual
Private Cloud:
subnet-id=string
The ID of the subnet the instance is.
vpc-id=string
The ID of the VPC the instance is in.
network-interface.description=string
The description of the network interface.
network-interface.subnet-id=string
The ID of the subnet of the network interface.
network-interface.vpc-id=string
The VPC ID of the network interface.
network-interface.network-interface.id=string
The ID of the network interface.
network-interface.owner-id=string
The ID of the owner of the network interface.
network-interface.availability-zone=string
The availability zone of the network interface.
network-interface.requester-id=string
The requester ID of the network interface.
network-interface.requester-managed=boolean
Indicates whether the network interface is being managed by an AWS service (for example, AWSManagement Console, Auto Scaling, and so on).
network-interface.status=available | in-use
The status of the network interface.
network-interface.mac-address=string
The MAC address of the network interface.
network-interface-private-dns-name=string
The private DNS name of the network interface.
network-interface.source-destination-check=Boolean
Indicates whether the network interface performs source/destination checking. This value must be false if the interface is to perform NAT in a VPC.
network-interface.group-id=string
The ID of a VPC security group associated with the network interface.
network-interface.group-name=string
The name of a VPC security group associated with the network interface.
network-interface.attachment.attachment-id=string
The ID of the interface attachment.
network-interface.attachment.instance-id=string
The ID of the instance to which the network interface is attached.
network-interface.attachment.instance-owner-id=string
The owner ID of the instance to which the network interface is attached
network-interface.addresses.private-ip-address=string
The private IP address associated with the network interface.
network-interface.attachment.device-index=integer
The device index to which the network interface is attached.
network-interface.attachment.status=value
The status of the attachment. Allowed values are: attaching, attached, detaching, detached.
network-interface.attachment.attach-time=date
The time when the network interface was attached to the instance.
network-interface.attachment.delete-on-termination=boolean
Specifies whether the attachment is deleted when an instance is terminated.
network-interface.addresses.primary=boolean
Specifies whether the IP address of the network interface is the primary private IP address.
network-interface.addresses.association.public-ip=string
The ID representing the association of a VPC Elastic IP address with a network interface in a VPC.
network-interface.addresses.association.ip-owner-id=string
The owner ID of the private IP address associated with the network interface.
association.public-ip=string
The Elastic IP address bound to the network interface.
association.ip-owner-id=string
The owner of the Elastic IP address associated with the network interface.
association.allocation-id=string
The allocation ID that AWS returned when an Elastic IP address was allocated for the network interface.
OUTPUT
Each instance is described in a separate multi-line block, between the Instance: and End of instance markers. The information within that block is indented by one tab stop to improve readablility.
Each instance description is prefaced by its reservation and owner IDs and a list of groups it pertains to. For example:
Reservation ID:
r-0ece705a
Owner ID: 053230519467
Groups:
Instance: i-7a00642e
Image ID: ami-1cd4924e |
|||
State: running |
|||
Kernel ID: |
|||
Architecture: x86_64 |
|||
Private DNS: |
|||
Public DNS: |
|||
Key: VPCKey |
|||
Type: c1.medium |
|||
Launch Time: 2012-06-28T17:41:48.000Z |
|||
Availability Zone: ap-southeast-1b |
|||
Group Name: |
|||
Tenancy: default |
|||
Private IP: 10.0.0.12 |
|||
Public IP: 46.51.219.63 |
|||
Groups: |
|||
sg-374b565b -- quick-start-3 | |||
Root Device Type: ebs |
|||
Root Device Name: /dev/sda1 |
|||
Device mapping: |
|||
/dev/sda1 vol-9e151bfc attached 2012-06-28T17:42:05.000Z true | |||
Virtualization: hvm |
|||
Tag Set: |
|||
Name=SingleENI | |||
Hypervisor: xen |
|||
EBS Optimized: |
End of instance
SEE ALSO
eclat(1), eclat-lsiattr(1), eclat-reboot(1), eclat-start(1), eclat-stop(1).
AUTHORS
Sergey Poznyakoff
BUG REPORTS
Report bugs to <bug-eclat@gnu.org.ua>.
COPYRIGHT
Copyright
© 2012-2018 Sergey Poznyakoff
License GPLv3+: GNU GPL version 3 or later
<http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and
redistribute it. There is NO WARRANTY, to the extent
permitted by law.
Manpage server at man.gnu.org.ua.
Powered by mansrv 1.1