Deskripsi Permintaan Respons Kesalahan Contoh

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.

Mencantumkan Pekerjaan berdasarkan Status

Deskripsi

Untuk mendapatkan daftar pekerjaan yang memiliki status tertentu, kirim permintaan GET ke/2012-09-25/jobsByStatus/Submittedsumber daya. Elastic Transcoder daftar pekerjaan yang telah Anda buat baru-baru ini dan yang saat ini memiliki status yang ditentukan.

Permintaan

Sintaksis

Untuk mendapatkan informasi tentang pekerjaan senilai enam bulan terakhir yang terkait dengan akun AWS saat ini yang memiliki status tertentu, kirimkan permintaan GET berikut.


GET /2012-09-25/jobsByStatus/Status?
Ascending=true|false&
PageToken=value for accessing the next page of results HTTP/1.1
Content-Type: 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

Parameter Permintaan

Operasi ini membutuhkan parameter permintaan berikut. Elastic Transcoder mengembalikan semua pekerjaan dari enam bulan terakhir yang memiliki status tertentu.

Status: Untuk mendapatkan informasi tentang semua pekerjaan dari enam bulan terakhir yang terkait dengan akun AWS saat ini yang memiliki status tertentu, tentukan statusnya:Submitted,Progressing,Complete,Canceled, atauError.
Menaik: Untuk daftar pekerjaan dalam urutan kronologis berdasarkan tanggal dan waktu yang mereka ajukan, masukkantrue. Untuk daftar tugas dalam urutan kronologis terbalik, masukkanfalse.
PageToken: Ketika Elastic Transcoder mengembalikan lebih dari satu halaman hasil, gunakanPageTokenselanjutnyaGETpermintaan untuk mendapatkan setiap halaman berturut-turut hasil.

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

Operasi ini tidak menggunakan isi permintaan.

Respons

Sintaksis


Status: 200 OK
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

