Réduisez les coûts et bénéficiez de davantage de fonctionnalités avec AWS Elemental MediaConvert
MediaConvert est un nouveau service de transcodage vidéo basé sur des fichiers qui fournit une suite complète de fonctionnalités de transcodage avancées, avec des tarifs à la demande à partir de 0,0075 $/minute. En savoir plus
Vous utilisez déjà Amazon Elastic Transcoder ? La migration vers cette solution est simple MediaConvert. Pour plus d'informations, consultez cette présentation
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Liste des tâches par statut
Description
Pour obtenir une liste des tâches dotées d'un statut donné, envoyez une requête GET à/2012-09-25/jobsByStatus/Submitted
ressource. Elastic Transcoder répertorie les tâches que vous avez créées récemment et qui possèdent actuellement le statut spécifié.
Requêtes
Syntaxe
Pour obtenir des informations sur les tâches des six derniers mois associées au compte AWS actuel présentant un statut donné, envoyez la demande GET suivante.
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
Paramètres de demande
Cette opération prend les paramètres de demande suivants. Elastic Transcoder renvoie toutes les tâches des six derniers mois ayant le statut spécifié.
- État
-
Pour obtenir des informations sur toutes les tâches des six derniers mois associées au compte AWS actuel présentant un statut donné, précisez le statut :
Submitted
,Progressing
,Complete
,Canceled
ouError
. - Croissante
-
Pour répertorier les tâches en ordre chronologique selon la date et l'heure à laquelle elles ont été soumises, saisissez
true
. Pour répertorier les tâches en ordre chronologique inversé, saisissezfalse
. - PageToken
-
Lorsqu'Elastic Transcoder renvoie plusieurs pages de résultats, utilisez
PageToken
dans les actions suivantesGET
demande d'obtenir les pages de résultats successives.
En-têtes de demande
Cette opération utilise uniquement les en-têtes de demande qui sont communs à toutes les opérations. Pour plus d'informations sur les en-têtes de demande communs, consultez Contenu de l'en-tête HTTP.
Corps de la demande
Cette opération n'utilise pas de corps de demande.
Réponses
Syntaxe
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 }
En-têtes de réponse
Cette opération utilise uniquement les en-têtes de réponse qui sont communs à la plupart des réponses. Pour plus d'informations sur les en-têtes de réponse communs, consultez Réponses HTTP.
Corps de la réponse
Le corps de la réponse contient un élément pour chaque tâche qui répond aux critères de recherche et chaque élément contient les valeurs que vous avez spécifiées lors de la création de la tâche. Pour plus d'informations sur les valeurs de tâche, consultez Paramètres que vous spécifiez lorsque vous créez un Elastic Transcoder Job.
En outre, Elastic Transcoder renvoie les valeurs suivantes.
- (Automatique) Id
-
Identificateur que Elastic Transcoder a attribué à la tâche. Cette valeur permet d'obtenir les paramètres de la tâche ou de le supprimer.
- (Automatique) Inputs:DetectedProperties
-
Les propriétés détectées du fichier d'entrée. Elastic Transcoder identifie ces valeurs à partir du fichier d'entrée.
- (Automatique) Inputs:Width
-
Largeur détectée du fichier d'entrée, en pixels.
- (Automatique) Inputs:Height
-
Hauteur détectée du fichier d'entrée, en pixels.
- (Automatique) Inputs:FrameRate
Fréquence d'images détectée du fichier d'entrée, en images par seconde.
- (Automatique) Inputs:FileSize
Taille de fichier détectée du fichier d'entrée, en octets.
- (Automatique) Inputs:DurationMillis
Durée détectée du fichier d'entrée, en millisecondes.
- (Automatique) Outputs:Id
-
Compteur séquentiel, commençant par 1, qui identifie une sortie parmi les sorties de la tâche actuelle. Dans
Output
syntaxe, cette valeur est toujours1
. - (Automatique) Outputs:Duration
-
Durée du fichier de sortie en secondes, arrondie.
- (Automatique) Outputs:DurationMillis
-
Durée du fichier de sortie, en millisecondes.
- (Automatique) Outputs:Width
-
Largeur du fichier de sortie, en pixels.
- (Automatique) Outputs:Height
-
Hauteur du fichier de sortie, en pixels.
- (Automatique) Outputs:FrameRate
-
Fréquence d'images du fichier de sortie, en images par seconde.
- (Automatique) Outputs:FileSize
-
Taille de fichier du fichier de sortie, en octets.
- (Automatique) Outputs:Status
-
Statut d'une sortie dans une tâche. Si vous n'avez spécifié qu'une seule sortie pour la tâche,
Outputs:Status
est toujours identique àJob:Status
. Si vous avez spécifié plusieurs sorties :Job:Status
etOutputs:Status
pour toutes les sorties estSubmitted
jusqu'à ce qu'Elastic Transcoder commence à traiter la première sortie.Lorsque Elastic Transcoder commence à traiter la première sortie,
Outputs:Status
pour cette sortie etJob:Status
Remplacez parProgressing
. Pour chaque sortie, la valeur deOutputs:Status
resteSubmitted
jusqu'à ce qu'Elastic Transcoder commence à traiter la sortie.Job:Status
resteProgressing
jusqu'à ce que toutes les sorties atteignent l'état terminal, soitComplete
ouError
.Lorsque toutes les sorties atteignent l'état terminal,
Job:Status
Modifications apportées àComplete
uniquement siOutputs:Status
pour toutes les sorties estComplete
. SiOutputs:Status
pour une ou plusieurs sorties estError
, l'état du terminal pourJob:Status
est aussiError
.
Pour
Status
est l'une des actions suivantes :Submitted
,Progressing
,Complete
,Canceled
, ouError
. - (Automatique) Outputs:StatusDetail
-
Informations qui expliquent plus en détail
Outputs:Status
. - (Automatique) Outputs:AppliedColorSpaceConversion
-
Si Elastic Transcoder a utilisé un préréglage avec un
ColorSpaceConversionMode
pour transcoder le fichier de sortie, leAppliedColorSpaceConversion
indique la conversion utilisée. Si nonColorSpaceConversionMode
a été défini dans le préréglage, ce paramètre ne sera pas inclus dans la réponse de la tâche. - (Automatique) Status
-
Si vous avez spécifié plusieurs résultats pour la tâche, le statut de la tâche entière. Lorsque Elastic Transcoder commence à traiter une tâche, la valeur de
Job:Status
Modifications apportées àProgressing
et ne change pas tant qu'Elastic Transcoder n'a pas fini de traiter toutes les sorties. Lorsque le traitement est terminé,Job:Status
change soit àComplete
ou, si l'une des sorties a échoué, àError
.Si vous n'avez spécifié qu'une seule sortie pour la tâche,
Job:Status
est identique àOutputs:Status
.Pour
Job:Status
est l'une des actions suivantes :Submitted
,Progressing
,Complete
,Canceled
, ouError
. - (Automatique) Timing
-
Les détails sur le moment d'une tâche.
- (Automatique) Timing:SubmitTimeMillis
-
Heure à laquelle la tâche a été soumise à Elastic Transcoder, en millisecondes d'époque.
- (Automatique) Timing:StartTimeMillis
-
Heure à laquelle le travail a commencé à transcoder, en millisecondes d'époque.
- (Automatique) Timing:FinishTimeMillis
-
Heure à laquelle la tâche a terminé le transcodage, en millisecondes d'époque.
Pour en savoir plus sur l'époque, accédez àEpoch Computing
sur Wikipédia. - (Automatique) NextPageToken
-
Valeur que vous utilisez pour accéder à la deuxième page de résultats et aux pages suivantes, le cas échéant. Lorsque les tâches du pipeline spécifié s'adaptent à une page ou lorsque vous avez atteint la dernière page de résultats, la valeur de
NextPageToken
estnull
.
Erreurs
Pour plus d'informations sur les exceptions et les messages d'erreur Elastic Transcoder, consultezGestion des erreurs dans Elastic Transcoder.
Exemples
L'exemple de demande suivant crée une tâche.
Exemple de demande
L'exemple de demande suivant obtient une liste de toutes les tâches que vous avez créées au cours des six derniers mois qui présentent le statut 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
Exemple de réponse
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 }