AWS X-Ray のアクション、リソース、および条件キー - サービス認証リファレンス

「翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。」

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

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

参照:

AWS X-Ray で定義されるアクション

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

[リソースタイプ] 列は、各アクションがリソースレベルのアクセス許可をサポートしているかどうかを示します。この列に値がない場合は、ポリシーステートメントの Resource 要素ですべてのリソース (「*」) を指定する必要があります。列にリソースタイプが含まれる場合、そのアクションを含むステートメントでそのタイプの ARN を指定できます。必須リソースは、アスタリスク (*) でテーブルに示されています。このアクションを使用してステートメントでリソースレベルのアクセス許可 ARN を指定する場合、このタイプである必要があります。一部のアクションでは、複数のリソースタイプがサポートされています。リソースタイプがオプション (必須として示されていない) の場合、一方を使用することはできますが、他方を使用することはできません。

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

アクション 説明 アクセスレベル リソースタイプ (* 必須) 条件キー 依存アクション
BatchGetTraces ID で指定されたトレースのリストを取得するアクセス許可を付与します。各トレースは、単一のリクエストに由来するセグメントドキュメントのコレクションです。GetTraceSummaries を使用して、トレース ID のリストを取得します。 リスト
CreateGroup 名前とフィルタ式を使用してグループリソースを作成するアクセス許可を付与します。 書き込み

group*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateSamplingRule 計測機能が搭載されたアプリケーションのサンプリング動作を制御するルールを作成するアクセス許可を付与します。 書き込み

sampling-rule*

aws:RequestTag/${TagKey}

aws:TagKeys

DeleteGroup グループリソースを削除するアクセス許可を付与します。 書き込み

group*

aws:ResourceTag/${TagKey}

DeleteSamplingRule サンプリングルールを削除するアクセス許可を付与します。 書き込み

sampling-rule*

aws:ResourceTag/${TagKey}

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 に渡します。 Read
ListTagsForResource X-Ray リソースのタグを一覧表示するアクセス許可を付与します リスト

group

sampling-rule

PutEncryptionConfig X-Ray データの暗号化構成を更新するアクセス許可を付与します。 アクセス権限の管理
PutTelemetryRecords AWS X-Ray デーモンのテレメトリをサービスに送信するアクセス許可を付与します。 書き込み
PutTraceSegments セグメントドキュメントを AWS X-Ray にアップロードするアクセス許可を付与します。X-Ray SDK はセグメントドキュメントを生成し、X-Ray デーモンに送信して、X-Ray デーモンはそれらをバッチ単位でアップロードします。 書き込み
TagResource X-Ray リソースにタグを追加するアクセス許可を付与します。 タグ付け

group

sampling-rule

aws:TagKeys

aws:RequestTag/${TagKey}

UntagResource X-Ray リソースからタグを削除するアクセス許可を付与します。 タグ付け

group

sampling-rule

aws:TagKeys

UpdateGroup グループリソースを更新するアクセス許可を付与します。 書き込み

group*

aws:ResourceTag/${TagKey}

UpdateSamplingRule サンプリングルールの構成を変更するアクセス許可を付与します。 書き込み

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 リクエストで渡されたタグキーに基づいてアクションをフィルタリングします。 文字列