Elenco di processi per pipeline - 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à.

Elenco di processi per pipeline

Descrizione

Per ricevere un elenco dei processi assegnati a una pipeline, invia una richiesta GET alla risorsa /2012-09-25/jobsByPipeline/pipelineId. Quando si crea un elenco di processi dalla pipeline, Elastic Transcoder elenca tutti i processi che sono stati creati di recente per la pipeline specificata.

Richieste

Sintassi

Per ricevere informazioni sui processi attualmente inclusi in una pipeline, invia la seguente richiesta GET. 

GET /2012-09-25/jobsByPipeline/pipeline Id?
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

Parametri della richiesta

Questa operazione accetta i seguenti parametri di richiesta. Elastic Transcoder restituisce tutti i processi degli ultimi sei mesi nella pipeline specificata.

IdId pipeline

Per ottenere informazioni sui processi aggiunti a una determinata pipeline, specifica il valore dell'oggetto Id per la pipeline.

Ascendente

Per elencare i processi in ordine cronologico in base alla data e all'ora in cui sono stati inviati, immetti true. Per elencarli in ordine cronologico invertito, immetti false.

Pagina Token

Quando Elastic Transcoder restituisce più pagine di risultati, utilizzaPageTokenin successivoGETrichiede di ottenere ogni successiva pagina di risultati.

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 utilizza 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

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

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

Il corpo della risposta contiene un elemento per ogni processo che soddisfa i criteri di ricerca e ogni elemento 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 serve per ottenere le impostazioni per il processo o per eliminare il processo.

Inputs:DetectedProperties (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, espressa in pixel.

Inputs:Height (automatico)

Altezza del file di input rilevata in pixel.

Inputs:FrameRate (automatico)

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

Inputs:FileSize (automatico)

La dimensione del file di input rilevato, espressa in byte.

DurationMillis (automatico)

La durata del file di input rilevata, espressa in millisecondi.

Outputs:Id (automatico)

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

Outputs:Duration (automatico)

Durata del file di output in secondi, arrotondata.

Outputs:DurationMillisOutputs:DurationMillis

Durata del file di output, espressa in millisecondi.

Outputs:Width (automatico)

Larghezza del file di output in pixel.

Outputs:Height (automatico)

Altezza del file di output in pixel.

Outputs:FrameRate (automatico)

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

(automatico)

La dimensione del file di output, espressa in byte.

Outputs:Status (automatico)

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 terminale,CompleteoError.

  • 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.

StatusOutputs:StatusDetail)

Informazioni che spiegano ulteriormenteOutputs:Status.

(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.

Status (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 delle uscite non è riuscita, aError.

Se hai specificato un solo output per il lavoro,Job:Statusè lo stessoOutputs:Status.

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

TimingTiming (automatico)

I dettagli sulla tempistica di un lavoro.

Timing:SubmitTimeMillis (automatico)

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

Timing:StartTimeMillisTiming:StartTimeMillis

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

Timing:FinishTimeMillis

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

Per ulteriori informazioni sull'epoca, consulta laEpoch Computingpagina su Wikipedia.

(automatico)

Valore utilizzato per accedere alla seconda e successiva pagina dei risultati, se presente. Quando i processi nella pipeline specificata si adattano a una pagina o quando si è raggiunta l'ultima pagina dei risultati, il valore diNextPageTokenènull.

Errori

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

Esempi

La richiesta di esempio seguente crea un processo.

Richiesta di esempio

L'esempio di richiesta riportato di seguito ottiene un elenco di tutti i processi degli ultimi sei mesi assegnati alla pipeline con ID 1111111111111-abcde1. 

GET /2012-09-25/jobsByPipeline/1111111111111-abcde1?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

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

{
   "Jobs":[
      {
         "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"
            }
         }],
         "Outputs":[
            {
               "Id":"1",
               "Key":"cooking/lasagna-KindleFireHD.mp4",
               "ThumbnailPattern":"cooking/lasagna-{count}-KindleFireHD",
               "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":"Submitted",
               "StatusDetail":"Job has been received.",
               "Captions":{
                  "CaptionFormats":[
                     {
                        "Format":"scc",
                        "Pattern":"scc/lasagna-{language}",
                     },
                     {
                        "Format":"srt",
                        "Pattern":"srt/lasagna-{language}"
                     },
                     {
                        "Format":"mov-text"
                     }
                  ]
               }
            },
            {
               "Id":"2",
               "Key":"cooking/lasagna-iPhone4s.mp4",
               "ThumbnailPattern":"cooking/lasagna-{count}-iPhone4s",
               "Rotate":"0",
               "PresetId":"1351620000000-100020",
               "Watermarks":[
                  {
                     "InputKey":"logo/128x64.png",
                     "PresetWatermarkId":"company logo 128x64"
                  }
               ],
               "Duration":"1003",
               "DurationMillis":"1003000",
               "Width":"1920",
               "Height":"1080",
               "FrameRate":"30.00",
               "FileSize":"4718600",
               "Status":"Submitted",
               "StatusDetail":"Job has been received.",
               "AppliedColorSpaceConversion":"None"
            }
         ],
         "PipelineId":"1111111111111-abcde1",
         "Timing":{
            "SubmitTime":"1427212800000",
            "StartTime":"1427212856000",
            "FinishTime":"1427212875000"
         }
      },
      {
         "Id":"4444444444444-abcde4",
         "Input":{
            "Key":"cooking/baked-ziti.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":"1",
               "Key":"cooking/baked-ziti-KindleFireHD.mp4",
               "ThumbnailPattern":"cooking/baked-ziti-{count}-KindleFireHD",
               "Rotate":"0",
               "PresetId":"1351620000000-100080",
               "Watermarks":[
                  {
                     "InputKey":"logo/128x64.png",
                     "PresetWatermarkId":"company logo 128x64"
                  }
               ],
               "Duration":"596",
               "DurationMillis":"1003000",
               "Width":"1280",
               "Height":"720",
               "FrameRate":"30.00",
               "FileSize":"4718600",
               "Status":"Complete",
               "StatusDetail":""
            }
         ],
         "UserMetadata":
            {
               "Food type":"Italian",
               "Cook book":"recipe notebook"
            },
         "PipelineId":"1111111111111-abcde1",
         "Timing":{
            "SubmitTime":"1427212800000",
            "StartTime":"1427212856000",
            "FinishTime":"1427212875000"
         }
      }
   ],
   "NextPageToken":null
}