DevToolbox

AWS ARNパーサー＆ビルダー

AWS ARN文字列をコンポーネントに分解、または個別フィールドから有効なARNを構築します。

このツールについて

AWS ARNパーサーは、Amazon Resource Name（ARN）文字列を個々のコンポーネント （パーティション、サービス、リージョン、アカウントID、リソースタイプ、リソースID）に 分解する無料のブラウザベースツールです。また、個別のフィールドから有効なARNを構築する ビルダーモードも搭載しており、IAMポリシー、CloudFormationテンプレート、 CLIコマンドの作成時に便利です。

ARNはarn:partition:service:region:account-id:resourceの形式に従いますが、 リソース部分はサービスによって異なります。スラッシュ区切り （resource-type/resource-id）を使用するものもあれば、コロン区切り （resource-type:resource-id）を使用するものもあり、S3のようにリージョンと アカウントIDを省略するサービスもあります。このツールはこれらのバリエーションを すべて自動的に処理し、各コンポーネントにコンテキストに応じた説明を提供します。

AWS IAMポリシーでJSONのフォーマットが必要な場合は、 JSONフォーマッターをお試しください。 CloudFormationテンプレートでYAMLとJSON間の変換には、 YAMLフォーマッターが便利です。 JSON設定をYAMLに変換する必要がある場合は、 JSON to YAML変換をご確認ください。

一般的なARNパターン参照テーブルには、15の人気AWSサービスのフォーマットが 表示され、ワンクリックの「Try it」ボタンでパーサーに自動入力できます。 これにより、あまり馴染みのないサービスのARNフォーマットも簡単に学べます。

すべての処理はブラウザ内で完全に実行されます。ARN文字列がサーバーに送信される ことはなく、本番のアカウントID、リソース名、機密識別子でも安全に使用できます。

使い方

  1. 上部のトグルボタンでParse ARNモード（デフォルト）またはBuild ARNモードを選択します。
  2. Parseモードでは、ARN InputテキストエリアにAWS ARN文字列を貼り付けます（例：arn:aws:s3:::my-bucket）。
  3. ParseをクリックするかCtrl+Enterを押して、ARNをコンポーネントに分解します。
  4. パーティション、サービス、リージョン、アカウントID、リソースタイプ、リソースIDと説明が表示された解析結果テーブルを確認します。
  5. Visual Breakdownセクションで、元のARN文字列の各コンポーネントが色分けされた表示を確認します。
  6. Buildモードでは、個別のフィールド（パーティション、サービス、リージョン、アカウントID、リソースタイプ、リソースID）を入力すると、ツールがリアルタイムでARN文字列を生成します。
  7. CopyをクリックするかCtrl+Shift+Cを押してARNをクリップボードにコピーします。Common ARN Patternsテーブルで人気AWSサービスのフォーマットを確認できます。

人気のAWS ARNの例

すべてのAWS ARNの例を見る →

よくある質問

AWS ARNとは何ですか？

Amazon Resource Name（ARN）はAWSリソースの一意識別子です。ARNはarn:partition:service:region:account-id:resourceの形式に従い、IAMポリシー、API呼び出し、CloudFormationテンプレート、CLIコマンドで、参照されるリソースを正確に指定するために使用されます。

なぜ一部のARNではリージョンやアカウントIDが空なのですか？

一部のAWSサービスはグローバルで、特定のリージョンに紐付いていません（IAMやS3など）。これらのサービスでは、ARNのリージョンやアカウントIDフィールドが空になります。例えば、S3バケットARNはarn:aws:s3:::bucket-nameのように、リージョンとアカウントIDの両方が空です。S3バケット名はグローバルで一意だからです。

リソース区切り文字の / と : の違いは何ですか？

AWSサービスはリソースタイプとリソースIDを区切るために2つの異なる規則を使用します。ほとんどのサービスはスラッシュ（/）を使用します（例：arn:aws:iam::123456789012:user/johndoe）。一部のサービスはコロン（:）を使用します（例：arn:aws:lambda:us-east-1:123456789012:function:my-function）。パーサーは両方の形式を自動的に処理します。

AWSパーティションとは何ですか？

AWSには3つのパーティションがあります：標準的な商用リージョン用の'aws'、中国リージョン（北京と寧夏）用の'aws-cn'、GovCloud（US）リージョン用の'aws-us-gov'です。パーティションは'arn:'の後の最初のコンポーネントで、利用可能なAWSエンドポイントとサービスのセットを決定します。

複数のARNを一度に解析できますか？

現在、ツールは一度に1つのARNを解析します。複数のARNを解析するには、それぞれ個別に貼り付けてください。パーサーは即座に入力を処理するため、ARN間の切り替えは高速です。Common ARN Patternsテーブルの「Try it」ボタンを使って、すばやく例を読み込むこともできます。

データは安全ですか？

はい。すべてのARN解析と構築はJavaScriptを使用してブラウザ内で完全に実行されます。データがサーバーに送信されることはありません。アカウントID、リソース名、ARN文字列はお使いのマシンに残ります。ツール使用中にブラウザの開発者ツールのネットワークタブで確認できます。

ツールはARNの正確性を検証しますか？

ツールは基本的なARN構造を検証します（'arn:'で始まること、正しい数のコロン区切りセグメントがあること、パーティションとサービスフィールドが空でないこと）。特定のリソースがAWSアカウントに実際に存在するかどうか、またはリージョン/サービスの組み合わせが有効かどうかの検証は行いません。

関連ツール

AWS IAMポリシージェネレーター

ビジュアルフォームからAWS IAMポリシーJSONドキュメントを生成。サービス、アクション、リソース、条件を選択。

AWS S3 URLパーサー

AWS S3 URLをバケット、キー、リージョン、URLスタイルに分解します。コンポーネントからS3 URLを構築することも可能。

AWS CLIコマンドビルダー

AWS CLIコマンドをビジュアルに構築します。サービスと操作を選択し、パラメータを入力して、すぐに使えるawsコマンドを生成。

JSONフォーマッター

JSONの整形、検証、ツリー表示をシンタックスハイライト付きで行えます。

YAMLフォーマッター

カスタマイズ可能なインデントと構文エラー表示でYAMLの整形、検証、圧縮を行います。