Skip to content
janiko71 edited this page Nov 6, 2024 · 21 revisions

Welcome to the aws-inventory wiki!

This is a very simple wiki for my AWS inventory script.

History

This script may help some hackers trying (like me) to understand how AWS environments work, and to check the resources you have used and created. AWS Config does the same but is $#!* expensive.

First inspired from https://github.com/powerupcloud/AWSInventoryLambda but not forked because it has been too much modified. Then rewritten from scratch to be more pythonified, and then (in nov 2024) rewritten again from scratch to be more flexible and expandable.

Testers needed and wanted!

If you can use aws-inventory by testing services that are not tested yet (for budget reasons ;), you're help will be much appreciated! Contact me if you can test supported or unsupported services. You can also send reports & bugs.

What you need to know

This code is not designed to be bullet-proof.

...and?

Take care when using cost explorer; even if all functions are read only (in AWS IAM), cost explorer is not free.

Prerequisites

  • This program needs Python 3.11 or newer.
  • AWS CLI must be installed and configured on the system you want to run aws-inventory. You SHOULD use a special account with minimal rights (= those in inventory*.json files). See below.
  • Make sure that you have the latest boto3 version. Older versions may lead to signature error with the newest regions or to some malfunction. Further information here :
  • Install required Python packages:
    pip install -r requirements.txt