サポート終了通知: 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/)を参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# パイプラインの通知を更新する
**Topics**
+ [説明](#update-pipeline-notifications-description)
+ [リクエスト](#update-pipeline-notifications-requests)
+ [レスポンス](#update-pipeline-notifications-responses)
+ [エラー](#update-pipeline-notifications-response-errors)
+ [例](#update-pipeline-notifications-examples)
## 説明
パイプラインの 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 ヘッダーの内容](making-http-requests.md#http-request-header)」を参照してください。
### リクエスト本文
リクエストボディの JSON 文字列には、次のオブジェクトが含まれます。
**ID**
更新するパイプラインの ID。
**Notifications:Progressing**
Elastic Transcoder でこのパイプラインのジョブの処理が開始されたときに通知する Amazon Simple Notification Service (Amazon SNS) のトピック ARN。これは、トピックの作成時に Amazon SNS によって返された ARN です。詳細については、[Amazon Simple Notification Service デベロッパーガイド](https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html)の「*トピックの作成*」を参照してください。
通知を受信するには、Amazon SNS コンソールで新しいトピックにサブスクライブする必要があります。
Amazon SNS にはさまざまな通知オプションが用意されており、Amazon Simple Queue Service キューに Amazon SNS メッセージを送信することもできます。詳細については、「[Amazon Simple Notification Service デベロッパーガイド](https://docs.aws.amazon.com/sns/latest/dg/)」を参照してください。
**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 レスポンス](making-http-requests.md#http-response-header)」を参照してください。
### レスポンス本文
パイプラインの通知を更新すると、リクエストで指定した値が Elastic Transcoder によって返されます。詳細については、「[リクエスト本文](#update-pipeline-notifications-request-body)」を参照してください。
## エラー
Elastic Transcoder の例外とエラーメッセージについては、「[Elastic Transcoder でのエラー処理](error-handling.md)」を参照してください。
## 例
以下のリクエスト例では、パイプラインの通知を更新しています。
### リクエスト例
```
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"
}
}
```