Pemberitahuan Status Job

Elastic Transcoder dapat memberi tahu Anda ketika status pekerjaan berubah. Anda dapat mengonfigurasi Elastic Transcoder untuk mengirimi Anda pemberitahuan untuk kombinasi apa pun (atau tidak ada) dari perubahan status berikut:

• Kemajuan: Elastic Transcoder telah mulai memproses pekerjaan di dalam pipa.

• Selesai: Elastic Transcoder telah selesai memproses pekerjaan di dalam pipa.

• Peringatan: Elastic Transcoder mengalami kondisi peringatan saat memproses pekerjaan di dalam pipa.

• Kesalahan: Elastic Transcoder mengalami kondisi kesalahan saat memproses pekerjaan di pipeline.

Elastic Transcoder mengirimkan notifikasi dengan menggunakan Amazon Simple Notification Service (Amazon SNS). Amazon SNS menawarkan berbagai opsi notifikasi, termasuk kemampuan untuk mengirim pesan ke titik akhir HTTP, alamat email, dan antrian Amazon Simple Queue Service (Amazon SQS). Untuk informasi selengkapnya tentang opsi ini dan lainnya, lihat Panduan Pengembang Layanan Pemberitahuan Sederhana Amazon.

Notifikasi berguna untuk merancang aplikasi berbasis-peristiwa. Jika Anda menggunakan notifikasi untuk menentukan kapan pekerjaan telah selesai, Anda dapat menghilangkan polling, dan Anda tidak akan menemukan Limit Exceeded pengecualian (kode status HTTP 429) yang terkadang dihasilkan dari polling.

Anda mengonfigurasi notifikasi saat membuat atau memperbarui pipeline. Untuk setiap pekerjaan yang Anda kirimkan ke pipeline tersebut, Elastic Transcoder mengirimkan notifikasi terkait.

penting

Saat Anda mengubah notifikasi, perubahan Anda akan segera berlaku. Pekerjaan yang telah Anda kirimkan dan Elastic Transcoder belum mulai diproses akan terpengaruh selain pekerjaan yang Anda kirimkan setelah Anda mengubah pemberitahuan.

Untuk mengonfigurasi Elastic Transcoder untuk memberi tahu Anda tentang perubahan status pekerjaan saat Anda menggunakan Elastic Transcoder API:

1. Buat satu atau lebih topik Amazon SNS, dan berlangganan setiap topik. Untuk informasi selengkapnya, lihat dokumentasi Amazon Simple Notification Service.

   Jika Anda sudah memiliki topik Amazon SNS yang ingin Anda gunakan, Anda dapat melewati langkah ini.

2. Buat pipeline atau perbarui pipeline yang ada. Untuk setiap perubahan status yang Anda inginkan notifikasi (Progress, Complete, Warning, Error), tentukan topik Amazon SNS yang berlaku yang Anda buat di Langkah 1. Untuk informasi selengkapnya, lihat Membuat Saluran, Perbarui Pipeline, atau Perbarui Pemberitahuan Pipeline.

3. Uji notifikasi Progressing dan Complete status dengan mengirimkan pekerjaan ke Elastic Transcoder.

Anda juga dapat menggunakan konsol Elastic Transcoder untuk mengonfigurasi notifikasi. Jika menggunakan konsol, Anda dapat membuat topik Amazon SNS saat membuat atau memperbarui pipeline. Namun, Anda masih perlu menggunakan konsol Amazon SNS, API, atau CLI untuk berlangganan topik baru.

Ketika Elastic Transcoder mengirimi Anda pemberitahuan perubahan status, pesan yang dikembalikan dalam notifikasi dalam format JSON berikut. Perhatikan bahwa pesan menyertakan status untuk setiap output serta status untuk pekerjaan:

{
   "state" : "PROGRESSING|COMPLETED|WARNING|ERROR",
   "errorCode" : "the code of any error that occurred",
   "messageDetails" : "the notification message you created in Amazon SNS",
   "version" : "API version that you used to create the job",
   "jobId" : "value of Job:Id object that Elastic Transcoder 
             returns in the response to a Create Job request",
   "pipelineId" : "value of PipelineId object 
                  in the Create Job request",
   "input" : {
      job Input settings
   },
   "outputKeyPrefix" : "prefix for file names in Amazon S3 bucket",
   "outputs": [
      {
         applicable job Outputs settings,
         "status" : "Progressing|Complete|Warning|Error"
      },
      {...}
   ],
   "playlists": [
      {
         applicable job playlists settings
      }
   ],
   "userMetadata": {
      "metadata key": "metadata value"
   }
}