教程：发送 Amazon SNS 通知

创建 Amazon SNS 主题。

1. 登录 Amazon SNS 控制台。

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

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

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

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

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

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

创建 Amazon SNS 订阅。

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

2. 在 Create subscripition（创建订阅），在 Details（详细信息）部分中，在 Protocol（协议）列表中，选择 SMS。

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

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

测试 Amazon SNS 通知。

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

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 控制台发布测试消息，然后继续本教程。

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

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

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

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

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

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

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

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

1. 在 Using SQL version（使用 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（添加操作）。

在 Select an action（选择操作）页面上，选择 Send a message as an SNS push notification（将消息发送为 SNS 推送通知）。

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

在 Configure action（配置操作）中：

1. 在 SNS target（SNS target）中，选择 Select（选择），找到您名为 high_temp_notice 的 SNS 主题，然后选择 Select（选择）。

2. 对于 Message format（消息格式），请选择 RAW。

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

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

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

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

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

在新操作的磁贴中，在 Send a message as an SNS push notification（将消息作为 SNS 推送通知发送）项下，您可以看到规则将调用的 SNS 主题。

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

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

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

1. 在 MQTT 客户端中，在 Subscriptions（订阅）项下，选择 Subscribe to a topic（订阅主题）。

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

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

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

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

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

1. 在 MQTT 客户端中，在 Subscriptions（订阅）项下，选择 Subscribe to a topic（订阅主题）。

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

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

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

4. 选择 Publish to topic（发布到主题）以发布您的 MQTT 消息。

确认文本消息已发送。

1. 在 MQTT 客户端，Subscriptions（订阅）项下，您之前订阅的主题旁边会有一个绿色圆点。

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

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 客户端中，在 Subscriptions（订阅）项下，选择 Subscribe to a topic（订阅主题）。

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

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

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

4. 要发送您的 MQTT 消息，请选择 Publish to topic（发布到主题）。

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

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