AWS ARN パーサー
ARN を解析する
ブラウザ内で、オフラインでも動作します。ARN はどこにも送信されません。ARN は機密情報ではありませんが、アカウント ID を含みます。
Amazon リソースネーム(ARN)は arn:partition:service:region:account-id:resource の形式で、たとえば arn:aws:sns:us-east-1:123456789012:my-topic です。リソース部分は ID、またはタイプと ID を / か : でつないだものです。空のフィールドがある ARN もあり、IAM の ARN にはリージョンがなく、S3 バケットの ARN にはリージョンもアカウントもありません。
ARN の構成要素
ARN は AWS 全体でリソースを一意に識別するため、IAM ポリシー、リソースタグ、多くの API 呼び出しで必要になります。すべての ARN はコロンで区切られた同じ 6 つの部分を持ちますが、リソース部分自体にコロンやスラッシュが含まれることがあります。
| 部分 | CloudConsoleとは | 例 |
|---|---|---|
arn | 固定の接頭辞 | arn |
| partition | リージョンのグループです:aws(AWS リージョン)、aws-cn(中国)、aws-us-gov(GovCloud US)。S3 のドキュメントには aws-eusc(European Sovereign Cloud)もあります。各アカウントは 1 つのパーティションに属します。 | aws |
| service | サービスの名前空間で、製品名と同じとは限りません。Step Functions は states、EventBridge ルールは events、ロードバランサーは elasticloadbalancing です。 | lambda |
| region | リージョンコード。IAM ロール、S3 バケット、CloudFront ディストリビューション、Route 53 ホストゾーンなどのグローバルリソースでは空です。 | us-east-2 |
| account-id | リソースを所有するアカウントの 12 桁の ID(ハイフンなし)。S3 のバケットとオブジェクトでは空、AWS 管理ポリシーでは aws です。 | 123456789012 |
| resource | resource-id、resource-type/resource-id、resource-type:resource-id のいずれかです。親リソースや、バージョンなどの修飾子を含むこともあります。 | function:my-function |
よく使う 27 の AWS サービスの ARN 形式
プレースホルダーは ${…} で示しています。これらは Service Authorization Reference の各サービスのページから取ったもので、ポリシーで使えるすべてのリソースタイプの ARN 形式が記載されています。STS セッションの形式は IAM 識別子のページによります。
| サービス | リソース | ARN 形式 |
|---|---|---|
| IAM | ユーザー | arn:${Partition}:iam::${Account}:user/${UserNameWithPath} |
| IAM | ロール | arn:${Partition}:iam::${Account}:role/${RoleNameWithPath} |
| IAM | ポリシー | arn:${Partition}:iam::${Account}:policy/${PolicyNameWithPath} |
| IAM | グループ | arn:${Partition}:iam::${Account}:group/${GroupNameWithPath} |
| IAM | インスタンスプロファイル | arn:${Partition}:iam::${Account}:instance-profile/${InstanceProfileNameWithPath} |
| IAM | ルートユーザー | arn:${Partition}:iam::${Account}:root |
| STS | 引き受けたロールのセッション | arn:${Partition}:sts::${Account}:assumed-role/${RoleName}/${RoleSessionName} |
| STS | フェデレーティッドユーザー | arn:${Partition}:sts::${Account}:federated-user/${FederatedUserName} |
| Amazon S3 | バケット | arn:${Partition}:s3:::${BucketName} |
| Amazon S3 | オブジェクト | arn:${Partition}:s3:::${BucketName}/${ObjectName} |
| Amazon EC2 | インスタンス | arn:${Partition}:ec2:${Region}:${Account}:instance/${InstanceId} |
| Amazon EC2 | VPC | arn:${Partition}:ec2:${Region}:${Account}:vpc/${VpcId} |
| Amazon EC2 | サブネット | arn:${Partition}:ec2:${Region}:${Account}:subnet/${SubnetId} |
| Amazon EC2 | セキュリティグループ | arn:${Partition}:ec2:${Region}:${Account}:security-group/${SecurityGroupId} |
| Amazon EC2 | EBS ボリューム | arn:${Partition}:ec2:${Region}:${Account}:volume/${VolumeId} |
| Amazon EC2 | AMI | arn:${Partition}:ec2:${Region}::image/${ImageId} |
| AWS Lambda | 関数 | arn:${Partition}:lambda:${Region}:${Account}:function:${FunctionName} |
| AWS Lambda | 関数のバージョン | arn:${Partition}:lambda:${Region}:${Account}:function:${FunctionName}:${Version} |
| AWS Lambda | 関数のエイリアス | arn:${Partition}:lambda:${Region}:${Account}:function:${FunctionName}:${Alias} |
| Amazon DynamoDB | テーブル | arn:${Partition}:dynamodb:${Region}:${Account}:table/${TableName} |
| Amazon SQS | キュー | arn:${Partition}:sqs:${Region}:${Account}:${QueueName} |
| Amazon SNS | トピック | arn:${Partition}:sns:${Region}:${Account}:${TopicName} |
| Amazon RDS | DB インスタンス | arn:${Partition}:rds:${Region}:${Account}:db:${DbInstanceName} |
| Amazon RDS | DB クラスター | arn:${Partition}:rds:${Region}:${Account}:cluster:${DbClusterInstanceName} |
| Amazon ECS | クラスター | arn:${Partition}:ecs:${Region}:${Account}:cluster/${ClusterName} |
| Amazon ECS | service | arn:${Partition}:ecs:${Region}:${Account}:service/${ClusterName}/${ServiceName} |
| Amazon ECS | タスク | arn:${Partition}:ecs:${Region}:${Account}:task/${ClusterName}/${TaskId} |
| Amazon ECS | タスク定義 | arn:${Partition}:ecs:${Region}:${Account}:task-definition/${TaskDefinitionFamilyName}:${TaskDefinitionRevisionNumber} |
| Amazon ECR | リポジトリ | arn:${Partition}:ecr:${Region}:${Account}:repository/${RepositoryName} |
| Amazon EKS | クラスター | arn:${Partition}:eks:${Region}:${Account}:cluster/${ClusterName} |
| AWS KMS | キー | arn:${Partition}:kms:${Region}:${Account}:key/${KeyId} |
| AWS KMS | エイリアス | arn:${Partition}:kms:${Region}:${Account}:alias/${Alias} |
| Secrets Manager | シークレット | arn:${Partition}:secretsmanager:${Region}:${Account}:secret:${SecretId} |
| CloudWatch Logs | ロググループ | arn:${Partition}:logs:${Region}:${Account}:log-group:${LogGroupName} |
| CloudWatch | アラーム | arn:${Partition}:cloudwatch:${Region}:${Account}:alarm:${AlarmName} |
| Step Functions | ステートマシン | arn:${Partition}:states:${Region}:${Account}:stateMachine:${StateMachineName} |
| Step Functions | 実行 | arn:${Partition}:states:${Region}:${Account}:execution:${StateMachineName}:${ExecutionId} |
| EventBridge | ルール(デフォルトのバス) | arn:${Partition}:events:${Region}:${Account}:rule/${RuleName} |
| EventBridge | ルール(カスタムバス) | arn:${Partition}:events:${Region}:${Account}:rule/${EventBusName}/${RuleName} |
| EventBridge | イベントバス | arn:${Partition}:events:${Region}:${Account}:event-bus/${EventBusName} |
| EventBridge Scheduler | スケジュール | arn:${Partition}:scheduler:${Region}:${Account}:schedule/${GroupName}/${ScheduleName} |
| CloudFormation | スタック | arn:${Partition}:cloudformation:${Region}:${Account}:stack/${StackName}/${Id} |
| API Gateway | REST API | arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId} |
| CloudFront | ディストリビューション | arn:${Partition}:cloudfront::${Account}:distribution/${DistributionId} |
| Route 53 | ホストゾーン | arn:${Partition}:route53:::hostedzone/${Id} |
| Certificate Manager | 証明書 | 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 | ターゲットグループ | arn:${Partition}:elasticloadbalancing:${Region}:${Account}:targetgroup/${TargetGroupName}/${TargetGroupId} |
| Systems Manager | パラメータ | arn:${Partition}:ssm:${Region}:${Account}:parameter/${ParameterNameWithoutLeadingSlash} |
| Kinesis Data Streams | ストリーム | arn:${Partition}:kinesis:${Region}:${Account}:stream/${StreamName} |
つまずきやすい点がいくつかあります。SQS キューと SNS トピックの ARN にはリソースタイプがなく、名前だけです。バージョンやエイリアスの接尾辞(:prod、:3)が付いた Lambda の ARN は「修飾付き」で、そのバージョンだけを指します。ECS タスク定義の ARN は family:revision で終わります。WithPath の IAM 名にはパスが含まれるため、サービスロールは role/service-role/MyRole のようになります。
パス、ワイルドカード、不完全な ARN
- パス。IAM のユーザー、グループ、ロール、ポリシーの名前にはパスを含めることができ、S3 のオブジェクトキーはフォルダのようにスラッシュを使います。IAM のパスには英字、数字、
/ + = , . @ _ -を使えます。 - ワイルドカード。ポリシーの
ResourceまたはNotResource要素では、*は任意の文字列、?は任意の 1 文字に一致します。例:arn:aws:iam::123456789012:role/service-*、arn:aws:s3:::amzn-s3-demo-bucket/????-test、全リージョンのすべての VPC ならarn:aws:ec2:*:123456789012:vpc/*。PrincipalやNotPrincipal、リソースタイプ(functi*)、パーティションでは使えません。 - 不完全な ARN。アイデンティティベースのポリシーでは、6 つ未満の部分しかない ARN はワイルドカードで補われます。つまり
arn:aws:sqsはarn:aws:sqs:*:*:*、すべてのリージョンとアカウントのすべてのキューを意味します。AssumeRole に渡すセッションポリシーは不完全な ARN を受け付けず、MalformedPolicyDocumentExceptionで失敗します。
ARN の調べ方
describe-、get-、list- のコマンドの多くは名前と一緒に ARN を返し、コンソールではリソースの詳細ページに表示されます。CLI の認証情報がどの ID のものかを確認するには aws sts get-caller-identity を実行します。引き受けたロールは arn:aws:sts::123456789012:assumed-role/RoleName/SessionName と表示されますが、これはセッションでありロールそのもの(arn:aws:iam::123456789012:role/RoleName)ではありません。信頼ポリシーやリソースポリシーではロールの ARN を使ってください。
AWS は ARN を秘密情報、機密情報、極秘情報とはみなしていませんが、ARN からアカウント ID やリソース名がわかるため、ほかの識別子と同じように注意して共有してください。
出典
よくある質問
AWS の ARN の形式は?
arn:partition:service:region:account-id:resource です。リソース部分はリソース ID、または role/MyRole や function:my-function のようにリソースタイプと ID をスラッシュかコロンで区切ったものです。リージョン、アカウント ID、またはその両方が空の ARN もあり、S3 バケットの ARN は arn:aws:s3:::my-bucket のようになります。
IAM や S3 の ARN に空のフィールド(:::)があるのはなぜですか?
IAM はグローバルなので、IAM の ARN にはリージョンがありません(arn:aws:iam::123456789012:role/MyRole)。S3 のバケット名はパーティション内で一意なので、バケットとオブジェクトの ARN にはリージョンもアカウント ID もありません(arn:aws:s3:::my-bucket/key)。
ARN は秘密情報ですか?
いいえ。AWS は ARN を秘密情報、機密情報、極秘情報とはみなしていませんが、ほかの識別子と同様に注意して共有してください。ARN にはアカウント ID とリソース名が含まれます。
ARN にワイルドカードを使えますか?
IAM ポリシーの Resource または NotResource 要素では使えます。arn:aws:s3:::my-bucket/* や arn:aws:ec2:*:123456789012:vpc/* のように、* は任意の文字列、? は任意の 1 文字に一致します。Principal や NotPrincipal、リソースタイプ(functi*)、パーティションでは使えません。
AWS のパーティションとは?
標準の AWS リージョンは aws、中国のリージョンは aws-cn、AWS GovCloud (US) は aws-us-gov です。S3 のドキュメントには AWS European Sovereign Cloud の aws-eusc もあります。アカウントは 1 つのパーティションに属します。
自分の IAM ID の ARN を調べるには?
aws sts get-caller-identity を実行してください。アカウント ID と、認証情報が属するユーザーまたは引き受けたロールのセッションの ARN が返されます。
CloudConsole の検索は、インスタンス、関数、バケット、データベース、ロググループ、アラーム、ECS サービスを、名前、ID、ARN、IP で、すべてのアカウントとリージョンにわたって見つけ、リソースの ARN やコンソールリンクをコピーできます。iPhone と Android に対応。
アプリについて →