{"id":24517770,"url":"https://github.com/fstab50/ec2tools","last_synced_at":"2026-04-16T01:33:33.234Z","repository":{"id":57425413,"uuid":"142773366","full_name":"fstab50/ec2tools","owner":"fstab50","description":"Collection of scripts for use with Amazon Web Services' EC2","archived":false,"fork":false,"pushed_at":"2021-07-06T22:32:59.000Z","size":6769,"stargazers_count":0,"open_issues_count":5,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-11-27T17:53:55.089Z","etag":null,"topics":["amazon-web-services","amazonlinux","aws","centos","ec2","redhat","redhat-enterprise-linux","ubuntu-bionic","ubuntu-xenial","ubuntu1404","ubuntu1604","ubuntu1804"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fstab50.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-07-29T15:39:30.000Z","updated_at":"2019-12-16T03:44:31.000Z","dependencies_parsed_at":"2022-08-29T22:51:09.619Z","dependency_job_id":null,"html_url":"https://github.com/fstab50/ec2tools","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/fstab50/ec2tools","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fstab50%2Fec2tools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fstab50%2Fec2tools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fstab50%2Fec2tools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fstab50%2Fec2tools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fstab50","download_url":"https://codeload.github.com/fstab50/ec2tools/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fstab50%2Fec2tools/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31867711,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-15T15:24:51.572Z","status":"ssl_error","status_checked_at":"2026-04-15T15:24:39.138Z","response_time":63,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["amazon-web-services","amazonlinux","aws","centos","ec2","redhat","redhat-enterprise-linux","ubuntu-bionic","ubuntu-xenial","ubuntu1404","ubuntu1604","ubuntu1804"],"created_at":"2025-01-22T01:35:12.012Z","updated_at":"2026-04-16T01:33:33.209Z","avatar_url":"https://github.com/fstab50.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ca name=\"top\"\u003e\u003c/a\u003e\n* * *\n# ec2tools\n* * *\n\n## Contents\n\n* [Summary](#summary)\n* [Contents](#contents)\n* [Getting Started](#getting-started)\n* [Dependencies](#dependencies)\n* [Supported Operating Systems](#supported-operating-systems)\n* [Installation](#installation)\n* [Instructions](#instructions)\n* [Help](#help)\n* [Author \u0026 Copyright](#author---copyright)\n* [License](#license)\n* [Disclaimer](#disclaimer)\n\n* * *\n\n## Summary\n\nScripts for use with Amazon Web Services' Elastic Compute Cluster (EC2)\n\n* [ec2tools](https://pypi.org/project/ec2tools), Version: 0.6.23\n\n[back to the top](#top)\n\n* * *\n\n## Contents\n\nCurrent Scripts contained in this version of **ec2tools**:\n\n* `machineimage` : Returns the most current Amazon Machine Image Id in a region\n\n* `profileaccount` : Profiles an AWS Account to precompile metadata in each region for use\nat a later time when provisioning EC2 instances.  Account data is saved as a local file and\ncontains regional data for:\n\n    - Subnets\n    - Security Groups\n    - SSH Keypairs\n\n[back to the top](#top)\n\n* * *\n\n## Getting Started\n\nSee the following resources before getting started:\n\n- [Amazon EC2](https://aws.amazon.com/ec2)\n- [Amazon Linux AMIs](https://aws.amazon.com/amazon-linux-ami)\n- [EC2 Developer Resources](https://aws.amazon.com/ec2/developer-resources/)\n\n[back to the top](#top)\n\n* * *\n\n## Dependencies\n\n* [Python 3.6+](https://www.python.org) is required.\n* [Amazon Web Services](https://aws.amazon.com) Account\n* An IAM user or Role with at least read-only permissions (sample IAM policy below)\n\n```json\n\n{\n    \"Version\": \"2012-10-17\",\n    \"Statement\": [\n        {\n            \"Effect\": \"Allow\",\n            \"Action\": [\n                \"ec2:Describe*\"\n            ],\n            \"Resource\": \"*\"\n        }\n    ]\n }\n\n```\n\n[back to the top](#top)\n\n* * *\n\n## Supported Operating Systems\n\nReturns most current Amazon Machine Image ID for the following Operating System Types:\n\n* [Amazon Linux 1](https://aws.amazon.com/amazon-linux-ami) 2017+\n* [Amazon Linux 2](https://aws.amazon.com/amazon-linux-2) 2018+\n* [Redhat](https://aws.amazon.com/partners/redhat/) 7.3, 7.4, 7.5\n* [Centos](https://aws.amazon.com/marketplace/seller-profile?id=16cb8b03-256e-4dde-8f34-1b0f377efe89) 6, 7\n* [Ubuntu Trusty](https://aws.amazon.com/marketplace/search/results?x=0\u0026y=0\u0026searchTerms=ubuntu+14.04) 14.04\n* [Ubuntu Xenial](https://aws.amazon.com/marketplace/pp/B01JBL2M0O?qid=1532883122707) 16.04\n* [Ubuntu Bionic](https://aws.amazon.com/marketplace/search/results?x=0\u0026y=0\u0026searchTerms=ubuntu+18.04) 18.04\n\n[back to the top](#top)\n\n* * *\n\n## Installation\n\nInstall [ec2tools](https://pypi.org/project/ec2tools) via pip:\n\n```bash\n\n$ pip install ec2tools --user\n\n```\n\n[back to the top](#top)\n\n* * *\n\n## Instructions\n\nExample cli commands for `machineimage` script\n\n::\n\n#### Return Image for a Particular Region\n\nFormat:  `json` (default)\n\n\n```bash\n    $ machineimage  --image redhat7.5  --region eu-west-1\n```\n\n[![redhat7](./assets/redhat7.5-1region.png)](https://rawgithub.com/fstab50/ec2tools/master/assets/redhat7.5-1region.png)\n\n* * *\n\n#### Return Image \u0026 Metadata for a Particular Region\n\nFormat:  `json`\n\n```bash\n    $ machineimage  --image centos7  --region eu-west-1  --details\n```\n\n[![redhat7](./assets/centos7-details.png)](https://rawgithub.com/fstab50/ec2tools/master/assets/centos7-details.png)\n\n* * *\n\n#### Return the AMI Image Ids for All Regions\n\nFormat:  `json`\n\n```bash\n    $ machineimage  --image amazonlinux1\n```\n\n[![aml1](./assets/aml1-allregions.png)](https://rawgithub.com/fstab50/ec2tools/master/assets/aml1-allregions.png)\n\n* * *\n\n#### Return the AMI Image Ids for All Regions\n\nFormat:  `text`\n\n```bash\n\n    $ machineimage   --image amazonlinux2   --format text\n\n```\n\n[![aml1](./assets/aml2-text.png)](https://images.awspros.world/ec2tools/ec2tools-metadata-text.png)\n\n[back to the top](#top)\n\n* * *\n\n## Help\n\nTo display the help menu:\n\n```bash\n    $ machineimage  --help\n```\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://rawgithub.com/fstab50/ec2tools/master/assets/help-menu.png\" alt=\"ec2tools help\"/\u003e\n\u003c/p\u003e\n\n\n[back to the top](#top)\n\n* * *\n\n## Author \u0026 Copyright\n\nAll works contained herein copyrighted via below author unless work is explicitly noted by an alternate author.\n\n* Copyright Blake Huber, All Rights Reserved.\n\n[back to the top](#top)\n\n* * *\n\n## License\n\n* Software contained in this repo is licensed under the [license agreement](./LICENSE.md).\n\n[back to the top](#top)\n\n* * *\n\n## Disclaimer\n\n*Code is provided \"as is\". No liability is assumed by either the code's originating author nor this repo's owner for their use at AWS or any other facility. Furthermore, running function code at AWS may incur monetary charges; in some cases, charges may be substantial. Charges are the sole responsibility of the account holder executing code obtained from this library.*\n\nAdditional terms may be found in the complete [license agreement](./LICENSE.md).\n\n[back to the top](#top)\n\n* * *\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffstab50%2Fec2tools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffstab50%2Fec2tools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffstab50%2Fec2tools/lists"}