AWS X-Ray のアクション、リソース、および条件キー

AWS X-Ray (サービスプレフィックス: xray) では、IAM 許可ポリシーで使用できるように、以下のサービス固有のリソース、アクション、条件コンテキストキーが用意されています。

参照:

• このサービスを設定する方法について説明します。

• このサービスで使用可能な API オペレーションのリストを表示します。

• IAM アクセス許可ポリシーを使用して、このサービスとそのリソースを保護する方法を学びます。

AWS X-Ray によって定義されるアクション

IAM ポリシーステートメントの Action エレメントでは、以下のアクションを指定できます。ポリシーを使用して、AWS でオペレーションを実行するアクセス許可を付与します。ポリシーでアクションを使用する場合は、通常、同じ名前の API オペレーションまたは CLI コマンドへのアクセスを許可または拒否します。ただし、場合によっては、1 つのアクションによって複数のオペレーションへのアクセスが制御されます。あるいは、いくつかのオペレーションはいくつかの異なるアクションを必要とします。

[アクション] テーブルの [リソースタイプ] 列は、各アクションがリソースレベルの許可をサポートしているかどうかを示します。この列に値がない場合は、ポリシーステートメントの Resource 要素で、ポリシーが適用されるすべてのリソース (「*」) を指定する必要があります。列にリソースタイプが含まれる場合、そのアクションを含むステートメントでそのタイプの ARN を指定できます。アクションで 1 つ以上のリソースが必須となっている場合、呼び出し元には、それらのリソースを伴うアクションを使用するための許可が付与されている必要があります。必須リソースは、アスタリスク (*) でテーブルに示されています。IAM ポリシーの Resource 要素でリソースアクセスを制限する場合は、必要なリソースタイプごとに ARN またはパターンを含める必要があります。一部のアクションでは、複数のリソースタイプがサポートされています。リソースタイプがオプション (必須として示されていない) の場合、オプションのリソースタイプのいずれかを使用することを選択できます。

[アクション] テーブルの [条件キー] 列には、ポリシーステートメントの Condition 要素で指定できるキーが含まれます。サービスのリソースに関連付けられている条件キーの詳細については、[リソースタイプ] テーブルの [条件キー] 列を参照してください。

注記

リソース条件キーは、リソースタイプテーブルに一覧表示されています。アクションに適用されるリソースタイプへのリンクは、[アクション] テーブルの [リソースタイプ (* 必須)] 列にあります。[リソースタイプ] テーブルのリソースタイプには、[アクション] テーブルのアクションに適用されるリソース条件キーである、[条件キー] 列が含まれています。

以下の表の列の詳細については、「アクションテーブル」を参照してください。

アクション	説明	アクセスレベル	リソースタイプ (* 必須)	条件キー	依存アクション
BatchGetTraceSummaryById [アクセス許可のみ]	ID で指定されたトレースリストのメタデータを取得する許可を付与	読み込み
BatchGetTraces	ID で指定されたトレースのリストを取得する許可を付与。各トレースは、単一のリクエストに由来するセグメントドキュメントのコレクションです。GetTraceSummaries を使用して、トレース ID のリストを取得します。	リスト
CreateGroup	名前とフィルタ式を使用してグループリソースを作成する許可を付与。	Write	group*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateSamplingRule	計測機能が搭載されたアプリケーションのサンプリング動作を制御するルールを作成する許可を付与。	Write	sampling-rule*
				aws:RequestTag/${TagKey} aws:TagKeys
DeleteGroup	グループリソースを削除する許可を付与。	書き込み	group*
				aws:ResourceTag/${TagKey}
DeleteResourcePolicy	リソースポリシーを削除する許可を付与	書き込み
DeleteSamplingRule	サンプリングルールを削除する許可を付与。	書き込み	sampling-rule*
				aws:ResourceTag/${TagKey}
GetDistinctTraceGraphs [アクセス許可のみ]	1 つ以上の特定のトレース ID の異なるサービスグラフを取得する許可を付与	読み込み
GetEncryptionConfig	X-Ray データの現在の暗号化設定を取得する許可を付与。	Read
GetGroup	グループリソースの詳細を取得する許可を付与。	Read	group*
				aws:ResourceTag/${TagKey}
