教程：发送 Amazon SNS 通知

创建 Amazon SNS 主题。

1. 登录 Amazon SNS 控制台。

2. 在左侧导航窗格中，选择主题。

3. 在 Topics（主题）页面上，选择 Create topic（创建主题）。

4. 在 Details（详细信息）中，选择 Standard（标准）类型。默认情况下，控制台会创建一个FIFO主题。

5. 在名称中，输入SNS主题名称。在本教程中，请输入 high_temp_notice。

6. 滚动到页面底部，然后选择 Create topic（创建主题）。

   控制台会打开新主题的详细信息页面。

创建 Amazon SNS 订阅。

1. 在 high_temp_notice 主题详细信息页面上，选择 Create subscription（创建订阅）。

2. 在创建订阅的详细信息部分的协议列表中，选择SMS。

3. 在 Endpoint（端点）中，输入可接收文本消息的电话号码。请务必输入号码，以 +开头，包含国家和地区代码，并且不包括任何其它标点符号字符。

4. 选择 Create subscription（创建订阅）。

测试 Amazon SNS 通知。

1. 在 Amazon SNS 控制台的左侧导航窗格中，选择主题。

2. 要打开主题的详细信息页面，请在 Topics（主题），在主题列表中，选择 high_temp_notice。

3. 打开 Publish message to topic（将消息发布到主题）页面中的 high_temp_notice详细信息页面，选择 Publish message（发布消息）。

4. 在 Publish message to topic（将消息发布到主题），在 Message body（消息正文）部分，Message body to send to the endpoint（要发送到端点的消息正文）中，输入一条简短的消息。

5. 滚动到页面底部并选择 Publish message（发布消息）。

6. 在使用您之前创建订阅时使用的号码的电话上，确认已收到消息。

如果您没有收到测试消息，请仔细检查电话号码和手机的设置。

在继续本教程之前，请确保您可以从 Amazon SNS 控制台发布测试消息。

打开AWS IoT 控制台的 “规则” 中心。

如果这是您的第一条规则，请选择 Create（创建），或者 Create a rule（创建规则）。

在 Create a rule（创建规则）中：

1. 在 Name（名称）中，输入 temp_limit_notify。

   请记住，规则名称在您的 AWS 账户 和区域内必须是唯一的，并且不能有任何空格。我们在此名称中使用了下划线字符来分隔规则名称中的单词。

2. 在 Description（说明）中，描述规则。

   有意义的描述可以更容易地记住此规则的作用以及您创建它的原因。描述可以根据需要延长，因此请尽可能详细。

在 Create a rule（创建规则）的 Rule query statement（规则查询语句）中：

1. 在 “使用SQL版本” 中，选择 2016-03-23。

2. 在 Rule query statement（规则查询语句）编辑框中，输入语句：

   SELECT topic(2) as device_id, 
       temperature as reported_temperature, 
       30 as max_temperature 
     FROM 'device/+/data' 
     WHERE temperature > 30

   本语句：

   • 监听主题与device/+/data主题筛选条件匹配且temperature值大于 30 的MQTT消息。

   • 从主题字符串中选择第二个元素，并将其分配给 device_id字段。

   • 从消息负载中选择 temperature字段的值，并将其分配给 reported_temperature字段。

   • 创建常数值 30来表示限制值，并将其赋值给 max_temperature字段。

要打开此规则的规则操作列表，请在 Set one or more actions（设置一个或多个操作）中，选择 Add action（添加操作）。

在 “选择操作” 中，选择 “以SNS推送通知形式发送消息”。

要打开选定操作的配置页面，请在操作列表底部选择 Configure action（配置操作）。

在 Configure action（配置操作）中：

1. 在SNS目标中，选择选择，找到名为 high_temp_notice SNS 的主题，然后选择选择。

2. 在 “消息格式” 中，选择RAW。

3. 在选择或创建角色以授予执行此操作的 AWS IoT 访问权限中，选择创建角色。

4. 在 Create a new role（创建新角色）中，Name（名称）项下，输入新角色的唯一名称。在本教程中，请使用 sns_rule_role。

5. 选择 Create role（创建角色）。

如果要重复本教程或重复使用现有角色，请选择 Update role（更新角色）然后再继续。这会更新角色的策略文档以与SNS目标配合使用。

选择 Add action（添加操作），然后返回到 Create a rule（创建规则）页。

在新操作的图块中，在 “以SNS推送通知形式发送消息” 下方，您可以看到您的规则将调用的SNS主题。

这是您将添加到此规则的唯一规则操作。

要创建规则并完成此步骤，请在 Create a rule（创建规则）中，向下滚动到底部，然后选择 Create rule（创建规则）。

在AWS IoT 控制台的MQTT客户端中，订阅输入主题，在本例中为device/+/data。

1. 在MQTT客户端的 “订阅” 下，选择 “订阅主题”。

2. 在 Subscription topic（订阅主题）中，输入输入主题筛选条件的主题，device/+/data。

3. 将其它字段保留为默认设置。

4. 选择 Subscribe to topic（订阅主题）。

   在 Subscriptions（订阅）栏，在 Publish to a topic（发布到主题）项下，将会显示 device/+/data。

使用特定设备 ID device/32/data向输入主题发布消息。您无法发布到包含通配符的MQTT话题。

1. 在MQTT客户端的 “订阅” 下，选择 “发布到主题”。

2. 在 Publish（发布）字段中，输入输入主题名称，device/32/data。

3. 复制此处显示的示例数据，然后在主题名称下方的编辑框中粘贴示例数据。

   {
     "temperature": 38,
     "humidity": 80,
     "barometer": 1013,
     "wind": {
       "velocity": 22,
       "bearing": 255
     }
   }

4. 选择 “发布到主题” 以发布您的MQTT消息。

确认文本消息已发送。

1. 在MQTT客户端的 “订阅” 下，您之前订阅的主题旁边有一个绿点。

   绿色圆点表示自上次查看消息以来已收到一条或多条新消息。

2. 在 Subscriptions（订阅）中，选择 device/+/data 来检查消息负载是否与刚刚发布的内容匹配，如下所示：

   {
     "temperature": 38,
     "humidity": 80,
     "barometer": 1013,
     "wind": {
       "velocity": 22,
       "bearing": 255
     }
   }

3. 检查您用来订阅该SNS主题的手机，并确认消息负载的内容如下所示：

   {"device_id":"32","reported_temperature":38,"max_temperature":30}

   请注意，device_id 值是一个带引号的字符串，temperature 值为数字。这是因为 topic()函数从输入消息的主题名称中提取字符串，而 temperature值使用输入消息负载中的数值。

   如果您想使 device_id值为数值，请在规则查询语句中将 topic(2)替换为：

   cast(topic(2) AS DECIMAL)

   请注意，将 topic(2)值设置为数字，DECIMAL 值仅在主题的该部分仅包含数字字符时才起作用。

尝试发送MQTT一条温度不超过极限的消息。

1. 在MQTT客户端的 “订阅” 下，选择 “发布到主题”。

2. 在 Publish（发布）字段中，输入输入主题名称，device/33/data。

3. 复制此处显示的示例数据，然后在主题名称下方的编辑框中粘贴示例数据。

   {
     "temperature": 28,
     "humidity": 80,
     "barometer": 1013,
     "wind": {
       "velocity": 22,
       "bearing": 255
     }
   }

4. 要发送MQTT消息，请选择发布到主题。

您应该会看到您在 device/+/data订阅中发送的消息。但是，由于温度值低于规则查询语句中的最大温度，因此您应无法收到文本消息。

如果您未看到正确的行为，请检查故障排除提示。