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.

Lire une tâche

Description

Pour obtenir des informations détaillées sur une tâche, envoyez une demande GET à la ressource /2012-09-25/jobs/jobId.

Requêtes

Syntaxe


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

Paramètre de demande

Cette opération prend le paramètre de demande suivant.

jobId: Identifiant de la tâche pour laquelle vous souhaitez obtenir des informations détaillées.

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'a 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

{
   "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 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"
      }
   }
}

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

Pour chaque tâche qui répond aux critères de recherche, le corps de la réponse 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 supprimer la tâche.

(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

La 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 àEpochsur Wikipédia.

Erreurs

Pour plus d'informations sur les exceptions et les messages d'erreur Elastic Transcoder, consultezGestion des erreurs dans Elastic Transcoder.

Exemples

Exemple de demande

L'exemple de requête suivant obtient la tâche portant l'ID de tâche 3333333333333-abcde3.


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

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

{
   "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"
      }
   }
}

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 statut

Annuler une tâche