本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
SNS
使用 SNS (sns
) 動作,將來自 MQTT 訊息的資料作為 Amazon Simple Notification Service (Amazon SNS) 推送通知進行傳送。
您可依循對您展示如何使用 SNS 動作 來建立及測試規則的教學課程。如需詳細資訊,請參閱 教學課程:傳送 Amazon SNS 通知。
注意
SNS 動作不支援 Amazon SNS FIFO (先進先出) 主題。因為規則引擎是一項完全分配式的服務,因此在呼叫 SNS 動作時無法保證訊息順序。
要求
此規則動作具有下列需求:
-
AWS IoT 可假設執行
sns:Publish
作業的 IAM 角色。如需詳細資訊,請參閱 授與 AWS IoT 規則所需的存取權。在 AWS IoT 主控台中,您可以選擇或建立允許 AWS IoT 執行此規則動作的角色。
-
如果您使用 AWS KMS 客戶管理的受管 AWS KMS key 來加密 Amazon SNS 中的靜態資料,則該服務必須具有代表呼叫者使用 AWS KMS key 的權限。如需詳細資訊,請參閱《Amazon Simple Notification Service 開發人員指南》中的金鑰管理。
參數
使用此動作建立 AWS IoT 規則時,必須指定下列資訊:
範例
下列 JSON 範例會定義 AWS IoT 規則中的 SNS 動作。
{ "topicRulePayload": { "sql": "SELECT * FROM 'some/topic'", "ruleDisabled": false, "awsIotSqlVersion": "2016-03-23", "actions": [ { "sns": { "targetArn": "arn:aws:sns:us-east-2:123456789012:my_sns_topic", "roleArn": "arn:aws:iam::123456789012:role/aws_iot_sns" } } ] } }
下列 JSON 範例會在 AWS IoT 規則中定義具有替代範本的 SNS 動作。
{ "topicRulePayload": { "sql": "SELECT * FROM 'some/topic'", "ruleDisabled": false, "awsIotSqlVersion": "2016-03-23", "actions": [ { "sns": { "targetArn": "arn:aws:sns:us-east-1:123456789012:${topic()}", "messageFormat": "JSON", "roleArn": "arn:aws:iam::123456789012:role/aws_iot_sns" } } ] } }
另請參閱
-
《Amazon Simple Notification Service 開發人員指南》中的什麼是 Amazon Simple Notification Service?