CloudConsole

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.

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:

Partes do ARN
ParteO que éExemplo
arnPrefixo literalarn
partitionO 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
serviceO 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
regionO 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-idO 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
resourceresource-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.

Formatos de ARN por serviço e tipo de recurso
ServiçoRecursoFormato de ARN
IAMusuárioarn:${Partition}:iam::${Account}:user/${UserNameWithPath}
IAMfunçãoarn:${Partition}:iam::${Account}:role/${RoleNameWithPath}
IAMpolíticaarn:${Partition}:iam::${Account}:policy/${PolicyNameWithPath}
IAMgrupoarn:${Partition}:iam::${Account}:group/${GroupNameWithPath}
IAMperfil de instânciaarn:${Partition}:iam::${Account}:instance-profile/${InstanceProfileNameWithPath}
IAMusuário raizarn:${Partition}:iam::${Account}:root
STSsessão de função assumidaarn:${Partition}:sts::${Account}:assumed-role/${RoleName}/${RoleSessionName}
STSusuário federadoarn:${Partition}:sts::${Account}:federated-user/${FederatedUserName}
Amazon S3bucketarn:${Partition}:s3:::${BucketName}
Amazon S3objetoarn:${Partition}:s3:::${BucketName}/${ObjectName}
Amazon EC2instânciaarn:${Partition}:ec2:${Region}:${Account}:instance/${InstanceId}
Amazon EC2VPCarn:${Partition}:ec2:${Region}:${Account}:vpc/${VpcId}
Amazon EC2sub-redearn:${Partition}:ec2:${Region}:${Account}:subnet/${SubnetId}
Amazon EC2grupo de segurançaarn:${Partition}:ec2:${Region}:${Account}:security-group/${SecurityGroupId}
Amazon EC2volume do EBSarn:${Partition}:ec2:${Region}:${Account}:volume/${VolumeId}
Amazon EC2AMIarn:${Partition}:ec2:${Region}::image/${ImageId}
AWS Lambdafunçãoarn:${Partition}:lambda:${Region}:${Account}:function:${FunctionName}
AWS Lambdaversão da funçãoarn:${Partition}:lambda:${Region}:${Account}:function:${FunctionName}:${Version}
AWS Lambdaalias da funçãoarn:${Partition}:lambda:${Region}:${Account}:function:${FunctionName}:${Alias}
Amazon DynamoDBtabelaarn:${Partition}:dynamodb:${Region}:${Account}:table/${TableName}
Amazon SQSfilaarn:${Partition}:sqs:${Region}:${Account}:${QueueName}
Amazon SNStópicoarn:${Partition}:sns:${Region}:${Account}:${TopicName}
Amazon RDSinstância de banco de dadosarn:${Partition}:rds:${Region}:${Account}:db:${DbInstanceName}
Amazon RDScluster de banco de dadosarn:${Partition}:rds:${Region}:${Account}:cluster:${DbClusterInstanceName}
Amazon ECSclusterarn:${Partition}:ecs:${Region}:${Account}:cluster/${ClusterName}
Amazon ECSservicearn:${Partition}:ecs:${Region}:${Account}:service/${ClusterName}/${ServiceName}
Amazon ECStarefaarn:${Partition}:ecs:${Region}:${Account}:task/${ClusterName}/${TaskId}
Amazon ECSdefinição de tarefaarn:${Partition}:ecs:${Region}:${Account}:task-definition/${TaskDefinitionFamilyName}:${TaskDefinitionRevisionNumber}
Amazon ECRrepositórioarn:${Partition}:ecr:${Region}:${Account}:repository/${RepositoryName}
Amazon EKSclusterarn:${Partition}:eks:${Region}:${Account}:cluster/${ClusterName}
AWS KMSchavearn:${Partition}:kms:${Region}:${Account}:key/${KeyId}
AWS KMSaliasarn:${Partition}:kms:${Region}:${Account}:alias/${Alias}
Secrets Managersegredoarn:${Partition}:secretsmanager:${Region}:${Account}:secret:${SecretId}
CloudWatch Logsgrupo de logsarn:${Partition}:logs:${Region}:${Account}:log-group:${LogGroupName}
CloudWatchalarmearn:${Partition}:cloudwatch:${Region}:${Account}:alarm:${AlarmName}
Step Functionsmáquina de estadoarn:${Partition}:states:${Region}:${Account}:stateMachine:${StateMachineName}
Step Functionsexecuçãoarn:${Partition}:states:${Region}:${Account}:execution:${StateMachineName}:${ExecutionId}
EventBridgeregra (barramento padrão)arn:${Partition}:events:${Region}:${Account}:rule/${RuleName}
EventBridgeregra (barramento personalizado)arn:${Partition}:events:${Region}:${Account}:rule/${EventBusName}/${RuleName}
EventBridgebarramento de eventosarn:${Partition}:events:${Region}:${Account}:event-bus/${EventBusName}
EventBridge Scheduleragendamentoarn:${Partition}:scheduler:${Region}:${Account}:schedule/${GroupName}/${ScheduleName}
CloudFormationpilhaarn:${Partition}:cloudformation:${Region}:${Account}:stack/${StackName}/${Id}
API GatewayAPI RESTarn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}
CloudFrontdistribuiçãoarn:${Partition}:cloudfront::${Account}:distribution/${DistributionId}
Route 53zona hospedadaarn:${Partition}:route53:::hostedzone/${Id}
Certificate Managercertificadoarn:${Partition}:acm:${Region}:${Account}:certificate/${CertificateId}
Elastic Load BalancingApplication Load Balancerarn:${Partition}:elasticloadbalancing:${Region}:${Account}:loadbalancer/app/${LoadBalancerName}/${LoadBalancerId}
Elastic Load Balancinggrupo de destinoarn:${Partition}:elasticloadbalancing:${Region}:${Account}:targetgroup/${TargetGroupName}/${TargetGroupId}
Systems Managerparâmetroarn:${Partition}:ssm:${Region}:${Account}:parameter/${ParameterNameWithoutLeadingSlash}
Kinesis Data Streamsstreamarn:${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

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 →