教學課程：使用 AWS Lambda 函數格式化通知

建立新的 AWS Lambda 函數。

1. 於 AWS Lambda 主控台中，選擇 Create function (建立函數)。

2. 於 Create function (建立函數) 中，選取 Use a blueprint (使用藍圖)。

   搜尋並選取 hello-world-python 藍圖，然後選擇 Configure (設定)。

3. 於基本資訊中：

   1. 在 Function name (函數名稱) 中，輸入此函數的名稱 format-high-temp-notification。

   2. 在執行角色中，選擇從 AWS 政策範本建立新角色。

   3. 於 Role name (角色名稱) 中，輸入新角色 format-high-temp-notification-role 的名稱。

   4. 在 Policy templates - optional (政策範本：選用) 中，搜尋並選取 Amazon SNS publish policy (Amazon SNS 發佈政策)。

   5. 選擇建立函數。

修改藍圖程式碼以進行格式化並傳送 Amazon SNS 通知。

1. 在您建立函數之後，您應該會看到 format-high-temp-notification 詳細資訊頁面。若您未看到，請從 Lambda 函數 頁面上加以開啟。

2. 在format-high-temp-notification 詳細資訊頁面中，選擇Configuration (組態) 索引標籤，然後捲動至 Function code (函數程式碼) 面板。

3. 於 Function code (函數程式碼) 視窗的 Environment (環境) 窗格中，選擇 Python 檔案 lambda_function.py。

4. 於 Function code (函數程式碼) 視窗中，刪除藍圖中的所有原始程式程式碼，並以此程式碼進行取代。

   import boto3
   #
   #   expects event parameter to contain:
   #   {
   #       "device_id": "32",
   #       "reported_temperature": 38,
   #       "max_temperature": 30,
   #       "notify_topic_arn": "arn:aws:sns:us-east-1:57EXAMPLE833:high_temp_notice"
   #   }
   # 
   #   sends a plain text string to be used in a text message
   #
   #      "Device {0} reports a temperature of {1}, which exceeds the limit of {2}."
   #   
   #   where:
   #       {0} is the device_id value
   #       {1} is the reported_temperature value
   #       {2} is the max_temperature value
   #
   def lambda_handler(event, context):
   
       # Create an SNS client to send notification
       sns = boto3.client('sns')
   
       # Format text message from data
       message_text = "Device {0} reports a temperature of {1}, which exceeds the limit of {2}.".format(
               str(event['device_id']),
               str(event['reported_temperature']),
               str(event['max_temperature'])
           )
   
       # Publish the formatted message
       response = sns.publish(
               TopicArn = event['notify_topic_arn'],
               Message = message_text
           )
   
       return response

5. 選擇部署。

在新視窗中，從教學課程有關如何進行 教學課程：傳送 Amazon SNS 通知 中查詢您 Amazon SNS 主題的 Amazon 資源名稱 (ARN)。

1. 於新視窗中，開啟 Amazon SNS 主控台的主題頁面。

2. 於 Topics (主題) 頁面中，於 Amazon SNS 主題清單中尋找 high_temp_notice 通知主題。

3. 尋找 high_temp_notice 通知主題的 ARN，以用於下一個步驟中。

建立您 Lambda 函數的測試案例。

1. 於主控台的 Lambda 函數頁面的 format-high-temp-notification 詳細資訊頁面上，選擇該頁面右上角中的 Select a test event (選擇測試事件) (即使看似已停用)，然後選擇 Configure test events (設定測試事件)。

2. 於 Configure test event (設定測試事件) 中，選擇 Create new test event (建立新的測試事件)。

3. 於 Event name (事件名稱) 中，輸入 SampleRuleOutput。

4. 在 Event name (事件名稱) 下的 JSON 編輯器，請貼上此範例 JSON 文件。這是您的 AWS IoT 規則將傳送到 Lambda 函數的範例。

   {
     "device_id": "32",
     "reported_temperature": 38,
     "max_temperature": 30,
     "notify_topic_arn": "arn:aws:sns:us-east-1:57EXAMPLE833:high_temp_notice"
   }

5. 請參閱具有 high_temp_notice 通知主題之 ARN 的視窗，然後複製 ARN 值。

6. 以您通知主題的 ARN 取代 JSON 編輯器中的 notify_topic_arn 值。

   保持此視窗的開啟狀態，您可於建立 AWS IoT 規則時再次使用此 ARN 值。

7. 選擇建立。

以範例資料測試函數。

