SESContoh Amazon menggunakan AWS CLI

Untuk menghapus identitas

Contoh berikut menggunakan delete-identity perintah untuk menghapus identitas dari daftar identitas yang diverifikasi dengan AmazonSES:

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

Untuk informasi selengkapnya tentang identitas terverifikasi, lihat Memverifikasi Alamat Email dan Domain SES di Amazon di Panduan Pengembang Layanan Email Sederhana Amazon.

Untuk mendapatkan DKIM atribut Amazon SES Easy untuk daftar identitas

Contoh berikut menggunakan get-identity-dkim-attributes perintah untuk mengambil DKIM atribut Amazon SES Easy untuk daftar identitas:

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

Jika Anda memanggil perintah ini dengan identitas yang belum pernah Anda kirimkan untuk verifikasi, identitas itu tidak akan muncul di output.

Untuk informasi selengkapnya tentang MudahDKIM, lihat Mudah DKIM di Amazon SES di Panduan Pengembang Layanan Email Sederhana Amazon.

Untuk mendapatkan atribut SES notifikasi Amazon untuk daftar identitas

Contoh berikut menggunakan get-identity-notification-attributes perintah untuk mengambil atribut SES notifikasi Amazon untuk daftar identitas:

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

Perintah ini mengembalikan status penerusan umpan balik email dan, jika berlaku, Nama Sumber Daya Amazon (ARNs) dari SNS topik Amazon tempat pentalan, keluhan, dan pemberitahuan pengiriman dikirim.

Jika Anda memanggil perintah ini dengan identitas yang belum pernah Anda kirimkan untuk verifikasi, identitas itu tidak akan muncul di output.

Untuk informasi selengkapnya tentang notifikasi, lihat Menggunakan Pemberitahuan Dengan Amazon SES di Panduan Pengembang Layanan Email Sederhana Amazon.

Untuk mendapatkan status SES verifikasi Amazon untuk daftar identitas

Contoh berikut menggunakan get-identity-verification-attributes perintah untuk mengambil status SES verifikasi Amazon untuk daftar identitas:

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

Jika Anda memanggil perintah ini dengan identitas yang belum pernah Anda kirimkan untuk verifikasi, identitas itu tidak akan muncul di output.

Untuk informasi selengkapnya tentang identitas terverifikasi, lihat Memverifikasi Alamat Email dan Domain SES di Amazon di Panduan Pengembang Layanan Email Sederhana Amazon.

Untuk mendapatkan batas SES pengiriman Amazon Anda

Contoh berikut menggunakan get-send-quota perintah untuk mengembalikan batas SES pengiriman Amazon Anda:

aws ses get-send-quota

Output:

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

Max24 HourSend adalah kuota pengiriman Anda, yaitu jumlah email maksimum yang dapat Anda kirim dalam jangka waktu 24 jam. Kuota pengiriman mencerminkan periode waktu bergulir. Setiap kali Anda mencoba mengirim email, Amazon SES memeriksa berapa banyak email yang Anda kirim dalam 24 jam sebelumnya. Selama jumlah email yang Anda kirim kurang dari kuota Anda, permintaan kirim Anda akan diterima dan email Anda akan terkirim.

SentLast24Hours adalah jumlah email yang telah Anda kirim dalam 24 jam sebelumnya.

MaxSendRate adalah jumlah maksimum email yang dapat Anda kirim per detik.

Perhatikan bahwa batas pengiriman didasarkan pada penerima, bukan pada pesan. Misalnya, email yang memiliki 10 penerima dihitung sebagai 10 terhadap kuota pengiriman Anda.

Untuk informasi selengkapnya, lihat Mengelola Batas SES Pengiriman Amazon Anda di Panduan Pengembang Layanan Email Sederhana Amazon.

Untuk mendapatkan statistik SES pengiriman Amazon Anda

Contoh berikut menggunakan get-send-statistics perintah untuk mengembalikan statistik SES pengiriman Amazon Anda

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

