Isi notifikasi untuk menerima email Amazon SES - Layanan Email Sederhana Amazon
Objek JSON tingkat atasObjek penerimaanobjek surat

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Isi notifikasi untuk menerima email Amazon SES

Semua notifikasi untuk penerimaan email dipublikasikan ke topik Amazon Simple Notification Service (Amazon SNS) JavaScript dalam format Object Notation (JSON).

Misalnya notifikasi, lihatContoh notifikasi.

Objek JSON tingkat atas

Objek JSON tingkat atas berisi beberapa bidang berikut.

Nama Bidang Deskripsi
notificationType

Tipe notifikasi. Untuk tipe notifikasi ini, nilainya selalu Received.

receipt

Objek yang berisi informasi tentang pengiriman email.

mail

Objek yang berisi informasi tentang email yang terkait dengan notifikasi.

content

String yang berisi email mentah dan tidak dimodifikasi, yang umumnya dalam format Multipurpose Internet Mail Extensions (MIME). Untuk informasi lebih lanjut tentang format MIME, lihat RFC 2045.

catatan

Bidang ini hanya ada jika notifikasi dipicu oleh tindakan SNS. Notifikasi yang dipicu oleh semua tindakan lain tidak menahan bidang ini.

Objek penerimaan

Objek receipt berisi bidang-bidang berikut.

Nama Bidang Deskripsi

action

Objek yang merangkum informasi tentang tindakan yang dieksekusi. Untuk daftar peluang nilai, lihat objek tindakan.

dkimVerdict

Objek yang menunjukkan apakah cek DomainKeys Identified Mail (DKIM) lulus. Untuk daftar peluang nilai, lihat Objek dkimVerdict.
dmarcPolicy

Mengindikasikan pengaturan autentikasi pesan, pelaporan & kesesuaian berbasis Domain (DMARC) untuk domain pengiriman. Bidang ini hanya muncul jika pesan gagal diautentikasi DMARC.

Peluang nilai untuk kolom ini meliputi:

  • none: Pemilik domain pengiriman meminta bahwa tidak ada tindakan tertentu yang dilakukan pada pesan yang gagal diautentikasikan DMARC.

  • quarantine: Pemilik domain pengiriman meminta bahwa pesan yang gagal diautentikasikan DMARC dianggap mencurigakan oleh penerima.

  • reject: Pemilik domain pengiriman meminta pesan yang gagal diautentikasikan DMARC untuk ditolak.
dmarcVerdict Objek yang mengindikasikan apakah pengecekan pada Pesan Autentikasi, Pelaporan & kesesuaian berbasis Domain (DMARC) sudah berlalu. Untuk daftar peluang nilai, lihat Objek dmarcVerdict.
processingTimeMillis

String yang menentukan tanda titik, dalam milidetik, pada saat Amazon SES menerima pesan ketika Amazon SES tersebut memicu tindakan.
recipients

Penerima (khususnya, amplop alamat RCPT TO) yang dicocokkan dengan aturan tanda terima aktif. Alamat yang tercantum di sini mungkin berbeda dari yang tercantum oleh bidang destination di bidang objek surat.

spamVerdict

Objek yang mengidikasikan apakah pesan adalah spam. Untuk daftar peluang nilai, lihat Objek spamVerdict.

spfVerdict

Objek yang mengindikasikan apakah pemeriksaan Pengirim Kebijakan Kerangka Kerja (SPF) sudah berlalu. Untuk daftar peluang nilai, lihat Objek spfVerdict.
timestamp

String yang menentukan tanggal dan waktu yang memenuhi syarat pada saat tindakan dipicu, di format ISO 8601.

Virus Putusan

Objek yang menunjukkan apakah pesan berisi virus. Untuk daftar peluang nilai, lihat Objek virusVerdict.

objek tindakan

Objek action berisi bidang-bidang berikut.

Nama Bidang Deskripsi
type

String yang mengindikasikan tipe tindakan yang dieksekusi. Peluang nilai adalah S3, SNS, Bounce, Lambda, Stop, dan WorkMail.
topicArn

String yang berisi Amazon Resource Name (ARN) dari topik Amazon SNS yang dipublikasikan oleh notifikasi.
bucketName

String yang berisi nama bucket Amazon S3 yang diterbitkan pesan. Hadir hanya untuk tipe tindakan S3.
objectKey

String dengan nama yang secara unik mengidentifikasi email dalam bucket Amazon S3. Ini sama dengan messageId di objek surat. Hadir hanya untuk tipe tindakan S3.
smtpReplyCode

String yang berisi kode balasan SMTP, seperti yang didefinisikan oleh RFC 5321. Hadir hanya untuk tipe tindakan pentalan.
statusCode

String dengan kode status yang ditingkatkan SMTP, seperti yang didefinisikan oleh RFC 3463. Hadir hanya untuk tipe tindakan pentalan.
message

String yang berisi teks yang dapat dibaca manusia untuk dimasukkan dalam pesan pentalan. Hadir hanya untuk tipe tindakan pentalan.
sender

String yang berisi alamat email dari pengirim email yang memantul. Ini adalah alamat dari mana pesan pentalan dikirim. Hadir hanya untuk tipe tindakan pentalan.
functionArn

