About this tool
AWS ARN Parser is a browser-based tool for inspecting Amazon Resource Names. It breaks an AWS ARN into its partition, service, region, account ID, resource type, resource name, and resource path so you can quickly understand which AWS resource an identifier represents.
What is an AWS ARN?
An Amazon Resource Name (ARN) is a standardized identifier used by AWS to uniquely identify resources across AWS services.
ARNs are used throughout the AWS ecosystem, including IAM policies, resource-based policies, Terraform configurations, CloudFormation templates, AWS CLI commands, SDK integrations, and automation scripts.
What does the AWS ARN Parser do?
The parser separates an ARN into its major components and displays each component individually. This makes long or unfamiliar ARNs easier to inspect and understand.
The tool also attempts to identify the resource type, resource name, and resource path based on common slash- and colon-based AWS resource formats.
- Identify the AWS partition
- Identify the AWS service
- Detect the region when present
- Extract the AWS account ID
- Inspect the resource component
- Identify a resource type when possible
- Extract a resource name
- Display the resource path
AWS ARN structure
A common ARN structure is arn:partition:service:region:account-id:resource. Some components can be empty depending on the AWS service.
For example, an S3 bucket ARN can use an empty region and account field, while an EC2 instance ARN normally includes both a region and account ID.
- arn — identifies the value as an Amazon Resource Name
- Partition — identifies the AWS partition such as aws or aws-us-gov
- Service — identifies the AWS service such as s3, iam, lambda, or ec2
- Region — identifies the AWS Region when applicable
- Account ID — identifies the owning AWS account when applicable
- Resource — identifies the specific resource
Common use cases
- Inspecting ARNs used in IAM policies
- Debugging AWS permission errors
- Reviewing Terraform resource references
- Checking CloudFormation resource identifiers
- Understanding ARNs returned by AWS APIs
- Inspecting AWS CLI and SDK configuration
- Troubleshooting resource-based policies
- Reviewing infrastructure automation scripts
Global and regional AWS resources
Not every AWS resource is associated with a Region. Some services and resource types use global identifiers, which means the region component of their ARN can be empty.
The parser displays an empty region as Global to make this distinction easier to understand. This is a presentation choice and does not mean every resource from that service is necessarily global.
Resource formats and limitations
AWS services do not all use exactly the same resource naming convention. Resource identifiers can use slashes, colons, or service-specific formats.
This parser uses the general ARN structure and common resource separators to identify resource details. It does not contain a service-specific database for every ARN format used by AWS.
A syntactically valid ARN may therefore contain a resource structure that cannot be fully interpreted by the generic parser.
Security and privacy
ARNs commonly contain AWS account IDs and infrastructure identifiers, so they should still be handled according to your organization's security policies.
ToolTunnel parses the ARN locally in your browser. The ARN does not need to be uploaded to a ToolTunnel backend for parsing.
Frequently Asked Questions
▶What is an AWS ARN?
An Amazon Resource Name (ARN) is a standardized AWS identifier used to uniquely identify a resource.
▶What are the parts of an AWS ARN?
A common ARN contains the arn prefix, partition, service, region, account ID, and resource. Some components can be empty depending on the service.
▶Can an AWS ARN have an empty region?
Yes. Some AWS resources use global identifiers and therefore do not include a Region in their ARN.
▶Does an ARN always contain an account ID?
No. Some AWS services and resource types use ARNs where the account ID component is empty.
▶Where are AWS ARNs commonly used?
ARNs are commonly used in IAM policies, Terraform, CloudFormation, AWS CLI commands, SDKs, resource policies, and automation.
▶Can this tool validate every AWS ARN?
It validates the general ARN structure and parses common components, but AWS services can use service-specific resource formats that require additional knowledge to interpret completely.
▶Does the parser contact AWS?
No. The parser performs its analysis locally and does not need to query AWS to split the ARN into its components.
▶Does an ARN contain sensitive information?
An ARN can contain information such as an AWS account ID, resource names, and infrastructure details. Treat ARNs according to your organization's security and information-sharing policies.