멀티파트 업로드 시작(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에서는 전체 아카이브 크기를 지정할 필요가 없기 때문에 멀티파트 업로드를 시작할 때 아카이브의 크기를 몰라도 상관없습니다.

멀티파트 업로드를 완료한 후 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

참고

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

요청 파라미터

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

요청 헤더

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

이름	설명	필수
x-amz-part-size	마지막 파트를 제외한 각 파트의 크기(바이트)입니다. 마지막 파트는 여기에 입력되는 크기 값보다 작을 수 있습니다. 유형: 문자열 기본값: None 제약 조건: 부품 크기는 2의 제곱이 곱해진 메비바이트(1024KiB) 값이어야 합니다. 예를 들어 1048576(1MiB), 2097152(2MiB), 4194304(4MiB), 8388608(8MiB) 등과 같습니다. 최소 허용 파트 크기는 1MiB이고, 최대 크기는 4GiB(4096MiB)입니다.	예
x-amz-archive-description	여러 파트로 나누어 업로드하는 아카이브 설명입니다. 평문으로 설명하거나 원하는 고유 식별자를 할당할 수도 있습니다. 볼트 인벤토리를 가져올 때는(작업 시작(POST jobs) 참조) 응답으로 반환되는 아카이브마다 이 설명이 인벤토리에 포함됩니다. 아카이브 설명에서 선행 스페이스는 제거됩니다. 유형: 문자열 기본값: None 제약 조건: 설명은 1,024바이트보다 작거나 같아야 합니다. 허용되는 문자는 제어 코드를 제외한 7비트 ASCII 중에서도 특히 ASCII 값 32~126 십진수 또는 0x20~0x7E 16진수입니다.	아니요

요청 본문

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

응답

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

응답 헤더

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

이름	설명
Location	S3 Glacier가 생성한 멀티파트 업로드 ID의 상대적 URI 경로입니다. 이 URI 경로를 통해 파트를 업로드하거나 멀티파트 업로드를 완료하는 요청을 전송합니다. 유형: 문자열
x-amz-multipart-upload-id	멀티파트 업로드 ID입니다. 이 값은 Location 헤더에도 포함됩니다. 유형: 문자열

응답 본문

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

오류

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) 단원을 참조하십시오.

관련 단원

• 파트 업로드(PUT uploadID)

• 멀티파트 업로드 완료(POST uploadID)

• 멀티파트 업로드 중단(업로드 ID 삭제)

• 멀티파트 업로드 목록 조회(GET multipart-uploads)

• 파트 목록 조회(GET uploadID)

• 아카이브 삭제(DELETE archive)

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

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