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.

# Cancelar trabajo
<a name="cancel-job"></a>

**Topics**
+ [Descripción](#cancel-job-description)
+ [Solicitudes](#cancel-job-requests)
+ [Respuestas](#cancel-job-responses)
+ [Errores](#cancel-job-response-errors)
+ [Ejemplos](#cancel-job-examples)

## Descripción
<a name="cancel-job-description"></a>

Para cancelar una tarea que Elastic Transcoder no ha empezado a procesar, envíe una solicitud de ELIMINACIÓN al recurso `/2012-09-25/jobs/jobId`. Elastic Transcoder podría devolver la tarea si envía una solicitud `Read Job`, `List Job by Pipeline` o `List Job by Status`, pero Elastic Transcoder no transcodificará el archivo de entrada y no se le cobrará la tarea.

**nota**  
Solamente se puede cancelar una tarea cuyo estado sea **Submitted**. Para evitar que una canalización comience a procesar una tarea mientras obtiene el identificador de la tarea, utilice [Actualizar estado de la canalización](update-pipeline-status.md) para detener temporalmente la canalización.

## Solicitudes
<a name="cancel-job-requests"></a>

### Sintaxis
<a name="cancel-job-request-syntax"></a>

```
DELETE /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
<a name="cancel-job-request-parameters"></a>

Esta operación toma el siguiente parámetro de solicitud. 

**jobId**  
Identificador de la tarea que desea cancelar.   
Para obtener una lista de las tareas (incluidos sus `jobId`) que tienen el estado `Submitted`, utilice la acción de la API [Enumerar tareas por estado](list-jobs-by-status.md).

### Encabezados de solicitud
<a name="cancel-job-request-headers"></a>

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
<a name="cancel-job-request-body"></a>

Esta operación no tiene un cuerpo de la solicitud.

## Respuestas
<a name="cancel-job-responses"></a>

### Sintaxis
<a name="cancel-job-response-syntax"></a>

```
Status: 202 Accepted
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

{
   "Success":"true"
}
```

### Encabezados de respuesta
<a name="cancel-job-response-headers"></a>

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
<a name="cancel-job-response-body"></a>

El cuerpo de la respuesta contiene el siguiente objeto JSON.

**Correcto**  
Si se cancela la tarea correctamente, el valor de `Success` es `true`.

## Errores
<a name="cancel-job-response-errors"></a>

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
<a name="cancel-job-examples"></a>

La siguiente solicitud de ejemplo cancela la tarea la canalización que tiene el ID `3333333333333-abcde3`.

### Solicitud de muestra
<a name="cancel-job-examples-sample-request"></a>

```
DELETE /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
<a name="cancel-job-examples-sample-response"></a>

```
Status: 202 Accepted
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
{
   "Success":"true"
}
```