Processo di lettura - Amazon Elastic Transcoder
DescrizioneRichiesteRisposteErroriEsempi

Risparmia sui costi e ottieni più funzionalità con AWS Elemental MediaConvert

MediaConvert è un nuovo servizio di transcodifica video basato su file che offre una suite completa di funzionalità di transcodifica avanzate, con tariffe su richiesta a partire da 0,0075 USD/minuto. Leggi di più.

Usi già Amazon Elastic Transcoder? È semplice migrare verso. MediaConvert Per ulteriori informazioni, consulta questa panoramica che include informazioni preziose sul processo di migrazione e collegamenti a risorse aggiuntive.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Processo di lettura

Descrizione

Per ottenere informazioni dettagliate su un processo, invia una richiesta GET alla risorsa /2012-09-25/jobs/jobId.

Richieste

Sintassi

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

Parametro della richiesta

Questa operazione prende il seguente parametro di richiesta.

jobId

L'identificatore del processo di cui si richiedono informazioni dettagliate.

Intestazioni di richiesta

Questa operazione utilizza solo le intestazioni richiesta che sono comuni a tutte le operazioni. Per informazioni sulle intestazioni richiesta comuni, consulta Contenuti nell'intestazione HTTP.

Corpo della richiesta

Questa operazione non ha un corpo della richiesta.

Risposte

Sintassi

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

Intestazioni di risposta

Questa operazione utilizza solo le intestazioni di risposta che sono comuni alla maggior parte delle risposte. Per informazioni sulle intestazioni di risposta comuni, consulta Risposte HTTP.

Corpo della risposta

Per ogni processo che soddisfa i criteri di ricerca, il corpo della risposta contiene i valori specificati durante la creazione del processo. Per ulteriori informazioni sui valori del processo, consulta Impostazioni che specificate quando create un lavoro Elastic Transcoder Job.

Inoltre, Elastic Transcoder restituisce i seguenti valori.

IdId (automatico)

Identificatore assegnato a Elastic Transcoder al lavoro. Questo valore consente di ottenere le impostazioni per il processo o per eliminare il processo.

(automatico)

Le proprietà rilevate del file di input. Elastic Transcoder identifica questi valori dal file di input.

(automatico)

La larghezza del file di input rilevata in pixel.

(automatico) Inputs:Height (automatico)

L'altezza del file di input rilevata in pixel.

(automatico)

La velocità di fotogrammi rilevati del file di input, espressa in fotogrammi al secondo.

(automatico)

La dimensione del file di input rilevata in byte.

(automatico)

La durata del file di input rilevata in millisecondi.

(automatico) Outputs:Id

Un contatore sequenziale, a partire da 1, che identifica un output tra gli output del lavoro corrente. NellaOutputsintassi, questo valore è sempre1.

(automatico) Outputs:Duration

Durata del file di output in secondi, arrotondata.

(automatico)

Durata del file di output in millisecondi.

(automatico) Outputs:Width

Larghezza del file di output in pixel.

(automatico) Outputs:Height (automatico)

Altezza del file di output, espressa in pixel.

(automatico)

Framerate del file di output, espressa in fotogrammi al secondo.

(automatico)

Le dimensioni del file di output in byte.

(automatico) Outputs:Status

Lo stato di un output in un lavoro. Se hai specificato un solo output per il lavoro,Outputs:Statusè sempre identicoJob:Status. Se hai specificato più di un output:

  • Job:StatuseOutputs:Statusper tutte le uscite èSubmittedfino a quando Elastic Transcoder inizia a elaborare il primo output.

  • Quando Elastic Transcoder inizia a elaborare il primo output,Outputs:Statusper quell'output eJob:Statusentrambi cambiano inProgressing. Per ogni uscita, il valore diOutputs:StatusrestiSubmittedfino a quando Elastic Transcoder inizia a elaborare l'output.

  • Job:StatusrestiProgressingfino a quando tutte le uscite raggiungono lo stato di un terminaleCompleteoError.

  • Quando tutte le uscite raggiungono lo stato di un terminale,Job:Statusmodifiche alleCompletesolo seOutputs:Statusper tutte le uscite èComplete. SeOutputs:Statusper una o più output èError, lo stato del terminale perJob:Statusè ancheError.

Il valore diStatusè uno dei seguenti modi:Submitted,Progressing,Complete,Canceled, oppureError.

(automatico)

Informazioni che spiegano ulteriormenteOutputs:Status.

(automatico) Outputs:AppliedColorSpaceConversion (automatico)

Se Elastic Transcoder ha usato un preset con unColorSpaceConversionModeper transcodificare il file di output,AppliedColorSpaceConversionparametro mostra la conversione utilizzata. Se noColorSpaceConversionModeè stato definito nel preset, questo parametro non sarà incluso nella risposta del lavoro.

(automatico)

Se è stato specificato più di un output per il lavoro, lo stato dell'intero processo. Quando Elastic Transcoder avvia l'elaborazione di un lavoro, il valore diJob:Statusmodifiche alleProgressinge non cambia fino a quando Elastic Transcoder non ha terminato l'elaborazione di tutti gli output. Al termine dell'elaborazione,Job:Statuscambia aCompleteo, se una qualsiasi delle uscite non è riuscita,Error.

Se hai specificato un solo output per il lavoro,Job:Statusè uguale aOutputs:Status.

Il valore diJob:Statusè uno dei seguenti modi:Submitted,Progressing,Complete,Canceled, oppureError.

TimingTiming (automatico)

I dettagli sulla tempistica di un lavoro.

(automatico)

Il momento in cui il lavoro è stato inviato a Elastic Transcoder, in millisecondi d'epoca.

(automatico)

Il momento in cui il lavoro ha iniziato la transcodifica, in millisecondi d'epoca.

(automatico)

Il tempo in cui il lavoro ha terminato la transcodifica, in millisecondi d'epoca.

Per ulteriori informazioni sull'epoca, vai allaEpoch Computingpagina su Wikipedia.

Errori

Per informazioni sulle eccezioni e i messaggi di errore di Elastic Transcoder, consulta la sezioneGestione degli errori in Elastic Transcoder.

Esempi

Richiesta di esempio

La seguente richiesta di esempio recupera il processo con ID 333333333333333-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

Risposta di esempio

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