Amazon SNS

Amazon SNS元件 (aws.greengrass.SNS) 會將訊息發佈至 Amazon Simple Notification Service (Amazon SNS) 主題。您可以使用此元件，將事件從 Greengrass 核心裝置傳送至 Web 伺服器、電子郵件地址和其他訊息訂閱者。如需詳細資訊，請參閱《Amazon Simple Notification Service 開發人員指南》中的什麼是 AmazonSNS？。

若要使用此元件發佈至 Amazon SNS主題，請將訊息發佈至此元件訂閱的主題。根據預設，此元件會訂閱sns/message本機發佈/訂閱主題。您可以在部署此元件時指定其他主題，包括 AWS IoT Core MQTT主題。

在自訂元件中，您可能想要實作篩選或格式化邏輯，以便在發佈訊息到此元件之前處理來自其他來源的訊息。這可讓您將訊息處理邏輯集中在單一元件上。

版本

此元件具有下列版本：

Type

此元件是 Lambda 元件 (aws.greengrass.lambda)。Greengrass 核會使用 Lambda 啟動器元件執行此元件的 Lambda 函數。

如需詳細資訊，請參閱元件類型。

作業系統

此元件只能安裝在 Linux 核心裝置上。

要求

此元件有下列需求：

端點和連接埠

除了基本操作所需的端點和連接埠之外，此元件還必須能夠對下列端點和連接埠執行傳出請求。如需詳細資訊，請參閱允許裝置流量透過 Proxy 或防火牆。

相依性

部署元件時， 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 軟體授權合約發行。

變更記錄

下表說明每個版本元件的變更。