Esempi di utilizzo di Amazon SES AWS CLI

Eliminazione di un'identità

Nell'esempio seguente viene utilizzato il comando delete-identity per eliminare un'identità dall'elenco delle identità verificate con Amazon SES:

aws ses delete-identity --identity user@example.com

Per ulteriori informazioni riguardo alle identità verificate, consulta Verifica degli indirizzi e-mail e dei domini in Amazon SES nella Guida per gli sviluppatori di Amazon Simple Email Service.

Per ottenere gli attributi Easy DKIM di Amazon SES per un elenco di identità

L'esempio seguente utilizza il get-identity-dkim-attributes comando per recuperare gli attributi Easy DKIM di Amazon SES per un elenco di identità:

aws ses get-identity-dkim-attributes --identities "example.com" "user@example.com"

Output:

{
   "DkimAttributes": {
       "example.com": {
           "DkimTokens": [
               "EXAMPLEjcs5xoyqytjsotsijas7236gr",
               "EXAMPLEjr76cvoc6mysspnioorxsn6ep",
               "EXAMPLEkbmkqkhlm2lyz77ppkulerm4k"
           ],
           "DkimEnabled": true,
           "DkimVerificationStatus": "Success"
       },
       "user@example.com": {
           "DkimEnabled": false,
           "DkimVerificationStatus": "NotStarted"
       }
   }
}

Se chiami questo comando con un'identità che non hai mai inviato per la verifica, tale identità non verrà visualizzata nell'output.

Per ulteriori informazioni su Easy DKIM, consulta Easy DKIM in Amazon SES nella Amazon Simple Email Service Developer Guide.

Per ottenere gli attributi di notifica di Amazon SES per un elenco di identità

L'esempio seguente utilizza il get-identity-notification-attributes comando per recuperare gli attributi di notifica di Amazon SES per un elenco di identità:

aws ses get-identity-notification-attributes --identities "user1@example.com" "user2@example.com"

Output:

{
   "NotificationAttributes": {
       "user1@example.com": {
           "ForwardingEnabled": false,
           "ComplaintTopic": "arn:aws:sns:us-east-1:EXAMPLE65304:MyTopic",
           "BounceTopic": "arn:aws:sns:us-east-1:EXAMPLE65304:MyTopic",
           "DeliveryTopic": "arn:aws:sns:us-east-1:EXAMPLE65304:MyTopic"
       },
       "user2@example.com": {
           "ForwardingEnabled": true
       }
   }
}

Questo comando restituisce lo stato dell'inoltro del feedback via e-mail e, se applicabile, gli Amazon Resource Names (ARNs) degli argomenti di Amazon SNS a cui vengono inviate le notifiche di rimbalzo, reclamo e consegna.

Se chiami questo comando con un'identità che non hai mai inviato per la verifica, tale identità non verrà visualizzata nell'output.

Per ulteriori informazioni sulle notifiche, consulta Using Notifications With Amazon SES nella Amazon Simple Email Service Developer Guide.

Ottenere lo stato di verifica di Amazon SES per un elenco di identità

Nell'esempio seguente viene utilizzato il comando get-identity-verification-attributes per richiamare lo stato di verifica di Amazon SES per un elenco di identità:

aws ses get-identity-verification-attributes --identities "user1@example.com" "user2@example.com"

Output:

{
   "VerificationAttributes": {
       "user1@example.com": {
           "VerificationStatus": "Success"
       },
       "user2@example.com": {
           "VerificationStatus": "Pending"
       }
   }
}

Se chiami questo comando con un'identità che non hai mai inviato per la verifica, tale identità non verrà visualizzata nell'output.

Per ulteriori informazioni riguardo alle identità verificate, consulta Verifica degli indirizzi e-mail e dei domini in Amazon SES nella Guida per gli sviluppatori di Amazon Simple Email Service.

Ottenere i limiti di invio di Amazon SES

Nell'esempio seguente viene utilizzato il comando get-send-quota per restituire i limiti di invio di Amazon SES:

aws ses get-send-quota

