節省成本並獲得更多功能 AWS Elemental MediaConvert
MediaConvert 是一項較新的檔案型視訊轉碼服務,提供全方位的進階轉碼功能,按需費率從每分鐘 $0.0075 起。閱讀更多
已經使用 Amazon Elastic Transcoder? 遷移到 MediaConvert. 如需詳細資訊,請參閱此概觀
本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
讀取任務
Description (描述)
欲取得任務的詳細資訊,請將 GET 請求傳送到 /2012-09-25/jobs/
資源。jobId
請求
Syntax (語法)
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
請求參數
此操作接受下列請求參數。
- jobId
-
您欲取得詳細資訊之任務的識別碼。
請求標頭
此操作僅使用所有操作常見的請求標頭。如需常見請求標頭的資訊,請參閱 HTTP 標頭內容。
請求主體
此操作沒有請求內文。
回應
Syntax (語法)
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 pixels
xheight 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
" } } }
回應標頭
此操作僅使用大部分回應常見的回應標頭。如需常見回應標頭的資訊,請參閱 HTTP 回應。
回應內文
針對每個滿足搜尋條件的任務,回應本文會包含您建立任務時指定的值。如需任務值的詳細資訊,請參閱您在建立 Elastic Transcoder Job 時指定的設定。
此外,Elastic Transcoder 會返回下列值。
- (自動) Id
-
Elastic Transcoder 分配給作業的標識符。您可使用此值來獲取作業的設定,或刪除作業。
- (自動) Inputs: Detections
-
檢測到的輸入文件屬性。Elastic Transcoder 從輸入文件中識別這些值。
- (自動) Inputs: Width
-
檢測到的輸入文件寬度 (以像素為單位)。
- Height (自動) Inputs: Height
-
檢測到的輸入文件高度 (以像素為單位)。
- (自動) Inputs: FrameRate
輸入文件的檢測到幀速率,以每秒影格數為單位。
- (自動) Inputs: FileSize
檢測到的輸入文件大小 (以位元組為單位)。
- (自動) Inputs: DurationMillis
檢測到的輸入文件持續時間,以毫秒為單位。
- Id (自動) Outputs: Id
-
一個序列計數器,從 1 開始,用於標識當前作業輸出之間的輸出。在 中
Output
語法,這個值永遠是1
。 - (自動) Outputs: Duration
-
輸出文件的持續時間(以秒為單位),向上舍入。
- DurationMillis
-
輸出文件的持續時間,以毫秒為單位。
- (自動) Outputs: Width
-
輸出文件的寬度 (以像素為單位)。
- Height (自動) Outputs: Height
-
輸出文件的高度 (以像素為單位)。
- (自動) Outputs: FrameRate
-
輸出文件的幀速率,以每秒影格數為單位。
- (自動) Outputs: FileSize
-
輸出文件的文件大小 (以位元組為單位)。
- (自動) Outputs: Status
-
作業中一個輸出的狀態。如果只為該作業指定了一個輸出,
Outputs:Status
永遠與Job:Status
。如果指定了多個輸出:Job:Status
和Outputs:Status
對於所有輸出都是Submitted
直到 Elastic Transcoder 開始處理第一個輸出。當 Elastic Transcoder 開始處理第一個輸出時,
Outputs:Status
對於該輸出,Job:Status
兩者皆是將變更為Progressing
。對於每個輸出,Outputs:Status
遺跡Submitted
直到 Elastic Transcoder 開始處理輸出。Job:Status
遺跡Progressing
直到所有輸出達到終端狀態,Complete
或者Error
。當所有輸出都達到終端狀態時,
Job:Status
對的變更Complete
僅適用於Outputs:Status
對於所有輸出都是Complete
。如果Outputs:Status
對於一或多個輸出,Error
,終端狀態Job:Status
也是Error
。
的值
Status
是下列其中一項:Submitted
、Progressing
、Complete
、Canceled
, 或Error
。 - (自動) Outputs: Status
-
進一步解釋的信息
Outputs:Status
。 - (自動) Outputs: AppliedColorSpaceCottings
-
如果 Elastic Transcoder 使用了具有
ColorSpaceConversionMode
來轉碼輸出文件,AppliedColorSpaceConversion
參數顯示了所使用的轉換。如果沒有ColorSpaceConversionMode
在預設中定義,則此參數將不會包含在作業響應中。 - (自動) Status
-
如果為作業指定了多個輸出,則表示整個作業的狀態。當 Elastic Transcoder 開始處理作業時,
Job:Status
對的變更Progressing
並且在 Elastic Transcoder 完成處理所有輸出之前不會更改。處理完成後,Job:Status
更改為Complete
或者,如果任何輸出失敗,Error
。如果只為該作業指定了一個輸出,
Job:Status
相同的Outputs:Status
。的值
Job:Status
是下列其中一項:Submitted
、Progressing
、Complete
、Canceled
, 或Error
。 - (自動) Timing
-
有關作業時間的詳細信息。
- (自動) Timing: SubmitTimeMillis
-
作業提交給 Elastic Transcoder 的時間,以紀元毫秒為單位。
- (自動) Timing: StartTimeMillis
-
作業開始轉碼的時間,以紀元毫秒為單位。
- (自動) Timing: FinishTimeMillis
-
作業完成轉碼的時間,以紀元毫秒為單位。
若要進一步了解紀元時間,請參Epoch
頁面。
錯誤
有關 Elastic Transcoder 例外和錯誤消息的信息,請參處理 Elastic Transcoder 中的錯誤。
範例
請求範例
下列示例請求會獲取任務 ID 為 333333333333333333-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
回應範例
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" } } }