Elenco di processi per stato

Descrizione

Per ricevere un elenco dei processi con uno stato specifico, invia una richiesta GET al/2012-09-25/jobsByStatus/Submittedrisorsa. Elastic Transcoder elenca i processi creati di recente e che attualmente presentano lo stato specificato.

Richieste

Sintassi

Per ottenere informazioni sui processi associati all'attuale account AWS con un determinato stato e creati negli ultimi sei mesi, invia la seguente richiesta GET.

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

Parametri della richiesta

Questa operazione richiede i seguenti parametri della richiesta. Elastic Transcoder restituisce tutti i processi creati negli ultimi sei mesi che hanno lo stato specificato.

Stato

Per ottenere informazioni su tutti i processi negli ultimi sei mesi che sono associati all'attuale account AWS e che hanno un determinato stato, specifica lo stato: Submitted, Progressing, Complete, Canceled o Error.

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.

Inputs:Width (automatico)

La larghezza del file di input rilevata in pixel.

Inputs:Height (automatico)

L'altezza del file di input rilevata in pixel.

Inputs:FrameRate

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

Inputs:FileSize (automatico)

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

Inputs:DurationMillisInputs:DurationMillis

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, espressa in pixel.

Outputs:Height (automatico)

Altezza del file di output, espressa in pixel.

Outputs:FrameRate

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

Outputs:FileSize (automatico)

Le dimensioni 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 identico aJob: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ù outputError, lo stato del terminale perJob:Statusè ancheError.

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

Outputs:StatusDetail (automatico)

Informazioni che spiegano ulteriormenteOutputs:Status.

(automatico) Outputs:AppliedColorSpaceConversionSpaceConversion

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 qualsiasi delle uscite non è riuscita,Error.

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

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

Timing( automatico)

I dettagli sulla tempistica di un lavoro.

Timing:SubmitTimeMillisTiming:Invia TimeMillis

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:FinishTimeMillisTiming: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.

NextPageToken (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, consultaGestione 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 creati negli ultimi sei mesi con stato 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

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