Output:

{
   "Max24HourSend": 200.0,
   "SentLast24Hours": 1.0,
   "MaxSendRate": 1.0
}

Max24 HourSend è la tua quota di invio, ovvero il numero massimo di e-mail che puoi inviare in un periodo di 24 ore. La quota di invio riflette un periodo di tempo continuo. Ogni volta che provi a inviare un messaggio e-mail, Amazon SES verifica la quantità di e-mail inviate nelle ultime 24 ore. Se il numero totale di e-mail che hai inviato è inferiore alla quota, la tua richiesta sarà accettata e l'e-mail inviata.

SentLast24Hours è il numero di email che hai inviato nelle 24 ore precedenti.

MaxSendRate è il numero massimo di e-mail che puoi inviare al secondo.

Tieni presente che i limiti di invio si basano sui destinatari e non sui messaggi. Ad esempio, un'e-mail con 10 destinatari viene conteggiata come 10 e-mail ai fini della quota sugli invii.

Per ulteriori informazioni, consulta Gestione dei limiti di invio in Amazon SES nella Guida per gli sviluppatori di Amazon Simple Email Service.

Per ottenere le statistiche di invio di Amazon SES

L'esempio seguente utilizza il get-send-statistics comando per restituire le statistiche di invio di Amazon SES

aws ses get-send-statistics

Output:

{
   "SendDataPoints": [
       {
           "Complaints": 0,
           "Timestamp": "2013-06-12T19:32:00Z",
           "DeliveryAttempts": 2,
           "Bounces": 0,
           "Rejects": 0
       },
       {
           "Complaints": 0,
           "Timestamp": "2013-06-12T00:47:00Z",
           "DeliveryAttempts": 1,
           "Bounces": 0,
           "Rejects": 0
       }
   ]
}

Il risultato è un elenco di punti dati, che rappresentano le ultime due settimane di attività di invio. Ogni punto dati nell'elenco contiene statistiche per un intervallo di 15 minuti.

In questo esempio, ci sono solo due punti dati perché le uniche e-mail inviate dall'utente nelle ultime due settimane rientrano in due intervalli di 15 minuti.

Per ulteriori informazioni, consulta Monitoring Your Your Amazon SES Usage Statistics nella Amazon Simple Email Service Developer Guide.

Per elencare tutte le identità (indirizzi e-mail e domini) per un account specifico AWS

Nell'esempio seguente viene utilizzato il comando list-identities per elencare tutte le identità che sono state inviate per la verifica con Amazon SES:

aws ses list-identities

Output:

{
    "Identities": [
      "user@example.com",
      "example.com"
    ]
}

L'elenco restituito contiene tutte le identità indipendentemente dallo stato della verifica (verified, pending verification, failure, ecc.).

In questo esempio, gli indirizzi e-mail e i domini vengono restituiti perché non è stato specificato il parametro identity-type.

Per ulteriori informazioni riguardo alla verifica, consulta Verifica degli indirizzi e-mail e dei domini in Amazon SES nella Guida per gli sviluppatori di Amazon Simple Email Service.

Invio di e-mail formattate utilizzando Amazon SES

Nell'esempio seguente viene utilizzato il comando send-email per inviare un messaggio e-mail formattato:

aws ses send-email --from sender@example.com --destination file://destination.json --message file://message.json

Output:

{
   "MessageId": "EXAMPLEf3a5efcd1-51adec81-d2a4-4e3f-9fe2-5d85c1b23783-000000"
}

La destinazione e il messaggio sono strutture di dati JSON salvate in file .json nella directory corrente. Tali file sono i seguenti:

destination.json:

{
  "ToAddresses":  ["recipient1@example.com", "recipient2@example.com"],
  "CcAddresses":  ["recipient3@example.com"],
  "BccAddresses": []
}

message.json:

