SESEsempi di utilizzo di Amazon AWS CLI

Eliminazione di un'identità

L'esempio seguente utilizza il delete-identity comando per eliminare un'identità dall'elenco di identità verificate con AmazonSES:

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

Per ulteriori informazioni sulle identità verificate, consulta Verifying Email Addresses and Domains in Amazon nella Amazon SES Simple Email Service Developer Guide.

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

L'esempio seguente utilizza il get-identity-dkim-attributes comando per recuperare gli DKIM attributi di Amazon SES Easy 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 EasyDKIM, consulta Easy DKIM in Amazon SES nella Amazon Simple Email Service Developer Guide.

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

L'esempio seguente utilizza il get-identity-notification-attributes comando per recuperare gli attributi di SES notifica di Amazon 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 SNS argomenti Amazon 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.

Per ottenere lo stato SES di verifica di Amazon per un elenco di identità

L'esempio seguente utilizza il get-identity-verification-attributes comando per recuperare lo stato di SES verifica di Amazon 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 sulle identità verificate, consulta Verifying Email Addresses and Domains in Amazon nella Amazon SES Simple Email Service Developer Guide.

Per stabilire i limiti di SES invio di Amazon

L'esempio seguente utilizza il get-send-quota comando per restituire i limiti di SES invio di Amazon:

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'e-mail, Amazon SES controlla quante e-mail hai inviato nelle 24 ore precedenti. Se il numero totale di e-mail che hai inviato è inferiore alla quota, la tua richiesta sarà accettata e l'e-mail inviata.

SentLast24 ore è il numero di e-mail 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 Managing Your Amazon SES Sending Limits nella Amazon Simple Email Service Developer Guide.

Per ottenere le statistiche di SES invio su Amazon

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

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

L'esempio seguente utilizza il list-identities comando per elencare tutte le identità che sono state inviate per la verifica con AmazonSES:

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 sulla verifica, consulta Verifying Email Addresses and Domains in Amazon SES nella Amazon Simple Email Service Developer Guide.

Per inviare un'e-mail formattata tramite 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 JSON dati 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 AmazonSES. Fino a quando non ti viene concesso l'accesso alla produzione ad AmazonSES, devi anche verificare l'indirizzo e-mail di ciascun destinatario, a meno che il destinatario non sia il simulatore di caselle di SES posta Amazon. Per ulteriori informazioni sulla verifica, consulta Verifying Email Addresses and Domains in Amazon SES nella Amazon Simple Email Service Developer Guide.

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 utilizzando Amazon SES API nella Amazon Simple Email Service Developer Guide.

Per inviare un'e-mail non elaborata tramite Amazon SES

L'esempio seguente utilizza il send-raw-email comando per inviare un'e-mail con un TXT allegato:

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

Output:

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

Il messaggio non elaborato è una struttura di JSON dati 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 puoi vedere, «Data» è una lunga stringa che contiene l'intero contenuto non elaborato dell'email in MIME formato, 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 AmazonSES. Fino a quando non ti viene concesso l'accesso alla produzione ad AmazonSES, devi anche verificare l'indirizzo e-mail del destinatario, a meno che il destinatario non sia il simulatore di caselle di SES posta Amazon. Per ulteriori informazioni sulla verifica, consulta Verifying Email Addresses and Domains in Amazon SES nella Amazon Simple Email Service Developer Guide.

L'ID del messaggio nell'output indica che la chiamata a send-raw-email è andata a buon fine.

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

Per ulteriori informazioni sull'invio di e-mail non elaborate, consulta la sezione Invio di e-mail non elaborate utilizzando Amazon SES API nella Amazon Simple Email Service Developer Guide.

Per abilitare o disabilitare l'identità SES verificata di Easy DKIM for an Amazon

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

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

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

Per abilitare o disabilitare l'inoltro di feedback via email di rimbalzo 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 respingimento e reclamo 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 SNS argomento Amazon sia per le notifiche di rimbalzo che per quelle di reclamo.

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

Per impostare l'SNSargomento Amazon 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'SNSargomento Amazon 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 DKIM token di un dominio verificato per la DKIM firma con Amazon SES

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

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

Output:

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

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

Per verificare 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 TXT record con il token di verifica restituito alle DNS impostazioni del dominio. Per ulteriori informazioni, consulta Verifying Domains in Amazon SES nella Amazon Simple Email Service Developer Guide.

Per 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 un'e-mail tramite AmazonSES, devi verificare l'indirizzo o il dominio da cui stai inviando l'e-mail per dimostrare che la possiedi. Se non disponi ancora dell'accesso alla produzione, devi anche verificare tutti gli indirizzi e-mail a cui invii e-mail, ad eccezione degli indirizzi e-mail forniti dal simulatore di SES casella di posta Amazon.

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 la sezione Verifica degli indirizzi e-mail in Amazon SES nella Amazon Simple Email Service Developer Guide.