

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.](https://aws.amazon.com/blogs/media/how-to-migrate-workflows-from-amazon-elastic-transcoder-to-aws-elemental-mediaconvert/)

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
<a name="list-presets"></a>

**Topics**
+ [Beschreibung](#list-presets-description)
+ [Anforderungen](#list-presets-requests)
+ [Antworten](#list-presets-responses)
+ [Fehler](#list-presets-response-errors)
+ [Beispiele](#list-presets-examples)

## Beschreibung
<a name="list-presets-description"></a>

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
<a name="list-presets-requests"></a>

### Syntax
<a name="list-presets-request-syntax"></a>

```
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
```

### Anforderungsparameter
<a name="list-presets-request-parameters"></a>

Dieser Vorgang verwendet die folgenden Anforderungsparameter. Elastic Transcoder gibt alle verfügbaren Presets 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 Ergebnisseite zurückgibt, verwenden Sie dies `PageToken` in nachfolgenden `GET` Anfragen, um jede weitere Ergebnisseite abzurufen.

### Anforderungsheader
<a name="list-presets-request-headers"></a>

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](making-http-requests.md#http-request-header).

### Anforderungstext
<a name="list-presets-request-body"></a>

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

## Antworten
<a name="list-presets-responses"></a>

### Syntax
<a name="list-presets-response-syntax"></a>

```
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
<a name="list-presets-response-headers"></a>

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](making-http-requests.md#http-response-header).

### Antworttext
<a name="list-presets-response-body"></a>

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 angeben, wenn Sie ein Elastic Transcoder Transcoder-Preset erstellen](preset-settings.md).

Darüber hinaus 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 von Elastic Transcoder (`System`) bereitgestellte Standardvoreinstellung oder um eine von Ihnen definierte Voreinstellung handelt (`Custom`).

**(Automatisch) NextPageToken**  
Ein Wert, den Sie für den Zugriff auf die zweite und gegebenenfalls nachfolgende Ergebnisseiten verwenden. Wenn die Vorgaben auf eine Seite passen oder wenn Sie die letzte Ergebnisseite erreicht haben, `NextPageToken` ist `null` der Wert von.

## Fehler
<a name="list-presets-response-errors"></a>

Informationen zu Elastic Transcoder Transcoder-Ausnahmen und Fehlermeldungen finden Sie unter. [Umgang mit Fehlern in Elastic Transcoder](error-handling.md)

## Beispiele
<a name="list-presets-examples"></a>

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

### Beispielanforderung
<a name="list-presets-examples-sample-request"></a>

```
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
<a name="list-presets-examples-sample-response"></a>

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