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.
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.
Leseauftrag
Beschreibung
Um detaillierte Informationen über einen Auftrag abzurufen, senden Sie eine GET-Anforderung an die /2012-09-25/jobs/
-Ressource.jobId
Anforderungen
Syntax
GET /2012-09-25/jobs/jobId 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.
- jobId
-
Der Bezeichner des Auftrags, für den Sie detaillierte Informationen abrufen möchten.
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 besitzt keinen Anforderungstext.
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 { "Job":{ "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 pixels
xheight 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
" } } }
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
Für jeden Auftrag, der die Suchkriterien erfüllt, enthält der Antworttext 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
-
Die Kennung, die Elastic Transcoder dem Job zugewiesen hat. Sie verwenden diesen Wert, um Einstellungen für den Job abzurufen oder den Job zu löschen.
- (Automatische) Eingaben: DetectedProperties
-
Die erkannten Eigenschaften der Eingabedatei. Elastic Transcoder identifiziert diese Werte aus der Eingabedatei.
- (Automatische) Eingaben: Breite
-
Die erkannte Breite der Eingabedatei in Pixeln.
- (Automatische) Eingaben: Höhe
-
Die erkannte Höhe der Eingabedatei in Pixeln.
- (Automatische) Eingaben: FrameRate
Die erkannte Bildrate der Eingabedatei in Bildern pro Sekunde.
- (Automatische) Eingaben: FileSize
Die erkannte Dateigröße der Eingabedatei in Byte.
- (Automatische) Eingaben: DurationMillis
Die erkannte Dauer der Eingabedatei in Millisekunden.
- (Automatisch) Outputs:Id
-
Ein sequentieller Zähler, der mit 1 beginnt und eine Ausgabe unter den Ausgaben des aktuellen Jobs identifiziert. In der
Output
Syntax ist dieser Wert immer1
. - (Automatisch) Outputs:Duration
-
Dauer der Ausgabedatei in Sekunden, aufgerundet.
- (Automatische) Ausgaben: DurationMillis
-
Dauer der Ausgabedatei in Millisekunden.
- (Automatisch) Outputs:Width
-
Breite der Ausgabedatei in Pixeln.
- (Automatisch) Outputs:Height
-
Höhe der Ausgabedatei in Pixeln.
- (Automatische) Ausgaben: FrameRate
-
Bildrate der Ausgabedatei in Bildern pro Sekunde.
- (Automatische) Ausgaben: FileSize
-
Dateigröße der Ausgabedatei in Byte.
- (Automatisch) Outputs:Status
-
Der Status einer Ausgabe in einem Job. Wenn Sie nur eine Ausgabe für den Job angegeben haben,
Outputs:Status
ist dies immer derselbe wieJob:Status
. Wenn Sie mehr als eine Ausgabe angegeben haben:Job:Status
undOutputs:Status
für alle Ausgaben gilt,Submitted
bis Elastic Transcoder mit der Verarbeitung der ersten Ausgabe beginnt.Wenn Elastic Transcoder mit der Verarbeitung der ersten Ausgabe beginnt, ändern sich
Outputs:Status
für diese Ausgabe undJob:Status
beide zu.Progressing
Für jede AusgabeOutputs:Status
bleibt der Wert von bestehen,Submitted
bis Elastic Transcoder mit der Verarbeitung der Ausgabe beginnt.Job:Status
bleibtProgressing
so lange bestehen, bis alle Ausgaben einen Terminalstatus (entweder oderComplete
) erreichen.Error
Wenn alle Ausgänge einen Terminalstatus erreichen, wird der
Job:Status
Wert auf „Complete
Nur wennOutputs:Status
für alle Ausgänge“ geändertComplete
. WennOutputs:Status
für einen oder mehrere Ausgänge giltError
,Job:Status
ist auch der Terminalstatus fürError
.
Der Wert von
Status
ist einer der folgenden:Submitted
,Progressing
Complete
,Canceled
, oderError
. - (Automatische) Ausgänge: StatusDetail
-
Informationen, die das näher erläutern
Outputs:Status
. - (Automatische) Ausgänge: AppliedColorSpaceConversion
-
Wenn Elastic Transcoder ein Preset mit a verwendet hat
ColorSpaceConversionMode
, um die Ausgabedatei zu transkodieren, zeigt derAppliedColorSpaceConversion
Parameter die verwendete Konvertierung an. Wenn in der Voreinstellung kein Wert definiertColorSpaceConversionMode
wurde, wird dieser Parameter nicht in die Job-Antwort aufgenommen. - (Automatisch) Status
-
Wenn Sie mehr als eine Ausgabe für den Job angegeben haben, der Status des gesamten Jobs. Wenn Elastic Transcoder mit der Verarbeitung eines Jobs beginnt, ändert sich der Wert von
Progressing
undJob:Status
ändert sich erst, wenn Elastic Transcoder die Verarbeitung aller Ausgaben abgeschlossen hat. Wenn die Verarbeitung abgeschlossen ist,Job:Status
ändert sich entweder zuComplete
oder, falls eine der Ausgaben fehlschlug, zu.Error
Wenn Sie nur eine Ausgabe für den Job angegeben haben,
Job:Status
ist dies dieselbe wieOutputs:Status
.Der Wert von
Job:Status
ist einer der folgenden:Submitted
,Progressing
Complete
,Canceled
, oderError
. - (Automatisch) Timing
-
Die Details zum Zeitpunkt eines Jobs.
- (Automatisches) Timing: SubmitTimeMillis
-
Der Zeitpunkt, zu dem der Job an Elastic Transcoder übermittelt wurde, in Epochen-Millisekunden.
- (Automatisches) Timing: StartTimeMillis
-
Der Zeitpunkt, zu dem der Auftrag mit der Transcodierung begann, in Millisekunden der Epoche.
- (Automatisches) Timing: FinishTimeMillis
-
Die Zeit, zu der der Job die Transcodierung abgeschlossen hat, in Epochen-Millisekunden.
Um mehr über Epoch Time zu erfahren, besuchen Sie die Epoch Computing-Seite auf Wikipedia.
Fehler
Informationen zu Elastic Transcoder Transcoder-Ausnahmen und Fehlermeldungen finden Sie unter. Umgang mit Fehlern in Elastic Transcoder
Beispiele
Beispielanforderung
Die folgende Beispielanforderung ruft den Job mit der Job-ID 33333333333-abcde3 ab.
GET /2012-09-25/jobs/3333333333333-abcde3 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 { "Job":{ "Id":"3333333333333-abcde3", "Inputs":[{ "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":"Progressing", "StatusDetail":"", "Captions":{ "CaptionFormats":[ { "Format":"scc", "Pattern":"scc/lasagna-{language}", }, { "Format":"srt", "Pattern":"srt/lasagna-{language}", }, { "Format":"mov-text" } ] } }, { "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":"Progressing", "StatusDetail":"", "AppliedColorSpaceConversion":"None" }, { "Id":"3", "Key":"iphone/lasagna-512k", "ThumbnailPattern":"iphone/th512k/lasagna-{count}", "Rotate":"0", "PresetId":"1351620000000-456789", "SegmentDuration":"5", "Duration":"1003", "DurationMillis":"1003000", "Width":"1136", "Height":"640", "FrameRate":"30.00", "FileSize":"3508900", "Status":"Complete", "StatusDetail":"" } ], "Playlists":[ { "Format":"HLSv3", "Name":"playlist-iPhone-lasagna.m3u8", "OutputKeys":[ "iphone/lasagna-1024k", "iphone/lasagna-512k" ] } ], "UserMetadata": { "Food type":"Italian", "Cook book":"recipe notebook" }, "PipelineId":"1111111111111-abcde1", "Status":"Progressing", "Timing":{ "SubmitTime":"1427212800000", "StartTime":"1427212856000", "FinishTime":"1427212875000" } } }