Amazon CloudWatch 的動作、資源和條件索引鍵

Amazon CloudWatch (服務字首：cloudwatch) 提供以下服務特定的資源、動作和條件內容金鑰以使用 IAM 許可政策。

參考資料：

• 了解如何設定此服務。

• 檢視可供此服務使用的 API 操作清單。

• 了解如何使用 IAM 許可政策來保護此服務及其資源。

Amazon CloudWatch 定義的動作

您可在 IAM 政策陳述式的 Action 元素中指定以下動作。使用政策來授予在 AWS 中執行操作的許可。在政策中使用動作時，通常會允許或拒絕存取相同名稱的 API 操作或 CLI 命令。不過，在某些情況下，單一動作可控制對多個操作的存取。或者，某些操作需要多種不同的動作。

「動作」資料表的資源類型欄會指出每個動作是否支援資源層級的許可。如果此欄沒有值，您必須在政策陳述式的 Resource 元素中指定政策適用的所有資源 ("*")。如果此欄包含資源類型，則您可以在包含該動作的陳述式中指定該類型的 ARN。如果動作具有一或多個必要資源，呼叫者必須具有對這些資源使用動作的許可。表格中的必要資源會以星號 (*) 表示。如果您使用 IAM 政策中的 Resource 元素限制資源存取，則每種必要的資源類型必須要有 ARN 或模式。某些動作支援多種資源類型。如果資源類型是選用 (未顯示為必要)，則您可以選擇使用其中一種選用資源類型。

「動作」資料表的條件索引鍵欄包含您可以在政策陳述式的 Condition 元素中指定的索引鍵。如需有關與服務資源相關聯之條件索引鍵的詳細資訊，請參閱「資源類型」資料表的條件索引鍵欄。

注意

資源條件索引鍵會列在資源類型資料表中。您可以在「動作」資料表的資源類型 (*必填) 欄中找到適用於動作的資源類型連結。「資源類型」資料表中的資源類型包括條件索引鍵欄，其中包含套用至「動作」資料表中動作的資源條件索引鍵。

如需下表各欄的詳細資訊，請參閱動作資料表。

動作	描述	存取層級	資源類型 (*必填項目)	條件索引鍵	相依動作
BatchGetServiceLevelIndicatorReport	准許批次取得服務水準指標報告	讀取
BatchGetServiceLevelObjectiveBudgetReport	准許批次擷取服務水準目標預算報告	讀取	slo*
CreateServiceLevelObjective	准許建立服務水準目標	寫入		aws:RequestTag/${TagKey} aws:TagKeys
DeleteAlarms	准許刪除警示的集合	寫入	alarm*
DeleteAnomalyDetector	准許從您的帳戶刪除特定異常偵測模型	寫入
DeleteDashboards	准許刪除您指定的所有 CloudWatch 儀表板	寫入	dashboard*
DeleteInsightRules	准許刪除詳情規則的集合	寫入	insight-rule*
DeleteMetricStream	准許刪除您指定的 CloudWatch 指標串流	寫入	metric-stream*
DeleteServiceLevelObjective	准許刪除服務水準目標	寫入	slo*
DescribeAlarmHistory	准許擷取特定警示的歷程記錄	讀取	alarm*
DescribeAlarms	准許描述目前使用者帳戶擁有的所有警示	讀取	alarm*
DescribeAlarmsForMetric	准許描述目前使用者帳戶擁有之特定指標上設定的所有警示	讀取
DescribeAnomalyDetectors	准許列出您在帳戶中建立的異常偵測模型	讀取
DescribeInsightRules	准許描述目前使用者帳戶擁有的所有詳情規則	讀取
DisableAlarmActions	准許停用警示集合的動作	寫入	alarm*
DisableInsightRules	准許停用詳情規則的集合	寫入	insight-rule*
EnableAlarmActions	准許啟用警示集合的動作	寫入	alarm*
EnableInsightRules	准許啟用詳情規則的集合	寫入	insight-rule*
EnableTopologyDiscovery	准許啟用 CloudWatch 拓撲探索	寫入
GenerateQuery	准許從自然語言提示產生 Metrics Insights 或 Logs Insights 查詢字串	讀取
GetDashboard	准許顯示您指定之 CloudWatch 儀表板的詳細資料	讀取	dashboard*
GetInsightRuleReport	准許傳回獨特作者群在某段時間內，限定詳情規則的前 N 份報表	讀取	insight-rule*
GetMetricData	准許批次擷取 CloudWatch 指標資料，並依據擷取的資料執行指標數學運算	讀取
GetMetricStatistics	准許擷取指定指標的統計資料	讀取
GetMetricStream	准許傳回 CloudWatch 指標串流的詳細資訊	讀取	metric-stream*
GetMetricWidgetImage	准許擷取指標 Widget 的快照	讀取
GetService	准許擷取服務的相關資訊	讀取	service*
GetServiceData [僅限許可]	准許擷取服務資料	讀取	service*
GetServiceLevelObjective	准許擷取服務水準目標的相關資訊	讀取	slo*
GetTopologyDiscoveryStatus [僅限許可]	准許擷取 CloudWatch 拓撲探索狀態	讀取
GetTopologyMap	准許擷取 CloudWatch 拓撲映射	讀取
Link [僅限許可]	准許與監控帳戶共用 CloudWatch 資源	寫入
ListDashboards	准許傳回帳戶中所有 CloudWatch 儀表板的清單	列出
ListManagedInsightRules	准許列出給定資源 ARN 的可用受管洞察規則	讀取		aws:RequestTag/${TagKey} aws:TagKeys cloudwatch:requestManagedResourceARNs
ListMetricStreams	准許傳回帳戶中所有 CloudWatch 指標串流的清單	列出
ListMetrics	准許為 AWS 帳戶 擁有者擷取存放的有效指標清單	列出
ListServiceLevelObjectives	准許列出服務水準目標	列出
ListServices	准許列出服務	列出
ListTagsForResource	准許列出 Amazon CloudWatch 資源的標籤	列出	alarm
			insight-rule
			slo
	案例：CloudWatch-Alarm		alarm*
	案例：CloudWatch-InsightRule		insight-rule*
	案例：CloudWatch-ServiceLevelObjective		slo*
