本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
AWS IoT 規則動作
AWS IoT 規則動作指定呼叫規則時要執行的動作。您可以定義動作，將資料傳送至 Amazon DynamoDB 資料庫、將資料傳送至 Amazon Kinesis Data Streams、叫用 AWS Lambda 函數等。 AWS IoT 支援下列動作， AWS 區域 其中提供動作的服務。
| 規則動作 | Description | API 中的名稱 |
|---|---|---|
| Apache Kafka | 將訊息傳送至 Apache Kafka 叢集。 | kafka |
| CloudWatch 警示 | 變更 Amazon CloudWatch 警示的狀態。 | cloudwatchAlarm |
| CloudWatch Logs | 將訊息傳送至 Amazon CloudWatch Logs。 | cloudwatchLogs |
| CloudWatch 指標 | 將訊息傳送至 CloudWatch 指標。 | cloudwatchMetric |
| DynamoDB | 將訊息傳送至 DynamoDB 表格。 | dynamoDB |
| DynamoDBv2 | 將訊息資料傳送至 DynamoDB 表格中的多個欄。 | dynamoDBv2 |
| Elasticsearch | 將訊息傳送至 OpenSearch 端點。 | OpenSearch |
| HTTP | 將訊息發佈至 HTTPS 端點。 | http |
| AWS IoT Events | 傳送訊息至 AWS IoT Events 輸入。 | iotEvents |
| AWS IoT SiteWise | 傳送訊息資料至 AWS IoT SiteWise 資產屬性。 | iotSiteWise |
| Firehose | 傳送訊息至 Firehose 交付串流。 | firehose |
| Kinesis Data Streams | 將訊息傳送至 Kinesis 資料串流。 | kinesis |
| Lambda | 以訊息資料作為輸入呼叫 Lambda 函數。 | lambda |
| Location | 將位置資料傳送至 Amazon Location Service。 | location |
| OpenSearch | 將訊息傳送至 Amazon OpenSearch Service 端點。 | OpenSearch |
| 重新發佈 | 可在另一個 MQTT 主題上重新發佈訊息。 | republish |
| S3 | 將訊息存放於 Amazon Simple Storage Service (Amazon S3) 儲存貯體中。 | s3 |
| Salesforce IoT | 傳送訊息至 Salesforce IoT 輸入串流。 | salesforce |
| SNS | 將訊息發佈為 Amazon Simple Notification Service (Amazon SNS)推送通知。 | sns |
| SQS | 將訊息發佈至 Amazon Simple Queue Service (Amazon SQS)佇列。 | sqs |
| 步驟函數 | 啟動 AWS Step Functions 狀態機器。 | stepFunctions |
| Timestream | 將訊息傳送至 Amazon Timestream 資料庫表格。 | timestream |
備註
-
在與其他服務資源 AWS 區域 相同的 中定義規則，以便規則動作可以與該資源互動。
-
如果發生間歇性錯誤， AWS IoT 規則引擎可能會多次嘗試執行動作。若所有嘗試都失敗了，則該訊息將遭捨棄，而且可在您的 CloudWatch Logs 中取得錯誤。您可以為失敗發生之後調用的每一個規則指定一個錯誤動作。如需詳細資訊，請參閱錯誤處理 (錯誤動作)。
-
某些規則動作會啟動服務中與 AWS Key Management Service (AWS KMS) 整合的動作，以支援靜態資料加密。如果您使用客戶受管 AWS KMS key (KMS 金鑰） 來加密靜態資料，服務必須具有代表發起人使用 KMS 金鑰的許可。若要了解如何管理客戶受管 KMS 金鑰的許可，請參閱適當服務指南中的資料加密主題。如需客戶受管 KMS 金鑰的詳細資訊，請參閱《AWS Key Management Service 開發人員指南》中的 AWS Key Management Service 概念。
您可以在錯誤動作的 SQL 陳述式中使用任何函數或替代範本，包括外部函數：
aws_lambda()、get_dynamodb()、get_registry_data()、get_thing_shadow()get_secret()、、machinelearning_predict()和decode()。如果錯誤動作需要呼叫外部函數，則叫用錯誤動作可能會導致外部函數產生額外的帳單。
