ジョブをキャンセルする - Amazon Elastic Transcoder
説明リクエストレスポンスエラー例

コストを節約し、より多くの機能を利用しましょう AWS Elemental MediaConvert

MediaConvert は、高度なトランスコーディング機能を幅広く提供する、新しいファイルベースの動画トランスコーディングサービスです。オンデマンド料金は 1 分あたり 0.0075 USD からです。もっと読む。

既に Amazon Elastic Transcoder をご使用中ですか？ MediaConvertへの移行は簡単です。詳細については、移行プロセスに関する貴重な情報やその他のリソースへのリンクを記載した本概要を参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

ジョブをキャンセルする

説明

Elastic Transcoder による処理がまだ開始されていないジョブをキャンセルするには、DELETE リクエストを /2012-09-25/jobs/jobId リソースに送信します。Read Job、List Job by Pipeline、List Job by Status のいずれかのリクエストを送信した場合、Elastic Transcoder によりそれでもジョブが返される可能性はありますが、Elastic Transcoder により入力ファイルのトランスコードが行われないため、そのジョブに対して課金されることはありません。

注記

キャンセルできるのは、ステータスが [Submitted] (送信済み) になっているジョブのみです。ジョブの識別子の取得中にパイプラインでジョブの処理が開始されないようにするには、「パイプラインのステータスを更新する」の手順を使用してパイプラインを一時停止します。

リクエスト

構文

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

リクエストパラメータ

このオペレーションでは、次のリクエストパラメーターを使用します。

JobId

キャンセルするジョブの識別子。

ステータスが Submitted であるジョブのリストを (jobId も含めて) 取得するには、ステータスに基づくジョブのリスト API アクションを使用します。

リクエストヘッダー

この操作では、すべての操作で共通のリクエストヘッダーのみ使用します。共通のリクエストヘッダーの詳細については、「HTTP ヘッダーの内容」を参照してください。

リクエスト本文

この操作にリクエストボディはありません。

レスポンス

構文

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"
}

レスポンスヘッダー

この操作はほとんどのレスポンスに共通のレスポンスヘッダーのみを使用します。共通のレスポンスヘッダーの詳細については、「HTTP レスポンス」を参照してください。

レスポンス本文

応答の本文には、以下の JSON オブジェクトが含まれます。

成功

ジョブが正常にキャンセルされた場合、Success の値は true です。

エラー

Elastic Transcoder の例外とエラーメッセージについては、「Elastic Transcoder でのエラー処理」を参照してください。

例

以下のリクエスト例では、ID が 3333333333333-abcde3 であるジョブをキャンセルしています。

リクエスト例

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

レスポンス例

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"
}