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à.
# Creazione di un processo
**Topics**
+ [Descrizione](#create-job-description)
+ [Richieste](#create-job-requests)
+ [Risposte](#create-job-responses)
+ [Errori](#create-job-response-errors)
+ [Esempi](#create-job-examples)
## Descrizione
Per creare un processo, invia una richiesta POST alla risorsa `/2012-09-25/jobs`. I processi si avviano non appena vengono creati.
**Nota**
Puoi configurare Elastic Transcoder in modo che ti invii una notifica quando lo stato di un lavoro cambia, incluso quando Elastic Transcoder inizia e termina l'elaborazione di un lavoro e quando Elastic Transcoder incontra una condizione di avviso o errore. Per ulteriori informazioni, consulta [Creazione di una pipeline](create-pipeline.md).
## Richieste
### Sintassi
```
POST /2012-09-25/jobs HTTP/1.1
Content-Type: application/json; 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
Content-Length: number of characters in the JSON string
{
"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",
"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",
"InputCaptions":{
"MergePolicy":"MergeOverride|MergeRetain|Override",
"CaptionSources":[
{
"Key":"name of the input caption file",
"Encryption":{
"Mode":"aes-cbc-pkcs7|aes-ctr|aes-gcm",
"Key":"encrypted and base64-encoded encryption key",
"KeyMd5":"base64-encoded key digest",
"InitializationVector":"base64-encoded
initialization vector"
},
"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"
},
{...}
]
}
},
{...}
]
"OutputKeyPrefix":"prefix for file names in Amazon S3 bucket",
"Outputs":[{
"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"
},
{...}
]
},
{...}
],
"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"
}
},
{...}
]
}
},
{...}],
"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":"pipeline to use for transcoding"
}
```
### Parametri della richiesta
Questa operazione non utilizza parametri richiesta.
### 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
La stringa JSON nel corpo della richiesta contiene gli oggetti di input per l'operazione `CreateJob`. Per ulteriori informazioni sugli oggetti di input, consulta [Impostazioni specificate durante la creazione di un lavoro Elastic Transcoder](job-settings.md).
## Risposte
### Sintassi
```
Status: 201 Created
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 assigns 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",
"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",
"Width":"width in pixels",
"Height":"height in pixels",
"Status":"Submitted|Progressing|Complete|Canceled|Error",
"StatusDetail":"additional information about job 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":{
"key1":"First user metadata value",
"key2":"Second user metadata value"
},
"PipelineId":"pipeline to add the job to",
"Status":"Submitted|Progressing|Complete|Canceled|Error"
}
}
```
### 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
Quando crei un lavoro, Elastic Transcoder restituisce i valori che hai specificato nella richiesta. Per ulteriori informazioni, 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.
**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): larghezza**
Larghezza del file di output, in pixel.
**Uscite (automatiche): altezza**
Altezza del file di output, in pixel.
**Uscite (automatiche): Stato**
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 lo è. `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 hai 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` passa 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`.
## Errori
Per informazioni sulle eccezioni e sui messaggi di errore di Elastic Transcoder, consulta. [Gestione degli errori in Elastic Transcoder](error-handling.md)
**Nota**
Se un processo ha esito negativo con errore `Access Denied`, ti consigliamo di eseguire l'operazioni API `Test Role` per determinare la causa dell'errore. Per ulteriori informazioni, consulta [Ruolo di test](test-pipeline-role.md).
## Esempi
La seguente richiesta di esempio crea un processo con due output.
### Richiesta di esempio
```
POST /2012-09-25/jobs HTTP/1.1
Content-Type: application/json; 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
Content-Length: number of characters in the JSON string
{
"Inputs":[{
"Key":"recipes/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"
}
]
}
}]
"OutputKeyPrefix":"recipes/",
"Outputs":[
{
"Key":"mp4/lasagna-kindlefirehd.mp4",
"ThumbnailPattern":"mp4/thumbnails/lasagna-{count}",
"Rotate":"0",
"PresetId":"1351620000000-100080",
"Watermarks":[
{
"InputKey":"logo/128x64.png",
"PresetWatermarkId":"company logo 128x64"
}
],
"Captions":{
"CaptionFormats":[
{
"Format":"scc",
"Pattern":"scc/lasagna-{language}"
},
{
"Format":"srt",
"Pattern":"srt/lasagna-{language}",
}
]
}
},
{
"Key":"iphone/lasagna-1024k",
"ThumbnailPattern":"iphone/th1024k/lasagna-{count}",
"Rotate":"0",
"PresetId":"1351620000000-987654",
"SegmentDuration":"5"
},
{
"Key":"iphone/lasagna-512k",
"ThumbnailPattern":"iphone/th512k/lasagna-{count}",
"Rotate":"0",
"PresetId":"1351620000000-456789",
"SegmentDuration":"5"
},
],
"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"
}
```
### Risposta di esempio
```
Status: 201 Created
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":"recipes/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"
}
]
}
}],
"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",
"Width":"1280",
"Height":"720",
"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",
"Width":"1136",
"Height":"640",
"Status":"Progressing",
"StatusDetail":""
},
{
"Id":"3",
"Key":"iphone/lasagna-512k",
"ThumbnailPattern":"iphone/th512k/lasagna-{count}",
"Rotate":"0",
"PresetId":"1351620000000-456789",
"SegmentDuration":"5",
"Duration":"1003",
"Width":"1136",
"Height":"640",
"Status":"Complete",
"StatusDetail":"",
"AppliedColorSpaceConversion":"None"
}
],
"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"
}
}
```