Contenuti delle notifiche per la ricezione di e-mail Amazon SES - Amazon Simple Email Service
Oggetto JSON di primo livelloOggetto receiptoggetto mail

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à.

Contenuti delle notifiche per la ricezione di e-mail Amazon SES

Tutte le notifiche per la ricezione di e-mail vengono pubblicate negli argomenti Amazon Simple Notification Service (Amazon SNS) in formato JSON (JavaScript Object Notation).

Per degli esempi di notifiche, consulta Esempi di notifiche.

Oggetto JSON di primo livello

L'oggetto JSON di primo livello contiene i campi seguenti.

Nome campo Descrizione
notificationType

Tipo di notifica. Per questo tipo di notifica, il valore è sempre Received.

receipt

Oggetto che contiene informazioni sulla consegna dell'e-mail.

mail

Oggetto che contiene informazioni sull'e-mail a cui la notifica è associata.

content

Stringa che contiene l'e-mail in formato RAW non modificato, in genere il formato Multipurpose Internet Mail Extensions (MIME). Per ulteriori informazioni sul formato MIME, consulta RFC 2045.

Nota

Questo campo è presente solo se la notifica è stata attivata da un'operazione SNS. Le notifiche attivate da tutte le altre operazioni non contengono questo campo.

Oggetto receipt

L'oggetto receipt dispone dei campi seguenti.

Nome campo Descrizione

action

Oggetto che incapsula informazioni sull'operazione eseguita. Per un elenco di possibili valori, consulta Oggetto action.

dkimVerdict

Oggetto che indica se il controllo DomainKeys Identified Mail (DKIM) è stato superato. Per un elenco di possibili valori, consulta Oggetto dkimVerdict.
dmarcPolicy

Indica le impostazioni Domain-based Message Authentication, Reporting & Conformance (DMARC) per il dominio di invio. Il campo appare solo se il messaggio fallisce l'autenticazione DMARC.

I valori possibili per questo campo sono:

  • none: il proprietario del dominio di invio richiede che non vengano eseguite operazioni specifiche sui messaggi che non superano l'autenticazione DMARC.

  • quarantine: il proprietario del dominio di invio richiede che i messaggi che non superano l'autenticazione DMARC vengano considerati sospetti dai ricevitori.

  • reject: il proprietario del dominio di invio richiede che i messaggi che non superano l'autenticazione DMARC vengano rifiutati.
dmarcVerdict Oggetto che indica se il controllo DMARC (Domain-based Message Authentication, Reporting & Conformance) è stato superato. Per un elenco di possibili valori, consulta Oggetto dmarcVerdict.
processingTimeMillis

Stringa che specifica il periodo di tempo, in millisecondi, dal momento in cui Amazon SES ha ricevuto il messaggio al momento in cui ha attivato l'operazione.
recipients

I destinatari (nello specifico, gli indirizzi envelope RCPT TO) abbinati dalla regola di ricezione attiva. Gli indirizzi elencati qui potrebbero differire da quelli elencati dal campo destination in oggetto mail.

spamVerdict

Oggetto che indica il messaggio come spam. Per un elenco di possibili valori, consulta Oggetto spamVerdict.

spfVerdict

Oggetto che indica se il controllo Sender Policy Framework (SPF) è stato superato. Per un elenco di possibili valori, consulta Oggetto spfVerdict.
timestamp

Stringa che specifica la data e l'ora in cui l'operazione è stata attivata, in formato ISO 8601.

virusVerdict

Oggetto che indica se il messaggio contiene un virus. Per un elenco di possibili valori, consulta Oggetto virusVerdict.

Oggetto action

L'oggetto action dispone dei campi seguenti.

Nome campo Descrizione
type

Stringa che indica il tipo di operazione che è stata eseguita. I valori possibili sono S3, SNS, Bounce, Lambda, Stop e WorkMail.
topicArn

Stringa che contiene l'Amazon Resource Name (ARN) dell'argomento Amazon SNS in cui la notifica è stata pubblicata.
bucketName

Stringa che contiene il nome del bucket Amazon S3 in cui il messaggio è stato pubblicato. Presente solo per il tipo di operazione S3.
objectKey

Stringa che include un nome che identifica in modo univoco l'e-mail nel bucket Amazon S3. Ciò corrisponde a messageId in oggetto mail. Presente solo per il tipo di operazione S3.
smtpReplyCode

Stringa che include il codice di risposta SMTP, come definito dallo standard RFC 5321. Presente solo per il tipo di operazione Bounce.
statusCode

Stringa che include il codice di stato avanzato SMTP, come definito dallo standard RFC 3463. Presente solo per il tipo di operazione Bounce.
message

Stringa che contiene il testo leggibile da includere nel messaggio di mancato recapito. Presente solo per il tipo di operazione Bounce.
sender

Stringa che contiene l'indirizzo e-mail del mittente dell'e-mail che non è stata recapitata. Questo è l'indirizzo da cui il messaggio di mancato recapito è stato inviato. Presente solo per il tipo di operazione Bounce.
functionArn

Stringa che contiene l'ARN della funzione Lambda che è stata attivata. Presente solo per il tipo di operazione Lambda.
invocationType

Stringa che include il tipo di richiamo della funzione Lambda. I valori possibili sono RequestResponse e Event. Presente solo per il tipo di operazione Lambda.
organizationArn