{
   "Jobs":[
      {
         "Id":"Id that Elastic Transcoder assigned to the job",
         "Inputs":[{
            "Key":"name of the file to transcode",
            "Encryption":{
               "Mode":"aes-cbc-pkcs7|aes-ctr|aes-gcm",
               "Key":"encrypted and base64-encoded decryption key",
               "KeyMd5":"base64-encoded key digest",
               "InitializationVector":"base64-encoded initialization vector"
            },
            "TimeSpan":{
               "StartTime":"starting place of the clip, in
                  HH:mm:ss.SSS or sssss.SSS",
               "Duration":"duration of the clip, in HH:mm:ss.SSS
                  or sssss.SSS"
            },
            "FrameRate":"auto|10|15|23.97|24|25|29.97|30|50|60",
            "Resolution":"auto|width in pixelsxheight in pixels",
            "AspectRatio":"auto|1:1|4:3|3:2|16:9",
            "Interlaced":"auto|true|false",
            "Container":"auto|aac|asf|avi|divx|flv|m4a|mkv|mov|mp2|mp3|
               mp4|mpeg|mpeg-ps|mpeg-ts|mxf|ogg|vob|wav|webm",
            "DetectedProperties":{
               "Width":"video width in pixels",
               "Height":"video height in pixels",        
               "FrameRate":"video frame rate in fps",
               "FileSize":"file size in bytes",
               "DurationMillis":"file duration in milliseconds"
            },
            "InputCaptions":{
   	       "MergePolicy":"MergeOverride|MergeRetain|Override",
               "CaptionSources":[
                  {
                     "Key":"name of the input caption file",
                     "Language":"language of the input caption file",
                     "TimeOffset":"starting place of the captions, in
                        either [-+]SS.sss or [-+]HH:mm:SS.ss",
                     "Label":"label for the caption"
                     "Encryption":{
                        "Mode":"aes-cbc-pkcs7|aes-ctr|aes-gcm",
                        "Key":"encrypted and base64-encoded decryption key",
                        "KeyMd5":"base64-encoded key digest",
                        "InitializationVector":"base64-encoded initialization 
                           vector"
                     },
                  },
                  {...}
               ]
            }
         },
      {...}],
      "OutputKeyPrefix":"prefix for file names in Amazon S3 bucket",
      "Outputs":[{
            "Id":"sequential counter",
            "Key":"name of the transcoded file",
            "Encryption":{
               "Mode":"s3||aes-cbc-pkcs7|aes-ctr|
                  aes-gcm",
               "Key":"encrypted and base64-encoded encryption key",
               "KeyMd5":"base64-encoded key digest",
               "InitializationVector":"base64-encoded initialization vector"           
            },
            "ThumbnailPattern":""|"pattern",
            "Rotate":"auto|0|90|180|270",
            "PresetId":"preset to use for the job",
            "SegmentDuration":"[1,60]",
            "Watermarks":[
               {
                  "InputKey":"name of the .png or .jpg file",
                  "Encryption":{
                     "Mode":"s3||aes-cbc-pkcs7|
                        aes-ctr|aes-gcm",
                     "Key":"encrypted and base64-encoded encryption key",
                     "KeyMd5":"base64-encoded key digest",
                     "InitializationVector":"base64-encoded initialization 
                        vector"
                  },
                  "PresetWatermarkId":"value of Video:Watermarks:Id in 
                     preset"
               },
               {...}
            ],
            "AlbumArt":[
               {
                  "AlbumArtMerge":"Replace|Prepend|Append|Fallback",
                  "AlbumArtArtwork":"can be empty, but not null":[
                     {
                        "AlbumArtInputKey":"name of the file to use as album 
                           art",
                        "Encryption":{
                           "Mode":"s3||aes-cbc-pkcs7|
                              aes-ctr|aes-gcm",
                           "Key":"encrypted and base64-encoded encryption key",
                           "KeyMd5":"base64-encoded key digest",
                           "InitializationVector":"base64-encoded
                              initialization vector"
                        },
                        "AlbumArtMaxWidth":"maximum width of output album art
                           in pixels",
                        "AlbumArtMaxHeight":"maximum height of output album
                           art in pixels",
                        "AlbumArtSizingPolicy":"Fit|Fill|Stretch|Keep|
                           ShrinkToFit|ShrinkToFill",
                        "AlbumArtPaddingPolicy":"Pad|NoPad",
                        "AlbumArtFormat":"jpg|png"
                     },
                     {...}
                  ]
            },
            {...}], 
            "Duration":"duration in seconds",
            "DurationMillis":"duration in milliseconds",
            "Height":"height in pixels",
            "Width":"width in pixels",
            "FrameRate":"frame rate in fps",
            "FileSize":"file size in bytes",
            "Status":"Submitted|In Progress|Complete|Error",
            "StatusDetail":"detail associated with Status",
            "Captions":{
               "CaptionFormats":[
                  {
                     "Format":"cea-708|dfxp|mov-text|scc|srt|webvtt",
                     "Pattern":"myCaption/file-language",
                     "Encryption":{
                        "Mode":"s3||aes-cbc-pkcs7|
                           aes-ctr|aes-gcm",
                        "Key":"encrypted and base64-encoded encryption key",
                        "KeyMd5":"base64-encoded key digest",
                        "InitializationVector":"base64-encoded 
                           initialization vector"
                     }
                  },
                  {...}
               ]
            },
            "AppliedColorSpaceConversion":"None|Bt601ToBt709|
                  Bt709ToBt601"
         },
         {...}
      ],
      "Playlists":[
         {
            "Format":"HLSv3|HLSv4|MPEG-DASH|Smooth",
            "Name":"name",
            "OutputKeys":[
               "Outputs:Key to include in this playlist",
               {...}
            ],
            "HlsContentProtection":{
                "Method":"aes-128",
                "Key":"encrypted and base64-encoded protection key",
                "KeyMd5":"base64-encoded key digest",
                "InitializationVector":"base64-encoded
                   initialization vector",
                "LicenseAcquisitionUrl":"license acquisition url",
                "KeyStoragePolicy":"NoStore|WithVariantPlaylists"
            },
            "PlayReadyDrm":{
                "Format":"microsoft|discretix-3.0",
                "Key":"encrypted and base64-encoded DRM key",
                "KeyId":"id of the DRM key",
                "KeyMd5":"base64-encoded key digest",
                "InitializationVector":"base64-encoded
                   initialization vector",
                "LicenseAcquisitionUrl":"license acquisition url"
               }
            },
            {...}
         ],
         "UserMetadata":
            {
                "Key":"Value",
                "Second user metadata key":"Second user metadata value"
            },
         "PipelineId":"PipelineId for the job",
         "Status":"Submitted|Progressing|Complete|Canceled|Error",
         "Timing":{
            "SubmitTimeMillis":"job submitted time in epoch milliseconds",
            "StartTimeMillis":"job start time in epoch milliseconds",
            "FinishTimeMillis":"job finish time in epoch milliseconds"
         }
      },
      {...}
   ],
   "NextPageToken":value for accessing the next page of results|null
}

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

