Auflisten von Aufträgen nach Status

Beschreibung

Um eine Liste mit den Aufträgen zu erhalten, die einen bestimmten Status haben, senden Sie eine GET-Anfrage an/2012-09-25/jobsByStatus/Submittedressource. Elastic Transcoder listet die Aufträge auf, die Sie vor Kurzem erstellt haben und die aktuell den angegebenen Status aufweisen.

Anforderungen

Syntax

Um Informationen über den Wert der Aufträge zu erhalten, die dem aktuellen AWS-Konto in den letzten sechs Monaten zugeordnet waren und einen bestimmten Status aufweisen, senden Sie die folgende GET-Anfrage.

GET /2012-09-25/jobsByStatus/Status?
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 Aufträge der letzten sechs Monate zurück, die den angegebenen Status aufweisen.

Status

Um Informationen zu allen Aufträgen aus den letzten sechs Monaten zu erhalten, die dem aktuellen AWS-Konto zugeordnet sind und einen bestimmten Status aufweisen, geben Sie den Status an: Submitted, Progressing, Complete, Canceled oder Error.

Aufsteigend

Um die Aufträge in chronologischer Reihenfolge nach dem Zeitpunkt, zu dem sie übermittelt wurden, aufzulisten, geben Sie true ein. Um die Aufträge in umgekehrt chronologischer Reihenfolge aufzulisten, geben Sie false ein.

PageToken

Wenn Elastic Transcoder mehr als eine Seite mit Ergebnissen zurückgibt, verwenden SiePageTokennachfolgendGETUm jede nachfolgende Ergebnisseite 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

Dieser Vorgang verwendet keinen Anfragetext.

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

