작업 상태 알림

Elastic Transcoder는 작업 상태가 변경되면 알림을 보냅니다. 다음 상태 변화의 조합(또는 없음)에 대해 알림을 보내도록 Elastic Transcoder를 구성할 수 있습니다.

• 처리 중: Elastic Transcoder가 파이프라인에서 작업 처리를 시작했습니다.

• 완료됨: 가 파이프라인에서 작업 처리를 완료했습니다.

• 경고: 파이프라인에서 작업을 처리하는 도중 Elastic Transcoder에 경고 상태가 발생했습니다.

• 오류: 파이프라인에서 작업을 처리하는 도중 Elastic Transcoder에 오류 상태가 발생했습니다.

Elastic Transcoder는 아마존 심플 알림 서비스 (아마존) 를 사용하여 알림을 전송합니다. SNS Amazon은 HTTP 엔드포인트로 메시지를 보내는 기능, 이메일 주소, Amazon 심플 큐 서비스 (AmazonSQS) 대기열을 비롯한 다양한 알림 옵션을 SNS 제공합니다. 이러한 옵션 및 기타 옵션에 대한 자세한 내용은 Amazon Simple Notification Service 개발자 가이드를 참조하세요.

알림은 이벤트 중심 애플리케이션을 설계하는 데 유용합니다. 알림을 사용하여 작업 완료 시점을 확인하면 폴링을 없앨 수 있으며 폴링으로 인해 가끔 발생하는 Limit Exceeded 예외 (HTTP상태 코드 429) 가 발생하지 않습니다.

알림은 파이프라인을 만들거나 업데이트할 때 구성합니다. Elastic Transcoder는 해당 파이프라인에 제출하는 모든 작업에 관련 알림을 보냅니다.

중요

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

Elastic Transcoder를 사용할 때 작업 상태의 변경 사항을 알리도록 Elastic Transcoder를 구성하려면: API

1. Amazon SNS 주제를 하나 이상 생성하고 각 주제를 구독하십시오. 자세한 내용은 Amazon Simple Notification Service 설명서를 참조하세요.

   사용하려는 Amazon SNS 주제가 이미 있는 경우 이 단계를 건너뛰어도 됩니다.

2. 파이프라인을 만들거나 기존 파이프라인을 업데이트합니다. 알림을 받고자 하는 각 상태 변경 (진행 중, 완료, 경고, 오류) 에 대해 1단계에서 생성한 해당 Amazon SNS 주제를 지정하십시오. 자세한 내용은 파이프라인 생성, 파이프라인 업데이트 또는 파이프라인 알림 업데이트 섹션을 참조하세요.

3. Elastic Transcoder로 작업을 제출하여 Progressing 및 Complete 상태에 대한 알림을 테스트합니다.

Elastic Transcoder 콘솔을 사용하여 알림을 구성할 수도 있습니다. 콘솔을 사용하는 경우 파이프라인을 생성하거나 업데이트할 때 Amazon SNS 주제를 생성할 수 있습니다. 하지만 여전히 Amazon SNS 콘솔을 사용하거나 새 주제를 CLI 구독해야 합니다. API

Elastic Transcoder에서 상태 변경 알림을 보내면 알림에서 반환되는 메시지는 다음 형식으로 표시됩니다. JSON 메시지에는 각 출력의 상태와 해당 작업의 상태가 나와 있습니다.

{
   "state" : "PROGRESSING|COMPLETED|WARNING|ERROR",
   "errorCode" : "the code of any error that occurred",
   "messageDetails" : "the notification message you created in Amazon SNS",
   "version" : "API version that you used to create the job",
   "jobId" : "value of Job:Id object that Elastic Transcoder 
             returns in the response to a Create Job request",
   "pipelineId" : "value of PipelineId object 
                  in the Create Job request",
   "input" : {
      job Input settings
   },
   "outputKeyPrefix" : "prefix for file names in Amazon S3 bucket",
   "outputs": [
      {
         applicable job Outputs settings,
         "status" : "Progressing|Complete|Warning|Error"
      },
      {...}
   ],
   "playlists": [
      {
         applicable job playlists settings
      }
   ],
   "userMetadata": {
      "metadata key": "metadata value"
   }
}