{"id":20657783,"url":"https://github.com/boltops-tools/aws-inventory","last_synced_at":"2025-04-19T13:16:14.497Z","repository":{"id":62553850,"uuid":"113206519","full_name":"boltops-tools/aws-inventory","owner":"boltops-tools","description":"aws inventory tool","archived":false,"fork":false,"pushed_at":"2022-02-08T03:31:01.000Z","size":81,"stargazers_count":47,"open_issues_count":4,"forks_count":18,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-05-01T11:29:03.172Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/boltops-tools.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-12-05T16:30:43.000Z","updated_at":"2023-04-11T19:27:00.000Z","dependencies_parsed_at":"2022-11-03T04:45:30.137Z","dependency_job_id":null,"html_url":"https://github.com/boltops-tools/aws-inventory","commit_stats":null,"previous_names":["tongueroo/aws-inventory"],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boltops-tools%2Faws-inventory","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boltops-tools%2Faws-inventory/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boltops-tools%2Faws-inventory/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boltops-tools%2Faws-inventory/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/boltops-tools","download_url":"https://codeload.github.com/boltops-tools/aws-inventory/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224954294,"owners_count":17397843,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-16T18:23:09.297Z","updated_at":"2024-11-16T18:23:09.986Z","avatar_url":"https://github.com/boltops-tools.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AWS Inventory\n\n[![BoltOps Badge](https://img.boltops.com/boltops/badges/boltops-badge.png)](https://www.boltops.com)\n\nAWS Inventory tool. Useful to get summarized information on AWS account.  The tool by default produces a report that can easily be read from a terminal, but it can also be used produce a tab separated output report that can be pasted into a spreadsheet and then copied to a report.  This is controlled via a `AWS_INVENTORY_FORMAT` env variable and covered in the Format Options section.\n\n## Usage\n```sh\naws-inventory acm             # report acm inventory\naws-inventory cfn             # report cfn inventory\naws-inventory cw              # report cloudwatch inventory\naws-inventory eb              # report eb inventory\naws-inventory ec2             # report ec2 inventory\naws-inventory ecs             # report ecs inventory\naws-inventory elb             # report elb inventory\naws-inventory iam             # report iam inventory\naws-inventory keypair         # report keypair inventory\naws-inventory rds             # report rds inventory\naws-inventory route53         # report route53 inventory\naws-inventory sg              # report security group inventory\naws-inventory vpc             # report vpc inventory\n```\n\n## Example\n\nWhat the output looks something like:\n\n```sh\n$ aws-inventory ec2\n+-------+-------------+---------------+----------+-----------------+\n| Name  | Instance Id | Instance Type | Platform | Security Groups |\n+-------+-------------+---------------+----------+-----------------+\n| name1 | i-123       | m3.medium     | linux    | sg-123          |\n| name2 | i-456       | t2.small      | linux    | sg-456          |\n+-------+-------------+---------------+----------+-----------------+\n$\n```\n\nIf you want to copy this to an spreadsheet, you can use the tab format.  Here's an example with `pbcopy`:\n\n```sh\nexport AWS_INVENTORY_FORMAT=tab\naws-inventory ec2 | pbcopy\n```\n\n### To Check Every Region for EC2 Instances\n\n```sh\nGREEN='\\033[0;32m'\nNC='\\033[0m' # No Color\nfor i in $(aws ec2 describe-regions | jq -r '.Regions[].RegionName') ; do\n  echo -e \"$GREEN$i$NC\"\n  AWS_REGION=$i aws-inventory ec2\ndone\n```\n\n### Format Option\n\nThere are a few supported formats: tab, table and json.  The default is table.  To switch between formats use the AWS_INVENTORY_FORMAT environment variable.\n\n```sh\nexport AWS_INVENTORY_FORMAT=tab\naws-inventory ec2\nexport AWS_INVENTORY_FORMAT=table\naws-inventory ec2\nexport AWS_INVENTORY_FORMAT=json\naws-inventory ec2\n```\n\n## Install\n\n```sh\ngem install aws-inventory\n```\n\n## Contributing\n\nI love pull requests! Happy to answer questions to help.\n\n1. Fork it\n2. Create your feature branch (`git checkout -b my-new-feature`)\n3. Commit your changes (`git commit -am 'Add some feature'`)\n4. Push to the branch (`git push origin my-new-feature`)\n5. Create new Pull Request\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fboltops-tools%2Faws-inventory","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fboltops-tools%2Faws-inventory","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fboltops-tools%2Faws-inventory/lists"}