Aviso de fim do suporte: em 13 de novembro de 2025, o suporte para o Amazon Elastic Transcoder AWS será interrompido. Depois de 13 de novembro de 2025, você não poderá mais acessar o console do Elastic Transcoder ou os recursos do Elastic Transcoder.
Para obter mais informações sobre a transição para AWS Elemental MediaConvert, visite esta [postagem do blog](https://aws.amazon.com/blogs/media/how-to-migrate-workflows-from-amazon-elastic-transcoder-to-aws-elemental-mediaconvert/).
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Ler trabalho
**Topics**
+ [Descrição](#get-job-description)
+ [Solicitações](#get-job-requests)
+ [Respostas](#get-job-responses)
+ [Erros](#get-job-response-errors)
+ [Exemplos](#get-job-examples)
## Descrição
Para obter informações detalhadas sobre um trabalho, envie uma solicitação GET para o recurso `/2012-09-25/jobs/jobId`.
## Solicitações
### Sintaxe
```
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
```
### Parâmetro de solicitação
Esta operação aceita o seguinte parâmetro de solicitação.
**jobId**
O identificador do trabalho para o qual você deseja obter informações detalhadas.
### Cabeçalhos de solicitação
Essa operação usa somente os cabeçalhos de solicitação que são comuns a todas as operações. Para informações sobre os cabeçalhos de solicitação comuns, consulte [Conteúdo de cabeçalho HTTP](making-http-requests.md#http-request-header).
### Corpo da Solicitação
Essa operação não tem um corpo de solicitação.
## Respostas
### Sintaxe
```
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"
}
}
}
```
### Cabeçalhos de resposta
Essa operação usa somente os cabeçalhos de resposta que são comuns a maioria das respostas. Para informações sobre os cabeçalhos de resposta comuns, consulte [Respostas HTTP](making-http-requests.md#http-response-header).
### Corpo da resposta
Para cada trabalho que satisfaz os critérios de pesquisa, o corpo de resposta contém os valores que você especificou quando criou o trabalho. Para obter mais informações sobre os valores de trabalhos, consulte [Configurações especificadas ao criar um trabalho do Elastic Transcoder](job-settings.md).
Além disso, o Elastic Transcoder retorna os seguintes valores.
**(Automático) Id**
O identificador que o Elastic Transcoder atribuiu ao trabalho. Você utiliza esse valor para obter configurações do trabalho ou para excluir o trabalho.
**Entradas (automáticas): DetectedProperties**
As propriedades detectadas do arquivo de entrada. O Elastic Transcoder identifica esses valores no arquivo de entrada.
**(Automático) Inputs:Width**
A largura detectada do arquivo de entrada, em pixels.
**(Automático) Inputs:Height**
A altura detectada do arquivo de entrada, em pixels.
**Entradas (automáticas): FrameRate**
A taxa de quadros detectada do arquivo de entrada, em quadros por segundo.
**Entradas (automáticas): FileSize**
O tamanho do arquivo de entrada detectado, em bytes.
**Entradas (automáticas): DurationMillis**
A duração detectada do arquivo de entrada, em milissegundos.
**(Automático) Outputs:Id**
Um contador sequencial, começando com 1, que identifica uma saída entre as saídas do trabalho atual. Na sintaxe de `Output`, esse valor é sempre `1`.
**(Automático) Outputs:Duration**
Duração do arquivo de saída em segundos, arredondada para cima.
**Saídas (automáticas): DurationMillis**
A duração do arquivo de saída, em milissegundos.
**(Automático) Outputs:Width**
Largura do arquivo de saída, em pixels.
**(Automático) Outputs:Height**
Altura do arquivo de saída, em pixels.
**Saídas (automáticas): FrameRate**
Taxa de quadros do arquivo de saída, em quadros por segundo.
**Saídas (automáticas): FileSize**
O tamanho do arquivo do arquivo de saída, em bytes.
**(Automático) Outputs:Status**
O status de uma saída em um trabalho. Se você especificou somente uma saída para o trabalho, `Outputs:Status` é sempre o mesmo que `Job:Status`. Se você especificou mais de uma saída:
+ `Job:Status` e `Outputs:Status` para todas as saídas é `Submitted` até que o Elastic Transcoder comece a processar a primeira saída.
+ Quando o Elastic Transcoder começa a processar a primeira saída, o `Outputs:Status` para aquela saída e `Job:Status` mudam para `Progressing`. Para cada saída, o valor de `Outputs:Status` permanece `Submitted` até que o Elastic Transcoder comece a processar a saída.
+ O `Job:Status` permanece `Progressing` até que todas as saídas atinjam um status terminal, `Complete` ou `Error`.
+ Quando todas as saídas atingem o status terminal, o `Job:Status` mudará para `Complete` somente se o `Outputs:Status` para todas as saídas for `Complete`. Se `Outputs:Status` para uma ou mais saídas for `Error`, o status terminal para `Job:Status` também será `Error`.
O valor de `Status` é um dos seguintes: `Submitted`, `Progressing`, `Complete`, `Canceled` ou `Error`.
**Saídas (automáticas): StatusDetail**
Informações que explicam melhor o `Outputs:Status`.
**Saídas (automáticas): AppliedColorSpaceConversion**
Se o Elastic Transcoder usou uma predefinição com `ColorSpaceConversionMode` para transcodificar o arquivo de saída, o parâmetro `AppliedColorSpaceConversion` mostra a conversão usada. Se nenhum `ColorSpaceConversionMode` tiver sido definido na predefinição, esse parâmetro não será incluído na resposta do trabalho.
**(Automático) Status**
Se você especificou mais de uma saída para o trabalho, o status do trabalho inteiro. Quando o Elastic Transcoder começa a processar uma tarefa, o valor de `Job:Status` muda para `Progressing` e não muda até que o Elastic Transcoder termine de processar todas as saídas. Quando o processamento estiver concluído, o `Job:Status` muda para `Complete` ou, se alguma das saídas falhar, para `Error`.
Se você especificou somente uma saída para o trabalho, `Job:Status` é o mesmo que `Outputs:Status`.
O valor de `Job:Status` é um dos seguintes: `Submitted`, `Progressing`, `Complete`, `Canceled` ou `Error`.
**(Automático) Timing**
Os detalhes sobre o tempo de um trabalho.
**Cronometragem (automática): SubmitTimeMillis**
A hora em que o trabalho foi enviado ao Elastic Transcoder, em milissegundos de epoch.
**Cronometragem (automática): StartTimeMillis**
A hora em que o trabalho começou a transcodificar, em milissegundos de epoch.
**Cronometragem (automática): FinishTimeMillis**
A hora em que o trabalho terminou de transcodificar, em milissegundos de epoch.
Para saber mais sobre o tempo epoch, acesse a página [Epoch Computing](https://en.wikipedia.org/wiki/Epoch_%28reference_date%29#Computing) na Wikipedia.
## Erros
Para obter mais informações sobre exceções e mensagens de erro do Elastic Transcoder, consulte [Tratamento de erros no Elastic Transcoder](error-handling.md).
## Exemplos
### Exemplo de solicitação
O exemplo de solicitação a seguir obtém o trabalho que tem o ID de trabalho 3333333333333-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
```
### Resposta da amostra
```
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"
}
}
}
```