Analisador de ARN da AWS
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.
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 | usuário | arn:${Partition}:iam::${Account}:user/${UserNameWithPath} |
| IAM | função | arn:${Partition}:iam::${Account}:role/${RoleNameWithPath} |
| IAM | política | arn:${Partition}:iam::${Account}:policy/${PolicyNameWithPath} |
| IAM | grupo | arn:${Partition}:iam::${Account}:group/${GroupNameWithPath} |
| IAM | perfil de instância | arn:${Partition}:iam::${Account}:instance-profile/${InstanceProfileNameWithPath} |
| IAM | usuário raiz | arn:${Partition}:iam::${Account}:root |
| STS | sessão de função assumida | arn:${Partition}:sts::${Account}:assumed-role/${RoleName}/${RoleSessionName} |
| STS | usuário federado | arn:${Partition}:sts::${Account}:federated-user/${FederatedUserName} |
| Amazon S3 | bucket | arn:${Partition}:s3:::${BucketName} |
| Amazon S3 | objeto | arn:${Partition}:s3:::${BucketName}/${ObjectName} |
| Amazon EC2 | instância | arn:${Partition}:ec2:${Region}:${Account}:instance/${InstanceId} |
| Amazon EC2 | VPC | arn:${Partition}:ec2:${Region}:${Account}:vpc/${VpcId} |
| Amazon EC2 | sub-rede | arn:${Partition}:ec2:${Region}:${Account}:subnet/${SubnetId} |
| Amazon EC2 | grupo de segurança | arn:${Partition}:ec2:${Region}:${Account}:security-group/${SecurityGroupId} |
| Amazon EC2 | volume do EBS | arn:${Partition}:ec2:${Region}:${Account}:volume/${VolumeId} |
| Amazon EC2 | AMI | arn:${Partition}:ec2:${Region}::image/${ImageId} |
| AWS Lambda | função | arn:${Partition}:lambda:${Region}:${Account}:function:${FunctionName} |
| AWS Lambda | versão da função | arn:${Partition}:lambda:${Region}:${Account}:function:${FunctionName}:${Version} |
| AWS Lambda | alias da função | arn:${Partition}:lambda:${Region}:${Account}:function:${FunctionName}:${Alias} |
| Amazon DynamoDB | tabela | arn:${Partition}:dynamodb:${Region}:${Account}:table/${TableName} |
| Amazon SQS | fila | arn:${Partition}:sqs:${Region}:${Account}:${QueueName} |
| Amazon SNS | tópico | arn:${Partition}:sns:${Region}:${Account}:${TopicName} |
| Amazon RDS | instância de banco de dados | arn:${Partition}:rds:${Region}:${Account}:db:${DbInstanceName} |
| Amazon RDS | cluster de banco de dados | arn:${Partition}:rds:${Region}:${Account}:cluster:${DbClusterInstanceName} |
| Amazon ECS | cluster | arn:${Partition}:ecs:${Region}:${Account}:cluster/${ClusterName} |
| Amazon ECS | service | arn:${Partition}:ecs:${Region}:${Account}:service/${ClusterName}/${ServiceName} |
| Amazon ECS | tarefa | arn:${Partition}:ecs:${Region}:${Account}:task/${ClusterName}/${TaskId} |
| Amazon ECS | definição de tarefa | arn:${Partition}:ecs:${Region}:${Account}:task-definition/${TaskDefinitionFamilyName}:${TaskDefinitionRevisionNumber} |
| Amazon ECR | repositório | arn:${Partition}:ecr:${Region}:${Account}:repository/${RepositoryName} |
| Amazon EKS | cluster | arn:${Partition}:eks:${Region}:${Account}:cluster/${ClusterName} |
| AWS KMS | chave | arn:${Partition}:kms:${Region}:${Account}:key/${KeyId} |
| AWS KMS | alias | arn:${Partition}:kms:${Region}:${Account}:alias/${Alias} |
| Secrets Manager | segredo | arn:${Partition}:secretsmanager:${Region}:${Account}:secret:${SecretId} |
| CloudWatch Logs | grupo de logs | arn:${Partition}:logs:${Region}:${Account}:log-group:${LogGroupName} |
| CloudWatch | alarme | arn:${Partition}:cloudwatch:${Region}:${Account}:alarm:${AlarmName} |
| Step Functions | máquina de estado | arn:${Partition}:states:${Region}:${Account}:stateMachine:${StateMachineName} |
| Step Functions | execução | arn:${Partition}:states:${Region}:${Account}:execution:${StateMachineName}:${ExecutionId} |
| EventBridge | regra (barramento padrão) | arn:${Partition}:events:${Region}:${Account}:rule/${RuleName} |
| EventBridge | regra (barramento personalizado) | arn:${Partition}:events:${Region}:${Account}:rule/${EventBusName}/${RuleName} |
| EventBridge | barramento de eventos | arn:${Partition}:events:${Region}:${Account}:event-bus/${EventBusName} |
| EventBridge Scheduler | agendamento | arn:${Partition}:scheduler:${Region}:${Account}:schedule/${GroupName}/${ScheduleName} |
| CloudFormation | pilha | arn:${Partition}:cloudformation:${Region}:${Account}:stack/${StackName}/${Id} |
| API Gateway | API REST | arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId} |
| CloudFront | distribuição | arn:${Partition}:cloudfront::${Account}:distribution/${DistributionId} |
| Route 53 | zona hospedada | arn:${Partition}:route53:::hostedzone/${Id} |
| Certificate Manager | certificado | arn:${Partition}:acm:${Region}:${Account}:certificate/${CertificateId} |
| Elastic Load Balancing | Application Load Balancer | arn:${Partition}:elasticloadbalancing:${Region}:${Account}:loadbalancer/app/${LoadBalancerName}/${LoadBalancerId} |
| Elastic Load Balancing | grupo de destino | arn:${Partition}:elasticloadbalancing:${Region}:${Account}:targetgroup/${TargetGroupName}/${TargetGroupId} |
| Systems Manager | parâmetro | arn:${Partition}:ssm:${Region}:${Account}:parameter/${ParameterNameWithoutLeadingSlash} |
| Kinesis Data Streams | 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
ResourceouNotResourcede 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, ouarn:aws:ec2:*:123456789012:vpc/*para todas as VPCs de todas as regiões. Não é possível usá-los emPrincipalouNotPrincipal, 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:sqssignificaarn: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 comMalformedPolicyDocumentException.
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
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.
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 →