Amazon SES contoh menggunakan AWS CLI

Untuk menghapus identitas

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

aws ses delete-identity --identity [email protected]

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

Untuk mendapatkan atribut Amazon SES Easy DKIM untuk daftar identitas

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

aws ses get-identity-dkim-attributes --identities "example.com" "[email protected]"

Output:

{
   "DkimAttributes": {
       "example.com": {
           "DkimTokens": [
               "EXAMPLEjcs5xoyqytjsotsijas7236gr",
               "EXAMPLEjr76cvoc6mysspnioorxsn6ep",
               "EXAMPLEkbmkqkhlm2lyz77ppkulerm4k"
           ],
           "DkimEnabled": true,
           "DkimVerificationStatus": "Success"
       },
       "[email protected]": {
           "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 Easy DKIM, lihat Easy DKIM di Amazon SES di Panduan Pengembang Layanan Email Sederhana Amazon.

Untuk mendapatkan atribut notifikasi Amazon SES untuk daftar identitas

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

aws ses get-identity-notification-attributes --identities "[email protected]" "[email protected]"

Output:

{
   "NotificationAttributes": {
       "[email protected]": {
           "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"
       },
       "[email protected]": {
           "ForwardingEnabled": true
       }
   }
}

Perintah ini mengembalikan status penerusan umpan balik email dan, jika berlaku, Nama Sumber Daya Amazon (ARNs) dari topik Amazon SNS tempat pemberitahuan pentalan, keluhan, dan 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 verifikasi Amazon SES untuk daftar identitas

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

aws ses get-identity-verification-attributes --identities "[email protected]" "[email protected]"

Output:

{
   "VerificationAttributes": {
       "[email protected]": {
           "VerificationStatus": "Success"
       },
       "[email protected]": {
           "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 di Amazon SES di Panduan Pengembang Layanan Email Sederhana Amazon.

Untuk mendapatkan batas pengiriman Amazon SES Anda

Contoh berikut menggunakan get-send-quota perintah untuk mengembalikan batas pengiriman Amazon SES 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 Pengiriman Amazon SES Anda di Panduan Pengembang Layanan Email Sederhana Amazon.

Untuk mendapatkan statistik pengiriman Amazon SES Anda

Contoh berikut menggunakan get-send-statistics perintah untuk mengembalikan statistik pengiriman Amazon SES 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 Penggunaan Amazon SES 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 Amazon SES:

aws ses list-identities

Output:

{
    "Identities": [
      "[email protected]",
      "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 [email protected] --destination file://destination.json --message file://message.json

Output:

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

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

destination.json:

{
  "ToAddresses":  ["[email protected]", "[email protected]"],
  "CcAddresses":  ["[email protected]"],
  "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 Amazon SES. Sampai Anda diberikan akses produksi ke Amazon SES, Anda juga harus memverifikasi alamat email setiap penerima kecuali penerima adalah simulator kotak surat Amazon SES. 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 lampiran TXT:

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

Output:

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

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

{
   "Data": "From: [email protected]\nTo: [email protected]\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 format MIME, termasuk lampiran yang disebut attachment.txt.

Ganti [email protected] dan [email protected] dengan alamat yang ingin Anda gunakan. Perhatikan bahwa alamat email pengirim harus diverifikasi dengan Amazon SES. Sampai Anda diberikan akses produksi ke Amazon SES, Anda juga harus memverifikasi alamat email penerima kecuali penerima adalah simulator kotak surat Amazon SES. 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 terverifikasi Amazon SES

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

aws ses set-identity-dkim-enabled --identity [email protected] --no-dkim-enabled

Untuk informasi selengkapnya tentang Easy DKIM, lihat Easy 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 [email protected] --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 topik Amazon SNS 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 topik Amazon SNS yang Amazon SES akan mempublikasikan pemberitahuan pentalan, keluhan, dan/atau pengiriman untuk identitas terverifikasi

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

aws ses set-identity-notification-topic --identity [email protected] --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 token DKIM domain terverifikasi untuk penandatanganan DKIM dengan Amazon SES

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

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

Output:

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

Untuk menyiapkan DKIM, Anda harus menggunakan token DKIM yang dikembalikan untuk memperbarui pengaturan DNS domain Anda dengan catatan CNAME yang mengarah ke kunci publik DKIM yang dihosting oleh Amazon SES. Untuk informasi selengkapnya, lihat DKIM Mudah 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 catatan TXT dengan token verifikasi yang dikembalikan ke pengaturan DNS domain Anda. Untuk informasi selengkapnya, lihat Memverifikasi Domain di Amazon SES di 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 [email protected]

Sebelum Anda dapat mengirim email menggunakan Amazon SES, 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 kotak surat Amazon SES.

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 di Panduan Pengembang Layanan Email Sederhana Amazon.