String yang berisi ARN fungsi Lambda yang dipicu. Hadir hanya untuk tipe tindakan Lambda.
invocationType

String yang berisi tipe invokasi fungsi Lambda. Kemungkinan nilai adalah RequestResponse dan Event. Hadir hanya untuk tipe tindakan Lambda.
organizationArn

String yang berisi ARN dari organisasi Amazon WorkMail. Hadir hanya untuk tipe WorkMail tindakan.

Objek dkimVerdict

Objek dkimVerdict berisi bidang-bidang berikut.

Nama Bidang Deskripsi
status

String yang berisi DKIM verdict. Kemungkinan nilai adalah:

  • PASS: Pesan melewati autentikasi DKIM.

  • FAIL: Pesan gagal dalam autentikasi DKIM.

  • GRAY: Pesan tidak ditandatangani DKIM atau domain from dan domain tanda tangan DKIM tidak cocok.

  • PROCESSING_FAILED: Terdapat masalah yang mencegah Amazon SES untuk memeriksa tanda tangan DKIM. Misalnya, Kueri DNS gagal atau header tanda tangan DKIM tidak diformat dengan benar.

Objek dmarcVerdict

Objek dmarcVerdict berisi bidang-bidang berikut.

Nama Bidang Deskripsi
status

String yang berisi DMARC verdict. Kemungkinan nilai adalah:

  • PASS: Pesan melewati autentikasi DMARC.

  • FAIL: Pesan gagal dalam autentikasi DMARC.

  • GRAYSetidaknya satu dari SPF atau DKIM lulus otentikasi, tetapi domain pengirim tidak memiliki kebijakan DMARC atau menggunakan kebijakan. p=none

  • PROCESSING_FAILED: Terdapat masalah yang mencegah Amazon SES memberikan DMARC verdict.

Objek spamVerdict

Objek spamVerdict berisi bidang-bidang berikut.

Nama Bidang Deskripsi
status

String yang berisi hasil pemindaian spam. Kemungkinan nilai adalah:

  • PASS: Pemindaian spam menentukan bahwa pesan tidak mungkin berisi spam.

  • FAIL: Pemindaian spam menentukan bahwa pesan kemungkinan berisi spam.

  • GRAY: Amazon SES memindai email tetapi tidak bisa menentukan dengan jelas apakah itu spam.

  • PROCESSING_FAILED: Amazon SES tidak dapat memindai email. Sebagai contoh, email bukan pesan MIME yang valid.

Objek spfVerdict

Objek spfVerdict berisi bidang-bidang berikut.

Nama Bidang Deskripsi
status

String yang berisi SPF verdict. Kemungkinan nilai adalah:

  • PASS: Pesan melewati autentikasi SPF.

  • FAIL: Pesan gagal dalam autentikasi SPF.

  • GRAY: Hasil SPF adalahnone,softfail, atauneutral.

  • PROCESSING_FAILED: Terdapat masalah yang mencegah Amazon SES memeriksa catatan SPF. Sebagai contoh, kueri DNS mengalami kegagalan.

Objek virusVerdict

Objek virusVerdict berisi bidang-bidang berikut.

Nama Bidang Deskripsi
status

String yang berisi hasil pemindaian virus. Kemungkinan nilai adalah:

  • PASS: Pesan tidak berisi virus.

  • FAIL: Pesan berisi virus.

  • GRAY: Amazon SES memindai email tetapi tidak bisa menentukan dengan jelas apakah pesan berisi virus.

  • PROCESSING_FAILED: Amazon SES tidak dapat memindai isi email. Sebagai contoh, email bukan pesan MIME yang valid.

objek surat

Objek mail berisi bidang-bidang berikut.

Nama Bidang Deskripsi
destination

Daftar lengkap untuk semua penerima alamat (termasuk penerima Kepada: dan CC:) dari header email MIME yang masuk.
messageId

String yang berisi ID unik yang ditetapkan ke email oleh Amazon SES. Jika email dikirim ke Amazon S3, ID pesan juga merupakan kunci objek Amazon S3 yang digunakan untuk menulis pesan ke bucket Amazon S3 Anda.
source

String yang berisi alamat email (khususnya, alamat envelope MAIL FROM) tempat email dikirimkan.
timestamp

String yang berisi waktu di mana email diterima, dalam format ISO86 01.
headers

Header Amazon SES dan header kustom Anda. Setiap header memiliki bidang berikut: name danvalue.

commonHeaders

Header umum untuk semua email. Setiap header memiliki bidang berikut: name danvalue.
headersTruncated

Menentukan apakah header dipotong dalam notifikasi, yang terjadi jika header lebih besar dari 10 KB. Kemungkinan nilai adalah true dan false.

Objek commonHeaders

Objek commonHeaders dapat memiliki bidang yang ditunjukkan dalam tabel berikut. Bidang yang ada dalam objek ini bervariasi tergantung pada bidang yang ada dalam email masuk.

Nama Bidang Deskripsi
messageId

ID dari pesan asli.
date

Tanggal dan waktu ketika Amazon SES menerima pesan.
to

Bagian To header email.
cc

Bagian CC header email.
bcc

Bagian BCC header email.
from

Bagian From header email.
sender

Bagian Sender header email.
returnPath

Bagian Return-Path header email.
replyTo

Bagian Reply-To header email.
subject

Bagian Subject header email.