공통 요청 헤더 - Amazon Glacier

이 페이지는 볼트와 2012년부터 원래 REST API를 사용하는 Amazon Glacier 서비스의 기존 고객만 사용할 수 있습니다.

아카이브 스토리지 솔루션을 찾고 있다면 Amazon S3의 Amazon Glacier 스토리지 클래스, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval 및 S3 Glacier Deep Archive를 사용하는 것이 좋습니다. 이러한 스토리지 옵션에 대한 자세한 내용은 Amazon Glacier 스토리지 클래스를 참조하세요.

Amazon Glacier(기존 독립 실행형 볼트 기반 서비스)는 2025년 12월 15일부터 기존 고객에게 영향을 주지 않고 더 이상 신규 고객을 받지 않습니다. Amazon Glacier는 데이터를 볼트에 저장하고 Amazon S3 및 Amazon S3 Glacier 스토리지 클래스와 구별되는 자체 API를 갖춘 독립 실행형 서비스입니다. 기존 데이터는 Amazon Glacier에서 무기한으로 안전하게 보관되며 액세스 가능합니다. 마이그레이션은 필요하지 않습니다. 저비용 장기 아카이브 스토리지의 경우, AWS에서는 S3 버킷 기반 API, 전체 AWS 리전 가용성, 저렴한 비용 및 AWS 서비스 통합을 통해 우수한 고객 경험을 제공하는 Amazon S3 Glacier 스토리지 클래스를 권장합니다. 향상된 기능을 원하는 경우 Amazon Glacier 볼트에서 Amazon S3 Glacier 스토리지 클래스로 데이터를 전송하기 위한 AWS 솔루션 지침을 사용하여 Amazon S3 Glacier 스토리지 클래스로 마이그레이션하는 것이 좋습니다.

공통 요청 헤더

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

헤더 이름 설명 필수
Authorization

요청에 서명하는 데 필요한 헤더입니다. Amazon 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는 Amazon 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는 Amazon 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

사용할 Amazon Glacier API 버전입니다. 현재 버전은 2012-06-01입니다.

유형: 문자열

x-amz-sha256-tree-hash

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

유형: 문자열

기본값: 없음

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

조건부