Amazon IoT Core Amazon IoT Events Amazon IoT SiteWise Amazon DynamoDB 亚马逊 DynamoDB (v2)Amazon Kinesis Data Firehose Amazon Lambda Amazon Simple Notification Service Amazon Simple Queue Service

使用其他Amazon服务

Amazon IoT Events支持以下允许您使用Amazon服务的操作：

iotTopicPublish发布有关 MQTT 主题的消息。
iotEvents将数据Amazon IoT Events作为输入值发送到。
iotSiteWise – 将数据发送到 Amazon IoT SiteWise 中的资产属性。
dynamoDB向亚马逊 DynamoDB 表发送数据。
dynamoDBv2向亚马逊 DynamoDB 表发送数据。
firehose向亚马逊 Kinesis Data Firehose 直播发送数据。
lambda来调用一个Amazon Lambda函数。
sns以推送通知的形式发送数据。
sqs将数据发送到 Amazon SQS 队列。

重要

您必须为两者Amazon IoT Events以及要使用的Amazon服务选择相同的Amazon区域。有关支持的区域列表，请参阅中的Amazon IoT Events终端节点和配额Amazon Web Services 一般参考。
在为Amazon IoT Events操作创建其他Amazon资源时，必须使用相同的Amazon区域。如果您切换Amazon区域，则访问Amazon资源可能会遇到问题。

默认情况下，Amazon IoT Events 会以 JSON 格式为任何操作生成标准有效负载。此操作负载包含所有属性值对，这些属性值对包含有关探测器模型实例和触发操作的事件的信息。要配置操作负载，您可以使用内容表达式。有关更多信息，请参阅表达式《Amazon IoT EventsAPI 参考》中的 P ayload 数据类型。

Amazon IoT Core

Amazon IoT Events

Amazon IoT SiteWise

IoT SiteWise action

该Amazon IoT SiteWise操作允许您将数据发送到中的资产属性Amazon IoT SiteWise。有关支持的区域列表，请参阅中的Amazon IoT SiteWise终端节点和配额Amazon Web Services 一般参考。

Amazon IoT SiteWise 是一种托管服务，可让您轻松地从工业设备中大规模收集、组织和分析数据。有关更多信息，请参阅《Amazon IoT SiteWise 用户指南》中的什么是 Amazon IoT SiteWise？。

More information (11)

向中的资产属性发送数据时Amazon IoT SiteWise，必须指定以下参数。

重要

要接收数据，您必须使用中的现有资产属性Amazon IoT SiteWise。

如果您使用Amazon IoT Events控制台，则必须指定propertyAlias以标识目标资产属性。
如果使用Amazon CLI，则必须指定其中一个propertyAlias或两个propertyId，assetId然后才能标识目标资产属性。

有关更多信息，请参阅《Amazon IoT SiteWise 用户指南》中的将工业数据流映射到资产属性。

propertyAlias

（可选）资产属性的别名。您也可以指定表达式。

assetId

（可选）具有指定属性的资产的 ID。您也可以指定表达式。

propertyId

（可选）资产属性的 ID。您也可以指定表达式。

entryId

（可选）此条目的唯一标识符。您可以使用条目 ID，跟踪在出现故障时哪些数据条目导致了错误。默认值为新的唯一标识符。您也可以指定表达式。

propertyValue

包含有关属性值的详细信息的结构。

quality

（可选）资产属性值的质量。值必须为 GOOD、BAD 或 UNCERTAIN。您也可以指定表达式。

timestamp

（可选）包含时间戳信息的结构。如果未指定此值，则默认为事件时间。

timeInSeconds: 采用 Unix 纪元时间格式的时间戳（以秒为单位）。有效范围在 1-31556889864403199 之间。您也可以指定表达式。
offsetInNanos: （可选）从timeInSeconds中转换的纳秒偏移量。有效范围在 0-999999999 之间。您也可以指定表达式。

