Membuat Permintaan HTTP ke Elastic Transcoder - Amazon Elastic Transcoder
Konten Header HTTPIsi PermintaanRespons HTTP

Hemat biaya dan dapatkan lebih banyak fitur dengan AWS Elemental MediaConvert

MediaConvert adalah layanan transcoding video berbasis file yang lebih baru yang menyediakan rangkaian lengkap fitur transcoding canggih, dengan tarif sesuai permintaan mulai dari $0,0075/menit. Baca lebih lanjut.

Sudah menggunakan Amazon Elastic Transcoder? Sangat mudah untuk bermigrasi ke MediaConvert. Untuk informasi selengkapnya, lihat ikhtisar ini yang mencakup informasi berharga tentang proses migrasi dan tautan ke sumber daya tambahan.

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

Membuat Permintaan HTTP ke Elastic Transcoder

Permintaan EST adalah permintaan HTTPS seperti yang didefinisikan dalam RFC 2616. (Untuk informasi selengkapnya, bukahttp://www.ietf.org/rfc/rfc2616.txt.) Bagian ini menjelaskan struktur permintaan EST Elastic Transcoder. Untuk deskripsi rinci tentang tindakan yang dapat Anda lakukan, lihatOperasi Pipeline,Operasi Tugas, danOperasi prasetel.

Tindakan REST khas terdiri dari mengirim permintaan HTTPS ke Elastic Transcoder dan menunggu respons. Seperti permintaan HTTP, permintaan REST untuk Elastic Transcoder berisi metode permintaan, URI, header permintaan, dan kadang-kadang string kueri atau badan permintaan. Respon berisi kode status HTTP, header respons, dan terkadang badan respons.

Konten Header HTTP

Elastic Transcoder membutuhkan informasi berikut di header permintaan HTTP:

Host (Diperlukan)

Endpoint Elastic Transcoder yang menentukan di mana sumber daya Anda dibuat. Nilai harus berupa endpoint regional bernama. Kami menyarankan Anda menggunakan endpoint yang sama untuk bucket Amazon S3 Anda dan untuk saluran dan pekerjaan Elastic Transcoder Anda. Jika Anda menggunakan titik akhir yang berbeda, Anda akan dikenakan biaya tambahan untuk data yang ditransfer antara wilayah yang berisi bucket Amazon S3 Anda dan wilayah tempat Elastic Transcoder melakukan pengkodean. Selain itu, waktu yang diperlukan untuk transfer data akan menunda akses ke file transcoded.

Untuk daftar endpoint Elastic Transcoder yang didukung, bukaWilayah dan Titik Akhirbagian dalamReferensi Umum Amazon Web Services.

Untuk informasi selengkapnya tentang biaya lintas daerah, lihat Harga Transfer Data diHarga Amazon S3.

x-amz-date atau Tanggal (Diperlukan)

Tanggal yang digunakan untuk membuat tanda tangan yang terdapat dalamAuthorizationheader. Tentukan tanggal dalam format standar ISO 8601, dalam waktu UTC, seperti pada contoh berikut:X-Amz-Date: 20130613T203622Z.

Anda harus menyertakan x-amz-date atau Date. (Beberapa pustaka klien tidak mengizinkan Anda mengaturDateheader). Saat header x-amz-date ada, sistem mengabaikan header Date saat mengautentikasi permintaan.

Cap waktu harus dalam waktu 15 menit dari waktu sistem AWS saat permintaan tersebut diterima. Jika tidak, permintaan gagal denganRequestExpiredkode kesalahan untuk mencegah orang lain memutar ulang permintaan Anda.

Otorisasi (Diperlukan)

Informasi yang diperlukan untuk otentikasi permintaan. Untuk informasi selengkapnya tentang cara membuat header ini, lihatMenandatangani Permintaan.

Tipe Konten (Bersyarat)

Menentukan JSON dan versi, misalnya,Content-Type: application/x-amz-json-1.0.

Kondisi: Diperlukan untuk permintaan POST.

Panjang Konten (Bersyarat)

Panjang pesan (tanpa header) menurut RFC 2616.

Kondisi: Diperlukan jika badan permintaan itu sendiri berisi informasi (kebanyakan toolkit menambahkan header ini secara otomatis).

Berikut ini adalah contoh header untuk permintaan HTTP untuk membuat pipeline.

POST /2012-09-25/pipelines HTTP/1.1
host: elastictranscoder.us-east-1.amazonaws.com:443
x-amz-date: 20120116T174952Z
Authorization: AWS4-HMAC-SHA256 Credential=AccessKeyID/20120116/us-east-1/elastictranscoder/aws4_request,SignedHeaders=host;x-amz-date;x-amz-target,Signature=145b1567ab3c50d929412f28f52c45dbf1e63ec5c66023d232a539a4afd11fd9
content-type: application/x-amz-json-1.0
content-length: 231
connection: Keep-Alive

Isi Permintaan

Banyak tindakan Elastic Transcoder mengharuskan Anda untuk menyertakan data yang diformat JSON. JSON sesuai dengan skema Elastic Transcoder.

catatan

Nilai JSON dalam isi permintaan adalah string.

contoh Permintaan

Contoh permintaan berikut menggunakan pernyataan JSON sederhana untuk membuat pekerjaan yang transcodes file bernamasample.mp4dan menyimpannya sebagaisams-birthday.mp4.

POST /2012-09-25/jobs HTTP/1.1
Content-Type: application/json; charset=UTF-8
Accept: */*
Host: elastictranscoder.us-east-1.amazonaws.com:443
Content-Length: 300
 
{
   "Input":{
      "Key":"sample.mp4",
      "FrameRate":"auto",
      "Resolution":"auto",
      "AspectRatio":"auto",
      "Interlaced":"auto",
      "Container":"mp4"
   },
   "OutputKeyPrefix":"family-videos/",
   "Outputs":[
      {
         "Key":"sams-birthday.mp4",
         "ThumbnailPattern":"thumbnails/sams-birthday-{count}",
         "Rotate":"0",
         "PresetId":"1351620000000-100080"
      }
   ],
   "PipelineId":"1111111111111-abcde1"
}

Respons HTTP

Semua tindakan API Elastic Transcoder mencakup data yang diformat JSON dalam respons. JSON sesuai dengan skema Elastic Transcoder.

catatan

Nilai JSON dalam respon adalah string.

Berikut adalah beberapa header penting dalam respons HTTP dan bagaimana Anda harus menanganinya dalam aplikasi Anda, jika berlaku:

HTTP/1.1

Header ini diikuti dengan kode status. Kode status200menunjukkan operasi yang berhasil. Untuk informasi tentang kode kesalahan, lihatKode Kesalahan API (Kesalahan Klien dan Server).

Jenis: String

X-AMZN-permintaan

Sebuah nilai yang dibuat oleh Elastic Transcoder yang secara unik mengidentifikasi permintaan Anda, misalnya, K2QH8DNOU907N97FNA2GDLL8OBV4KQNSO5AEMVJF66Q9ASUAAJG. Jika Anda memiliki masalah dengan Elastic Transcoder, AWS dapat menggunakan nilai ini untuk mengatasi masalah. Kami menyarankan Anda untuk mencatat nilai-nilai ini.

Jenis: String

Panjang Konten

Panjang respons dalam byte.

Jenis: String

Tanggal

Tanggal dan waktu yang direspons Elastic Transcoder, misalnya,Sun, 25 Mar 2012 12:00:00 GMT. Format tanggal harus salah satu dari format tanggal penuh yang ditentukan oleh RFC 2616, bagian 3.3.

Jenis: String