CloudConsole

AWS-ARN-Parser

Kostenlos, im Browser · ARN-Formate für 27 Services · funktioniert offline

ARN zerlegen

Läuft in Ihrem Browser, auch offline: Der ARN wird nirgendwohin gesendet. ARNs sind nicht geheim, enthalten aber Ihre Konto-ID.

Kurze Antwort

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:

ARN-Teile
TeilWas es istBeispiel
arnFestes Präfixarn
partitionDie 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
serviceDer Service-Namespace, der nicht immer dem Produktnamen entspricht: Step Functions ist states, EventBridge-Regeln sind events, Load Balancer elasticloadbalancing.lambda
regionDer Regionscode, oder leer bei globalen Ressourcen wie IAM-Rollen, S3-Buckets, CloudFront-Distributionen und gehosteten Zonen in Route 53.us-east-2
account-idDie 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
resourceresource-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.

ARN-Formate nach Service und Ressourcentyp
ServiceRessourceARN-Format
IAMBenutzerarn:${Partition}:iam::${Account}:user/${UserNameWithPath}
IAMRollearn:${Partition}:iam::${Account}:role/${RoleNameWithPath}
IAMRichtliniearn:${Partition}:iam::${Account}:policy/${PolicyNameWithPath}
IAMGruppearn:${Partition}:iam::${Account}:group/${GroupNameWithPath}
IAMInstanzprofilarn:${Partition}:iam::${Account}:instance-profile/${InstanceProfileNameWithPath}
IAMRoot-Benutzerarn:${Partition}:iam::${Account}:root
STSAssumed-Role-Sitzungarn:${Partition}:sts::${Account}:assumed-role/${RoleName}/${RoleSessionName}
STSföderierter Benutzerarn:${Partition}:sts::${Account}:federated-user/${FederatedUserName}
Amazon S3Bucketarn:${Partition}:s3:::${BucketName}
Amazon S3Objektarn:${Partition}:s3:::${BucketName}/${ObjectName}
Amazon EC2Instanzarn:${Partition}:ec2:${Region}:${Account}:instance/${InstanceId}
Amazon EC2VPCarn:${Partition}:ec2:${Region}:${Account}:vpc/${VpcId}
Amazon EC2Subnetzarn:${Partition}:ec2:${Region}:${Account}:subnet/${SubnetId}
Amazon EC2Sicherheitsgruppearn:${Partition}:ec2:${Region}:${Account}:security-group/${SecurityGroupId}
Amazon EC2EBS-Volumearn:${Partition}:ec2:${Region}:${Account}:volume/${VolumeId}
Amazon EC2AMIarn:${Partition}:ec2:${Region}::image/${ImageId}
AWS LambdaFunktionarn:${Partition}:lambda:${Region}:${Account}:function:${FunctionName}
AWS LambdaFunktionsversionarn:${Partition}:lambda:${Region}:${Account}:function:${FunctionName}:${Version}
AWS LambdaFunktionsaliasarn:${Partition}:lambda:${Region}:${Account}:function:${FunctionName}:${Alias}
Amazon DynamoDBTabellearn:${Partition}:dynamodb:${Region}:${Account}:table/${TableName}
Amazon SQSWarteschlangearn:${Partition}:sqs:${Region}:${Account}:${QueueName}
Amazon SNSTopicarn:${Partition}:sns:${Region}:${Account}:${TopicName}
Amazon RDSDB-Instanzarn:${Partition}:rds:${Region}:${Account}:db:${DbInstanceName}
Amazon RDSDB-Clusterarn:${Partition}:rds:${Region}:${Account}:cluster:${DbClusterInstanceName}
Amazon ECSClusterarn:${Partition}:ecs:${Region}:${Account}:cluster/${ClusterName}
Amazon ECSservicearn:${Partition}:ecs:${Region}:${Account}:service/${ClusterName}/${ServiceName}
Amazon ECSTaskarn:${Partition}:ecs:${Region}:${Account}:task/${ClusterName}/${TaskId}
Amazon ECSTask-Definitionarn:${Partition}:ecs:${Region}:${Account}:task-definition/${TaskDefinitionFamilyName}:${TaskDefinitionRevisionNumber}
Amazon ECRRepositoryarn:${Partition}:ecr:${Region}:${Account}:repository/${RepositoryName}
Amazon EKSClusterarn:${Partition}:eks:${Region}:${Account}:cluster/${ClusterName}
AWS KMSSchlüsselarn:${Partition}:kms:${Region}:${Account}:key/${KeyId}
AWS KMSAliasarn:${Partition}:kms:${Region}:${Account}:alias/${Alias}
Secrets ManagerSecretarn:${Partition}:secretsmanager:${Region}:${Account}:secret:${SecretId}
CloudWatch LogsLog-Gruppearn:${Partition}:logs:${Region}:${Account}:log-group:${LogGroupName}
CloudWatchAlarmarn:${Partition}:cloudwatch:${Region}:${Account}:alarm:${AlarmName}
Step FunctionsZustandsautomatarn:${Partition}:states:${Region}:${Account}:stateMachine:${StateMachineName}
Step FunctionsAusführungarn:${Partition}:states:${Region}:${Account}:execution:${StateMachineName}:${ExecutionId}
EventBridgeRegel (Standard-Bus)arn:${Partition}:events:${Region}:${Account}:rule/${RuleName}
EventBridgeRegel (eigener Bus)arn:${Partition}:events:${Region}:${Account}:rule/${EventBusName}/${RuleName}
EventBridgeEvent-Busarn:${Partition}:events:${Region}:${Account}:event-bus/${EventBusName}
EventBridge SchedulerZeitplanarn:${Partition}:scheduler:${Region}:${Account}:schedule/${GroupName}/${ScheduleName}
CloudFormationStackarn:${Partition}:cloudformation:${Region}:${Account}:stack/${StackName}/${Id}
API GatewayREST-APIarn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}
CloudFrontDistributionarn:${Partition}:cloudfront::${Account}:distribution/${DistributionId}
Route 53gehostete Zonearn:${Partition}:route53:::hostedzone/${Id}
Certificate ManagerZertifikatarn:${Partition}:acm:${Region}:${Account}:certificate/${CertificateId}
Elastic Load BalancingApplication Load Balancerarn:${Partition}:elasticloadbalancing:${Region}:${Account}:loadbalancer/app/${LoadBalancerName}/${LoadBalancerId}
Elastic Load BalancingZielgruppearn:${Partition}:elasticloadbalancing:${Region}:${Account}:targetgroup/${TargetGroupName}/${TargetGroupId}
Systems ManagerParameterarn:${Partition}:ssm:${Region}:${Account}:parameter/${ParameterNameWithoutLeadingSlash}
Kinesis Data StreamsStreamarn:${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 Resource oder NotResource einer Richtlinie steht * für beliebige Zeichen und ? für ein Zeichen: arn:aws:iam::123456789012:role/service-*, arn:aws:s3:::amzn-s3-demo-bucket/????-test oder arn:aws:ec2:*:123456789012:vpc/* für jede VPC in jeder Region. Sie sind nicht erlaubt in Principal oder NotPrincipal, 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:sqs bedeutet also arn:aws:sqs:*:*:*: jede Warteschlange in jeder Region und jedem Konto. Sitzungsrichtlinien für AssumeRole akzeptieren keine unvollständigen ARNs und scheitern mit MalformedPolicyDocumentException.

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.

Eine Ressource über ihren ARN finden

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 →