다음을 통해 비용을 절감하고 더 많은 기능을 이용할 수 있습니다. AWS Elemental MediaConvert
MediaConvert 는 포괄적인 고급 트랜스코딩 기능을 제공하는 최신 파일 기반 비디오 트랜스코딩 서비스로, 온디맨드 요금은 분당 0.0075달러부터 시작합니다. 자세한 내용을 읽어보세요
이미 Amazon Elastic Transcoder를 사용하고 계신가요? MediaConvert마이그레이션하는 방법은 간단합니다. 자세한 내용은 마이그레이션 프로세스에 대한 중요한 정보와 추가 리소스 링크가 포함된 이 개요
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
작업 읽기
설명
작업에 대한 세부 정보를 확인하려면 /2012-09-25/jobs/ 리소스에 GET 요청을 보냅니다.jobId
요청
조건
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 헤더 콘텐츠 섹션을 참조하세요.
요청 본문
이 작업에는 요청 본문이 없습니다.
응답
조건
Status: 200 OK x-amzn-RequestId: c321ec43-378e-11e2-8e4c-4d5b971203e9 Content-Type: application/json Content-Length:number of characters in the responseDate: 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" } } }
응답 헤더
이 작업은 대부분의 응답에 일반적인 응답 헤더만 사용합니다. 일반적인 응답 헤더에 대한 내용은 HTTP 응답 섹션을 참조하세요.
응답 본문
검색 조건을 만족하는 각 작업에 대해 응답 본문에는 작업을 만들 때 지정한 값이 포함됩니다. 작업 값에 대한 자세한 내용은 Elastic Transcoder 작업을 만들 때 지정하는 설정 섹션을 참조하세요.
또한 Elastic Transcoder는 다음 값을 반환합니다.
- (자동) Id
-
Elastic Transcoder가 작업에 할당한 식별자입니다. 이 값을 사용하여 작업의 설정을 가져오거나 작업을 삭제합니다.
- (자동) Inputs:DetectedProperties
-
입력 파일의 감지된 속성입니다. Elastic Transcoder는 입력 파일에서 이러한 값을 식별합니다.
- (자동) Inputs:Width
-
입력 파일의 감지된 너비(픽셀 단위)입니다.
- (자동) Inputs:Height
-
입력 파일의 감지된 높이(픽셀 단위)입니다.
- (자동) Inputs:FrameRate
입력 파일의 감지된 프레임 속도(초당 프레임 수)입니다.
- (자동) Inputs:FileSize
입력 파일의 감지된 크기(바이트)입니다.
- (자동) Inputs:DurationMillis
입력 파일의 감지된 지속 시간(밀리초)입니다.
- (자동) Outputs:Id
-
현재 작업의 출력 중에서 출력을 식별하는 1부터 시작하는 순차 카운터.
Output구문에서 이 값은 항상1입니다. - (자동) Outputs:Duration
-
출력 파일의 지속 시간(초)으로, 반올림됩니다.
- (자동) Outputs:DurationMillis
-
출력 파일의 기간(밀리초)입니다.
- (자동) Outputs:Width
-
출력 파일의 너비(픽셀)입니다.
- (자동) Outputs:Height
-
출력 파일의 높이(픽셀)입니다.
- (자동) Outputs:FrameRate
-
출력 파일의 프레임 속도(초당 프레임 수)입니다.
- (자동) Outputs:FileSize
-
출력 파일의 파일 크기(바이트)입니다.
- (자동) Outputs:Status
-
작업 내 단일 출력의 상태입니다. 작업에 지정한 출력이 하나뿐일 경우
Outputs:Status는 항상Job:Status와 동일합니다. 여러 개의 출력을 지정한 경우:Elastic Transcoder가 첫 번째 출력을 처리하기 시작할 때까지 모든 출력의
Job:Status및Outputs:Status는Submitted입니다.Elastic Transcoder가 첫 번째 출력을 처리하기 시작하면 해당 출력의
Outputs:Status와Job:Status가 모두Progressing으로 바뀝니다. 각 출력에서Outputs:Status값은 Elastic Transcoder가 해당 출력을 처리하기 시작할 때까지Submitted를 유지합니다.모든 출력이 최종 상태(
Job:Status또는Progressing)에 도달할 때까지Complete는Error을 유지합니다.모든 출력이 최종 상태에 도달하면 모든 출력의
Job:Status가Complete인 경우에만Outputs:Status가Complete로 바뀝니다. 하나 이상의 출력에서Outputs:Status가Error일 경우Job:Status의 최종 상태도Error입니다.
Status값은 다음 중 하나입니다.Submitted,Progressing,Complete,Canceled또는Error. - (자동) Outputs:StatusDetail
-
Outputs:Status를 더 자세히 설명하는 정보입니다. - (자동) Outputs:AppliedColorSpaceConversion
-
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에 제출된 시간(epoch 밀리초)입니다.
- (자동) Timing:StartTimeMillis
-
작업이 트랜스코딩을 시작한 시간(epoch 밀리초)입니다.
- (자동) Timing:FinishTimeMillis
-
작업이 트랜스코팅을 마친 시간(epoch 밀리초).
epoch 시간에 대한 자세한 내용은 Wikipedia의 Epoch Computing
페이지를 참조하세요.
오류
Elastic Transcoder 예외 및 오류 메시지에 대한 자세한 내용은 Elastic Transcoder에서의 오류 처리 섹션을 참조하세요.
예시
예제 요청
다음 예제 요청은 작업 ID가 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
샘플 응답
Status: 200 OK x-amzn-RequestId: c321ec43-378e-11e2-8e4c-4d5b971203e9 Content-Type: application/json Content-Length:number of characters in the responseDate: 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" } } }
