Amazon SNS

亚马逊 SNS 组件 (aws.greengrass.SNS) 向亚马逊简单通知服务 (Amazon SNS) Simple Notification Service 主题发布消息。您可以使用此组件将事件从 Greengrass 核心设备发送到 Web 服务器、电子邮件地址和其他消息订阅者。有关更多信息，请参阅《Amazon Simple Notification Service 开发者指南》中的什么是 Amazon SNS？。

要使用此组件发布到 Amazon SNS 主题，请向该组件订阅的主题发布一条消息。默认情况下，此组件订阅sns/message本地发布/ 订阅主题。部署此组件时，您可以指定其他主题，包括 Amazon IoT Core MQTT 主题。

在您的自定义组件中，您可能需要实现筛选或格式化逻辑来处理来自其他来源的消息，然后再将其发布到此组件。这使您能够将消息处理逻辑集中在单个组件上。

版本

此组件有以下版本：

类型

此组件是一个 Lambda 组件 () aws.greengrass.lambda。Greengrass 核心使用 Lambda 启动器组件运行此组件的 Lambda 函数。

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

操作系统

此组件只能安装在 Linux 核心设备上。

要求

此组件具有以下要求：

端点和端口

除了基本操作所需的端点和端口外，此组件还必须能够对以下端点和端口执行出站请求。有关更多信息，请参阅允许设备流量通过代理或防火墙。

依赖项

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

有关组件依赖关系的更多信息，请参阅组件配方参考。

配置

此组件提供以下配置参数，您可以在部署该组件时对其进行自定义。

{
  "lambdaExecutionParameters": {
    "EnvironmentVariables": {
      "DEFAULT_SNS_ARN": "arn:aws:sns:us-west-2:123456789012:mytopic"
    }
  },
  "containerMode": "GreengrassContainer"
}

{
  "lambdaExecutionParameters": {
    "EnvironmentVariables": {
      "DEFAULT_SNS_ARN": "arn:aws:sns:us-west-2:123456789012:mytopic"
    }
  },
  "containerMode": "NoContainer"
}

输入数据

此组件接受有关以下主题的消息，并将消息按原样发布到目标 Amazon SNS 主题。默认情况下，此组件订阅本地发布/订阅消息。有关如何从您的自定义组件向该组件发布消息的更多信息，请参阅发布/订阅本地消息。

默认主题（本地发布/订阅）：sns/message

该消息接受以下属性。输入消息必须采用 JSON 格式。

{
  "request": {
    "subject": "Message subject",
    "message": "Message data",
    "sns_topic_arn": "arn:aws:sns:region:account-id:topic2-name"
  },
  "id": "request123"
}

{
  "request": {
    "subject": "Message subject",
    "message": "{ \"default\": \"Message data\" }",
    "message_structure": "json"
  },
  "id": "request123"
}

输出数据

默认情况下，此组件将响应作为以下 MQTT 主题的输出数据发布。您必须在传统订阅路由器组件的配置subject中将此主题指定为。有关如何在您的自定义组件中订阅有关此主题的消息的更多信息，请参阅发布/订阅 Amazon IoT Core MQTT 消息。

默认主题 (Amazon IoT Core MQTT)：sns/message/status

{
  "response": {
    "sns_message_id": "f80a81bc-f44c-56f2-a0f0-d5af6a727c8a",
    "status": "success"
  },
  "id": "request123"
}

{
  "response" : {
    "error": "InvalidInputException",
    "error_message": "SNS Topic Arn is invalid",
    "status": "fail"
  },
  "id": "request123"
}

本地日志文件

此组件使用以下日志文件。

/greengrass/v2/logs/aws.greengrass.SNS.log

许可证

此组件包括以下第三方软件/许可：

该组件是根据 Greengrass 核心软件许可协议发布的。

更改日志

下表描述了该组件的每个版本中的更改。