Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Amazon SNS
<a name="sns-component"></a>

Die Amazon SNS-Komponente (`aws.greengrass.SNS`) veröffentlicht Nachrichten zu einem Amazon Simple Notification Service (Amazon SNS) -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 Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/welcome.html)? im *Amazon Simple Notification Service Developer Guide*.

Um mit dieser Komponente in einem Amazon SNS SNS-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](ipc-publish-subscribe.md) Thema „Veröffentlichen/Abonnieren“. Sie können andere Themen angeben, einschließlich AWS IoT Core MQTT-Themen, 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.

**Anmerkung**  
Diese Komponente bietet ähnliche Funktionen wie der Amazon SNS SNS-Connector in AWS IoT Greengrass Version 1. Weitere Informationen finden Sie unter [Amazon SNS Connector](https://docs.aws.amazon.com/greengrass/latest/developerguide/sns-connector.html) im *AWS IoT Greengrass V1-Entwicklerhandbuch*.

**Topics**
+ [Versionen](#sns-component-versions)
+ [Typ](#sns-component-type)
+ [Betriebssystem](#sns-component-os-support)
+ [Voraussetzungen](#sns-component-requirements)
+ [Abhängigkeiten](#sns-component-dependencies)
+ [Konfiguration](#sns-component-configuration)
+ [Eingabedaten](#sns-component-input-data)
+ [Ausgabedaten](#sns-component-output-data)
+ [Lokale Protokolldatei](#sns-component-log-file)
+ [Lizenzen](#sns-component-licenses)
+ [Änderungsprotokoll](#sns-component-changelog)

## Versionen
<a name="sns-component-versions"></a>

Diese Komponente hat die folgenden Versionen:
+ 2.1.x
+ 2.0.x

## Typ
<a name="sns-component-type"></a>

<a name="public-component-type-lambda"></a>Diese <a name="public-component-type-lambda-phrase"></a>Komponente ist eine Lambda-Komponente (`aws.greengrass.lambda`). [Der [Greengrass-Kern führt die](greengrass-nucleus-component.md) Lambda-Funktion dieser Komponente mithilfe der Lambda-Launcher-Komponente aus.](lambda-launcher-component.md)

<a name="public-component-type-more-information"></a>Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).

## Betriebssystem
<a name="sns-component-os-support"></a>

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

## Voraussetzungen
<a name="sns-component-requirements"></a>

Für diese Komponente gelten die folgenden Anforderungen:
+ <a name="core-device-lambda-function-requirements"></a>Ihr Kerngerät muss die Anforderungen für die Ausführung von Lambda-Funktionen erfüllen. Wenn Sie möchten, dass das Kerngerät containerisierte Lambda-Funktionen ausführt, muss das Gerät die entsprechenden Anforderungen erfüllen. Weitere Informationen finden Sie unter [Anforderungen an die Lambda-Funktion](setting-up.md#greengrass-v2-lambda-requirements).
+ <a name="public-component-python3-requirement"></a>[Python-Version](https://www.python.org/) 3.7 wurde auf dem Core-Gerät installiert und zur Umgebungsvariablen PATH hinzugefügt.
+ Amazon SNS-Thema. Weitere Informationen finden Sie unter [Amazon SNS-Thema anlegen](https://docs.aws.amazon.com/sns/latest/dg/sns-create-topic.html) im *Amazon Simple Notification Service-Entwicklerhandbuch*.
+ Die [Greengrass-Geräterolle](device-service-role.md) muss die `sns:Publish` Aktion zulassen, wie im folgenden Beispiel für eine IAM-Richtlinie gezeigt.

------
#### [ JSON ]

****  

  ```
  {
    "Version":"2012-10-17",		 	 	 
    "Statement": [
      {
        "Action": [
          "sns:Publish"
        ],
        "Effect": "Allow",
        "Resource": [
          "arn:aws:sns:us-east-1:123456789012:topic-name"
        ]
      }
    ]
  }
  ```

------

  Sie können das Standardthema in der Nutzlast der Eingabenachricht für diese Komponente dynamisch überschreiben. Wenn Ihre Anwendung diese Funktion verwendet, muss die IAM-Richtlinie alle Zielthemen als Ressourcen enthalten. Sie können Ressourcen granularen oder bedingten Zugriff gewähren (etwa mit einem Benennungsschema mit Platzhaltern `*`).
+ <a name="connector-component-legacy-subscription-router-dependency"></a>Um Ausgabedaten von dieser Komponente zu erhalten, müssen Sie bei der Bereitstellung dieser Komponente das folgende Konfigurationsupdate für die [ältere Abonnement-Router-Komponente](legacy-subscription-router-component.md) (`aws.greengrass.LegacySubscriptionRouter`) zusammenführen. Diese Konfiguration gibt das Thema an, zu dem diese Komponente Antworten veröffentlicht.

------
#### [ Legacy subscription router v2.1.x ]

  ```
  {
    "subscriptions": {
      "aws-greengrass-sns": {
        "id": "aws-greengrass-sns",
        "source": "component:aws.greengrass.SNS",
        "subject": "sns/message/status",
        "target": "cloud"
      }
    }
  }
  ```

------
#### [ Legacy subscription router v2.0.x ]

  ```
  {
    "subscriptions": {
      "aws-greengrass-sns": {
        "id": "aws-greengrass-sns",
        "source": "arn:aws:lambda:region:aws:function:aws-greengrass-sns:version",
        "subject": "sns/message/status",
        "target": "cloud"
      }
    }
  }
  ```<a name="connector-component-legacy-subscription-router-dependency-replace"></a>
  + *region*Ersetzen Sie es durch AWS-Region das, was Sie verwenden.
  + *version*Ersetzen Sie durch die Version der Lambda-Funktion, die diese Komponente ausführt. Um die Version der Lambda-Funktion zu finden, müssen Sie sich das Rezept für die Version dieser Komponente ansehen, die Sie bereitstellen möchten. Öffnen Sie die Detailseite dieser Komponente in der [AWS IoT Greengrass Konsole](https://console.aws.amazon.com//greengrass) und suchen Sie nach dem **Schlüssel-Wert-Paar der Lambda-Funktion**. Dieses Schlüssel-Wert-Paar enthält den Namen und die Version der Lambda-Funktion.

**Wichtig**  <a name="connector-component-legacy-subscription-router-dependency-note"></a>
Sie müssen die Lambda-Funktionsversion auf dem Legacy-Abonnement-Router jedes Mal aktualisieren, wenn Sie diese Komponente bereitstellen. Dadurch wird sichergestellt, dass Sie die richtige Lambda-Funktionsversion für die Komponentenversion verwenden, die Sie bereitstellen.

------

  <a name="connector-component-create-deployments"></a>Weitere Informationen finden Sie unter [Erstellen von Bereitstellungen](create-deployments.md).
+ Die Amazon SNS SNS-Komponente wird für die Ausführung in einer VPC unterstützt. Um diese Komponente in einer VPC bereitzustellen, ist Folgendes erforderlich.
  + Die Amazon SNS SNS-Komponente muss über Konnektivität verfügen`sns.region.amazonaws.com`, zu der der VPC-Endpunkt ist. `com.amazonaws.us-east-1.sns`

### Endpunkte und Ports
<a name="sns-component-endpoints"></a>

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 [Geräteverkehr über einen Proxy oder eine Firewall zulassen](allow-device-traffic.md).


| Endpoint | Port | Erforderlich | Description | 
| --- | --- | --- | --- | 
|  `sns.region.amazonaws.com`  | 443 | Ja |  Veröffentlichen Sie Nachrichten in Amazon SNS.  | 

## Abhängigkeiten
<a name="sns-component-dependencies"></a>

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](#sns-component-changelog) 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](https://console.aws.amazon.com//greengrass) anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der **Abhängigkeiten**.

------
#### [ 2.1.10 ]

In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.10 dieser Komponente aufgeführt.


| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit | 
| --- | --- | --- | 
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.16.0  | Hart | 
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0  | Hart | 
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0  | Weich | 
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0  | Hart | 

------
#### [ 2.1.9 ]

In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.9 dieser Komponente aufgeführt.


| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit | 
| --- | --- | --- | 
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.15.0  | Hart | 
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0  | Hart | 
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0  | Weich | 
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0  | Hart | 

------
#### [ 2.1.8 ]

In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.8 dieser Komponente aufgeführt.


| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit | 
| --- | --- | --- | 
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.14.0  | Hart | 
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0  | Hart | 
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0  | Weich | 
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0  | Hart | 

------
#### [ 2.1.7 ]

In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.7 dieser Komponente aufgeführt.


| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit | 
| --- | --- | --- | 
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0  | Hart | 
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0  | Hart | 
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0  | Weich | 
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0  | Hart | 

------
#### [ 2.1.6 ]

In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.6 dieser Komponente aufgeführt.


| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit | 
| --- | --- | --- | 
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0  | Hart | 
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0  | Hart | 
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0  | Weich | 
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0  | Hart | 

------
#### [ 2.1.5 ]

In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.5 dieser Komponente aufgeführt.


| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit | 
| --- | --- | --- | 
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0  | Hart | 
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0  | Hart | 
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0  | Weich | 
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0  | Hart | 

------
#### [ 2.1.4 ]

In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.4 dieser Komponente aufgeführt.


| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit | 
| --- | --- | --- | 
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0  | Hart | 
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0  | Hart | 
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0  | Weich | 
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0  | Hart | 

------
#### [ 2.1.3 ]

In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.3 dieser Komponente aufgeführt.


| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit | 
| --- | --- | --- | 
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0  | Hart | 
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0  | Hart | 
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0  | Weich | 
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0  | Hart | 

------
#### [ 2.1.2 ]

In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.2 dieser Komponente aufgeführt.


| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit | 
| --- | --- | --- | 
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0  | Hart | 
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0  | Hart | 
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0  | Weich | 
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0  | Hart | 

------
#### [ 2.1.1 ]

In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.1 dieser Komponente aufgeführt.


| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit | 
| --- | --- | --- | 
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0  | Hart | 
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0  | Hart | 
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0  | Weich | 
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0  | Hart | 

------
#### [ 2.0.8 - 2.1.0 ]

In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.0.8 und 2.1.0 dieser Komponente aufgeführt.


| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit | 
| --- | --- | --- | 
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0  | Hart | 
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0  | Hart | 
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0  | Weich | 
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0  | Hart | 

------
#### [ 2.0.7 ]

In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.7 dieser Komponente aufgeführt.


| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit | 
| --- | --- | --- | 
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0  | Hart | 
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0  | Hart | 
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0  | Weich | 
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0  | Hart | 

------
#### [ 2.0.6 ]

In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.6 dieser Komponente aufgeführt.


| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit | 
| --- | --- | --- | 
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0  | Hart | 
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0  | Hart | 
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0  | Weich | 
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0  | Hart | 

------
#### [ 2.0.5 ]

In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.5 dieser Komponente aufgeführt.


| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit | 
| --- | --- | --- | 
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0  | Hart | 
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0  | Hart | 
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0  | Weich | 
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0  | Hart | 

------
#### [ 2.0.4 ]

In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.4 dieser Komponente aufgeführt.


| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit | 
| --- | --- | --- | 
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0  | Hart | 
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0  | Hart | 
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0  | Weich | 
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0  | Hart | 

------
#### [ 2.0.3 ]

In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.3 dieser Komponente aufgeführt.


| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit | 
| --- | --- | --- | 
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.3 <2.1.0  | Hart | 
| [Lambda-Launcher](lambda-launcher-component.md) | >=1.0.0  | Hart | 
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | >=1,0.0  | Weich | 
| [Token-Austauschdienst](token-exchange-service-component.md) | >=1.0.0  | Hart | 

------

Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den [Komponentenrezepten](component-recipe-reference.md#recipe-reference-component-dependencies).

## Konfiguration
<a name="sns-component-configuration"></a>

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

**Anmerkung**  <a name="connector-component-lambda-parameters"></a>
Die Standardkonfiguration dieser Komponente umfasst Lambda-Funktionsparameter. Wir empfehlen, dass Sie nur die folgenden Parameter bearbeiten, um diese Komponente auf Ihren Geräten zu konfigurieren.

`lambdaParams`  
Ein Objekt, das die Parameter für die Lambda-Funktion dieser Komponente enthält. Dieses Objekt enthält die folgenden Informationen:    
`EnvironmentVariables`  
Ein Objekt, das die Parameter der Lambda-Funktion enthält. Dieses Objekt enthält die folgenden Informationen:    
`DEFAULT_SNS_ARN`  
Der ARN des Amazon SNS SNS-Standardthemas, in dem diese Komponente Nachrichten veröffentlicht. Sie können das Zielthema mit der `sns_topic_arn` Eigenschaft in der Nutzlast der Eingabenachricht überschreiben.

`containerMode`  <a name="connector-component-container-mode-parameter"></a>
(Optional) Der Containerisierungsmodus für diese Komponente. Wählen Sie aus den folgenden Optionen aus:  <a name="lambda-function-component-container-mode-parameter"></a>
+ `NoContainer`— Die Komponente wird nicht in einer isolierten Laufzeitumgebung ausgeführt.
+ `GreengrassContainer`— Die Komponente läuft in einer isolierten Laufzeitumgebung innerhalb des AWS IoT Greengrass Containers.
Standard: `GreengrassContainer`

`containerParams`  
<a name="connector-component-container-params-description"></a>(Optional) Ein Objekt, das die Container-Parameter für diese Komponente enthält. Die Komponente verwendet diese Parameter, wenn Sie `GreengrassContainer` für angeben`containerMode`.  
Dieses Objekt enthält die folgenden Informationen:    
`memorySize`  
<a name="connector-component-container-params-memory-size-description"></a>(Optional) Die Speichermenge (in Kilobyte), die der Komponente zugewiesen werden soll.  
Der Standardwert ist 512 MB (525.312 KB).

`pubsubTopics`  <a name="connector-component-pubsub-topics-parameter"></a>
(Optional) Ein Objekt, das die Themen enthält, in denen die Komponente den Empfang von Nachrichten abonniert. Sie können jedes Thema angeben und angeben, ob die Komponente MQTT-Themen von AWS IoT Core oder lokale Themen abonniert. publish/subscribe   
Dieses Objekt enthält die folgenden Informationen:    
`0`— Dies ist ein Array-Index als Zeichenfolge.  
Ein Objekt, das die folgenden Informationen enthält:    
`type`  
(Optional) Der publish/subscribe Messaging-Typ, den diese Komponente verwendet, um Nachrichten zu abonnieren. Wählen Sie aus den folgenden Optionen aus:  
+ `PUB_SUB` — Abonnieren Sie lokale Veröffentlichen/Abonnement-Nachrichten. Wenn Sie diese Option wählen, darf das Thema keine MQTT-Platzhalter enthalten. Weitere Informationen zum Senden von Nachrichten von einer benutzerdefinierten Komponente aus, wenn Sie diese Option angeben, finden Sie unter. [Lokale Nachrichten veröffentlichen/abonnieren](ipc-publish-subscribe.md)
+ `IOT_CORE`— Abonnieren Sie AWS IoT Core MQTT-Nachrichten. Wenn Sie diese Option wählen, kann das Thema MQTT-Platzhalter enthalten. Weitere Informationen zum Senden von Nachrichten aus benutzerdefinierten Komponenten, wenn Sie diese Option angeben, finden Sie unter. [MQTT-Nachrichten veröffentlichen/abonnieren AWS IoT Core](ipc-iot-core-mqtt.md)
Standard: `PUB_SUB`  
`topic`  
(Optional) Das Thema, das die Komponente abonniert, um Nachrichten zu empfangen. Wenn Sie `IotCore` für angeben`type`, können Sie in diesem Thema MQTT-Platzhalter (`+`und`#`) verwenden.

**Example Beispiel: Aktualisierung der Konfigurationszusammenführung (Container-Modus)**  

```
{
  "lambdaExecutionParameters": {
    "EnvironmentVariables": {
      "DEFAULT_SNS_ARN": "arn:aws:sns:us-west-2:123456789012:mytopic"
    }
  },
  "containerMode": "GreengrassContainer"
}
```

**Example Beispiel: Aktualisierung der Konfigurationszusammenführung (kein Container-Modus)**  

```
{
  "lambdaExecutionParameters": {
    "EnvironmentVariables": {
      "DEFAULT_SNS_ARN": "arn:aws:sns:us-west-2:123456789012:mytopic"
    }
  },
  "containerMode": "NoContainer"
}
```

## Eingabedaten
<a name="sns-component-input-data"></a>

Diese Komponente akzeptiert Nachrichten zum folgenden Thema und veröffentlicht die Nachricht unverändert im Amazon SNS SNS-Zielthema. <a name="connector-component-local-publish"></a>Standardmäßig abonniert diese Komponente lokale publish/subscribe Nachrichten. Weitere Informationen zum Veröffentlichen von Nachrichten aus Ihren benutzerdefinierten Komponenten in dieser Komponente finden Sie unter[Lokale Nachrichten veröffentlichen/abonnieren](ipc-publish-subscribe.md). 

**Standardthema (lokales Veröffentlichen/Abonnieren):** `sns/message`

<a name="connector-component-input-properties"></a>Die Nachricht akzeptiert die folgenden Eigenschaften. Eingabenachrichten müssen im JSON-Format vorliegen.

`request`  
Die Informationen zu der Nachricht, die an das Amazon SNS SNS-Thema gesendet werden soll.  
Typ: der `object` die folgenden Informationen enthält:    
`message`  
Der Inhalt der Nachricht als Zeichenfolge.  
Um ein JSON-Objekt zu senden, serialisieren Sie es als Zeichenfolge und geben Sie es `json` für die `message_structure` Eigenschaft an.  
Typ: `string`  
`subject`  
(Optional) Der Betreff der Nachricht.  
Typ: `string`  
Der Betreff kann aus ASCII-Text und bis zu 100 Zeichen bestehen. Er muss mit einem Buchstaben, einer Zahl oder einem Satzzeichen beginnen. Es darf keine Zeilenumbrüche oder Steuerzeichen enthalten.  
`sns_topic_arn`  
(Optional) Der ARN des Amazon SNS SNS-Themas, in dem diese Komponente die Nachricht veröffentlicht. Geben Sie diese Eigenschaft an, um das standardmäßige Amazon SNS SNS-Thema zu überschreiben.  
Typ: `string`  
`message_structure`  
(Optional) Die Struktur der Nachricht. Geben Sie `json` in der `content` Eigenschaft an, dass eine JSON-Nachricht gesendet werden soll, die Sie als Zeichenfolge serialisieren.  
Typ: `string`  
Zulässige Werte: `json`

`id`  <a name="connector-component-input-property-id"></a>
Eine willkürliche ID für die Anforderung. Verwenden Sie diese Eigenschaft, um eine Eingabeanforderung einer Ausgabeantwort zuzuordnen. Wenn Sie diese Eigenschaft angeben, setzt die Komponente die `id` Eigenschaft im Antwortobjekt auf diesen Wert.  
Typ: `string`

**Anmerkung**  
Die Nachrichtengröße kann maximal 256 KB betragen.

**Example Beispieleingabe: Zeichenfolgen-Nachricht**  

```
{
  "request": {
    "subject": "Message subject",
    "message": "Message data",
    "sns_topic_arn": "arn:aws:sns:region:account-id:topic2-name"
  },
  "id": "request123"
}
```

**Example Beispieleingabe: JSON-Nachricht**  

```
{
  "request": {
    "subject": "Message subject",
    "message": "{ \"default\": \"Message data\" }",
    "message_structure": "json"
  },
  "id": "request123"
}
```

## Ausgabedaten
<a name="sns-component-output-data"></a>

 <a name="connector-component-output-data"></a>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](legacy-subscription-router-component.md) angeben. Weitere Informationen zum Abonnieren von Nachrichten zu diesem Thema in Ihren benutzerdefinierten Komponenten finden Sie unter[MQTT-Nachrichten veröffentlichen/abonnieren AWS IoT Core](ipc-iot-core-mqtt.md). 

**Standardthema (AWS IoT Core MQTT):** `sns/message/status`

**Example Beispielausgabe: Erfolg**  

```
{
  "response": {
    "sns_message_id": "f80a81bc-f44c-56f2-a0f0-d5af6a727c8a",
    "status": "success"
  },
  "id": "request123"
}
```

**Example Beispielausgabe: Fehler**  

```
{
  "response" : {
    "error": "InvalidInputException",
    "error_message": "SNS Topic Arn is invalid",
    "status": "fail"
  },
  "id": "request123"
}
```

## Lokale Protokolldatei
<a name="sns-component-log-file"></a>

Diese Komponente verwendet die folgende Protokolldatei.

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

**Um die Protokolle dieser Komponente einzusehen**
+ Führen Sie den folgenden Befehl auf dem Kerngerät aus, um die Protokolldatei dieser Komponente in Echtzeit anzuzeigen. `/greengrass/v2`Ersetzen Sie es durch den Pfad zum AWS IoT Greengrass Stammordner.

  ```
  sudo tail -f /greengrass/v2/logs/aws.greengrass.SNS.log
  ```

## Lizenzen
<a name="sns-component-licenses"></a>

Diese Komponente umfasst die folgende Software/Lizenzierung von Drittanbietern:<a name="boto-3-licenses"></a>
+ [AWS SDK für Python (Boto3)](https://pypi.org/project/boto3/)/Apache-Lizenz 2.0
+ [botocore](https://pypi.org/project/botocore/)/Apache-Lizenz 2.0
+ [dateutil](https://pypi.org/project/python-dateutil/1.4/)/PSF-Lizenz
+ [docutils](https://pypi.org/project/docutils/)/BSD-Lizenz, GNU General Public License (GPL), Python Software Foundation License, Public Domain
+ [jmespath](https://pypi.org/project/jmespath/)/MIT-Lizenz
+ [s3transfer](https://pypi.org/project/s3transfer/)/Apache-Lizenz 2.0
+ [urllib3](https://pypi.org/project/urllib3/)/MIT-Lizenz

<a name="component-core-software-license"></a>Diese Komponente wird im Rahmen der [Greengrass Core Software-Lizenzvereinbarung](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf) veröffentlicht.

## Änderungsprotokoll
<a name="sns-component-changelog"></a>

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


|  **Version**  |  **Änderungen**  | 
| --- | --- | 
|  2.1.10  | Die Version wurde für die Version 2.15.0 von Greengrass Nucleus aktualisiert. | 
|  2.1.9  | Die Version wurde für die Version 2.14.0 von Greengrass Nucleus aktualisiert. | 
|  2.1.8  | Die Version wurde für die Version 2.13.0 von Greengrass Nucleus aktualisiert. | 
|  2.1.7  | Die Version wurde für die Version 2.12.0 von Greengrass Nucleus aktualisiert. | 
|  2.1.6  | Die Version wurde für die Version 2.11.0 von Greengrass Nucleus aktualisiert. | 
|  2.1.5  | Die Version wurde für die Version 2.10.0 von Greengrass Nucleus aktualisiert. | 
|  2.1.4  | Die Version wurde für die Version 2.9.0 von Greengrass Nucleus aktualisiert. | 
|  2.1.3  | Die Version wurde für die Version 2.8.0 von Greengrass Nucleus aktualisiert. | 
|  2.1.2  |  Die Version wurde für die Version 2.7.0 von Greengrass Nucleus aktualisiert.  | 
|  2.1.1  |  Die Version wurde für die Version 2.6.0 von Greengrass Nucleus aktualisiert.  | 
|  2.1.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/sns-component.html)  | 
|  2.0.8  |  Die Version wurde für die Version 2.5.0 von Greengrass Nucleus aktualisiert.  | 
|  2.0.7  |  Die Version wurde für die Version 2.4.0 von Greengrass Nucleus aktualisiert.  | 
|  2.0.6  |  Die Version wurde für die Version 2.3.0 von Greengrass Nucleus aktualisiert.  | 
|  2.0.5  |  Die Version wurde für die Version 2.2.0 von Greengrass Nucleus aktualisiert.  | 
|  2.0.4  |  Die Version wurde für die Version 2.1.0 von Greengrass Nucleus aktualisiert.  | 
|  2.0.3  |  Erste Version  |