AWS-ARN-Parser
ARN zerlegen
Läuft in Ihrem Browser, auch offline: Der ARN wird nirgendwohin gesendet. ARNs sind nicht geheim, enthalten aber Ihre Konto-ID.
Ein Amazon Resource Name (ARN) hat die Form arn:partition:service:region:account-id:resource, zum Beispiel arn:aws:sns:us-east-1:123456789012:my-topic. Der Ressourcenteil ist eine ID oder ein Typ und eine ID, verbunden durch / oder :, und manche ARNs lassen Felder leer: IAM-ARNs haben keine Region, S3-Bucket-ARNs weder Region noch Konto.
Die Teile eines ARN
ARNs identifizieren eine Ressource eindeutig in ganz AWS, deshalb verlangen IAM-Richtlinien, Ressourcen-Tags und viele API-Aufrufe danach. Jeder ARN hat dieselben sechs durch Doppelpunkte getrennten Teile, wobei der Ressourcenteil selbst Doppelpunkte und Schrägstriche enthalten kann:
| Teil | Was es ist | Beispiel |
|---|---|---|
arn | Festes Präfix | arn |
| partition | Die Gruppe von Regionen: aws (AWS-Regionen), aws-cn (China), aws-us-gov (GovCloud US). Die S3-Dokumentation nennt außerdem aws-eusc (European Sovereign Cloud). Jedes Konto gehört zu genau einer Partition. | aws |
| service | Der Service-Namespace, der nicht immer dem Produktnamen entspricht: Step Functions ist states, EventBridge-Regeln sind events, Load Balancer elasticloadbalancing. | lambda |
| region | Der Regionscode, oder leer bei globalen Ressourcen wie IAM-Rollen, S3-Buckets, CloudFront-Distributionen und gehosteten Zonen in Route 53. | us-east-2 |
| account-id | Die 12-stellige ID des Kontos, dem die Ressource gehört, ohne Bindestriche. Leer bei S3-Buckets und -Objekten; aws bei von AWS verwalteten Richtlinien. | 123456789012 |
| resource | resource-id, resource-type/resource-id oder resource-type:resource-id. Er kann eine übergeordnete Ressource oder einen Qualifier wie eine Version enthalten. | function:my-function |
ARN-Formate für 27 gängige AWS-Services
Platzhalter stehen in ${…}. Sie stammen von der Seite des jeweiligen Service in der Service Authorization Reference, die das ARN-Format jedes in Richtlinien nutzbaren Ressourcentyps auflistet; die Formate der STS-Sitzungen stammen von der Seite zu IAM-Kennungen.
| Service | Ressource | ARN-Format |
|---|---|---|
| IAM | Benutzer | arn:${Partition}:iam::${Account}:user/${UserNameWithPath} |
| IAM | Rolle | arn:${Partition}:iam::${Account}:role/${RoleNameWithPath} |
| IAM | Richtlinie | arn:${Partition}:iam::${Account}:policy/${PolicyNameWithPath} |
| IAM | Gruppe | arn:${Partition}:iam::${Account}:group/${GroupNameWithPath} |
| IAM | Instanzprofil | arn:${Partition}:iam::${Account}:instance-profile/${InstanceProfileNameWithPath} |
| IAM | Root-Benutzer | arn:${Partition}:iam::${Account}:root |
| STS | Assumed-Role-Sitzung | arn:${Partition}:sts::${Account}:assumed-role/${RoleName}/${RoleSessionName} |
| STS | föderierter Benutzer | arn:${Partition}:sts::${Account}:federated-user/${FederatedUserName} |
| Amazon S3 | Bucket | arn:${Partition}:s3:::${BucketName} |
| Amazon S3 | Objekt | arn:${Partition}:s3:::${BucketName}/${ObjectName} |
| Amazon EC2 | Instanz | arn:${Partition}:ec2:${Region}:${Account}:instance/${InstanceId} |
| Amazon EC2 | VPC | arn:${Partition}:ec2:${Region}:${Account}:vpc/${VpcId} |
| Amazon EC2 | Subnetz | arn:${Partition}:ec2:${Region}:${Account}:subnet/${SubnetId} |
| Amazon EC2 | Sicherheitsgruppe | arn:${Partition}:ec2:${Region}:${Account}:security-group/${SecurityGroupId} |
| Amazon EC2 | EBS-Volume | arn:${Partition}:ec2:${Region}:${Account}:volume/${VolumeId} |
| Amazon EC2 | AMI | arn:${Partition}:ec2:${Region}::image/${ImageId} |
| AWS Lambda | Funktion | arn:${Partition}:lambda:${Region}:${Account}:function:${FunctionName} |
| AWS Lambda | Funktionsversion | arn:${Partition}:lambda:${Region}:${Account}:function:${FunctionName}:${Version} |
| AWS Lambda | Funktionsalias | arn:${Partition}:lambda:${Region}:${Account}:function:${FunctionName}:${Alias} |
| Amazon DynamoDB | Tabelle | arn:${Partition}:dynamodb:${Region}:${Account}:table/${TableName} |
| Amazon SQS | Warteschlange | arn:${Partition}:sqs:${Region}:${Account}:${QueueName} |
| Amazon SNS | Topic | arn:${Partition}:sns:${Region}:${Account}:${TopicName} |
| Amazon RDS | DB-Instanz | arn:${Partition}:rds:${Region}:${Account}:db:${DbInstanceName} |
| Amazon RDS | DB-Cluster | 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 | Task | arn:${Partition}:ecs:${Region}:${Account}:task/${ClusterName}/${TaskId} |
| Amazon ECS | Task-Definition | arn:${Partition}:ecs:${Region}:${Account}:task-definition/${TaskDefinitionFamilyName}:${TaskDefinitionRevisionNumber} |
| Amazon ECR | Repository | arn:${Partition}:ecr:${Region}:${Account}:repository/${RepositoryName} |
| Amazon EKS | Cluster | arn:${Partition}:eks:${Region}:${Account}:cluster/${ClusterName} |
| AWS KMS | Schlüssel | arn:${Partition}:kms:${Region}:${Account}:key/${KeyId} |
| AWS KMS | Alias | arn:${Partition}:kms:${Region}:${Account}:alias/${Alias} |
| Secrets Manager | Secret | arn:${Partition}:secretsmanager:${Region}:${Account}:secret:${SecretId} |
| CloudWatch Logs | Log-Gruppe | arn:${Partition}:logs:${Region}:${Account}:log-group:${LogGroupName} |
| CloudWatch | Alarm | arn:${Partition}:cloudwatch:${Region}:${Account}:alarm:${AlarmName} |
| Step Functions | Zustandsautomat | arn:${Partition}:states:${Region}:${Account}:stateMachine:${StateMachineName} |
| Step Functions | Ausführung | arn:${Partition}:states:${Region}:${Account}:execution:${StateMachineName}:${ExecutionId} |
| EventBridge | Regel (Standard-Bus) | arn:${Partition}:events:${Region}:${Account}:rule/${RuleName} |
| EventBridge | Regel (eigener Bus) | arn:${Partition}:events:${Region}:${Account}:rule/${EventBusName}/${RuleName} |
| EventBridge | Event-Bus | arn:${Partition}:events:${Region}:${Account}:event-bus/${EventBusName} |
| EventBridge Scheduler | Zeitplan | arn:${Partition}:scheduler:${Region}:${Account}:schedule/${GroupName}/${ScheduleName} |
| CloudFormation | Stack | arn:${Partition}:cloudformation:${Region}:${Account}:stack/${StackName}/${Id} |
| API Gateway | REST-API | arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId} |
| CloudFront | Distribution | arn:${Partition}:cloudfront::${Account}:distribution/${DistributionId} |
| Route 53 | gehostete Zone | arn:${Partition}:route53:::hostedzone/${Id} |
| Certificate Manager | Zertifikat | 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 | Zielgruppe | arn:${Partition}:elasticloadbalancing:${Region}:${Account}:targetgroup/${TargetGroupName}/${TargetGroupId} |
| Systems Manager | Parameter | arn:${Partition}:ssm:${Region}:${Account}:parameter/${ParameterNameWithoutLeadingSlash} |
| Kinesis Data Streams | Stream | arn:${Partition}:kinesis:${Region}:${Account}:stream/${StreamName} |
Einige Details bringen Leute ins Stolpern. ARNs von SQS-Warteschlangen und SNS-Topics haben keinen Ressourcentyp, nur den Namen. Lambda-ARNs mit Versions- oder Alias-Suffix (:prod, :3) sind „qualifiziert“ und zeigen nur auf diese Version. Ein ECS-Task-Definitions-ARN endet auf family:revision. Die IAM-Namen mit WithPath enthalten den Pfad, eine Service-Rolle sieht also aus wie role/service-role/MyRole.
Pfade, Platzhalter und unvollständige ARNs
- Pfade. Namen von IAM-Benutzern, -Gruppen, -Rollen und -Richtlinien können einen Pfad haben, und S3-Objektschlüssel nutzen Schrägstriche wie Ordner. IAM-Pfade dürfen Buchstaben, Ziffern und
/ + = , . @ _ -enthalten. - Platzhalter. Im Element
ResourceoderNotResourceeiner Richtlinie steht*für beliebige Zeichen und?für ein Zeichen:arn:aws:iam::123456789012:role/service-*,arn:aws:s3:::amzn-s3-demo-bucket/????-testoderarn:aws:ec2:*:123456789012:vpc/*für jede VPC in jeder Region. Sie sind nicht erlaubt inPrincipaloderNotPrincipal, im Ressourcentyp (functi*) und in der Partition. - Unvollständige ARNs. In einer identitätsbasierten Richtlinie wird ein ARN mit weniger als sechs Teilen mit Platzhaltern ergänzt,
arn:aws:sqsbedeutet alsoarn:aws:sqs:*:*:*: jede Warteschlange in jeder Region und jedem Konto. Sitzungsrichtlinien für AssumeRole akzeptieren keine unvollständigen ARNs und scheitern mitMalformedPolicyDocumentException.
Einen ARN finden
Die meisten Befehle mit describe-, get- und list- geben den ARN zusammen mit dem Namen zurück, und die Konsole zeigt ihn auf der Detailseite der Ressource. Um zu sehen, zu welcher Identität Ihre CLI-Zugangsdaten gehören, führen Sie aws sts get-caller-identity aus: Eine übernommene Rolle erscheint als arn:aws:sts::123456789012:assumed-role/RoleName/SessionName – das ist die Sitzung, nicht die Rolle selbst (arn:aws:iam::123456789012:role/RoleName). Verwenden Sie in Vertrauens- und Ressourcenrichtlinien den Rollen-ARN.
Laut AWS sind ARNs nicht geheim, sensibel oder vertraulich, sie verraten aber die Konto-ID und Ressourcennamen. Teilen Sie sie also so umsichtig wie jede andere Kennung.
Quellen
Häufige Fragen
Welches Format hat ein AWS-ARN?
arn:partition:service:region:account-id:resource. Der Ressourcenteil ist eine Ressourcen-ID oder ein Ressourcentyp und eine ID, getrennt durch Schrägstrich oder Doppelpunkt, etwa role/MyRole oder function:my-function. Manche ARNs lassen Region, Konto-ID oder beides leer: S3-Bucket-ARNs sehen aus wie arn:aws:s3:::my-bucket.
Warum hat ein IAM- oder S3-ARN leere Felder (:::)?
IAM ist global, IAM-ARNs haben also keine Region (arn:aws:iam::123456789012:role/MyRole). S3-Bucket-Namen sind innerhalb der Partition eindeutig, Bucket- und Objekt-ARNs haben daher weder Region noch Konto-ID (arn:aws:s3:::my-bucket/key).
Ist ein ARN geheim?
Nein. Laut AWS gelten ARNs nicht als geheim, sensibel oder vertraulich, Sie sollten sie aber wie jede Kennung umsichtig teilen. Ein ARN enthält die Konto-ID und den Ressourcennamen.
Kann ich Platzhalter in einem ARN verwenden?
Im Element Resource oder NotResource einer IAM-Richtlinie ja: * steht für beliebige Zeichen und ? für ein Zeichen, wie in arn:aws:s3:::my-bucket/* oder arn:aws:ec2:*:123456789012:vpc/*. Nicht in Principal oder NotPrincipal, nicht im Ressourcentyp (functi*) und nicht in der Partition.
Welche AWS-Partitionen gibt es?
aws für die Standard-AWS-Regionen, aws-cn für die Regionen in China und aws-us-gov für AWS GovCloud (US). Die S3-Dokumentation nennt außerdem aws-eusc für die AWS European Sovereign Cloud. Ein Konto gehört zu genau einer Partition.
Wie finde ich den ARN meiner eigenen IAM-Identität?
Führen Sie aws sts get-caller-identity aus. Der Befehl gibt Ihre Konto-ID und den ARN des Benutzers oder der Assumed-Role-Sitzung zurück, zu der Ihre Zugangsdaten gehören.
Die Suche von CloudConsole findet Instanzen, Funktionen, Buckets, Datenbanken, Log-Gruppen, Alarme und ECS-Services nach Name, ID, ARN oder IP über alle Ihre Konten und Regionen hinweg, und Sie können den ARN oder Konsolen-Link einer Ressource kopieren. Auf iPhone und Android.
Über die App →