value

一个包含资产属性值的结构。

重要

您必须指定以下值类型之一，具体取决于指定的资产属性的 dataType。有关更多信息，请参阅《Amazon IoT SiteWise API 参考》中的 AssetProperty。

booleanValue: （可选）资产属性值是一个布尔值，必须为TRUE或FALSE。您也可以指定表达式。如果使用表达式，则计算结果应为布尔值。
doubleValue: （可选）资产属性值为双精度。您也可以指定表达式。如果使用表达式，则计算结果应为双精度值。
integerValue: （可选）资产属性值为整数。您也可以指定表达式。如果使用表达式，则计算结果应为整数值。
stringValue: （可选）资产属性值是一个字符串。您也可以指定表达式。如果使用表达式，则计算结果应为字符串值。

注意

确保附加到您的Amazon IoT Events服务角色的策略授予了该iotsitewise:BatchPutAssetPropertyValue权限。有关更多信息，请参阅适用于 Amazon IoT Events 的 Identity and Access Management：

有关更多信息，请参阅《Amazon IoT Events API 参考》中的 IotSiteWiseAction。

Amazon DynamoDB

DynamoDB action

Amazon DynamoDB 操作允许您向 DynamoDB 表发送数据。DynamoDB 表的一列接收您指定的操作负载中的所有属性值对。有关支持的区域列表，请参阅中的亚马逊 DynamoDB 终端节点和配额。Amazon Web Services 一般参考

Amazon DynamoDB 是一种全托管 NoSQL 数据库服务，提供快速而可预测的性能，能够实现无缝扩展。有关更多信息，请参阅什么是 DynamoDB？在亚马逊 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

（可选）默认负载包含所有属性值对，这些属性值对包含有关探测器模型实例和触发操作的事件的信息。此外，您还可以自定义负载。有关更多信息，请参阅 Amazon IoT EventsAPI 参考中的负载。

如果指定的负载类型为字符串，则DynamoDBAction将非 JSON 数据作为二进制数据发送到 DynamoDB 表。DynamoDB 控制台以 Base64 编码文本格式显示数据。payloadField 值为 payload-field_raw。您也可以指定表达式。

注意

确保附加到您的Amazon IoT Events服务角色的策略授予了该dynamodb:PutItem权限。有关更多信息，请参阅适用于 Amazon IoT Events 的 Identity and Access Management：

有关更多信息，请参阅 API 参考中的 DynamodBaction。Amazon IoT Events

亚马逊 DynamoDB (v2)

Amazon Kinesis Data Firehose

Firehose action

亚马逊 Kinesis Data Firehose 操作允许您将数据发送到 Kinesis Data Firehose 传输流。有关支持的区域列表，请参阅中的亚马逊 Kinesis Data Firehose 终端节点和配额。Amazon Web Services 一般参考

Amazon Kinesis Data Firehose 是一项完全托管的服务，用于向亚马逊简单存储服务（亚马逊简单存储服务）、亚马逊Redshift OpenSearch 、亚马逊服务（OpenSearch 服务）和Splunk等目的地提供实时流数据。有关更多信息，请参阅什么是亚马逊 Kinesis Data Firehose？在亚马逊 Kinesis Data Firehose 开发者指南中。

More information (3)

向 Kinesis Data Firehose 传输流发送数据时，必须指定以下参数。

deliveryStreamName: 接收数据的 Kinesis Data Firehose 传输流的名称。
separator: （可选）您可以使用字符分隔符来分隔发送到 Kinesis Data Firehose 传输流的连续数据。分隔符值必须是'\n'（换行符）、'\t'（制表符）、'\r\n'（Windows 新行）或','（逗号）。
payload: （可选）默认负载包含所有属性值对，这些属性值对包含有关探测器模型实例和触发操作的事件的信息。此外，您还可以自定义负载。有关更多信息，请参阅 Amazon IoT EventsAPI 参考中的负载。