1. 於 format-high-temp-notification 詳細資料頁面的右上角中，確認 SampleRuleOutput 會顯示於 Test (測試) 按鈕旁。若未顯示，請從可用的測試事件清單中進行選擇。

2. 如要將範例規則輸出訊息傳送至您的函數，請選擇 Test (測試)。

開啟 AWS IoT 主控台的規則中樞。

如要於 Rules (規則) 中開始建立新規則，請選擇 Create (建立)。

在 Create a rule (建立規則) 的頂部中：

1. 於 Name (名稱) 中，輸入規則名稱 wx_friendly_text。

   請記住，規則名稱在您的 AWS 帳戶 和 區域中必須是唯一的，而且不能有任何空格。我們在此名稱中使用底線字元來分隔規則名稱中的兩個單字。

2. 在 Description (說明) 中，說明規則。

   有意義的說明可讓您更容易記住此規則的作用及您建立規則的原因。說明可依所需而定，因此請盡可能詳細說明。

在 Create a rule (建立規則) 的 Rule query statement (規則查詢陳述式) 中：

1. 在使用 SQL 版本中，選取 2016-03-23。

2. 在 Rule query statement (規則查詢陳述式) 編輯方塊中輸入陳述式：

   SELECT 
     cast(topic(2) AS DECIMAL) as device_id, 
     temperature as reported_temperature,
     30 as max_temperature,
     'arn:aws:sns:us-east-1:57EXAMPLE833:high_temp_notice' as notify_topic_arn
   FROM 'device/+/data' WHERE temperature > 30

   本陳述式：

   • 聆聽主題與 device/+/data 主題篩選條件相符及 temperature 值大於 30 的 MQTT 訊息。

   • 從主題字串選取第二個元素，將其轉換為十進位數字，進而指派給 device_id 欄位。

   • 從訊息承載選取值 temperature 欄位的值，然後將其指派給 reported_temperature 欄位。

   • 建立常數值 30 來表示限制值，並將其指定給 max_temperature 欄位。

   • 建立 notify_topic_arn 欄位的常數值。

3. 請參閱具有 high_temp_notice 通知主題之 ARN 的視窗，然後複製 ARN 值。

4. 以您通知主題的 ARN 取代規則查詢陳述式編輯器中的 ARN 值 (arn:aws:sns:us-east-1:57EXAMPLE833:high_temp_notice)。

於 Set one or more actions (設定一個或多個動作) 中：

1. 若要開啟此規則的規則動作清單，請選擇 Add action (新增動作)。

2. 於 Select an action (選取動作) 中，選擇 Send a message to a Lambda function (將訊息傳送至 Lambda 函數)。

3. 若要開啟所選取動作的組態頁面，請在動作清單底部選擇 Configure action (設定動作)。

於 Configure action (設定動作)：

1. 於 Function name (函數名稱) 中，選擇 Select (選取)。

2. 選擇 format-high-temp-notification。

3. 在 Configure action (設定動作) 的底部，選擇 Add action (新增動作)。

4. 如要建立規則，請於 Create a rule (建立規則) 中，選擇 Create rule (建立規則)。

在 AWS 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 (訂閱) 下選擇 Publish to topic (發佈至主題)。

2. 在 Publish (發佈) 欄位中輸入輸入主題名稱 device/32/data。

3. 複製此處顯示的範例資料，並在主題名稱下方的編輯方塊中貼上範例資料。

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

4. 如要發佈您的 MQTT 訊息，請選擇 Publish to topic (發佈至主題)。

確認簡訊已傳送。

1. 在 MQTT 用戶端中 Subscriptions (訂閱) 下，您先前訂閱的主題旁會有一個綠點。

   該綠點表示自上次查看後，已收到一個或多個新訊息。

2. 於 Subscriptions (訂閱) 下，選擇 device/+/data，來檢查訊息承載是否與您剛剛發佈的內容相符，如下所示：

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

3. 檢查您用來訂閱 SNS 主題的手機，並確認訊息承載內容如下所示：

   Device 32 reports a temperature of 38, which exceeds the limit of 30.

   若您變更訊息主題中的主題 ID 元素，請記得，僅當訊息主題中的該元素僅包含數字字元時，將 topic(2) 值轉換為數值才會有效。

請嘗試傳送溫度不超過限制的 MQTT 訊息。

1. 在 MQTT 用戶端中的 Subscriptions (訂閱) 下選擇 Publish to 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 訂閱中傳送的訊息；但因溫度值低於規則查詢陳述式中的最高溫度，您不應收到簡訊。

若您並未看到正確的行為，請查看疑難排解提示。