CloudConsole

Analyseur d’ARN AWS

Gratuit, dans votre navigateur · formats d’ARN de 27 services · fonctionne hors ligne

Analyser un ARN

Tourne dans votre navigateur, même hors ligne : l’ARN n’est envoyé nulle part. Les ARN ne sont pas secrets, mais ils contiennent votre ID de compte.

En bref

Un Amazon Resource Name (ARN) a la forme arn:partition:service:region:account-id:resource, par exemple arn:aws:sns:us-east-1:123456789012:my-topic. La partie ressource est un ID, ou un type et un ID reliés par / ou :, et certains ARN laissent des champs vides : les ARN IAM n’ont pas de région, et les ARN de bucket S3 n’ont ni région ni compte.

Les parties d’un ARN

Les ARN identifient une ressource sans ambiguïté dans tout AWS : c’est pourquoi les politiques IAM, les tags de ressource et de nombreux appels d’API les demandent. Chaque ARN a les mêmes six parties séparées par des deux-points, même si la partie ressource peut elle-même contenir des deux-points et des barres obliques :

Parties d’un ARN
PartieCe que c’estExemple
arnPréfixe littéralarn
partitionLe groupe de régions : aws (régions AWS), aws-cn (Chine), aws-us-gov (GovCloud US). La documentation S3 liste aussi aws-eusc (European Sovereign Cloud). Chaque compte appartient à une partition.aws
serviceL’espace de noms du service, qui n’est pas toujours le nom du produit : Step Functions est states, les règles EventBridge sont events, les équilibreurs de charge elasticloadbalancing.lambda
regionLe code de région, ou vide pour les ressources globales comme les rôles IAM, les buckets S3, les distributions CloudFront et les zones hébergées Route 53.us-east-2
account-idL’ID à 12 chiffres du compte propriétaire de la ressource, sans tirets. Vide pour les buckets et objets S3 ; aws pour les politiques gérées par AWS.123456789012
resourceresource-id, resource-type/resource-id ou resource-type:resource-id. Elle peut inclure une ressource parente ou un qualificateur comme une version.function:my-function

Formats d’ARN de 27 services AWS courants

Les variables sont entre ${…}. Elles viennent de la page de chaque service dans la Service Authorization Reference, qui liste le format d’ARN de chaque type de ressource utilisable dans une politique ; les formats des sessions STS viennent de la page sur les identifiants IAM.