Hasilnya adalah daftar titik data, yang mewakili dua minggu terakhir aktivitas pengiriman. Setiap titik data dalam daftar berisi statistik untuk interval 15 menit.

Dalam contoh ini, hanya ada dua titik data karena satu-satunya email yang dikirim pengguna dalam dua minggu terakhir jatuh dalam dua interval 15 menit.

Untuk informasi selengkapnya, lihat Memantau Statistik SES Penggunaan Amazon Anda di Panduan Pengembang Layanan Email Sederhana Amazon.

Untuk mencantumkan semua identitas (alamat email dan domain) untuk akun tertentu AWS

Contoh berikut menggunakan list-identities perintah untuk mencantumkan semua identitas yang telah dikirimkan untuk verifikasi dengan AmazonSES:

aws ses list-identities

Output:

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

Daftar yang dikembalikan berisi semua identitas terlepas dari status verifikasi (verifikasi, verifikasi tertunda, kegagalan, dll.).

Dalam contoh ini, alamat email dan domain dikembalikan karena kami tidak menentukan parameter tipe identitas.

Untuk informasi selengkapnya tentang verifikasi, lihat Memverifikasi Alamat Email dan Domain di Amazon SES di Panduan Pengembang Layanan Email Sederhana Amazon.

Untuk mengirim email yang diformat menggunakan Amazon SES

Contoh berikut menggunakan send-email perintah untuk mengirim email yang diformat:

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

Tujuan dan pesan adalah struktur JSON data yang disimpan dalam file.json di direktori saat ini. File-file ini adalah sebagai berikut:

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

Ganti alamat email pengirim dan penerima dengan yang ingin Anda gunakan. Perhatikan bahwa alamat email pengirim harus diverifikasi dengan AmazonSES. Sampai Anda diberikan akses produksi ke AmazonSES, Anda juga harus memverifikasi alamat email setiap penerima kecuali penerima adalah simulator SES kotak surat Amazon. Untuk informasi selengkapnya tentang verifikasi, lihat Memverifikasi Alamat Email dan Domain di Amazon SES di Panduan Pengembang Layanan Email Sederhana Amazon.

ID Pesan dalam output menunjukkan bahwa panggilan ke kirim-email berhasil.

Jika Anda tidak menerima email, centang kotak Sampah Anda.

Untuk informasi selengkapnya tentang mengirim email yang diformat, lihat Mengirim Email Berformat Menggunakan Amazon SES API di Panduan Pengembang Layanan Email Sederhana Amazon.

Untuk mengirim email mentah menggunakan Amazon SES

Contoh berikut menggunakan send-raw-email perintah untuk mengirim email dengan TXT lampiran:

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

Output:

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

Pesan mentah adalah struktur JSON data yang disimpan dalam file bernama message.json di direktori saat ini. Ini berisi yang berikut:

{
   "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--"
}

Seperti yang Anda lihat, “Data” adalah satu string panjang yang berisi seluruh konten email mentah dalam MIME format, termasuk lampiran yang disebut attachment.txt.

Ganti sender@example.com dan recipient@example.com dengan alamat yang ingin Anda gunakan. Perhatikan bahwa alamat email pengirim harus diverifikasi dengan AmazonSES. Sampai Anda diberikan akses produksi ke AmazonSES, Anda juga harus memverifikasi alamat email penerima kecuali penerima adalah simulator SES kotak surat Amazon. Untuk informasi selengkapnya tentang verifikasi, lihat Memverifikasi Alamat Email dan Domain di Amazon SES di Panduan Pengembang Layanan Email Sederhana Amazon.

ID Pesan dalam output menunjukkan bahwa panggilan ke send-raw-email berhasil.

Jika Anda tidak menerima email, centang kotak Sampah Anda.

Untuk informasi selengkapnya tentang mengirim email mentah, lihat Mengirim Email Mentah Menggunakan Amazon SES API di Panduan Pengembang Layanan Email Sederhana Amazon.

