

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Configurazione di una destinazione per eventi Amazon Data Firehose in AWS End User Messaging SMS
<a name="configuration-sets-kinesis"></a>

Amazon Data Firehose è un servizio completamente gestito per la distribuzione di dati di streaming in tempo reale a più tipi di destinazioni. Amazon Data Firehose fa parte della piattaforma di streaming di dati Kinesis. Per ulteriori informazioni su Amazon Data Firehose, consulta la [Amazon Data Firehose Developer Guide](https://docs.aws.amazon.com/firehose/latest/dev/).

Alcuni degli esempi di questa sezione presuppongono che tu abbia già installato e configurato il. AWS Command Line Interface Per ulteriori informazioni sulla configurazione di AWS CLI, consulta la [Guida AWS Command Line Interface per l'utente](https://docs.aws.amazon.com/cli/latest/userguide/).

**Prerequisiti**

1. Prima di poter creare una destinazione per eventi Amazon Data Firehose, devi creare un flusso di distribuzione Amazon Data Firehose. Per ulteriori informazioni sulla creazione di stream, consulta [Creating an Amazon Data Firehose Delivery Stream nella Amazon Data Firehose](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html) *Developer Guide*.
**Importante**  
Per creare la destinazione dell'evento è necessario l'Amazon Resource Name (ARN) del flusso di distribuzione di Amazon Data Firehose.

1. Devi creare un ruolo IAM che consenta agli SMS di messaggistica con l'utente AWS finale di scrivere nel flusso di distribuzione, vedi. [Politica IAM per Amazon Data Firehose](configuration-sets-kinesis-creating-role.md) 
**Importante**  
Avrai bisogno dell'Amazon Resource Name (ARN) del ruolo IAM per creare la destinazione dell'evento.

1. Hai anche impostato un set di configurazione a cui associare le destinazioni degli eventi, vedi[Creare un set di configurazione in AWS End User Messaging SMS](configuration-set-create.md).

**Topics**
+ [

# Politica IAM per Amazon Data Firehose
](configuration-sets-kinesis-creating-role.md)
+ [Creare una destinazione per eventi Amazon Data Firehose](configuration-set-kinesis-add.md)
+ [Modificare la destinazione di un evento Amazon Data Firehose](configuration-set-kinesis-edit.md)
+ [Eliminare una destinazione per eventi Amazon Data Firehose](configuration-set-kinesis-delete.md)

# Politica IAM per Amazon Data Firehose
<a name="configuration-sets-kinesis-creating-role"></a>

Utilizza l'esempio seguente per creare una policy per l'invio di eventi a uno stream Amazon Data Firehose.

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

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "firehose:PutRecord",
            "Resource": "arn:aws:firehose:us-east-1:111122223333:deliverystream/DeliveryStreamName"
        }
    ]
}
```

------

Per ulteriori informazioni sulle policy IAM, consulta la sezione relativa a [Policy e autorizzazioni in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) nella *Guida per l'utente di IAM*.

L'istruzione di esempio seguente utilizza le `SourceArn` condizioni, facoltative ma `SourceAccount` consigliate, per verificare che solo l'account proprietario di AWS End User Messaging SMS abbia accesso al set di configurazione. In questo esempio, *accountId* sostituiscilo con l'ID dell' AWS account, *region* con il Regione AWS nome e *ConfigSetName* con il nome del set di configurazione.

Dopo aver creato la policy IAM, crea un ruolo IAM a cui collegarla. Quando crei il ruolo, aggiungi anche la seguente policy di attendibilità:

------
#### [ 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"
            }
        }
    }
}
```

------

Per ulteriori informazioni sulla creazione di ruoli IAM, consulta [Creazione di ruoli IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html) nella *Guida per l'utente di IAM*.

# Crea una destinazione per eventi Amazon Data Firehose in AWS End User Messaging (SMS)
<a name="configuration-set-kinesis-add"></a>