Formats d’ARN par service et type de ressource
ServiceRessourceFormat d’ARN
IAMutilisateurarn:${Partition}:iam::${Account}:user/${UserNameWithPath}
IAMrôlearn:${Partition}:iam::${Account}:role/${RoleNameWithPath}
IAMpolitiquearn:${Partition}:iam::${Account}:policy/${PolicyNameWithPath}
IAMgroupearn:${Partition}:iam::${Account}:group/${GroupNameWithPath}
IAMprofil d’instancearn:${Partition}:iam::${Account}:instance-profile/${InstanceProfileNameWithPath}
IAMutilisateur rootarn:${Partition}:iam::${Account}:root
STSsession de rôle assuméarn:${Partition}:sts::${Account}:assumed-role/${RoleName}/${RoleSessionName}
STSutilisateur fédéréarn:${Partition}:sts::${Account}:federated-user/${FederatedUserName}
Amazon S3bucketarn:${Partition}:s3:::${BucketName}
Amazon S3objetarn:${Partition}:s3:::${BucketName}/${ObjectName}
Amazon EC2instancearn:${Partition}:ec2:${Region}:${Account}:instance/${InstanceId}
Amazon EC2VPCarn:${Partition}:ec2:${Region}:${Account}:vpc/${VpcId}
Amazon EC2sous-réseauarn:${Partition}:ec2:${Region}:${Account}:subnet/${SubnetId}
Amazon EC2groupe de sécuritéarn:${Partition}:ec2:${Region}:${Account}:security-group/${SecurityGroupId}
Amazon EC2volume EBSarn:${Partition}:ec2:${Region}:${Account}:volume/${VolumeId}
Amazon EC2AMIarn:${Partition}:ec2:${Region}::image/${ImageId}
AWS Lambdafonctionarn:${Partition}:lambda:${Region}:${Account}:function:${FunctionName}
AWS Lambdaversion de fonctionarn:${Partition}:lambda:${Region}:${Account}:function:${FunctionName}:${Version}
AWS Lambdaalias de fonctionarn:${Partition}:lambda:${Region}:${Account}:function:${FunctionName}:${Alias}
Amazon DynamoDBtablearn:${Partition}:dynamodb:${Region}:${Account}:table/${TableName}
Amazon SQSfile d’attentearn:${Partition}:sqs:${Region}:${Account}:${QueueName}
Amazon SNSrubriquearn:${Partition}:sns:${Region}:${Account}:${TopicName}
Amazon RDSinstance de base de donnéesarn:${Partition}:rds:${Region}:${Account}:db:${DbInstanceName}
Amazon RDScluster de base de donnéesarn:${Partition}:rds:${Region}:${Account}:cluster:${DbClusterInstanceName}
Amazon ECSclusterarn:${Partition}:ecs:${Region}:${Account}:cluster/${ClusterName}
Amazon ECSservicearn:${Partition}:ecs:${Region}:${Account}:service/${ClusterName}/${ServiceName}
Amazon ECStâchearn:${Partition}:ecs:${Region}:${Account}:task/${ClusterName}/${TaskId}
Amazon ECSdéfinition de tâchearn:${Partition}:ecs:${Region}:${Account}:task-definition/${TaskDefinitionFamilyName}:${TaskDefinitionRevisionNumber}
Amazon ECRréférentielarn:${Partition}:ecr:${Region}:${Account}:repository/${RepositoryName}
Amazon EKSclusterarn:${Partition}:eks:${Region}:${Account}:cluster/${ClusterName}
AWS KMScléarn:${Partition}:kms:${Region}:${Account}:key/${KeyId}
AWS KMSaliasarn:${Partition}:kms:${Region}:${Account}:alias/${Alias}
Secrets Managersecretarn:${Partition}:secretsmanager:${Region}:${Account}:secret:${SecretId}
CloudWatch Logsgroupe de logsarn:${Partition}:logs:${Region}:${Account}:log-group:${LogGroupName}
CloudWatchalarmearn:${Partition}:cloudwatch:${Region}:${Account}:alarm:${AlarmName}
Step Functionsmachine d’étatarn:${Partition}:states:${Region}:${Account}:stateMachine:${StateMachineName}
Step Functionsexécutionarn:${Partition}:states:${Region}:${Account}:execution:${StateMachineName}:${ExecutionId}
EventBridgerègle (bus par défaut)arn:${Partition}:events:${Region}:${Account}:rule/${RuleName}
EventBridgerègle (bus personnalisé)arn:${Partition}:events:${Region}:${Account}:rule/${EventBusName}/${RuleName}
EventBridgebus d’événementsarn:${Partition}:events:${Region}:${Account}:event-bus/${EventBusName}
EventBridge Schedulerplanificationarn:${Partition}:scheduler:${Region}:${Account}:schedule/${GroupName}/${ScheduleName}
CloudFormationpilearn:${Partition}:cloudformation:${Region}:${Account}:stack/${StackName}/${Id}
API GatewayAPI RESTarn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}
CloudFrontdistributionarn:${Partition}:cloudfront::${Account}:distribution/${DistributionId}
Route 53zone hébergéearn:${Partition}:route53:::hostedzone/${Id}
Certificate Managercertificatarn:${Partition}:acm:${Region}:${Account}:certificate/${CertificateId}
Elastic Load BalancingApplication Load Balancerarn:${Partition}:elasticloadbalancing:${Region}:${Account}:loadbalancer/app/${LoadBalancerName}/${LoadBalancerId}
Elastic Load Balancinggroupe ciblearn:${Partition}:elasticloadbalancing:${Region}:${Account}:targetgroup/${TargetGroupName}/${TargetGroupId}
Systems Managerparamètrearn:${Partition}:ssm:${Region}:${Account}:parameter/${ParameterNameWithoutLeadingSlash}
Kinesis Data Streamsfluxarn:${Partition}:kinesis:${Region}:${Account}:stream/${StreamName}

Quelques détails piègent souvent. Les ARN de file SQS et de rubrique SNS n’ont pas de type de ressource, seulement le nom. Les ARN Lambda avec un suffixe de version ou d’alias (:prod, :3) sont « qualifiés » et ne désignent que cette version. Un ARN de définition de tâche ECS se termine par family:revision. Les noms IAM WithPath incluent le chemin : un rôle de service ressemble donc à role/service-role/MyRole.

