サポート終了通知: 2025 年 11 月 13 日、 AWS は Amazon 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 による処理がまだ開始されていないジョブをキャンセルするには、DELETE リクエストを `/2012-09-25/jobs/jobId` リソースに送信します。`Read Job`、`List Job by Pipeline`、`List Job by Status` のいずれかのリクエストを送信した場合、Elastic Transcoder によりそれでもジョブが返される可能性はありますが、Elastic Transcoder により入力ファイルのトランスコードが行われないため、そのジョブに対して課金されることはありません。

**注記**  
キャンセルできるのは、ステータスが **[Submitted]** (送信済み) になっているジョブのみです。ジョブの識別子の取得中にパイプラインでジョブの処理が開始されないようにするには、「[パイプラインのステータスを更新する](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 (成功)**  
ジョブが正常にキャンセルされた場合、`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"
}
```