Description Requêtes Réponses Erreurs Exemples

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 qui inclut des informations précieuses sur le processus de migration et des liens vers des ressources supplémentaires.

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/Submittedressource. 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 ou Error.
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é, saisissez false.
PageToken: Lorsqu'Elastic Transcoder renvoie plusieurs pages de résultats, utilisezPageTokendans les actions suivantesGETdemande 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 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
}

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. DansOutputsyntaxe, 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:Statusest toujours identique àJob:Status. Si vous avez spécifié plusieurs sorties :

Job:StatusetOutputs:Statuspour toutes les sorties estSubmittedjusqu'à ce qu'Elastic Transcoder commence à traiter la première sortie.
Lorsque Elastic Transcoder commence à traiter la première sortie,Outputs:Statuspour cette sortie etJob:StatusRemplacez parProgressing. Pour chaque sortie, la valeur deOutputs:StatusresteSubmittedjusqu'à ce qu'Elastic Transcoder commence à traiter la sortie.
Job:StatusresteProgressingjusqu'à ce que toutes les sorties atteignent l'état terminal, soitCompleteouError.
Lorsque toutes les sorties atteignent l'état terminal,Job:StatusModifications apportées àCompleteuniquement siOutputs:Statuspour toutes les sorties estComplete. SiOutputs:Statuspour une ou plusieurs sorties estError, l'état du terminal pourJob:Statusest aussiError.

PourStatusest l'une des actions suivantes :Submitted,Progressing,Complete,Canceled, ouError.

(Automatique) Outputs:StatusDetail

Informations qui expliquent plus en détailOutputs:Status.

(Automatique) Outputs:AppliedColorSpaceConversion

Si Elastic Transcoder a utilisé un préréglage avec unColorSpaceConversionModepour transcoder le fichier de sortie, leAppliedColorSpaceConversionindique la conversion utilisée. Si nonColorSpaceConversionModea é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 deJob:StatusModifications apportées àProgressinget ne change pas tant qu'Elastic Transcoder n'a pas fini de traiter toutes les sorties. Lorsque le traitement est terminé,Job:Statuschange soit àCompleteou, si l'une des sorties a échoué, àError.

Si vous n'avez spécifié qu'une seule sortie pour la tâche,Job:Statusest identique àOutputs:Status.

PourJob:Statusest 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 Computingsur 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 deNextPageTokenestnull.

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
}

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Liste des tâches par pipeline

Lire une tâche