지원 종료 공지: 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-status"></a>

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

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

파이프라인을 일시 중지하거나 다시 활성화하기 위해 파이프라인은 작업 처리를 중지하거나 다시 시작하고 파이프라인의 상태를 업데이트합니다. `/2012-09-25/pipelines/pipelineId/status` 리소스에 POST 요청을 보냅니다.

작업을 하나 이상 취소하려는 경우 파이프라인 상태를 변경하는 것이 유용합니다. Elastic Transcoder가 작업을 처리하기 시작한 후에는 작업을 취소할 수 없습니다. 작업을 제출한 파이프라인을 일시 중지하는 경우, 취소하려는 작업의 작업 ID를 확인한 후 `Delete Job` 요청을 보내야 하므로 시간이 오래 걸립니다.

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

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

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

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

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

**pipelineId**  
일시 중지하거나 다시 활성화하려는 파이프라인의 식별자입니다.

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

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

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

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

**상태**  
파이프라인의 새 상태입니다.  
+ `Active`: 파이프라인이 작업 처리를 시작할 수 있도록 활성화합니다.
+ `Paused`: 파이프라인이 작업 처리를 중지할 수 있도록 비활성화합니다.

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

### 구문
<a name="update-pipeline-status-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

{
   "Id":"ID for the pipeline",
   "Status":"new status for the pipeline"
}
```

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

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

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

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

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

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

## 예제
<a name="update-pipeline-status-examples"></a>

다음 예제 요청은 ID가 `1111111111111-abcde1`인 파이프라인을 활성화합니다.

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

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

### 샘플 응답
<a name="update-pipeline-status-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",
   "Status":"Active"
}
```