1EUCA-DESCRIBE-IMAGES(1) User Commands EUCA-DESCRIBE-IMAGES(1)
2
3
4
6 euca-describe-images - Show information about images
7
9 euca-describe-images [-a] [-o ACCOUNT] [-x ACCOUNT]
10
11 [--show-empty-fields] [-U URL]
12 [--region USER@REGION] [-I KEY_ID] [-S KEY] [--security-token
13 TOKEN] [--filter NAME=VALUE] [--debug] [--debugger] [--version]
14 [-h] [IMAGE [IMAGE ...]]
15
17 Show information about images
18
20 By default, only images your account owns and images for which your
21 account has explicit launch permissions are shown.
22
23 positional arguments:
24 IMAGE limit results to specific images
25
26 optional arguments:
27 -a, --all
28 describe all images
29
30 -o ACCOUNT, --owner ACCOUNT
31 describe images owned by the specified owner
32
33 -x ACCOUNT, --executable-by ACCOUNT
34 describe images for which the specified account has explicit
35 launch permissions
36
37 --show-empty-fields
38 show empty values as "(nil)"
39
40 -U URL, --url URL
41 compute service endpoint URL
42
43 --region USER@REGION
44 region and/or user names to search when looking up config file
45 data
46
47 -I KEY_ID, --access-key-id KEY_ID
48
49 -S KEY, --secret-key KEY
50
51 --security-token TOKEN
52
53 --filter NAME=VALUE
54 restrict results to those that meet criteria
55
56 --debug
57 show debugging output
58
59 --debugger
60 launch interactive debugger on error
61
62 --version
63 show the program's version and exit
64
65 -h, --help
66 show this help message and exit
67
68 allowed filter names:
69 architecture
70 CPU architecture
71
72 block-device-mapping.delete-on-termination
73 whether a volume is deleted upon instance termination
74
75 block-device-mapping.device-name
76 device name for a volume mapped to the image
77
78 block-device-mapping.snapshot-id
79 snapshot ID for a volume mapped to the image
80
81 block-device-mapping.volume-size
82 volume size for a volume mapped to the image
83
84 block-device-mapping.volume-type
85 volume type for a volume mapped to the image
86
87 description
88 image description
89
90 hypervisor
91 image's hypervisor type image-id image-type image
92 type ("machine", "kernel", or "ramdisk") is-public
93 whether the image is public kernel-id manifest-location name
94 owner-alias image owner's account alias owner-id
95 image owner's account ID platform "windows" for
96 Windows images product-code product code associated
97 with the image product-code.type type of product code asso‐
98 ciated with the image ("devpay", "marketplace") ramdisk-id
99 root-device-name root-device-type root device type ("ebs"
100 or "instance-store") state image state ("avail‐
101 able", "pending", or "failed")
102
103 state-reason-code
104 reason code for the most recent state change
105
106 state-reason-message
107 message for the most recent state change
108
109 tag-key
110 key of a tag assigned to the image
111
112 tag-value
113 value of a tag assigned to the image
114
115 tag:KEY
116 specific tag key/value combination
117
118 virtualization-type
119 virtualization type ("paravirtual" or "hvm")
120
121
122
123euca2ools 3.4 December 2016 EUCA-DESCRIBE-IMAGES(1)