Untuk mengaktifkan atau menonaktifkan Easy DKIM untuk identitas SES terverifikasi Amazon

Contoh berikut menggunakan set-identity-dkim-enabled perintah DKIM untuk menonaktifkan alamat email terverifikasi:

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

Untuk informasi selengkapnya tentang MudahDKIM, lihat Mudah DKIM di Amazon SES di Panduan Pengembang Layanan Email Sederhana Amazon.

Untuk mengaktifkan atau menonaktifkan penerusan umpan balik email pentalan dan keluhan untuk identitas terverifikasi Amazon SES

Contoh berikut menggunakan set-identity-feedback-forwarding-enabled perintah untuk mengaktifkan alamat email terverifikasi untuk menerima pemberitahuan bouncing dan keluhan melalui email:

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

Anda diminta untuk menerima pemberitahuan pentalan dan keluhan melalui Amazon SNS atau penerusan umpan balik email, sehingga Anda hanya dapat menonaktifkan penerusan umpan balik email jika Anda memilih SNS topik Amazon untuk pemberitahuan bouncing dan keluhan.

Untuk informasi selengkapnya tentang notifikasi, lihat Menggunakan Pemberitahuan Dengan Amazon SES di Panduan Pengembang Layanan Email Sederhana Amazon.

Untuk mengatur SNS topik Amazon tempat Amazon SES akan mempublikasikan pemberitahuan pentalan, keluhan, dan/atau pengiriman untuk identitas terverifikasi

Contoh berikut menggunakan set-identity-notification-topic perintah untuk menentukan SNS topik Amazon yang alamat email terverifikasi akan menerima pemberitahuan bouncing:

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

Untuk informasi selengkapnya tentang notifikasi, lihat Menggunakan Pemberitahuan Dengan Amazon SES di Panduan Pengembang Layanan Email Sederhana Amazon.

Untuk menghasilkan DKIM token domain terverifikasi untuk DKIM ditandatangani dengan Amazon SES

Contoh berikut menggunakan verify-domain-dkim perintah untuk menghasilkan DKIM token untuk domain yang telah diverifikasi dengan AmazonSES:

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

Output:

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

Untuk menyiapkanDKIM, Anda harus menggunakan DKIM token yang dikembalikan untuk memperbarui DNS pengaturan domain Anda dengan CNAME catatan yang mengarah ke kunci DKIM publik yang dihosting oleh AmazonSES. Untuk informasi selengkapnya, lihat Mudah DKIM di Amazon SES di Panduan Pengembang Layanan Email Sederhana Amazon.

Untuk memverifikasi domain dengan Amazon SES

Contoh berikut menggunakan verify-domain-identity perintah untuk memverifikasi domain:

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

Output:

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

Untuk menyelesaikan verifikasi domain, Anda harus menambahkan TXT catatan dengan token verifikasi yang dikembalikan ke DNS pengaturan domain Anda. Untuk informasi selengkapnya, lihat Memverifikasi Domain di Amazon SES dalam Panduan Pengembang Layanan Email Sederhana Amazon.

Untuk memverifikasi alamat email dengan Amazon SES

Contoh berikut menggunakan verify-email-identity perintah untuk memverifikasi alamat email:

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

Sebelum Anda dapat mengirim email menggunakan AmazonSES, Anda harus memverifikasi alamat atau domain tempat Anda mengirim email untuk membuktikan bahwa Anda memilikinya. Jika Anda belum memiliki akses produksi, Anda juga perlu memverifikasi alamat email apa pun yang Anda kirimi email kecuali alamat email yang disediakan oleh simulator SES kotak surat Amazon.

Setelah verify-email-identity dipanggil, alamat email akan menerima email verifikasi. Pengguna harus mengklik tautan di email untuk menyelesaikan proses verifikasi.

Untuk informasi selengkapnya, lihat Memverifikasi Alamat Email di Amazon SES dalam Panduan Pengembang Layanan Email Sederhana Amazon.