아카이브 업로드(POST archive) - Amazon Glacier
설명요청응답예시관련 단원

이 페이지는 볼트와 2012년의 원래 REST API를 사용하는 Amazon Glacier 서비스의 기존 고객에게만 해당됩니다.

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

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

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

아카이브 업로드(POST archive)

설명

이번 작업에서는 아카이브를 볼트에 추가합니다. 성공적으로 업로드되면 데이터를 오랜 기간 저장할 수 있습니다. Amazon Glacier(Amazon Glacier)는 응답의 x-amz-archive-id 헤더에 아카이브 ID를 반환합니다. 반환되는 아카이브 ID는 나중에 아카이브에 액세스하는 데 필요하므로 저장해야 합니다.

업로드하는 데이터의 SHA256 트리-해시를 입력해야 합니다. SHA256 트리-해시의 계산에 대한 자세한 내용은 체크섬 계산 단원을 참조하십시오.

참고

SHA256 트리 해시는 API를 사용할 때의 아카이브 업로드(POST archive) 작업에만 필요합니다. 를 사용할 때는 필요하지 않습니다 AWS CLI.

아카이브를 업로드할 때 선택적으로 최대 1,024개의 인쇄 가능한 ASCII 문자의 아카이브 설명을 지정할 수 있습니다. Amazon Glacier는 아카이브를 검색하거나 볼트 인벤토리를 가져올 때 아카이브 설명을 반환합니다. Amazon Glacier는 어떤 식으로든 설명을 해석하지 않습니다. 아카이브 설명이 고유할 필요는 없습니다. 또한 설명을 사용하여 아카이브 목록을 가져오거나 정렬할 수도 없습니다.

선택적 아카이브 설명을 제외하고 Amazon Glacier는 아카이브에 대한 추가 메타데이터를 지원하지 않습니다. 아카이브 ID는 불투명한 문자열이기 때문에 아카이브의 의미를 추정조차 할 수 없습니다. 대신에 클라이언트 측에서 아카이브 메타데이터를 유지할 수 있습니다. 자세한 내용은 Amazon Glacier에서 아카이브 작업 단원을 참조하십시오.

아카이브는 변경할 수 없습니다. 이미 업로드한 아카이브는 내용이나 설명을 편집할 수 없습니다.

요청

아카이브를 업로드하려면 HTTP POST 메서드를 사용하여 작업 요청을 아카이브를 저장할 볼트의 archives 하위 리소스에게 전송합니다. 이때 요청에는 아카이브 페이로드 크기와 체크섬(SHA256 트리-해시)이 포함되어야 하며, 옵션으로 아카이브 설명을 추가할 수도 있습니다.

구문

POST /AccountId/vaults/VaultName/archives
Host: glacier.Region.amazonaws.com
x-amz-glacier-version: 2012-06-01
Date: Date
Authorization: SignatureValue
x-amz-archive-description: Description
x-amz-sha256-tree-hash: SHA256 tree hash
x-amz-content-sha256: SHA256 linear hash
Content-Length: Length

<Request body.>

참고

AccountId 값은 볼트를 소유한 계정의 AWS 계정 ID입니다. AWS 계정 ID를 지정하거나 선택적으로 단일 '-'(하이픈)를 지정할 수 있습니다.이 경우 Amazon Glacier는 요청에 서명하는 데 사용되는 자격 증명과 연결된 AWS 계정 ID를 사용합니다. 계정 ID를 사용하는 경우 ID에 하이픈('-')을 포함할 수 없습니다.

요청 파라미터

이번 작업에서는 요청 파라미터를 사용하지 않습니다.

요청 헤더

이 작업은 모든 작업에 일반적인 요청 헤더 외에 다음 요청 헤더를 사용합니다. 일반적인 요청 헤더에 대한 자세한 내용은 공통 요청 헤더 단원을 참조하십시오.

이름 설명 필수
Content-Length

