아카이브 업로드(POST archive)

설명

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

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

참고

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

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

S3 Glacier는 옵션인 아카이브 설명을 제외하고는 아카이브의 추가적인 메타데이터를 지원하지 않습니다. 아카이브 ID는 불투명한 문자열이기 때문에 아카이브의 의미를 추정조차 할 수 없습니다. 대신에 클라이언트 측에서 아카이브 메타데이터를 유지할 수 있습니다. 자세한 내용은 Amazon S3 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 S3 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 트리-해시의 계산에 대한 자세한 내용은 체크섬 계산 단원을 참조하십시오. S3 Glacier가 다른 페이로드 체크섬을 계산할 경우에는 요청이 거부됩니다. 유형: 문자열 기본값: None 제약 조건: 없음	예

요청 본문

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

응답

S3 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​	S3 Glacier에서 계산하는 아카이브 체크섬입니다. 유형: 문자열

응답 본문

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

오류

S3 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).>

응답의 예

아래와 같이 성공적인 응답에는 S3 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

관련 단원

• Amazon S3 Glacier에서 아카이브 작업

• 대용량 아카이브를 여러 파트로 나누어 업로드(멀티파트 업로드)

• 아카이브 삭제(DELETE archive)

• Amazon S3 Glacier의 Identity and Access Management(IAM)