{
   "Jobs":[
      {
         "Id":"Id that Elastic Transcoder assigned to the job",
         "Inputs":[{
            "Key":"name of the file to transcode",
            "Encryption":{
               "Mode":"aes-cbc-pkcs7|aes-ctr|aes-gcm",
               "Key":"encrypted and base64-encoded decryption key",
               "KeyMd5":"base64-encoded key digest",
               "InitializationVector":"base64-encoded initialization vector"
            },
            "TimeSpan":{
               "StartTime":"starting place of the clip, in
                  HH:mm:ss.SSS or sssss.SSS",
               "Duration":"duration of the clip, in HH:mm:ss.SSS
                  or sssss.SSS"
            },
            "FrameRate":"auto|10|15|23.97|24|25|29.97|30|50|60",
            "Resolution":"auto|width in pixelsxheight in pixels",
            "AspectRatio":"auto|1:1|4:3|3:2|16:9",
            "Interlaced":"auto|true|false",
            "Container":"auto|aac|asf|avi|divx|flv|m4a|mkv|mov|mp2|mp3|
               mp4|mpeg|mpeg-ps|mpeg-ts|mxf|ogg|vob|wav|webm",
            "DetectedProperties":{
               "Width":"video width in pixels",
               "Height":"video height in pixels",        
               "FrameRate":"video frame rate in fps",
               "FileSize":"file size in bytes",
               "DurationMillis":"file duration in milliseconds"
            },
            "InputCaptions":{
   	       "MergePolicy":"MergeOverride|MergeRetain|Override",
               "CaptionSources":[
                  {
                     "Key":"name of the input caption file",
                     "Language":"language of the input caption file",
                     "TimeOffset":"starting place of the captions, in
                        either [-+]SS.sss or [-+]HH:mm:SS.ss",
                     "Label":"label for the caption"
                     "Encryption":{
                        "Mode":"aes-cbc-pkcs7|aes-ctr|aes-gcm",
                        "Key":"encrypted and base64-encoded decryption key",
                        "KeyMd5":"base64-encoded key digest",
                        "InitializationVector":"base64-encoded initialization 
                           vector"
                     },
                  },
                  {...}
               ]
            }
         },
      {...}],
      "OutputKeyPrefix":"prefix for file names in Amazon S3 bucket",
      "Outputs":[{
            "Id":"sequential counter",
            "Key":"name of the transcoded file",
            "Encryption":{
               "Mode":"s3||aes-cbc-pkcs7|aes-ctr|
                  aes-gcm",
               "Key":"encrypted and base64-encoded encryption key",
               "KeyMd5":"base64-encoded key digest",
               "InitializationVector":"base64-encoded initialization vector"           
            },
            "ThumbnailPattern":""|"pattern",
            "Rotate":"auto|0|90|180|270",
            "PresetId":"preset to use for the job",
            "SegmentDuration":"[1,60]",
            "Watermarks":[
               {
                  "InputKey":"name of the .png or .jpg file",
                  "Encryption":{
                     "Mode":"s3||aes-cbc-pkcs7|
                        aes-ctr|aes-gcm",
                     "Key":"encrypted and base64-encoded encryption key",
                     "KeyMd5":"base64-encoded key digest",
                     "InitializationVector":"base64-encoded initialization 
                        vector"
                  },
                  "PresetWatermarkId":"value of Video:Watermarks:Id in 
                     preset"
               },
               {...}
            ],
            "AlbumArt":[
               {
                  "AlbumArtMerge":"Replace|Prepend|Append|Fallback",
                  "AlbumArtArtwork":"can be empty, but not null":[
                     {
                        "AlbumArtInputKey":"name of the file to use as album 
                           art",
                        "Encryption":{
                           "Mode":"s3||aes-cbc-pkcs7|
                              aes-ctr|aes-gcm",
                           "Key":"encrypted and base64-encoded encryption key",
                           "KeyMd5":"base64-encoded key digest",
                           "InitializationVector":"base64-encoded
                              initialization vector"
                        },
                        "AlbumArtMaxWidth":"maximum width of output album art
                           in pixels",
                        "AlbumArtMaxHeight":"maximum height of output album
                           art in pixels",
                        "AlbumArtSizingPolicy":"Fit|Fill|Stretch|Keep|
                           ShrinkToFit|ShrinkToFill",
                        "AlbumArtPaddingPolicy":"Pad|NoPad",
                        "AlbumArtFormat":"jpg|png"
                     },
                     {...}
                  ]
            },
            {...}], 
            "Duration":"duration in seconds",
            "DurationMillis":"duration in milliseconds",
            "Height":"height in pixels",
            "Width":"width in pixels",
            "FrameRate":"frame rate in fps",
            "FileSize":"file size in bytes",
            "Status":"Submitted|In Progress|Complete|Error",
            "StatusDetail":"detail associated with Status",
            "Captions":{
               "CaptionFormats":[
                  {
                     "Format":"cea-708|dfxp|mov-text|scc|srt|webvtt",
                     "Pattern":"myCaption/file-language",
                     "Encryption":{
                        "Mode":"s3||aes-cbc-pkcs7|
                           aes-ctr|aes-gcm",
                        "Key":"encrypted and base64-encoded encryption key",
                        "KeyMd5":"base64-encoded key digest",
                        "InitializationVector":"base64-encoded 
                           initialization vector"
                     }
                  },
                  {...}
               ]
            },
            "AppliedColorSpaceConversion":"None|Bt601ToBt709|
                  Bt709ToBt601"
         },
         {...}
      ],
      "Playlists":[
         {
            "Format":"HLSv3|HLSv4|MPEG-DASH|Smooth",
            "Name":"name",
            "OutputKeys":[
               "Outputs:Key to include in this playlist",
               {...}
            ],
            "HlsContentProtection":{
                "Method":"aes-128",
                "Key":"encrypted and base64-encoded protection key",
                "KeyMd5":"base64-encoded key digest",
                "InitializationVector":"base64-encoded
                   initialization vector",
                "LicenseAcquisitionUrl":"license acquisition url",
                "KeyStoragePolicy":"NoStore|WithVariantPlaylists"
            },
            "PlayReadyDrm":{
                "Format":"microsoft|discretix-3.0",
                "Key":"encrypted and base64-encoded DRM key",
                "KeyId":"id of the DRM key",
                "KeyMd5":"base64-encoded key digest",
                "InitializationVector":"base64-encoded
                   initialization vector",
                "LicenseAcquisitionUrl":"license acquisition url"
               }
            },
            {...}
         ],
         "UserMetadata":
            {
                "Key":"Value",
                "Second user metadata key":"Second user metadata value"
            },
         "PipelineId":"PipelineId for the job",
         "Status":"Submitted|Progressing|Complete|Canceled|Error",
         "Timing":{
            "SubmitTimeMillis":"job submitted time in epoch milliseconds",
            "StartTimeMillis":"job start time in epoch milliseconds",
            "FinishTimeMillis":"job finish time in epoch milliseconds"
         }
      },
      {...}
   ],
   "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

Der Antworttext enthält ein Element für jeden Auftrag, der die Suchkriterien erfüllt, und jedes Element enthält die Werte, die Sie beim Erstellen des Auftrags angegeben haben. Weitere Informationen zu den Auftragswerten finden Sie unter Einstellungen, die Sie angeben, wenn Sie einen Elastic Transcoder Transcoder-Job erstellen.

Darüber hinaus gibt Elastic Transcoder die folgenden Werte zurück.

(Automatisch) Id

Der Bezeichner, den Elastic Transcoder dem Job zugewiesen hat. Diesen Wert erhalten Sie, um die Einstellungen für den Auftrag abzurufen oder den Auftrag zu löschen.

(Automatisch) Inputs:DetectedProperties

Die erkannten Eigenschaften der Eingabedatei. Elastic Transcoder identifiziert diese Werte aus der Eingabedatei.

(Breite) (Automatisch) Inputs:Width

Die erkannte Breite der Eingabedatei in Pixeln.

(Höhe) (Automatisch) Inputs:Height

Die erkannte Höhe der Eingabedatei in Pixeln.

(Automatisch) Inputs:FrameRate

Die erkannte Bildrate der Eingabedatei in Bildern pro Sekunde.

(Automatisch) Inputs:FileSize

Die erkannte Dateigröße der Eingabedatei in Bytes.

(Automatisch) Inputs:DurationMillis

Die erkannte Dauer der Eingabedatei in Millisekunden.

(Automatisch) Outputs:Id

Ein sequentieller Zähler, beginnend mit 1, der eine Ausgabe zwischen den Ausgängen des aktuellen Jobs identifiziert. In derOutputSyntax ist dieser Wert immer1aus.

(Automatisch) Outputs:Duration

Dauer der Ausgabedatei in Sekunden, aufgerundet.

(Automatisch) Outputs:DurationMillis

Dauer der Ausgabedatei in Millisekunden.

(Automatisch) Outputs:Width

Breite der Ausgabedatei in Pixeln.

(Automatisch) Outputs:Height

Die Höhe der Ausgabedatei in Pixeln.

(Automatisch) Outputs:FrameRate

Bildrate der Ausgabedatei in Bildern pro Sekunde.

(Automatisch) Outputs:FileSize

Die Dateigröße der Ausgabedatei in Bytes.

(Automatisch) Outputs:Status

Der Status einer Ausgabe in einem Job. Wenn Sie nur eine Ausgabe für den Job angegeben haben,Outputs:Statusist immer identisch zuJob:Statusaus. Wenn Sie mehr als einen Ausgang angegeben haben:

• Job:StatusundOutputs:Statusfür alle Ausgänge istSubmittedbis Elastic Transcoder beginnt, die erste Ausgabe zu verarbeiten.

• Wenn Elastic Transcoder beginnt, den ersten Ausgang zu verarbeiten,Outputs:Statusfür diese Ausgabe undJob:StatusBeide wechseln zuProgressingaus. Für jede Ausgabe ist der Wert vonOutputs:StatusbleibtSubmittedbis Elastic Transcoder beginnt, die Ausgabe zu verarbeiten.

• Job:StatusbleibtProgressingbis alle Ausgänge einen Terminalstatus erreichen, entwederCompleteoderErroraus.

• Wenn alle Ausgänge einen Terminalstatus erreichen,Job:StatusÄnderungen anCompleteNur wennOutputs:Statusfür alle Ausgänge istCompleteaus. WennOutputs:StatusFür einen oder mehrere Ausgänge istError, der Terminalstatus fürJob:Statusist auchErroraus.

Der Wert vonStatusist gehen Sie wie folgt vor:Submitted,Progressing,Complete,Canceled, oderErroraus.

(Automatisch) Outputs:StatusDetail

Informationen, die weiter erklärenOutputs:Statusaus.

(Automatisch) Outputs:AppliedColorSpaceConversion

Wenn Elastic Transcoder eine Voreinstellung mit einemColorSpaceConversionModeum die Ausgabedatei zu transcodieren, wird dieAppliedColorSpaceConversion-Parameter zeigt die verwendete Konvertierung an. Wenn neinColorSpaceConversionModewurde in der Voreinstellung definiert, dieser Parameter wird nicht in die Job-Antwort aufgenommen.

(Automatisch) Status

Wenn Sie mehr als eine Ausgabe für den Job angegeben haben, den Status des gesamten Jobs. Wenn Elastic Transcoder mit der Verarbeitung eines Jobs beginnt, ist der Wert vonJob:StatusÄnderungen anProgressingund ändert sich erst, wenn Elastic Transcoder die Verarbeitung aller Ausgaben abgeschlossen hat. Wenn die Verarbeitung abgeschlossen ist,Job:Statusändert sich entweder inCompleteoder, falls eine der Ausgaben fehlgeschlagen ist,Erroraus.

Wenn Sie nur eine Ausgabe für den Job angegeben haben,Job:Statusist identisch zuOutputs:Statusaus.

Der Wert vonJob:Statusist gehen Sie wie folgt vor:Submitted,Progressing,Complete,Canceled, oderErroraus.

(Automatisch) Timing

Die Details über den Zeitpunkt eines Jobs.

(Automatisch) Timing:SubmitTimeMillis

Die Zeit, zu der der Job in Epoche Millisekunden an Elastic Transcoder übermittelt wurde.

(Automatisch) Timing:StartTimeMillis

Die Zeit, als der Job mit der Transcodierung begann, in Epochen Millisekunden.

(Automatisch) Timing:FinishTimeMillis

Die Zeit, zu der der Auftrag die Transcodierung beendet hat, in Epochenmillisekunden.

Weitere Informationen zur Epoche-Zeit finden Sie unterEpoche-ComputingSeite auf Wikipedia.

(Automatisch) NextPageToken

Ein Wert, den Sie verwenden, um gegebenenfalls auf die zweite und die folgenden Ergebnisseiten zuzugreifen. Wenn die Jobs in der angegebenen Pipeline 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

Mit der folgenden Beispielanfrage wird ein Auftrag erstellt.

Beispielanforderung

Mit der folgenden Beispielanfrage wird eine Liste aller Aufträge mit dem Status Complete abgerufen, die Sie in den letzten sechs Monaten erstellt haben.

GET /2012-09-25/jobsByStatus/Complete?Ascending=true 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

{
   "Jobs":[
      {
         "Id":"3333333333333-abcde3",
         "Input":[{
            "Key":"cooking/lasagna.mp4",
            "FrameRate":"auto",
            "Resolution":"auto",
            "AspectRatio":"auto",
            "Interlaced":"auto",
            "Container":"mp4",
            "InputCaptions"{
               "MergePolicy":"MergeOverride",
               "CaptionSources":[
                  {
                     "Key":"scc/lasagna-kindlefirehd.scc",
                     "Language":"en",
                     "Label":"English"
                  },
                  {
                     "Key":"srt/lasagna-kindlefirehd.srt",
                     "Language":"fr",
                     "TimeOffset":"1:00:00",
                     "Label":"French"
                  }
               ]
            },
            "DetectedProperties":{
               "Width":"1280",
               "Height":"720",
               "FrameRate":"30.00",
               "FileSize":"5872000",
               "DurationMillis":"1003000"
            }
         }],
         "OutputKeyPrefix":"",
         "Outputs":[
            {
               "Id":"1",
               "Key":"mp4/lasagna-kindlefirehd.mp4",
               "ThumbnailPattern":"mp4/thumbnails/lasagna-{count}",
               "Rotate":"0",
               "PresetId":"1351620000000-100080",
               "Watermarks":[
                  {
                     "InputKey":"logo/128x64.png",
                     "PresetWatermarkId":"company logo 128x64",
                  }
               ],
               "Duration":"1003",
               "DurationMillis":"1003000",
               "Width":"1280",
               "Height":"720",
               "FrameRate":"30.00",
               "FileSize":"5872000",
               "Status":"Complete",
               "StatusDetail":"",
               "Captions":{
                  "CaptionFormats":[
                     {
                        "Format":"scc",
                        "Pattern":"scc/lasagna-{language}"
                     },
                     {
                        "Format":"srt",
                        "Pattern":"srt/lasagna-{language}"
                     },
                     {
                        "Format":"mov-text"
                     }
                  ]
               },
               "AppliedColorSpaceConversion":"None"
            },
            {
               "Id":"2",
               "Key":"iphone/lasagna-1024k",
               "ThumbnailPattern":"iphone/th1024k/lasagna-{count}",
               "Rotate":"0",
               "PresetId":"1351620000000-987654",
               "SegmentDuration":"5",
               "Duration":"1003",
               "DurationMillis":"1003000",
               "Width":"1136",
               "Height":"640",
               "FrameRate":"30.00",
               "FileSize":"4718600",
               "Status":"Complete",
               "StatusDetail":""
            },
         ],
         "PipelineId":"1111111111111-abcde1",
         "Playlists":[
            {
               "Format":"HLSv3",
               "Name":"playlist-iPhone-lasagna.m3u8",
               "OutputKeys":[
                  "iphone/lasagna-1024k",
                  "iphone/lasagna-512k"
               ]
            }
         ],
         "Timing":{
               "SubmitTime":"1427212800000",
               "StartTime":"1427212856000",
               "FinishTime":"1427212875000"
         },
         "Status":"Complete"
      },
      {
         "Id":"4444444444444-abcde4",
         "Input":{
            "Key":"cooking/spaghetti.mp4",
            "FrameRate":"auto",
            "Resolution":"auto",
            "AspectRatio":"auto",
            "Interlaced":"auto",
            "Container":"mp4",
            "DetectedProperties":{
               "Width":"1280",
               "Height":"720",
               "FrameRate":"30.00",
               "FileSize":"5872000",
               "DurationMillis":"1003000"
            }
         },
         "Outputs":[
            {
               "Id":"3",
               "Key":"iphone/spaghetti-512k",
               "ThumbnailPattern":"iphone/th512k/spaghetti-{count}",
               "Rotate":"0",
               "PresetId":"1351620000000-456789",
               "SegmentDuration":"5",
               "Watermarks":[
                  {
                     "InputKey":"logo/128x64.png",
                     "PresetWatermarkId":"company logo 128x64"
                  }
               ],
               "Duration":"1003",
               "DurationMillis":"1003000",
               "Width":"1136",
               "Height":"640",
               "FrameRate":"30.00",
               "FileSize":"5872000",
               "Status":"Complete",
               "StatusDetail":""
            }
         ],
         "Playlists":[
            {
               "Format":"HLSv3",
               "Name":"playlist-iPhone-spaghetti.m3u8",
               "OutputKeys":[
                  "iphone/spaghetti-512k"
               ]
            }
         ],
         "UserMetadata":
            {
               "Food type":"Italian",
               "Cook book":"recipe notebook"
            },
         "Status":"Complete",
         "Timing":{
            "SubmitTime":"1427212800000",
            "StartTime":"1427212856000",
            "FinishTime":"1427212875000"
         }
      }
   ],
   "NextPageToken":null
}