Stringa che contiene l'ARN dell'organizzazione Amazon WorkMail. Presente solo per il tipo di operazione WorkMail.

Oggetto dkimVerdict

L'oggetto dkimVerdict dispone dei campi seguenti.

Nome campo Descrizione
status

Stringa che contiene il risultato DKIM. I valori possibili sono:

  • PASS: il messaggio ha superato l'autenticazione DKIM.

  • FAIL: il messaggio non ha superato l'autenticazione DKIM.

  • GRAY: il messaggio non è firmato da DKIM o il dominio di provenienza e il dominio con firma DKIM non corrispondono.

  • PROCESSING_FAILED:A un problema impedisce ad Amazon SES di verificare la firma DKIM. Ad esempio, le query DNS non riescono o l'intestazione della firma DKIM non ha il formato corretto.

Oggetto dmarcVerdict

L'oggetto dmarcVerdict dispone dei campi seguenti.

Nome campo Descrizione
status

Stringa che contiene il risultato DMARC. I valori possibili sono:

  • PASS: il messaggio ha superato l'autenticazione DMARC.

  • FAIL: il messaggio non ha superato l'autenticazione DMARC.

  • GRAY: almeno uno tra SPF e DKIM ha superato l'autenticazione, ma il dominio di invio non dispone di una policy DMARC o utilizza la policy p=none.

  • PROCESSING_FAILED: un problema impedisce ad Amazon SES di fornire un risultato DMARC.

Oggetto spamVerdict

L'oggetto spamVerdict dispone dei campi seguenti.

Nome campo Descrizione
status

Stringa che contiene il risultato della scansione di verifica spam. I valori possibili sono:

  • PASS: la scansione di verifica spam ha determinato che non è probabile che il messaggio contenga spam.

  • FAIL: la scansione di verifica spam ha determinato che è probabile che il messaggio contenga spam.

  • GRAY: Amazon SES ha analizzato l'e-mail senza poter determinare con sicurezza se si tratta di spam.

  • PROCESSING_FAILED: Amazon SES non è stato in grado di analizzare l'e-mail. Ad esempio, l'e-mail non è un messaggio MIME valido.

Oggetto spfVerdict

L'oggetto spfVerdict dispone dei campi seguenti.

Nome campo Descrizione
status

Stringa che contiene il risultato SPF. I valori possibili sono:

  • PASS: il messaggio ha superato l'autenticazione SPF.

  • FAIL: il messaggio non ha superato l'autenticazione SPF.

  • GRAY: il risultato SPF è none, softfail o neutral.

  • PROCESSING_FAILED: un problema impedisce ad Amazon SES di verificare il record SPF. Ad esempio, le query DNS non riescono.

Oggetto virusVerdict

L'oggetto virusVerdict dispone dei campi seguenti.

Nome campo Descrizione
status

Stringa che contiene il risultato della scansione di verifica virus. I valori possibili sono:

  • PASS: il messaggio non contiene virus.

  • FAIL: il messaggio contiene virus.

  • GRAY: Amazon SES ha analizzato l'e-mail senza poter determinare con sicurezza se contiene virus.

  • PROCESSING_FAILED: Amazon SES non è in grado di analizzare il contenuto dell'e-mail. Ad esempio, l'e-mail non è un messaggio MIME valido.

oggetto mail

L'oggetto mail dispone dei campi seguenti.

Nome campo Descrizione
destination

Un elenco completo di tutti gli indirizzi dei destinatari (inclusi i destinatari A: e Cc:) tratti dalle intestazioni MIME dell'e-mail in entrata.
messageId

Stringa che contiene l'ID univoco assegnato all'e-mail da Amazon SES. Se l'e-mail è stata consegnata ad Amazon S3, l'ID messaggio è anche la chiave dell'oggetto Amazon S3 utilizzata per scrivere il messaggio al tuo bucket Amazon S3.
source

Stringa che contiene l'indirizzo e-mail da cui l'email è stata inviata (nello specifico, l'indirizzo MAIL FROM della busta).
timestamp

Stringa che contiene data e ora in cui l'e-mail è stata ricevuta, in formato ISO8601.
headers

Le intestazioni Amazon SES e le intestazioni personalizzate. Ogni intestazione dispone dei campi seguenti: name e value.

commonHeaders

Le intestazioni comuni a tutte le e-mail. Ogni intestazione dispone dei campi seguenti: name e value.
headersTruncated

Stringa che specifica se le intestazioni sono state troncate nella notifica. Ciò si verifica se le intestazioni hanno dimensione superiore a 10 KB. I valori possibili sono true e false.

Oggetto commonHeaders

L'oggetto commonHeaders può avere i campi indicati nella tabella riportata di seguito. I campi presenti in questo oggetto variano a seconda di quali campi erano presenti nella posta in entrata.

Nome campo Descrizione
messageId

L'ID del messaggio originale.
date

La data e l'ora in cui Amazon SES ha ricevuto il messaggio.
to

L'intestazione To dell'e-mail.
cc

L'intestazione CC dell'e-mail.
bcc

L'intestazione BCC dell'e-mail.
from

L'intestazione From dell'e-mail.
sender

L'intestazione Sender dell'e-mail.
returnPath

L'intestazione Return-Path dell'e-mail.
replyTo

L'intestazione Reply-To dell'e-mail.
subject

L'intestazione Subject dell'e-mail.