파이프라인 상태 업데이트

설명

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

작업을 하나 이상 취소하려는 경우 파이프라인 상태를 변경하는 것이 유용합니다. 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"
}