使用其他Amazon服务 - Amazon IoT Events
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

使用其他Amazon服务

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

  • iotTopicPublish发布有关 MQTT 主题的消息。

  • iotEvents将数据Amazon IoT Events作为输入值发送到。

  • iotSiteWise – 将数据发送到 Amazon IoT SiteWise 中的资产属性。

  • dynamoDB向Amazon DynamoDB 表发送数据。

  • dynamoDBv2向Amazon DynamoDB 表发送数据。

  • firehose将数据发送到 Amazon Kinesis Data Firehose 流。

  • lambda调用一个Amazon Lambda函数。

  • sns以推送通知的形式发送数据。

  • sqs将数据发送到 Amazon SQS 队列。

重要
  • 您必须为两者Amazon IoT Events以及要使用的Amazon服务选择相同的Amazon区域。有关支持的区域的列表,请参阅 Amazon Web Services 一般参考中的Amazon IoT Events端点和配额

  • 为Amazon IoT Events操作创建其他Amazon资源时,必须使用相同的Amazon区域。如果您切换Amazon区域,则访问Amazon资源时可能会遇到问题。

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

Amazon IoT Core

IoT topic publish action

该Amazon IoT Core操作允许您通过消息代理发布 MQTTAmazon IoT 消息。有关支持的区域的列表,请参阅 Amazon Web Services 一般参考中的Amazon IoT Core端点和配额

Amazon IoT 消息代理通过将消息从发布客户端发送到订阅客户端来连接 Amazon IoT 客户端。有关更多信息,请参阅Amazon IoT开发者指南Amazon IoT中的消息代理

More information (2)

当您发布 MQTT 消息时,必须指定以下参数。

mqttTopic

接收消息的 MQTT 主题。

您可以使用在检测器模型中创建的变量或输入值在运行时动态定义 MQTT 主题名称。

payload

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

注意

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

有关更多信息,请参阅《Amazon IoT Events API 参考》中的 IotTopicPublishAction

Amazon IoT Events

IoT Events action

该Amazon IoT Events操作允许您将数据Amazon IoT Events作为输入发送到。有关支持的区域的列表,请参阅 Amazon Web Services 一般参考中的Amazon IoT Events端点和配额

Amazon IoT Events允许您监控您的设备或设备机群中的故障或操作中的更改,并在发生此类事件时触发操作。有关更多信息,请参阅 Amazon IoT Events 开发人员指南中的什么是 Amazon IoT Events?

More information (2)

当您将数据发送到时Amazon IoT Events,必须指定以下参数。

inputName

接收数据的Amazon IoT Events输入的名称。

payload

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

注意

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

有关更多信息,请参阅《Amazon IoT Events API 参考》中的 IotEventsAction

Amazon IoT SiteWise

IoT SiteWise action

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

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或两者assetIdpropertyId以标识目标资产属性。

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

propertyAlias

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

assetId

(可选)包含指定属性的资产的 ID。您也可以指定表达式。

propertyId

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

entryId

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

propertyValue

一个包含属性值的详细信息的结构。

quality

(可选)资产属性值的质量。值必须为 GOODBADUNCERTAIN。您也可以指定表达式。

timestamp

(可选)一个包含时间戳信息的结构。如果您未指定此值,则默认为事件时间。

timeInSeconds

采用 Unix 纪元时间格式的时间戳(以秒为单位)。有效范围在 1-31556889864403199 之间。您也可以指定表达式。

offsetInNanos

(可选)从转换时的纳秒偏移量timeInSeconds。有效范围在 0-999999999 之间。您也可以指定表达式。

value

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

重要

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

booleanValue

(可选)资产属性值是一个布尔值,该值必须为TRUEFALSE。您也可以指定表达式。如果使用表达式,则计算结果应为布尔值。

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 表中有一个列用于接收指定操作有效负载中的所有属性/值对。有关支持的区域的列表,请参阅亚马逊云科技一般参考中的 Amazon DynamoDB 端点和配额

Amazon DynamoDB 是一种全托管 NoSQL 数据库服务,提供快速而可预测的性能,能够实现无缝扩展。有关更多信息,请参阅什么是 DynamoDB? Amazon DynamoDB 开发人员指南中。

More information (10)

向 DynamoDB 表的一列发送数据时,必须指定以下参数。

tableName

接收数据的 DynamoDB 表的名称。tableName值必须与 DynamoDB 表的表名匹配。您也可以指定表达式。

