공통 요청 헤더 - Amazon S3 Glacier

이 페이지는 Vaults와 2012RESTAPI년의 원본을 사용하는 S3 Glacier 서비스의 기존 고객만 사용할 수 있습니다.

아카이브 스토리지 솔루션을 찾고 있다면 Amazon S3, S3 Glacier Instant Retrieval , S33 S3 Glacier Flexible Retrieval 및 S3 Glacier Deep Archive 의 S3 Glacier 스토리지 클래스를 사용하는 것이 좋습니다. Amazon S3 이러한 스토리지 옵션에 대한 자세한 내용은 Amazon S3 사용 설명서의 S3 Glacier 스토리지 클래스 S3 Glacier 스토리지 클래스를 사용하는 장기 데이터 스토리지를 참조하세요. Amazon S3 이러한 스토리지 클래스는 Amazon S3 를 사용하며API, 모든 리전에서 사용할 수 있고, Amazon S3 콘솔 내에서 관리할 수 있습니다. 스토리지 비용 분석, 스토리지 렌즈, 고급 선택적 암호화 기능 등과 같은 기능을 제공합니다.

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

공통 요청 헤더

Amazon S3 Glacier(S3 Glacier) REST 요청에는 요청에 대한 기본 정보가 저장되는 헤더가 포함됩니다. 다음 표는 모든 S3 Glacier REST 요청에서 사용할 수 있는 헤더를 설명한 것입니다.

헤더 이름 설명 필수
Authorization

요청에 서명하는 데 필요한 헤더입니다. S3 Glacier에는 서명 버전 4가 필요합니다. 자세한 내용은 요청에 서명하기 섹션을 참조하세요.

유형: 문자열

Content-Length

요청 본문(헤더 제외) 길이입니다.

유형: 문자열

조건: 아카이브 업로드(POST archive) API에만 필요합니다.

조건
Date

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

서명할 때 Date 헤더를 사용하지 않는다면 RFC 2616 섹션 3.3에 지정된 전체 날짜 형식 중 하나여야 합니다. 예를 들어 다음의 날짜 및 시간 Wed, 10 Feb 2017 12:00:00 GMT은 S3 Glacier에서 유효하게 사용할 수 있는 날짜 및 시간 헤더입니다.

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

유형: 문자열

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

조건
Host

이 헤더는 작업 요청을 전송하는 서비스 엔드포인트를 지정합니다. 헤더 값은 ‘glacier.region.amazonaws.com‘ 형식을 따라야 하며, 여기에서 regionus-west-2와 같은 AWS 리전 지정으로 치환됩니다.

유형: 문자열

x-amz-content-sha256

아카이브 업로드(POST archive) 또는 파트 업로드(PUT uploadID)로 업로드되는 전체 페이로드에 대해 계산된 SHA256 체크섬입니다. 이 헤더는 x-amz-sha256-tree-hash 헤더와 같지 않지만 일부 작은 페이로드의 경우에는 값이 일치합니다. x-amz-content-sha256이 필요한 경우에는 x-amz-content-sha256x-amz-sha256-tree-hash를 모두 지정해야 합니다.

유형: 문자열

조건: API, 아카이브 업로드(POST archive)파트 업로드(PUT uploadID)를 스트리밍하는 데 필요합니다.

조건
x-amz-date

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

유형: 문자열

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

조건
x-amz-glacier-version

사용해야 하는 S3 Glacier API 버전입니다. 현재 버전은 2012-06-01입니다.

유형: 문자열

x-amz-sha256-tree-hash

업로드된 아카이브(아카이브 업로드(POST archive)) 또는 아카이브 파트(파트 업로드(PUT uploadID))에 대해 계산된 SHA256 트리-해시 체크섬입니다. 체크섬 계산에 대한 자세한 내용은 체크섬 계산 단원을 참조하십시오.

유형: 문자열

기본값: None

조건: 아카이브 업로드(POST archive)파트 업로드(PUT uploadID)에 필요합니다.

조건