Perbarui Pemberitahuan Pipeline

Deskripsi

Untuk memperbarui notifikasi Amazon Simple Notification Service (Amazon SNS) untuk pipeline, kirim permintaan POST ke/2012-09-25/pipelines/pipelineId/notificationssumber daya.

penting

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

Permintaan

Sintaksis

POST /2012-09-25/pipelines/pipelineId/notifications HTTP/1.1
Content-Type: application/json; charset=UTF-8
Accept: */*
Host: elastictranscoder.Elastic Transcoder endpoint.amazonaws.com:443
x-amz-date: 20130114T174952Z
Authorization: AWS4-HMAC-SHA256 
               Credential=AccessKeyID/request-date/Elastic Transcoder endpoint/elastictranscoder/aws4_request,
               SignedHeaders=host;x-amz-date;x-amz-target,
               Signature=calculated-signature
Content-Length: number of characters in the JSON string
{
   "Id":"pipelineId",
   "Notifications":{
      "Progressing":"SNS topic to notify when
         Elastic Transcoder has started to process the job",
      "Complete":"SNS topic to notify when
         Elastic Transcoder has finished processing the job",
      "Warning":"SNS topic to notify when
      	Elastic Transcoder returns a warning",
      "Error":"SNS topic to notify when
         Elastic Transcoder returns an error"
   }
}

Parameter Permintaan

Operasi ini membutuhkan parameter permintaan berikut.

PipelineID

Pengenal pipa yang ingin Anda ubah pengaturan notifikasi.

Header Permintaan

Operasi ini hanya menggunakan header permintaan yang umum untuk semua operasi. Untuk informasi selengkapnya tentang header permintaan umum, lihat Konten Header HTTP.

Isi Permintaan

String JSON dalam isi permintaan berisi objek berikut.

Id

ID pipa yang ingin Anda perbarui.

Pemberitahuan: Kemajuan

Topik ARN untuk topik Amazon Simple Notification Service (Amazon SNS) yang ingin Anda beri tahu saat Elastic Transcoder mulai memproses pekerjaan di pipeline ini. Ini adalah ARN yang Amazon SNS kembali ketika Anda membuat topik. Untuk informasi lebih lanjut, lihat Buat topik dalam Panduan Developer Amazon Simple Notification Service.

penting

Untuk menerima notifikasi, Anda juga harus berlangganan ke topik baru di konsol Amazon SNS.

Amazon SNS menawarkan berbagai opsi notifikasi, termasuk kemampuan untuk mengirim pesan Amazon SNS ke antrian Amazon Simple Queue Service. Untuk informasi lebih lanjut, lihat Panduan Developer Layanan Notifikasi Sederhana Amazon.

Notifikasi:Lengkap

Topik ARN untuk topik Amazon SNS yang ingin Anda beritahu ketika Elastic Transcoder telah selesai memproses pekerjaan dalam pipa ini. Ini adalah ARN yang Amazon SNS kembali ketika Anda membuat topik.

Pemberitahuan: Peringatan

Topik ARN untuk topik Amazon SNS yang ingin Anda informasikan ketika Elastic Transcoder menemukan kondisi peringatan saat memproses pekerjaan dalam pipa ini. Ini adalah ARN yang Amazon SNS kembali ketika Anda membuat topik.

Notifikasi:Kesalahan

Topik ARN untuk topik Amazon SNS yang ingin Anda informasikan ketika Elastic Transcoder menemukan kondisi kesalahan saat memproses pekerjaan dalam pipa ini. Ini adalah ARN yang Amazon SNS kembali ketika Anda membuat topik.

Respons

Sintaksis

Status: 202 Accepted
x-amzn-RequestId: c321ec43-378e-11e2-8e4c-4d5b971203e9
Content-Type: application/json
Content-Length: number of characters in the response
Date: Mon, 14 Jan 2013 06:01:47 GMT
{
   "Pipeline":{
      "Id":"ID for the new pipeline",
      "Notifications":{
         "Progressing":"SNS topic to notify when Elastic Transcoder has started to process the job",
         "Complete":"SNS topic to notify when Elastic Transcoder has finished processing the job",
         "Warning":"SNS topic to notify when Elastic Transcoder returns a warning",
         "Error":"SNS topic to notify when Elastic Transcoder returns an error"
      }
   }
}

Header Respons

Operasi ini hanya menggunakan header respons yang umum untuk sebagian besar respons. Untuk informasi tentang header permintaan umum, lihat Respons HTTP.

Isi Respons

Ketika Anda memperbarui pemberitahuan untuk pipa, Elastic Transcoder mengembalikan nilai yang Anda tentukan dalam permintaan. Untuk informasi selengkapnya, lihat Isi Permintaan.

Kesalahan

Untuk informasi tentang pengecualian dan pesan kesalahan Elastic Transcoder, lihatPenanganan Kesalahan di Elastic Transcoder.

Contoh

Contoh berikut permintaan update pemberitahuan untuk pipa.

Sampel Permintaan

POST /2012-09-25/pipelines/1111111111111-abcde1/notifications HTTP/1.1
Content-Type: application/json; charset=UTF-8
Accept: */*
Host: elastictranscoder.Elastic Transcoder endpoint.amazonaws.com:443
x-amz-date: 20130114T174952Z
Authorization: AWS4-HMAC-SHA256 
               Credential=AccessKeyID/request-date/Elastic Transcoder endpoint/elastictranscoder/aws4_request,
               SignedHeaders=host;x-amz-date;x-amz-target,
               Signature=calculated-signature
Content-Length: number of characters in the JSON string
{
   "Id":"1111111111111-abcde1",
   "Notifications":{
      "Progressing":"",
      "Complete":"",
      "Warning":"",
      "Error":"arn:aws:sns:us-east-1:111222333444:ETS_Errors"
   }
}

Contoh Respons

Status: 202 Accepted
x-amzn-RequestId: c321ec43-378e-11e2-8e4c-4d5b971203e9
Content-Type: application/json
Content-Length: number of characters in the response
Date: Mon, 14 Jan 2013 06:01:47 GMT

{
   "Id":"1111111111111-abcde1",
   "Notifications":{
      "Progressing":"",
      "Complete":"",
      "Warning":"",
      "Error":"arn:aws:sns:us-east-1:111222333444:ETS_Errors"
   }
}