Analizador de ARN de AWS
Analizar un ARN
Funciona en tu navegador, también sin conexión: el ARN no se envía a ningún sitio. Los ARN no son secretos, pero contienen tu ID de cuenta.
Un Amazon Resource Name (ARN) tiene la forma arn:partition:service:region:account-id:resource, por ejemplo arn:aws:sns:us-east-1:123456789012:my-topic. La parte del recurso es un ID, o un tipo y un ID unidos por / o :, y algunos ARN dejan campos vacíos: los ARN de IAM no tienen región, y los ARN de buckets de S3 no tienen ni región ni cuenta.
Las partes de un ARN
Los ARN identifican un recurso sin ambigüedad en todo AWS, por eso las políticas de IAM, las etiquetas de recursos y muchas llamadas a la API los piden. Todo ARN tiene las mismas seis partes separadas por dos puntos, aunque la parte del recurso puede contener a su vez dos puntos y barras:
| Parte | Qué es | Ejemplo |
|---|---|---|
arn | Prefijo literal | arn |
| partition | El grupo de regiones: aws (regiones de AWS), aws-cn (China), aws-us-gov (GovCloud US). La documentación de S3 también incluye aws-eusc (European Sovereign Cloud). Cada cuenta pertenece a una partición. | aws |
| service | El espacio de nombres del servicio, que no siempre coincide con el nombre del producto: Step Functions es states, las reglas de EventBridge son events y los balanceadores de carga, elasticloadbalancing. | lambda |
| region | El código de región, o vacío para recursos globales como roles de IAM, buckets de S3, distribuciones de CloudFront y zonas alojadas de Route 53. | us-east-2 |
| account-id | El ID de 12 dígitos de la cuenta propietaria del recurso, sin guiones. Vacío para buckets y objetos de S3; aws para las políticas administradas por AWS. | 123456789012 |
| resource | resource-id, resource-type/resource-id o resource-type:resource-id. Puede incluir un recurso padre o un calificador como una versión. | function:my-function |
Formatos de ARN de 27 servicios de AWS habituales
Los marcadores van entre ${…}. Proceden de la página de cada servicio en la Service Authorization Reference, que indica el formato de ARN de cada tipo de recurso que puedes usar en una política; los formatos de las sesiones de STS proceden de la página de identificadores de IAM.
| Servicio | Recurso | Formato de ARN |
|---|---|---|
| IAM | usuario | arn:${Partition}:iam::${Account}:user/${UserNameWithPath} |
| IAM | rol | 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 instancia | arn:${Partition}:iam::${Account}:instance-profile/${InstanceProfileNameWithPath} |
| IAM | usuario raíz | arn:${Partition}:iam::${Account}:root |
| STS | sesión de rol asumido | arn:${Partition}:sts::${Account}:assumed-role/${RoleName}/${RoleSessionName} |
| STS | usuario 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 | instancia | arn:${Partition}:ec2:${Region}:${Account}:instance/${InstanceId} |
| Amazon EC2 | VPC | arn:${Partition}:ec2:${Region}:${Account}:vpc/${VpcId} |
| Amazon EC2 | subred | arn:${Partition}:ec2:${Region}:${Account}:subnet/${SubnetId} |
| Amazon EC2 | grupo de seguridad | arn:${Partition}:ec2:${Region}:${Account}:security-group/${SecurityGroupId} |
| Amazon EC2 | volumen de EBS | arn:${Partition}:ec2:${Region}:${Account}:volume/${VolumeId} |
| Amazon EC2 | AMI | arn:${Partition}:ec2:${Region}::image/${ImageId} |
| AWS Lambda | función | arn:${Partition}:lambda:${Region}:${Account}:function:${FunctionName} |
| AWS Lambda | versión de función | arn:${Partition}:lambda:${Region}:${Account}:function:${FunctionName}:${Version} |
| AWS Lambda | alias de función | arn:${Partition}:lambda:${Region}:${Account}:function:${FunctionName}:${Alias} |
| Amazon DynamoDB | tabla | arn:${Partition}:dynamodb:${Region}:${Account}:table/${TableName} |
| Amazon SQS | cola | arn:${Partition}:sqs:${Region}:${Account}:${QueueName} |
| Amazon SNS | tema | arn:${Partition}:sns:${Region}:${Account}:${TopicName} |
| Amazon RDS | instancia de base de datos | arn:${Partition}:rds:${Region}:${Account}:db:${DbInstanceName} |
| Amazon RDS | clúster de base de datos | arn:${Partition}:rds:${Region}:${Account}:cluster:${DbClusterInstanceName} |
| Amazon ECS | clúster | arn:${Partition}:ecs:${Region}:${Account}:cluster/${ClusterName} |
| Amazon ECS | service | arn:${Partition}:ecs:${Region}:${Account}:service/${ClusterName}/${ServiceName} |
| Amazon ECS | tarea | arn:${Partition}:ecs:${Region}:${Account}:task/${ClusterName}/${TaskId} |
| Amazon ECS | definición de tarea | arn:${Partition}:ecs:${Region}:${Account}:task-definition/${TaskDefinitionFamilyName}:${TaskDefinitionRevisionNumber} |
| Amazon ECR | repositorio | arn:${Partition}:ecr:${Region}:${Account}:repository/${RepositoryName} |
| Amazon EKS | clúster | arn:${Partition}:eks:${Region}:${Account}:cluster/${ClusterName} |
| AWS KMS | clave | arn:${Partition}:kms:${Region}:${Account}:key/${KeyId} |
| AWS KMS | alias | arn:${Partition}:kms:${Region}:${Account}:alias/${Alias} |
| Secrets Manager | secreto | arn:${Partition}:secretsmanager:${Region}:${Account}:secret:${SecretId} |
| CloudWatch Logs | grupo de logs | arn:${Partition}:logs:${Region}:${Account}:log-group:${LogGroupName} |
| CloudWatch | alarma | arn:${Partition}:cloudwatch:${Region}:${Account}:alarm:${AlarmName} |
| Step Functions | máquina de estado | arn:${Partition}:states:${Region}:${Account}:stateMachine:${StateMachineName} |
| Step Functions | ejecución | arn:${Partition}:states:${Region}:${Account}:execution:${StateMachineName}:${ExecutionId} |
| EventBridge | regla (bus predeterminado) | arn:${Partition}:events:${Region}:${Account}:rule/${RuleName} |
| EventBridge | regla (bus personalizado) | arn:${Partition}:events:${Region}:${Account}:rule/${EventBusName}/${RuleName} |
| EventBridge | bus de eventos | arn:${Partition}:events:${Region}:${Account}:event-bus/${EventBusName} |
| EventBridge Scheduler | programación | arn:${Partition}:scheduler:${Region}:${Account}:schedule/${GroupName}/${ScheduleName} |
| CloudFormation | pila | arn:${Partition}:cloudformation:${Region}:${Account}:stack/${StackName}/${Id} |
| API Gateway | API REST | arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId} |
| CloudFront | distribución | arn:${Partition}:cloudfront::${Account}:distribution/${DistributionId} |
| Route 53 | zona alojada | 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 | flujo | arn:${Partition}:kinesis:${Region}:${Account}:stream/${StreamName} |
Algunos detalles confunden a menudo. Los ARN de colas de SQS y temas de SNS no tienen tipo de recurso, solo el nombre. Los ARN de Lambda con sufijo de versión o alias (:prod, :3) son «calificados» y apuntan solo a esa versión. El ARN de una definición de tarea de ECS termina en family:revision. Los nombres de IAM WithPath incluyen la ruta, así que un rol de servicio tiene el aspecto role/service-role/MyRole.
Rutas, comodines y ARN incompletos
- Rutas. Los nombres de usuarios, grupos, roles y políticas de IAM pueden tener una ruta, y las claves de objetos de S3 usan barras como carpetas. Las rutas de IAM pueden contener letras, números y
/ + = , . @ _ -. - Comodines. En el elemento
ResourceoNotResourcede una política,*coincide con cualquier carácter y?con uno solo:arn:aws:iam::123456789012:role/service-*,arn:aws:s3:::amzn-s3-demo-bucket/????-test, oarn:aws:ec2:*:123456789012:vpc/*para todas las VPC de todas las regiones. No se pueden usar enPrincipalni enNotPrincipal, en el tipo de recurso (functi*) ni en la partición. - ARN incompletos. En una política basada en identidad, un ARN con menos de seis partes se completa con comodines, así que
arn:aws:sqssignificaarn:aws:sqs:*:*:*: todas las colas de todas las regiones y cuentas. Las políticas de sesión que se pasan a AssumeRole no aceptan ARN incompletos y fallan conMalformedPolicyDocumentException.
Encontrar un ARN
La mayoría de los comandos describe-, get- y list- devuelven el ARN junto al nombre, y la consola lo muestra en la página de detalles del recurso. Para saber a qué identidad pertenecen tus credenciales de la CLI, ejecuta aws sts get-caller-identity: un rol asumido aparece como arn:aws:sts::123456789012:assumed-role/RoleName/SessionName, que es la sesión, no el rol en sí (arn:aws:iam::123456789012:role/RoleName). Usa el ARN del rol en las políticas de confianza y de recursos.
AWS dice que los ARN no son secretos, sensibles ni confidenciales, pero revelan el ID de cuenta y los nombres de los recursos, así que compártelos con el mismo cuidado que cualquier otro identificador.
Fuentes
Preguntas frecuentes
¿Qué formato tiene un ARN de AWS?
arn:partition:service:region:account-id:resource. La parte del recurso es un ID de recurso, o un tipo de recurso y un ID separados por una barra o por dos puntos, como role/MyRole o function:my-function. Algunos ARN dejan vacía la región, el ID de cuenta o ambos: los ARN de buckets de S3 son como arn:aws:s3:::my-bucket.
¿Por qué un ARN de IAM o de S3 tiene campos vacíos (:::)?
IAM es global, así que los ARN de IAM no tienen región (arn:aws:iam::123456789012:role/MyRole). Los nombres de bucket de S3 son únicos en la partición, así que los ARN de buckets y objetos no tienen ni región ni ID de cuenta (arn:aws:s3:::my-bucket/key).
¿Un ARN es secreto?
No. AWS dice que los ARN no se consideran secretos, sensibles ni confidenciales, aunque como cualquier identificador conviene compartirlos con cuidado. Un ARN contiene el ID de cuenta y el nombre del recurso.
¿Puedo usar comodines en un ARN?
En el elemento Resource o NotResource de una política de IAM, sí: * coincide con cualquier carácter y ? con uno solo, como en arn:aws:s3:::my-bucket/* o arn:aws:ec2:*:123456789012:vpc/*. No en Principal ni en NotPrincipal, no en el tipo de recurso (functi*) y no en la partición.
¿Cuáles son las particiones de AWS?
aws para las regiones de AWS estándar, aws-cn para las regiones de China y aws-us-gov para AWS GovCloud (US). La documentación de S3 también incluye aws-eusc para la AWS European Sovereign Cloud. Una cuenta pertenece a una partición.
¿Cómo encuentro el ARN de mi propia identidad de IAM?
Ejecuta aws sts get-caller-identity. Devuelve tu ID de cuenta y el ARN del usuario o de la sesión de rol asumido a la que pertenecen tus credenciales.
La búsqueda de CloudConsole encuentra instancias, funciones, buckets, bases de datos, grupos de logs, alarmas y servicios de ECS por nombre, ID, ARN o IP, en todas tus cuentas y regiones, y te deja copiar el ARN o el enlace de la consola de un recurso. En iPhone y Android.
Sobre la app →