CloudConsole

Analizador de ARN de AWS

Gratis, en tu navegador · formatos de ARN de 27 servicios · funciona sin conexión

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.

Respuesta corta

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:

Partes de un ARN
ParteQué esEjemplo
arnPrefijo literalarn
partitionEl 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
serviceEl 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
regionEl 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-idEl 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
resourceresource-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.

Formatos de ARN por servicio y tipo de recurso
ServicioRecursoFormato de ARN
IAMusuarioarn:${Partition}:iam::${Account}:user/${UserNameWithPath}
IAMrolarn:${Partition}:iam::${Account}:role/${RoleNameWithPath}
IAMpolíticaarn:${Partition}:iam::${Account}:policy/${PolicyNameWithPath}
IAMgrupoarn:${Partition}:iam::${Account}:group/${GroupNameWithPath}
IAMperfil de instanciaarn:${Partition}:iam::${Account}:instance-profile/${InstanceProfileNameWithPath}
IAMusuario raízarn:${Partition}:iam::${Account}:root
STSsesión de rol asumidoarn:${Partition}:sts::${Account}:assumed-role/${RoleName}/${RoleSessionName}
STSusuario federadoarn:${Partition}:sts::${Account}:federated-user/${FederatedUserName}
Amazon S3bucketarn:${Partition}:s3:::${BucketName}
Amazon S3objetoarn:${Partition}:s3:::${BucketName}/${ObjectName}
Amazon EC2instanciaarn:${Partition}:ec2:${Region}:${Account}:instance/${InstanceId}
Amazon EC2VPCarn:${Partition}:ec2:${Region}:${Account}:vpc/${VpcId}
Amazon EC2subredarn:${Partition}:ec2:${Region}:${Account}:subnet/${SubnetId}
Amazon EC2grupo de seguridadarn:${Partition}:ec2:${Region}:${Account}:security-group/${SecurityGroupId}
Amazon EC2volumen de EBSarn:${Partition}:ec2:${Region}:${Account}:volume/${VolumeId}
Amazon EC2AMIarn:${Partition}:ec2:${Region}::image/${ImageId}
AWS Lambdafunciónarn:${Partition}:lambda:${Region}:${Account}:function:${FunctionName}
AWS Lambdaversión de funciónarn:${Partition}:lambda:${Region}:${Account}:function:${FunctionName}:${Version}
AWS Lambdaalias de funciónarn:${Partition}:lambda:${Region}:${Account}:function:${FunctionName}:${Alias}
Amazon DynamoDBtablaarn:${Partition}:dynamodb:${Region}:${Account}:table/${TableName}
Amazon SQScolaarn:${Partition}:sqs:${Region}:${Account}:${QueueName}
Amazon SNStemaarn:${Partition}:sns:${Region}:${Account}:${TopicName}
Amazon RDSinstancia de base de datosarn:${Partition}:rds:${Region}:${Account}:db:${DbInstanceName}
Amazon RDSclúster de base de datosarn:${Partition}:rds:${Region}:${Account}:cluster:${DbClusterInstanceName}
Amazon ECSclústerarn:${Partition}:ecs:${Region}:${Account}:cluster/${ClusterName}
Amazon ECSservicearn:${Partition}:ecs:${Region}:${Account}:service/${ClusterName}/${ServiceName}
Amazon ECStareaarn:${Partition}:ecs:${Region}:${Account}:task/${ClusterName}/${TaskId}
Amazon ECSdefinición de tareaarn:${Partition}:ecs:${Region}:${Account}:task-definition/${TaskDefinitionFamilyName}:${TaskDefinitionRevisionNumber}
Amazon ECRrepositorioarn:${Partition}:ecr:${Region}:${Account}:repository/${RepositoryName}
Amazon EKSclústerarn:${Partition}:eks:${Region}:${Account}:cluster/${ClusterName}
AWS KMSclavearn:${Partition}:kms:${Region}:${Account}:key/${KeyId}
AWS KMSaliasarn:${Partition}:kms:${Region}:${Account}:alias/${Alias}
Secrets Managersecretoarn:${Partition}:secretsmanager:${Region}:${Account}:secret:${SecretId}
CloudWatch Logsgrupo de logsarn:${Partition}:logs:${Region}:${Account}:log-group:${LogGroupName}
CloudWatchalarmaarn:${Partition}:cloudwatch:${Region}:${Account}:alarm:${AlarmName}
Step Functionsmáquina de estadoarn:${Partition}:states:${Region}:${Account}:stateMachine:${StateMachineName}
Step Functionsejecuciónarn:${Partition}:states:${Region}:${Account}:execution:${StateMachineName}:${ExecutionId}
EventBridgeregla (bus predeterminado)arn:${Partition}:events:${Region}:${Account}:rule/${RuleName}
EventBridgeregla (bus personalizado)arn:${Partition}:events:${Region}:${Account}:rule/${EventBusName}/${RuleName}
EventBridgebus de eventosarn:${Partition}:events:${Region}:${Account}:event-bus/${EventBusName}
EventBridge Schedulerprogramaciónarn:${Partition}:scheduler:${Region}:${Account}:schedule/${GroupName}/${ScheduleName}
CloudFormationpilaarn:${Partition}:cloudformation:${Region}:${Account}:stack/${StackName}/${Id}
API GatewayAPI RESTarn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}
CloudFrontdistribuciónarn:${Partition}:cloudfront::${Account}:distribution/${DistributionId}
Route 53zona alojadaarn:${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 Streamsflujoarn:${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 Resource o NotResource de 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, o arn:aws:ec2:*:123456789012:vpc/* para todas las VPC de todas las regiones. No se pueden usar en Principal ni en NotPrincipal, 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:sqs significa arn: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 con MalformedPolicyDocumentException.

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.

Buscar un recurso por su ARN

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 →