旧版订阅路由器 - Amazon IoT Greengrass
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

旧版订阅路由器

旧版订阅路由器 (aws.greengrass.LegacySubscriptionRouter) 管理 Greengrass 核心设备上的订阅。订阅是Amazon IoT GreengrassV1,定义 Lambda 函数可用于核心设备上的 MQTT 消息传送的主题。有关更多信息,请参阅 。MQTT 消息传递工作流中的托管订阅中的Amazon IoT GreengrassV1 开发人员指南.

您可以使用此组件为连接器组件和 Lambda 函数组件启用预订,这些组件使用Amazon IoT Greengrass核心开发工具包。

注意

仅当您的 Lambda 函数使用publish()函数Amazon IoT Greengrass核心开发工具包。如果您更新 Lambda 函数代码以使用 V2 中的进程间通信 (IPC) 接口Amazon IoT Device SDK,不需要部署旧订阅路由器组件。有关更多信息,请参阅以下进程间通信服务:

Versions

此组件具有以下版本:

  • 2.1.x

  • 2.0.x

Type

此组件是一个通用组件 (aws.greengrass.generic)。这些区域有:Greengrass 核心运行组件的生命周期脚本。

有关更多信息,请参阅组件类型

Dependencies

部署组件时,Amazon IoT Greengrass还部署其依赖关系的兼容版本。这意味着您必须满足组件及其所有依赖关系的要求才能成功部署组件。此部分列出了发布版本以及定义每个依赖关系的组件版本的语义版本约束。您也可以在中查看每一版本的组件的依赖关系。Amazon IoT Greengrass控制台. 在组件详细信息页面上,查找依赖项列表

2.1.3

下表列出了此组件 2.1.3 版的依赖关系。

依赖关系 兼容的版本 依赖关系类型
Greengrass 核心 >=2.5.0 软性
2.1.2

下表列出了此组件 2.1.2 版的依赖关系。

依赖关系 兼容的版本 依赖关系类型
Greengrass 核心 >=2.0.0 软性
2.1.1

下表列出了此组件 2.1.1 版的依赖关系。

依赖关系 兼容的版本 依赖关系类型
Greengrass 核心 >=2.3.0 软性
2.1.0

下表列出了此组件 2.1.0 版的依赖关系。

依赖关系 兼容的版本 依赖关系类型
Greengrass 核心 >=2.2.0 软性
2.0.3

下表列出了此组件 2.0.3 版的依赖关系。

依赖关系 兼容的版本 依赖关系类型
Greengrass 核心 >2.1.0 软性

有关组件依赖项的更多信息,请参阅。组件配方参考.

Configuration

此组件提供了以下配置参数,您可以在部署组件时自定义这些参数。

v2.1.x
subscriptions

(可选)要在核心设备上启用的订阅。这是一个对象,其中每个密钥都是唯一的 ID,每个值都是定义该连接器的预订的对象。当您部署 V1 连接器组件或使用Amazon IoT Greengrass核心开发工具包。

每个订阅对象都包含以下信息:

id

此订阅的唯一 ID。此 ID 必须与此订阅对象的密钥匹配。

source

Lambda 函数使用Amazon IoT Greengrass核心 SDK 用于发布有关您在subject. 指定下列项之一:

  • 核心设备上 Lambda 函数组件的名称。指定组件名称,并使用component:前缀,例如component:com.example.HelloWorldLambda.

  • 核心设备上 Lambda 函数的 Amazon 资源名称 (ARN)。

    重要

    如果 Lambda 函数的版本发生更改,则必须使用该函数的新版本配置订阅。否则,在版本与订阅匹配之前,此组件不会路由邮件。

    您必须指定 Amazon 资源名称 (ARN),其中包括要导入的函数版本。您不能使用像 $LATEST 这样的版本别名。

要部署 V1 连接器组件的预订,请指定该组件的名称或连接器组件的 Lambda 函数的 ARN。

subject

源和目标可以在其中发布和接收消息的 MQTT 主题或主题筛选器。此值支持+#主题通配符。

target

接收 MQTT 消息的目标,您在subject. 订阅指定source函数将 MQTT 消息发布到Amazon IoT Core或核心设备上的 Lambda 函数。指定下列项之一:

  • cloud. 这些区域有:source函数将 MQTT 消息发布到Amazon IoT Core.

  • 核心设备上 Lambda 函数组件的名称。指定组件名称,并使用component:前缀,例如component:com.example.HelloWorldLambda.

  • 核心设备上 Lambda 函数的 Amazon 资源名称 (ARN)。

    重要

    如果 Lambda 函数的版本发生更改,则必须使用该函数的新版本配置订阅。否则,在版本与订阅匹配之前,此组件不会路由邮件。

    您必须指定 Amazon 资源名称 (ARN),其中包括要导入的函数版本。您不能使用像 $LATEST 这样的版本别名。

