Elastic Transcoder에 대한 HTTP 요청 만들기 - Amazon Elastic Transcoder
HTTP 헤더 콘텐츠HTTP 요청 본문HTTP 응답

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

로 전환하는 방법에 대한 자세한 내용은이 블로그 게시물을 AWS Elemental MediaConvert참조하세요.

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

Elastic Transcoder에 대한 HTTP 요청 만들기

RFC 2616에 정의되어 있는 것처럼, Elastic Transcoder REST 요청은 HTTPS 요청입니다. (자세한 내용은 http://www.ietf.org/rfc/rfc2616.txt를 참조하세요.) 이 섹션에서는 Elastic Transcoder REST 요청의 구조를 설명합니다. 수행할 수 있는 작업에 대한 자세한 설명은 파이프라인 작업, 작업, 프리셋 작업을 참조하세요.

일반적인 REST 작업은 HTTPS 요청을 Elastic Transcoder로 보내고 응답을 기다리는 과정으로 구성됩니다. HTTP 요청과 마찬가지로, Elastic Transcoder에 대한 REST 요청에는 요청 방법, URI, 요청 헤더, 그리고 때로는 쿼리 문자열이나 요청 본문이 포함됩니다. 응답에는 HTTP 상태 코드, 응답 헤더, 그리고 때로는 응답 본문이 포함됩니다.

HTTP 헤더 콘텐츠

Elastic Transcoder 작업 시 HTTP 요청의 헤더에 다음 정보를 제공해야 합니다.

호스트(필수)

리소스가 생성되는 위치를 지정하는 Elastic Transcoder 엔드포인트입니다. 이 값은 명명된 리전 엔드포인트여야 합니다. Amazon S3 버킷과 Elastic Transcoder 파이프라인 및 작업에 동일한 엔드포인트를 사용하는 것이 좋습니다. 서로 다른 엔드포인트를 사용하면 Amazon S3 버킷이 포함된 리전과 Elastic Transcoder가 인코딩하는 리전 간에 전송되는 데이터에 대해 추가 요금이 발생합니다. 또한 데이터 전송에 필요한 시간으로 인해 트랜스코딩된 파일에 대한 액세스가 지연됩니다.

지원되는 모든 Elastic Transcoder 엔드포인트 목록은 Amazon Web Services 일반 참조에서 리전 및 엔드포인트 섹션을 참조하세요.

리전 간 요금에 대한 자세한 내용은 Amazon S3 요금의 데이터 전송 요금을 참조하세요.

x-amz-date 또는 날짜(필수)

Authorization 헤더에 포함된 서명을 만드는 데 사용되는 날짜. ISO 8601 표준 형식을 사용하여 UTC 시간으로 날짜를 지정합니다. 예: X-Amz-Date: 20130613T203622Z.

x-amz-date 또는 Date를 포함시켜야 합니다. 일부 HTTP 클라이언트 라이브러리에서는 Date 헤더를 설정할 수 없습니다. x-amz-date 헤더가 있으면 요청 인증 시 모든 Date 헤더가 무시됩니다.

타임스탬프는 요청 수신 시 AWS 시스템 시간이 15분 이내여야 합니다. 그렇지 않으면 다른 사람이 요청을 재생하는 것을 방지하기 위해 RequestExpired 오류 코드와 함께 요청이 실패합니다.

권한 부여(필수)

요청 인증에 필요한 정보. 이 헤더를 구성하는 방법에 대한 자세한 내용은 요청에 서명하기 섹션을 참조하세요.

Content-Type(조건부)

JSON 및 버전을 지정합니다. 예: Content-Type: application/x-amz-json-1.0.

조건: POST 요청에 필수입니다.

Content-Length(조건부)

RFC 2616에 따른 메시지의 길이(헤더 제외).

조건: 요청 본문 자체에 정보가 포함되어 있는 경우에 필요합니다(대부분의 도구 키트는 이 헤더를 자동으로 추가함).

다음은 파이프라인을 생성하기 위한 HTTP 요청의 헤더 예제입니다.

POST /2012-09-25/pipelines HTTP/1.1
host: elastictranscoder.us-east-1.amazonaws.com:443
x-amz-date: 20120116T174952Z
Authorization: AWS4-HMAC-SHA256 Credential=AccessKeyID/20120116/us-east-1/elastictranscoder/aws4_request,SignedHeaders=host;x-amz-date;x-amz-target,Signature=145b1567ab3c50d929412f28f52c45dbf1e63ec5c66023d232a539a4afd11fd9
content-type: application/x-amz-json-1.0
content-length: 231
connection: Keep-Alive

HTTP 요청 본문

많은 Elastic Transcoder API 작업에는 JSON 형식의 데이터를 요청 본문에 포함시켜야 합니다. JSON은 Elastic Transcoder 스키마를 준수합니다.

참고

요청 본문 내 JSON 값은 문자열입니다.

예 요청

다음 예제 요청은 간단한 JSON 문을 사용하여 sample.mp4라는 파일을 트랜스코딩하고 이를 sams-birthday.mp4로 저장하는 작업을 만듭니다.

POST /2012-09-25/jobs HTTP/1.1
Content-Type: application/json; charset=UTF-8
Accept: */*
Host: elastictranscoder.us-east-1.amazonaws.com:443
Content-Length: 300
 
{
   "Input":{
      "Key":"sample.mp4",
      "FrameRate":"auto",
      "Resolution":"auto",
      "AspectRatio":"auto",
      "Interlaced":"auto",
      "Container":"mp4"
   },
   "OutputKeyPrefix":"family-videos/",
   "Outputs":[
      {
         "Key":"sams-birthday.mp4",
         "ThumbnailPattern":"thumbnails/sams-birthday-{count}",
         "Rotate":"0",
         "PresetId":"1351620000000-100080"
      }
   ],
   "PipelineId":"1111111111111-abcde1"
}

HTTP 응답

모든 Elastic Transcoder API 작업에서는 JSON 형식의 데이터가 응답에 포함됩니다. JSON은 Elastic Transcoder 스키마를 준수합니다.

참고

응답 내 JSON 값은 문자열입니다.

다음은 HTTP 응답의 몇 가지 중요 헤더와 해당되는 경우 애플리케이션에서 이 헤더를 처리하는 방법입니다.

HTTP/1.1

이 헤더 다음에는 상태 코드가 이어집니다. 상태 코드 200은 작업 성공을 나타냅니다. 오류 코드에 대한 자세한 내용은 API 오류 코드(클라이언트 및 서버 오류) 섹션을 참조하세요.

유형: 문자열

x-amzn-RequestId

요청을 고유하게 식별하기 위해 Elastic Transcoder가 생성한 값입니다(예: K2QH8DNOU907N97FNA2GDLL8OBVV4KQNSO5AEMVJF66Q9ASUAAJG). Elastic Transcoder에 문제가 있는 경우 AWS는 이 값을 사용하여 문제를 해결할 수 있습니다. 이러한 값을 로깅할 것을 권장합니다.

유형: 문자열

Content-Length

응답 본문의 길이(바이트)입니다.

유형: 문자열

날짜

Elastic Transcoder가 응답한 날짜 및 시간입니다(예: Sun, 25 Mar 2012 12:00:00 GMT). 날짜 형식은 RFC 2616 섹션 3.3에 지정된 전체 날짜 형식 중 하나여야 합니다.

유형: 문자열