PutAnomalyDetector	准許建立或更新 CloudWatch 指標的異常偵測模型	寫入
PutCompositeAlarm	准許建立或更新複合警示	寫入	alarm*
				aws:RequestTag/${TagKey} aws:TagKeys cloudwatch:AlarmActions
PutDashboard	准許建立 CloudWatch 儀表板，或更新現有儀表板 (如果已存在)	寫入	dashboard*
PutInsightRule	准許建立新的詳情規則或取代現有的詳情規則	寫入	insight-rule*
				aws:RequestTag/${TagKey} aws:TagKeys cloudwatch:requestInsightRuleLogGroups
PutManagedInsightRules	准許建立受管洞察規則	寫入		aws:RequestTag/${TagKey} aws:TagKeys cloudwatch:requestManagedResourceARNs
PutMetricAlarm	准許建立或更新警示，並將其與指定的 Amazon CloudWatch 指標建立關聯	寫入	alarm*
				aws:RequestTag/${TagKey} aws:TagKeys cloudwatch:AlarmActions
PutMetricData	准許將指標資料點發佈至 Amazon CloudWatch	寫入		cloudwatch:namespace
PutMetricStream	准許建立 CloudWatch 指標串流，或更新現有指標串流 (如果已存在)	寫入	metric-stream*
				aws:RequestTag/${TagKey} aws:TagKeys
SetAlarmState	准許暫時設定為警示狀態以進行測試	寫入	alarm*
StartMetricStreams	准許啟動您指定的所有 CloudWatch 指標串流	寫入	metric-stream*
StopMetricStreams	准許停止您指定的所有 CloudWatch 指標串流	寫入	metric-stream*
TagResource	准許將標籤新增至 Amazon CloudWatch 資源	標記	alarm
			insight-rule
			slo
				aws:TagKeys aws:RequestTag/${TagKey}
	案例：CloudWatch-Alarm		alarm*
	案例：CloudWatch-InsightRule		insight-rule*
	案例：CloudWatch-ServiceLevelObjective		slo*
UntagResource	准許將標籤從 Amazon CloudWatch 資源中移除	標記	alarm
			insight-rule
			slo
				aws:TagKeys
	案例：CloudWatch-Alarm		alarm*
	案例：CloudWatch-InsightRule		insight-rule*
	案例：CloudWatch-ServiceLevelObjective		slo*
UpdateServiceLevelObjective	准許更新服務水準目標	寫入	slo*

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}
slo	arn:${Partition}:cloudwatch:${Region}:${Account}:slo/${SloName}	aws:ResourceTag/${TagKey}
service	arn:${Partition}:cloudwatch:${Region}:${Account}:service/${ServiceName}-${UniqueAttributesHex}	aws:ResourceTag/${TagKey}

Amazon CloudWatch 條件索引鍵

Amazon CloudWatch 會定義下列條件金鑰，可用於 IAM 政策的 Condition 元素。您可以使用這些索引鍵來縮小套用政策陳述式的條件。如需下表各欄的詳細資訊，請參閱條件索引鍵表。

若要檢視所有服務都可使用的全域條件索引鍵，請參閱可用的全域條件索引鍵。

條件索引鍵	描述	類型
aws:RequestTag/${TagKey}	根據每個標籤的允許值集來篩選動作	字串
aws:ResourceTag/${TagKey}	根據與資源相關聯的標籤值來篩選動作	字串
aws:TagKeys	根據請求中是否存在強制標籤來篩選動作	ArrayOfString
cloudwatch:AlarmActions	根據定義的警示動作來篩選動作	ArrayOfString
cloudwatch:namespace	依選用命名空間值存在與否篩選動作	字串
cloudwatch:requestInsightRuleLogGroups	根據 Insight Rule 中指定的日誌群組篩選動作	ArrayOfString
cloudwatch:requestManagedResourceARNs	依受管洞察規則中指定的資源 ARN 篩選存取	ArrayOfARN