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

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

Amazon CloudWatch のアクション、リソース、および条件キー

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

参照:

Amazon CloudWatch で定義されるアクション

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

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

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

アクション 説明 アクセスレベル リソースタイプ (* 必須) 条件キー 依存アクション
DeleteAlarms アラームのコレクションを削除するアクセス許可を付与します。 書き込み

alarm*

DeleteAnomalyDetector 指定した異常検出モデルをアカウントから削除するアクセス許可を付与します。 書き込み
DeleteDashboards 指定したすべての CloudWatch ダッシュボードを削除するアクセス許可を付与します 書き込み

dashboard*

DeleteInsightRules インサイトルールのコレクションを削除するアクセス許可を付与します。 書き込み

insight-rule*

DeleteMetricStream 指定した CloudWatch メトリックストリームを削除するアクセス許可を付与します。 書き込み

metric-stream*

DescribeAlarmHistory 指定したアラームの履歴を取得するアクセス許可を付与します。 Read

alarm*

DescribeAlarms ユーザーのアカウントが現在所有しているすべてのアラームを記述するアクセス許可を付与します。 Read

alarm*

DescribeAlarmsForMetric ユーザーのアカウントが現在所有している、指定したメトリクスで設定されているすべてのアラームを記述するアクセス許可を付与します。 Read
DescribeAnomalyDetectors アカウントで作成した異常検出モデルを一覧表示するアクセス許可を付与します。 Read
DescribeInsightRules ユーザーのアカウントが現在所有しているすべてのインサイトルールを記述するアクセス許可を付与します。 Read
DisableAlarmActions アラームのコレクションに対するアクションを無効にするアクセス許可を付与します。 書き込み

alarm*

DisableInsightRules インサイトルールのコレクションを無効にするアクセス許可を付与します。 書き込み

insight-rule*

EnableAlarmActions アラームのコレクションに対するアクションを有効にするアクセス許可を付与します。 書き込み

alarm*

EnableInsightRules インサイトルールのコレクションを有効にするアクセス許可を付与します。 書き込み

insight-rule*

GetDashboard 指定した CloudWatch ダッシュボードの詳細を表示するアクセス許可を付与します。 Read

dashboard*

GetInsightRuleReport 特定のインサイトルールについて、時間範囲内で一意のコントリビュータの top-N レポートを返すアクセス許可を付与します。 Read

insight-rule*

GetMetricData CloudWatch メトリクスデータのバッチ容量を取得し、取得したデータで Metric Math を行うアクセス許可を付与します。 Read
GetMetricStatistics 指定したメトリクスの統計を取得するアクセス許可を付与します。 Read
GetMetricStream CloudWatch メトリックストリームの詳細を返すアクセス許可を付与します。 Read

metric-stream*

GetMetricWidgetImage メトリクスウィジェットのスナップショットを取得するアクセス許可を付与します Read
ListDashboards アカウント内のすべての CloudWatch ダッシュボードのリストを返すアクセス許可を付与します。 リスト
ListMetricStreams アカウント内のすべての CloudWatch メトリックストリームのリストを返すアクセス許可を付与します。 リスト
ListMetrics AWS アカウント所有者用に保存されている有効なメトリクスのリストを取得するアクセス許可を付与します。 リスト
ListTagsForResource Amazon CloudWatch リソースのタグを一覧表示するアクセス許可を付与します。 リスト

alarm

insight-rule

シナリオ: CloudWatch-Alarm

alarm*

シナリオ: CloudWatch-InsightRule

insight-rule*

PutAnomalyDetector CloudWatch メトリクスの異常検出モデルを作成または更新するアクセス許可を付与します。 書き込み
PutCompositeAlarm 複合アラームを作成または更新するアクセス許可を付与します。 書き込み

alarm*

aws:RequestTag/${TagKey}

aws:TagKeys

PutDashboard CloudWatch ダッシュボードを作成したり、既存のダッシュボード (存在する場合) を更新したりするアクセス許可を付与します。 書き込み

dashboard*

PutInsightRule 新しいインサイトルールを作成したり、既存のインサイトルールを置き換えるアクセス許可を付与します。 書き込み

insight-rule*

aws:RequestTag/${TagKey}

aws:TagKeys

PutMetricAlarm アラームを作成または更新するアクセス許可を付与し、指定した Amazon CloudWatch メトリクスに関連付けます。 書き込み

alarm*

aws:RequestTag/${TagKey}

aws:TagKeys

PutMetricData メトリクスデータポイントを Amazon CloudWatch に発行するアクセス許可を付与します。 書き込み

cloudwatch:namespace

PutMetricStream CloudWatch メトリックストリームを作成するアクセス許可を、既存のメトリックストリームがすでに存在する場合は、既存のメトリックストリームを更新するアクセス許可を付与します。 書き込み

metric-stream*

SetAlarmState テスト目的でアラームの状態を一時的に設定するアクセス許可を付与します。 書き込み

alarm*

StartMetricStreams 指定したすべての CloudWatch メトリックストリームを開始するアクセス許可を付与します。 書き込み

metric-stream*

StopMetricStreams 指定したすべての CloudWatch メトリックストリームを停止するアクセス許可を付与します。 書き込み

metric-stream*

TagResource Amazon CloudWatch リソースにタグを追加するアクセス許可を付与します。 タグ付け

alarm

insight-rule

aws:TagKeys

aws:RequestTag/${TagKey}

シナリオ: CloudWatch-Alarm

alarm*

シナリオ: CloudWatch-InsightRule

insight-rule*

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

alarm

insight-rule

aws:TagKeys

シナリオ: CloudWatch-Alarm

alarm*

シナリオ: CloudWatch-InsightRule

insight-rule*

Amazon CloudWatch で定義されるリソースタイプ

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

リソースタイプ ARN 条件キー
alarm arn:${Partition}:cloudwatch:${Region}:${Account}:alarm:${AlarmName}

aws:ResourceTag/${TagKey}

dashboard arn:${Partition}:cloudwatch::${Account}:dashboard/${DashboardName}
insight-rule arn:${Partition}:cloudwatch:${Region}:${Account}:insight-rule/${InsightRuleName}

aws:ResourceTag/${TagKey}

metric-stream arn:${Partition}:cloudwatch:${Region}:${Account}:metric-stream/${MetricStreamName}

aws:ResourceTag/${TagKey}

Amazon CloudWatch の条件キー

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

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

条件キー 説明 タイプ
aws:RequestTag/${TagKey} 各タグで許可されている値のセットに基づいてアクションをフィルタリングします 文字列
aws:ResourceTag/${TagKey} リソースに関連付けられている tag-value に基づいてアクションをフィルタリングします。 文字列
aws:TagKeys リクエスト内の必須タグのプレゼンスに基づいてアクションをフィルタリングします 文字列
cloudwatch:namespace オプションの名前空間値の存在に基づいてアクションをフィルタリングします。 文字列