默认值:无订阅

例 配置更新示例(定义Amazon IoT Core)

下面的示例指定com.example.HelloWorldLambdaLambda 函数组件将 MQTT 消息发布到Amazon IoT Core上hello/world主题。

{ "subscriptions": { "Greengrass_HelloWorld_to_cloud": { "id": "Greengrass_HelloWorld_to_cloud", "source": "component:com.example.HelloWorldLambda", "subject": "hello/world", "target": "cloud" } } }

例 配置更新示例(定义另一个 Lambda 函数的订阅)

下面的示例指定com.example.HelloWorldLambdaLambda 函数组件将 MQTT 消息发布到com.example.MessageRelayLambda 函数组件hello/world主题。

{ "subscriptions": { "Greengrass_HelloWorld_to_cloud": { "id": "Greengrass_HelloWorld_to_cloud", "source": "component:com.example.HelloWorldLambda", "subject": "hello/world", "target": "component:com.example.MessageRelay" } } }
v2.0.x
subscriptions

(可选)要在核心设备上启用的订阅。这是一个对象,其中每个密钥都是唯一的 ID,每个值都是定义该连接器的预订的对象。当您部署 V1 连接器组件或使用Amazon IoT Greengrass核心开发工具包。

每个订阅对象都包含以下信息:

id

此订阅的唯一 ID。此 ID 必须与此订阅对象的密钥匹配。

source

Lambda 函数使用Amazon IoT Greengrass核心 SDK 用于发布有关您在subject. 指定以下内容:

  • 核心设备上 Lambda 函数的 Amazon 资源名称 (ARN)。

    重要

    如果 Lambda 函数的版本发生更改,则必须使用该函数的新版本配置订阅。否则,在版本与订阅匹配之前,此组件不会路由邮件。

    您必须指定 Amazon 资源名称 (ARN),其中包括要导入的函数版本。您不能使用像 $LATEST 这样的版本别名。

要为 V1 连接器组件部署预订,请指定连接器组件的 Lambda 函数的 ARN。

subject

源和目标可以在其中发布和接收消息的 MQTT 主题或主题筛选器。此值支持+#主题通配符。

target

接收 MQTT 消息的目标,您在subject. 订阅指定source函数将 MQTT 消息发布到Amazon IoT Core或核心设备上的 Lambda 函数。指定下列项之一:

  • cloud. 这些区域有:source函数将 MQTT 消息发布到Amazon IoT Core.

  • 核心设备上 Lambda 函数的 Amazon 资源名称 (ARN)。

    重要

    如果 Lambda 函数的版本发生更改,则必须使用该函数的新版本配置订阅。否则,在版本与订阅匹配之前,此组件不会路由邮件。

    您必须指定 Amazon 资源名称 (ARN),其中包括要导入的函数版本。您不能使用像 $LATEST 这样的版本别名。

默认值:无订阅

例 配置更新示例(定义Amazon IoT Core)

下面的示例指定Greengrass_HelloWorld函数将 MQTT 消息发布到Amazon IoT Core上hello/world主题。

"subscriptions": { "Greengrass_HelloWorld_to_cloud": { "id": "Greengrass_HelloWorld_to_cloud", "source": "arn:aws:lambda:us-west-2:123456789012:function:Greengrass_HelloWorld:5", "subject": "hello/world", "target": "cloud" } }

例 配置更新示例(定义另一个 Lambda 函数的订阅)

下面的示例指定Greengrass_HelloWorld函数将 MQTT 消息发布到Greengrass_MessageRelayhello/world主题。

"subscriptions": { "Greengrass_HelloWorld_to_cloud": { "id": "Greengrass_HelloWorld_to_cloud", "source": "arn:aws:lambda:us-west-2:123456789012:function:Greengrass_HelloWorld:5", "subject": "hello/world", "target": "arn:aws:lambda:us-west-2:123456789012:function:Greengrass_MessageRelay:5" } }

Changelog

下表介绍每一版本的组件中的更改。

Version

更改

2.1.3

版本更新了 Greengrass 核版本 2.4.0

2.1.2

版本更新了 Greengrass 核版本 2.3.0

2.1.1

版本更新了 Greengrass 核版本 2.2.0

2.1.0

错误修复和改进
  • 添加对指定组件名称而不是 ARN 的支持sourcetarget. 如果为预订指定组件名称,则无需在每次 Lambda 函数版本更改时重新配置预订。

2.0.3

初始版本。