教學課程：使用 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. 在政策範本 - 選用 中，搜尋並選取 Amazon SNS 發佈政策 。

   5. 選擇建立函數。

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

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

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

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 Resource Name （ARN），了解如何 教學課程：傳送 Amazon SNS通知。

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

2. 在主題頁面中，尋找 Amazon 主題清單中的 high_temp_notice 通知SNS主題。

3. 尋找要在下一個步驟中使用的 high_temp_notice 通知主題ARN的 。

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

1. 在主控台的 Lambda Functions 頁面中，在format-high-temp-notification詳細資訊頁面上，選擇頁面右上角的選取測試事件 （即使看起來已停用），然後選擇設定測試事件 。

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

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

4. 在事件名稱 下方的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. 將JSON編輯器中的 notify_topic_arn 值取代為通知主題ARN中的 。

   保持此視窗開啟，以便在建立 AWS IoT 規則時再次使用此ARN值。

7. 選擇 Create (建立)。

以範例資料測試函數。

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

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

   本陳述式：

   • 接聽具有符合主題篩選條件且temperature值大於 30 device/+/data之主題MQTT的訊息。

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

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

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

   • 建立 notify_topic_arn 欄位的常數值。

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

4. 取代 ARN值 （arn:aws:sns:us-east-1:57EXAMPLE833:high_temp_notice） 在您的規則查詢陳述式編輯器中，包含通知主題ARN的 。

在 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 (建立規則)。

在MQTT主控台的 AWS IoT 用戶端 中，訂閱輸入主題，在此情況下，訂閱 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 32 reports a temperature of 38, which exceeds the limit of 30.

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

嘗試傳送訊息，MQTT其中溫度未超過限制。

1. 在MQTT用戶端的訂閱 下，選擇發佈至主題 。

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

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

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

4. 若要傳送訊息MQTT，請選擇發佈至主題 。

您應該會看到您在 device/+/data 訂閱中傳送的訊息；但因溫度值低於規則查詢陳述式中的最高溫度，您不應收到簡訊。

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