本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
SQS
SQS (sqs
) 操作将 MQTT 消息中的数据发送到 Amazon Simple Queue Service (Amazon SQS) 队列。
注意
SQS 操作不支持 Amazon SQS FIFO(先进先出)队列。由于规则引擎是一个完全分布式服务,因此无法保证触发 SQS 操作时的消息顺序。
要求
此规则操作具有以下要求:
-
AWS IoT 可以代入执行
sqs:SendMessage
操作的 IAM 角色。有关更多信息,请参阅 授予 AWS IoT 规则所需的访问权限。在 AWS IoT 控制台中,您可以选择或创建 AWS IoT 允许执行此规则操作的角色。
-
如果您使用 AWS KMS 客户托管 AWS KMS key 对 Amazon SQS 中的静态数据进行加密,则该服务必须有权代表来电者使用这些数据。 AWS KMS key 有关更多信息,请参阅 Amazon Simple Queue Service 开发人员指南中的密钥管理。
参数
使用此操作创建 AWS IoT 规则时,必须指定以下信息:
queueUrl
-
数据写入的 Amazon SQS 队列的 URL。此 URL 中的区域不必与您的AWS IoT 规则 AWS 区域相同。
注意
AWS 区域 使用 SQS 规则操作进行交叉数据传输可能会产生额外费用。有关更多信息,请参阅 Amazon SQS 定价
。 支持替换模板:API 且 AWS CLI 仅支持
useBase64
-
将该参数设置为
true
以配置规则操作,以便在将数据写入 Amazon SQS 队列之前对消息数据进行 base64 编码。默认值为false
。支持替换模板:否
roleArn
-
允许访问 Amazon SQS 队列的 IAM 角色。有关更多信息,请参阅 要求。
支持替换模板:否
示例
以下 JSON 示例在 AWS IoT 规则中定义了 SQS 操作。
{ "topicRulePayload": { "sql": "SELECT * FROM 'some/topic'", "ruleDisabled": false, "awsIotSqlVersion": "2016-03-23", "actions": [ { "sqs": { "queueUrl": "https://sqs.us-east-2.amazonaws.com/123456789012/my_sqs_queue", "roleArn": "arn:aws:iam::123456789012:role/aws_iot_sqs" } } ] } }
以下 JSON 示例定义了在 AWS IoT 规则中使用替换模板的 SQS 操作。
{ "topicRulePayload": { "sql": "SELECT * FROM 'some/topic'", "ruleDisabled": false, "awsIotSqlVersion": "2016-03-23", "actions": [ { "sqs": { "queueUrl": "https://sqs.us-east-2.amazonaws.com/123456789012/${topic()}", "useBase64": true, "roleArn": "arn:aws:iam::123456789012:role/aws_iot_sqs" } } ] } }
另请参阅
-
Amazon Simple Queue Service 开发人员指南中的什么是 Amazon Simple Queue Service?