CloudConsole

AWS ARN パーサー

無料、ブラウザで動作 · 27 サービスの 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 つの部分を持ちますが、リソース部分自体にコロンやスラッシュが含まれることがあります。

ARN の部分
部分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
resourceresource-id、resource-type/resource-id、resource-type:resource-id のいずれかです。親リソースや、バージョンなどの修飾子を含むこともあります。function:my-function

よく使う 27 の AWS サービスの ARN 形式

プレースホルダーは ${…} で示しています。これらは Service Authorization Reference の各サービスのページから取ったもので、ポリシーで使えるすべてのリソースタイプの ARN 形式が記載されています。STS セッションの形式は IAM 識別子のページによります。

サービスとリソースタイプ別の ARN 形式
サービスリソース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 EC2VPCarn:${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 EC2EBS ボリュームarn:${Partition}:ec2:${Region}:${Account}:volume/${VolumeId}
Amazon EC2AMIarn:${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 RDSDB インスタンスarn:${Partition}:rds:${Region}:${Account}:db:${DbInstanceName}
Amazon RDSDB クラスターarn:${Partition}:rds:${Region}:${Account}:cluster:${DbClusterInstanceName}
Amazon ECSクラスターarn:${Partition}:ecs:${Region}:${Account}:cluster/${ClusterName}
Amazon ECSservicearn:${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 GatewayREST APIarn:${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 BalancingApplication Load Balancerarn:${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 が返されます。

ARN でリソースを探す

CloudConsole の検索は、インスタンス、関数、バケット、データベース、ロググループ、アラーム、ECS サービスを、名前、ID、ARN、IP で、すべてのアカウントとリージョンにわたって見つけ、リソースの ARN やコンソールリンクをコピーできます。iPhone と Android に対応。

アプリについて →