hashKeyField

哈希键(也称为分区键)的名称。hashKeyField值必须与 DynamoDB 表的分区键匹配。您也可以指定表达式。

hashKeyType

(可选)哈希键的数据类型。哈希键类型的值必须为STRINGNUMBER。默认为 STRING。您也可以指定表达式。

hashKeyValue

哈希键的值。hashKeyValue使用替换模板。这些模板在运行时提供数据。您也可以指定表达式。

rangeKeyField

(可选)范围键(也称为排序键)的名称。rangeKeyField值必须与 DynamoDB 表的排序键匹配。您也可以指定表达式。

rangeKeyType

(可选)范围键的数据类型。哈希键类型的值必须为STRINGNUMBER。默认为 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

有关更多信息,请参阅 Amazon IoT EventsAPI 参考中的 DynamoDBActi on

Amazon DynamoDB (v2)

DynamoDBv2 action

Amazon DynamoDB (v2) 操作允许你将数据写入 DynamoDB 表。DynamoDB 表中有一个单独的列用于接收指定操作有效负载中的一个属性/值对。有关支持的区域的列表,请参阅亚马逊云科技一般参考中的 Amazon DynamoDB 端点和配额

Amazon DynamoDB 是一种全托管 NoSQL 数据库服务,提供快速而可预测的性能,能够实现无缝扩展。有关更多信息,请参阅什么是 DynamoDB? Amazon DynamoDB 开发人员指南中。

More information (2)

向 DynamoDB 表的多列发送数据时,必须指定以下参数。

tableName

接收数据的 DynamoDB 表的名称。您也可以指定表达式。

payload

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

重要

负载类型必须是 JSON。您也可以指定表达式。

注意

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

有关更多信息,请参阅 Amazon IoT EventsAPI 参考中的 DynamoDBV2Acti on

Amazon Kinesis Data Firehose

Firehose action

Amazon Kinesis Data Firehose 操作允许您将数据发送到 Kinesis Data Firehose 传输流。有关支持的区域列表,请参阅 Amazon Web Services 通用参考中的 Amazon Kinesis Data Fireh ose 终端节点和配额

Amazon Kinesis Data Firehose 是一项完全托管服务,用于将实时流数据传输到Amazon Simple 存储服务(Amazon Simple 存储服务)、Amazon Redshift sis Service( OpenSearch OpenSearch 服务)和 Splunk 等目标。有关更多信息,请参阅什么是 Amazon Kinesis Data Firehose? Amazon 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

Lambda action

该Amazon Lambda操作允许您调用 Lambda 函数。有关支持的区域的列表,请参阅 Amazon Web Services 一般参考中的Amazon Lambda端点和配额

Amazon Lambda 是一项计算服务,可使您无需预配置或管理服务器即可运行代码。有关更多信息,请参阅 Amazon Lambda 开发人员指南中的什么是 Amazon Lambda?

More information (2)

当您调用 Lambda 函数时,必须指定以下参数。

functionArn

要调用的 Lambda 函数的 ARN。

payload

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

注意

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

有关更多信息,请参阅《Amazon IoT Events API 参考》中的 LambdaAction

Amazon Simple Notification Service

SNS action

Amazon SNS 主题发布操作允许您发布Amazon SNS 消息。有关支持的区域的列表,请参阅亚马逊云科技一般参考中的 Amazon Simple NotificatiAmazon Web Services e 终端节点和配额

Amazon Simple Notification Service(Amazon Simple Notification Service)是一项 Web 服务,用于协调和管理向订阅端节点或客户端交付 有关更多信息,请参阅什么是 Amazon SNS? Amazon Simple Notion Serv ice

注意

Amazon 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

Amazon SQS 操作允许您将数据发送到 Amazon SQS 队列。有关支持的区域的列表,请参阅 Amazon Web Services 一般参考中的 Amazon Sim p le Queueueueueueue

Amazon Simple Queue Service (Amazon SQS) eueueueueueueueueueueueueueueueueueueueueueueueueueueu 有关更多信息,请参阅 Amazon Simple Q ueueueueueue ueueueueueue ueue

注意

Amazon SQS 操作不支持 Amazon SQS FIFO(先入先出)主题。由于规则引擎是一个完全分布式服务,因此触发 Amazon SQS 操作时,消息可能不会按指定顺序显示。

More information (3)

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

queueUrl

接收数据的Amazon SQS 队列的 URL。

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作为输入发送到探测器。