지원 종료 공지: 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-preset-description)
+ [요청](#get-preset-requests)
+ [응답](#get-preset-responses)
+ [오류](#get-preset-response-errors)
+ [예시](#get-preset-examples)
## 설명
프리셋에 대한 세부 정보를 보려면 `/2012-09-25/presets/presetId` 리소스에 GET 요청을 보냅니다.
## 요청
### 구문
```
GET /2012-09-25/presets/presetId HTTP/1.1
Content-Type: application/json; 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
Content-Length: number of characters in the JSON string
```
### 요청 매개변수
이 작업은 다음 요청 파라미터를 사용합니다.
** **presetId****
세부 정보를 조회하려는 프리셋의 식별자입니다.
### 요청 헤더
이 작업은 모든 작업에 일반적인 요청 헤더만 사용합니다. 일반적인 요청 헤더에 대한 내용은 [HTTP 헤더 콘텐츠](making-http-requests.md#http-request-header) 섹션을 참조하세요.
### 요청 본문
이 작업에는 요청 본문이 없습니다.
## 응답
### 구문
```
Status: 200 OK
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
{
"Preset":{
"Id":"preset identifier",
"Type":"Custom|System",
"Name":"preset name",
"Description":"preset description",
"Container":"flac|flv|fmp4|gif|mp2|mp3|mp4|mpg|mxf|oga|ogg|ts|wav|webm",
"Audio":{
"Codec":"AAC|flac|mp2|mp3|pcm|vorbis",
"CodecOptions":{
"Profile":"auto|AAC-LC|HE-AAC|HE-AACv2",
"BitDepth":"8|16|24|32",
"Signed":"Signed|Unsigned",
"BitOrder":"LittleEndian"
},
"SampleRate":"auto|22050|32000|44100|48000|96000",
"BitRate":"audio bit rate of output file in kilobits/second",
"Channels":"auto|0|1|2",
"AudioPackingMode":"SingleTrack|OneChannelPerTrack|
OneChannelPerTrackWithMosTo8Tracks"
},
"Video":{
"Codec":"gif|H.264|mpeg2|vp8|vp9",
"CodecOptions":{
"Profile":"baseline|main|high|0|1|2|3",
"Level":"1|1b|1.1|1.2|1.3|2|2.1|2.2|3|3.1|3.2|4|4.1",
"MaxReferenceFrames":maximum number of reference frames,
"MaxBitRate":"maximum bit rate",
"BufferSize":"maximum buffer size",
"InterlacedMode":"Progressive|TopFirst|BottomFirst|Auto",
"ColorSpaceConversionMode":"None|Bt709ToBt601|Bt601ToBt709|Auto",
"ChromaSubsampling":"yuv420p|yuv422p",
"LoopCount":"Infinite|[0,100]"
},
"KeyframesMaxDist":maximum frames between key frames,
"FixedGOP":"true|false",
"BitRate":"auto|video bit rate of output file in kilobits/second",
"FrameRate":"auto|10|15|23.97|24|25|29.97|30|50|60",
"MaxFrameRate":"10|15|23.97|24|25|29.97|30|50|60",
"MaxWidth":"auto|[128,4096]",
"MaxHeight":"auto|[96,3072]",
"SizingPolicy":"Fit|Fill|Stretch|Keep|ShrinkToFit|ShrinkToFill",
"PaddingPolicy":"Pad|NoPad",
"DisplayAspectRatio":"auto|1:1|4:3|3:2|16:9",
"Resolution":"width in pixelsxheight in pixels" ,
"AspectRatio":"auto|1:1|4:3|3:2|16:9"
"Watermarks":[
{
"Id":"unique identifier up to 40 characters",
"MaxWidth":"[16,Video:MaxWidth]px|[0,100]%",
"MaxHeight":"[16,Video:MaxHeight]px|[0,100]%",
"SizingPolicy":"Fit|Stretch|ShrinkToFit",
"HorizontalAlign":"Left|Right|Center",
"HorizontalOffset":"[0,100]%|[0,Video:MaxWidth]px",
"VerticalAlign":"Top|Bottom|Center",
"VerticalOffset":"[0,100]%|[0,Video:MaxHeight]px",
"Opacity":"[0,100]",
"Target":"Content|Frame"
}
]
},
"Thumbnails":{
"Format":"jpg|png",
"Interval":"number of seconds between thumbnails",
"MaxWidth":"auto|[32,4096]",
"MaxHeight":"auto|[32,3072]",
"SizingPolicy":"Fit|Fill|Stretch|Keep|ShrinkToFit|ShrinkToFill",
"PaddingPolicy":"Pad|NoPad",
"Resolution":"width in pixelsxheight in pixels",
"AspectRatio":"auto|1:1|4:3|3:2|16:9"
}
}
}
```
### 응답 헤더
이 작업은 대부분의 응답에 일반적인 응답 헤더만 사용합니다. 일반적인 응답 헤더에 대한 내용은 [HTTP 응답](making-http-requests.md#http-response-header) 섹션을 참조하세요.
### 응답 본문
프리셋을 조회하면, Elastic Transcoder는 프리셋을 만들 때 지정한 값을 반환합니다. 자세한 내용은 [Elastic Transcoder 프리셋을 생성할 때 지정하는 설정](preset-settings.md) 단원을 참조하십시오.
또한 Elastic Transcoder는 다음 값을 반환합니다.
**(자동) Id**
프리셋의 식별자. 이 값을 사용하여 프리셋의 설정을 가져오거나 프리셋을 삭제할 수 있습니다.
**(자동) Type**
프리셋이 Elastic Transcoder가 제공하는 기본 프리셋(`System`) 또는 사용자가 정의한 프리셋(`Custom`)인지 여부입니다.
## 오류
Elastic Transcoder 예외 및 오류 메시지에 대한 자세한 내용은 [Elastic Transcoder에서의 오류 처리](error-handling.md) 섹션을 참조하세요.
## 예시
다음 예제 요청은 ID가 `5555555555555-abcde5`인 프리셋을 가져옵니다.
### 샘플 요청
```
GET /2012-09-25/presets/5555555555555-abcde5 HTTP/1.1
Content-Type: application/json; 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
Content-Length: number of characters in the JSON string
```
### 샘플 응답
```
Status: 200 OK
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
{
"Preset":{
"Id":"5555555555555-abcde5",
"Type":"Custom",
"Name":"DefaultPreset",
"Description":"Use for published videos",
"Container":"mp4",
"Audio":{
"Codec":"AAC",
"CodecOptions":{
"Profile":"AAC-LC"
},
"SampleRate":"44100",
"BitRate":"96",
"Channels":"2"
},
"Video":{
"Codec":"H.264",
"CodecOptions":{
"Profile":"main",
"Level":"2.2",
"MaxReferenceFrames":"3",
"MaxBitRate":"",
"BufferSize":"",
"InterlacedMode":"Progressive",
"ColorSpaceConversionMode":"None"
},
"KeyframesMaxDist":"240",
"FixedGOP":"false",
"BitRate":"1600",
"FrameRate":"auto",
"MaxFrameRate":"30",
"MaxWidth":"auto",
"MaxHeight":"auto",
"SizingPolicy":"Fit",
"PaddingPolicy":"Pad",
"DisplayAspectRatio":"auto",
"Watermarks":[
{
"Id":"company logo",
"MaxWidth":"20%",
"MaxHeight":"20%",
"SizingPolicy":"ShrinkToFit",
"HorizontalAlign":"Right",
"HorizontalOffset":"10px",
"VerticalAlign":"Bottom",
"VerticalOffset":"10px",
"Opacity":"55.5",
"Target":"Content"
}
]
}
"Thumbnails":{
"Format":"png",
"Interval":"120",
"MaxHeight":"auto",
"MaxWidth":"auto",
"SizingPolicy":"Fit",
"PaddingPolicy":"Pad"
},
},
"Warning":""
}
```