https://github.com/baccenfutter/awsamigo
Python package for quick and easy lookup of AWS AMI images.
https://github.com/baccenfutter/awsamigo
ami aws find finder lookup python python-package python-script python2 python3 search
Last synced: 2 months ago
JSON representation
Python package for quick and easy lookup of AWS AMI images.
- Host: GitHub
- URL: https://github.com/baccenfutter/awsamigo
- Owner: baccenfutter
- License: apache-2.0
- Created: 2018-07-09T21:48:30.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2018-07-10T09:16:24.000Z (over 7 years ago)
- Last Synced: 2025-02-18T19:42:39.480Z (about 1 year ago)
- Topics: ami, aws, find, finder, lookup, python, python-package, python-script, python2, python3, search
- Language: Python
- Size: 41 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# AWS AMIgo
Python package for quick and easy lookup of AWS AMI images.
## Installation
```bash
# For users:
pip install awsamigo
# For developers:
mkvirtualenv awsamigo # perhaps: `apt install virtualenvwrapper`, first
git clone https://github.com/baccenfutter/awsamigo
cd awsamigo
setvirtualenvproject
make install
```
## Usage
```
$ export AWS_ACCESS_KEY_ID=
$ export AWS_SECRET_ACCESS_KEY=
$ awsamigo -h
awsamigo - Quickly find the right AWS AMI ID for your instances.
Usage:
awsamigo (-h | --help)
awsamigo --version
awsamigo search [--region=]
[--image-name=]
[--arch=]
[--image-type=]
[--hypervisor=]
[--virt-type=]
[--device-type=]
[--state=]
[--description=]
awsamigo latest [--region=]
[--only-id | --only=]
[--image-name=]
[--arch=]
[--image-type=]
[--hypervisor=]
[--virt-type=]
[--device-type=]
[--state=]
[--description=]
Options:
-h --help Show this help and exit
--version Print version and exit
--region= AWS region to connect to [default: eu-west-1]
--image-name= Only lookup image-names matchin this pattern
--arch= Display only images of this architecture [default: x86_64]
--hypervisor= Display only images of this hypervisor [default: xen]
--virt-type= Display only images of this virtualization-type [default: hvm]
--device-type= Display only images with this root-device type [default: ebs]
--image-type= Display only images of this machine-type [default: machine]
--state= Display only images in this state [default: available]
--description= Display only images with this description
--only-id Display only the image-id
--only= Display only the given attribute of the found image(s)
```
## Examples
Search for all officially supported Ubuntu Xenial AMI images:
```
$ awsamigo search ubuntu --image-name ubuntu/images/*16.04*
{
"Images": [
[...]
[...]
[...]
```
Get only the `ImageId` of the latest Debian Stretch in us-west-1:
```bash
$ awsamigo latest debian \
--region=us-west-1 \
--image-name=debian-stretch* \
--only-id
ami-a126c2c2
```
Search for all Foobar AMI images inside any specific AWS account.
```bash
$ awsamigo search $YOUR_AWS_ACCOUNT_ID --image-name=foobar*
```