Aviso de fin de soporte: el 13 de noviembre de 2025, AWS dejaremos de ofrecer soporte a Amazon Elastic Transcoder. Después del 13 de noviembre de 2025, ya no podrás acceder a la consola de Elastic Transcoder ni a los recursos de Elastic Transcoder.
[Para obtener más información sobre la transición a AWS Elemental MediaConvert, visite esta entrada de blog.](https://aws.amazon.com/blogs/media/how-to-migrate-workflows-from-amazon-elastic-transcoder-to-aws-elemental-mediaconvert/)
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Leer tarea
**Topics**
+ [Descripción](#get-job-description)
+ [Solicitudes](#get-job-requests)
+ [Respuestas](#get-job-responses)
+ [Errores](#get-job-response-errors)
+ [Ejemplos](#get-job-examples)
## Descripción
Para obtener información detallada acerca de una tarea, envíe una solicitud GET al recurso `/2012-09-25/jobs/jobId`.
## Solicitudes
### Sintaxis
```
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 solicitud
Esta operación toma el siguiente parámetro de solicitud.
**jobId**
Identificador de la tarea para la que desea obtener información detallada.
### Encabezados de solicitud
Esta operación solo usa encabezados de solicitud que sean comunes para todas las operaciones. Para obtener información acerca de los encabezados de solicitudes comunes, consulte [Contenido de los encabezados HTTP](making-http-requests.md#http-request-header).
### Cuerpo de la solicitud
Esta operación no tiene un cuerpo de la solicitud.
## Respuestas
### Sintaxis
```
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"
}
}
}
```
### Encabezados de respuesta
Esta operación solo usa encabezados de respuesta que sean comunes a la mayoría de las respuestas. Para obtener información acerca de los encabezados de respuestas comunes, consulte [Respuestas HTTP](making-http-requests.md#http-response-header).
### Cuerpo de respuesta
Para cada tarea que satisface los criterios de búsqueda, el cuerpo de respuesta contiene los valores que especificó cuando creó la tarea. Para obtener más información acerca de los valores de la tarea, consulte [Configuración que se especifica para crear una tarea de Elastic Transcoder](job-settings.md).
Además, Elastic Transcoder devuelve los siguientes valores.
**(Automatic) Id**
El identificador que Elastic Transcoder asignó a la tarea. Use este valor para obtener la configuración de la tarea o para eliminarla.
**Entradas (automáticas): DetectedProperties**
Las propiedades detectadas del archivo de entrada. Elastic Transcoder identifica estos valores en el archivo de entrada.
**(Automático) Inputs:Width**
El ancho detectado del archivo de entrada, en píxeles.
**(Automático) Inputs:Height**
El alto detectado del archivo de entrada, en píxeles.
**Entradas (automáticas): FrameRate**
La velocidad de fotogramas detectada del archivo de entrada, en fotogramas por segundo.
**Entradas (automáticas): FileSize**
El tamaño del archivo de entrada detectado, en bytes.
**Entradas (automáticas): DurationMillis**
La duración detectada del archivo de entrada, en milisegundos.
**(Automatic) Outputs:Id**
Un contador secuencial, que cuenta a partir de 1 e identifica una salida entre las salidas de la tarea actual. En la sintaxis de `Output`, este valor siempre es `1`.
**(Automatic) Outputs:Duration**
La duración del archivo de salida en segundos, redondeada por exceso.
**Salidas (automáticas): DurationMillis**
La duración de archivo de salida, en milisegundos.
**(Automatic) Outputs:Width**
El ancho del archivo de salida, en píxeles.
**(Automatic) Outputs:Height**
El alto del archivo de salida, en píxeles.
**Salidas (automáticas): FrameRate**
La velocidad de fotogramas del archivo de salida, en fotogramas por segundo.
**Salidas (automáticas): FileSize**
El tamaño del archivo de salida, en bytes.
**(Automatic) Outputs:Status**
El estado de una salida en una tarea. Si ha especificado una sola salida para la tarea, `Outputs:Status` siempre es el mismo que `Job:Status`. Si ha especificado varias salidas:
+ `Job:Status` y `Outputs:Status` para todas las salidas son `Submitted` hasta que Elastic Transcoder comience a procesar la primera salida.
+ Cuando Elastic Transcoder comience a procesar la primera salida, `Outputs:Status` para esa salida y `Job:Status` cambiarán a la vez a `Progressing`. Para cada salida, el valor de `Outputs:Status` permanece en `Submitted` hasta que Elastic Transcoder comience a procesar la salida.
+ `Job:Status` permanece en `Progressing` hasta que todas las salidas alcancen un estado final, ya sea `Complete` o `Error`.
+ Cuando todas las salidas alcanzan un estado final, `Job:Status` cambia a `Complete` solo si `Outputs:Status` es para todas las salidas `Complete`. Si `Outputs:Status` de una o más salidas es `Error`, el estado final de `Job:Status` también es `Error`.
El valor de `Status` es uno de los siguientes: `Submitted`, `Progressing`, `Complete`, `Canceled` o `Error`.
**Salidas (automáticas): StatusDetail**
Información que explica con más detalle el `Outputs:Status`.
**Salidas (automáticas): AppliedColorSpaceConversion**
Si Elastic Transcoder ha utilizado un elemento preestablecido con un `ColorSpaceConversionMode` para transcodificar el archivo de salida, el parámetro `AppliedColorSpaceConversion` mostrará la conversión utilizada. Si no se ha definido `ColorSpaceConversionMode` en el elemento preestablecido, este parámetro no se incluirá en la respuesta de la tarea.
**(Automatic) Status**
Si ha especificado más de una salida para la tarea, el estado de toda la tarea. Cuando Elastic Transcoder comienza a procesar una tarea, el valor de `Job:Status` cambia a `Progressing` y no vuelve a cambiar hasta que Elastic Transcoder termina de procesar todos los resultados. Cuando finaliza el procesamiento, `Job:Status` cambia a `Complete` o, si alguna de las salidas ha generado un error, a `Error`.
Si ha especificado solo una salida para la tarea, `Job:Status` es el mismo que `Outputs:Status`.
El valor de `Job:Status` es uno de los siguientes: `Submitted`, `Progressing`, `Complete`, `Canceled` o `Error`.
**(Automatic) Timing**
Los detalles sobre la sincronización de una tarea.
**Sincronización (automática): SubmitTimeMillis**
La hora en que se envió la tarea a Elastic Transcoder, en milisegundos desde la fecha de inicio.
**Sincronización (automática): StartTimeMillis**
La hora en que comenzó la transcodificación de la tarea, en milisegundos desde la fecha de inicio.
**Sincronización (automática): FinishTimeMillis**
La hora en que finalizó transcodificación de la tarea, en milisegundos desde la fecha de inicio.
Para obtener más información sobre el tiempo desde la fecha de inicio, visite la página de [ Epoch Computing](https://en.wikipedia.org/wiki/Epoch_%28reference_date%29#Computing) en Wikipedia.
## Errores
Para obtener información acerca de los mensajes de error y las excepciones en Elastic Transcoder, consulte [Gestión de errores en Elastic Transcoder](error-handling.md).
## Ejemplos
### Solicitud de ejemplo
La siguiente solicitud de ejemplo obtiene la tarea que tiene el ID de tarea 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
```
### Respuesta de ejemplo
```
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"
}
}
}
```