Avviso di fine del supporto: il 13 novembre 2025, il supporto per Amazon Elastic Transcoder AWS verrà interrotto. Dopo il 13 novembre 2025, non potrai più accedere alla console Elastic Transcoder o alle risorse Elastic Transcoder.
[Per ulteriori informazioni sulla transizione a, consulta questo post del blog AWS Elemental MediaConvert.](https://aws.amazon.com/blogs/media/how-to-migrate-workflows-from-amazon-elastic-transcoder-to-aws-elemental-mediaconvert/)
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 stato
**Topics**
+ [Descrizione](#list-jobs-by-status-description)
+ [Richieste](#list-jobs-by-status-requests)
+ [Risposte](#list-jobs-by-status-responses)
+ [Errori](#list-jobs-by-status-response-errors)
+ [Esempi](#list-jobs-by-status-examples)
## Descrizione
Per ottenere un elenco dei lavori con uno stato specificato, invia una richiesta GET alla `/2012-09-25/jobsByStatus/Submitted` risorsa. Elastic Transcoder elenca i lavori che hai creato di recente e che attualmente hanno 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 di richiesta. Elastic Transcoder restituisce tutti i lavori degli ultimi sei mesi con 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`.
**PageToken**
Quando Elastic Transcoder restituisce più di una pagina di risultati, `PageToken` utilizzala nelle richieste `GET` successive per ottenere ogni pagina successiva 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](making-http-requests.md#http-request-header).
### 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](making-http-requests.md#http-response-header).
### 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 specificate durante la creazione di un lavoro Elastic Transcoder](job-settings.md).
Inoltre, Elastic Transcoder restituisce i seguenti valori.
**ID (Automatico)**
L'identificatore che Elastic Transcoder ha assegnato al lavoro. Questo valore viene utilizzato per ottenere le impostazioni per il lavoro o per eliminarlo.
**Ingressi (automatici): DetectedProperties**
Le proprietà rilevate del file di input. Elastic Transcoder identifica questi valori dal file di input.
**Ingressi (automatici): larghezza**
La larghezza rilevata del file di input, in pixel.
**Ingressi (automatici): altezza**
L'altezza rilevata del file di input, in pixel.
**Ingressi (automatici): FrameRate**
La frequenza dei fotogrammi rilevata del file di input, in fotogrammi al secondo.
**Ingressi (automatici): FileSize**
La dimensione rilevata del file di input, in byte.
**Ingressi (automatici): DurationMillis**
La durata rilevata del file di input, in millisecondi.
**Uscite (automatiche): Id**
Un contatore sequenziale, che inizia con 1, che identifica un'uscita tra le uscite del lavoro corrente. Nella `Output` sintassi, questo valore è sempre. `1`
**Uscite (automatiche): durata**
Durata del file di output in secondi, arrotondata per eccesso.
**Uscite (automatiche): DurationMillis**
Durata del file di output, in millisecondi.
**Uscite (automatiche): larghezza**
Larghezza del file di output, in pixel.
**Uscite (automatiche): altezza**
Altezza del file di output, in pixel.
**Uscite (automatiche): FrameRate**
Frequenza dei fotogrammi del file di output, in fotogrammi al secondo.
**Uscite (automatiche): FileSize**
Dimensione del file di output, in byte.
**Uscite (automatiche): Status**
Lo stato di un output in un lavoro. Se è stato specificato un solo output per il lavoro, `Outputs:Status` è sempre lo stesso di`Job:Status`. Se hai specificato più di un output:
+ `Job:Status`e `Outputs:Status` per tutti gli output è `Submitted` fino a quando Elastic Transcoder non inizia a elaborare il primo output.
+ Quando Elastic Transcoder inizia a elaborare il primo output`Outputs:Status`, per quell'output `Job:Status` ed entrambi cambiano in. `Progressing` Per ogni output, il valore di `Outputs:Status` rimane `Submitted` fino a quando Elastic Transcoder non inizia a elaborare l'output.
+ `Job:Status`rimane `Progressing` finché tutte le uscite non raggiungono lo stato di terminale, oppure. `Complete` `Error`
+ Quando tutte le uscite raggiungono lo stato di terminale, `Job:Status` passa a `Complete` solo se `Outputs:Status` per tutte le uscite è. `Complete` Se `Outputs:Status` per una o più uscite è`Error`, lo è anche lo stato del terminale per`Job:Status`. `Error`
Il valore di `Status` è uno dei seguenti:`Submitted`,`Progressing`, `Complete``Canceled`, o`Error`.
**Uscite (automatiche): StatusDetail**
Informazioni che `Outputs:Status` spiegano ulteriormente.
**Uscite (automatiche): AppliedColorSpaceConversion**
Se Elastic Transcoder ha utilizzato una preimpostazione con `ColorSpaceConversionMode` a per transcodificare il file di output, `AppliedColorSpaceConversion` il parametro mostra la conversione utilizzata. Se nella preimpostazione non `ColorSpaceConversionMode` è stato definito alcun, questo parametro non verrà incluso nella risposta al lavoro.
**Stato (Automatico)**
Se è stato specificato più di un output per il lavoro, lo stato dell'intero lavoro. Quando Elastic Transcoder inizia a elaborare un lavoro, il valore `Job:Status` di cambia e non cambia `Progressing` finché Elastic Transcoder non ha terminato l'elaborazione di tutti gli output. Una volta completata l'elaborazione, `Job:Status` modifica a `Complete` o, se uno degli output fallisce, a. `Error`
Se è stato specificato un solo output per il lavoro, `Job:Status` è lo stesso `Outputs:Status` di.
Il valore di `Job:Status` è uno dei seguenti:`Submitted`, `Progressing``Complete`,`Canceled`, o`Error`.
**(Automatico) Cronometraggio**
I dettagli sulla tempistica di un lavoro.
**Tempistica (Automatica): SubmitTimeMillis**
L'ora in cui il lavoro è stato inviato a Elastic Transcoder, in millisecondi epoch.
**Tempistica (automatica): StartTimeMillis**
L'ora in cui il processo ha iniziato la transcodifica, in millisecondi epocali.
**Tempistica (Automatica): FinishTimeMillis**
L'ora in cui il processo ha terminato la transcodifica, in millisecondi di epoca.
[Per saperne di più su Epoch Time, vai alla pagina Epoch Computing su Wikipedia.](https://en.wikipedia.org/wiki/Epoch_%28reference_date%29#Computing)
**(Automatico) NextPageToken**
Valore utilizzato per accedere alla seconda e alle successive pagine di risultati, se presenti. Quando i lavori della pipeline specificata rientrano in una pagina o quando hai raggiunto l'ultima pagina di risultati, il valore di `NextPageToken` è`null`.
## Errori
Per informazioni sulle eccezioni e sui messaggi di errore di Elastic Transcoder, consulta. [Gestione degli errori in Elastic Transcoder](error-handling.md)
## 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
}
```