작업 상태 알림

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

Elastic Transcoder는 Amazon Simple Notification Service(SNS)를 사용하여 알림을 보냅니다. Amazon SNS는 HTTP 엔드포인트, 이메일 주소 및 Amazon Simple Queue Service(Amazon SQS) 대기열에 메시지를 보내는 기능을 포함하여 다양한 알림 옵션을 제공합니다. 이러한 옵션 및 기타 옵션에 대한 자세한 내용은 Amazon Simple Notification Service 개발자 가이드를 참조하세요.

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

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

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

Elastic Transcoder 콘솔을 사용하여 알림을 구성할 수도 있습니다. 콘솔을 사용하는 경우 파이프라인을 만들거나 업데이트할 때 Amazon SNS 주제를 만들 수 있습니다. 그러나 새로운 주제를 구독하려면 Amazon SNS 콘솔, API 또는 CLI를 사용해야 합니다.

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