Prima di poter creare una destinazione per eventi Amazon Data Firehose, devi creare uno stream Amazon Data Firehose. Per ulteriori informazioni sulla creazione di gruppi di log, consulta [Creating an Amazon Data Firehose Delivery Stream nella Amazon *Data* Firehose](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html) Developer Guide.

È necessario creare un ruolo IAM che consenta all'API AWS End User Messaging SMS and Voice v2 di inviare dati allo stream. La sezione seguente contiene informazioni sui requisiti per questo ruolo.

Inoltre, hai già impostato un set di configurazione a cui associare le destinazioni di evento. Consulta [Set di configurazione in AWS End User Messaging SMS](configuration-sets.md).

------
#### [ Create Amazon Data Firehose event destination (Console) ]

Per creare una destinazione per eventi Amazon Data Firehose utilizzando la console AWS End User Messaging SMS, segui questi passaggi:

1. Apri la console SMS di AWS End User Messaging all'indirizzo [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).

1. Nel riquadro di navigazione, in **Configurazioni**, scegli **Set di configurazione**.

1. Nella pagina **Set di configurazione**, scegliete il set di configurazione a cui aggiungere una destinazione per l'evento. 

1. Nella pagina dei **dettagli del set di configurazione**, scegli **Aggiungi evento di destinazione**.

1. Nella sezione **Dettagli dell'evento**, inserisci un nome descrittivo per il nome della **destinazione dell'evento**.

1. Dal menu a discesa **Tipo di destinazione** scegli Amazon Data Firehose.

1. Per il **ruolo IAM arn**, inserisci l'ARN del ruolo IAM. Per ulteriori informazioni sul ruolo IAM arn, consulta. [Politica IAM per Amazon Data Firehose](configuration-sets-kinesis-creating-role.md)

1. Per **Delivery stream arn**, inserisci l'ARN del gruppo di log Amazon Data Firehose a cui inviare gli eventi. 

1. **Attiva la pubblicazione degli eventi.**

1. In **Tipi di eventi**, scegli:
   + **Tutti gli eventi SMS (consigliato)**: scegli questa opzione per inviare tutti gli eventi SMS elencati in [Event types (Tipi di evento)](configuration-sets-event-types.md) Amazon Data Firehose.
   + **Eventi SMS personalizzati**: scegli eventi SMS specifici da inviare ad Amazon Data Firehose. Per modificare l'elenco degli eventi, scegli **Modifica selezione eventi SMS**. Nella **selezione Modifica evento SMS**, seleziona solo gli eventi che desideri inviare ad Amazon Data Firehose. Scegli **Salva selezione**.
   + **Tutti gli eventi vocali (consigliato)**: scegli questa opzione per inviare tutti gli eventi vocali elencati in [Event types (Tipi di evento)](configuration-sets-event-types.md) Amazon Data Firehose.
   + **Eventi vocali personalizzati**: scegli eventi vocali specifici da inviare ad Amazon Data Firehose. Per modificare l'elenco degli eventi, scegli **Modifica la selezione degli eventi vocali**. In **Modifica la selezione degli eventi vocali**, seleziona solo gli eventi che desideri inviare ad Amazon Data Firehose. Scegli **Salva selezione**.
   + **Tutti gli eventi MMS (consigliato)**: scegli questa opzione per inviare tutti gli eventi MMS elencati ad [Event types (Tipi di evento)](configuration-sets-event-types.md) Amazon Data Firehose.
   + Eventi **MMS personalizzati: scegli tra eventi** MMS specifici da inviare ad Amazon Data Firehose. Per modificare l'elenco degli eventi, scegli **Modifica selezione eventi MMS**. In **Modifica selezione eventi MMS**, seleziona solo gli eventi che desideri inviare ad Amazon Data Firehose. Scegli **Salva** selezione.

1. Scegliere **Crea evento**.

