Skip to main content

Dump all EC2 information to a folder suitable for version control

Project description

Dump all EC2 information to a folder suitable for version control

ec2audit can output either to stdout or to a directory, and can output in json and yaml formats. Identical data should produce identical output (suitable for diff-ing).


Currently ec2audit can dump:

  • instances

  • security groups

  • volumes.


The most basic usage is:

ec2audit <region>

However the recommended usage is to output to a directory with one item per file.

ec2audit <region> -o <output_dir>

This will create instances, security_groups, and volumes folders under the <output_dir> directory, with each instance, security group and volume represented in its own file.

You can change the output format using -f json or -f yaml. For convenience you can also do -fj or -fy.

For reference, the complete usage information is represented below:

  ec2audit [options] <region>
  ec2audit -h | --help
  ec2audit -v | --version

  -h --help                               Show this screen.
  -v --version                            Show the version.

  -o --output=OUTPUT                      The output directory, stdout otherwise
  -f --format=FORMAT                      The output format: json or yaml [default: yaml]

  -I --access-key-id=ACCESS_KEY_ID        AWS access key to use (default: $AWS_ACCESS_KEY_ID)[.
  -S --secret-key=SECRET_KEY              AWS secret key to use (default: $AWS_SECRET_ACCESS_KEY).
  -K --secret-key-file=SECRET_KEY_FILE    File containing AWS secret key to use.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ec2audit-0.2.0.tar.gz (4.7 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page