本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
AWS IoT Events 的動作、資源和條件索引鍵
AWS IoT Events （服務字首：iotevents) 提供下列服務特定的資源、動作和條件內容索引鍵，可用於 IAM 許可政策。
參考資料：
-
了解如何設定此服務。
-
檢視可供此服務使用的 API 操作清單。
-
了解如何使用 IAM 許可政策來保護此服務及其資源。
AWS IoT Events 定義的動作
您可在 IAM 政策陳述式的 Action 元素中指定以下動作。使用政策來授予在 AWS中執行操作的許可。在政策中使用動作時，通常會允許或拒絕存取相同名稱的 API 操作或 CLI 命令。不過，在某些情況下，單一動作可控制對多個操作的存取。或者，某些操作需要多種不同的動作。
動作資料表的存取層級欄說明動作的分類方式 （列出、讀取、許可管理或標記）。此分類可協助您了解在政策中使用某動作時，該動作授予您的存取層級。如需存取層級的詳細資訊，請參閱政策摘要中的存取層級。
「動作」資料表的資源類型欄會指出每個動作是否支援資源層級的許可。如果此欄沒有值，您必須在政策陳述式的 Resource 元素中指定政策適用的所有資源 ("*")。如果資料欄包含資源類型，則您可以在具有該動作的陳述式中指定該類型的 ARN。如果動作具有一或多個必要資源，呼叫者必須具有對這些資源使用動作的許可。表格中的必要資源會以星號 (*) 表示。如果您使用 IAM 政策中的 Resource 元素限制資源存取，則每種必要的資源類型必須要有 ARN 或模式。某些動作支援多種資源類型。如果資源類型是選用 (未顯示為必要)，則您可以選擇使用其中一種選用資源類型。
「動作」資料表的條件索引鍵欄包含您可以在政策陳述式的 Condition 元素中指定的索引鍵。如需有關與服務資源相關聯之條件索引鍵的詳細資訊，請參閱「資源類型」資料表的條件索引鍵欄。
動作資料表的相依動作欄會顯示成功呼叫動作所需的其他許可。除了 動作本身的許可之外，還可能需要這些許可。當動作指定相依動作時，這些相依性可能適用於針對該動作定義的其他資源，而不只是資料表中列出的第一個資源。
注意
資源條件索引鍵會列在資源類型資料表中。您可以在「動作」資料表的資源類型 (*必填) 欄中找到適用於動作的資源類型連結。「資源類型」資料表中的資源類型包括條件索引鍵欄，其中包含套用至「動作」資料表中動作的資源條件索引鍵。
如需下表各欄的詳細資訊，請參閱動作資料表。
| 動作 | 描述 | 存取層級 | 資源類型 (*必填項目) | 條件索引鍵 | 相依動作 |
|---|---|---|---|---|---|
| BatchAcknowledgeAlarm | 准許將一或多個確認動作請求傳送至 AWS IoT Events | 寫入 | |||
| BatchDeleteDetector | 准許刪除 AWS IoT Events 系統中的偵測器執行個體 | 寫入 | |||
| BatchDisableAlarm | 准許停用一個或多個警示執行個體 | 寫入 | |||
| BatchEnableAlarm | 准許啟用一個或多個警示執行個體 | 寫入 | |||
| BatchPutMessage | 准許將一組訊息傳送至 AWS IoT Events 系統 | 寫入 | |||
| BatchResetAlarm | 准許重設一個或多個警示執行個體 | 寫入 | |||
| BatchSnoozeAlarm | 准許將一個或多個警示執行個體變更為延後模式 | 寫入 | |||
| BatchUpdateDetector | 准許更新 AWS IoT Events 系統中的偵測器執行個體 | 寫入 | |||
| CreateAlarmModel | 准許建立警示模型來監控 AWS IoT 事件輸入屬性或 AWS IoT SiteWise 資產屬性 | 寫入 | |||
| CreateDetectorModel | 准許建立偵測器模型來監控 AWS IoT Events 輸入屬性 | 寫入 | |||
| CreateInput | 准許在 IotEvents 中建立輸入 | 寫入 | |||
| DeleteAlarmModel | 准許刪除警示模型 | 寫入 | |||
| DeleteDetectorModel | 准許刪除偵測器模型 | 寫入 | |||
| DeleteInput | 准許刪除輸入 | 寫入 | |||
| DescribeAlarm | 准許擷取警示執行個體的相關資訊。 | 讀取 | |||
| DescribeAlarmModel | 准許擷取警示模型的相關資訊。 | 讀取 | |||
| DescribeDetector | 准許擷取偵測器執行個體的相關資訊 | 讀取 | |||
| DescribeDetectorModel | 准許擷取偵測器模型的相關資訊 | 閱讀 | |||
| DescribeDetectorModelAnalysis | 准許擷取偵測器模型分析資訊 | 閱讀 | |||
| DescribeInput | 准許擷取輸入的相關資訊 | 閱讀 | |||
| DescribeLoggingOptions | 准許擷取 AWS IoT Events 記錄選項的目前設定 | 閱讀 | |||
| GetDetectorModelAnalysisResults | 准許擷取偵測器模型分析結果 | 閱讀 | |||
| ListAlarmModelVersions | 准許列出警示模型的所有版本 | 列出 | |||
| ListAlarmModels | 准許列出您建立的警示模型 | 列出 | |||
| ListAlarms | 准許按 alarmModel 擷取所有警示執行個體的相關資訊 | 列出 | |||
| ListDetectorModelVersions | 准許列出偵測器模型的所有版本 | 列出 | |||
| ListDetectorModels | 准許列出您建立的偵測器模型 | 列出 | |||
| ListDetectors | 准許按 detectormodel 擷取所有偵測器執行個體的相關資訊 | 列出 | |||
| ListInputRoutings | 准許列出一或多個輸入路由 | 列出 | |||
| ListInputs | 准許列出您建立的輸入 | 列出 | |||
| ListTagsForResource | 准許列出已指派給資源的標籤 (中繼資料) | 閱讀 | |||
| PutLoggingOptions | 准許設定或更新 AWS IoT Events 記錄選項 | 寫入 | |||
| StartDetectorModelAnalysis | 准許啟動偵測器模型分析 | 寫入 | |||
| TagResource | 准許新增或修改指定資源的標籤。標籤是可用於管理資源的中繼資料 | 標記 | |||
| UntagResource | 准許從資源中移除指定標籤 (中繼資料) | 標記 | |||
| UpdateAlarmModel | 准許更新警示模型 | 寫入 | |||
| UpdateDetectorModel | 准許更新偵測器模型 | 寫入 | |||
| UpdateInput | 准許更新輸入 | 寫入 | |||
| UpdateInputRouting | 准許更新輸入路由 | 寫入 |
AWS IoT Events 定義的資源類型
此服務會定義下列資源類型，並可用在 IAM 許可政策陳述式的 Resource 元素中。動作表格中的每個動作都代表可使用該動作指定的資源類型。資源類型也能定義您可以在政策中包含哪些條件索引鍵。這些索引鍵都會顯示在「資源類型」資料表的最後一欄。如需下表各欄的詳細資訊，請參閱資源類型資料表。
| 資源類型 | ARN | 條件索引鍵 |
|---|---|---|
| detectorModel |
arn:${Partition}:iotevents:${Region}:${Account}:detectorModel/${DetectorModelName}
|
|
| alarmModel |
arn:${Partition}:iotevents:${Region}:${Account}:alarmModel/${AlarmModelName}
|
|
| input |
arn:${Partition}:iotevents:${Region}:${Account}:input/${InputName}
|
AWS IoT Events 的條件索引鍵
AWS IoT Events 定義下列條件索引鍵，可用於 IAM 政策的 Condition元素。您可以使用這些索引鍵來縮小套用政策陳述式的條件。如需下表各欄的詳細資訊，請參閱條件索引鍵表。
若要檢視所有 服務可用的全域條件索引鍵，請參閱AWS 全域條件內容索引鍵。
| 條件索引鍵 | 描述 | 類型 |
|---|---|---|
| aws:RequestTag/${TagKey} | 依請求中的標籤鍵值組篩選存取權 | 字串 |
| aws:ResourceTag/${TagKey} | 依連接到資源的標籤篩選存取權 | 字串 |
| aws:TagKeys | 依請求中的標籤鍵篩選動作 | ArrayOfString |
| iotevents:keyValue | 按訊息的 instanceId (鍵值) 篩選存取權 | 字串 |
