# Analisador de ARN da AWS

Grátis, no seu navegador · formatos de ARN de 27 serviços · funciona off-line

## Analisar um ARN

Roda no seu navegador, também off-line: o ARN não é enviado para lugar nenhum. ARNs não são secretos, mas contêm o ID da sua conta.

Screenshot: A lista de ferramentas do app, com Open by ARN em Find and open

No app CloudConsole

## Faça isso na sua própria conta

No app, o Open by ARN verifica um ARN colado ou escaneado com este mesmo analisador e depois abre o recurso na própria tela dele, mudando antes para a conta e a região certas.

[Como funciona o Open by ARN →](https://cloudconsole.dev/pt-br/help/tools)

[Baixar na App Store](https://apps.apple.com/app/cloudconsole-for-aws/id6835419710) · [Disponível no Google Play](https://play.google.com/store/apps/details?id=com.cloudconsole.app)

**Resposta curta**

Um Amazon Resource Name (ARN) tem o formato `arn:partition:service:region:account-id:resource`, por exemplo `arn:aws:sns:us-east-1:123456789012:my-topic`. A parte do recurso é um ID, ou um tipo e um ID unidos por `/` ou `:`, e alguns ARNs deixam campos vazios: ARNs do IAM não têm região, e ARNs de bucket do S3 não têm nem região nem conta.

## As partes de um ARN

ARNs identificam um recurso sem ambiguidade em toda a AWS, por isso políticas do IAM, tags de recursos e muitas chamadas de API pedem por eles. Todo ARN tem as mesmas seis partes separadas por dois-pontos, embora a parte do recurso possa conter dois-pontos e barras:

| Parte | O que é | Exemplo |
|---|---|---|
| `arn` | Prefixo literal | `arn` |
| partition | O grupo de regiões: `aws` (regiões da AWS), `aws-cn` (China), `aws-us-gov` (GovCloud US). A documentação do S3 também lista `aws-eusc` (European Sovereign Cloud). Cada conta pertence a uma partição. | `aws` |
| service | O namespace do serviço, que nem sempre é o nome do produto: o Step Functions é `states`, as regras do EventBridge são `events` e os load balancers, `elasticloadbalancing`. | `lambda` |
| region | O código da região, ou vazio para recursos globais como funções do IAM, buckets do S3, distribuições do CloudFront e zonas hospedadas do Route 53. | `us-east-2` |
| account-id | O ID de 12 dígitos da conta dona do recurso, sem hifens. Vazio para buckets e objetos do S3; `aws` para políticas gerenciadas pela AWS. | `123456789012` |
| resource | `resource-id`, `resource-type/resource-id` ou `resource-type:resource-id`. Pode incluir um recurso pai ou um qualificador, como uma versão. | `function:my-function` |

## Formatos de ARN de 27 serviços comuns da AWS

Os marcadores ficam entre `${…}`. Eles vêm da página de cada serviço na Service Authorization Reference, que lista o formato de ARN de cada tipo de recurso que você pode usar em uma política; os formatos das sessões do STS vêm da página de identificadores do IAM.

| Serviço | Recurso | Formato de ARN |
|---|---|---|
| [IAM](https://docs.aws.amazon.com/service-authorization/latest/reference/list_iam.html) | usuário | `arn:${Partition}:iam::${Account}:user/${UserNameWithPath}` |
| [IAM](https://docs.aws.amazon.com/service-authorization/latest/reference/list_iam.html) | função | `arn:${Partition}:iam::${Account}:role/${RoleNameWithPath}` |
| [IAM](https://docs.aws.amazon.com/service-authorization/latest/reference/list_iam.html) | política | `arn:${Partition}:iam::${Account}:policy/${PolicyNameWithPath}` |
| [IAM](https://docs.aws.amazon.com/service-authorization/latest/reference/list_iam.html) | grupo | `arn:${Partition}:iam::${Account}:group/${GroupNameWithPath}` |
| [IAM](https://docs.aws.amazon.com/service-authorization/latest/reference/list_iam.html) | perfil de instância | `arn:${Partition}:iam::${Account}:instance-profile/${InstanceProfileNameWithPath}` |
| [IAM](https://docs.aws.amazon.com/service-authorization/latest/reference/list_iam.html) | usuário raiz | `arn:${Partition}:iam::${Account}:root` |
| [STS](https://docs.aws.amazon.com/service-authorization/latest/reference/list_sts.html) | sessão de função assumida | `arn:${Partition}:sts::${Account}:assumed-role/${RoleName}/${RoleSessionName}` |
| [STS](https://docs.aws.amazon.com/service-authorization/latest/reference/list_sts.html) | usuário federado | `arn:${Partition}:sts::${Account}:federated-user/${FederatedUserName}` |
| [Amazon S3](https://docs.aws.amazon.com/service-authorization/latest/reference/list_s3.html) | bucket | `arn:${Partition}:s3:::${BucketName}` |
| [Amazon S3](https://docs.aws.amazon.com/service-authorization/latest/reference/list_s3.html) | objeto | `arn:${Partition}:s3:::${BucketName}/${ObjectName}` |
| [Amazon EC2](https://docs.aws.amazon.com/service-authorization/latest/reference/list_ec2.html) | instância | `arn:${Partition}:ec2:${Region}:${Account}:instance/${InstanceId}` |
| [Amazon EC2](https://docs.aws.amazon.com/service-authorization/latest/reference/list_ec2.html) | VPC | `arn:${Partition}:ec2:${Region}:${Account}:vpc/${VpcId}` |
| [Amazon EC2](https://docs.aws.amazon.com/service-authorization/latest/reference/list_ec2.html) | sub-rede | `arn:${Partition}:ec2:${Region}:${Account}:subnet/${SubnetId}` |
| [Amazon EC2](https://docs.aws.amazon.com/service-authorization/latest/reference/list_ec2.html) | grupo de segurança | `arn:${Partition}:ec2:${Region}:${Account}:security-group/${SecurityGroupId}` |
| [Amazon EC2](https://docs.aws.amazon.com/service-authorization/latest/reference/list_ec2.html) | volume do EBS | `arn:${Partition}:ec2:${Region}:${Account}:volume/${VolumeId}` |
| [Amazon EC2](https://docs.aws.amazon.com/service-authorization/latest/reference/list_ec2.html) | AMI | `arn:${Partition}:ec2:${Region}::image/${ImageId}` |
| [AWS Lambda](https://docs.aws.amazon.com/service-authorization/latest/reference/list_lambda.html) | função | `arn:${Partition}:lambda:${Region}:${Account}:function:${FunctionName}` |
| [AWS Lambda](https://docs.aws.amazon.com/service-authorization/latest/reference/list_lambda.html) | versão da função | `arn:${Partition}:lambda:${Region}:${Account}:function:${FunctionName}:${Version}` |
| [AWS Lambda](https://docs.aws.amazon.com/service-authorization/latest/reference/list_lambda.html) | alias da função | `arn:${Partition}:lambda:${Region}:${Account}:function:${FunctionName}:${Alias}` |
| [Amazon DynamoDB](https://docs.aws.amazon.com/service-authorization/latest/reference/list_dynamodb.html) | tabela | `arn:${Partition}:dynamodb:${Region}:${Account}:table/${TableName}` |
| [Amazon SQS](https://docs.aws.amazon.com/service-authorization/latest/reference/list_sqs.html) | fila | `arn:${Partition}:sqs:${Region}:${Account}:${QueueName}` |
| [Amazon SNS](https://docs.aws.amazon.com/service-authorization/latest/reference/list_sns.html) | tópico | `arn:${Partition}:sns:${Region}:${Account}:${TopicName}` |
| [Amazon RDS](https://docs.aws.amazon.com/service-authorization/latest/reference/list_rds.html) | instância de banco de dados | `arn:${Partition}:rds:${Region}:${Account}:db:${DbInstanceName}` |
| [Amazon RDS](https://docs.aws.amazon.com/service-authorization/latest/reference/list_rds.html) | cluster de banco de dados | `arn:${Partition}:rds:${Region}:${Account}:cluster:${DbClusterInstanceName}` |
| [Amazon ECS](https://docs.aws.amazon.com/service-authorization/latest/reference/list_ecs.html) | cluster | `arn:${Partition}:ecs:${Region}:${Account}:cluster/${ClusterName}` |
| [Amazon ECS](https://docs.aws.amazon.com/service-authorization/latest/reference/list_ecs.html) | service | `arn:${Partition}:ecs:${Region}:${Account}:service/${ClusterName}/${ServiceName}` |
| [Amazon ECS](https://docs.aws.amazon.com/service-authorization/latest/reference/list_ecs.html) | tarefa | `arn:${Partition}:ecs:${Region}:${Account}:task/${ClusterName}/${TaskId}` |
| [Amazon ECS](https://docs.aws.amazon.com/service-authorization/latest/reference/list_ecs.html) | definição de tarefa | `arn:${Partition}:ecs:${Region}:${Account}:task-definition/${TaskDefinitionFamilyName}:${TaskDefinitionRevisionNumber}` |
| [Amazon ECR](https://docs.aws.amazon.com/service-authorization/latest/reference/list_ecr.html) | repositório | `arn:${Partition}:ecr:${Region}:${Account}:repository/${RepositoryName}` |
| [Amazon EKS](https://docs.aws.amazon.com/service-authorization/latest/reference/list_eks.html) | cluster | `arn:${Partition}:eks:${Region}:${Account}:cluster/${ClusterName}` |
| [AWS KMS](https://docs.aws.amazon.com/service-authorization/latest/reference/list_kms.html) | chave | `arn:${Partition}:kms:${Region}:${Account}:key/${KeyId}` |
| [AWS KMS](https://docs.aws.amazon.com/service-authorization/latest/reference/list_kms.html) | alias | `arn:${Partition}:kms:${Region}:${Account}:alias/${Alias}` |
| [Secrets Manager](https://docs.aws.amazon.com/service-authorization/latest/reference/list_secretsmanager.html) | segredo | `arn:${Partition}:secretsmanager:${Region}:${Account}:secret:${SecretId}` |
| [CloudWatch Logs](https://docs.aws.amazon.com/service-authorization/latest/reference/list_logs.html) | grupo de logs | `arn:${Partition}:logs:${Region}:${Account}:log-group:${LogGroupName}` |
| [CloudWatch](https://docs.aws.amazon.com/service-authorization/latest/reference/list_cloudwatch.html) | alarme | `arn:${Partition}:cloudwatch:${Region}:${Account}:alarm:${AlarmName}` |
| [Step Functions](https://docs.aws.amazon.com/service-authorization/latest/reference/list_stepfunctions.html) | máquina de estado | `arn:${Partition}:states:${Region}:${Account}:stateMachine:${StateMachineName}` |
| [Step Functions](https://docs.aws.amazon.com/service-authorization/latest/reference/list_stepfunctions.html) | execução | `arn:${Partition}:states:${Region}:${Account}:execution:${StateMachineName}:${ExecutionId}` |
| [EventBridge](https://docs.aws.amazon.com/service-authorization/latest/reference/list_eventbridge.html) | regra (barramento padrão) | `arn:${Partition}:events:${Region}:${Account}:rule/${RuleName}` |
| [EventBridge](https://docs.aws.amazon.com/service-authorization/latest/reference/list_eventbridge.html) | regra (barramento personalizado) | `arn:${Partition}:events:${Region}:${Account}:rule/${EventBusName}/${RuleName}` |
| [EventBridge](https://docs.aws.amazon.com/service-authorization/latest/reference/list_eventbridge.html) | barramento de eventos | `arn:${Partition}:events:${Region}:${Account}:event-bus/${EventBusName}` |
| [EventBridge Scheduler](https://docs.aws.amazon.com/service-authorization/latest/reference/list_scheduler.html) | agendamento | `arn:${Partition}:scheduler:${Region}:${Account}:schedule/${GroupName}/${ScheduleName}` |
| [CloudFormation](https://docs.aws.amazon.com/service-authorization/latest/reference/list_cloudformation.html) | pilha | `arn:${Partition}:cloudformation:${Region}:${Account}:stack/${StackName}/${Id}` |
| [API Gateway](https://docs.aws.amazon.com/service-authorization/latest/reference/list_apigateway.html) | API REST | `arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}` |
| [CloudFront](https://docs.aws.amazon.com/service-authorization/latest/reference/list_cloudfront.html) | distribuição | `arn:${Partition}:cloudfront::${Account}:distribution/${DistributionId}` |
| [Route 53](https://docs.aws.amazon.com/service-authorization/latest/reference/list_route53.html) | zona hospedada | `arn:${Partition}:route53:::hostedzone/${Id}` |
| [Certificate Manager](https://docs.aws.amazon.com/service-authorization/latest/reference/list_acm.html) | certificado | `arn:${Partition}:acm:${Region}:${Account}:certificate/${CertificateId}` |
| [Elastic Load Balancing](https://docs.aws.amazon.com/service-authorization/latest/reference/list_elbv2.html) | Application Load Balancer | `arn:${Partition}:elasticloadbalancing:${Region}:${Account}:loadbalancer/app/${LoadBalancerName}/${LoadBalancerId}` |
| [Elastic Load Balancing](https://docs.aws.amazon.com/service-authorization/latest/reference/list_elbv2.html) | grupo de destino | `arn:${Partition}:elasticloadbalancing:${Region}:${Account}:targetgroup/${TargetGroupName}/${TargetGroupId}` |
| [Systems Manager](https://docs.aws.amazon.com/service-authorization/latest/reference/list_ssm.html) | parâmetro | `arn:${Partition}:ssm:${Region}:${Account}:parameter/${ParameterNameWithoutLeadingSlash}` |
| [Kinesis Data Streams](https://docs.aws.amazon.com/service-authorization/latest/reference/list_kinesis.html) | stream | `arn:${Partition}:kinesis:${Region}:${Account}:stream/${StreamName}` |

Alguns detalhes costumam confundir. ARNs de filas do SQS e de tópicos do SNS não têm tipo de recurso, só o nome. ARNs do Lambda com sufixo de versão ou alias (`:prod`, `:3`) são "qualificados" e apontam só para aquela versão. O ARN de uma definição de tarefa do ECS termina em `family:revision`. Os nomes do IAM `WithPath` incluem o caminho, então uma função de serviço fica como `role/service-role/MyRole`.

## Caminhos, curingas e ARNs incompletos

- **Caminhos.** Nomes de usuários, grupos, funções e políticas do IAM podem ter um caminho, e as chaves de objetos do S3 usam barras como pastas. Caminhos do IAM podem conter letras, números e `/ + = , . @ _ -`.
- **Curingas.** No elemento `Resource` ou `NotResource` de uma política, `*` corresponde a quaisquer caracteres e `?` a um caractere: `arn:aws:iam::123456789012:role/service-*`, `arn:aws:s3:::amzn-s3-demo-bucket/????-test`, ou `arn:aws:ec2:*:123456789012:vpc/*` para todas as VPCs de todas as regiões. Não é possível usá-los em `Principal` ou `NotPrincipal`, no tipo de recurso (`functi*`) nem na partição.
- **ARNs incompletos.** Em uma política baseada em identidade, um ARN com menos de seis partes é completado com curingas, então `arn:aws:sqs` significa `arn:aws:sqs:*:*:*`: todas as filas de todas as regiões e contas. Políticas de sessão passadas para o AssumeRole não aceitam ARNs incompletos e falham com `MalformedPolicyDocumentException`.

## Como encontrar um ARN

A maioria dos comandos `describe-`, `get-` e `list-` retorna o ARN junto com o nome, e o console o mostra na página de detalhes do recurso. Para ver a qual identidade suas credenciais da CLI pertencem, execute `aws sts get-caller-identity`: uma função assumida aparece como `arn:aws:sts::123456789012:assumed-role/RoleName/SessionName`, que é a sessão, não a própria função (`arn:aws:iam::123456789012:role/RoleName`). Use o ARN da função em políticas de confiança e de recursos.

A AWS diz que ARNs não são secretos, sensíveis nem confidenciais, mas eles revelam o ID da conta e os nomes dos recursos, então compartilhe-os com o mesmo cuidado que qualquer outro identificador.

## Fontes

- [IAM User Guide: Identify AWS resources with Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html)
- [IAM User Guide: IAM identifiers (IAM and STS ARNs)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html)
- [Service Authorization Reference: actions, resources and condition keys for each service](https://docs.aws.amazon.com/service-authorization/latest/reference/reference_policies_actions-resources-contextkeys.html)
- [Amazon S3 User Guide: General purpose bucket naming rules (partitions)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html)

## Perguntas frequentes

### Qual é o formato de um ARN da AWS?

arn:partition:service:region:account-id:resource. A parte do recurso é um ID de recurso, ou um tipo de recurso e um ID separados por barra ou dois-pontos, como role/MyRole ou function:my-function. Alguns ARNs deixam vazios a região, o ID da conta ou ambos: ARNs de bucket do S3 são como arn:aws:s3:::my-bucket.

### Por que um ARN do IAM ou do S3 tem campos vazios (:::)?

O IAM é global, então ARNs do IAM não têm região (arn:aws:iam::123456789012:role/MyRole). Nomes de bucket do S3 são únicos na partição, então ARNs de bucket e de objeto não têm nem região nem ID de conta (arn:aws:s3:::my-bucket/key).

### Um ARN é secreto?

Não. A AWS diz que ARNs não são considerados secretos, sensíveis nem confidenciais, mas, como qualquer identificador, compartilhe-os com cuidado. Um ARN contém o ID da conta e o nome do recurso.

### Posso usar curingas em um ARN?

No elemento Resource ou NotResource de uma política do IAM, sim: * corresponde a quaisquer caracteres e ? a um caractere, como em arn:aws:s3:::my-bucket/* ou arn:aws:ec2:*:123456789012:vpc/*. Não em Principal ou NotPrincipal, não no tipo de recurso (functi*) e não na partição.

### Quais são as partições da AWS?

aws para as regiões padrão da AWS, aws-cn para as regiões da China e aws-us-gov para o AWS GovCloud (US). A documentação do S3 também lista aws-eusc para a AWS European Sovereign Cloud. Uma conta pertence a uma partição.

### Como encontro o ARN da minha própria identidade do IAM?

Execute aws sts get-caller-identity. Ele retorna o ID da sua conta e o ARN do usuário ou da sessão de função assumida a que suas credenciais pertencem.

**Encontre um recurso pelo ARN**

A busca do CloudConsole encontra instâncias, funções, buckets, bancos de dados, grupos de logs, alarmes e serviços do ECS por nome, ID, ARN ou IP, em todas as suas contas e regiões, e permite copiar o ARN ou o link do console de um recurso. No iPhone e no Android.

[Sobre o app →](https://cloudconsole.dev/pt-br/aws-console-app)

## Veja também

- [AccessDeniedException: User is not authorized to perform this action because no identity-based policy allows it (EN)](https://cloudconsole.dev/errors/accessdenied-no-identity-based-policy-allows) – Correção de erro da AWS
- [AccessDenied: User is not authorized to perform: sts:AssumeRole (EN)](https://cloudconsole.dev/errors/not-authorized-to-perform-sts-assumerole) – Correção de erro da AWS
- [aws sts get-caller-identity (EN)](https://cloudconsole.dev/cli/sts-get-caller-identity) – AWS CLI
- [aws iam simulate-principal-policy (EN)](https://cloudconsole.dev/cli/iam-simulate-principal-policy) – AWS CLI
- [Gerador de expressões cron da AWS](https://cloudconsole.dev/pt-br/tools/eventbridge-cron-builder) – Ferramenta grátis
- [Verificador de nomes de bucket do S3](https://cloudconsole.dev/pt-br/tools/s3-bucket-name-checker) – Ferramenta grátis

---

Source: https://cloudconsole.dev/pt-br/tools/arn-parser

CloudConsole is an independent iPhone and Android app for Amazon Web Services by Cloudconcur Ltd. It is not affiliated with Amazon Web Services.
