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.
# Veranstaltungsziele in AWS End User Messaging SMS
Ein *Eventziel* ist ein Ort (z. B. eine CloudWatch Gruppe, ein Amazon Data Firehose-Stream oder ein Amazon SNS SNS-Thema), an den SMS- und Sprachereignisse gesendet werden. Um Veranstaltungsziele zu verwenden, erstellen Sie zuerst das Ziel und verknüpfen es dann mit einem. [Konfigurationssätze in AWS End User Messaging SMS](configuration-sets.md) Sie können bis zu fünf Ereignisziel einem einzelnen Konfigurationssatz zuordnen. Wenn Sie eine Nachricht senden, enthält Ihr API-Aufruf einen Verweis auf den Konfigurationssatz.
Von Transporteuren generierte Ereignisse oder Empfangsbestätigungen (DLR) können bis zu 72 Stunden in Anspruch nehmen. Sie sollten daher nicht verwendet werden, um festzustellen, ob es bei der Zustellung ausgehender Nachrichten zu Verzögerungen gekommen ist. Wenn die AWS Endbenutzer-Nachrichten-SMS nach 72 Stunden kein letztes Ereignis von einem Mobilfunkanbieter erhalten hat, gibt der Dienst automatisch eine UNBEKANNTE Meldung zurück, `messageStatus` da wir nicht wissen, was mit der Nachricht passiert ist.
**Voraussetzungen**
Sie müssen bereits einen Konfigurationssatz erstellt haben, mit dem Sie die Veranstaltungsziele verknüpfen können, siehe[Konfigurationssätze in AWS End User Messaging SMS](configuration-sets.md).
**Topics**
+ [Event types (Ereignistypen)](configuration-sets-event-types.md)
+ [Beispiel für Ereignisdaten](configuration-sets-event-format.md)
+ [CloudWatch Amazon-Eventziel einrichten](configuration-sets-cloud-watch.md)
+ [Amazon Data Firehose-Ereignisziel einrichten](configuration-sets-kinesis.md)
+ [Richten Sie ein Amazon SNS SNS-Ereignisziel ein](configuration-sets-sns.md)
# Ereignistypen für SMS, MMS und Sprache
Die einfachste Art der Verwendung von Ereigniszielen besteht im Senden aller SMS-, MMS- und Sprachereignisse an ein einziges Ziel. Sie können Ereignisziele jedoch so konfigurieren, dass bestimmte Ereignistypen an unterschiedliche Ziele gesendet werden. Sie könnten beispielsweise alle Ereignisse im Zusammenhang mit der Lieferung zur Speicherung an Firehose und alle Fehlerereignisse an ein Amazon SNS SNS-Thema senden, sodass Sie benachrichtigt werden können, wenn sie eintreten. Sie können auch SMS- und Sprachereignisse an verschiedene Standorte senden.
Sie können Ereignisziele so konfigurieren, dass sie die folgenden Arten von Ereignissen senden:
**SMS-, MMS- und Sprachereignisse**
+ **ALL** — Sendet alle SMS-, MMS- und Sprachereignisse an das angegebene Ziel.
**SMS-Ereignisse**
+ **TEXT\$1ALL**: Sendet alle SMS-Ereignisse an das angegebene Ziel.
+ **TEXT\$1DELIVERED (Zugestellt)** — Sendet alle SMS-Zustellereignisse an das angegebene Ziel. Je nach Zielland können die Ereignisse TEXT\$1DELIVERED und **TEXT\$1SUCCESSFUL** **synonym verwendet werden.**
+ **TEXT\$1SUCCESSFUL (Erfolgreich)** — Erfolgsereignisse treten auf, wenn die Nachricht vom Mobilfunkanbieter des Empfängers akzeptiert wird. Je nach Zielland können die Ereignisse TEXT\$1DELIVERED und **TEXT\$1SUCCESSFUL** **synonym verwendet werden.**
+ **TEXT\$1QUEUED (Queued) — Ereignisse in der Warteschlange** treten auf, wenn sich die Nachricht in der Warteschlange für die Zustellung befindet, aber noch nicht zugestellt wurde.
+ **TEXT\$1PENDING (Pending)** — Ausstehende Ereignisse treten auf, wenn eine Nachricht gerade zugestellt wird, aber noch nicht zugestellt wurde (oder nicht zugestellt werden konnte).
+ **TEXT\$1BLOCKED (Blockiert)** — Blockierte Ereignisse treten auf, wenn das Gerät oder der Mobilfunkanbieter des Empfängers Nachrichten an diesen Empfänger blockiert.
+ **TEXT\$1TTL\$1EXPIRED (TTL abgelaufen) — TTL-Abgelaufene** Ereignisse treten auf, wenn die für die Zustellung der Nachricht benötigte Zeit den `TTL` Wert überschreitet, den Sie beim Senden der Nachricht angegeben haben.
+ **TEXT\$1CARRIER\$1UNREACHABLE (Träger nicht erreichbar) — Ereignisse, bei denen der Träger nicht erreichbar ist**, treten auf, wenn im Trägernetz des Nachrichtenempfängers ein vorübergehender Fehler auftritt.
+ **TEXT\$1INVALID (SMS ungültig) — Ungültige** Ereignisse treten auf, wenn die Zieltelefonnummer nicht gültig ist.
+ **TEXT\$1INVALID\$1MESSAGE (Ungültige Nachricht)** — Ungültige Nachrichtenereignisse treten auf, wenn der Text der SMS-Nachricht ungültig ist und nicht zugestellt werden kann.
+ **TEXT\$1CARRIER\$1BLOCKED (Mobilfunkanbieter blockiert) — Ereignisse, die vom Mobilfunkanbieter blockiert** wurden, treten auf, wenn der Mobilfunkanbieter des Empfängers die Zustellung der Nachricht blockiert. Dies ist in der Regel der Fall, wenn der Mobilfunkanbieter die Nachricht als bösartig (z. B. wenn die Nachricht Informationen im Zusammenhang mit einem Phishing-Betrug enthält) oder als missbräuchlich (z. B. wenn der Verdacht besteht, dass es sich bei der Nachricht um unaufgeforderte oder verbotene Inhalte handelt) identifiziert.
+ **TEXT\$1UNREACHABLE (Unreachable)** — Ereignisse, die nicht erreichbar sind, treten auf, wenn das Gerät des Empfängers nicht verfügbar ist. Dies kann auftreten, wenn das Gerät nicht mit einem Mobilfunknetz verbunden oder ausgeschaltet ist.
+ **TEXT\$1SPAM (Spam)** — Spam-Ereignisse treten auf, wenn der Transporteur des Empfängers feststellt, dass die Nachricht unerwünschte kommerzielle Inhalte enthält, und die Zustellung der Nachricht blockiert.
+ **TEXT\$1UNKNOWN (Unbekannt)** — Unbekannte Ereignisse treten auf, wenn eine Nachricht aus einem Grund nicht zugestellt werden kann, der nicht durch einen der anderen Ereignistypen abgedeckt ist. Unbekannte Fehler können vorübergehend oder dauerhaft sein.
+ **TEXT\$1PROTECT\$1BLOCKED (Protect Blocked) — Nachricht wurde durch die Protect-Konfiguration blockiert**.
**Sprachereignisse**
+ **VOICE\$1ALL**: Sendet alle Sprachereignisse an das angegebene Ziel.
+ **VOICE\$1COMPLETED (Abgeschlossen)** — Abgeschlossene Ereignisse treten auf, wenn die Audionachricht dem Empfänger abgespielt wird. Dieser Status bedeutet nicht unbedingt, dass die Nachricht an einen menschlichen Empfänger zugestellt wurde. Dies könnte beispielsweise darauf hinweisen, dass die Nachricht an ein Voicemail-System zugestellt wurde.
+ **VOICE\$1ANSWERED (Answered) — Ereignisse, die beantwortet wurden**, treten auf, wenn der Empfänger den Anruf entgegennimmt.
+ **VOICE\$1INITIATED (Initiated) — Sendet jedes Mal, wenn eine Sprachnachricht initiiert** wird, Ereignisse an das angegebene Ziel.
+ **VOICE\$1TTL\$1EXPIRED (TTL abgelaufen) — TTL Expired-Ereignisse** treten auf, wenn die für die Zustellung der Nachricht benötigte Zeit den Wert überschreitet, den Sie beim Senden der Nachricht angegeben haben. `TTL`
+ **VOICE\$1BUSY (Busy) — Besetzt-Ereignisse treten auf, wenn** die Telefonleitung des Empfängers besetzt ist.
+ **VOICE\$1NO\$1ANSWER (Keine Antwort)** — Es treten keine Antwortereignisse auf, nachdem der Anruf getätigt wurde, aber der Empfänger (oder sein Voicemail-System) antwortet nie.
+ **VOICE\$1RINGING (Klingeln) — Klingelereignisse treten auf**, nachdem der Anruf getätigt wurde, aber bevor der Empfänger antwortet.
+ **VOICE\$1FAILED (Fehlgeschlagen)** — Fehlerereignisse treten auf, wenn die Nachricht nicht zugestellt werden kann.
**MMS-Ereignisse**
+ **MEDIA\$1ALL** — Sendet alle MMS-Ereignisse an das angegebene Ziel.
+ **MEDIA\$1PENDING (Ausstehend)** — Ausstehende Ereignisse treten auf, wenn eine Nachricht gerade zugestellt wird, aber noch nicht zugestellt wurde (oder nicht zugestellt werden konnte).
+ **MEDIA\$1QUEUED (Warteschlange) — Ereignisse in der Warteschlange** treten auf, wenn sich die Nachricht in der Warteschlange für die Zustellung befindet, aber noch nicht zugestellt wurde.
+ **MEDIA\$1SUCCESSFUL (Erfolgreich)** — Erfolgsereignisse treten auf, wenn die Nachricht vom Mobilfunkanbieter des Empfängers akzeptiert wird.
+ **MEDIA\$1DELIVERED (Zugestellt)** — Sendet alle MMS-Zustellungsereignisse an das angegebene Ziel.
+ **MEDIA\$1INVALID (MMS invalid)** — Ungültige Ereignisse treten auf, wenn die Zieltelefonnummer nicht gültig ist.
+ **MEDIA\$1INVALID\$1MESSAGE (Ungültige Nachricht)** — Ungültige Nachrichtenereignisse treten auf, wenn der Hauptteil der MMS-Nachricht ungültig ist und nicht zugestellt werden kann.
+ **MEDIA\$1UNREACHABLE (Unreachable)** — Ereignisse, die nicht erreichbar sind, treten auf, wenn das Gerät des Empfängers nicht verfügbar ist. Dies kann auftreten, wenn das Gerät nicht mit einem Mobilfunknetz verbunden oder ausgeschaltet ist.
+ **MEDIA\$1CARRIER\$1UNREACHABLE (Carrier unreachable)** — Ereignisse, die nicht erreichbar sind, treten auf, wenn ein vorübergehender Fehler im Trägernetz des Nachrichtenempfängers auftritt.
+ **MEDIA\$1BLOCKED (Blockiert) — Blockierte** Ereignisse treten auf, wenn das Gerät oder der Mobilfunkanbieter des Empfängers Nachrichten an diesen Empfänger blockiert.
+ **MEDIA\$1CARRIER\$1BLOCKED (Mobilfunkanbieter blockiert)** — Ereignisse, die vom Mobilfunkanbieter blockiert wurden, treten auf, wenn der Mobilfunkanbieter des Empfängers die Zustellung der Nachricht blockiert. Dies ist in der Regel der Fall, wenn der Mobilfunkanbieter die Nachricht als bösartig (z. B. wenn die Nachricht Informationen im Zusammenhang mit einem Phishing-Betrug enthält) oder als missbräuchlich (z. B. wenn der Verdacht besteht, dass es sich bei der Nachricht um unaufgeforderte oder verbotene Inhalte handelt) identifiziert.
+ **MEDIA\$1SPAM (Spam)** — Spam-Ereignisse treten auf, wenn der Transporteur des Empfängers feststellt, dass die Nachricht unerwünschte kommerzielle Inhalte enthält, und die Zustellung der Nachricht blockiert.
+ **MEDIA\$1UNKNOWN (Unbekannt)** — Unbekannte Ereignisse treten auf, wenn eine Nachricht aus einem Grund nicht zugestellt werden kann, der nicht durch einen der anderen Ereignistypen abgedeckt ist. Unbekannte Fehler können vorübergehend oder dauerhaft sein.
+ **MEDIA\$1TTL\$1EXPIRED (TTL abgelaufen)** — Ereignisse mit TTL Expired treten auf, wenn die für die Zustellung der Nachricht benötigte Zeit den `TTL` Wert überschreitet, den Sie beim Senden der Nachricht angegeben haben.
+ **MEDIA\$1FILE\$1TYPE\$1UNSUPPORTED (Dateityp nicht unterstützt) — Ereignisse vom Dateityp treten auf, wenn eine Mediendatei nicht in einem unterstützten** Format vorliegt. Eine Liste der unterstützten Dateitypen finden Sie unter [MMS-Dateitypen, Größen- und Zeichenbeschränkungen](mms-limitations-character.md)
+ **MEDIA\$1FILE\$1SIZE\$1EXCEEDED (Dateigröße)** — Ein Ereignis, bei dem die Dateigröße überschritten wird, tritt auf, wenn die Mediendatei größer als 600 KB ist.
+ **MEDIA\$1FILE\$1INACCESSIBLE (Datei nicht zugänglich) — Ereignisse, auf die Datei nicht zugegriffen** werden kann, treten auf, wenn AWS End User Messaging SMS nicht über die erforderlichen Zugriffsrechte auf die Datei verfügt.
# Beispiel für SMS-Ereignisdaten für AWS Endbenutzer-Nachrichten
AWS End User Messaging SMS kann Ereignisdaten für SMS-, MMS- und Sprachnachrichtenzustellungen streamen. Da es bis zu 72 Stunden dauern kann, bis von Mobilfunkanbietern generierte Ereignisse empfangen werden, sollten Sie diese nicht verwenden, um festzustellen, ob es bei der Zustellung ausgehender Nachrichten zu Verzögerungen kommt. Wenn die AWS Endbenutzer-Nachrichten-SMS nach 72 Stunden kein letztes Ereignis von einem Mobilfunkanbieter erhalten hat, gibt der Dienst automatisch eine Meldung zurück, `UNKNOWN` `messageStatus` da wir nicht wissen, was mit der Nachricht passiert ist.
**Topics**
+ [SMS-Beispielprotokoll](#configuration-sets-event-format-sms-example)
+ [Beispielprotokoll für SMS Protect](#configuration-sets-event-format-sms-protect-example)
+ [Beispiel für eine Sprachausgabe, ein Ereignisprotokoll](#configuration-sets-event-format-voice-example)
+ [MMS-Beispielprotokoll](#configuration-sets-event-format-mms-example)
## SMS-Beispielprotokoll
Das JSON-Objekt für ein SMS-Ereignis enthält die Daten wie im folgenden Beispiel.
```
{
"eventType": "TEXT_SUCCESSFUL",
"eventVersion": "1.0",
"eventTimestamp": 1686975103470,
"isFinal": true,
"originationPhoneNumber": "+12065550152",
"destinationPhoneNumber": "+14255550156",
"isInternationalSend": false,
"mcc": "310",
"mnc": "800",
"messageId": "862a8790-60c0-4430-9b2b-658bdexample",
"messageRequestTimestamp": 1686975103170,
"messageEncoding": "GSM",
"messageType": "PROMOTIONAL",
"messageStatus": "SUCCESSFUL",
"messageStatusDescription": "Message has been accepted by phone carrier",
"context": {
"account": "bar"
},
"totalMessageParts": 1,
"totalMessagePrice": 0.09582,
"totalCarrierFee": 0.0
}
```
****
| Attribut | Description |
| --- | --- |
| eventType | Der Ereignistyp. Die Werte sind aufgeführt in [Ereignistypen für SMS, MMS und Sprache](configuration-sets-event-types.md) |
| eventVersion | Die Version des Ereignis-JSON-Schemas. |
| eventTimestamp | Der Zeitpunkt, zu dem das Ereignis gemeldet wurde, angezeigt als Unix-Zeit in Millisekunden. |
| isFinal | Truewenn dies der endgültige Status der Nachricht ist. Es gibt Zwischenstatus für Nachrichten, und es kann bis zu 72 Stunden dauern, bis der endgültige Nachrichtenstatus eingeht. |
| originationPhoneNumber | Die Telefonnummer, von der die Nachricht gesendet wurde. |
| destinationPhoneNumber | Die Telefonnummer, an die Sie versucht haben, die Nachricht zu senden. |
| isInternationalSend | Truewenn internationale Nachrichtenübermittlung für diese Telefonnummer aktiviert ist. |
| isoCountryCode | Das Land , die der Telefonnummer des Empfängers zugeordnet ist, im ISO 3166-1 Alpha-2-Format. |
| mcc | Mobile Country Codes identifiziert das Land, zu dem eine Telefonnummer gehört. Dieses Feld ist optional und möglicherweise nicht vorhanden. |
| mnc | Mobile Network Codes identifiziert einen Mobilfunknetzbetreiber. Dieses Feld ist optional und möglicherweise nicht vorhanden. |
| messageId | Die eindeutige ID, die AWS End User Messaging SMS generiert, wenn die Nachricht akzeptiert wird. |
| messageRequestTimestamp | Die Uhrzeit, zu der die SMS-Nachrichtenanforderung empfangen wurde, wird als Unix-Zeit in Millisekunden angezeigt. |
| messageEncoding | Die Kodierung der Nachricht. Mögliche Werte sind GSM und Unicode. Weitere Hinweise zur Nachrichtenkodierung finden Sie unter[SMS-Zeichenbeschränkungen](sms-limitations-character.md). |
| messageType | Der Nachrichtentyp. Mögliche Werte sind Promotional und Transactional. |
| messageStatus | Der Status der Nachricht. Die möglichen Werte sind: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/sms-voice/latest/userguide/configuration-sets-event-format.html) |
| messageStatusDescription | Eine Beschreibung des Nachrichtenstatus. |
| context | Benutzerdefinierte Attribute, die Sie angeben können und die protokolliert werden, wenn Sie eine Nachricht senden. |
| totalMessageParts | Die Anzahl der Nachrichtenteile, die AWS End User Messaging SMS erstellt hat, um die Nachricht zu senden. Im Allgemeinen können SMS-Nachrichten nur 160 GSM-7-Zeichen oder 67 Nicht-GSM-Zeichen enthalten, obwohl diese Limits je nach Land variieren können. Wenn Sie eine Nachricht senden, die diese Grenzwerte überschreitet, teilt AWS End User Messaging SMS die Nachricht automatisch in kleinere Teile auf. Wir erstellen Rechnungen basierend auf der Anzahl der Mitteilungsteile, die Sie senden. Weitere Informationen zu Teilen von Nachrichten finden Sie unter[Was sind die MPS-Grenzwerte (Message Parts per Second)?](sms-limitations-mps.md). |
| totalMessagePrice | Der Betrag, den wir Ihnen für das Senden der Nachricht berechnet haben. Dieser Preis wird in Tausendstel eines US-Cents angegeben. Wenn der Wert dieses Attributs beispielsweise 645 lautet, wird Ihnen für das Senden der Nachricht 0,645 ¢ in Rechnung gestellt (645/1 000 = 0,645 ¢ = 0,00645 \$1). |
| totalCarrierFee | Die Gesamtkosten der Transporteurgebühren für eine Nachricht. |
## Beispielprotokoll für SMS Protect
Das JSON-Objekt für ein SMS-Ereignis bei Verwendung von [SMS Protect](protect.md) enthält die im folgenden Beispiel gezeigten Daten.
```
{
"eventType": "TEXT_PROTECT_BLOCKED",
"eventVersion": "1.0",
"eventTimestamp": 1686975103470,
"isFinal": true,
"originationPhoneNumber": "+12065550152",
"destinationPhoneNumber": "+14255550156",
"isoCountryCode": "US",
"mcc": "310",
"mnc": "800",
"messageId": "862a8790-60c0-4430-9b2b-658bdexample",
"messageRequestTimestamp": 1686975103170,
"messageEncoding": "GSM",
"messageType": "PROMOTIONAL",
"messageStatus": "PROTECT_BLOCKED",
"messageStatusDescription": "Message blocked by protect configuration",
"context": {
"account": "bar"
},
"totalMessageParts": 1,
"totalMessagePrice": 0,
"totalCarrierFee": 0,
"protectConfiguration": {
"protectConfigurationId": "protect-d777777777777771bbd5d59f4d903479",
"protectStatus": "FILTER"
},
"protectConfigurationAssessment": {
"protectRecommendation": "BLOCK"
"protectInsights": {
"blockReason": "AIT_SUSPECTED"
}
}
}
```
****
| Attribut | Description |
| --- | --- |
| eventType | Der Ereignistyp. Die Werte sind aufgeführt in [Ereignistypen für SMS, MMS und Sprache](configuration-sets-event-types.md) |
| eventVersion | Die Version des Ereignis-JSON-Schemas. |
| eventTimestamp | Der Zeitpunkt, zu dem das Ereignis gemeldet wurde, angezeigt als Unix-Zeit in Millisekunden. |
| isFinal | Truewenn dies der endgültige Status der Nachricht ist. Es gibt Zwischenstatus für Nachrichten, und es kann bis zu 72 Stunden dauern, bis der endgültige Nachrichtenstatus eingeht. |
| originationPhoneNumber | Die Telefonnummer, von der die Nachricht gesendet wurde. |
| destinationPhoneNumber | Die Telefonnummer, an die Sie versucht haben, die Nachricht zu senden. |
| isoCountryCode | Das Land , die der Telefonnummer des Empfängers zugeordnet ist, im ISO 3166-1 Alpha-2-Format. |
| mcc | Mobile Country Codes identifizieren das Land, zu dem eine Telefonnummer gehört. Dieses Feld ist optional und möglicherweise nicht vorhanden. |
| mnc | Mobile Network Codes identifiziert einen Mobilfunknetzbetreiber. Dieses Feld ist optional und möglicherweise nicht vorhanden. |
| messageId | Die eindeutige ID, die AWS End User Messaging SMS generiert, wenn die Nachricht akzeptiert wird. |
| messageRequestTimestamp | Die Uhrzeit, zu der die SMS-Nachrichtenanforderung empfangen wurde, wird als Unix-Zeit in Millisekunden angezeigt. |
| messageEncoding | Die Kodierung der Nachricht. Mögliche Werte sind GSM und Unicode. Weitere Hinweise zur Nachrichtenkodierung finden Sie unter[SMS-Zeichenbeschränkungen](sms-limitations-character.md). |
| messageType | Der Nachrichtentyp. Mögliche Werte sind Promotional und Transactional. |
| messageStatus | Der Status der Nachricht. Die möglichen Werte sind: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/sms-voice/latest/userguide/configuration-sets-event-format.html) |
| messageStatusDescription | Eine Beschreibung des Nachrichtenstatus. |
| context | Benutzerdefinierte Attribute, die Sie angeben können und die protokolliert werden, wenn Sie eine Nachricht senden. |
| totalMessageParts | Die Anzahl der Nachrichtenteile, die AWS End User Messaging SMS erstellt hat, um die Nachricht zu senden. Im Allgemeinen können SMS-Nachrichten nur 160 GSM-7-Zeichen oder 67 Nicht-GSM-Zeichen enthalten, obwohl diese Limits je nach Land variieren können. Wenn Sie eine Nachricht senden, die diese Grenzwerte überschreitet, teilt AWS End User Messaging SMS die Nachricht automatisch in kleinere Teile auf. Wir erstellen Rechnungen basierend auf der Anzahl der Mitteilungsteile, die Sie senden. Weitere Informationen zu Teilen von Nachrichten finden Sie unter[Was sind die MPS-Grenzwerte (Message Parts per Second)?](sms-limitations-mps.md). |
| totalMessagePrice | Der Betrag, den wir Ihnen für das Senden der Nachricht berechnet haben. Dieser Preis wird in Tausendstel eines US-Cents angegeben. Wenn der Wert dieses Attributs beispielsweise 645 lautet, wird Ihnen für das Senden der Nachricht 0,645 ¢ in Rechnung gestellt (645/1 000 = 0,645 ¢ = 0,00645 \$1). |
| totalCarrierFee | Die Gesamtkosten der Transporteurgebühren für eine Nachricht. |
| protectConfiguration | Die ID der Schutzkonfiguration, die beim Senden der Nachricht verwendet wurde, und der Status, in dem sich das Zielland zu diesem Zeitpunkt befand. Weitere Informationen zu SMS Protect finden Sie unter [SMS Protect](protect.md). |
| protectConfigurationAssessment | Eine Bewertung, ob SMS Protect der Meinung ist, dass Ihre Nachricht erlaubt oder nicht gesendet werden sollte, und die Gründe für die Sperrung, sofern verfügbar. |
## Beispiel für eine Sprachausgabe, ein Ereignisprotokoll
Das JSON-Objekt für ein Voice-Ereignis enthält die im folgenden Beispiel gezeigten Daten.
```
{
"eventType": "VOICE_COMPLETED",
"eventVersion": "1.0",
"eventTimestamp": 1697835373500,
"isFinal": true,
"originationPhoneNumber": "+12065550153",
"destinationPhoneNumber": "+14255550159",
"isoCountryCode": "US",
"messageId": "567f6c11-6e8b-4352-9749-a42a0example",
"messageRequestTimestamp": 1697835372720,
"messageStatus": "COMPLETED",
"callDurationInSeconds": 60,
"totalDurationInMinutes": 1,
"totalMessagePrice": 0.013,
"context": {
"account": "bar"
}
}
```
****
| Attribut | Description |
| --- | --- |
| eventType | Der Ereignistyp. Die Werte sind aufgeführt in [Ereignistypen für SMS, MMS und Sprache](configuration-sets-event-types.md) |
| eventVersion | Die Version des Ereignis-JSON-Schemas. |
| eventTimestamp | Der Zeitpunkt, zu dem das Ereignis gemeldet wurde, angezeigt als Unix-Zeit in Millisekunden. |
| isFinal | Truewenn dies der endgültige Status der Nachricht ist. Es gibt zwischengeschaltete Nachrichtenstatus. |
| originationPhoneNumber | Die Telefonnummer, von der die Nachricht gesendet wurde. |
| destinationPhoneNumber | Die Telefonnummer, an die Sie versucht haben, die Nachricht zu senden. |
| isoCountryCode | Das Land , die der Telefonnummer des Empfängers zugeordnet ist, im ISO 3166-1 Alpha-2-Format. |
| messageId | Die eindeutige ID, die AWS End User Messaging SMS generiert, wenn die Nachricht akzeptiert wird. |
| messageRequestTimestamp | Die Uhrzeit, zu der die SMS-Nachrichtenanforderung empfangen wurde, wird als Unix-Zeit in Millisekunden angezeigt. |
| messageStatus | Der Status der Nachricht. Die möglichen Werte sind: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/sms-voice/latest/userguide/configuration-sets-event-format.html) |
| callDurationInSeconds | Die Dauer des Anrufs in Sekunden. |
| totalDurationInMinutes | Die Dauer des Anrufs in Minuten. |
| totalMessagePrice | Der Betrag, den wir Ihnen für das Senden der Sprachnachricht berechnet haben. Dieser Preis wird in Tausendstel eines US-Cents angegeben. |
| context | Benutzerdefinierte Attribute, die Sie angeben können und die protokolliert werden, wenn Sie eine Nachricht senden. |
## MMS-Beispielprotokoll
Das JSON-Objekt für ein MMS-Ereignis enthält die im folgenden Beispiel gezeigten Daten.
```
{
"contentType":"MMS",
"eventType": "MEDIA_DELIVERED",
"eventVersion": "1.0",
"eventTimestamp": 1635197695208,
"isFinal": true,
"originationPhoneNumber": "+12065550153",
"destinationPhoneNumber": "+14255550159",
"isoCountryCode": "US",
"messageId": "b4a3196d-5b61-4884-a0d9-745acf1f6235example",
"messageRequestTimestamp": 1635197693241,
"messageType": "TRANSACTIONAL",
"messageStatus": "DELIVERED",
"messageStatusDescription": "Message has been accepted by phone",
"context": {"foo":"bar"},
"totalMessageParts": 1,
"totalMessagePrice": 0.0195,
"totalCarrierFee": 0.00266
}
```
****
| Attribut | Description |
| --- | --- |
| eventType | Der Ereignistyp. Die Werte sind aufgeführt in [Ereignistypen für SMS, MMS und Sprache](configuration-sets-event-types.md) |
| eventVersion | Die Version des Ereignis-JSON-Schemas. |
| eventTimestamp | Der Zeitpunkt, zu dem das Ereignis gemeldet wurde, angezeigt als Unix-Zeit in Millisekunden. |
| isFinal | Truewenn dies der endgültige Status der Nachricht ist. Es gibt Zwischenstatus für Nachrichten, und es kann bis zu 72 Stunden dauern, bis der endgültige Nachrichtenstatus eingeht. |
| originationPhoneNumber | Die Telefonnummer, von der die Nachricht gesendet wurde. |
| destinationPhoneNumber | Die Telefonnummer, an die Sie versucht haben, die Nachricht zu senden. |
| isoCountryCode | Das Land , die der Telefonnummer des Empfängers zugeordnet ist, im ISO 3166-1 Alpha-2-Format. |
| messageId | Die eindeutige ID, die AWS End User Messaging SMS generiert, wenn die Nachricht akzeptiert wird. |
| messageRequestTimestamp | Die Uhrzeit, zu der die SMS-Nachrichtenanforderung empfangen wurde, wird als Unix-Zeit in Millisekunden angezeigt. |
| messageType | Der Nachrichtentyp. Mögliche Werte sind Promotional und Transactional. |
| messageStatus | Der Status der Nachricht. Die möglichen Werte sind: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/sms-voice/latest/userguide/configuration-sets-event-format.html) |
| messageStatusDescription | Eine Beschreibung des Nachrichtenstatus. |
| context | Benutzerdefinierte Attribute, die Sie angeben können und die protokolliert werden, wenn Sie eine Nachricht senden. |
| totalMessageParts | Die Anzahl der Nachrichtenteile, die AWS End User Messaging SMS erstellt hat, um die Nachricht zu senden. Weitere Informationen zu Nachrichtenteilen finden Sie unter[Was sind die MPS-Grenzwerte (Message Parts per Second)?](sms-limitations-mps.md). |
| totalMessagePrice | Der Betrag, den wir Ihnen für das Senden der Nachricht berechnet haben. Dieser Preis wird in Tausendstel eines US-Cents angegeben. Wenn der Wert dieses Attributs beispielsweise 645 lautet, wird Ihnen für das Senden der Nachricht 0,645 ¢ in Rechnung gestellt (645/1 000 = 0,645 ¢ = 0,00645 \$1). |
| totalCarrierFee | Die Gesamtkosten der Transporteurgebühren für eine Nachricht. |
# Richten Sie ein CloudWatch Amazon-Eventziel in AWS End User Messaging SMS ein
Amazon CloudWatch Logs ist ein AWS Service, mit dem Sie Protokolldateien überwachen, speichern und darauf zugreifen können. Wenn Sie ein CloudWatch Ereignisziel erstellen, sendet AWS End User Messaging SMS die Ereignistypen, die Sie im Ereignisziel angegeben haben, an eine CloudWatch Gruppe. Weitere Informationen CloudWatch finden Sie im [Amazon CloudWatch Logs-Benutzerhandbuch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/).
**Voraussetzungen**
1. Bevor Sie ein CloudWatch Veranstaltungsziel erstellen können, müssen Sie zunächst eine CloudWatch Gruppe erstellen. Weitere Informationen zum Erstellen von Protokollgruppen finden Sie unter [Arbeiten mit Protokollgruppen und Protokollströmen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html) im *Amazon CloudWatch Logs-Benutzerhandbuch*.
**Wichtig**
Sie benötigen den Amazon-Ressourcennamen (ARN) der CloudWatch Gruppe, um das Eventziel zu erstellen.
1. Sie müssen eine [IAM-Rolle](configuration-sets-cloud-watch-creating-role.md#configuration-sets-cloud-watch-creating-role.title) erstellen, die es AWS End User Messaging SMS ermöglicht, in die Protokollgruppe zu schreiben.
**Wichtig**
Sie benötigen den Amazon-Ressourcennamen (ARN) der IAM-Rolle, um das Eventziel zu erstellen.
1. Sie haben auch einen Konfigurationssatz eingerichtet, mit dem Sie die Veranstaltungsziele verknüpfen können, siehe[Erstellen Sie einen Konfigurationssatz in AWS End User Messaging SMS](configuration-set-create.md).
# IAM-Richtlinie für Amazon CloudWatch
Verwenden Sie das folgende Beispiel, um eine Richtlinie für das Senden von Ereignissen an eine CloudWatch Gruppe zu erstellen.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"logs:CreateLogStream",
"logs:DescribeLogStreams",
"logs:PutLogEvents"
],
"Resource": [
"arn:aws:logs:us-east-1:111122223333:log-group:log-group-name:*"
]
}
]
}
```
------
Weitere Informationen zu IAM-Richtlinien finden Sie unter [Berechtigungen und Richtlinien in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) im *IAM-Benutzerhandbuch*.
In der folgenden Beispielanweisung werden die optionalen, aber empfohlenen `SourceArn` Bedingungen verwendet, `SourceAccount` um zu überprüfen, ob nur das SMS-Besitzerkonto für AWS Endbenutzernachrichten Zugriff auf den Konfigurationssatz hat. In diesem Beispiel *accountId* ersetzen Sie es durch Ihre AWS Konto-ID, *region* durch den AWS-Region Namen und *ConfigSetName* durch den Namen des Konfigurationssatzes.
Nachdem Sie die Richtlinie erstellt haben, erstellen Sie eine neue IAM-Rolle und hängen Sie die Richtlinie an diese an. Wenn Sie die Rolle erstellen, fügen Sie ihr auch die folgende Vertrauensrichtlinie hinzu:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": {
"Effect": "Allow",
"Principal": {
"Service": "sms-voice.amazonaws.com"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "111122223333"
},
"ArnLike": {
"aws:SourceArn": "arn:aws:sms-voice:us-east-1:111122223333:configuration-set/ConfigSetName"
}
}
}
}
```
------
Weitere Informationen zum Erstellen von IAM-Rollen finden Sie unter [Erstellen von IAM-Rollen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html) im *IAM-Benutzerhandbuch*.
# Erstellen Sie ein CloudWatch Amazon-Eventziel in AWS End User Messaging SMS
Nachdem Sie die IAM-Rolle und die CloudWatch Gruppe erstellt haben, können Sie das Ereignisziel erstellen.
------
#### [ Create event destination (Console) ]
Gehen Sie wie folgt vor, um mit der SMS-Konsole für AWS Endbenutzernachrichten ein Ereignisziel zu erstellen:
1. Öffnen Sie die SMS-Konsole für AWS Endbenutzernachrichten unter [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).
1. Wählen Sie im Navigationsbereich unter **Konfigurationen** die Option **Konfigurationssätze** aus.
1. Wählen Sie auf der Seite „**Konfigurationssätze**“ den Konfigurationssatz aus, dem Sie ein Ereignisziel hinzufügen möchten.
1. Wählen Sie auf der **Detailseite des Konfigurationssatzes** die Option **Zielereignis hinzufügen** aus.
1. Geben Sie im Abschnitt **Veranstaltungsdetails** einen benutzerfreundlichen Namen für den Namen des **Veranstaltungsziels** ein.
1. Wählen Sie im Drop-down-Menü **Zieltyp** die Option Amazon CloudWatch aus.
1. Geben Sie für die **IAM-Rolle arn** den ARN der IAM-Rolle ein. Weitere Informationen zur IAM-Rolle arn finden Sie unter. [IAM-Richtlinie für Amazon CloudWatch](configuration-sets-cloud-watch-creating-role.md)
1. Geben Sie für **Protokollgruppe arn** den ARN der CloudWatch Amazon-Protokollgruppe ein, an die die Ereignisse gesendet werden sollen.
1. Schalten Sie die **Veröffentlichung von Ereignissen** ein.
1. Wählen Sie unter **Ereignistypen** Folgendes aus:
+ **Alle SMS-Ereignisse (empfohlen)** — Wählen Sie diese Option, um alle in aufgeführten SMS-Ereignisse an Amazon [Event types (Ereignistypen)](configuration-sets-event-types.md) zu senden CloudWatch.
+ **Benutzerdefinierte SMS-Ereignisse** — Wählen Sie bestimmte SMS-Ereignisse aus, an die gesendet werden soll CloudWatch. Um die Liste der Ereignisse zu **bearbeiten, wählen Sie SMS-Ereignisauswahl** bearbeiten. Markieren **Sie unter SMS-Ereignisauswahl bearbeiten** nur die Ereignisse, die Sie an Amazon senden möchten CloudWatch. Wählen Sie **Auswahl speichern**.
+ **Alle Sprachereignisse (empfohlen)** — Wählen Sie diese Option, um alle in aufgeführten Sprachereignisse [Event types (Ereignistypen)](configuration-sets-event-types.md) an Amazon zu senden CloudWatch.
+ **Benutzerdefinierte Sprachereignisse** — Wählen Sie bestimmte Sprachereignisse aus, an die gesendet werden soll CloudWatch. Um die Liste der Ereignisse zu bearbeiten, wählen Sie **Auswahl für Sprachereignisse bearbeiten**. Markieren **Sie unter Auswahl von Sprachereignissen bearbeiten** nur die Ereignisse, die Sie an Amazon senden möchten CloudWatch. Wählen Sie **Auswahl speichern**.
+ **Alle MMS-Ereignisse (empfohlen)** — Wählen Sie diese Option, um alle MMS-Ereignisse, die in aufgeführt sind, an Amazon [Event types (Ereignistypen)](configuration-sets-event-types.md) zu senden. CloudWatch
+ **Benutzerdefinierte MMS-Ereignisse — Wählen Sie bestimmte MMS-Ereignisse** aus, an die gesendet werden soll. CloudWatch Um die Liste der Ereignisse zu bearbeiten, wählen Sie **MMS-Ereignisauswahl bearbeiten**. Markieren **Sie unter MMS-Eventauswahl bearbeiten** nur die Ereignisse, die Sie an Amazon CloudWatch senden möchten. Wählen Sie **Auswahl speichern**.
1. Wählen Sie **Ereignis erstellen** aus.
------
#### [ Create event destination (AWS CLI) ]
Sie können den [create-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/create-event-destination.html)Befehl verwenden, um ein Eventziel zu erstellen.
Führen Sie in der Befehlszeile den folgenden Befehl aus.
```
$ aws pinpoint-sms-voice-v2 create-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSet \
> --matching-event-types eventTypes \
> --cloud-watch-logs-destination IamRoleArn=arn:aws:iam::111122223333:role/CWLSMSRole,LogGroupArn=arn:aws:logs:us-east-1:111122223333:log-group:MyCWLLogGroup
```
Nehmen Sie im vorherigen Befehl die folgenden Änderungen vor:
+ *eventDestinationName*Ersetzen Sie es durch einen Namen, der das Ziel des Ereignisses beschreibt.
+ *configurationSet*Ersetzen Sie es durch den Namen des Konfigurationssatzes, dem Sie das Ereignisziel zuordnen möchten.
+ *eventTypes*Ersetzen Sie es durch einen oder mehrere der unter aufgeführten Ereignistypen[Ereignistypen für SMS, MMS und Sprache](configuration-sets-event-types.md).
+ Ersetzen Sie den Wert von `IamRoleArn` durch den Amazon-Ressourcenname (ARN) einer IAM-Rolle, für die unter [IAM-Richtlinie für Amazon CloudWatch](configuration-sets-cloud-watch-creating-role.md) beschriebenen Richtlinien gelten.
+ Ersetzen Sie den Wert von `LogGroupArn` durch den ARN der CloudWatch Gruppe, an die Sie Ereignisse senden möchten.
------
# Bearbeiten Sie ein CloudWatch Amazon-Eventziel in AWS End User Messaging SMS
Verwenden Sie die SMS-Konsole für AWS Endbenutzernachrichten oder AWS CLI bearbeiten Sie ein CloudWatch Ereignisziel.
------
#### [ Update event destination (Console) ]
Gehen Sie wie folgt vor, um ein Ereignisziel mithilfe der SMS-Konsole für AWS Endbenutzernachrichten zu aktualisieren:
1. Öffnen Sie die SMS-Konsole für AWS Endbenutzernachrichten unter [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).
1. Wählen Sie im Navigationsbereich unter **Konfigurationen** die Option **Konfigurationssätze** aus.
1. Wählen Sie auf der Seite **Konfigurationssätze** den zu bearbeitenden Konfigurationssatz aus.
1. Wählen Sie auf der Registerkarte **Veranstaltungseinstellungen** ein CloudWatch Amazon-Eventziel und dann **Bearbeiten** aus.
1. Geben Sie für die **IAM-Rolle arn** den ARN der IAM-Rolle ein. Weitere Informationen zur IAM-Rolle arn finden Sie unter. [IAM-Richtlinie für Amazon CloudWatch](configuration-sets-cloud-watch-creating-role.md)
1. Geben Sie für **Protokollgruppe arn** den ARN der CloudWatch Amazon-Protokollgruppe ein, an die die Ereignisse gesendet werden sollen.
1. Wählen Sie unter **Ereignistypen** Folgendes aus:
+ **Alle SMS-Ereignisse (empfohlen)** — Wählen Sie diese Option, um alle in aufgeführten SMS-Ereignisse an Amazon [Event types (Ereignistypen)](configuration-sets-event-types.md) zu senden CloudWatch.
+ **Benutzerdefinierte SMS-Ereignisse** — Wählen Sie diese Option und wählen Sie bestimmte SMS-Ereignisse aus, an die gesendet CloudWatch werden soll. Um die Liste der Ereignisse zu **bearbeiten, wählen Sie SMS-Ereignisauswahl** bearbeiten. Markieren **Sie unter SMS-Ereignisauswahl bearbeiten** nur die Ereignisse, die Sie an Amazon senden möchten CloudWatch. Wählen Sie **Auswahl speichern**.
+ **Alle Sprachereignisse (empfohlen)** — Wählen Sie diese Option, um alle in aufgeführten Sprachereignisse [Event types (Ereignistypen)](configuration-sets-event-types.md) an Amazon zu senden CloudWatch.
+ **Benutzerdefinierte Sprachereignisse** — Wählen Sie diese Option und wählen Sie bestimmte Sprachereignisse aus, an die gesendet CloudWatch werden sollen. Um die Liste der Ereignisse zu bearbeiten, wählen Sie **Auswahl für Sprachereignisse bearbeiten**. Markieren **Sie unter Auswahl von Sprachereignissen bearbeiten** nur die Ereignisse, die Sie an Amazon senden möchten CloudWatch. Wählen Sie **Auswahl speichern**.
+ **Alle MMS-Ereignisse (empfohlen)** — Wählen Sie diese Option, um alle in aufgeführten MMS-Ereignisse an Amazon [Event types (Ereignistypen)](configuration-sets-event-types.md) zu senden. CloudWatch
+ **Benutzerdefinierte MMS-Ereignisse** — Wählen Sie diese Option und wählen Sie bestimmte MMS-Ereignisse aus, an die gesendet werden soll. CloudWatch Um die Liste der Ereignisse zu bearbeiten, wählen Sie **MMS-Ereignisauswahl bearbeiten**. Markieren **Sie unter MMS-Eventauswahl bearbeiten** nur die Ereignisse, die Sie an Amazon CloudWatch senden möchten. Wählen Sie **Auswahl speichern**.
1. Wählen Sie **Event bearbeiten**.
------
#### [ Update event destination AWS CLI) ]
Sie können den [update-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/update-event-destination.html)Befehl verwenden, um ein Ereignisziel zu aktualisieren.
Das Verfahren zum Aktualisieren eines CloudWatch Ereignisziels ähnelt dem Verfahren zum Erstellen eines Ereignisziels. Führen Sie in der Befehlszeile den folgenden Befehl aus.
```
$ aws pinpoint-sms-voice-v2 update-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSet \
> --matching-event types eventTypes \
> --cloud-watch-logs-destination IamRoleArn=arn:aws:iam::111122223333:role/CWLSMSRole,LogGroupArn=arn:aws:logs:us-east-1:111122223333:log-group:MyCWLLogGroup
```
Nehmen Sie im vorherigen Befehl die folgenden Änderungen vor:
+ *eventDestinationName*Ersetzen Sie es durch den Namen des Ereignisziels, das Sie ändern möchten.
+ *configurationSet*Ersetzen Sie ihn durch den Namen des Konfigurationssatzes, dem Sie das Ereignisziel zuordnen möchten. Sie können das Ereignisziel einem anderen Konfigurationssatz zuordnen.
+ *eventTypes*Ersetzen Sie es durch einen der unter aufgeführten Ereignistypen[Ereignistypen für SMS, MMS und Sprache](configuration-sets-event-types.md).
+ Ersetzen Sie den Wert von `IamRoleArn` durch den Amazon-Ressourcenname (ARN) einer IAM-Rolle, für die unter [Ereignistypen für SMS, MMS und Sprache](configuration-sets-event-types.md) beschriebenen Richtlinien gelten.
+ Ersetzen Sie den Wert von `LogGroupArn` durch den ARN der CloudWatch Gruppe, an die Sie Ereignisse senden möchten.
------
# Löschen Sie ein CloudWatch Amazon-Eventziel in AWS End User Messaging SMS
Verwenden Sie die SMS-Konsole für AWS Endbenutzernachrichten oder AWS CLI um ein CloudWatch Ereignisziel zu löschen.
------
#### [ Delete an CloudWatch event destination (Console) ]
Der Vorgang zum Löschen eines Ereignisziels ist unabhängig von der Art des Ereignisziels, das Sie löschen möchten, derselbe.
**Um ein CloudWatch Ereignisziel in der Konsole zu löschen**
1. Öffnen Sie die SMS-Konsole für AWS Endbenutzernachrichten unter [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).
1. Wählen Sie im Navigationsbereich unter **Konfigurationen** die Option **Konfigurationssätze** aus.
1. Wählen Sie auf der Seite **Konfigurationssätze** den Konfigurationssatz aus, aus dem ein Ereignisziel entfernt werden soll.
1. Wählen Sie im Abschnitt **Alle Ziele** ein Veranstaltungsziel aus und klicken Sie dann auf **Löschen**.
------
#### [ Delete an CloudWatch event destination (AWS CLI) ]
Sie können den [delete-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/delete-event-destination.html)Befehl verwenden, um ein Veranstaltungsziel zu löschen.
Der Vorgang zum Löschen eines Ereignisziels ist unabhängig von der Art des Ereignisziels, das Sie löschen möchten, derselbe.
**Um ein CloudWatch Ereignisziel in der AWS CLI**
+ Führen Sie in der Befehlszeile den folgenden Befehl aus.
```
$ aws pinpoint-sms-voice-v2 delete-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSetName
```
Nehmen Sie im vorherigen Befehl die folgenden Änderungen vor:
+ *eventDestinationName*Ersetzen Sie es durch den Namen oder den Amazon-Ressourcennamen (ARN) des Ereignisziels, das Sie löschen möchten.
+ *configurationSetName*Ersetzen Sie durch den Namen oder ARN des Konfigurationssatzes, dem das Ereignisziel zugeordnet ist.
------
# Richten Sie ein Amazon Data Firehose-Ereignisziel in AWS End User Messaging SMS ein
Amazon Data Firehose ist ein vollständig verwalteter Service für die Bereitstellung von Echtzeit-Streaming-Daten an verschiedene Arten von Zielen. Amazon Data Firehose ist Teil der Kinesis-Streaming-Datenplattform. Weitere Informationen zu Amazon Data Firehose finden Sie im [Amazon Data Firehose Developer Guide](https://docs.aws.amazon.com/firehose/latest/dev/).
Bei einigen Beispielen in diesem Abschnitt wird davon ausgegangen, dass Sie den bereits installiert und konfiguriert haben. AWS Command Line Interface Weitere Informationen zur Einrichtung von finden Sie im [AWS Command Line Interface Benutzerhandbuch](https://docs.aws.amazon.com/cli/latest/userguide/). AWS CLI
**Voraussetzungen**
1. Bevor Sie ein Amazon Data Firehose-Ereignisziel erstellen können, müssen Sie zunächst einen Amazon Data Firehose-Lieferstream erstellen. Weitere Informationen zum Erstellen von Streams finden Sie unter [Creating an Amazon Data Firehose Delivery Stream](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html) im *Amazon Data Firehose Developer Guide*.
**Wichtig**
Sie benötigen den Amazon-Ressourcennamen (ARN) des Amazon Data Firehose-Lieferstreams, um das Eventziel zu erstellen.
1. Sie müssen eine IAM-Rolle erstellen, die es AWS End User Messaging SMS ermöglicht, in den Zustellungsstream zu schreiben, siehe. [IAM-Richtlinie für Amazon Data Firehose](configuration-sets-kinesis-creating-role.md)
**Wichtig**
Sie benötigen den Amazon-Ressourcennamen (ARN) der IAM-Rolle, um das Eventziel zu erstellen.
1. Sie haben auch einen Konfigurationssatz eingerichtet, mit dem Sie die Veranstaltungsziele verknüpfen können, siehe[Erstellen Sie einen Konfigurationssatz in AWS End User Messaging SMS](configuration-set-create.md).
**Topics**
+ [IAM-Richtlinie für Amazon Data Firehose](configuration-sets-kinesis-creating-role.md)
+ [Erstellen Sie ein Amazon Data Firehose-Ereignisziel](configuration-set-kinesis-add.md)
+ [Ein Amazon Data Firehose-Ereignisziel bearbeiten](configuration-set-kinesis-edit.md)
+ [Löschen Sie ein Amazon Data Firehose-Ereignisziel](configuration-set-kinesis-delete.md)
# IAM-Richtlinie für Amazon Data Firehose
Verwenden Sie das folgende Beispiel, um eine Richtlinie für das Senden von Ereignissen an einen Amazon Data Firehose-Stream zu erstellen.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "firehose:PutRecord",
"Resource": "arn:aws:firehose:us-east-1:111122223333:deliverystream/DeliveryStreamName"
}
]
}
```
------
Weitere Informationen zu IAM-Richtlinien finden Sie unter [Berechtigungen und Richtlinien in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) im *IAM-Benutzerhandbuch*.
In der folgenden Beispielanweisung werden die optionalen, aber empfohlenen `SourceArn` Bedingungen verwendet, `SourceAccount` um zu überprüfen, ob nur das SMS-Besitzerkonto von AWS End User Messaging Zugriff auf den Konfigurationssatz hat. In diesem Beispiel *accountId* ersetzen Sie es durch Ihre AWS Konto-ID, *region* durch den AWS-Region Namen und *ConfigSetName* durch den Namen des Konfigurationssatzes.
Nachdem Sie die Richtlinie erstellt haben, erstellen Sie eine neue IAM-Rolle und hängen Sie die Richtlinie an diese an. Wenn Sie die Rolle erstellen, fügen Sie ihr auch die folgende Vertrauensrichtlinie hinzu:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": {
"Effect": "Allow",
"Principal": {
"Service": "sms-voice.amazonaws.com"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "111122223333"
},
"ArnLike": {
"aws:SourceArn": "arn:aws:sms-voice:us-east-1:111122223333:configuration-set/ConfigSetName"
}
}
}
}
```
------
Weitere Informationen zum Erstellen von IAM-Rollen finden Sie unter [Erstellen von IAM-Rollen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html) im *IAM-Benutzerhandbuch*.
# Erstellen Sie ein Amazon Data Firehose-Ereignisziel in AWS End User Messaging SMS
Bevor Sie ein Amazon Data Firehose-Ereignisziel erstellen können, müssen Sie zunächst einen Amazon Data Firehose-Stream erstellen. Weitere Informationen zum Erstellen von Protokollgruppen finden Sie unter [Creating an Amazon Data Firehose Delivery Stream](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html) im *Amazon Data Firehose* Developer Guide.
Sie müssen eine IAM-Rolle erstellen, die es der AWS End User Messaging SMS and Voice v2-API ermöglicht, Daten an den Stream zu senden. Der folgende Abschnitt enthält Informationen zu den Anforderungen für diese Rolle.
Sie haben auch bereits einen Konfigurationssatz eingerichtet, mit dem Sie die Veranstaltungsziele verknüpfen können, siehe [Konfigurationssätze in AWS End User Messaging SMS](configuration-sets.md).
------
#### [ Create Amazon Data Firehose event destination (Console) ]
Gehen Sie wie folgt vor, um mithilfe der AWS End User Messaging SMS-Konsole ein Amazon Data Firehose-Ereignisziel zu erstellen:
1. Öffnen Sie die SMS-Konsole für AWS Endbenutzer-Messaging unter [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).
1. Wählen Sie im Navigationsbereich unter **Konfigurationen** die Option **Konfigurationssätze** aus.
1. Wählen Sie auf der Seite „**Konfigurationssätze**“ den Konfigurationssatz aus, dem Sie ein Ereignisziel hinzufügen möchten.
1. Wählen Sie auf der **Detailseite des Konfigurationssatzes** die Option **Zielereignis hinzufügen** aus.
1. Geben Sie im Abschnitt **Veranstaltungsdetails** einen benutzerfreundlichen Namen für den Namen des **Veranstaltungsziels** ein.
1. Wählen Sie in der Dropdownliste **Zieltyp** die Option Amazon Data Firehose aus.
1. Geben Sie für die **IAM-Rolle arn** den ARN der IAM-Rolle ein. Weitere Informationen zur IAM-Rolle arn finden Sie unter. [IAM-Richtlinie für Amazon Data Firehose](configuration-sets-kinesis-creating-role.md)
1. Geben Sie für **Delivery stream arn** den ARN der Amazon Data Firehose-Protokollgruppe ein, an die die Ereignisse gesendet werden sollen.
1. Schalten Sie die **Veröffentlichung von Ereignissen ein**.
1. Wählen Sie unter **Ereignistypen** Folgendes aus:
+ **Alle SMS-Ereignisse (empfohlen)** — Wählen Sie diese Option, um alle in Amazon Data Firehose aufgelisteten SMS-Ereignisse [Event types (Ereignistypen)](configuration-sets-event-types.md) zu senden.
+ **Benutzerdefinierte SMS-Ereignisse** — Wählen Sie bestimmte SMS-Ereignisse aus, die an Amazon Data Firehose gesendet werden sollen. Um die Liste der Ereignisse zu bearbeiten, wählen Sie **SMS-Ereignisauswahl bearbeiten**. Markieren **Sie unter SMS-Ereignisauswahl bearbeiten** nur die Ereignisse, die Sie an Amazon Data Firehose senden möchten. Wählen Sie **Auswahl speichern**.
+ **Alle Sprachereignisse (empfohlen)** — Wählen Sie diese Option, um alle in Amazon Data Firehose aufgeführten Sprachereignisse [Event types (Ereignistypen)](configuration-sets-event-types.md) zu senden.
+ **Benutzerdefinierte Sprachereignisse** — Wählen Sie bestimmte Sprachereignisse aus, die an Amazon Data Firehose gesendet werden sollen. Um die Liste der Ereignisse zu bearbeiten, wählen Sie **Auswahl für Sprachereignisse bearbeiten**. Markieren **Sie unter Auswahl von Sprachereignissen bearbeiten** nur die Ereignisse, die Sie an Amazon Data Firehose senden möchten. Wählen Sie **Auswahl speichern**.
+ **Alle MMS-Ereignisse (empfohlen)** — Wählen Sie diese Option, um alle in Amazon Data Firehose aufgelisteten MMS-Ereignisse [Event types (Ereignistypen)](configuration-sets-event-types.md) zu senden.
+ **Benutzerdefinierte MMS-Ereignisse** — Wählen Sie bestimmte MMS-Ereignisse aus, die an Amazon Data Firehouse gesendet werden sollen. Um die Liste der Ereignisse zu bearbeiten, wählen Sie **MMS-Ereignisauswahl bearbeiten**. Markieren **Sie unter MMS-Ereignisauswahl bearbeiten** nur die Ereignisse, die Sie an Amazon Data Firehose senden möchten. Wählen Sie Auswahl **speichern**.
1. Wählen Sie **Ereignis erstellen** aus.
------
#### [ Create Amazon Data Firehose event destination (AWS CLI) ]
Nachdem Sie die IAM-Rolle und den Amazon Data Firehose-Lieferstream erstellt haben, können Sie das Ereignisziel erstellen.
Sie können den [create-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/create-event-destination.html)Befehl verwenden, um ein Eventziel zu erstellen.
```
$ aws pinpoint-sms-voice-v2 create-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSet \
> --matching-event-types eventTypes \
> --kinesis-firehose-destination IamRoleArn=arn:aws:iam::111122223333:role/AKFSMSRole,DeliveryStreamArn=arn:aws:firehose:us-east-1:111122223333:deliverystream/MyDeliveryStream
```
Nehmen Sie im vorherigen Befehl die folgenden Änderungen vor:
+ *eventDestinationName*Ersetzen Sie es durch einen Namen, der das Ziel des Ereignisses beschreibt.
+ *configurationSet*Ersetzen Sie es durch den Namen des Konfigurationssatzes, dem Sie das Ereignisziel zuordnen möchten.
+ *eventTypes*Ersetzen Sie es durch einen oder mehrere der unter aufgeführten Ereignistypen[Ereignistypen für SMS, MMS und Sprache](configuration-sets-event-types.md).
+ Ersetzen Sie den Wert von `IamRoleArn` durch den Amazon-Ressourcenname (ARN) einer IAM-Rolle, für die unter [IAM-Richtlinie für Amazon Data Firehose](configuration-sets-kinesis-creating-role.md) beschriebenen Richtlinien gelten.
+ Ersetzen Sie den Wert von `DeliveryStreamArn` durch den ARN des Amazon Data Firehose-Streams, an den Sie Ereignisse senden möchten.
------
# Bearbeiten Sie ein Amazon Data Firehose-Ereignisziel in AWS End User Messaging SMS
Verwenden Sie die SMS-Konsole für AWS Endbenutzernachrichten oder bearbeiten AWS CLI Sie ein Amazon Data Firehose-Ereignisziel.
------
#### [ Update Amazon Data Firehose event destination (Console) ]
Gehen Sie wie folgt vor, um ein Amazon Data Firehose-Ereignisziel mithilfe der AWS End User Messaging SMS-Konsole zu aktualisieren:
1. Öffnen Sie die SMS-Konsole für AWS Endbenutzernachrichten unter [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).
1. Wählen Sie im Navigationsbereich unter **Konfigurationen** die Option **Konfigurationssätze** aus.
1. Wählen Sie auf der Seite „**Konfigurationssätze**“ den Konfigurationssatz aus, dem Sie ein Ereignisziel hinzufügen möchten.
1. Wählen Sie auf der Seite **Konfigurationssätze** den zu bearbeitenden Konfigurationssatz aus.
1. Wählen Sie auf der **Detailseite des Konfigurationssatzes** ein Amazon Data Firehose-Ereignisziel aus und klicken **Sie dann auf Bearbeiten**.
1. Geben Sie für die **IAM-Rolle arn** den ARN der IAM-Rolle ein. Weitere Informationen zur IAM-Rolle arn finden Sie unter. [IAM-Richtlinie für Amazon Data Firehose](configuration-sets-kinesis-creating-role.md)
1. Geben Sie für **Delivery stream arn** den ARN der Amazon Data Firehose-Protokollgruppe ein, an die die Ereignisse gesendet werden sollen.
1. Wählen Sie unter **Ereignistypen** Folgendes aus:
+ **Alle SMS-Ereignisse (empfohlen)** — Wählen Sie diese Option, um alle in Amazon Data Firehose aufgeführten SMS-Ereignisse [Event types (Ereignistypen)](configuration-sets-event-types.md) zu senden.
+ **Benutzerdefinierte SMS-Ereignisse** — Wählen Sie diese Option und wählen Sie bestimmte SMS-Ereignisse aus, an die gesendet werden soll CloudWatch. Um die Liste der Ereignisse zu **bearbeiten, wählen Sie SMS-Ereignisauswahl** bearbeiten. Markieren **Sie unter SMS-Ereignisauswahl bearbeiten** nur die Ereignisse, die Sie an Amazon Data Firehose senden möchten. Wählen Sie **Auswahl speichern**.
+ **Alle Sprachereignisse (empfohlen)** — Wählen Sie diese Option, um alle in Amazon Data Firehose aufgeführten Sprachereignisse [Event types (Ereignistypen)](configuration-sets-event-types.md) zu senden.
+ **Benutzerdefinierte Sprachereignisse** — Wählen Sie diese Option und wählen Sie bestimmte Sprachereignisse aus, die an Amazon Data Firehose gesendet werden sollen. Um die Liste der Ereignisse zu bearbeiten, wählen Sie **Auswahl für Sprachereignisse bearbeiten**. Markieren **Sie unter Auswahl von Sprachereignissen bearbeiten** nur die Ereignisse, die Sie an Amazon Data Firehose senden möchten. Wählen Sie **Auswahl speichern**.
+ **Alle MMS-Ereignisse (empfohlen)** — Wählen Sie diese Option, um alle in Amazon Data Firehose aufgelisteten MMS-Ereignisse [Event types (Ereignistypen)](configuration-sets-event-types.md) zu senden.
+ **Benutzerdefinierte MMS-Ereignisse** — Wählen Sie diese Option und wählen Sie bestimmte MMS-Ereignisse aus, an die gesendet werden soll. CloudWatch Um die Liste der Ereignisse zu bearbeiten, wählen Sie **MMS-Ereignisauswahl bearbeiten**. Markieren **Sie unter MMS-Ereignisauswahl bearbeiten** nur die Ereignisse, die Sie an Amazon Data Firehose senden möchten. Wählen Sie Auswahl **speichern**.
1. Wählen Sie **Event bearbeiten**.
------
#### [ Update Amazon Data Firehose event destination (AWS CLI) ]
Sie können den [update-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/update-event-destination.html)Befehl verwenden, um ein Ereignisziel zu aktualisieren.
Das Verfahren zum Aktualisieren eines Amazon Data Firehose-Ereignisziels ähnelt dem Verfahren zum Erstellen eines Ereignisziels.
```
$ aws pinpoint-sms-voice-v2 create-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSet \
> --matching-event-types eventTypes \
> --kinesis-firehose-destination IamRoleArn=arn:aws:iam::111122223333:role/AKFSMSRole,DeliveryStreamArn=arn:aws:firehose:us-east-1:111122223333:deliverystream/MyDeliveryStream
```
Nehmen Sie im vorherigen Befehl die folgenden Änderungen vor:
+ *eventDestinationName*Ersetzen Sie es durch den Namen des Veranstaltungsziels, das Sie ändern möchten.
+ *configurationSet*Ersetzen Sie ihn durch den Namen des Konfigurationssatzes, dem Sie das Ereignisziel zuordnen möchten. Sie können das Ereignisziel einem anderen Konfigurationssatz zuordnen.
+ *eventTypes*Ersetzen Sie es durch einen der unter aufgeführten Ereignistypen[Ereignistypen für SMS, MMS und Sprache](configuration-sets-event-types.md).
+ Ersetzen Sie den Wert von `IamRoleArn` durch den Amazon-Ressourcenname (ARN) einer IAM-Rolle, für die unter [IAM-Richtlinie für Amazon Data Firehose](configuration-sets-kinesis-creating-role.md) beschriebenen Richtlinien gelten.
+ Ersetzen Sie den Wert von `DeliveryStreamArn` durch den ARN des Amazon Data Firehose-Streams, an den Sie Ereignisse senden möchten.
------
# Löschen Sie ein Amazon Data Firehose-Ereignisziel in AWS End User Messaging SMS
Verwenden Sie die SMS-Konsole für AWS Endbenutzernachrichten oder AWS CLI um ein Amazon Data Firehose-Ereignisziel zu löschen.
------
#### [ Delete an Amazon Data Firehose event destination (Console) ]
Der Vorgang zum Löschen eines Ereignisziels ist unabhängig von der Art des Ereignisziels, das Sie löschen möchten, derselbe.
**Um ein Amazon Data Firehose-Ereignisziel in der Konsole zu löschen**
1. Öffnen Sie die SMS-Konsole für AWS Endbenutzer-Messaging unter [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).
1. Wählen Sie im Navigationsbereich unter **Konfigurationen** die Option **Konfigurationssätze** aus.
1. Wählen Sie auf der Seite **Konfigurationssätze** den Konfigurationssatz aus, aus dem ein Ereignisziel entfernt werden soll.
1. Wählen Sie im Abschnitt **Alle Ziele** ein Veranstaltungsziel aus und klicken Sie dann auf **Löschen**.
------
#### [ Delete an Amazon Data Firehose event destination (AWS CLI) ]
Sie können den [delete-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/delete-event-destination.html)Befehl verwenden, um ein Veranstaltungsziel zu löschen.
Der Vorgang zum Löschen eines Ereignisziels ist unabhängig von der Art des Ereignisziels, das Sie löschen möchten, derselbe.
**So löschen Sie ein Amazon Data Firehose-Ereignisziel in der AWS CLI**
+ Führen Sie in der Befehlszeile den folgenden Befehl aus.
```
$ aws pinpoint-sms-voice-v2 delete-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSetName
```
Nehmen Sie im vorherigen Befehl die folgenden Änderungen vor:
+ *eventDestinationName*Ersetzen Sie es durch den Namen oder den Amazon-Ressourcennamen (ARN) des Ereignisziels, das Sie löschen möchten.
+ *configurationSetName*Ersetzen Sie durch den Namen oder ARN des Konfigurationssatzes, dem das Ereignisziel zugeordnet ist.
------
# Richten Sie ein Amazon SNS SNS-Ereignisziel in AWS End User Messaging SMS ein
Amazon Pinpoint User Guide. ist ein Webservice, mit dem Anwendungen, Endanwender und Geräte sofort Benachrichtigungen senden und empfangen können. Weitere Informationen zu Amazon SNS finden Sie im [Entwicklerhandbuch für Amazon Simple Notification Service](https://docs.aws.amazon.com/sns/latest/dg/).
Bei einigen Beispielen in diesem Abschnitt wird davon ausgegangen, dass Sie den AWS Command Line Interface bereits installiert und konfiguriert haben. Weitere Informationen zur Einrichtung von finden Sie im [AWS Command Line Interface Benutzerhandbuch](https://docs.aws.amazon.com/cli/latest/userguide/). AWS CLI
**Topics**
+ [Amazon SNS SNS-Zugriffsrichtlinie](configuration-sets-sns-creating-role.md)
+ [Erstellen Sie ein Amazon SNS SNS-Ereignisziel](configuration-sets-sns-add.md)
+ [Ein Amazon SNS SNS-Ereignisziel bearbeiten](configuration-sets-sns-edit.md)
+ [Löschen Sie ein Amazon SNS SNS-Ereignisziel](configuration-sets-sns-delete.md)
# Amazon SNS SNS-Zugriffsrichtlinie
Der Zugriff auf ein Amazon SNS SNS-Thema wird durch eine dem Amazon SNS SNS-Thema beigefügte *Ressourcenrichtlinie* gesteuert. Diese wird auch als *Zugriffsrichtlinie* bezeichnet. Weitere Informationen zu den Amazon *SNS-Zugriffsrichtlinien* finden Sie unter [Identitäts- und Zugriffsmanagement](https://docs.aws.amazon.com/sns/latest/dg/security-iam.html) im *Amazon SNS* Developer Guide.
**Anmerkung**
Wenn für Ihr Amazon SNS SNS-Thema die serverseitige Verschlüsselung aktiviert ist, fügen Sie die Richtlinie auch dem zugehörigen vom [Kunden verwalteten Schlüssel für symmetrische Verschlüsselung](#configuration-sets-sns-creating-role-encrypted) hinzu. AWS Key Management Service
Aktualisieren Sie die *Zugriffsrichtlinie* mit der folgenden Erklärung, damit AWS Endbenutzer-Nachrichten-SMS im Amazon SNS SNS-Thema veröffentlicht werden können.
+ *111122223333*Ersetzen Sie es durch die eindeutige ID für Ihr AWS Konto.
+ *TopicName*Ersetzen Sie es durch den Namen des Amazon SNS SNS-Themas.
+ *Region*Ersetzen Sie es durch das AWS-Region , das das Amazon SNS SNS-Thema und den Konfigurationssatz enthält.
+ *ConfigSetName*Ersetzen Sie es durch den Namen des Konfigurationssatzes.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "sms-voice.amazonaws.com"
},
"Action": "sns:Publish",
"Resource": "arn:aws:sns:us-east-1:111122223333:TopicName",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "accountId"
},
"ArnLike": {
"aws:SourceArn": "arn:aws:sms-voice:us-east-1:111122223333:configuration-set/ConfigSetName"
}
}
}
]
}
```
------
## Zugriffsrichtlinie für verschlüsselte Amazon SNS SNS-Themen
Wenn für Ihr Amazon SNS SNS-Thema serverseitige Verschlüsselung aktiviert ist AWS Key Management Service, fügen Sie dem zugehörigen, vom Kunden verwalteten Schlüssel für symmetrische Verschlüsselung die folgende Richtlinie hinzu. Sie müssen die Richtlinie zu einem vom Kunden verwalteten Schlüssel hinzufügen, da Sie den AWS verwalteten Schlüssel für Amazon SNS nicht ändern können.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Id": "example-ID",
"Statement": [
{
"Sid": "example-statement-ID",
"Effect": "Allow",
"Principal": {
"Service": "sms-voice.amazonaws.com"
},
"Action": [
"kms:GenerateDataKey",
"kms:Decrypt"
],
"Resource": "*"
}
]
}
```
------
# Erstellen Sie ein Amazon SNS SNS-Ereignisziel in AWS End User Messaging SMS
Bevor Sie ein Amazon-SNS-Ereignisziel erstellen können, müssen Sie zunächst ein Amazon-SNS-Thema erstellen. Weitere Informationen zum Erstellen von Amazon SNS SNS-Themen finden Sie unter [Erstellen eines Themas](https://docs.aws.amazon.com/sns/latest/dg/sns-create-topic.html) im *Amazon Simple Notification Service Developer Guide*.
Sie müssen außerdem bereits einen Konfigurationssatz eingerichtet haben, mit dem Sie die Veranstaltungsziele verknüpfen können, siehe[Konfigurationssätze in AWS End User Messaging SMS](configuration-sets.md).
------
#### [ Create an Amazon SNS event destination (Console) ]
Gehen Sie wie folgt vor, um mit der AWS End User Messaging SMS-Konsole ein Amazon SNS SNS-Ereignisziel zu erstellen:
1. Öffnen Sie die SMS-Konsole für AWS Endbenutzernachrichten unter [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).
1. Wählen Sie im Navigationsbereich unter **Konfigurationen** die Option **Konfigurationssätze** aus.
1. Wählen Sie auf der Seite „**Konfigurationssätze**“ den Konfigurationssatz aus, dem Sie ein Ereignisziel hinzufügen möchten.
1. Wählen Sie auf der **Detailseite des Konfigurationssatzes** die Option **Zielereignis hinzufügen** aus.
1. Geben Sie im Abschnitt „**Ereignisdetails**“ einen Namen ein.
1. Wählen Sie in der Dropdownliste **Zieltyp** die Option Amazon SNS aus.
1. **Neues Amazon SNS SNS-Thema** — Wählen Sie diese Option für AWS End User Messaging SMS, um ein Thema in Ihrem Konto zu erstellen. Das Thema wird automatisch mit allen erforderlichen Berechtigungen erstellt. Weitere Informationen zu Amazon SNS-Themen finden Sie unter [Konfiguration von Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html) im [Amazon Simple Notification Service Developer Guide](https://docs.aws.amazon.com/sns/latest/dg/).
1. **Bestehendes Amazon SNS SNS-Thema** — Wählen Sie diese Option, wenn Sie in der Dropdownliste Thema ein vorhandenes Amazon SNS **SNS-Thema haben.**
1. Wählen Sie unter **Ereignistypen Folgendes** aus:
+ **Alle SMS-Ereignisse (empfohlen)** — Wählen Sie diese Option, um alle in Amazon SNS aufgeführten SMS-Ereignisse [Event types (Ereignistypen)](configuration-sets-event-types.md) zu senden.
+ **Benutzerdefinierte SMS-Ereignisse** — Wählen Sie bestimmte SMS-Ereignisse aus, die an Amazon SNS gesendet werden sollen. Um die Liste der Ereignisse zu bearbeiten, wählen Sie **SMS-Ereignisauswahl bearbeiten**. Markieren **Sie unter SMS-Ereignisauswahl bearbeiten** nur die Ereignisse, die Sie an Amazon SNS senden möchten. Wählen Sie **Auswahl speichern**.
+ **Alle Sprachereignisse (empfohlen)** — Wählen Sie diese Option, um alle in Amazon SNS aufgeführten Sprachereignisse [Event types (Ereignistypen)](configuration-sets-event-types.md) zu senden.
+ **Benutzerdefinierte Sprachereignisse** — Wählen Sie bestimmte Sprachereignisse aus, die an Amazon SNS gesendet werden sollen. Um die Liste der Ereignisse zu bearbeiten, wählen Sie **Auswahl für Sprachereignisse bearbeiten**. Markieren **Sie unter Auswahl von Sprachereignissen bearbeiten** nur die Ereignisse, die Sie an Amazon SNS senden möchten. Wählen Sie **Auswahl speichern**.
+ **Alle MMS-Ereignisse (empfohlen)** — Wählen Sie diese Option, um alle in Amazon SNS aufgeführten MMS-Ereignisse [Event types (Ereignistypen)](configuration-sets-event-types.md) zu senden.
+ **Benutzerdefinierte MMS-Ereignisse** — Wählen Sie bestimmte MMS-Ereignisse aus, die an Amazon SNS gesendet werden sollen. Um die Liste der Ereignisse zu bearbeiten, wählen Sie **MMS-Ereignisauswahl bearbeiten**. Markieren **Sie unter MMS-Ereignisauswahl bearbeiten** nur die Ereignisse, die Sie an Amazon SNS senden möchten. Wählen Sie Auswahl **speichern**.
1. Wählen Sie **Ereignis erstellen** aus.
------
#### [ Create an Amazon SNS event destination (AWS CLI) ]
Sie können den [create-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/create-event-destination.html)Befehl verwenden, um ein Eventziel zu erstellen.
```
$ aws pinpoint-sms-voice-v2 create-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSet \
> --matching-event-types eventTypes \
> --sns-destination TopicArn=arn:aws:sns:us-east-1:111122223333:snsTopic
```
Nehmen Sie im vorherigen Befehl die folgenden Änderungen vor:
+ *eventDestinationName*Ersetzen Sie es durch einen beschreibenden Namen für das Ereignisziel.
+ *configurationSet*Ersetzen Sie ihn durch den Namen des Konfigurationssatzes, dem Sie das Ereignisziel zuordnen möchten.
+ *eventTypes*Ersetzen Sie es durch einen der unter aufgeführten Ereignistypen[Ereignistypen für SMS, MMS und Sprache](configuration-sets-event-types.md).
+ Ersetzen Sie den Wert von `TopicArn` mit dem Amazon-Ressourcennamen (ARN) des Amazon-SNS-Themas, an das Sie Ereignisse senden möchten.
------
# Bearbeiten Sie ein Amazon SNS SNS-Ereignisziel in AWS End User Messaging SMS
Verwenden Sie die SMS-Konsole für AWS Endbenutzernachrichten oder bearbeiten AWS CLI Sie ein Amazon SNS SNS-Ereignisziel.
------
#### [ Update an Amazon SNS event destination (Console) ]
Gehen Sie wie folgt vor, um das Ziel eines AWS SMS-Ereignisses für AWS Endbenutzernachrichten mithilfe der SMS-Konsole für Endbenutzernachrichten zu aktualisieren:
1. Öffnen Sie die SMS-Konsole für AWS Endbenutzernachrichten unter [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).
1. Wählen Sie im Navigationsbereich unter **Konfigurationen** die Option **Konfigurationssätze** aus.
1. Wählen Sie auf der Seite „**Konfigurationssätze**“ den Konfigurationssatz aus, dem Sie ein Ereignisziel hinzufügen möchten.
1. Wählen Sie auf der Seite „**Konfigurationssätze**“ den Konfigurationssatz aus, den Sie bearbeiten möchten.
1. Wählen Sie auf der **Detailseite des Konfigurationssatzes** ein Amazon SNS SNS-Ereignisziel aus und klicken **Sie dann auf Bearbeiten**.
1. Wählen Sie in der Dropdownliste **Zieltyp** die Option Amazon SNS aus.
1. **Neues Amazon SNS SNS-Thema** — Wählen Sie diese Option. AWS End User Messaging SMS erstellt ein Thema in Ihrem Konto. Das Thema wird automatisch mit allen erforderlichen Berechtigungen erstellt. Weitere Informationen zu Amazon SNS-Themen finden Sie unter [Konfiguration von Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html) im [Amazon Simple Notification Service Developer Guide](https://docs.aws.amazon.com/sns/latest/dg/).
1. **Bestehendes Amazon SNS SNS-Thema** — Wählen Sie diese Option, wenn Sie in der Dropdownliste Thema ein vorhandenes Amazon SNS **SNS-Thema haben.**
1. Wählen Sie unter **Ereignistypen Folgendes** aus:
+ **Alle SMS-Ereignisse (empfohlen)** — Wählen Sie diese Option, um alle in Amazon SNS aufgeführten SMS-Ereignisse [Event types (Ereignistypen)](configuration-sets-event-types.md) zu senden.
+ **Benutzerdefinierte SMS-Ereignisse** — Wählen Sie diese Option und wählen Sie bestimmte SMS-Ereignisse aus, die an Amazon SNS gesendet werden sollen. Um die Liste der Ereignisse zu bearbeiten, wählen Sie **SMS-Ereignisauswahl bearbeiten**. Markieren **Sie unter SMS-Ereignisauswahl bearbeiten** nur die Ereignisse, die Sie an Amazon SNS senden möchten. Wählen Sie **Auswahl speichern**.
+ **Alle Sprachereignisse (empfohlen)** — Wählen Sie diese Option, um alle in Amazon SNS aufgeführten Sprachereignisse [Event types (Ereignistypen)](configuration-sets-event-types.md) zu senden.
+ **Benutzerdefinierte Sprachereignisse** — Wählen Sie diese Option und wählen Sie bestimmte Sprachereignisse aus, die an Amazon SNS gesendet werden sollen. Um die Liste der Ereignisse zu bearbeiten, wählen Sie **Auswahl für Sprachereignisse bearbeiten**. Markieren **Sie unter Auswahl von Sprachereignissen bearbeiten** nur die Ereignisse, die Sie an Amazon SNS senden möchten. Wählen Sie **Auswahl speichern**.
+ **Alle MMS-Ereignisse (empfohlen)** — Wählen Sie diese Option, um alle in Amazon SNS aufgeführten MMS-Ereignisse [Event types (Ereignistypen)](configuration-sets-event-types.md) zu senden.
+ **Benutzerdefinierte MMS-Ereignisse** — Wählen Sie diese Option und wählen Sie bestimmte MMS-Ereignisse aus, die an Amazon SNS gesendet werden sollen. Um die Liste der Ereignisse zu bearbeiten, wählen Sie **MMS-Ereignisauswahl bearbeiten**. Markieren **Sie unter MMS-Ereignisauswahl bearbeiten** nur die Ereignisse, die Sie an Amazon SNS senden möchten. Wählen Sie Auswahl **speichern**.
1. Wählen Sie **Event bearbeiten**.
------
#### [ Update an Amazon SNS event destination (AWS CLI) ]
Sie können den [update-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/update-event-destination.html)Befehl verwenden, um ein Ereignisziel zu aktualisieren.
Das Verfahren zum Aktualisieren eines Amazon-SNS-Ereignisziels ähnelt dem Verfahren zum Erstellen eines Ereignisziels.
**Um ein Amazon SNS SNS-Ereignisziel zu aktualisieren in der AWS CLI**
+ Führen Sie in der Befehlszeile den folgenden Befehl aus.
```
$ aws pinpoint-sms-voice-v2 update-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSet \
> --matching-event types eventTypes \
> --sns-destination TopicArn=arn:aws:sns:us-east-1:111122223333:snsTopic
```
Nehmen Sie im vorherigen Befehl die folgenden Änderungen vor:
+ *eventDestinationName*Ersetzen Sie es durch den Namen des Ereignisziels, das Sie ändern möchten.
+ *configurationSet*Ersetzen Sie ihn durch den Namen des Konfigurationssatzes, dem Sie das Ereignisziel zuordnen möchten. Sie können das Ereignisziel einem anderen Konfigurationssatz zuordnen.
+ *eventTypes*Ersetzen Sie es durch einen oder mehrere der unter aufgeführten Ereignistypen[Ereignistypen für SMS, MMS und Sprache](configuration-sets-event-types.md).
+ Ersetzen Sie den Wert von `TopicArn` mit dem Amazon-Ressourcennamen (ARN) des Amazon-SNS-Themas, an das Sie Ereignisse senden möchten.
------
# Löschen Sie ein Amazon SNS SNS-Ereignisziel in AWS End User Messaging SMS
Verwenden Sie die SMS-Konsole für AWS Endbenutzernachrichten oder AWS CLI um ein Amazon SNS SNS-Thema zu löschen.
------
#### [ Delete an Amazon SNS event destination (Console) ]
Der Vorgang zum Löschen eines Ereignisziels ist unabhängig von der Art des Ereignisziels, das Sie löschen möchten, derselbe.
**Um ein Amazon SNS SNS-Ereignisziel in der Konsole zu löschen**
1. Öffnen Sie die SMS-Konsole für AWS Endbenutzernachrichten unter [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).
1. Wählen Sie im Navigationsbereich unter **Konfigurationen** die Option **Konfigurationssätze** aus.
1. Wählen Sie auf der Seite **Konfigurationssätze** den Konfigurationssatz aus, aus dem ein Ereignisziel entfernt werden soll.
1. Wählen Sie im Abschnitt **Alle Ziele** ein Veranstaltungsziel aus und klicken Sie dann auf **Löschen**.
------
#### [ Delete an Amazon SNS event destination (AWS CLI) ]
Sie können den [delete-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/delete-event-destination.html)Befehl verwenden, um ein Veranstaltungsziel zu löschen.
Der Vorgang zum Löschen eines Ereignisziels ist unabhängig von der Art des Ereignisziels, das Sie löschen möchten, derselbe.
**Um ein Amazon SNS SNS-Ereignisziel zu löschen in der AWS CLI**
+ Führen Sie in der Befehlszeile den folgenden Befehl aus.
```
$ aws pinpoint-sms-voice-v2 delete-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSetName
```
Nehmen Sie im vorherigen Befehl die folgenden Änderungen vor:
+ *eventDestinationName*Ersetzen Sie es durch den Namen oder den Amazon-Ressourcennamen (ARN) des Ereignisziels, das Sie löschen möchten.
+ *configurationSetName*Ersetzen Sie durch den Namen oder ARN des Konfigurationssatzes, dem das Ereignisziel zugeordnet ist.
------