本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
IoT Analytics
IoT Analytics (iotAnalytics
) 操作可将 MQTT 消息中的数据发送至 Amazon IoT Analytics 通道。
要求
此规则操作具有以下要求:
-
Amazon IoT 可以承担以执行
iotanalytics:BatchPutMessage
操作的 IAM 角色。有关更多信息,请参阅向 Amazon IoT 规则授予所需的访问权限:在 Amazon IoT 控制台中,您可以选择或创建一个角色以允许 Amazon IoT 执行此规则操作。
附加到您指定角色的策略应如下所示:
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iotanalytics:BatchPutMessage", "Resource": [ "arn:aws:iotanalytics:us-west-2:
account-id
:channel/mychannel" ] } ] }
参数
使用此操作创建 Amazon IoT 规则时,您必须指定以下信息:
batchMode
-
(可选)是否批处理操作。默认值为
false
。如果
batchMode
为true
且规则 SQL 语句的求值为一个 Array 时,每个 Array 元素在由BatchPutMessage
传递到 Amazon IoT Analytics 通道时,都将作为单独的消息进行传递。生成的数组,其消息不得超过 100 条。支持替换模板:否
channelName
-
数据写入的 Amazon IoT Analytics 通道的名称。
支持替换模板:仅限 API 和 Amazon CLI
roleArn
-
允许访问 Amazon IoT Analytics 通道的 IAM 角色。有关更多信息,请参阅要求:
支持替换模板:否
示例
以下 JSON 示例定义了 Amazon IoT 规则中的 IoT Analytics 操作。
{ "topicRulePayload": { "sql": "SELECT * FROM 'some/topic'", "ruleDisabled": false, "awsIotSqlVersion": "2016-03-23", "actions": [ { "iotAnalytics": { "channelName": "mychannel", "roleArn": "arn:aws:iam::123456789012:role/analyticsRole", } } ] } }
另请参阅
-
Amazon IoT Analytics 用户指南 中的什么是 Amazon IoT Analytics?
-
Amazon IoT Analytics 控制台还具有快速入门功能,让您可以通过一次单击创建通道、数据存储和管道。有关更多信息,请参阅 Amazon IoT Analytics用户指南中的 Amazon IoT Analytics 控制台快速入门指南。