객체의 크기(바이트)입니다. 자세한 내용은 http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.13을 참조하십시오.

형식: 숫자

기본값: None

제약 조건: 없음

 예
x-amz-archive-description

옵션으로 업로드하는 아카이브 설명입니다. 평문으로 설명하거나 원하는 식별자를 할당할 수도 있습니다. 아카이브 전체에서 설명이 고유할 필요는 없습니다. 볼트 인벤토리를 가져올 때는(작업 시작(POST jobs) 참조) 응답으로 반환되는 아카이브마다 이 설명이 포함됩니다.

유형: 문자열

기본값: None

제약 조건: 설명은 1,024자보다 작거나 같아야 합니다. 허용되는 문자는 제어 코드를 제외한 7비트 ASCII로 그 중에서도 특히 ASCII 10진수값 32~126 또는 16진수값 0x20~0x7E입니다.

 아니요
x-amz-content-sha256

페이로드의 SHA256 체크섬(선형 해시)입니다. 이 값은 x-amz-sha256-tree-hash 헤더에서 지정하는 값과 다릅니다.

유형: 문자열

기본값: None

제약 조건: 없음

 예
x-amz-sha256-tree-hash

사용자가 계산하는 페이로드 체크섬, 즉 SHA256 트리-해시입니다. SHA256 트리-해시의 계산에 대한 자세한 내용은 체크섬 계산 단원을 참조하십시오. Amazon Glacier가 페이로드의 다른 체크섬을 계산하면 요청이 거부됩니다.

유형: 문자열

기본값: None

제약 조건: 없음

 예

요청 본문

요청 본문에는 업로드할 데이터가 포함됩니다.

응답

이에 대한 응답으로 Amazon Glacier는 아카이브를 내구성 있게 저장하고 아카이브 ID에 URI 경로를 반환합니다.

구문

HTTP/1.1 201 Created
x-amzn-RequestId: x-amzn-RequestId
Date: Date
x-amz-sha256-tree-hash: ChecksumComputedByAmazonGlacier
Location: Location
x-amz-archive-id: ArchiveId

응답 헤더

성공적인 응답에는 모든 작업에 일반적인 응답 헤더 외에 다음 응답 헤더가 포함됩니다. 일반적인 응답 헤더에 대한 자세한 내용은 공통 응답 헤더 단원을 참조하십시오.

이름 설명
Location

새롭게 추가된 아카이브 리소스의 상대적 URI 경로입니다.

유형: 문자열
x-amz-archive-id

아카이브 ID입니다. 이 값은 Location 헤더에도 포함됩니다.

유형: 문자열
x-amz-sha256-tree-hash​

Amazon Glacier에서 계산한 아카이브의 체크섬입니다.

유형: 문자열

응답 본문

이 작업은 응답 본문을 반환하지 않습니다.

오류

Amazon Glacier 예외 및 오류 메시지에 대한 자세한 내용은 섹션을 참조하세요오류 응답.

예시

요청 예시

다음은 아카이브를 업로드하는 요청 예제입니다.

POST /-/vaults/examplevault/archives HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60
x-amz-content-sha256: 7f2fe580edb35154041fa3d4b41dd6d3adaef0c85d2ff6309f1d4b520eeecda3
Content-Length: 2097152
x-amz-glacier-version: 2012-06-01
Authorization: Authorization=AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-content-sha256;x-amz-date;x-amz-glacier-version,Signature=16b9a9e220a37e32f2e7be196b4ebb87120ca7974038210199ac5982e792cace

<Request body (2097152 bytes).>

응답의 예

아래 응답에는 Amazon Glacier가 아카이브에 할당한 ID를 가져올 수 있는 Location 헤더가 있습니다.

HTTP/1.1 201 Created
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT
x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60
Location: /111122223333/vaults/examplevault/archives/NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId
x-amz-archive-id: NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId

관련 단원