GetGroups	アクティブなグループの詳細をすべて取得する許可を付与。	Read
GetInsight	特定のインサイトの詳細を取得する許可を付与。	Read
GetInsightEvents	特定のインサイトのイベントを取得する許可を付与。	Read
GetInsightImpactGraph	特定のインサイトに影響を受けるサービスグラフの一部を取得する許可を付与。	Read
GetInsightSummaries	オプションのフィルタを使用して、グループおよび時間範囲のすべてのインサイトの概要を取得する許可を付与。	Read
GetSamplingRules	すべてのサンプリングルールを取得する許可を付与。	Read
GetSamplingStatisticSummaries	すべてのサンプリングルールについて、最近のサンプリング結果に関する情報を取得する許可を付与。	Read
GetSamplingTargets	サービスがリクエストのサンプリングに使用しているルールのサンプリングクォータを要求する許可を付与。	Read
GetServiceGraph	受信リクエストを処理するサービスと、その結果として呼び出されるダウンストリームサービスを記述するドキュメントを取得する許可を付与。	Read
GetTimeSeriesServiceStatistics	時間間隔にバケット化された特定の時間範囲によって定義されるサービス統計情報の集計を取得する許可を付与。	Read
GetTraceGraph	1 つ以上の特定のトレース ID のサービスグラフを取得する許可を付与。	Read
GetTraceSummaries	オプションのフィルタを使用して、指定したタイムフレームで使用可能なトレースの ID とメタデータを取得する許可を付与。トレース全体を取得するには、トレース ID を BatchGetTraces に渡します。	読み込み
Link [アクセス許可のみ]	モニタリングアカウントに X-Ray リソースを共有する許可を付与	書き込み
ListResourcePolicies	リソースポリシーを一覧表示する許可を付与	リスト
ListTagsForResource	X-Ray リソースのタグを一覧表示する許可を付与	リスト	group
			sampling-rule
PutEncryptionConfig	X-Ray データの暗号化構成を更新する許可を付与。	経営へのアクセス権
PutResourcePolicy	リソースポリシーを作成または更新する許可を付与	書き込み
PutTelemetryRecords	AWS X-Ray デーモンのテレメトリをサービスに送信する許可を付与	Write
PutTraceSegments	セグメントドキュメントを AWS X-Ray にアップロードする許可を付与します。X-Ray SDK はセグメントドキュメントを生成し、X-Ray デーモンに送信して、X-Ray デーモンはそれらをバッチ単位でアップロードします。	Write
TagResource	X-Ray リソースにタグを追加する許可を付与。	タグ付け	group
			sampling-rule
				aws:TagKeys aws:RequestTag/${TagKey}
UntagResource	X-Ray リソースからタグを削除する許可を付与。	タグ付け	group
			sampling-rule
				aws:TagKeys
UpdateGroup	グループリソースを更新する許可を付与。	Write	group*
				aws:ResourceTag/${TagKey}
UpdateSamplingRule	サンプリングルールの構成を変更する許可を付与。	Write	sampling-rule*
				aws:ResourceTag/${TagKey}

AWS X-Ray で定義されるリソースタイプ

以下のリソースタイプは、このサービスによって定義され、IAM アクセス許可ポリシーステートメントの Resource エレメントで使用できます。アクションテーブルの各アクションは、そのアクションで指定できるリソースタイプを示しています。リソースタイプは、ポリシーに含めることができる条件キーを定義することもできます。これらのキーは、[リソースタイプ] テーブルの最後の列に表示されます。以下の表の列の詳細については、「リソースタイプテーブル」を参照してください。

リソースタイプ	ARN	条件キー
group	arn:${Partition}:xray:${Region}:${Account}:group/${GroupName}/${Id}	aws:ResourceTag/${TagKey}
sampling-rule	arn:${Partition}:xray:${Region}:${Account}:sampling-rule/${SamplingRuleName}	aws:ResourceTag/${TagKey}

AWS X-Ray の条件キー

AWS X-Ray では、IAM ポリシーの Condition 要素で使用できる以下の条件キーを定義します。これらのキーを使用して、ポリシーステートメントが適用される条件をさらに絞り込むことができます。以下の表の列の詳細については、「条件キーテーブル」を参照してください。

すべてのサービスで使用できるグローバル条件キーを確認するには、「使用できるグローバル条件キー」を参照してください。

条件キー	説明	タイプ
aws:RequestTag/${TagKey}	リクエストで渡されたタグでアクセスをフィルタリング	文字列
aws:ResourceTag/${TagKey}	リソースに関連付けられたタグでアクセスをフィルタリング	文字列
aws:TagKeys	リクエストで渡されたタグキーでアクセスをフィルタリング	ArrayOfString