Amazon SNS

Die SNS Amazon-Komponente (aws.greengrass.SNS) veröffentlicht Nachrichten zu einem Amazon Simple Notification Service (AmazonSNS) -Thema. Sie können diese Komponente verwenden, um Ereignisse von Greengrass-Core-Geräten an Webserver, E-Mail-Adressen und andere Nachrichtenabonnenten zu senden. Weitere Informationen finden Sie unter Was ist AmazonSNS? im Amazon Simple Notification Service Developer Guide.

Um mit dieser Komponente in einem SNS Amazon-Thema zu veröffentlichen, veröffentlichen Sie eine Nachricht zu dem Thema, das diese Komponente abonniert. Standardmäßig abonniert diese Komponente das sns/message lokale Thema „Veröffentlichen/Abonnieren“. Sie können andere Themen, einschließlich AWS IoT Core MQTT Themen, angeben, wenn Sie diese Komponente bereitstellen.

In Ihrer benutzerdefinierten Komponente möchten Sie möglicherweise eine Filter- oder Formatierungslogik implementieren, um Nachrichten aus anderen Quellen zu verarbeiten, bevor Sie sie in dieser Komponente veröffentlichen. Auf diese Weise können Sie Ihre Nachrichtenverarbeitungslogik in einer einzigen Komponente zentralisieren.

Versionen

Diese Komponente hat die folgenden Versionen:

Typ

Diese Komponente ist eine Lambda-Komponente (aws.greengrass.lambda). Der Greengrass-Kern führt die Lambda-Funktion dieser Komponente mithilfe der Lambda-Launcher-Komponente aus.

Weitere Informationen finden Sie unter Komponententypen.

Betriebssystem

Diese Komponente kann nur auf Linux-Kerngeräten installiert werden.

Voraussetzungen

Für diese Komponente gelten die folgenden Anforderungen:

Endpunkte und Ports

Diese Komponente muss in der Lage sein, ausgehende Anfragen an die folgenden Endpunkte und Ports auszuführen, zusätzlich zu den Endpunkten und Ports, die für den Basisbetrieb erforderlich sind. Weitere Informationen finden Sie unter Zulassen von Gerätedatenverkehr über einen Proxy oder eine Firewall.

Abhängigkeiten

Wenn Sie eine Komponente bereitstellen, stellt sie AWS IoT Greengrass auch kompatible Versionen ihrer Abhängigkeiten bereit. Das bedeutet, dass Sie die Anforderungen für die Komponente und all ihre Abhängigkeiten erfüllen müssen, um die Komponente erfolgreich bereitstellen zu können. In diesem Abschnitt werden die Abhängigkeiten für die veröffentlichten Versionen dieser Komponente sowie die semantischen Versionseinschränkungen aufgeführt, die die Komponentenversionen für jede Abhängigkeit definieren. Sie können auch die Abhängigkeiten für jede Version der Komponente in der AWS IoT Greengrass Konsole anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der Abhängigkeiten.

Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den Komponentenrezepten.

Konfiguration

Diese Komponente stellt die folgenden Konfigurationsparameter bereit, die Sie bei der Bereitstellung der Komponente anpassen können.

{
  "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"
}

Eingabedaten

Diese Komponente akzeptiert Nachrichten zum folgenden Thema und veröffentlicht die Nachricht unverändert im SNS Amazon-Zielthema. Standardmäßig abonniert diese Komponente lokale Veröffentlichungs-/Abonnement-Nachrichten. Weitere Informationen zum Veröffentlichen von Nachrichten aus Ihren benutzerdefinierten Komponenten in dieser Komponente finden Sie unter. Lokale Nachrichten veröffentlichen/abonnieren

Standardthema (lokal veröffentlichen/abonnieren): sns/message

Die Nachricht akzeptiert die folgenden Eigenschaften. Eingabenachrichten müssen im JSON Format vorliegen.

{
  "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"
}

Ausgabedaten

Diese Komponente veröffentlicht standardmäßig Antworten als Ausgabedaten zum folgenden MQTT Thema. Sie müssen dieses Thema subject in der Konfiguration für die ältere Abonnement-Router-Komponente angeben. Weitere Informationen zum Abonnieren von Nachrichten zu diesem Thema in Ihren benutzerdefinierten Komponenten finden Sie unterNachrichten veröffentlichen/abonnieren AWS IoT Core MQTT.

Standardthema (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"
}

Lokale Protokolldatei

Diese Komponente verwendet die folgende Protokolldatei.

/greengrass/v2/logs/aws.greengrass.SNS.log

Lizenzen

Diese Komponente umfasst die folgende Software/Lizenzierung von Drittanbietern:

Diese Komponente wird im Rahmen der Greengrass Core Software-Lizenzvereinbarung veröffentlicht.

Änderungsprotokoll

In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.