View a markdown version of this page

공통 요청 헤더 - Amazon Simple Storage Service

공통 요청 헤더

다음 표에서는 모든 Amazon S3 REST 요청에서 사용할 수 있는 헤더를 설명합니다.

헤더 이름 설명
Authorization

요청 인증에 필요한 정보. 자세한 내용은 Amazon Simple Storage Service 개발자 안내서의 인증 헤더를 참조하세요. 익명 요청의 경우 이 헤더는 필요하지 않습니다.
Access-Control-Request-Method 사전 CORS 요청으로 전송되는 HTTP 메서드의 목록입니다. 사전 CORS 평가가 성공하면 지정된 메서드를 다음 CORS 요청에서 사용할 수 있습니다.
Content-Length

RFC 2616에 따른 메시지의 길이(헤더 제외). 이 헤더는 PUT 요청과 XML을 로드하는 작업(예: 로깅 및 ACL)에 필요합니다.
Content-Type

요청의 본문에 콘텐츠가 있는 경우 리소스의 콘텐츠 유형입니다. 예시: text/plain
Content-MD5

RFC 1864에 따른 메시지(헤더 제외)의 Base64로 인코딩된 128비트 MD5 다이제스트입니다. 이 헤더를 메시지 무결성 검사로 사용하여 데이터가 원래 전송된 데이터와 동일한지 확인할 수 있습니다. 선택 사항이지만 Content-MD5 메커니즘을 엔드 투 엔드 무결성 검사로 사용하는 것이 좋습니다. REST 요청 인증에 대한 자세한 내용은 Amazon Simple Storage Service 개발자 안내서의 REST 인증을 참조하세요.
Date

Authorization 헤더에 포함되는 서명을 생성할 때 사용할 수 있는 날짜입니다. 서명할 때 Date 헤더를 사용해야 하는 경우에는 ISO 8601 기본 형식에 따라 지정해야 합니다. 이때 x-amz-date 헤더는 필요하지 않습니다. x-amz-date가 있으면 항상 Date 헤더 값보다 우선하기 때문입니다.

서명할 때 Date 헤더가 사용되지 않는 경우 RFC 2616 섹션 3.3에 지정된 전체 날짜 형식 중 하나일 수 있습니다. 예를 들어 날짜/시간 Wed, 01 Mar 2006 12:00:00 GMT는 Amazon S3에서 사용할 수 있는 유효한 날짜/시간 헤더입니다.

서명에 Date 헤더를 사용할 때는 ISO 8601 기본 YYYYMMDD'T'HHMMSS'Z' 형식을 따라야 합니다.

Date를 지정하면서 ISO 8601 기본 형식을 따르지 않는 경우에는 x-amz-date 헤더도 포함해야 합니다. ISO 8601 기본 형식에 따라 Date를 지정하는 경우에는 이 헤더만으로도 요청 서명이 가능하므로 x-amz-date 헤더가 필요 없습니다. 자세한 정보는 Amazon Web Services 용어집의 서명 버전 4의 날짜 처리 섹션을 참조하세요.
Expect

애플리케이션이 100-Continue를 사용하는 경우 승인을 받을 때까지 요청 본문을 전송하지 않습니다. 헤더를 기반으로 메시지가 거부될 경우 메시지의 본문이 전송되지 않습니다. 이 헤더는 본문을 전송하는 경우에만 사용할 수 있습니다.

유효한 값: 100-Continue
Host

경로 방식 요청의 경우 값은 s3.amazonaws.com입니다. 가상 방식 요청의 경우 값은 BucketName.s3.amazonaws.com입니다. 자세한 내용은 Amazon Simple Storage Service 사용 설명서의 가상 호스팅을 참조하세요.

이 헤더는 HTTP 1.1의 경우 필수이고(대부분의 도구 키트는 이 헤더를 자동으로 추가함), HTTP/1.0 요청의 경우 선택 사항입니다.
Origin

초기 요청자의 서버 이름을 지정하는 엔드포인트입니다.
x-amz-content-sha256

서명 버전 4를 사용하여 요청을 인증하는 경우 이 헤더는 요청 페이로드의 해시를 제공합니다. 자세한 내용은 Authorization 헤더에 대한 서명 계산: 페이로드를 단일 청크로 전송(AWS 서명 버전 4)을 참조하세요. 객체를 청크로 업로드하는 경우 서명이 헤더만 포함하고 페이로드가 없음을 나타내려면 값을 STREAMING-AWS4-HMAC-SHA256-PAYLOAD로 설정합니다. 자세한 내용은 Authorization 헤더에 대한 서명 계산: 페이로드를 여러 청크로 전송(청크 업로드)(AWS 서명 버전 4) 섹션을 참조하세요.
x-amz-date

Authorization 헤더에서 서명을 생성할 때 사용하는 날짜입니다. 형식은 ISO 8601 기본 형식(YYYYMMDD'T'HHMMSS'Z')을 따라야 합니다. 예를 들어 날짜/시간 20170210T120000Z는 Amazon S3에서 사용할 수 있는 유효한 x-amz-date입니다.

x-amz-date는 모든 요청에서 선택 사항이지만 서명 요청에 사용되는 날짜보다 우선할 때 사용됩니다. Date 헤더가 ISO 8601 기본 형식으로 지정되면 x-amz-date는 필요하지 않습니다. x-amz-date가 있으면 항상 Date 헤더 값보다 우선하기 때문입니다. 자세한 정보는 Amazon Web Services 용어집의 서명 버전 4의 날짜 처리 섹션을 참조하세요.
x-amz-security-token

이 헤더는 다음 시나리오에서 사용할 수 있습니다.

  • Amazon DevPay 작업에 보안 토큰을 제공 - Amazon DevPay를 사용하는 각 요청에는 두 개의 x-amz-security-token 헤더가 필요합니다. 하나는 제품 토큰용이고 다른 하나는 사용자 토큰용입니다. Amazon S3는 인증된 요청을 수신하면 계산된 서명을 제공된 서명과 비교합니다. 서명을 계산하는 데 사용되는 잘못된 형식의 다중 값 헤더는 인증 문제를 일으킬 수 있습니다.

  • 임시 보안 자격 증명을 사용할 때 보안 토큰을 제공 - IAM에서 얻은 임시 보안 자격 증명을 사용하여 요청할 때 이 헤더를 사용하여 보안 토큰을 제공해야 합니다. 임시 보안 자격 증명에 대한 자세한 내용은 요청하기를 참조하세요.

이 헤더는 Amazon DevPay를 사용하는 요청과 임시 보안 자격 증명을 사용하여 서명된 요청에 필요합니다.