注意

确保附加到您的Amazon IoT Events服务角色的策略授予了该firehose:PutRecord权限。有关更多信息，请参阅适用于 Amazon IoT Events 的 Identity and Access Management：

有关更多信息，请参阅《Amazon IoT Events API 参考》中的 FirehoseAction。

Amazon Lambda

Amazon Simple Notification Service

SNS action

亚马逊 SNS 主题发布操作允许您发布亚马逊 SNS 消息。有关支持的区域列表，请参阅中的亚马逊简单通知服务终端节点和配额Amazon Web Services 一般参考。

亚马逊简单通知服务（亚马逊简单通知服务）是一项 Web 服务，用于协调和管理向订阅终端节点或客户端发送或发送消息。有关更多信息，请参阅什么是 Amazon SNS？在《亚马逊简单通知服务开发者指南》中。

注意

亚马逊 SNS 主题发布操作不支持 Amazon SNS FIFO（先入先出）主题。由于规则引擎是一项完全分布式的服务，因此启动 Amazon SNS 操作时，消息可能不会按指定顺序显示。

More information (2)

在发布 Amazon SNS 消息时，必须指定以下参数。

targetArn: 接收消息的 Amazon SNS 目标的 ARN。
payload: （可选）默认负载包含所有属性值对，这些属性值对包含有关探测器模型实例和触发操作的事件的信息。此外，您还可以自定义负载。有关更多信息，请参阅 Amazon IoT EventsAPI 参考中的负载。

注意

确保附加到您的Amazon IoT Events服务角色的策略授予了该sns:Publish权限。有关更多信息，请参阅适用于 Amazon IoT Events 的 Identity and Access Management：

有关更多信息，请参阅 Amazon IoT EventsAPI 参考TopicPublishAction中的 SNS。

Amazon Simple Queue Service

SQS action

亚马逊 SQS 操作允许您将数据发送到亚马逊 SQS 队列。有关支持的区域列表，请参阅中的亚马逊简单队列服务终端节点和配额Amazon Web Services 一般参考。

Amazon Simple Queue Service (Amazon SQS) 提供安全、耐用且可用的托管队列，可让您集成和分离分布式软件系统和组件。有关更多信息，请参阅《亚马逊简单队列服务开发者指南》中的什么是亚马逊简单队列服务 >。

注意

亚马逊 SQS 操作不支持亚马逊 SQS FIFO（先入先出）主题。由于规则引擎是一项完全分布式的服务，因此启动 Amazon SQS 操作时，消息可能不会按指定顺序显示。

More information (3)

当您向 Amazon SQS 队列发送数据时，必须指定以下参数。

queueUrl: 接收数据的亚马逊 SQS 队列的网址。
useBase64: （可选）如果您指定，则将数据Amazon IoT Events编码为 Base64 文本。TRUE默认为 FALSE。
payload: （可选）默认负载包含所有属性值对，这些属性值对包含有关探测器模型实例和触发操作的事件的信息。此外，您还可以自定义负载。有关更多信息，请参阅 Amazon IoT EventsAPI 参考中的负载。

注意

确保附加到您的Amazon IoT Events服务角色的策略授予了该sqs:SendMessage权限。有关更多信息，请参阅适用于 Amazon IoT Events 的 Identity and Access Management：

有关更多信息，请参阅 Amazon IoT EventsAPI 参考TopicPublishAction中的 SNS。

您也可以使用 Amazon SNS 和Amazon IoT Core规则引擎来触发函数。Amazon Lambda这使得使用其他服务（例如Amazon Connect，甚至是公司的企业资源规划 (ERP) 应用程序）采取行动成为可能。

注意

要实时收集和处理大量数据记录，您可以使用其他Amazon服务，例如 Amazon Kinesis。然后，您可以完成初步分析，然后将结果Amazon IoT Events作为输入发送到探测器。

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

使用内置动作

表达式