{"id":22671365,"url":"https://github.com/cloudforet-io/plugin-aws-ec2-inven-collector","last_synced_at":"2025-04-12T12:22:33.702Z","repository":{"id":109062700,"uuid":"532700459","full_name":"cloudforet-io/plugin-aws-ec2-inven-collector","owner":"cloudforet-io","description":"Plugin for AWS EC2","archived":false,"fork":false,"pushed_at":"2024-11-28T07:49:26.000Z","size":7009,"stargazers_count":6,"open_issues_count":1,"forks_count":5,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-03-26T07:04:22.969Z","etag":null,"topics":["collector","inventory","plugin"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cloudforet-io.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-09-05T01:11:34.000Z","updated_at":"2024-11-28T07:49:31.000Z","dependencies_parsed_at":"2024-03-21T17:53:48.792Z","dependency_job_id":null,"html_url":"https://github.com/cloudforet-io/plugin-aws-ec2-inven-collector","commit_stats":null,"previous_names":[],"tags_count":49,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudforet-io%2Fplugin-aws-ec2-inven-collector","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudforet-io%2Fplugin-aws-ec2-inven-collector/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudforet-io%2Fplugin-aws-ec2-inven-collector/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudforet-io%2Fplugin-aws-ec2-inven-collector/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cloudforet-io","download_url":"https://codeload.github.com/cloudforet-io/plugin-aws-ec2-inven-collector/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248565258,"owners_count":21125442,"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":["collector","inventory","plugin"],"created_at":"2024-12-09T16:14:42.565Z","updated_at":"2025-04-12T12:22:33.680Z","avatar_url":"https://github.com/cloudforet-io.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003eAWS EC2 Instance Collector\u003c/h1\u003e  \n\n\u003cbr/\u003e  \n\u003cdiv align=\"center\" style=\"display:flex;\"\u003e  \n  \u003cimg width=\"245\" src=\"https://spaceone-custom-assets.s3.ap-northeast-2.amazonaws.com/console-assets/icons/aws-cloudservice.svg\"\u003e\n  \u003cp\u003e \n    \u003cbr\u003e\n    \u003cimg alt=\"Version\"  src=\"https://img.shields.io/badge/version-1.14.3-blue.svg?cacheSeconds=2592000\"  /\u003e    \n    \u003ca href=\"https://www.apache.org/licenses/LICENSE-2.0\"  target=\"_blank\"\u003e\u003cimg alt=\"License: Apache 2.0\"  src=\"https://img.shields.io/badge/License-Apache 2.0-yellow.svg\" /\u003e\u003c/a\u003e \n  \u003c/p\u003e \n\u003c/div\u003e    \n\n**Plugin to collect EC2 information**\n\n\u003e SpaceONE's [plugin-aws-ec2-inven-collector](https://github.com/spaceone-dev/plugin-aws-ec2-inven-collector) is a convenient tool to get EC2 resources information from AWS.\n\n\nFind us also at [Dockerhub](https://hub.docker.com/repository/docker/spaceone/plugin-aws-ec2-inven-collector)\n\u003e Latest stable version : 1.14.3\n\nPlease contact us if you need any further information. (\u003csupport@spaceone.dev\u003e)\n\n---\n\n## AWS Service Endpoint (in use)\n\n There is an endpoints used to collect AWS resources information.\nAWS endpoint is a URL consisting of a region and a service code. \n\u003cpre\u003e\nhttps://ec2.[region-code].amazonaws.com\nhttps://autoscaling.[region-code].amazonaws.com\nhttps://elbv2.[region-code].amazonaws.com\n\u003c/pre\u003e\n\nWe use a lots of endpoints because we collect information from many regions.  \n\n### Region list\n\nBelow is the AWS region information.\nThe regions we collect are not all regions supported by AWS. Exactly, we target the regions results returned by [describe_regions()](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/ec2.html#EC2.Client.describe_regions) of AWS ec2 client.\n\n|No.|Region name|Region Code|\n|---|------|---|\n|1|US East (Ohio)|us-east-2|\n|2|US East (N. Virginia)|us-east-1|\n|3|US West (N. California)|us-west-1|\n|4|US West (Oregon)|us-west-2|\n|5|Asia Pacific (Mumbai)|ap-south-1|\n|6|Asia Pacific (Osaka)|ap-northeast-3|\n|7|Asia Pacific (Seoul)|ap-northeast-2|\n|8|Asia Pacific (Singapore)|ap-southeast-1|\n|9|Asia Pacific (Sydney)|ap-southeast-2|\n|10|Asia Pacific (Tokyo)|ap-northeast-1|\n|11|Canada (Central)|ca-central-1|\n|12|Europe (Frankfurt)|eu-central-1|\n|13|Europe (Ireland)|eu-west-1|\n|14|Europe (London)|eu-west-2|\n|15|Europe (Paris)|eu-west-3|\n|16|Europe (Stockholm)|eu-north-1|\n|17|South America (São Paulo)|sa-east-1|\n\n---\n\n### Service list\n\nThe following is a list of services being collected and service code information.\n\n|No.|Service name|Service Code|\n|---|------|---|\n|1|EC2 Instance|AmazonEC2|\n\n---\n## Authentication Overview\n\nRegistered service account on SpaceONE must have certain permissions to collect cloud service data Please, set\nauthentication privilege for followings:\n\n\u003cpre\u003e\n\u003ccode\u003e\n{\n    \"Version\": \"2012-10-17\",\n    \"Statement\": [\n        {\n            \"Action\": [\n                \"autoscaling:Describe*\",\n                \"ec2:Describe*\",\n                \"elasticloadbalancing:Describe*\"\n            ],\n            \"Effect\": \"Allow\",\n            \"Resource\": \"*\"\n        }\n    ]\n}\n\u003c/code\u003e\n\u003c/pre\u003e\n\n\n---\n## API List for collecting resources\n\n### Boto3 info\n\n* [describe_regions](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/ec2.html#EC2.Client.describe_regions)\n* [describe_instances](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/ec2.html#EC2.Client.describe_instances)\n* [describe_instance_types](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/ec2.html#EC2.Client.describe_instance_types)\n* [describe_instance_attribute](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/ec2.html#EC2.Client.describe_instance_attribute)\n* [describe_auto_scaling_groups](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/autoscaling.html#AutoScaling.Client.describe_auto_scaling_groups)\n* [describe_launch_configurations](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/autoscaling.html#AutoScaling.Client.describe_launch_configurations)\n* [describe_launch_templates](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/ec2.html#EC2.Client.describe_launch_templates)\n* [describe_load_balancers](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/elbv2.html#ElasticLoadBalancingv2.Client.describe_load_balancers)\n* [describe_target_groups](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/elbv2.html#ElasticLoadBalancingv2.Client.describe_target_groups)\n* [describe_listeners](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/elbv2.html#ElasticLoadBalancingv2.Client.describe_listeners)\n* [describe_target_health](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/elbv2.html#ElasticLoadBalancingv2.Client.describe_target_health)\n* [describe_security_groups](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/ec2.html#EC2.Client.describe_security_groups)\n* [describe_subnets](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/ec2.html#EC2.Client.describe_subnets)\n* [describe_vpcs](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/ec2.html#EC2.Client.describe_vpcs)\n* [describe_volumes](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/ec2.html#EC2.Client.describe_volumes)\n* [describe_images](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/ec2.html#EC2.Client.describe_images)\n* [describe_addresses](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/ec2.html#EC2.Client.describe_addresses)\n* [get_caller_identity](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sts.html#STS.Client.get_caller_identity)\n* [assume_role](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sts.html#STS.Client.assume_role)\n\n---\n\n# Release Note\n\n## Version 1.14.3\nFIX BUG: [Links in Security Group do not work](https://github.com/cloudforet-io/plugin-aws-ec2-inven-collector/issues/11)\n\n## Version 1.12.1\nRemove region filter in secret_data. It is not used.\n\n## Version 1.3.1\nSupport collect Large Capacity of EC2s (More than 2k) \n* Handling API 'rate exceeded'\n* Default maximum number of retries has set to handle up to 10k APIs\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudforet-io%2Fplugin-aws-ec2-inven-collector","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcloudforet-io%2Fplugin-aws-ec2-inven-collector","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudforet-io%2Fplugin-aws-ec2-inven-collector/lists"}