------
#### [ Create Amazon Data Firehose event destination (AWS CLI) ]

Dopo aver creato il ruolo IAM e il flusso di distribuzione di Amazon Data Firehose, puoi creare la destinazione dell'evento.

Puoi usare il [create-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/create-event-destination.html)comando per creare una destinazione per un evento.

```
$ 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
```

Nel comando precedente, apporta le modifiche seguenti:
+ Sostituiscilo *eventDestinationName* con un nome che descriva la destinazione dell'evento.
+ Sostituitelo *configurationSet* con il nome del set di configurazione a cui desiderate associare la destinazione dell'evento.
+ Sostituiscilo *eventTypes* con uno o più tipi di eventi elencati in[Tipi di eventi per SMS, MMS e voce](configuration-sets-event-types.md).
+ Sostituisci il valore di `IamRoleArn` con il nome della risorsa Amazon (ARN) di un ruolo IAM con le policy descritte in [Politica IAM per Amazon Data Firehose](configuration-sets-kinesis-creating-role.md).
+ Sostituisci il valore di `DeliveryStreamArn` con l'ARN dello stream Amazon Data Firehose a cui desideri inviare gli eventi. 

------

# Modifica la destinazione di un evento Amazon Data Firehose in AWS End User Messaging (SMS)
<a name="configuration-set-kinesis-edit"></a>

Utilizza la console SMS di AWS End User Messaging o AWS CLI per modificare la destinazione di un evento Amazon Data Firehose.

------
#### [ Update Amazon Data Firehose event destination (Console) ]

Per aggiornare la destinazione di un evento Amazon Data Firehose utilizzando la console AWS End User Messaging SMS, segui questi passaggi:

1. Apri la console SMS di AWS End User Messaging all'indirizzo [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).

1. Nel riquadro di navigazione, in **Configurazioni**, scegli **Set di configurazione**.

1. Nella pagina **Set di configurazione**, scegliete il set di configurazione a cui aggiungere una destinazione per l'evento. 

1. Nella pagina **Set di configurazione**, scegliete il set di configurazione da modificare. 

1. **Nella pagina dei **dettagli del set di configurazione**, scegli una destinazione dell'evento Amazon Data Firehose e poi Modifica.**

1. Per il **ruolo IAM arn**, inserisci l'ARN del ruolo IAM. Per ulteriori informazioni sul ruolo IAM arn, consulta. [Politica IAM per Amazon Data Firehose](configuration-sets-kinesis-creating-role.md)

1. Per **Delivery stream arn**, inserisci l'ARN del gruppo di log Amazon Data Firehose a cui inviare gli eventi. 

1. In **Tipi di eventi**, scegli:
   + **Tutti gli eventi SMS (consigliato)**: scegli questa opzione per inviare tutti gli eventi SMS elencati in [Event types (Tipi di evento)](configuration-sets-event-types.md) Amazon Data Firehose.
   + **Eventi SMS personalizzati**: scegli questa opzione per scegliere eventi SMS specifici a cui inviare CloudWatch. Per modificare l'elenco degli eventi, scegli **Modifica selezione eventi SMS**. Nella **selezione Modifica evento SMS**, seleziona solo gli eventi che desideri inviare ad Amazon Data Firehose. Scegli **Salva selezione**.
   + **Tutti gli eventi vocali (consigliato)**: scegli questa opzione per inviare tutti gli eventi vocali elencati in [Event types (Tipi di evento)](configuration-sets-event-types.md) Amazon Data Firehose.
   + **Eventi vocali personalizzati**: scegli questa opzione per scegliere eventi vocali specifici da inviare ad Amazon Data Firehose. Per modificare l'elenco degli eventi, scegli **Modifica la selezione degli eventi vocali**. In **Modifica la selezione degli eventi vocali**, seleziona solo gli eventi che desideri inviare ad Amazon Data Firehose. Scegli **Salva selezione**.
   + **Tutti gli eventi MMS (consigliato)**: scegli questa opzione per inviare tutti gli eventi MMS elencati in [Event types (Tipi di evento)](configuration-sets-event-types.md) Amazon Data Firehose.
   + Eventi **MMS personalizzati: scegli questa opzione per scegliere eventi** MMS specifici a cui inviare. CloudWatch Per modificare l'elenco degli eventi, scegli **Modifica selezione eventi MMS**. In **Modifica selezione eventi MMS**, seleziona solo gli eventi che desideri inviare ad Amazon Data Firehose. Scegli **Salva** selezione.