Badan respon berisi satu elemen untuk setiap pekerjaan yang memenuhi kriteria pencarian, dan setiap elemen berisi nilai yang Anda tentukan saat Anda membuat pekerjaan. Untuk informasi selengkapnya tentang nilai tugas, lihatPengaturan yang Anda Tentukan Saat Membuat Pekerjaan Transcoder Elastis.

Selain itu, Elastic Transcoder mengembalikan nilai berikut.

(Otomatis) Id

Pengenal bahwa Elastic Transcoder ditugaskan untuk pekerjaan. Anda menggunakan nilai ini untuk mendapatkan pengaturan untuk pekerjaan atau untuk menghapus pekerjaan.

(Otomatis) input:DetectedProperties

Sifat berkas input yang terdeteksi. Elastic Transcoder mengidentifikasi nilai-nilai ini dari file input.

(Otomatis) Input: Lebar

Lebar berkas input yang terdeteksi, dalam piksel.

(Otomatis) Input: Tinggi

Ketinggian terdeteksi dari file input, dalam piksel.

(Otomatis) Input: Framerate

Frame rate terdeteksi dari file input, dalam frame per detik.

(Otomatis) Input: FileSize

Ukuran berkas yang terdeteksi dari berkas input, dalam byte.

(Otomatis) Input: DurationMillis

Durasi terdeteksi dari file input, dalam milidetik.

(Otomatis) Output: Id

Penghitung berurutan, dimulai dengan 1, yang mengidentifikasi output di antara output dari pekerjaan saat ini. DiOutputsintaks, nilai ini selalu1.

(Otomatis) Output: Durasi

Durasi file output dalam hitungan detik, dibulatkan.

(Otomatis) Output: DurationMillis

Durasi file output, dalam milidetik.

(Otomatis) Output: Lebar

Lebar berkas output, dalam piksel.

(Otomatis) Output: Tinggi

Ketinggian file output, dalam piksel.

(Otomatis) Output: Framerate

Frame rate dari file output, dalam frame per detik.

(Otomatis) Output: FileSize

Ukuran file output, dalam byte.

(Otomatis) Output: Status

Status satu output dalam pekerjaan. Jika Anda menentukan hanya satu output untuk pekerjaan itu,Outputs:Statusselalu sama denganJob:Status. Jika Anda menentukan lebih dari satu output:

Job:StatusdanOutputs:Statusuntuk semua output adalahSubmittedsampai Elastic Transcoder mulai memproses output pertama.
Ketika Elastic Transcoder mulai memproses output pertama,Outputs:Statusuntuk output itu danJob:Statuskeduanya berubah menjadiProgressing. Untuk setiap output, nilaiOutputs:StatussisaSubmittedsampai Elastic Transcoder mulai memproses output.
Job:StatussisaProgressingsampai semua output mencapai status terminal, baikCompleteatauError.
Ketika semua output mencapai status terminal,Job:StatusperubahanCompletehanya jikaOutputs:Statusuntuk semua output adalahComplete. JikaOutputs:Statusuntuk satu atau lebih outputError, status terminal untukJob:StatusjugaError.

