プリセットのリスト - Amazon Elastic Transcoder
説明リクエストレスポンスエラー例

でコストを節約し、より多くの機能を利用する AWS Elemental MediaConvert

MediaConvert は、包括的な高度なトランスコード機能スイートを提供する、より新しいファイルベースのビデオトランスコードサービスで、オンデマンド料金は 1 分あたり 0.0075 USD からとなります。もっと読む。

既に Amazon Elastic Transcoder をご使用中ですか？ への移行は簡単です MediaConvert。詳細については、移行プロセスに関する貴重な情報やその他のリソースへのリンクを記載した本概要を参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

プリセットのリスト

説明

現在の 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 ヘッダーの内容」を参照してください。

リクエスト本文

リクエストボディの 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" <not recommended>,
            "AspectRatio":"auto|1:1|4:3|3:2|16:9" <not recommended>
            "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 レスポンス」を参照してください。

レスポンス本文

レスポンス本文の JSON 文字列は、プリセットの作成時に指定した値を返します。各オブジェクトの詳細については、「Elastic Transcoder プリセットの作成時に指定する設定」を参照してください。

また、以下の値も Elastic Transcoder によって返されます。

(自動) Id

プリセットの識別子。この値を使用して、プリセットの設定を取得したり、削除したりできます。

(自動) Type

そのプリセットが、Elastic Transcoder によって提供されるデフォルトのプリセット (System) であるか、または定義したプリセット (Custom) であるかが示されます。

(自動) NextPageToken

結果の 2 ページ目以降のページ (存在する場合) にアクセスするために使用する値。プリセットが 1 ページに収まる場合、または結果の最後のページに達したとき、NextPageToken の値は null になります。

エラー

Elastic Transcoder の例外とエラーメッセージについては、「Elastic Transcoder でのエラー処理」を参照してください。

例

次のサンプルリクエストでは、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"
         },
      },
      {...}
   ]
}