Auflisten von Voreinstellungen - Amazon Elastic Transcoder
BeschreibungAnforderungenAntwortenFehlerBeispiele

Hinweis zum Ende des Supports: Am 13. November 2025 AWS wird der Support für Amazon Elastic Transcoder eingestellt. Nach dem 13. November 2025 können Sie nicht mehr auf die Elastic Transcoder Transcoder-Konsole oder die Elastic Transcoder Transcoder-Ressourcen zugreifen.

Weitere Informationen zur Umstellung auf finden Sie in diesem AWS Elemental MediaConvert Blogbeitrag.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Auflisten von Voreinstellungen

Beschreibung

Um eine Liste mit allen Voreinstellungen zu erhalten, die aktuellen AWS-Konten zugeordnet sind, senden Sie eine GET-Anfrage an die Ressource /2012-09-25/presets.

Anforderungen

Syntax

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

Anfrageparameter

Diese Operation akzeptiert die folgenden Anforderungsparameter. Elastic Transcoder gibt alle verfügbaren Voreinstellungen zurück.

Aufsteigend

Um die Voreinstellungen in chronologischer Reihenfolge nach dem Datum und der Zeit, zu dem/der sie eingereicht wurden, aufzulisten, gehen Sie zu true. Um die Voreinstellungen in umgekehrt chronologischer Reihenfolge aufzulisten, gehen Sie zu false.

PageToken

Wenn Elastic Transcoder mehr als eine Seite mit Ergebnissen zurückgibt, verwenden SiePageTokenNachfolgendeGET-Anfragen, alle nachfolgenden Ergebnisseiten abzurufen.

Anforderungsheader

Für diesen Vorgang werden ausschließlich Anforderungs-Header verwendet, die für alle Vorgänge gelten. Weitere Informationen über allgemeine Anforderungs-Header finden Sie unter Inhalt des HTTP-Headers.

Anforderungstext

Die JSON-Zeichenfolge im Anfragetext enthält die folgenden Objekte.

Antworten

Syntax

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
}

Antwort-Header

Für diesen Vorgang werden ausschließlich Antwort-Header verwendet, die für die meisten Antworten gelten. Weitere Informationen über allgemeine Antwort-Header finden Sie unter HTTP-Antworten.

Antworttext

Die JSON-Zeichenfolge im Antworttext gibt die Werte zurück, die Sie beim Erstellen der Voreinstellung angegeben haben. Weitere Informationen zu den einzelnen Objekten finden Sie unter Einstellungen, die Sie beim Erstellen einer Elastic Transcoder Transcoder-Voreinstellung festlegen.

Außerdem gibt Elastic Transcoder die folgenden Werte zurück:

(Automatisch) Id

ID für die Voreinstellung. Diesen Wert können Sie verwenden, um die Einstellungen für die Voreinstellung abzurufen oder sie zu löschen.

(Automatisch) Type

Ob es sich bei der Voreinstellung um eine Standardvoreinstellung handelt, die von Elastic Transcoder (System) oder eine Voreinstellung, die Sie definiert haben (Custom) enthalten.

(Automatisch) NextPageToken

Ein Wert, den Sie verwenden, um gegebenenfalls auf die zweite und die folgenden Ergebnisseiten zuzugreifen. Wenn die Voreinstellungen auf eine Seite passen oder wenn Sie die letzte Ergebnisseite erreicht haben, ist der Wert vonNextPageTokenistnullaus.

Fehler

Weitere Informationen über Elastic Transcoder Transcoder-Ausnahmen und -Fehlermeldungen finden Sie unterUmgang mit Fehlern in Elastic Transcoderaus.

Beispiele

Im folgenden Beispiel wird eine Voreinstellung mit dem Namen DefaultPreset erstellt.

Beispielanforderung

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

Beispielantwort

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"
         },
      },
      {...}
   ]
}