1EUCA-DESCRIBE-INSTANCES(1)       User Commands      EUCA-DESCRIBE-INSTANCES(1)
2
3
4

NAME

6       euca-describe-instances - Show information about instances
7

SYNOPSIS

9       euca-describe-instances [--show-empty-fields] [-U URL]
10
11       [--region USER@REGION] [-I KEY_ID] [-S KEY]
12              [--security-token   TOKEN]   [--filter   NAME=VALUE]   [--debug]
13              [--debugger] [--version] [-h] [INSTANCE [INSTANCE ...]]
14

DESCRIPTION

16       Show information about instances
17
18   positional arguments:
19       INSTANCE
20              limit results to specific instances
21
22   optional arguments:
23       --show-empty-fields
24              show empty values as "(nil)"
25
26       -U URL, --url URL
27              compute service endpoint URL
28
29       --region USER@REGION
30              region and/or user names to search when looking up  config  file
31              data
32
33       -I KEY_ID, --access-key-id KEY_ID
34
35       -S KEY, --secret-key KEY
36
37       --security-token TOKEN
38
39       --filter NAME=VALUE
40              restrict results to those that meet criteria
41
42       --debug
43              show debugging output
44
45       --debugger
46              launch interactive debugger on error
47
48       --version
49              show the program's version and exit
50
51       -h, --help
52              show this help message and exit
53
54   allowed filter names:
55       architecture
56              CPU architecture
57
58       association.allocation-id
59              [VPC  only] allocation ID bound to a network interface's elastic
60              IP address
61
62       association.association-id
63              [VPC only] association ID returned when an elastic IP was  asso‐
64              ciated with a network interface
65
66       association.ip-owner-id
67              [VPC  only] ID of the owner of the elastic IP address associated
68              with a network interface
69
70       association.public-ip
71              [VPC only] address of the elastic IP address bound to a  network
72              interface   availability-zone   block-device-mapping.attach-time
73              volume attachment time
74
75       block-device-mapping.delete-on-termination
76              whether a volume is deleted upon instance termination
77
78       block-device-mapping.device-name
79              volume device name (e.g.  /dev/sdf)
80
81       block-device-mapping.status
82              volume status
83
84       block-device-mapping.volume-id
85              volume ID
86
87       client-token
88              idempotency token provided at instance run time
89
90       dns-name
91              public DNS name
92
93       group-id
94              security group ID
95
96       group-name
97              security group name
98
99       hypervisor
100              hypervisor type
101
102       iam-instance-profile.arn
103              ARN of the instance's instance profile
104
105       image-id
106              machine image ID
107
108       instance.group-id
109              security group ID
110
111       instance.group-name
112              security group name  instance-id  instance-lifecycle     whether
113              this is a spot instance instance-state-code   numeric code iden‐
114              tifying  instance  state  instance-state-name    instance  state
115              instance-type  ip-address            public IP address kernel-id
116              kernel image ID key-name              key pair name provided  at
117              instance launch time launch-index          launch index within a
118              reservation launch-time           instance launch time  monitor‐
119              ing-state       monitoring  state ("enabled" or "disabled") net‐
120              work-interface.addresses.association.ip-owner-id
121
122       [VPC only] ID of the owner of the private IP
123              address associated with a network interface
124
125       network-interface.addresses.association.public-ip
126              [VPC only] ID of the association of an elastic IP address with a
127              network interface
128
129       network-interface.addresses.primary
130              [VPC  only]  whether the IP address of the VPC network interface
131              is the primary private IP address ("true" or "false")
132
133       network-interface.addresses.private-ip-address
134              [VPC only] network interface's private IP address
135
136       network-interface.attachment.device-index
137              [VPC only] device index to which a network interface is attached
138
139       network-interface.attachment.attach-time
140              [VPC only] time a network interface was attached to an instance
141
142       network-interface.attachment.attachment-id
143              [VPC only] ID of a network interface's attachment
144
145       network-interface.attachment.delete-on-termination
146              [VPC only] whether a network  interface  attachment  is  deleted
147              when an instance is terminated ("true" or "false")
148
149       network-interface.attachment.instance-owner-id
150              [VPC  only]  ID  of the instance to which a network interface is
151              attached
152
153       network-interface.attachment.status
154              [VPC only] network interface's attachment status
155
156       network-interface.availability-zone
157              [VPC only] network interface's availability zone
158
159       network-interface.description
160              [VPC only] description of a network interface
161
162       network-interface.group-id
163              [VPC only] network interface's security group ID
164
165       network-interface.group-name
166              [VPC only] network interface's security group name
167
168       network-interface.mac-address
169              [VPC only] network interface's hardware address
170
171       network-interface.network-interface.id
172              [VPC only] ID of a network interface
173
174       network-interface.owner-id
175              [VPC only] ID of a network interface's owner
176
177       network-interface.private-dns-name
178              [VPC only] network interface's private DNS name
179
180       network-interface.requester-id
181              [VPC only] network interface's requester ID
182
183       network-interface.requester-managed
184              [VPC only] whether the network interface is managed by the  ser‐
185              vice
186
187       network-interface.source-destination-check
188              [VPC  only] whether source/destination checking is enabled for a
189              network interface ("true" or "false")
190
191       network-interface.status
192              [VPC only] network interface's status
193
194       network-interface.subnet-id
195              [VPC only] ID of a network interface's subnet
196
197       network-interface.vpc-id
198              [VPC only] ID of a network interface's VPC
199
200       owner-id
201              instance  owner's  account  ID   placement-group-name   platform
202              "windows"    for   Windows   instances   private-dns-name   pri‐
203              vate-ip-address product-code product-code.type     type of prod‐
204              uct code ("devpay" or "marketplace")
205
206       ramdisk-id
207              ramdisk image ID
208
209       reason reason for the instance's current state
210
211       requester-id
212              ID of the entity that launched an instance
213
214       reservation-id
215              ID of the instance's reservation
216
217       root-device-name
218              root device name (e.g.  /dev/sda1)
219
220       root-device-type
221              root     device     type     ("ebs"     or     "instance-store")
222              spot-instance-request-id state-reason-code     reason  code  for
223              the  most  recent  state  change  state-reason-message   message
224              describing the most recent state change
225
226       subnet-id
227              [VPC only] ID of the subnet the instance is in
228
229       tag-key
230              name of any tag assigned to the instance
231
232       tag-value
233              value of any tag assigned to the instance
234
235       tag:KEY
236              specific tag key/value  combination  virtualization-type  vpc-id
237              [VPC only] ID of the VPC the instance is in
238
239
240
241euca2ools 3.4                    December 2016      EUCA-DESCRIBE-INSTANCES(1)