이 페이지는 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 콘솔 내에서 관리할 수 있습니다. 스토리지 비용 분석, 스토리지 렌즈, 고급 선택적 암호화 기능 등과 같은 기능을 제공합니다.

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

멀티파트 업로드 시작(POST multipart-uploads)

설명

이 작업으로 멀티파트 업로드가 시작됩니다(대용량 아카이브를 여러 파트로 나누어 업로드(멀티파트 업로드) 참조). Amazon S3 Glacier(S3 Glacier)는 멀티파트 업로드 리소스를 생성하고 응답에서 해당 ID를 반환합니다. 업로드 ID는 이후 멀티파트 업로드 작업에서 사용됩니다.

멀티파트 업로드를 시작할 때는 파트 크기(바이트 수)를 지정합니다. 부품 크기는 2의 제곱이 곱해진 메비바이트(MiB)(1024키비바이트 [KiB]) 값이어야 합니다. 예를 들어 1048576(1MiB), 2097152(2MiB), 4194304(4MiB), 8388608(8MiB) 등과 같습니다. 최소 허용 파트 크기는 1MiB이고, 최대 크기는 4기비바이트(GiB)입니다.

마지막 파트를 제외하고 현재 업로드 ID를 사용해 업로드하는 파트는 모두 크기가 같아야 합니다. 마지막 파트는 크기가 같거나 작을 수 있습니다. 예를 들어 16.2MiB 파일을 업로드한다고 가정하겠습니다. 파트 크기를 4MiB씩 나누어 멀티파트 업로드를 시작한다면 각각 4MiB의 파트 네 개와 0.2MiB의 파트 한 개를 업로드하게 됩니다.

멀티파트 업로드를 완료한 후 S3 Glacier는 ID가 참조한 멀티파트 업로드 리소스를 제거합니다. 사용자가 멀티파트 업로드를 취소하면 S3 Glacier가 멀티파트 업로드 리소스를 제거하며, 24시간 동안 활동이 없어도 리소스가 제거될 수 있습니다. ID는 24시간 이후에도 사용할 수 있지만 애플리케이션은 이러한 사용을 예상하지 못합니다.

요청

멀티파트 업로드를 시작하려면 HTTP POST 요청을 아카이브를 저장할 볼트의 multipart-uploads 하위 리소스 URI로 전송합니다. 이때 요청에는 파트 크기가 포함되어야 하며, 옵션으로 아카이브 설명을 추가할 수도 있습니다.

조건

POST /AccountId/vaults/VaultName/multipart-uploads 
Host: glacier.us-west-2.amazonaws.com
Date: Date
Authorization: SignatureValue
x-amz-glacier-version: 2012-06-01
x-amz-archive-description: ArchiveDescription
x-amz-part-size: PartSize

요청 파라미터

이 작업은 요청 파라미터를 사용하지 않습니다.

요청 헤더

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

요청 본문

이 작업에는 요청 본문이 없습니다.

응답

S3 Glacier는 요청에 대한 응답으로 ID로 식별된 멀티파트 업로드 리소스를 생성한 후 멀티파트 업로드 ID의 상대적 URI 경로를 반환합니다.

조건

HTTP/1.1 201 Created
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Location: Location
x-amz-multipart-upload-id: multiPartUploadId

응답 헤더

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

응답 본문

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

오류

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

예

예 요청

다음은 HTTP POST 요청을 이름이 multipart-uploads인 볼트의 examplevault 하위 리소스 URI로 전송하여 멀티파트 업로드를 시작하는 예제입니다. 여기에는 4MiB(4194304바이트)의 파트 크기를 지정하는 헤더와 아카이브 설명(옵션)이 포함되어 있습니다.

POST /-/vaults/examplevault/multipart-uploads 
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-archive-description: MyArchive-101
x-amz-part-size: 4194304
x-amz-glacier-version: 2012-06-01
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2

응답의 예

S3 Glacier는 멀티파트 업로드 리소스를 생성한 후 볼트의 multipart-uploads 하위 리소스에 추가합니다. Location 응답 헤더에는 멀티파트 업로드 ID에 대한 상대적 URI 경로가 포함되어 있습니다.

HTTP/1.1 201 Created
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT
Location: /111122223333/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE
x-amz-multipart-upload-id: OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE

개별 파트 업로드에 대한 자세한 내용은 파트 업로드(PUT uploadID) 단원을 참조하십시오.

관련 단원