Nilai dariStatusadalah salah satu dari berikut:Submitted,Progressing,Complete,Canceled, atauError.

(Otomatis) Output: StatusDetail

Informasi yang lebih lanjut menjelaskanOutputs:Status.

(Otomatis) Output: AppliedColorSpaceConversion

Jika Elastic Transcoder menggunakan preset denganColorSpaceConversionModeuntuk transcode file output, yangAppliedColorSpaceConversionparameter menunjukkan konversi yang digunakan. Jika tidak adaColorSpaceConversionModedidefinisikan dalam preset, parameter ini tidak akan dimasukkan dalam respon pekerjaan.

Status (Otomatis)

Jika Anda menentukan lebih dari satu output untuk pekerjaan, status seluruh pekerjaan. Ketika Elastic Transcoder mulai memproses pekerjaan, nilaiJob:StatusperubahanProgressingdan tidak berubah sampai Elastic Transcoder telah selesai memproses semua output. Saat pemrosesan selesai,Job:Statusperubahan baik keCompleteatau, jika salah satu output gagal, untukError.

Jika Anda menentukan hanya satu output untuk pekerjaan itu,Job:Statussama denganOutputs:Status.

Nilai dariJob:Statusadalah salah satu dari berikut:Submitted,Progressing,Complete,Canceled, atauError.

(Otomatis) Waktu

Detail tentang waktu pekerjaan.

(Otomatis) Timing: SubmitTimeMillis

Waktu pekerjaan diserahkan ke Elastic Transcoder, dalam milidetik zaman.

(Otomatis) Waktu: StartTimeMillis

Waktu pekerjaan mulai transcoding, dalam milidetik zaman.

(Otomatis) Waktu: FinishTimeMillis

Waktu pekerjaan selesai transcoding, dalam milidetik zaman.

Untuk mempelajari lebih lanjut tentang waktu zaman, pergi keKomputasi Epochhalaman di Wikipedia.

(Otomatis) BerikutnyaPageToken

Nilai yang Anda gunakan untuk mengakses halaman kedua dan selanjutnya dari hasil, jika ada. Ketika pekerjaan di pipa yang ditentukan sesuai pada satu halaman atau ketika Anda telah mencapai halaman terakhir dari hasil, nilaiNextPageTokenadalahnull.

Kesalahan

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

Contoh

Contoh permintaan berikut menciptakan pekerjaan.

Contoh Permintaan

Contoh permintaan berikut mendapat daftar semua pekerjaan yang Anda buat dalam enam bulan terakhir yang memiliki statusComplete.


GET /2012-09-25/jobsByStatus/Complete?Ascending=true HTTP/1.1
Content-Type: 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

Contoh Respons


Status: 200 OK
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

