Save costs and get more features with AWS Elemental MediaConvert
MediaConvert is a newer file-based video transcoding service that provides a comprehensive suite of advanced transcoding features, with on-demand rates starting at $0.0075/minute. Read more
Already using Amazon Elastic Transcoder? It's simple to migrate to MediaConvert. For more information, see this overview
List Jobs by Status
Description
To get a list of the jobs that have a specified status, send a GET request to the
/2012-09-25/jobsByStatus/Submitted
resource. Elastic Transcoder lists the jobs that you've created recently and that
currently have the specified status.
Requests
Syntax
To get information about the last six months worth of jobs associated with the current AWS account that have a specified status, send the following GET request.
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
Request Parameters
This operation takes the following request parameters. Elastic Transcoder returns all of the jobs from the last six months that have the specified status.
- Status
-
To get information about all of the jobs from the last six months that are associated with the current AWS account that have a given status, specify the status:
Submitted
,Progressing
,Complete
,Canceled
, orError
. - Ascending
-
To list jobs in chronological order by the date and time that they were submitted, enter
true
. To list jobs in reverse chronological order, enterfalse
. - PageToken
-
When Elastic Transcoder returns more than one page of results, use
PageToken
in subsequentGET
requests to get each successive page of results.
Request Headers
This operation uses only request headers that are common to all operations. For information about common request headers, see HTTP Header Contents.
Request Body
This operation does not use a request body.
Responses
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 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
" } }, {...} ], "NextPageToken":value for accessing the next page of results
|null }
Response Headers
This operation uses only response headers that are common to most responses. For information about common response headers, see HTTP Responses.
Response Body
The response body contains one element for each job that satisfies the search criteria, and each element contains the values that you specified when you created the job. For more information about the job values, see Settings that You Specify When You Create an Elastic Transcoder Job.
In addition, Elastic Transcoder returns the following values.
- (Automatic) Id
-
The identifier that Elastic Transcoder assigned to the job. You use this value to get settings for the job or to delete the job.
- (Automatic) Inputs:DetectedProperties
-
The detected properties of the input file. Elastic Transcoder identifies these values from the input file.
- (Automatic) Inputs:Width
-
The detected width of the input file, in pixels.
- (Automatic) Inputs:Height
-
The detected height of the input file, in pixels.
- (Automatic) Inputs:FrameRate
The detected frame rate of the input file, in frames per second.
- (Automatic) Inputs:FileSize
The detected file size of the input file, in bytes.
- (Automatic) Inputs:DurationMillis
The detected duration of the input file, in milliseconds.
- (Automatic) Outputs:Id
-
A sequential counter, starting with 1, that identifies an output among the outputs from the current job. In the
Output
syntax, this value is always1
. - (Automatic) Outputs:Duration
-
Duration of the output file in seconds, rounded up.
- (Automatic) Outputs:DurationMillis
-
Duration of the output file, in milliseconds.
- (Automatic) Outputs:Width
-
Width of the output file, in pixels.
- (Automatic) Outputs:Height
-
Height of the output file, in pixels.
- (Automatic) Outputs:FrameRate
-
Frame rate of the output file, in frames per second.
- (Automatic) Outputs:FileSize
-
File size of the output file, in bytes.
- (Automatic) Outputs:Status
-
The status of one output in a job. If you specified only one output for the job,
Outputs:Status
is always the same asJob:Status
. If you specified more than one output:Job:Status
andOutputs:Status
for all of the outputs isSubmitted
until Elastic Transcoder starts to process the first output.When Elastic Transcoder starts to process the first output,
Outputs:Status
for that output andJob:Status
both change toProgressing
. For each output, the value ofOutputs:Status
remainsSubmitted
until Elastic Transcoder starts to process the output.Job:Status
remainsProgressing
until all of the outputs reach a terminal status, eitherComplete
orError
.When all of the outputs reach a terminal status,
Job:Status
changes toComplete
only ifOutputs:Status
for all of the outputs isComplete
. IfOutputs:Status
for one or more outputs isError
, the terminal status forJob:Status
is alsoError
.
The value of
Status
is one of the following:Submitted
,Progressing
,Complete
,Canceled
, orError
. - (Automatic) Outputs:StatusDetail
-
Information that further explains
Outputs:Status
. - (Automatic) Outputs:AppliedColorSpaceConversion
-
If Elastic Transcoder used a preset with a
ColorSpaceConversionMode
to transcode the output file, theAppliedColorSpaceConversion
parameter shows the conversion used. If noColorSpaceConversionMode
was defined in the preset, this parameter will not be included in the job response. - (Automatic) Status
-
If you specified more than one output for the job, the status of the entire job. When Elastic Transcoder starts processing a job, the value of
Job:Status
changes toProgressing
and doesn't change until Elastic Transcoder has finished processing all outputs. When processing is complete,Job:Status
changes either toComplete
or, if any of the outputs failed, toError
.If you specified only one output for the job,
Job:Status
is the same asOutputs:Status
.The value of
Job:Status
is one of the following:Submitted
,Progressing
,Complete
,Canceled
, orError
. - (Automatic) Timing
-
The details about the timing of a job.
- (Automatic) Timing:SubmitTimeMillis
-
The time the job was submitted to Elastic Transcoder, in epoch milliseconds.
- (Automatic) Timing:StartTimeMillis
-
The time the job began transcoding, in epoch milliseconds.
- (Automatic) Timing:FinishTimeMillis
-
The time the job finished transcoding, in epoch milliseconds.
To learn more about epoch time, go to the Epoch Computing
page on Wikipedia. - (Automatic) NextPageToken
-
A value that you use to access the second and subsequent pages of results, if any. When the jobs in the specified pipeline fit on one page or when you've reached the last page of results, the value of
NextPageToken
isnull
.
Errors
For information about Elastic Transcoder exceptions and error messages, see Handling Errors in Elastic Transcoder.
Examples
The following example request creates a job.
Sample Request
The following example request gets a list of all of the jobs that you created in the last six months
that have a status of Complete
.
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
Sample Response
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 }