终止支持通知：2025 年 11 月 13 日， AWS 我们将停止对亚马逊 Elastic Transcoder 的支持。2025 年 11 月 13 日之后，您将无法再访问 Elastic Transcoder 控制台或 Elastic Transcoder 资源。

有关过渡到的更多信息 AWS Elemental MediaConvert，请访问此[博客文章](https://aws.amazon.com/blogs/media/how-to-migrate-workflows-from-amazon-elastic-transcoder-to-aws-elemental-mediaconvert/)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 取消作业
<a name="cancel-job"></a>

**Topics**
+ [描述](#cancel-job-description)
+ [请求](#cancel-job-requests)
+ [响应](#cancel-job-responses)
+ [错误](#cancel-job-response-errors)
+ [示例](#cancel-job-examples)

## 描述
<a name="cancel-job-description"></a>

要取消 Elastic Transcoder 尚未开始处理的任务，请向 `/2012-09-25/jobs/jobId` 资源发送 DELETE 请求。如果您提交 `Read Job`、`List Job by Pipeline` 或 `List Job by Status` 请求，Elastic Transcoder 可能仍然返回任务，但是 Elastic Transcoder 不会将输入文件转码，且我们不会向您收取任务费用。

**注意**  
您只能取消状态为**已提交**的任务。要防止管道在您获取任务标识符的同时开始处理任务，请使用 [更新管道状态](update-pipeline-status.md) 临时暂停管道。

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

### 语法
<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
```

### 请求参数
<a name="cancel-job-request-parameters"></a>

此操作接受以下请求参数。

** jobId**  
要取消的任务的标识符。  
要获取状态为 `Submitted` 的任务（包括其 `jobId`）的列表，请使用 [按状态列出任务](list-jobs-by-status.md) API 操作。

### 请求标头
<a name="cancel-job-request-headers"></a>

此操作仅使用所有操作通用的请求标头。有关通用请求标头的信息，请参阅 [HTTP 标头内容](making-http-requests.md#http-request-header)。

### 请求正文
<a name="cancel-job-request-body"></a>

此操作没有请求正文。

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

### 语法
<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"
}
```

### 响应标头
<a name="cancel-job-response-headers"></a>

此操作仅使用大多数响应通用的响应标头。有关通用响应标头的信息，请参阅 [HTTP 响应](making-http-requests.md#http-response-header)。

### 响应正文
<a name="cancel-job-response-body"></a>

响应正文包含以下 JSON 对象。

** 成功**  
如果任务已被成功取消，则 `Success` 的值是 `true`。

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

有关 Elastic Transcoder 异常和错误消息的信息，请参阅 [处理 Elastic Transcoder 中的错误](error-handling.md)。

## 示例
<a name="cancel-job-examples"></a>

以下请求示例会取消 ID 为 `3333333333333-abcde3` 的任务。

### 示例请求
<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
```

### 示例响应
<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"
}
```