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à.
# Impostazione della pubblicazione di eventi Amazon SES
Questa sezione descrive cosa devi fare per configurare Amazon SES per pubblicare gli eventi di invio di e-mail sui seguenti AWS servizi:
+ Amazon CloudWatch
+ Amazon Data Firehose
+ Amazon Pinpoint
+ Amazon Simple Notification Service (Amazon SNS)
I seguenti passaggi necessari per impostare la pubblicazione degli eventi sono trattati negli argomenti riportati di seguito:
1. Per prima cosa devi creare un *set di configurazione* utilizzando la console o l'API Amazon SES.
1. Aggiungi una o più *destinazioni di eventi* (CloudWatch, Firehose, Pinpoint o SNS) al set di configurazione e configura i parametri unici per la destinazione dell'evento.
1. Specifica un set di configurazione che contenga la destinazione dell'evento quando invii un messaggio di posta elettronica.
**Topics**
+ [Fase 1: creazione di un set di configurazione](event-publishing-create-configuration-set.md)
+ [Fase 2: aggiunta di una destinazione degli eventi](event-publishing-add-event-destination.md)
+ [Fase 3: specificazione di un set di configurazione per l'invio di un messaggio di posta elettronica](event-publishing-send-email.md)
# Fase 1: creazione di un set di configurazione
È innanzitutto necessario disporre di un set di configurazione per impostare la pubblicazione degli eventi. Se non disponi ancora di un set di configurazione o desideri crearne uno nuovo, consulta [Creazione di set di configurazione in SES](creating-configuration-sets.md)
Puoi anche creare set di configurazione utilizzando l'[CreateConfigurationSet](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateConfigurationSet.html)operazione nell'API Amazon SES V2 o nell'Amazon SES CLI v2, vedi. [Creazione di un set di configurazione (AWS CLI)](creating-configuration-sets.md#config-sets-create-cli)
# Fase 2: aggiunta di una destinazione degli eventi
Le destinazioni degli eventi sono le posizioni in cui Amazon SES pubblica gli eventi. Ogni destinazione impostata appartiene a un solo set di configurazione. Quando configuri la destinazione di un evento con Amazon SES, scegli la destinazione del AWS servizio e specifichi i parametri associati a tale destinazione.
Quando configuri la destinazione di un evento, puoi scegliere di inviare eventi a uno dei seguenti AWS servizi:
+ Amazon CloudWatch
+ Amazon Data Firehose
+ Amazon EventBridge
+ Amazon Pinpoint
+ Amazon Simple Notification Service (Amazon SNS)
La destinazione che scegli dipende dal livello di dettaglio che desideri per gli eventi e dal modo in cui desideri ricevere le informazioni sugli eventi. Se vuoi semplicemente un totale parziale di ogni tipo di evento (ad esempio, per impostare un allarme quando il totale diventa troppo alto), puoi utilizzare CloudWatch.
Se desideri registrare eventi dettagliati da inviare a un altro servizio come Amazon OpenSearch Service o Amazon Redshift per l'analisi, puoi utilizzare Firehose.
Se vuoi ricevere notifiche quando si verificano determinati eventi, puoi utilizzare Amazon SNS.
**Topics**
+ [Imposta una CloudWatch destinazione per la pubblicazione degli eventi](event-publishing-add-event-destination-cloudwatch.md)
+ [Configurare una destinazione di eventi Data Firehose per la pubblicazione di eventi Amazon SES](event-publishing-add-event-destination-firehose.md)
+ [Configura una EventBridge destinazione Amazon per la pubblicazione di eventi](event-publishing-add-event-destination-eventbridge.md)
+ [Configurazione di una destinazione degli eventi Amazon Pinpoint per la pubblicazione di eventi](event-publishing-add-event-destination-pinpoint.md)
+ [Configurazione di una destinazione degli eventi Amazon SNS per la pubblicazione di eventi](event-publishing-add-event-destination-sns.md)
# Imposta una CloudWatch destinazione per la pubblicazione degli eventi
Con [Amazon CloudWatch Metrics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html), puoi utilizzare le destinazioni degli eventi per pubblicare e-mail di invio di eventi di Amazon SES. CloudWatch Poiché la destinazione di un CloudWatch evento può essere impostata solo in un set di configurazione, devi prima [creare un set di configurazione](event-publishing-create-configuration-set.md) e quindi aggiungere la destinazione dell'evento al set di configurazione.
Quando aggiungete una destinazione di CloudWatch eventi a un set di configurazione, dovete scegliere una o più CloudWatch *dimensioni* che corrispondano ai tag dei messaggi che utilizzate quando inviate le vostre e-mail. Come i tag dei messaggi, una CloudWatch dimensione è una name/value coppia che consente di identificare in modo univoco una metrica.
Ad esempio, puoi disporre di tag di messaggio e di una dimensione denominata `campaign` che utilizzi per identificare la tua campagna e-mail. Quando pubblicate gli eventi di invio e-mail su CloudWatch, la scelta dei tag e delle dimensioni dei messaggi è importante perché queste scelte influiscono sulla CloudWatch fatturazione e determinano come filtrare i dati degli eventi di invio e-mail. CloudWatch
Questa sezione fornisce informazioni per aiutarvi a scegliere le dimensioni e quindi mostra come aggiungere una destinazione per CloudWatch eventi a un set di configurazione.
**Topics**
+ [Aggiungere una destinazione per un CloudWatch evento](#event-publishing-add-event-destination-cloudwatch-add)
+ [Scelta CloudWatch delle dimensioni](#event-publishing-add-event-destination-cloudwatch-dimensions)
## Aggiungere una destinazione per un CloudWatch evento
La procedura in questa sezione mostra come aggiungere i dettagli della destinazione CloudWatch dell'evento a un set di configurazione e presuppone che tu abbia completato i passaggi da 1 a 6 in [Creazione di una destinazione degli eventi](event-destinations-manage.md#event-destination-add) poi.
Puoi anche utilizzare l'[UpdateConfigurationSetEventDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_UpdateConfigurationSetEventDestination.html)operazione nell'API Amazon SES V2 per creare e modificare le destinazioni degli eventi.
**Per aggiungere i dettagli della destinazione CloudWatch dell'evento a un set di configurazione utilizzando la console**
1. Queste sono le istruzioni dettagliate per la selezione CloudWatch del tipo di destinazione dell'evento nel [passaggio 7](event-destinations-manage.md#specify-event-dest-step) e presuppongono che tu abbia completato tutti i passaggi precedenti. [Creazione di una destinazione degli eventi](event-destinations-manage.md#event-destination-add) Dopo aver selezionato il **tipo di CloudWatch destinazione**, inserito un **nome** di destinazione e abilitato la **pubblicazione degli eventi**, viene visualizzato il riquadro delle ** CloudWatch dimensioni di Amazon**, i cui campi vengono risolti nei passaggi seguenti. *(Si applicano costi aggiuntivi, consulta [Prezzo per metrica per.) CloudWatch](#cw-add-pricing)*
1. Per **Value Source**, specifica in che modo Amazon SES otterrà i dati a cui vengono trasferiti CloudWatch. Sono disponibili le seguenti sorgenti valore:
+ **Message Tag** (Tag di messaggio): Amazon SES recupera il nome della dimensione e il valore da un tag di messaggio che specifichi mediante un'intestazione `X-SES-MESSAGE-TAGS` o un parametro per l'API `EmailTags`. Per ulteriori informazioni sull'utilizzo dei tag di messaggio, consulta [Fase 3: specificazione di un set di configurazione per l'invio di un messaggio di posta elettronica](event-publishing-send-email.md).
**Nota**
I tag di messaggio possono includere numeri da 0 a 9, lettere da A a Z (maiuscole e minuscole), trattini (-) e trattini di sottolineatura (\$1).
Puoi inoltre utilizzare la sorgente valore **Message Tag** (Tag messaggio) per creare delle dimensioni in base ai tag automatici di Amazon SES. Per usare un tag automatico, digita il nome completo del tag automatico come **Dimension Name** (Nome dimensione). Ad esempio, per creare una dimensione in base al set di configurazione dei tag automatici, utilizza `ses:configuration-set` per **Dimension Name** (Nome dimensione) e il nome del set di configurazione per **Default Value** (Valore predefinito). Per un elenco completo dei tag automatici, consulta [Come funziona la pubblicazione degli eventi con i set di configurazione e i tag dei messaggi](monitor-using-event-publishing.md#event-publishing-how-works).
+ **Email Header** (Intestazione e-mail): Amazon SES recupera il nome della dimensione e il valore da un'intestazione e-mail.
**Nota**
Non puoi usare nessuna delle seguenti intestazioni e-mail come **Dimension Name** (Nome della dimensione): `Received`, `To`, `From`, `DKIM-Signature`, `CC`, `message-id` o `Return-Path`.
+ **Link Tag** (Tag di collegamento): Amazon SES recupera il nome della dimensione e il valore da un tag che hai specificato in un collegamento. Per ulteriori informazioni sull'aggiunta di tag ai collegamenti, consulta [Posso aggiungere tag ai collegamenti con identificatori univoci?](faqs-metrics.md#sending-metric-faqs-clicks-q5).
1. In **Dimension Name (Nome della dimensione)**, digita il nome della dimensione che desideri passare a CloudWatch.
**Nota**
I nomi delle dimensioni possono contenere solo lettere ASCII (a-z, A-Z), numeri (0-9), caratteri di sottolineatura (\$1) o trattini (-). Spazi, caratteri accentati, caratteri non latini e altri caratteri speciali non sono consentiti.
1. In **Default Value** (Valore predefinito), digita il valore della dimensione.
**Nota**
I valori delle dimensioni possono contenere solo lettere ASCII (a-z, A-Z), numeri (0-9), caratteri di sottolineatura (\$1), trattini (-), segni (@) e punti (.). Spazi, caratteri accentati, caratteri non latini e altri caratteri speciali non sono consentiti.
1. Se desideri aggiungere ulteriori dimensioni, scegli **Add Dimension** (Aggiungi dimensione). Altrimenti, scegli **Next** (Successivo).
1. Nella schermata di revisione, se sei soddisfatto della definizione della destinazione dell'evento, scegli **Add destination** (Aggiungi destinazione).
## Scelta CloudWatch delle dimensioni
Quando scegli nomi e valori da utilizzare come CloudWatch dimensioni, considera i seguenti fattori:
+ **Prezzo per metrica**: puoi visualizzare gratuitamente i parametri di base di Amazon SES. CloudWatch [Tuttavia, quando raccogli i parametri utilizzando la pubblicazione di eventi, devi sostenere costi di monitoraggio CloudWatch dettagliato.](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch-metrics-basic-detailed.html) Ogni combinazione univoca di tipo di evento, nome della dimensione e valore della dimensione crea una metrica diversa in. CloudWatch Quando utilizzi CloudWatch Detailed Monitoring, ti viene addebitato un costo per ogni metrica. Per questo motivo, potresti voler evitare di scegliere le dimensioni che possono sfruttare diversi valori. Ad esempio, a meno che tu non sia molto interessato a monitorare i tuoi eventi di invio di e-mail dal dominio "Da", potresti non voler definire una dimensione per il tag automatico Amazon SES `ses:from-domain` perché può richiedere molti valori differenti. Per ulteriori informazioni, consulta la sezione [Prezzi di CloudWatch](https://aws.amazon.com/cloudwatch/pricing).
+ **Filtraggio metrico**: se una metrica ha più dimensioni, non è possibile accedere alla metrica in CloudWatch base a ciascuna dimensione separatamente. Per questo motivo, rifletti attentamente prima di aggiungere più di una dimensione a una singola destinazione dell'evento. CloudWatch Ad esempio, se desideri parametri per ogni `campaign`, per una combinazione di `campaign` e `genre` hai bisogno di aggiungere due destinazioni di evento: una con solo `campaign` come dimensione e una con `campaign` e `genre` come dimensioni.
+ **Sorgente del valore della dimensione**: in alternativa per specificare i valori della dimensione usando intestazioni specifiche di Amazon SES o il parametro all'API, puoi anche optare per Amazon SES per prendere i valori della dimensione dalle tue intestazioni nel messaggio MIME. Potresti utilizzare questa opzione se stai già utilizzando intestazioni personalizzate e non desideri modificare le tue e-mail o le chiamate dell'API di invio di e-mail per raccogliere i parametri in base ai tuoi valori dell'intestazione. Se utilizzi le tue intestazioni nel messaggio MIME per la pubblicazione di eventi Amazon SES, i nomi e i valori che utilizzi per la pubblicazione di eventi Amazon SES potrebbe includere solo lettere dalla A alla Z, numeri da 0 a 9, trattini bassi (\$1), chiocciole (@), trattini (-) e punti (.). Se specifichi un nome o un valore che contiene altri caratteri, la chiamata di invio e-mail avrà comunque esito positivo, ma le metriche dell'evento non verranno inviate ad Amazon CloudWatch.
Per ulteriori informazioni sui CloudWatch concetti, consulta [Amazon CloudWatch Concepts](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html) nella *Amazon CloudWatch User Guide*.
# Configurare una destinazione di eventi Data Firehose per la pubblicazione di eventi Amazon SES
Una destinazione di eventi Amazon Data Firehose rappresenta un'entità che pubblica eventi specifici di invio e-mail di Amazon SES a Firehose. Poiché una destinazione di eventi Firehose può essere impostata solo in un set di configurazione, è necessario prima [creare un set di configurazione](event-publishing-create-configuration-set.md). Successivamente, aggiungi la destinazione dell'evento al set di configurazione.
La procedura in questa sezione mostra come aggiungere i dettagli della destinazione degli eventi Firehose a un set di configurazione e presuppone che siano stati completati i passaggi da 1 a 6. [Creazione di una destinazione degli eventi](event-destinations-manage.md#event-destination-add)
Puoi anche utilizzare l'[UpdateConfigurationSetEventDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_UpdateConfigurationSetEventDestination.html)operazione nella destinazione Amazon SES API V2 per creare e aggiornare le destinazioni degli eventi.
**Per aggiungere i dettagli della destinazione degli eventi Firehose a un set di configurazione utilizzando la console**
1. Queste sono le istruzioni dettagliate per selezionare Firehose come tipo di destinazione dell'evento nella [Fase 7](event-destinations-manage.md#specify-event-dest-step) e presuppongono che abbiate completato tutti i passaggi precedenti. [Creazione di una destinazione degli eventi](event-destinations-manage.md#event-destination-add) Dopo aver selezionato il **tipo di destinazione** Firehose, inserito un **nome** di destinazione e abilitato la **pubblicazione degli eventi**, viene visualizzato il riquadro del **flusso di distribuzione di Amazon Data Firehose**, i cui campi vengono risolti nei passaggi seguenti.
1. Per **Delivery stream**, scegli un flusso di distribuzione Firehose esistente oppure scegli **Crea nuovo stream** per crearne uno nuovo utilizzando la console Firehose.
Per informazioni sulla creazione di uno stream utilizzando la console Firehose, consulta [Creating an Amazon Kinesis Firehose Delivery Stream nella *Amazon* Data Firehose](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html) Developer Guide.
1. Per il ruolo **Identity and Access Management (IAM)**, scegli un ruolo IAM per il quale Amazon SES è autorizzato a pubblicare su Firehose per tuo conto. Puoi scegliere un ruolo esistente, far sì che Amazon SES crei un ruolo per te oppure creare il tuo ruolo.
Se scegli un ruolo esistente o crei il tuo ruolo, devi modificare manualmente le politiche del ruolo per autorizzarlo ad accedere al flusso di distribuzione di Firehose e autorizzare Amazon SES ad assumere il ruolo. Per esempi di policy, consulta [Autorizzazione alla pubblicazione su Firehose Delivery Stream di Amazon SES](#event-publishing-add-event-destination-firehose-role).
1. Seleziona **Next** (Successivo).
1. Nella schermata di revisione, se sei soddisfatto della definizione della destinazione dell'evento, scegli **Add destination** (Aggiungi destinazione).
Per informazioni su come utilizzare l'`UpdateConfigurationSetEventDestination`API per aggiungere una destinazione di eventi Firehose, consulta [Amazon Simple Email Service API](https://docs.aws.amazon.com/ses/latest/APIReference/API_UpdateConfigurationSetEventDestination.html) Reference.
## Autorizzazione alla pubblicazione su Firehose Delivery Stream di Amazon SES
Per consentire ad Amazon SES di pubblicare record nel tuo flusso di distribuzione Firehose, devi utilizzare un [ruolo AWS Identity and Access Management](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) (IAM) e allegare o modificare la politica di autorizzazione e la politica di fiducia del ruolo. La politica di autorizzazione consente al ruolo di pubblicare record nel flusso di distribuzione di Firehose e la politica di attendibilità consente ad Amazon SES di assumere il ruolo.
In questa sezione vengono forniti esempi di entrambe le policy. Per informazioni sul collegamento di policy ai ruoli IAM, consulta la pagina relativa alla [modifica di un ruolo](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage_modify.html) nella *Guida per l'utente su IAM*.
### Policy di autorizzazione
La seguente politica di autorizzazioni consente al ruolo di pubblicare record di dati nel flusso di distribuzione di Firehose.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "",
"Effect": "Allow",
"Action": [
"firehose:PutRecordBatch"
],
"Resource": [
"arn:aws:firehose:us-east-1:111122223333:deliverystream/delivery-stream-name"
]
}
]
}
```
------
Nel precedente esempio di policy, apporta le modifiche seguenti:
+ Sostituisci *delivery-region* con la AWS regione in cui hai creato il flusso di distribuzione Firehose.
+ Sostituisci *111122223333* con il tuo ID account AWS .
+ Sostituire *delivery-stream-name* con il nome del flusso di distribuzione di Firehose.
### Policy di attendibilità
La policy di attendibilità seguente consente ad Amazon SES di assumere il ruolo.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "",
"Effect": "Allow",
"Principal": {
"Service": "ses.amazonaws.com"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"AWS:SourceAccount": "111122223333",
"AWS:SourceArn": "arn:aws:ses:delivery-region:111122223333:configuration-set/configuration-set-name"
}
}
}
]
}
```
------
Nel precedente esempio di policy, apporta le modifiche seguenti:
+ Sostituisci *delivery-region* con la AWS regione in cui hai creato il flusso di distribuzione Firehose.
+ Sostituisci *111122223333* con il tuo ID account AWS .
+ Sostituire *configuration-set-name* con il nome del set di configurazione associato al flusso di distribuzione di Firehose.
# Configura una EventBridge destinazione Amazon per la pubblicazione di eventi
Una destinazione di EventBridge eventi Amazon ti notifica gli eventi di invio di e-mail specificati in un set di configurazione. SES genera e invia eventi di invio di e-mail definiti durante la creazione di una destinazione di eventi sul bus di eventi EventBridge predefinito. Un [bus di eventi](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-bus.html) è un router che riceve eventi e può inviarli a più destinazioni. Puoi trovare ulteriori informazioni sull'integrazione degli eventi di invio di e-mail con Amazon EventBridge in[Monitoraggio degli eventi SES tramite Amazon EventBridge](monitoring-eventbridge.md). Poiché la destinazione di un EventBridge evento può essere impostata solo in un set di configurazione, è necessario [creare un set di configurazione](event-publishing-create-configuration-set.md) prima di aggiungere la destinazione dell'evento al set di configurazione.
La procedura in questa sezione mostra come aggiungere i dettagli della destinazione EventBridge dell'evento a un set di configurazione e presuppone che siano stati completati i passaggi da 1 a 6 in [Creazione di una destinazione degli eventi](event-destinations-manage.md#event-destination-add) poi.
Puoi anche utilizzare l'[UpdateConfigurationSetEventDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_UpdateConfigurationSetEventDestination.html)operazione nell'API Amazon SES V2 per creare e modificare le destinazioni degli eventi.
**Per aggiungere i dettagli della destinazione EventBridge dell'evento a un set di configurazione utilizzando la console**
1. Queste sono le istruzioni dettagliate per la selezione EventBridge del tipo di destinazione dell'evento nel [passaggio 7](event-destinations-manage.md#specify-event-dest-step) e presuppongono che tu abbia completato tutti i passaggi precedenti. [Creazione di una destinazione degli eventi](event-destinations-manage.md#event-destination-add) Dopo aver selezionato il **tipo di EventBridge destinazione** *Amazon*, inserito un **nome** di destinazione e abilitato la **pubblicazione degli eventi**, viene visualizzato il riquadro informativo **Amazon EventBridge Event Bus**.
1. Scegli **Next (Successivo)**.
1. Nella schermata di revisione, se sei soddisfatto della definizione della destinazione dell'evento, scegli **Add destination** (Aggiungi destinazione). In questo modo verrà aperta la pagina di riepilogo della destinazione dell'evento, in cui un banner di esito positivo confermerà se la destinazione dell'evento è stata creata o modificata correttamente.
# Configurazione di una destinazione degli eventi Amazon Pinpoint per la pubblicazione di eventi
Una destinazione di eventi Amazon Pinpoint ti avvisa degli eventi di invio e-mail specificati in un set di configurazione. Poiché una destinazione di eventi Amazon Pinpoint può essere configurata solo in un set di configurazione, è necessario [creare un set di configurazione](event-publishing-create-configuration-set.md) prima di aggiungere la destinazione dell'evento al set di configurazione.
La procedura in questa sezione mostra come aggiungere i dettagli di una destinazione di eventi Amazon Pinpoint a un set di configurazione e considera che tu abbia completato le fasi da 1 a 6 in [Creazione di una destinazione degli eventi](event-destinations-manage.md#event-destination-add).
Puoi anche utilizzare l'[UpdateConfigurationSetEventDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_UpdateConfigurationSetEventDestination.html)operazione nell'API Amazon SES V2 per creare e modificare le destinazioni degli eventi.
Sono previsti costi aggiuntivi per i tipi di canali che hai configurato nei tuoi progetti Amazon Pinpoint. Per ulteriori informazioni, consulta [Prezzi di Amazon Pinpoint](https://aws.amazon.com/pinpoint/pricing/).
**Aggiunta di dettagli per una destinazione di eventi Amazon Pinpoint a un set di configurazione utilizzando la console**
1. Queste sono le istruzioni dettagliate per selezionare Amazon Pinpoint come tipo di destinazione dell'evento in [Fase 7](event-destinations-manage.md#specify-event-dest-step) e presuppone di aver completato tutti i passaggi precedenti in [Creazione di una destinazione degli eventi](event-destinations-manage.md#event-destination-add).
**Nota**
Amazon Pinpoint non supporta i tipi di evento **Delivery delays** (Ritardi di consegna) o **Subscriptions** (Sottoscrizioni).
Dopo aver selezionato il **tipo di destinazione** Amazon Pinpoint, inserito un **nome** di destinazione e abilitato la **pubblicazione degli eventi**, viene visualizzato il riquadro dei dettagli del **progetto Amazon Pinpoint**, i cui campi vengono risolti nei passaggi seguenti.
1. Per **Project** (Progetto), scegli un progetto Amazon Pinpoint esistente oppure **Create a new project in Amazon Pinpoint** (Crea un nuovo progetto in Amazon Pinpoint) per crearne uno nuovo.
Per informazioni su come creare un progetto, vedi [Creazione di un progetto](https://docs.aws.amazon.com/pinpoint/latest/userguide/gettingstarted-create-project.html) nella *Guida per l'utente di Amazon Pinpoint*.
1. Seleziona **Next** (Successivo).
1. Nella schermata di revisione, se sei soddisfatto della definizione della destinazione dell'evento, scegli **Add destination** (Aggiungi destinazione). In questo modo verrà aperta la pagina di riepilogo della destinazione dell'evento, in cui un banner di esito positivo confermerà se la destinazione dell'evento è stata creata o modificata correttamente.
# Configurazione di una destinazione degli eventi Amazon SNS per la pubblicazione di eventi
Una destinazione di eventi Amazon SNS ti notifica gli eventi di invio e-mail specificati in un set di configurazione. Poiché una destinazione di eventi Amazon SNS può essere configurata solo in un set di configurazione, è necessario [creare un set di configurazione](event-publishing-create-configuration-set.md) prima di aggiungere la destinazione dell'evento al set di configurazione.
La procedura in questa sezione mostra come aggiungere i dettagli di una destinazione di eventi Amazon SNS a un set di configurazione e considera che tu abbia completato le fasi da 1 a 6 in [Creazione di una destinazione degli eventi](event-destinations-manage.md#event-destination-add).
Puoi anche utilizzare l'[UpdateConfigurationSetEventDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_UpdateConfigurationSetEventDestination.html)operazione nell'API Amazon SES V2 per creare e modificare le destinazioni degli eventi.
**Nota**
È possibile utilizzare anche Amazon SNS per impostare le notifiche dei feedback per mancati recapiti, reclami e recapiti per qualsiasi identità di invio verificata. Per ulteriori informazioni, consulta [Configurazione delle notifiche Amazon SNS per Amazon SES](configure-sns-notifications.md).
Sono previsti costi aggiuntivi per l'invio di messaggi agli endpoint sottoscritti ai tuoi argomenti Amazon SNS. Per ulteriori informazioni, consulta [Prezzi di Amazon SNS](https://aws.amazon.com/sns/pricing/).
**Aggiunta di dettagli per una destinazione di eventi Amazon SNS a un set di configurazione utilizzando la console**
1. Queste sono le istruzioni dettagliate per selezionare Amazon SNS come tipo di destinazione dell'evento in [Fase 7](event-destinations-manage.md#specify-event-dest-step) e presuppone di aver completato tutti i passaggi precedenti in [Creazione di una destinazione degli eventi](event-destinations-manage.md#event-destination-add). Dopo aver selezionato il **tipo di destinazione** Amazon SNS, inserito un **nome** di destinazione e abilitato la **pubblicazione degli eventi**, viene visualizzato il riquadro degli argomenti **Amazon Simple Notification Service (SNS)**, i cui campi vengono risolti nei passaggi seguenti.
1. Per **SNS topic** (Argomento SNS) scegli un argomento Amazon SNS esistente oppure **Create SNS topic** (Crea argomento SNS) per crearne uno nuovo.
Per informazioni su come creare un argomento, consulta [Creazione di un argomento](https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html) nella *Guida per gli sviluppatori di Amazon Simple Notification Service*.
**Importante**
Quando crei il tuo argomento utilizzando Amazon SNS, per **Type** (Tipo), scegli solo **Standard**. (SES non supporta argomenti di tipo FIFO).
1. Scegli **Next (Successivo)**.
1. Nella schermata di revisione, se sei soddisfatto della definizione della destinazione dell'evento, scegli **Add destination** (Aggiungi destinazione). In questo modo verrà aperta la pagina di riepilogo della destinazione dell'evento, in cui un banner di esito positivo confermerà se la destinazione dell'evento è stata creata o modificata correttamente.
1. Sia che tu abbia creato un nuovo argomento SNS o ne abbia selezionato uno esistente, ora dovrai concedere l'accesso a SES per pubblicare le notifiche sull'argomento. Nella pagina di riepilogo della destinazione dell'evento della fase precedente, scegli **Amazon SNS** dalla colonna **Destination type (Tipo di destinazione)**: questo ti porterà all'elenco **Topics (Argomenti)** nella console Amazon Simple Notification Service. *Effettua i passaggi seguenti dalla console Amazon SNS:*
1. Seleziona il nome dell'argomento SNS che hai creato o modificato nella fase precedente.
1. Nella schermata dei dettagli dell'argomento, scegli **Edit (Modifica)**.
1. Per concedere a SES l'autorizzazione a pubblicare notifiche nell'argomento, nella schermata **Edit topic (Modifica argomento)** della console SNS, espandi **Access policy (Policy di accesso)** e in **JSON editor (Editor JSON)** aggiungi la policy di autorizzazione seguente:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Id": "notification-policy",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "ses.amazonaws.com"
},
"Action": "sns:Publish",
"Resource": "arn:aws:sns:us-east-1:111122223333:topic_name",
"Condition": {
"StringEquals": {
"AWS:SourceAccount": "111122223333",
"AWS:SourceArn": "arn:aws:ses:topic_region:111122223333:configuration-set/configuration-set-name"
}
}
}
]
}
```
------
Nel precedente esempio di policy, apporta le modifiche seguenti:
+ Sostituiscilo *topic\$1region* con la AWS regione in cui hai creato l'argomento SNS.
+ *111122223333*Sostituiscilo con l'ID AWS del tuo account.
+ Sostituiscilo *topic\$1name* con il nome del tuo argomento SNS.
+ Sostituiscilo *configuration-set-name* con il nome del set di configurazione associato alla destinazione dell'evento SNS.
1. Scegli **Save changes (Salva modifiche)**.
# Fase 3: specificazione di un set di configurazione per l'invio di un messaggio di posta elettronica
Dopo aver [creato un set di configurazione](event-publishing-create-configuration-set.md) e aver [aggiunto una destinazione degli eventi](event-publishing-add-event-destination.md), l'ultima fase della pubblicazione di eventi consiste nell'inviare le tue e-mail.
Per pubblicare gli eventi associati a un'e-mail, devi fornire il nome del set di configurazione da associare all'e-mail. Opzionalmente puoi fornire tag di messaggio per classificare l'e-mail.
Puoi fornire queste informazioni ad Amazon SES come parametri dell'API di invio di e-mail, intestazioni specifiche di Amazon SES o intestazioni personalizzate nel messaggio MIME. Il metodo scelto dipende da quale interfaccia di invio di e-mail utilizzi, come illustrato nella seguente tabella.
****
| Interfaccia di invio di e-mail | Metodi di pubblicazione di eventi |
| --- | --- |
| `SendEmail` | Parametri dell'API |
| `SendTemplatedEmail` | Parametri dell'API |
| `SendBulkTemplatedEmail` | Parametri dell'API |
| `SendCustomVerificationEmail` | Parametri dell'API |
| `SendRawEmail` | Parametri dell'API, intestazioni e-mail specifiche di Amazon SES o intestazioni MIME personalizzate Se specifichi tag di messaggio utilizzando sia le intestazioni che i parametri dell'API, Amazon SES utilizza solo i tag di messaggio forniti dai parametri dell'API. Amazon SES non unisce i tag di messaggio specificati dai parametri dell'API e dalle intestazioni. |
| Interfaccia SMTP | Intestazioni e-mail specifiche di Amazon SES |
Le sezioni seguenti descrivono come specificare il set di configurazione e i tag di messaggio utilizzando le intestazioni e i parametri dell'API.
+ [Utilizzo di parametri dell'API Amazon SES](#event-publishing-using-ses-parameters)
+ [Utilizzo di intestazioni e-mail specifiche di Amazon SES](#event-publishing-using-ses-headers)
+ [Utilizzo di intestazioni e-mail personalizzate](#event-publishing-using-custom-headers)
**Nota**
Opzionalmente puoi includere tag di messaggio nelle intestazioni dell'e-mail. I tag di messaggio possono includere numeri da 0 a 9, lettere da A a Z (maiuscole e minuscole), trattini (-) e trattini di sottolineatura (\$1).
## Utilizzo di parametri dell'API Amazon SES
Per utilizzare [SendEmail](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendEmail.html), [SendTemplatedEmail](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendTemplatedEmail.html), [SendBulkTemplatedEmail[SendCustomVerificationEmail](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendCustomVerificationEmail.html)](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendBulkTemplatedEmail.html), o [SendRawEmail](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendRawEmail.html)con la pubblicazione di eventi, specificate il set di configurazione e i tag dei messaggi passando le strutture di dati chiamate [ConfigurationSet](https://docs.aws.amazon.com/ses/latest/APIReference/API_ConfigurationSet.html)e [MessageTag](https://docs.aws.amazon.com/ses/latest/APIReference/API_MessageTag.html)alla chiamata API.
Per ulteriori informazioni sull'uso dell'API Amazon SES, consulta [Documenti di riferimento per le API di Amazon Simple Email Service](https://docs.aws.amazon.com/ses/latest/APIReference/).
## Utilizzo di intestazioni e-mail specifiche di Amazon SES
Quando usi `SendRawEmail` o l'interfaccia SMTP, puoi specificare il set di configurazione e i tag di messaggio aggiungendo intestazioni specifiche di Amazon SES all'e-mail. Amazon SES rimuove le intestazioni prima di inviare l'e-mail. La tabella seguente mostra i nomi delle intestazioni da utilizzare.
| Informazioni per la pubblicazione di eventi | Header |
| --- | --- |
| Set di configurazione | `X-SES-CONFIGURATION-SET` |
| Tag di messaggio | `X-SES-MESSAGE-TAGS` |
L'esempio seguente mostra il possibile aspetto delle intestazioni in un'e-mail in formato RAW inviata ad Amazon SES.
```
1. X-SES-MESSAGE-TAGS: tagName1=tagValue1, tagName2=tagValue2
2. X-SES-CONFIGURATION-SET: myConfigurationSet
3. From: sender@example.com
4. To: recipient@example.com
5. Subject: Subject
6. Content-Type: multipart/alternative;
7. boundary="----=_boundary"
8.
9. ------=_boundary
10. Content-Type: text/plain; charset=UTF-8
11. Content-Transfer-Encoding: 7bit
12.
13. body
14. ------=_boundary
15. Content-Type: text/html; charset=UTF-8
16. Content-Transfer-Encoding: 7bit
17.
18. body
19. ------=_boundary--
```
## Utilizzo di intestazioni e-mail personalizzate
Anche se devi specificare il nome del set di configurazione utilizzando l'intestazione specifica di Amazon SES `X-SES-CONFIGURATION-SET`, puoi specificare i tag di messaggio utilizzando le tue intestazioni MIME.
**Nota**
I nomi e i valori delle intestazioni che usi per la pubblicazione di eventi Amazon SES devono essere in ASCII. Se specifichi un nome o un valore di intestazione non ASCII per la pubblicazione di eventi Amazon SES, la chiamata di invio e-mail avrà comunque esito positivo, ma i parametri dell'evento non verranno trasmessi ad Amazon. CloudWatch