지원 종료 공지: 2025년 11월 13일에 AWS 는 Amazon Elastic Transcoder에 대한 지원을 중단합니다. 2025년 11월 13일 이후에는 더 이상 Elastic Transcoder 콘솔 또는 Elastic Transcoder 리소스에 액세스할 수 없습니다.

로 전환하는 방법에 대한 자세한 내용은이 [블로그 게시물](https://aws.amazon.com/blogs/media/how-to-migrate-workflows-from-amazon-elastic-transcoder-to-aws-elemental-mediaconvert/)을 AWS Elemental MediaConvert참조하십시오.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 파이프라인 알림 업데이트
<a name="update-pipeline-notifications"></a>

**Topics**
+ [설명](#update-pipeline-notifications-description)
+ [요청](#update-pipeline-notifications-requests)
+ [응답](#update-pipeline-notifications-responses)
+ [오류](#update-pipeline-notifications-response-errors)
+ [예시](#update-pipeline-notifications-examples)

## 설명
<a name="update-pipeline-notifications-description"></a>

파이프라인의 Amazon Simple Notification Service(SNS) 알림만 업데이트하려면 `/2012-09-25/pipelines/pipelineId/notifications` 리소스에 POST 요청을 보냅니다.

**중요**  
알림을 변경하면 변경 사항이 즉시 적용됩니다. 알림을 변경한 후 제출한 작업 외에도 이미 제출했으나 Elastic Transcoder가 처리를 시작하지 않은 작업도 영향을 받습니다.

## 요청
<a name="update-pipeline-notifications-requests"></a>

### 구문
<a name="update-pipeline-notifications-request-syntax"></a>

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

### 요청 파라미터
<a name="update-pipeline-notifications-request-parameters"></a>

이 작업은 다음 요청 파라미터를 사용합니다.

**pipelineId**  
알림 설정을 변경하려는 파이프라인의 식별자입니다.

### 요청 헤더
<a name="update-pipeline-notifications-request-headers"></a>

이 작업은 모든 작업에 일반적인 요청 헤더만 사용합니다. 일반적인 요청 헤더에 대한 내용은 [HTTP 헤더 콘텐츠](making-http-requests.md#http-request-header) 섹션을 참조하세요.

### 요청 본문
<a name="update-pipeline-notifications-request-body"></a>

요청 본문의 JSON 문자열에는 다음 객체가 포함되어 있습니다.

**id**  
업데이트할 파이프라인의 ID입니다.

**알림: 진행 중**  
Elastic Transcoder가 이 파이프라인에서 작업을 처리하기 시작하면 알릴 Amazon Simple Notification Service(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 Developer Guide](https://docs.aws.amazon.com/sns/latest/dg/)를 참조하십시오.

**Notifications:Complete**  
Elastic Transcoder가 이 파이프라인에서 작업 처리를 완료하면 알릴 Amazon SNS 주제의 주제 ARN입니다. 이 값은 주제를 생성할 때 Amazon SNS가 반환한 ARN입니다.

**Notifications:Warning**  
Elastic Transcoder가 이 파이프라인에서 작업을 처리하는 동안 경고 상태가 발생하면 알릴 Amazon SNS 주제의 주제 ARN입니다. 이 값은 주제를 생성할 때 Amazon SNS가 반환한 ARN입니다.

**Notifications:Error**  
Elastic Transcoder가 이 파이프라인에서 작업을 처리하는 동안 오류 상태가 발생하면 알릴 Amazon SNS 주제의 주제 ARN입니다. 이 값은 주제를 생성할 때 Amazon SNS가 반환한 ARN입니다.

## 응답
<a name="update-pipeline-notifications-responses"></a>

### 구문
<a name="update-pipeline-notifications-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
{
   "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"
      }
   }
}
```

### 응답 헤더
<a name="update-pipeline-notifications-response-headers"></a>

이 작업은 대부분의 응답에 일반적인 응답 헤더만 사용합니다. 일반적인 응답 헤더에 대한 내용은 [HTTP 응답](making-http-requests.md#http-response-header) 섹션을 참조하세요.

### 응답 본문
<a name="update-pipeline-notifications-response-body"></a>

파이프라인의 알림을 업데이트하면 Elastic Transcoder는 사용자가 요청에 지정한 값을 반환합니다. 자세한 내용은 [요청 본문](#update-pipeline-notifications-request-body) 단원을 참조하십시오.

## 오류
<a name="update-pipeline-notifications-response-errors"></a>

Elastic Transcoder 예외 및 오류 메시지에 대한 자세한 내용은 [Elastic Transcoder에서의 오류 처리](error-handling.md) 섹션을 참조하세요.

## 예시
<a name="update-pipeline-notifications-examples"></a>

다음 예제 요청은 파이프라인의 알림을 업데이트합니다.

### 샘플 요청
<a name="update-pipeline-notifications-examples-sample-request"></a>

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

### 샘플 응답
<a name="update-pipeline-notifications-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

{
   "Id":"1111111111111-abcde1",
   "Notifications":{
      "Progressing":"",
      "Complete":"",
      "Warning":"",
      "Error":"arn:aws:sns:us-east-1:111222333444:ETS_Errors"
   }
}
```