

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.

# Richten Sie ein Amazon Data Firehose-Ereignisziel in AWS End User Messaging SMS ein
<a name="configuration-sets-kinesis"></a>

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
<a name="configuration-sets-kinesis-creating-role"></a>

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
<a name="configuration-set-kinesis-add"></a>

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
<a name="configuration-set-kinesis-edit"></a>

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
<a name="configuration-set-kinesis-delete"></a>

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.

------