{
   "Subject": {
       "Data": "Test email sent using the AWS CLI",
       "Charset": "UTF-8"
   },
   "Body": {
       "Text": {
           "Data": "This is the message body in text format.",
           "Charset": "UTF-8"
       },
       "Html": {
           "Data": "This message body contains HTML formatting. It can, for example, contain links like this one: <a class=\"ulink\" href=\"http://docs.aws.amazon.com/ses/latest/DeveloperGuide\" target=\"_blank\">Amazon SES Developer Guide</a>.",
           "Charset": "UTF-8"
       }
   }
}

Sostituisci gli indirizzi e-mail del mittente e del destinatario con quelli che desideri utilizzare. Tieni presente che l'indirizzo e-mail del mittente deve essere verificato con Amazon SES. Fino a quando non ti viene concesso l'accesso alla produzione ad Amazon SES, devi verificare anche l'indirizzo e-mail di ciascun destinatario, a meno che il destinatario non sia il simulatore di mailbox Amazon SES. Per ulteriori informazioni riguardo alla verifica, consulta Verifica degli indirizzi e-mail e dei domini in Amazon SES nella Guida per gli sviluppatori di Amazon Simple Email Service.

L'ID del messaggio nell'output indica che la chiamata a send-email è stata completata correttamente.

Se non ricevi l'e-mail, controlla la casella della posta indesiderata.

Per ulteriori informazioni sull'invio di e-mail formattate, consulta Invio di e-mail formattate tramite l'API Amazon SES nella Guida per gli sviluppatori di Amazon Simple Email Service.

Invio di e-mail in formato RAW utilizzando Amazon SES

Nell'esempio seguente viene utilizzato il comando send-raw-email per inviare un messaggio con un allegato TXT:

aws ses send-raw-email --raw-message file://message.json

Output:

{
   "MessageId": "EXAMPLEf3f73d99b-c63fb06f-d263-41f8-a0fb-d0dc67d56c07-000000"
}

Il messaggio in formato RAW è una struttura di dati JSON salvata in un file denominato message.json nella directory corrente. Contiene i seguenti dati:

{
   "Data": "From: sender@example.com\nTo: recipient@example.com\nSubject: Test email sent using the AWS CLI (contains an attachment)\nMIME-Version: 1.0\nContent-type: Multipart/Mixed; boundary=\"NextPart\"\n\n--NextPart\nContent-Type: text/plain\n\nThis is the message body.\n\n--NextPart\nContent-Type: text/plain;\nContent-Disposition: attachment; filename=\"attachment.txt\"\n\nThis is the text in the attachment.\n\n--NextPart--"
}

Come si vede, quella denominata "Data" è una lunga stringa con all'interno tutto il contenuto RAW dell'e-mail in formato MIME, incluso un allegato chiamato attachment.txt.

Sostituisci sender@example.com e recipient@example.com con gli indirizzi che desideri utilizzare. Tieni presente che l'indirizzo e-mail del mittente deve essere verificato con Amazon SES. Fino a quando non ti viene concesso l'accesso alla produzione ad Amazon SES, devi verificare anche l'indirizzo e-mail del destinatario, a meno che il destinatario non sia il simulatore di mailbox Amazon SES. Per ulteriori informazioni riguardo alla verifica, consulta Verifica degli indirizzi e-mail e dei domini in Amazon SES nella Guida per gli sviluppatori di Amazon Simple Email Service.

L'ID del messaggio nell'output indica che la chiamata a ha send-raw-email avuto esito positivo.

Se non ricevi l'e-mail, controlla la casella della posta indesiderata.

Per ulteriori informazioni sull'invio di e-mail in formato RAW, consulta Invio di e-mail in formato RAW tramite l'API Amazon SES nella Guida per gli sviluppatori di Amazon Simple Email Service.

Per abilitare o disabilitare Easy DKIM per un'identità verificata da Amazon SES

L'esempio seguente utilizza il set-identity-dkim-enabled comando per disabilitare DKIM per un indirizzo email verificato:

aws ses set-identity-dkim-enabled --identity user@example.com --no-dkim-enabled

Per ulteriori informazioni su Easy DKIM, consulta Easy DKIM in Amazon SES nella Amazon Simple Email Service Developer Guide.