{
   "Jobs":[
      {
         "Id":"3333333333333-abcde3",
         "Input":[{
            "Key":"cooking/lasagna.mp4",
            "FrameRate":"auto",
            "Resolution":"auto",
            "AspectRatio":"auto",
            "Interlaced":"auto",
            "Container":"mp4",
            "InputCaptions"{
               "MergePolicy":"MergeOverride",
               "CaptionSources":[
                  {
                     "Key":"scc/lasagna-kindlefirehd.scc",
                     "Language":"en",
                     "Label":"English"
                  },
                  {
                     "Key":"srt/lasagna-kindlefirehd.srt",
                     "Language":"fr",
                     "TimeOffset":"1:00:00",
                     "Label":"French"
                  }
               ]
            },
            "DetectedProperties":{
               "Width":"1280",
               "Height":"720",
               "FrameRate":"30.00",
               "FileSize":"5872000",
               "DurationMillis":"1003000"
            }
         }],
         "OutputKeyPrefix":"",
         "Outputs":[
            {
               "Id":"1",
               "Key":"mp4/lasagna-kindlefirehd.mp4",
               "ThumbnailPattern":"mp4/thumbnails/lasagna-{count}",
               "Rotate":"0",
               "PresetId":"1351620000000-100080",
               "Watermarks":[
                  {
                     "InputKey":"logo/128x64.png",
                     "PresetWatermarkId":"company logo 128x64",
                  }
               ],
               "Duration":"1003",
               "DurationMillis":"1003000",
               "Width":"1280",
               "Height":"720",
               "FrameRate":"30.00",
               "FileSize":"5872000",
               "Status":"Complete",
               "StatusDetail":"",
               "Captions":{
                  "CaptionFormats":[
                     {
                        "Format":"scc",
                        "Pattern":"scc/lasagna-{language}"
                     },
                     {
                        "Format":"srt",
                        "Pattern":"srt/lasagna-{language}"
                     },
                     {
                        "Format":"mov-text"
                     }
                  ]
               },
               "AppliedColorSpaceConversion":"None"
            },
            {
               "Id":"2",
               "Key":"iphone/lasagna-1024k",
               "ThumbnailPattern":"iphone/th1024k/lasagna-{count}",
               "Rotate":"0",
               "PresetId":"1351620000000-987654",
               "SegmentDuration":"5",
               "Duration":"1003",
               "DurationMillis":"1003000",
               "Width":"1136",
               "Height":"640",
               "FrameRate":"30.00",
               "FileSize":"4718600",
               "Status":"Complete",
               "StatusDetail":""
            },
         ],
         "PipelineId":"1111111111111-abcde1",
         "Playlists":[
            {
               "Format":"HLSv3",
               "Name":"playlist-iPhone-lasagna.m3u8",
               "OutputKeys":[
                  "iphone/lasagna-1024k",
                  "iphone/lasagna-512k"
               ]
            }
         ],
         "Timing":{
               "SubmitTime":"1427212800000",
               "StartTime":"1427212856000",
               "FinishTime":"1427212875000"
         },
         "Status":"Complete"
      },
      {
         "Id":"4444444444444-abcde4",
         "Input":{
            "Key":"cooking/spaghetti.mp4",
            "FrameRate":"auto",
            "Resolution":"auto",
            "AspectRatio":"auto",
            "Interlaced":"auto",
            "Container":"mp4",
            "DetectedProperties":{
               "Width":"1280",
               "Height":"720",
               "FrameRate":"30.00",
               "FileSize":"5872000",
               "DurationMillis":"1003000"
            }
         },
         "Outputs":[
            {
               "Id":"3",
               "Key":"iphone/spaghetti-512k",
               "ThumbnailPattern":"iphone/th512k/spaghetti-{count}",
               "Rotate":"0",
               "PresetId":"1351620000000-456789",
               "SegmentDuration":"5",
               "Watermarks":[
                  {
                     "InputKey":"logo/128x64.png",
                     "PresetWatermarkId":"company logo 128x64"
                  }
               ],
               "Duration":"1003",
               "DurationMillis":"1003000",
               "Width":"1136",
               "Height":"640",
               "FrameRate":"30.00",
               "FileSize":"5872000",
               "Status":"Complete",
               "StatusDetail":""
            }
         ],
         "Playlists":[
            {
               "Format":"HLSv3",
               "Name":"playlist-iPhone-spaghetti.m3u8",
               "OutputKeys":[
                  "iphone/spaghetti-512k"
               ]
            }
         ],
         "UserMetadata":
            {
               "Food type":"Italian",
               "Cook book":"recipe notebook"
            },
         "Status":"Complete",
         "Timing":{
            "SubmitTime":"1427212800000",
            "StartTime":"1427212856000",
            "FinishTime":"1427212875000"
         }
      }
   ],
   "NextPageToken":null
}

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Mencantumkan Pekerjaan berdasarkan Pipa

Baca Job