パイプラインのステータスを更新する - Amazon Elastic Transcoder

でコストを節約し、より多くの機能を取得 AWS Elemental MediaConvert

MediaConvert は、包括的な一連の高度なトランスコード機能を提供する、より新しいファイルベースのビデオトランスコードサービスで、オンデマンド料金は 1 分あたり 0.0075 USD からとなります。もっと読む

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

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

パイプラインのステータスを更新する

説明

パイプラインを一時停止するか再びアクティブにするには (パイプライン内のジョブを停止するか再開するには)、パイプラインのステータスを更新します。/2012-09-25/pipelines/pipelineId/status リソースに POST リクエストを送信します。

パイプラインのステータスの変更は、1 つ以上のジョブをキャンセルする場合に便利です。ジョブは Elastic Transcoder による処理の開始後にキャンセルすることはできません。ジョブを送信した先のパイプラインを一時停止する場合は、キャンセルするジョブの ID を取得して Delete Job リクエストを送信するための時間が余分にかかります。

リクエスト

構文

POST /2012-09-25/pipelines/pipelineId/status HTTP/1.1 Content-Type: application/json; 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 Content-Length: number of characters in the JSON string { "Status":"new status for the pipeline" }

リクエストパラメータ

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

pipelineId

一時停止または再びアクティブにするパイプラインの識別子。

リクエストヘッダー

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

リクエスト本文

リクエストの本文内の JSON 文字列には、以下のオブジェクトが含まれます。

ステータス

パイプラインの新しいステータス:

  • Active: パイプラインが有効になり、ジョブの処理が開始されます。

  • Paused: パイプラインが無効になり、ジョブの処理が停止します。

レスポンス

構文

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 { "Id":"ID for the pipeline", "Status":"new status for the pipeline" }

レスポンスヘッダー

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

レスポンス本文

パイプラインのステータスを更新すると、リクエストで指定した値が Elastic Transcoder によって返されます。詳細については、「リクエスト本文」を参照してください。

エラー

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

以下のリクエスト例では、ID が 1111111111111-abcde1 であるパイプラインを有効にしています。

リクエスト例

POST /2012-09-25/pipelines/1111111111111-abcde1/status HTTP/1.1 Content-Type: application/json; 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 Content-Length: number of characters in the JSON string { "Status":"Active" }

レスポンス例

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 { "Id":"1111111111111-abcde1", "Status":"Active" }