Per abilitare o disabilitare l'inoltro di feedback via e-mail di respingimento e reclamo per un'identità verificata da Amazon SES

L'esempio seguente utilizza il set-identity-feedback-forwarding-enabled comando per consentire a un indirizzo e-mail verificato di ricevere notifiche di rimbalzi e reclami via e-mail:

aws ses set-identity-feedback-forwarding-enabled --identity user@example.com --forwarding-enabled

Devi ricevere notifiche di rimbalzo e reclamo tramite Amazon SNS o l'inoltro di feedback via e-mail, quindi puoi disabilitare l'inoltro di feedback via e-mail solo se selezioni un argomento Amazon SNS per le notifiche di rimbalzo e di reclamo.

Per ulteriori informazioni sulle notifiche, consulta Using Notifications With Amazon SES nella Amazon Simple Email Service Developer Guide.

Per impostare l'argomento Amazon SNS su cui Amazon SES pubblicherà notifiche di rimbalzo, reclamo e/o consegna per un'identità verificata

L'esempio seguente utilizza il set-identity-notification-topic comando per specificare l'argomento Amazon SNS a cui un indirizzo e-mail verificato riceverà le notifiche di rimbalzo:

aws ses set-identity-notification-topic --identity user@example.com --notification-type Bounce --sns-topic arn:aws:sns:us-east-1:EXAMPLE65304:MyTopic

Per ulteriori informazioni sulle notifiche, consulta Using Notifications With Amazon SES nella Amazon Simple Email Service Developer Guide.

Per generare i token DKIM di un dominio verificato per la firma DKIM con Amazon SES

L'esempio seguente utilizza il verify-domain-dkim comando per generare token DKIM per un dominio che è stato verificato con Amazon SES:

aws ses verify-domain-dkim --domain example.com

Output:

{
   "DkimTokens": [
       "EXAMPLEq76owjnks3lnluwg65scbemvw",
       "EXAMPLEi3dnsj67hstzaj673klariwx2",
       "EXAMPLEwfbtcukvimehexktmdtaz6naj"
   ]
}

Per configurare DKIM, devi utilizzare i token DKIM restituiti per aggiornare le impostazioni DNS del tuo dominio con record CNAME che puntano a chiavi pubbliche DKIM ospitate da Amazon SES. Per ulteriori informazioni, consulta Easy DKIM in Amazon SES nella Amazon Simple Email Service Developer Guide.

Verifica di un dominio con Amazon SES

Nell'esempio seguente viene utilizzato il comando verify-domain-identity per verificare un dominio:

aws ses verify-domain-identity --domain example.com

Output:

{
   "VerificationToken": "eoEmxw+YaYhb3h3iVJHuXMJXqeu1q1/wwmvjuEXAMPLE"
}

Per completare la verifica del dominio, devi aggiungere un record TXT con il token di verifica restituito alle impostazioni DNS del tuo dominio. Per ulteriori informazioni, consulta Verifica dei domini nella Guida per gli sviluppatori di Amazon Simple Email Service.

Aggiungere e verificare un indirizzo e-mail con Amazon SES

Nell'esempio seguente viene utilizzato il comando verify-email-identity per verificare un indirizzo e-mail:

aws ses verify-email-identity --email-address user@example.com

Prima di poter inviare e-mail usando Amazon SES, è necessario verificare il dominio o l'indirizzo da cui si intende inviare l'e-mail per dimostrarne la proprietà. Se non disponi ancora dell'accesso alla produzione, devi verificare anche tutti gli indirizzi e-mail a cui invii messaggi, ad eccezione degli indirizzi e-mail forniti dal Simulatore di mailbox di Amazon SES.

Dopo verify-email-identity la chiamata, l'indirizzo e-mail riceverà un'e-mail di verifica. L'utente deve fare clic sul link nell'e-mail per completare il processo di verifica.

Per ulteriori informazioni, consulta Verifica degli indirizzi e-mail in Amazon SES nella Guida per gli sviluppatori di Amazon Simple Email Service.