다음을 통해 비용을 절감하고 더 많은 기능을 이용할 수 있습니다. AWS Elemental MediaConvert
MediaConvert 는 포괄적인 고급 트랜스코딩 기능을 제공하는 최신 파일 기반 비디오 트랜스코딩 서비스로, 온디맨드 요금은 분당 0.0075달러부터 시작합니다. 자세한 내용을 읽어보세요
이미 Amazon Elastic Transcoder를 사용하고 계신가요? MediaConvert마이그레이션하는 방법은 간단합니다. 자세한 내용은 마이그레이션 프로세스에 대한 중요한 정보와 추가 리소스 링크가 포함된 이 개요
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
Elastic Transcoder에 대한 HTTP 요청 만들기
RFC 2616에 정의되어 있는 것처럼, Elastic Transcoder REST 요청은 HTTPS 요청입니다. (자세한 내용은 http://www.ietf.org/rfc/rfc2616.txt
일반적인 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에 지정된 전체 날짜 형식 중 하나여야 합니다.유형: 문자열