AWS ARN Parser & Builder
Parse AWS ARN strings into their component parts or build valid ARNs from individual fields.
About This Tool
The AWS ARN Parser is a free browser-based tool that breaks down Amazon Resource Name (ARN) strings into their individual components: partition, service, region, account ID, resource type, and resource ID. It also includes a builder mode that lets you construct valid ARNs from individual fields, which is helpful when writing IAM policies, CloudFormation templates, or CLI commands.
ARNs follow the format arn:partition:service:region:account-id:resource,
but the resource portion varies by service — some use a slash separator
(resource-type/resource-id), others use a colon
(resource-type:resource-id), and some services like S3 omit the region
and account ID entirely. This tool handles all of these variations
automatically and explains each component with contextual descriptions.
If you work with AWS IAM policies and need to format JSON, try the JSON Formatter. For converting between YAML and JSON in CloudFormation templates, the YAML Formatter is useful. And if you need to convert JSON configuration to YAML, check out the JSON to YAML Converter.
The common ARN patterns reference table shows formats for 15 popular AWS services, with one-click "Try it" buttons that auto-populate the parser. This makes it easy to learn ARN formats for services you are less familiar with.
All processing runs entirely in your browser. Your ARN strings are never sent to any server, making this tool safe to use with production account IDs, resource names, and sensitive identifiers.
How to Use
- Select Parse ARN mode (default) or Build ARN mode using the toggle buttons at the top.
- In Parse mode, paste an AWS ARN string into the ARN Input text area (e.g.,
arn:aws:s3:::my-bucket). - Click Parse or press Ctrl+Enter to break the ARN into its component parts.
- Review the parsed components table showing partition, service, region, account ID, resource type, and resource ID with descriptions.
- Use the Visual Breakdown section to see each component color-coded in the original ARN string.
- In Build mode, fill in the individual fields (partition, service, region, account ID, resource type, resource ID) and the tool generates the ARN string in real time.
- Click Copy or press Ctrl+Shift+C to copy the ARN to your clipboard. Use the Common ARN Patterns table to explore formats for popular AWS services.
Popular AWS ARN Examples
FAQ
What is an AWS ARN?
An Amazon Resource Name (ARN) is a unique identifier for AWS resources. ARNs follow the format arn:partition:service:region:account-id:resource and are used in IAM policies, API calls, CloudFormation templates, and CLI commands to specify exactly which resource is being referenced.
Why do some ARNs have empty region or account ID fields?
Some AWS services are global and not tied to a specific region (like IAM and S3). For these services, the region and/or account ID fields are left empty in the ARN. For example, S3 bucket ARNs look like arn:aws:s3:::bucket-name with both region and account ID empty, because S3 bucket names are globally unique.
What is the difference between / and : as resource separators?
AWS services use two different conventions to separate the resource type from the resource ID. Most services use a slash (/) — for example, arn:aws:iam::123456789012:user/johndoe. Some services use a colon (:) — for example, arn:aws:lambda:us-east-1:123456789012:function:my-function. The parser handles both formats automatically.
What are the AWS partitions?
AWS has three partitions: 'aws' for standard commercial regions, 'aws-cn' for China regions (Beijing and Ningxia), and 'aws-us-gov' for GovCloud (US) regions. The partition is the first component after 'arn:' and determines which set of AWS endpoints and services are available.
Can I parse multiple ARNs at once?
Currently the tool parses one ARN at a time. To parse multiple ARNs, paste each one individually. The parser processes the input instantly, so switching between ARNs is fast. You can also use the 'Try it' buttons in the Common ARN Patterns table to quickly load examples.
Is my data safe?
Yes. All ARN parsing and building runs entirely in your browser using JavaScript. No data is sent to any server. Your account IDs, resource names, and ARN strings remain on your machine. You can verify this by checking the Network tab in your browser's developer tools.
Does the tool validate ARN correctness?
The tool validates the basic ARN structure (starts with 'arn:', has the correct number of colon-separated segments, and has non-empty partition and service fields). It does not validate whether the specific resource actually exists in your AWS account or whether the region/service combination is valid.
Related Tools
AWS IAM Policy Generator
Generate AWS IAM policy JSON documents from a visual form. Select services, actions, resources, and conditions with common policy templates.
AWS S3 URL Parser
Parse AWS S3 URLs into bucket, key, region, and URL style. Build S3 URLs from components. Supports virtual-hosted, path-style, s3://, and ARN formats.
AWS CLI Command Builder
Build AWS CLI commands visually. Select service, operation, fill in parameters, and generate ready-to-use aws commands with syntax highlighting.
JSON Formatter
Format, validate, and beautify JSON with syntax highlighting and tree view.
YAML Formatter
Format, validate, and minify YAML with customizable indentation and syntax error display.