パイプラインの通知を更新する - Amazon Elastic Transcoder
説明リクエストレスポンスエラー例

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

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

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

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

パイプラインの通知を更新する

説明

パイプラインの Amazon Simple Notification Service (Amazon SNS) 通知のみを更新するには、/2012-09-25/pipelines/pipelineId/notifications リソースに POST リクエストを送信します。

重要

通知を変更すると、その変更はすぐに反映されます。通知の変更後に送信するジョブだけでなく、すでに送信したが Elastic Transcoder によってまだ処理が開始されていないジョブにも、変更は適用されます。

リクエスト

構文

POST /2012-09-25/pipelines/pipelineId/notifications 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
{
   "Id":"pipelineId",
   "Notifications":{
      "Progressing":"SNS topic to notify when
         Elastic Transcoder has started to process the job",
      "Complete":"SNS topic to notify when
         Elastic Transcoder has finished processing the job",
      "Warning":"SNS topic to notify when
      	Elastic Transcoder returns a warning",
      "Error":"SNS topic to notify when
         Elastic Transcoder returns an error"
   }
}

リクエストパラメータ

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

PipelineId

通知設定を変更するパイプラインの識別子。

リクエストヘッダー

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

リクエスト本文

リクエストボディの JSON 文字列には、次のオブジェクトが含まれます。

ID

更新するパイプラインの ID。

Notifications:Progressing

Elastic Transcoder でこのパイプラインのジョブの処理が開始されたときに通知する Amazon Simple Notification Service (Amazon SNS) のトピック ARN。これは、トピックの作成時に Amazon SNS によって返された ARN です。詳細については、Amazon Simple Notification Service デベロッパーガイドの「トピックの作成」を参照してください。

重要

通知を受信するには、Amazon SNS コンソールで新しいトピックにサブスクライブする必要があります。

Amazon SNS にはさまざまな通知オプションが用意されており、Amazon Simple Queue Service キューに Amazon SNS メッセージを送信することもできます。詳細については、Amazon Simple Notification Service デベロッパーガイドを参照してください。

Notifications:Complete

Elastic Transcoder でこのパイプラインのジョブの処理が終了したときに通知する Amazon Simple Notification Service (Amazon SNS) のトピック ARN。これは、トピックの作成時に Amazon SNS によって返された ARN です。

Notifications:Warning

Elastic Transcoder でこのパイプラインのジョブの処理中に警告が発生したときに通知する Amazon Simple Notification Service (Amazon SNS) のトピック ARN。これは、トピックの作成時に Amazon SNS によって返された ARN です。

Notifications:Error

Elastic Transcoder でこのパイプラインのジョブの処理中にエラーが発生したときに通知する Amazon Simple Notification Service (Amazon SNS) のトピック ARN。これは、トピックの作成時に Amazon SNS によって返された ARN です。

レスポンス

構文

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
{
   "Pipeline":{
      "Id":"ID for the new pipeline",
      "Notifications":{
         "Progressing":"SNS topic to notify when Elastic Transcoder has started to process the job",
         "Complete":"SNS topic to notify when Elastic Transcoder has finished processing the job",
         "Warning":"SNS topic to notify when Elastic Transcoder returns a warning",
         "Error":"SNS topic to notify when Elastic Transcoder returns an error"
      }
   }
}

レスポンスヘッダー

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

レスポンス本文

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

エラー

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

例

以下のリクエスト例では、パイプラインの通知を更新しています。

リクエスト例

POST /2012-09-25/pipelines/1111111111111-abcde1/notifications 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
{
   "Id":"1111111111111-abcde1",
   "Notifications":{
      "Progressing":"",
      "Complete":"",
      "Warning":"",
      "Error":"arn:aws:sns:us-east-1:111222333444:ETS_Errors"
   }
}

レスポンス例

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",
   "Notifications":{
      "Progressing":"",
      "Complete":"",
      "Warning":"",
      "Error":"arn:aws:sns:us-east-1:111222333444:ETS_Errors"
   }
}