支援終止通知：2026 年 5 月 20 日， AWS 將終止對 的支援 AWS IoT Events。2026 年 5 月 20 日之後，您將無法再存取 AWS IoT Events 主控台或 AWS IoT Events 資源。如需詳細資訊，請參閱[AWS IoT Events 終止支援](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-end-of-support.html)。 本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # AWS IoT Events 使用其他 AWS 服務 AWS IoT Events 支援下列可讓您使用 AWS 服務的動作： + [`iotTopicPublish`](#iotevents-iotcore) 在 MQTT 主題上發佈訊息。 + [`iotEvents`](#iotevents-iteinput) 將資料傳送至 AWS IoT Events 做為輸入值。 + [`iotSiteWise`](#iotevents-iotsitewise) 將資料傳送至 AWS IoT SiteWise中的資產屬性。 + [`dynamoDB`](#iotevents-dynamodb) 將資料傳送至 Amazon DynamoDB 資料表。 + [`dynamoDBv2`](#iotevents-dynamodbv2) 將資料傳送至 Amazon DynamoDB 資料表。 + [`firehose`](#iotevents-firehose) 將資料傳送至 Amazon Data Firehose 串流。 + [`lambda`](#iotevents-lambda) 叫用 AWS Lambda 函數。 + [`sns`](#iotevents-sns) 以推送通知的形式傳送資料。 + [`sqs`](#iotevents-sqs) 將資料傳送至 Amazon SQS 佇列。 **重要** 您必須為要使用的 AWS IoT Events 和 AWS 服務選擇相同的 AWS 區域。如需支援區域的清單，請參閱《*Amazon Web Services 一般參考*》中的 [AWS IoT Events 端點和配額](https://docs.aws.amazon.com/general/latest/gr/iot-events.html)。 當您為 AWS IoT Events 動作建立其他 AWS 資源時，必須使用相同的 AWS 區域。如果您切換 AWS 區域，存取 AWS 資源時可能會遇到問題。 根據預設， 會在 JSON 中為任何動作 AWS IoT Events 產生標準承載。此動作承載包含具有偵測器模型執行個體相關資訊的所有屬性值對，以及觸發動作的事件。若要設定動作承載，您可以使用內容表達式。如需詳細資訊，請參閱 [篩選、轉換和處理事件資料的表達式](iotevents-expressions.md)和 *AWS IoT Events API 參考*中的[承載](https://docs.aws.amazon.com/iotevents/latest/apireference/API_Payload.html)資料類型。 ## AWS IoT Core ------ #### [ IoT topic publish action ] AWS IoT Core 動作可讓您透過訊息代理程式發佈 MQTT AWS IoT 訊息。如需支援區域的清單，請參閱《*Amazon Web Services 一般參考*》中的 [AWS IoT Core 端點和配額](https://docs.aws.amazon.com/general/latest/gr/iot-core.html)。 AWS IoT 訊息代理程式會透過將訊息從發佈 AWS IoT 用戶端傳送至訂閱用戶端來連接用戶端。如需詳細資訊，請參閱《 *AWS IoT 開發人員指南*》中的[裝置通訊協定](https://docs.aws.amazon.com/iot/latest/developerguide/protocols.html)。 ------ #### [ More information (2) ] 當您發佈 MQTT 訊息時，您必須指定下列參數。 **`mqttTopic`** 接收訊息的 MQTT 主題。 您可以使用偵測器模型中建立的變數或輸入值，在執行時間動態定義 MQTT 主題名稱。 **`payload`** （選用） 預設承載包含具有偵測器模型執行個體和事件觸發動作相關資訊的所有屬性值對。您也可以自訂承載。如需詳細資訊，請參閱 *AWS IoT Events API 參考*中的[承載](https://docs.aws.amazon.com/iotevents/latest/apireference/API_Payload.html)。 **注意** 請確定連接至 AWS IoT Events 服務角色的政策授予 `iot:Publish`許可。如需詳細資訊，請參閱[的身分和存取管理 AWS IoT Events](security-iam.md)。 如需詳細資訊，請參閱 *AWS IoT Events API 參考*中的 [IotTopicPublishAction](https://docs.aws.amazon.com/iotevents/latest/apireference/API_IotTopicPublishAction.html)。 ------ ## AWS IoT Events ------ #### [ IoT Events action ] AWS IoT Events 動作可讓您將資料傳送至 AWS IoT Events 做為輸入。如需支援區域的清單，請參閱《*Amazon Web Services 一般參考*》中的 [AWS IoT Events 端點和配額](https://docs.aws.amazon.com/general/latest/gr/iot-events.html)。 AWS IoT Events 可讓您監控設備或裝置機群操作失敗或變更，並在發生此類事件時觸發動作。如需詳細資訊，請參閱[什麼是 AWS IoT Events？](https://docs.aws.amazon.com/iotevents/latest/developerguide/what-is-iotevents.html) 《 *AWS IoT Events 開發人員指南*》中的 。 ------ #### [ More information (2) ] 將資料傳送到 時 AWS IoT Events，您必須指定下列參數。 **`inputName`** 接收資料的 AWS IoT Events 輸入名稱。 **`payload`** （選用） 預設承載包含具有偵測器模型執行個體和事件觸發動作相關資訊的所有屬性值對。您也可以自訂承載。如需詳細資訊，請參閱 *AWS IoT Events API 參考*中的[承載](https://docs.aws.amazon.com/iotevents/latest/apireference/API_Payload.html)。 **注意** 請確定連接至 AWS IoT Events 服務角色的政策授予 `iotevents:BatchPutMessage`許可。如需詳細資訊，請參閱[的身分和存取管理 AWS IoT Events](security-iam.md)。 如需詳細資訊，請參閱 *AWS IoT Events API 參考*中的 [IotEventsAction](https://docs.aws.amazon.com/iotevents/latest/apireference/API_IotEventsAction.html)。 ------ ## AWS IoT SiteWise ------ #### [ IoT SiteWise action ] AWS IoT SiteWise 動作可讓您將資料傳送至 中的資產屬性 AWS IoT SiteWise。如需支援區域的清單，請參閱《*Amazon Web Services 一般參考*》中的 [AWS IoT SiteWise 端點和配額](https://docs.aws.amazon.com/general/latest/gr/iot-sitewise.html)。 AWS IoT SiteWise 是一項受管服務，可讓您大規模收集、組織和分析工業設備的資料。如需詳細資訊，請參閱《 AWS IoT SiteWise使用者指南**》中的[什麼是AWS IoT SiteWise ？](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/what-is-sitewise.html)。 ------ #### [ More information (11) ] 當您將資料傳送至 中的資產屬性時 AWS IoT SiteWise，您必須指定下列參數。 **重要** 若要接收資料，您必須使用 中的現有資產屬性 AWS IoT SiteWise。 如果您使用 AWS IoT Events 主控台，則必須指定 `propertyAlias`來識別目標資產屬性。 如果您使用 AWS CLI，則必須指定 `propertyAlias`或兩者`assetId``propertyId`，並識別目標資產屬性。 如需詳細資訊，請參閱《AWS IoT SiteWise 使用者指南》中的[將工業資料串流映射至資產屬性](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/connect-data-streams.html)。 **`propertyAlias`** （選用） 資產屬性的別名。您也可以指定表達式。 **`assetId`** （選用） 具有指定屬性的資產 ID。您也可以指定表達式。 **`propertyId`** （選用） 資產屬性的 ID。您也可以指定表達式。 **`entryId`** (選用) 此項目的唯一識別符。您可以使用項目 ID 來追蹤在失敗時，哪個資料項目會發生錯誤。預設值為新的唯一識別碼。您也可以指定表達式。 **`propertyValue`** 包含屬性值詳細資訊的結構。 **`quality`** （選用） 資產屬性值的品質。值必須為 `GOOD`、`BAD` 或 `UNCERTAIN`。您也可以指定表達式。 **`timestamp`** （選用） 包含時間戳記資訊的結構。如果您未指定此值，則預設為事件時間。 **`timeInSeconds`** 時間戳記 (以秒為單位，格式為 Unix epoch)。有效範圍介於 1 與 31556889864403199 之間。您也可以指定表達式。 **`offsetInNanos`** （選用） 從 轉換的奈秒位移`timeInSeconds`。有效範圍介於 0 與 999999999 之間。您也可以指定表達式。 **`value`** 包含資產屬性值的結構。 您必須根據 指定資產屬性的 `dataType`，指定下列其中一種值類型。如需詳細資訊，請參閱 *AWS IoT SiteWise API 參考*中的 [AssetProperty](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_AssetProperty.html)。 **`booleanValue`** （選用） 資產屬性值是布林值，必須為 `TRUE`或 `FALSE`。您也可以指定表達式。如果您使用表達式，則評估結果應為布林值。 **`doubleValue`** （選用） 資產屬性值為兩倍。您也可以指定表達式。如果您使用表達式，評估結果應該是雙精確度。 **`integerValue`** （選用） 資產屬性值為整數。您也可以指定表達式。如果您使用表達式，則評估結果應該是整數。 **`stringValue`** （選用） 資產屬性值為字串。您也可以指定表達式。如果您使用表達式，則評估結果應該是字串。 **注意** 請確定連接至 AWS IoT Events 服務角色的政策授予 `iotsitewise:BatchPutAssetPropertyValue`許可。如需詳細資訊，請參閱[的身分和存取管理 AWS IoT Events](security-iam.md)。 如需詳細資訊，請參閱 *AWS IoT Events API 參考*中的 [IotSiteWiseAction](https://docs.aws.amazon.com/iotevents/latest/apireference/API_IotSiteWiseAction.html)。 ------ ## Amazon DynamoDB ------ #### [ DynamoDB action ] Amazon DynamoDB 動作可讓您將資料傳送至 DynamoDB 資料表。DynamoDB 資料表的一欄會接收您指定的動作承載中的所有屬性值對。如需支援的區域清單，請參閱《》中的 [Amazon DynamoDB 端點和配額](https://docs.aws.amazon.com/general/latest/gr/ddb.html)*Amazon Web Services 一般參考*。 Amazon DynamoDB 是一項完全受管的 NoSQL 資料庫服務，可提供快速且可預期的效能及無縫的可擴展性。如需詳細資訊，請參閱[什麼是 DynamoDB？](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Introduction.html) Amazon * DynamoDB 開發人員指南*中的 。 ------ #### [ More information (10) ] 當您將資料傳送至 DynamoDB 資料表的一個資料欄時，您必須指定下列參數。 **`tableName`** 接收資料的 DynamoDB 資料表名稱。`tableName` 值必須符合 DynamoDB 資料表的資料表名稱。您也可以指定表達式。 **`hashKeyField`** 雜湊金鑰的名稱 （也稱為分割區金鑰）。`hashKeyField` 值必須符合 DynamoDB 資料表的分割區索引鍵。您也可以指定表達式。 **`hashKeyType`** （選用） 雜湊金鑰的資料類型。雜湊金鑰類型的值必須為 `STRING`或 `NUMBER`。預設值為 `STRING`。您也可以指定表達式。 **`hashKeyValue`** 雜湊索引鍵的值。`hashKeyValue` 使用替代範本。這些範本會在執行時間提供資料。您也可以指定表達式。 **`rangeKeyField`** (選用) 範圍索引鍵 (亦稱為排序索引鍵) 的名稱。`rangeKeyField` 值必須符合 DynamoDB 資料表的排序索引鍵。您也可以指定表達式。 **`rangeKeyType`** （選用） 範圍索引鍵的資料類型。雜湊金鑰類型的值必須為 `STRING`或 `NUMBER`。預設值為 `STRING`。您也可以指定表達式。 **`rangeKeyValue`** (選用) 範圍索引鍵的值。`rangeKeyValue` 使用替代範本。這些範本會在執行時間提供資料。您也可以指定表達式。 **operation** （選用） 要執行的操作類型。您也可以指定表達式。操作值必須是下列其中一個值： + `INSERT` - 將資料做為新項目插入 DynamoDB 資料表。這是預設值。 + `UPDATE` - 使用新資料更新 DynamoDB 資料表的現有項目。 + `DELETE` - 從 DynamoDB 資料表中刪除現有項目。 **`payloadField`** （選用） 接收動作承載的 DynamoDB 資料欄名稱。預設名稱為 `payload`。您也可以指定表達式。 **`payload`** （選用） 預設承載包含具有偵測器模型執行個體和事件觸發動作相關資訊的所有屬性值對。您也可以自訂承載。如需詳細資訊，請參閱 *AWS IoT Events API 參考*中的[承載](https://docs.aws.amazon.com/iotevents/latest/apireference/API_Payload.html)。 如果指定的承載類型是字串， 會將非 JSON 資料作為二進位資料`DynamoDBAction`傳送至 DynamoDB 資料表。DynamoDB 主控台會以 Base64 編碼文字來顯示資料。`payloadField` 值是 `{{payload-field}}_raw`。您也可以指定表達式。 **注意** 請確定連接至 AWS IoT Events 服務角色的政策授予 `dynamodb:PutItem`許可。如需詳細資訊，請參閱[的身分和存取管理 AWS IoT Events](security-iam.md)。 如需詳細資訊，請參閱 *AWS IoT Events API 參考*中的 [DynamoDBAction](https://docs.aws.amazon.com/iotevents/latest/apireference/API_DynamoDBAction.html)。 ------ ## Amazon DynamoDB(v2) ------ #### [ DynamoDBv2 action ] Amazon DynamoDB(v2) 動作可讓您將資料寫入 DynamoDB 資料表。DynamoDB 資料表的個別資料欄會在您指定的動作承載中收到一個屬性值對。如需支援的區域清單，請參閱《》中的 [Amazon DynamoDB 端點和配額](https://docs.aws.amazon.com/general/latest/gr/ddb.html)*Amazon Web Services 一般參考*。 Amazon DynamoDB 是一項完全受管的 NoSQL 資料庫服務，可提供快速且可預期的效能及無縫的可擴展性。如需詳細資訊，請參閱[什麼是 DynamoDB？](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Introduction.html) Amazon * DynamoDB 開發人員指南*中的 。 ------ #### [ More information (2) ] 當您將資料傳送至 DynamoDB 資料表的多個資料欄時，您必須指定下列參數。 **`tableName`** 接收資料的 DynamoDB 資料表名稱。您也可以指定表達式。 **`payload`** （選用） 預設承載包含具有偵測器模型執行個體和事件觸發動作相關資訊的所有屬性值對。您也可以自訂承載。如需詳細資訊，請參閱 *AWS IoT Events API 參考*中的[承載](https://docs.aws.amazon.com/iotevents/latest/apireference/API_Payload.html)。 承載類型必須是 JSON。您也可以指定表達式。 **注意** 請確定連接至 AWS IoT Events 服務角色的政策授予 `dynamodb:PutItem`許可。如需詳細資訊，請參閱[的身分和存取管理 AWS IoT Events](security-iam.md)。 如需詳細資訊，請參閱《 *AWS IoT Events API 參考*》中的 [DynamoDBv2Action](https://docs.aws.amazon.com/iotevents/latest/apireference/API_DynamoDBv2Action.html)。 ------ ## Amazon Data Firehose ------ #### [ Firehose action ] Amazon Data Firehose 動作可讓您將資料傳送至 Firehose 交付串流。如需支援的區域清單，請參閱《》中的 [Amazon Data Firehose 端點和配額](https://docs.aws.amazon.com/general/latest/gr/fh.html)*Amazon Web Services 一般參考*。 Amazon Data Firehose 是一項全受管服務，可將即時串流資料交付至目的地，例如 Amazon Simple Storage Service (Amazon Simple Storage Service)、Amazon Redshift、Amazon OpenSearch Service (OpenSearch Service) 和 Splunk。如需詳細資訊，請參閱[什麼是 Amazon Data Firehose？](https://docs.aws.amazon.com/firehose/latest/dev/what-is-this-service.html) *Amazon Data Firehose 開發人員指南*中的 。 ------ #### [ More information (3) ] 當您將資料傳送至 Firehose 交付串流時，您必須指定下列參數。 **`deliveryStreamName`** 接收資料的 Firehose 交付串流名稱。 **`separator`** （選用） 您可以使用字元分隔符號來分隔傳送至 Firehose 交付串流的連續資料。分隔符號值必須是 `'\n'`（換行）、 `'\t'`(tab)、 `'\r\n'`(Windows 換行） 或 `','`（逗號）。 **`payload`** （選用） 預設承載包含具有偵測器模型執行個體和事件觸發動作相關資訊的所有屬性值對。您也可以自訂承載。如需詳細資訊，請參閱 *AWS IoT Events API 參考*中的[承載](https://docs.aws.amazon.com/iotevents/latest/apireference/API_Payload.html)。 **注意** 請確定連接至 AWS IoT Events 服務角色的政策授予 `firehose:PutRecord`許可。如需詳細資訊，請參閱[的身分和存取管理 AWS IoT Events](security-iam.md)。 如需詳細資訊，請參閱 *AWS IoT Events API 參考*中的 [FirehoseAction](https://docs.aws.amazon.com/iotevents/latest/apireference/API_FirehoseAction.html)。 ------ ## AWS Lambda ------ #### [ Lambda action ] AWS Lambda 動作可讓您呼叫 Lambda 函數。如需支援區域的清單，請參閱《*Amazon Web Services 一般參考*》中的 [AWS Lambda 端點和配額](https://docs.aws.amazon.com/general/latest/gr/lambda-service.html)。 AWS Lambda 是一種運算服務，可讓您執行程式碼，而無需佈建或管理伺服器。如需詳細資訊，請參閱[什麼是 AWS Lambda？](https://docs.aws.amazon.com/lambda/latest/dg/welcome.html) 《 *AWS Lambda 開發人員指南*》中的 。 ------ #### [ More information (2) ] 呼叫 Lambda 函數時，您必須指定下列參數。 **`functionArn`** Lambda 函數呼叫的 ARN。 **`payload`** （選用） 預設承載包含具有偵測器模型執行個體和事件觸發動作相關資訊的所有屬性值對。您也可以自訂承載。如需詳細資訊，請參閱 *AWS IoT Events API 參考*中的[承載](https://docs.aws.amazon.com/iotevents/latest/apireference/API_Payload.html)。 **注意** 請確定連接至 AWS IoT Events 服務角色的政策授予 `lambda:InvokeFunction`許可。如需詳細資訊，請參閱[的身分和存取管理 AWS IoT Events](security-iam.md)。 如需詳細資訊，請參閱 *AWS IoT Events API 參考*中的 [LambdaAction](https://docs.aws.amazon.com/iotevents/latest/apireference/API_LambdaAction.html)。 ------ ## Amazon Simple Notification Service ------ #### [ SNS action ] Amazon SNS 主題發佈動作可讓您發佈 Amazon SNS 訊息。如需支援的區域清單，請參閱《》中的 [Amazon Simple Notification Service 端點和配額](https://docs.aws.amazon.com/general/latest/gr/sns.html)*Amazon Web Services 一般參考*。 Amazon Simple Notification Service (Amazon Simple Notification Service) 是一種 Web 服務，可協調和管理訊息傳遞或傳送至訂閱端點或用戶端。如需詳細資訊，請參閱[什麼是 Amazon SNS？](https://docs.aws.amazon.com/sns/latest/dg/welcome.html) *Amazon Simple Notification Service 開發人員指南*中的 。 **注意** Amazon SNS 主題發佈動作不支援 Amazon SNS FIFO （先進先出） 主題。由於規則引擎是全分散式服務，因此啟動 Amazon SNS 動作時，訊息可能不會以指定的順序顯示。 ------ #### [ More information (2) ] 當您發佈 Amazon SNS 訊息時，您必須指定下列參數。 **`targetArn`** 接收訊息之 Amazon SNS 目標的 ARN。 **`payload`** （選用） 預設承載包含具有偵測器模型執行個體和事件觸發動作相關資訊的所有屬性值對。您也可以自訂承載。如需詳細資訊，請參閱 *AWS IoT Events API 參考*中的[承載](https://docs.aws.amazon.com/iotevents/latest/apireference/API_Payload.html)。 **注意** 請確定連接至 AWS IoT Events 服務角色的政策授予 `sns:Publish`許可。如需詳細資訊，請參閱[的身分和存取管理 AWS IoT Events](security-iam.md)。 如需詳細資訊，請參閱《 *AWS IoT Events API 參考*》中的 [SNSTopicPublishAction](https://docs.aws.amazon.com/iotevents/latest/apireference/API_SNSTopicPublishAction.html)。 ------ ## Amazon Simple Queue Service ------ #### [ SQS action ] Amazon SQS 動作可讓您將資料傳送至 Amazon SQS 佇列。如需支援的區域清單，請參閱《》中的 [Amazon Simple Queue Service 端點和配額](https://docs.aws.amazon.com/general/latest/gr/sqs-service.html)*Amazon Web Services 一般參考*。 Amazon Simple Queue Service (Amazon SQS) 提供安全、耐用且可用的託管佇列，可讓您整合與分離分散式軟體系統和元件。如需詳細資訊，請參閱[《Amazon Simple Queue Service 開發人員指南》中的什麼是 Amazon Simple Queue Service>](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/welcome.html)。 ** **注意** Amazon SQS 動作不支援 >Amazon SQS FIFO （先進先出） 主題。由於規則引擎是全分散式服務，因此啟動 Amazon SQS 動作時，訊息可能不會以指定的順序顯示。 ------ #### [ More information (3) ] 當您將資料傳送至 Amazon SQS 佇列時，您必須指定下列參數。 **`queueUrl`** 接收資料的 Amazon SQS 佇列 URL。 **`useBase64`** 如果您指定 ， （選用） 會將資料 AWS IoT Events 編碼為 Base64 文字`TRUE`。預設值為 `FALSE`。 **`payload`** （選用） 預設承載包含具有偵測器模型執行個體和事件觸發動作相關資訊的所有屬性值對。您也可以自訂承載。如需詳細資訊，請參閱 *AWS IoT Events API 參考*中的[承載](https://docs.aws.amazon.com/iotevents/latest/apireference/API_Payload.html)。 **注意** 請確定連接至 AWS IoT Events 服務角色的政策授予 `sqs:SendMessage`許可。如需詳細資訊，請參閱[的身分和存取管理 AWS IoT Events](security-iam.md)。 如需詳細資訊，請參閱《 *AWS IoT Events API 參考*》中的 [SNSTopicPublishAction](https://docs.aws.amazon.com/iotevents/latest/apireference/API_SNSTopicPublishAction.html)。 ------ 您也可以使用 Amazon SNS 和 AWS IoT Core 規則引擎來觸發 AWS Lambda 函數。這可讓您使用 Connect Customer 等其他服務，甚至是公司企業資源規劃 (ERP) 應用程式來採取動作。 **注意** 若要即時收集和處理大型資料記錄串流，您可以使用其他服務 AWS ，例如 [Amazon Kinesis](https://docs.aws.amazon.com/kinesis/index.html)。從那裡，您可以完成初始分析，然後將結果作為偵測器的 AWS IoT Events 輸入傳送到 。