Amazon SNS

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

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

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

版本

此组件具有以下版本：

类型

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

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

操作系统

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

要求

此组件具有以下要求：

端点和端口

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

依赖项

部署组件时， AWS IoT Greengrass 还会部署其依赖项的兼容版本。这意味着您必须满足组件及其所有依赖关系的要求，才能成功部署组件。本部分列出了此组件的已发布版本的依赖关系，以及定义每个依赖关系的组件版本的语义版本约束。您还可以在 AWS 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。有关如何在自定义组件中订阅此主题消息的更多信息，请参阅 发布/订阅 AWS IoT Core MQTT 消息。

默认主题 (AWS 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 Core 软件许可协议下发行。

更改日志

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