Pemberitahuan akhir dukungan: Pada 13 November 2025, AWS akan menghentikan dukungan untuk Amazon Elastic Transcoder. Setelah 13 November 2025, Anda tidak akan lagi dapat mengakses konsol Elastic Transcoder atau sumber daya Elastic Transcoder.
Untuk informasi lebih lanjut tentang transisi ke AWS Elemental MediaConvert, kunjungi [posting blog](https://aws.amazon.com/blogs/media/how-to-migrate-workflows-from-amazon-elastic-transcoder-to-aws-elemental-mediaconvert/) ini.
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Baca Job
**Topics**
+ [Deskripsi](#get-job-description)
+ [Permintaan](#get-job-requests)
+ [Respons](#get-job-responses)
+ [Kesalahan](#get-job-response-errors)
+ [Contoh](#get-job-examples)
## Deskripsi
Untuk mendapatkan informasi terperinci tentang suatu pekerjaan, kirim permintaan GET ke `/2012-09-25/jobs/jobId` sumber daya.
## Permintaan
### Sintaks
```
GET /2012-09-25/jobs/jobId 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 mengambil parameter permintaan berikut.
**JoBid**
Pengidentifikasi pekerjaan yang ingin Anda dapatkan informasi detailnya.
### Header Permintaan
Operasi ini hanya menggunakan header permintaan yang umum untuk semua operasi. Untuk informasi selengkapnya tentang header permintaan umum, lihat [Konten Header HTTP](making-http-requests.md#http-request-header).
### Isi Permintaan
Operasi ini tidak memiliki isi permintaan.
## Respons
### Sintaks
```
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
{
"Job":{
"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"
}
}
}
```
### Header Respons
Operasi ini hanya menggunakan header respons yang umum untuk sebagian besar respons. Untuk informasi tentang header permintaan umum, lihat [Tanggapan HTTP](making-http-requests.md#http-response-header).
### Isi Respons
Untuk setiap pekerjaan yang memenuhi kriteria pencarian, badan respons berisi nilai yang Anda tentukan saat Anda membuat pekerjaan. Untuk informasi selengkapnya tentang nilai pekerjaan, lihat[Pengaturan yang Anda Tentukan Saat Membuat Pekerjaan Transcoder Elastis](job-settings.md).
Selain itu, Elastic Transcoder mengembalikan nilai-nilai berikut.
**(Otomatis) Id**
Identifier yang Elastic Transcoder ditugaskan untuk pekerjaan. Anda menggunakan nilai ini untuk mendapatkan pengaturan untuk pekerjaan atau untuk menghapus pekerjaan.
**(Otomatis) Input: DetectedProperties**
Properti yang terdeteksi dari file input. Elastic Transcoder mengidentifikasi nilai-nilai ini dari file input.
**(Otomatis) Masukan: Lebar**
Lebar yang terdeteksi dari file input, dalam piksel.
**(Otomatis) Input: Tinggi**
Ketinggian file input yang terdeteksi, dalam piksel.
**(Otomatis) Input: FrameRate**
Frame rate yang terdeteksi dari file input, dalam frame per detik.
**(Otomatis) Input: FileSize**
Ukuran file yang terdeteksi dari file input, dalam byte.
**(Otomatis) Input: DurationMillis**
Durasi file input yang terdeteksi, dalam milidetik.
**(Otomatis) Keluaran: Id**
Penghitung sekuensial, dimulai dengan 1, yang mengidentifikasi output di antara output dari pekerjaan saat ini. Dalam `Output` sintaks, nilai ini selalu`1`.
**(Otomatis) Keluaran: Durasi**
Durasi file output dalam hitungan detik, dibulatkan ke atas.
**(Otomatis) Output: DurationMillis**
Durasi file output, dalam milidetik.
**(Otomatis) Keluaran: Lebar**
Lebar file output, dalam piksel.
**(Otomatis) Keluaran: Tinggi**
Tinggi file output, dalam piksel.
**(Otomatis) Output: FrameRate**
Frame rate dari file output, dalam frame per detik.
**(Otomatis) Output: FileSize**
Ukuran file dari file output, dalam byte.
**(Otomatis) Keluaran: Status**
Status satu output dalam suatu pekerjaan. Jika Anda menentukan hanya satu output untuk pekerjaan `Outputs:Status` itu, selalu sama dengan`Job:Status`. Jika Anda menentukan lebih dari satu output:
+ `Job:Status`dan `Outputs:Status` untuk semua output `Submitted` sampai Elastic Transcoder mulai memproses output pertama.
+ Ketika Elastic Transcoder mulai memproses output pertama`Outputs:Status`, untuk output itu `Job:Status` dan keduanya berubah menjadi. `Progressing` Untuk setiap output, nilai `Outputs:Status` tetap `Submitted` sampai Elastic Transcoder mulai memproses output.
+ `Job:Status`tetap `Progressing` sampai semua output mencapai status terminal, baik `Complete` atau`Error`.
+ Ketika semua output mencapai status terminal, `Job:Status` perubahan `Complete` hanya jika `Outputs:Status` untuk semua output. `Complete` Jika `Outputs:Status` untuk satu atau lebih output adalah`Error`, status terminal untuk `Job:Status` juga`Error`.
Nilai `Status` adalah salah satu dari yang berikut:`Submitted`,`Progressing`,`Complete`,`Canceled`, atau`Error`.
**(Otomatis) Output: StatusDetail**
Informasi yang menjelaskan lebih lanjut`Outputs:Status`.
**(Otomatis) Output: AppliedColorSpaceConversion**
Jika Elastic Transcoder menggunakan preset dengan `ColorSpaceConversionMode` a untuk mentranskode file output, parameter menunjukkan konversi `AppliedColorSpaceConversion` yang digunakan. Jika no `ColorSpaceConversionMode` didefinisikan dalam preset, parameter ini tidak akan disertakan dalam respons pekerjaan.
**Status (Otomatis)**
Jika Anda menentukan lebih dari satu output untuk pekerjaan itu, status seluruh pekerjaan. Ketika Elastic Transcoder mulai memproses pekerjaan, nilai `Job:Status` berubah menjadi dan tidak berubah `Progressing` sampai Elastic Transcoder selesai memproses semua output. Ketika pemrosesan selesai, `Job:Status` perubahan baik ke `Complete` atau, jika salah satu output gagal, ke`Error`.
Jika Anda menentukan hanya satu output untuk pekerjaan `Job:Status` itu, adalah sama dengan`Outputs:Status`.
Nilai `Job:Status` adalah salah satu dari yang berikut:`Submitted`,`Progressing`,`Complete`,`Canceled`, atau`Error`.
**(Otomatis) Pengaturan Waktu**
Detail tentang waktu suatu pekerjaan.
**(Otomatis) Waktu: SubmitTimeMillis**
Waktu pekerjaan diserahkan ke Elastic Transcoder, dalam milidetik epoch.
**(Otomatis) Waktu: StartTimeMillis**
Waktu pekerjaan mulai transcoding, dalam hitungan milidetik.
**(Otomatis) Waktu: FinishTimeMillis**
Waktu pekerjaan selesai transcoding, dalam milidetik epoch.
Untuk mempelajari lebih lanjut tentang epoch time, buka halaman [Epoch Computing](https://en.wikipedia.org/wiki/Epoch_%28reference_date%29#Computing) di Wikipedia.
## Kesalahan
Untuk informasi tentang pengecualian Elastic Transcoder dan pesan kesalahan, lihat. [Kesalahan Penanganan di Elastic Transcoder](error-handling.md)
## Contoh
### Permintaan Sampel
Contoh permintaan berikut mendapatkan pekerjaan yang memiliki ID pekerjaan 3333333333333-abcde3.
```
GET /2012-09-25/jobs/3333333333333-abcde3 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
{
"Job":{
"Id":"3333333333333-abcde3",
"Inputs":[{
"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":"Progressing",
"StatusDetail":"",
"Captions":{
"CaptionFormats":[
{
"Format":"scc",
"Pattern":"scc/lasagna-{language}",
},
{
"Format":"srt",
"Pattern":"srt/lasagna-{language}",
},
{
"Format":"mov-text"
}
]
}
},
{
"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":"Progressing",
"StatusDetail":"",
"AppliedColorSpaceConversion":"None"
},
{
"Id":"3",
"Key":"iphone/lasagna-512k",
"ThumbnailPattern":"iphone/th512k/lasagna-{count}",
"Rotate":"0",
"PresetId":"1351620000000-456789",
"SegmentDuration":"5",
"Duration":"1003",
"DurationMillis":"1003000",
"Width":"1136",
"Height":"640",
"FrameRate":"30.00",
"FileSize":"3508900",
"Status":"Complete",
"StatusDetail":""
}
],
"Playlists":[
{
"Format":"HLSv3",
"Name":"playlist-iPhone-lasagna.m3u8",
"OutputKeys":[
"iphone/lasagna-1024k",
"iphone/lasagna-512k"
]
}
],
"UserMetadata":
{
"Food type":"Italian",
"Cook book":"recipe notebook"
},
"PipelineId":"1111111111111-abcde1",
"Status":"Progressing",
"Timing":{
"SubmitTime":"1427212800000",
"StartTime":"1427212856000",
"FinishTime":"1427212875000"
}
}
}
```