Chemins, caractères génériques et ARN incomplets

  • Chemins. Les noms d’utilisateurs, de groupes, de rôles et de politiques IAM peuvent avoir un chemin, et les clés d’objets S3 utilisent des barres obliques comme des dossiers. Les chemins IAM peuvent contenir des lettres, des chiffres et / + = , . @ _ -.
  • Caractères génériques. Dans l’élément Resource ou NotResource d’une politique, * correspond à n’importe quels caractères et ? à un seul : arn:aws:iam::123456789012:role/service-*, arn:aws:s3:::amzn-s3-demo-bucket/????-test, ou arn:aws:ec2:*:123456789012:vpc/* pour tous les VPC de toutes les régions. Ils sont interdits dans Principal ou NotPrincipal, dans le type de ressource (functi*) et dans la partition.
  • ARN incomplets. Dans une politique basée sur l’identité, un ARN de moins de six parties est complété par des caractères génériques : arn:aws:sqs signifie donc arn:aws:sqs:*:*:*, soit toutes les files de toutes les régions et de tous les comptes. Les politiques de session transmises à AssumeRole n’acceptent pas les ARN incomplets et échouent avec MalformedPolicyDocumentException.

Trouver un ARN

La plupart des commandes describe-, get- et list- renvoient l’ARN avec le nom, et la console l’affiche sur la page de détails de la ressource. Pour savoir à quelle identité appartiennent vos identifiants CLI, exécutez aws sts get-caller-identity : un rôle assumé apparaît sous la forme arn:aws:sts::123456789012:assumed-role/RoleName/SessionName, qui désigne la session, pas le rôle lui-même (arn:aws:iam::123456789012:role/RoleName). Utilisez l’ARN du rôle dans les politiques d’approbation et de ressource.

Selon AWS, les ARN ne sont ni secrets, ni sensibles, ni confidentiels, mais ils révèlent l’ID de compte et les noms de ressources : partagez-les avec la même prudence que tout autre identifiant.

Sources

Questions fréquentes

Quel est le format d’un ARN AWS ?

arn:partition:service:region:account-id:resource. La partie ressource est un ID de ressource, ou un type de ressource et un ID séparés par une barre oblique ou un deux-points, comme role/MyRole ou function:my-function. Certains ARN laissent vides la région, l’ID de compte ou les deux : les ARN de bucket S3 ressemblent à arn:aws:s3:::my-bucket.

Pourquoi un ARN IAM ou S3 a-t-il des champs vides (:::) ?

IAM est global : les ARN IAM n’ont donc pas de région (arn:aws:iam::123456789012:role/MyRole). Les noms de bucket S3 sont uniques dans la partition : les ARN de bucket et d’objet n’ont donc ni région ni ID de compte (arn:aws:s3:::my-bucket/key).

Un ARN est-il secret ?

Non. Selon AWS, les ARN ne sont pas considérés comme secrets, sensibles ou confidentiels, mais comme tout identifiant, partagez-les avec prudence. Un ARN contient l’ID de compte et le nom de la ressource.

Puis-je utiliser des caractères génériques dans un ARN ?

Dans l’élément Resource ou NotResource d’une politique IAM, oui : * correspond à n’importe quels caractères et ? à un seul, comme dans arn:aws:s3:::my-bucket/* ou arn:aws:ec2:*:123456789012:vpc/*. Pas dans Principal ou NotPrincipal, pas dans le type de ressource (functi*) et pas dans la partition.

Quelles sont les partitions AWS ?

aws pour les régions AWS standard, aws-cn pour les régions de Chine et aws-us-gov pour AWS GovCloud (US). La documentation S3 liste aussi aws-eusc pour l’AWS European Sovereign Cloud. Un compte appartient à une partition.

Comment trouver l’ARN de ma propre identité IAM ?

Exécutez aws sts get-caller-identity. La commande renvoie votre ID de compte et l’ARN de l’utilisateur ou de la session de rôle assumé à laquelle appartiennent vos identifiants.

Retrouver une ressource à partir de son ARN

La recherche de CloudConsole trouve instances, fonctions, buckets, bases de données, groupes de logs, alarmes et services ECS par nom, ID, ARN ou IP, dans tous vos comptes et régions, et vous permet de copier l’ARN ou le lien de console d’une ressource. Sur iPhone et Android.

À propos de l’app →