EC2LISTIMG-3.13(1)

🌸 NAME 🌸

ec2listimg — list images in EC2. This is the ec2listimg-3.13(1) manual page, aka the ec2listimg() page; manual name folded in near the top like a lil name tag, because bestie we are organized. 💅

✨ SYNOPSIS ✨

ec2listimg [option]

🦋 DESCRIPTION 🦋

Okay so ec2listimg lists an image in EC2. When no filter is specified, all images in the account will be listed. It is possible to list only the image name, the image name and image id, or the complete image description. No cap, that’s the whole vibe. 😭

💖 OPTIONS 💖

• -a, --account ACCOUNT_NAME — specifies the account to use to connect to EC2. The account is specified in the config file ~/.ec2utils.conf. The account is specified as a section with [account-ACCOUNT_NAME] delimiter. The options of the sections are: access_key_id, secret_access_key, ssh_key_name, and ssh_private_key. This allows the program to connect to EC2. If access_key_id and/or secret_access_key are not found in ~/.ec2utils.conf, the search will use ACCOUNT_NAME to look for a matching section [profile ACCOUNT_NAME] in ~/.aws/config or [ACCOUNT_NAME] in ~/.aws/credentials. Only the access_key_id and secret_access_key options are used by this tool.
• --access-id AWS_ACCESS_KEY — specifies the AWS access key and overrides the value given for the account with the access_key_id in the configuration file.
• -f, --file CONFIG_FILE — specifies the configuration file to use. The default is ~/.ec2utils.conf. 🎀
• --image-id AMI_ID — specify the AMI ID of the image to be listed. This option is mutually exclusive with --image-name, --image-name-frag, and --image-name-match. It will only return a result in a specific region as image ids are unique per region. 🌍
• --image-name IMAGE_NAME — specify the name of the image to be listed. The program will look for an exact match of the name. This option is mutually exclusive with --image-id, --image-name-frag, and --image-name-match.
• --image-name-frag IMAGE_NAME_FRAGMENT — specify a section of an image name for the image(s) to be listed. Every image that matches the name fragment will be marked as listed. This option is mutually exclusive with --image-id, --image-name-name, and --image-name-match. (Yes, it says --image-name-name; I’m just holding up the mirror, bestie. 🪞)
• --image-name-match REGEX — specify a regular expression to match an image name. Every image matching the regular expression will be listed. This option is mutually exclusive with --image-id, --image-name-name, and --image-name-frag. (Typo again: --image-name-name, iconic.)
• -r, --regions EC2_REGIONS — a comma separated list of Amazon EC2 regions, or a single region. If no region argument is specified, all EC2 connected regions will be processed. EC2 disconnected regions have different API keys and thus the specified account would not work with the disconnected regions. If a disconnected region is to be processed, specify the region explicitly on the command line, and only the region of interest along with the matching account. 🗺️
• -s, --secret-key AWS_SECRET_KEY — specifies the AWS secret access key and overrides the value given for the account with the secret_access_key in the configuration file.
• --verbose — supported values are 0 (default), 1, and 2. With the default setting, the output will be the image name. Setting the verbosity to 1 will list the image name and the image id. A value of 2 will provide the full image description as it is known to EC2. 🔥
• --version — Print the version of he program. (The “he” is not a typo I invented; it’s in the original, so I’m keeping it exactly.)

🐚 EXAMPLE 🐚

ec2listimg --account example --image-name-match test --verbose 1
--region us-west-1

Will list all images in the account example that match the test in the image name in the us-west-1 region. Slay. 💅

👑 AUTHOR 👑

SUSE Public Cloud Team (public-cloud-dev@susecloud.net). Iconic. 🫶

That’s the page, bestie — footer tag ec2listimg(), manual/source version ec2listimg-3.13(1), and no date was printed on this page, so here’s your cute timestamp-free sign-off. 💖✨