サポート終了通知: 2025 年 11 月 13 日、 AWS は Amazon Elastic Transcoder のサポートを終了します。2025 年 11 月 13 日以降、Elastic Transcoder コンソールまたは Elastic Transcoder リソースにアクセスできなくなります。
への移行の詳細については AWS Elemental MediaConvert、この[ブログ記事](https://aws.amazon.com/blogs/media/how-to-migrate-workflows-from-amazon-elastic-transcoder-to-aws-elemental-mediaconvert/)を参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# プリセットのリスト
**Topics**
+ [説明](#list-presets-description)
+ [リクエスト](#list-presets-requests)
+ [レスポンス](#list-presets-responses)
+ [エラー](#list-presets-response-errors)
+ [例](#list-presets-examples)
## 説明
現在の AWS アカウントに関連付けられたすべてのプリセットのリストを取得するには、`/2012-09-25/presets` リソースに GET リクエストを送信します。
## リクエスト
### 構文
```
GET /2012-09-25/presets/Ascending=true|false&
PageToken=value for accessing the next page of
results 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
```
### リクエストパラメータ
このオペレーションでは、次のリクエストパラメータを使用します。Elastic Transcoder により、すべての利用可能なプリセットが返されます。
**昇順**
プリセットを、送信された日時に基づいて古い順に一覧表示するには、`true` を入力します。プリセットを新しい順に一覧表示するには、`false` を入力します。
**PageToken**
Elastic Transcoder から返される結果のページが複数にわたる場合、後続の `GET` リクエストで `PageToken` を使用することで、それぞれの結果のページを連続したページとして取得できます。
### リクエストヘッダー
このオペレーションは、すべてのオペレーションに共通のリクエストヘッダーのみを使用します。共通のリクエストヘッダーの詳細については、「[HTTP ヘッダーの内容](making-http-requests.md#http-request-header)」を参照してください。
### リクエスト本文
リクエストボディの JSON 文字列には、次のオブジェクトが含まれます。
## レスポンス
### 構文
```
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
{
"Presets":[
{
"Id":"preset ID",
"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"
},
},
{...},
],
"NextPageToken":value for accessing the next page of results|null
}
```
### レスポンスヘッダー
この操作はほとんどのレスポンスに共通のレスポンスヘッダーのみを使用します。共通のレスポンスヘッダーの詳細については、「[HTTP レスポンス](making-http-requests.md#http-response-header)」を参照してください。
### レスポンス本文
レスポンス本文の JSON 文字列は、プリセットの作成時に指定した値を返します。各オブジェクトの詳細については、「[Elastic Transcoder プリセットの作成時に指定する設定](preset-settings.md)」を参照してください。
また、以下の値も Elastic Transcoder によって返されます。
**(自動) Id**
プリセットの識別子。この値を使用して、プリセットの設定を取得したり、削除したりできます。
**(自動) Type**
そのプリセットが、Elastic Transcoder によって提供されるデフォルトのプリセット (`System`) であるか、または定義したプリセット (`Custom`) であるかが示されます。
**(自動) NextPageToken**
結果の 2 ページ目以降のページ (存在する場合) にアクセスするために使用する値。プリセットが 1 ページに収まる場合、または結果の最後のページに達したとき、`NextPageToken` の値は `null` になります。
## エラー
Elastic Transcoder の例外とエラーメッセージについては、「[Elastic Transcoder でのエラー処理](error-handling.md)」を参照してください。
## 例
次のサンプルリクエストでは、`DefaultPreset` という名前のプリセットを作成します。
### リクエスト例
```
GET /2012-09-25/presets 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
{
"Presets":[
{
"Id":"5555555555555-abcde5",
"Type":"Custom",
"Name":"DefaultPreset",
"Description":"Use for published videos",
"Container":"mp4",
"Audio":{
"BitRate":"96",
"Channels":"2",
"Codec":"AAC",
"CodecOptions":{
"Profile":"AAC-LC"
},
"SampleRate":"44100"
},
"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",
"MaxWidth":"auto",
"MaxHeight":"auto",
"SizingPolicy":"Fit",
"PaddingPolicy":"Pad"
},
},
{...}
]
}
```