지원 종료 공지: 2025년 11월 13일에 AWS 는 Amazon Elastic Transcoder에 대한 지원을 중단합니다. 2025년 11월 13일 이후에는 더 이상 Elastic Transcoder 콘솔 또는 Elastic Transcoder 리소스에 액세스할 수 없습니다.
로 전환하는 방법에 대한 자세한 내용은이 [블로그 게시물](https://aws.amazon.com/blogs/media/how-to-migrate-workflows-from-amazon-elastic-transcoder-to-aws-elemental-mediaconvert/)을 AWS Elemental MediaConvert참조하십시오.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 작업 읽기
**Topics**
+ [설명](#get-job-description)
+ [요청](#get-job-requests)
+ [응답](#get-job-responses)
+ [오류](#get-job-response-errors)
+ [예](#get-job-examples)
## 설명
작업에 대한 세부 정보를 확인하려면 `/2012-09-25/jobs/jobId` 리소스에 GET 요청을 보냅니다.
## 요청
### 구문
```
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 헤더 콘텐츠](making-http-requests.md#http-request-header) 섹션을 참조하세요.
### 요청 본문
이 작업에는 요청 본문이 없습니다.
## 응답
### 구문
```
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"
}
}
}
```
### 응답 헤더
이 작업은 대부분의 응답에 일반적인 응답 헤더만 사용합니다. 일반적인 응답 헤더에 대한 내용은 [HTTP 응답](making-http-requests.md#http-response-header) 섹션을 참조하세요.
### 응답 본문
검색 조건을 만족하는 각 작업에 대해 응답 본문에는 작업을 만들 때 지정한 값이 포함됩니다. 작업 값에 대한 자세한 내용은 [Elastic Transcoder 작업을 만들 때 지정하는 설정](job-settings.md) 섹션을 참조하세요.
또한 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`을 유지합니다.
+ 모든 출력이 최종 상태에 도달하면 모든 출력의 `Outputs:Status`가 `Complete`인 경우에만 `Job: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](https://en.wikipedia.org/wiki/Epoch_%28reference_date%29#Computing) 페이지를 참조하세요.
## 오류
Elastic Transcoder 예외 및 오류 메시지에 대한 자세한 내용은 [Elastic Transcoder에서의 오류 처리](error-handling.md) 섹션을 참조하세요.
## 예
### 예 요청
다음 예제 요청은 작업 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 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"
}
}
}
```