{"id":13514374,"url":"https://github.com/turbot/steampipe-mod-aws-tags","last_synced_at":"2025-09-25T09:40:28.406Z","repository":{"id":40419409,"uuid":"378930308","full_name":"turbot/steampipe-mod-aws-tags","owner":"turbot","description":"Is your AWS tagging strategy following best practice? This mod checks if your AWS resource tags are set correctly to help you manage them effectively using Powerpipe and Steampipe.","archived":false,"fork":false,"pushed_at":"2025-08-08T06:38:04.000Z","size":3762,"stargazers_count":19,"open_issues_count":3,"forks_count":7,"subscribers_count":9,"default_branch":"main","last_synced_at":"2025-08-11T00:51:58.079Z","etag":null,"topics":["aws","aws-tags","hacktoberfest","powerpipe","powerpipe-mod","sql","steampipe","steampipe-mod","tagging","tags"],"latest_commit_sha":null,"homepage":"https://hub.powerpipe.io/mods/turbot/aws_tags","language":"Puppet","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/turbot.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2021-06-21T12:54:49.000Z","updated_at":"2024-10-24T11:32:30.000Z","dependencies_parsed_at":"2024-03-15T06:35:16.872Z","dependency_job_id":"6967d416-1249-4f78-a88b-cca1b9d7921d","html_url":"https://github.com/turbot/steampipe-mod-aws-tags","commit_stats":null,"previous_names":[],"tags_count":18,"template":false,"template_full_name":null,"purl":"pkg:github/turbot/steampipe-mod-aws-tags","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/turbot%2Fsteampipe-mod-aws-tags","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/turbot%2Fsteampipe-mod-aws-tags/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/turbot%2Fsteampipe-mod-aws-tags/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/turbot%2Fsteampipe-mod-aws-tags/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/turbot","download_url":"https://codeload.github.com/turbot/steampipe-mod-aws-tags/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/turbot%2Fsteampipe-mod-aws-tags/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":276896555,"owners_count":25724047,"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","status":"online","status_checked_at":"2025-09-25T02:00:09.612Z","response_time":80,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["aws","aws-tags","hacktoberfest","powerpipe","powerpipe-mod","sql","steampipe","steampipe-mod","tagging","tags"],"created_at":"2024-08-01T05:00:54.851Z","updated_at":"2025-09-25T09:40:28.366Z","avatar_url":"https://github.com/turbot.png","language":"Puppet","funding_links":[],"categories":["Puppet"],"sub_categories":[],"readme":"# AWS Tags Mod for Powerpipe\n\nAn AWS tags checking tool that can be used to look for untagged resources, missing tags, resources with too many tags, and more.\n\nRun checks in a dashboard:\n\n![image](https://raw.githubusercontent.com/turbot/steampipe-mod-aws-tags/main/docs/aws_tags_dashboard.png)\n\nOr in a terminal:\n\n![image](https://raw.githubusercontent.com/turbot/steampipe-mod-aws-tags/main/docs/aws_tags_mod_terminal.png)\n\n## Documentation\n\n- **[Benchmarks and controls →](https://hub.powerpipe.io/mods/turbot/aws_tags/controls)**\n\n## Getting Started\n\n### Installation\n\nInstall Powerpipe (https://powerpipe.io/downloads), or use Brew:\n\n```sh\nbrew install turbot/tap/powerpipe\n```\n\nThis mod also requires [Steampipe](https://steampipe.io) with the [AWS plugin](https://hub.steampipe.io/plugins/turbot/aws) as the data source. Install Steampipe (https://steampipe.io/downloads), or use Brew:\n\n```sh\nbrew install turbot/tap/steampipe\nsteampipe plugin install aws\n```\n\nSteampipe will automatically use your default AWS credentials. Optionally, you can [setup multiple accounts](https://hub.steampipe.io/plugins/turbot/aws#multi-account-connections) or [customize AWS credentials](https://hub.steampipe.io/plugins/turbot/aws#configuring-aws-credentials).\n\nFinally, install the mod:\n\n```sh\nmkdir dashboards\ncd dashboards\npowerpipe mod init\npowerpipe mod install github.com/turbot/steampipe-mod-aws-tags\n```\n\n### Browsing Dashboards\n\nStart Steampipe as the data source:\n\n```sh\nsteampipe service start\n```\n\nStart the dashboard server:\n\n```sh\npowerpipe server\n```\n\nBrowse and view your dashboards at **http://localhost:9033**.\n\n### Running Checks in Your Terminal\n\nInstead of running benchmarks in a dashboard, you can also run them within your\nterminal with the `powerpipe benchmark` command:\n\nList available benchmarks:\n\n```sh\npowerpipe benchmark list\n```\n\nRun a benchmark:\n\n```sh\npowerpipe benchmark run aws_tags.benchmark.untagged\n```\n\nDifferent output formats are also available, for more information please see\n[Output Formats](https://powerpipe.io/docs/reference/cli/benchmark#output-formats).\n\n### Configure Variables\n\nSeveral benchmarks have [input variables](https://powerpipe.io/docs/build/mod-variables#input-variables) that can be configured to better match your environment and requirements. Each variable has a default defined in its source file, e.g., `controls/limit.sp`, but these can be overwritten in several ways:\n\nIt's easiest to setup your vars file, starting with the sample:\n\n```sh\ncp powerpipe.ppvars.example powerpipe.ppvars\nvi powerpipe.ppvars\n```\n\nAlternatively you can pass variables on the command line:\n\n```sh\npowerpipe benchmark run aws_tags.benchmark.mandatory --var 'mandatory_tags=[\"Application\", \"Environment\", \"Department\", \"Owner\"]'\n```\n\nOr through environment variables:\n\n```sh\nexport PP_VAR_mandatory_tags='[\"Application\", \"Environment\", \"Department\", \"Owner\"]'\npowerpipe control run aws_tags.control.ec2_instance_mandatory\n```\n\nThese are only some of the ways you can set variables. For a full list, please see [Passing Input Variables](https://powerpipe.io/docs/build/mod-variables#passing-input-variables).\n\n### Common and Tag Dimensions\n\nThe benchmark queries use common properties (like `account_id`, `connection_name` and `region`) and tags that are defined in the form of a default list of strings in the `variables.sp` file. These properties can be overwritten in several ways:\n\nIt's easiest to setup your vars file, starting with the sample:\n\n```sh\ncp powerpipe.ppvars.example powerpipe.ppvars\nvi powerpipe.ppvars\n```\n\nAlternatively you can pass variables on the command line:\n\n```sh\npowerpipe benchmark run aws_tags.benchmark.limit --var 'tag_dimensions=[\"Environment\", \"Owner\"]'\n```\n\nOr through environment variables:\n\n```sh\nexport PP_VAR_common_dimensions='[\"account_id\", \"connection_name\", \"region\"]'\nexport PP_VAR_tag_dimensions='[\"Environment\", \"Owner\"]'\npowerpipe benchmark run aws_tags.benchmark.limit\n```\n\n### Remediation\n\nUsing the control output and the AWS CLI, you can remediate various tagging issues.\n\nFor instance, with the results of the `ec2_instance_mandatory` control, you can add missing tags with the AWS CLI:\n\n```sh\n#!/bin/bash\n\nOLDIFS=$IFS\nIFS='#'\n\nINPUT=$(powerpipe control run aws_tags.control.ec2_instance_mandatory --var 'mandatory_tags=[\"Application\"]' --output csv --header=false --separator '#' | grep 'alarm')\n[ -z \"$INPUT\" ] \u0026\u0026 { echo \"No instances in alarm, aborting\"; exit 0; }\n\nwhile read -r group_id title description control_id control_title control_description reason resource status account_id region\ndo\n  aws resourcegroupstaggingapi tag-resources --region ${region} --resource-arn-list ${resource} --tags Application=MyApplication\ndone \u003c\u003c\u003c \"$INPUT\"\n\nIFS=$OLDIFS\n```\n\nTo remove prohibited tags from EC2 instances:\n\n```sh\n#!/bin/bash\n\nOLDIFS=$IFS\nIFS='#'\n\nINPUT=$(powerpipe control run aws_tags.control.ec2_instance_prohibited --var 'prohibited_tags=[\"Password\"]' --output csv --header=false --separator '#' | grep 'alarm')\n[ -z \"$INPUT\" ] \u0026\u0026 { echo \"No instances in alarm, aborting\"; exit 0; }\n\nwhile read -r group_id title description control_id control_title control_description reason resource status account_id region\ndo\n  aws resourcegroupstaggingapi untag-resources --region ${region} --resource-arn-list ${resource} --tag-keys Password\ndone \u003c\u003c\u003c \"$INPUT\"\n\nIFS=$OLDIFS\n```\n\n## Open Source \u0026 Contributing\n\nThis repository is published under the [Apache 2.0 license](https://www.apache.org/licenses/LICENSE-2.0). Please see our [code of conduct](https://github.com/turbot/.github/blob/main/CODE_OF_CONDUCT.md). We look forward to collaborating with you!\n\n[Steampipe](https://steampipe.io) and [Powerpipe](https://powerpipe.io) are products produced from this open source software, exclusively by [Turbot HQ, Inc](https://turbot.com). They are distributed under our commercial terms. Others are allowed to make their own distribution of the software, but cannot use any of the Turbot trademarks, cloud services, etc. You can learn more in our [Open Source FAQ](https://turbot.com/open-source).\n\n## Get Involved\n\n**[Join #powerpipe on Slack →](https://turbot.com/community/join)**\n\nWant to help but don't know where to start? Pick up one of the `help wanted` issues:\n\n- [Powerpipe](https://github.com/turbot/powerpipe/labels/help%20wanted)\n- [AWS Tags Mod](https://github.com/turbot/steampipe-mod-aws-tags/labels/help%20wanted)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fturbot%2Fsteampipe-mod-aws-tags","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fturbot%2Fsteampipe-mod-aws-tags","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fturbot%2Fsteampipe-mod-aws-tags/lists"}