1. Scegli **Modifica evento**.

------
#### [ Update Amazon Data Firehose event destination (AWS CLI) ]

È possibile utilizzare il [update-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/update-event-destination.html)comando per aggiornare la destinazione di un evento.

La procedura per aggiornare una destinazione di eventi Amazon Data Firehose è simile alla procedura per la creazione di una destinazione di evento.

```
$ 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
```

Nel comando precedente, apporta le modifiche seguenti:
+ Sostituiscila *eventDestinationName* con il nome della destinazione dell'evento che desideri modificare.
+ Sostituitelo *configurationSet* con il nome del set di configurazione a cui desiderate associare la destinazione dell'evento. È possibile associare la destinazione di evento a un set di configurazione diverso.
+ Sostituiscilo *eventTypes* con uno dei tipi di eventi elencati in[Tipi di eventi per SMS, MMS e voce](configuration-sets-event-types.md).
+ Sostituisci il valore di `IamRoleArn` con il nome della risorsa Amazon (ARN) di un ruolo IAM con le policy descritte in [Politica IAM per Amazon Data Firehose](configuration-sets-kinesis-creating-role.md).
+ Sostituisci il valore di `DeliveryStreamArn` con l'ARN dello stream Amazon Data Firehose a cui desideri inviare gli eventi. 

------

# Eliminare la destinazione di un evento Amazon Data Firehose in AWS End User Messaging (SMS)
<a name="configuration-set-kinesis-delete"></a>

Utilizza la console SMS di AWS End User Messaging o AWS CLI elimina una destinazione di eventi Amazon Data Firehose.

------
#### [ Delete an Amazon Data Firehose event destination (Console) ]

Il processo di eliminazione di una destinazione di evento è lo stesso indipendentemente dal tipo di destinazione che si desidera eliminare.

**Per eliminare la destinazione di un evento Amazon Data Firehose nella console**

1. Apri la console SMS di AWS End User Messaging all'indirizzo [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).

1. Nel riquadro di navigazione, in **Configurazioni**, scegli **Set di configurazione**.

1. Nella pagina **Set di configurazione**, scegliete il set di configurazione da cui rimuovere la destinazione di un evento. 

1. Nella sezione **Tutte le destinazioni**, scegliete una destinazione per l'evento, quindi scegliete **Elimina**.

------
#### [ Delete an Amazon Data Firehose event destination (AWS CLI) ]

È possibile utilizzare il [delete-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/delete-event-destination.html)comando per eliminare la destinazione di un evento.

Il processo di eliminazione di una destinazione di evento è lo stesso indipendentemente dal tipo di destinazione che si desidera eliminare.

**Per eliminare una destinazione di evento Amazon Data Firehose nel AWS CLI**
+ Alla riga di comando esegui il comando riportato di seguito:

  ```
  $ aws pinpoint-sms-voice-v2 delete-event-destination \
  > --event-destination-name eventDestinationName \
  > --configuration-set-name configurationSetName
  ```

  Nel comando precedente, apporta le modifiche seguenti:
  + Sostituisci *eventDestinationName* con il nome o Amazon Resource Name (ARN) della destinazione dell'evento che desideri eliminare.
  + Sostituire *configurationSetName* con il nome o l'ARN del set di configurazione a cui è associata la destinazione dell'evento.

------