**이 페이지는 볼트와 2012년부터 원래 REST API를 사용하는 Amazon Glacier 서비스의 기존 고객만 사용할 수 있습니다.** 아카이브 스토리지 솔루션을 찾고 있다면 Amazon S3의 Amazon Glacier 스토리지 클래스, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval 및 S3 Glacier Deep Archive를 사용하는 것이 좋습니다. 이러한 스토리지 옵션에 대한 자세한 내용은 [Amazon Glacier 스토리지 클래스](https://aws.amazon.com/s3/storage-classes/glacier/)를 참조하세요. Amazon Glacier(기존 독립 실행형 볼트 기반 서비스)는 더 이상 신규 고객을 받지 않습니다. Amazon Glacier는 데이터를 볼트에 저장하고 Amazon S3 및 Amazon S3 Glacier 스토리지 클래스와 구별되는 자체 API를 갖춘 독립 실행형 서비스입니다. 기존 데이터는 Amazon Glacier에서 무기한으로 안전하게 보관되며 액세스 가능합니다. 마이그레이션은 필요하지 않습니다. 저비용 장기 아카이브 스토리지의 경우는 [S3 버킷 기반 API, 전체 가용성, 저렴한 비용 및 서비스 통합을 통해 우수한 고객 경험을 제공하는 Amazon S3 Glacier 스토리지 클래스](https://aws.amazon.com/s3/storage-classes/glacier/)를 AWS 권장합니다. S3 APIs AWS 리전 AWS 향상된 기능을 원하는 경우 [Amazon Glacier 볼트에서 Amazon S3 Glacier 스토리지 클래스로 데이터를 전송하기 위한AWS 솔루션 지침](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/)을 사용하여 Amazon S3 Glacier 스토리지 클래스로 마이그레이션하는 것이 좋습니다. 기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # 멀티파트 업로드 작업 다음은 Amazon Glacier에서 사용할 수 있는 멀티파트 업로드 작업입니다. **Topics** + [멀티파트 업로드 중단(DELETE uploadID)](api-multipart-abort-upload.md) + [멀티파트 업로드 완료(POST uploadID)](api-multipart-complete-upload.md) + [멀티파트 업로드 시작(POST multipart-uploads)](api-multipart-initiate-upload.md) + [파트 목록 조회(GET uploadID)](api-multipart-list-parts.md) + [멀티파트 업로드 목록 조회(GET multipart-uploads)](api-multipart-list-uploads.md) + [파트 업로드(PUT uploadID)](api-upload-part.md) # 멀티파트 업로드 중단(DELETE uploadID) ## 설명 멀티파트 업로드 작업을 위한 본 명령어는 업로드 ID로 식별된 멀티파트 업로드를 중단합니다. 멀티파트 업로드 중단 요청에 성공한 후에는 업로드 ID를 사용하여 추가적인 파트를 업로드하거나 다른 작업을 수행할 수 없습니다. 완료된 멀티파트 업로드는 중단이 불가능합니다. 그러나 이미 중단된 업로드는 일시적으로 중단이 가능합니다. 이 작업은 멱등성을 갖습니다. 멀티파트 업로드에 대한 자세한 내용은 [대용량 아카이브를 여러 파트로 나누어 업로드(멀티파트 업로드)](uploading-archive-mpu.md) 섹션을 참조하세요. ## Requests 멀티파트 업로드를 중단하려면 볼트의 `multipart-uploads` 하위 리소스 URI로 HTTP `DELETE` 요청을 보내고 특정 멀티파트 업로드 ID를 URI의 일부분으로 식별하십시오. ### 구문 ``` 1. DELETE /AccountId/vaults/VaultName/multipart-uploads/uploadID HTTP/1.1 2. Host: glacier.Region.amazonaws.com 3. Date: Date 4. Authorization: SignatureValue 5. x-amz-glacier-version: 2012-06-01 ``` **참고** `AccountId` 값은 볼트를 소유한 계정의 AWS 계정 ID입니다. AWS 계정 ID를 지정하거나 선택적으로 단일 '`-`'(하이픈)를 지정할 수 있습니다.이 경우 Amazon Glacier는 요청에 서명하는 데 사용되는 자격 증명과 연결된 AWS 계정 ID를 사용합니다. 계정 ID를 사용하는 경우 ID에 하이픈('-')을 포함할 수 없습니다. ### 요청 파라미터 이 작업은 요청 파라미터를 사용하지 않습니다. ### 요청 헤더 이 작업은 모든 작업에 일반적인 요청 헤더만 사용합니다. 일반적인 요청 헤더에 대한 내용은 [공통 요청 헤더](api-common-request-headers.md) 섹션을 참조하세요. ### 요청 본문 이 작업에는 요청 본문이 없습니다. ## 응답 ### 구문 ``` HTTP/1.1 204 No Content x-amzn-RequestId: x-amzn-RequestId Date: Date ``` ### 응답 헤더 이 작업은 대부분의 응답에 일반적인 응답 헤더만 사용합니다. 일반적인 응답 헤더에 대한 내용은 [공통 응답 헤더](api-common-response-headers.md) 섹션을 참조하세요. ### 응답 본문 이 작업은 응답 본문을 반환하지 않습니다. ### 오류 Amazon Glacier 예외 및 오류 메시지에 대한 자세한 내용은 [오류 응답](api-error-responses.md) 섹션을 참조하세요. ## 예제 ### 요청 예시 다음의 예시에서는 멀티파트 업로드 ID 리소스의 URI로 `DELETE` 요청이 전송됩니다. ``` 1. DELETE /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. x-amz-Date: 20170210T120000Z 4. x-amz-glacier-version: 2012-06-01 5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2 ``` ### 응답의 예 ``` 1. HTTP/1.1 204 No Content 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT ``` ## 관련 섹션 + [멀티파트 업로드 시작(POST multipart-uploads)](api-multipart-initiate-upload.md) + [파트 업로드(PUT uploadID)](api-upload-part.md) + [멀티파트 업로드 완료(POST uploadID)](api-multipart-complete-upload.md) + [멀티파트 업로드 목록 조회(GET multipart-uploads)](api-multipart-list-uploads.md) + [파트 목록 조회(GET uploadID)](api-multipart-list-parts.md) + [대용량 아카이브를 여러 파트로 나누어 업로드(멀티파트 업로드)](uploading-archive-mpu.md) + [Amazon Glacier의 ID 및 액세스 관리(IAM)](security-iam.md) # 멀티파트 업로드 완료(POST uploadID) ## 설명 이 멀티파트 업로드 작업을 직접 호출하여 모든 아카이브 파트의 업로드를 마쳤으며 이제 업로드된 파트에서 Amazon Glacier가 아카이브를 어셈블링할 수 있음을 Amazon Glacier(Amazon Glacier)에 알립니다. 멀티파트 업로드에 대한 자세한 내용은 [대용량 아카이브를 여러 파트로 나누어 업로드(멀티파트 업로드)](uploading-archive-mpu.md) 섹션을 참조하세요. 아카이브를 어셈블링하여 볼트에 저장하고 나면 Amazon Glacier가 새롭게 생성된 아카이브 리소스의 아카이브 ID를 반환합니다. 아카이브를 업로드하고 나서 나중에 아카이브를 가져오려면 반환된 아카이브 ID를 저장해야 합니다. 요청할 때는 업로드한 전체 아카이브에 대해 계산된 SHA256 트리-해시를 포함시켜야 합니다. SHA256 트리-해시의 계산에 대한 자세한 내용은 [체크섬 계산](checksum-calculations.md) 섹션을 참조하세요. 서버 측에서도 Amazon Glacier는 어셈블링된 아카이브의 SHA256 트리-해시를 구성합니다. 값이 일치하면 Amazon Glacier가 아카이브를 볼트에 저장합니다. 그렇지 않으면 오류를 반환하고 작업이 중단됩니다. [파트 목록 조회(GET uploadID)](api-multipart-list-parts.md) 작업은 특정 멀티파트 업로드에 대해 업로드한 파트 목록을 반환합니다. 여기에는 업로드된 각 파트에서 불량 체크섬 문제를 디버깅하는 데 사용할 수 있는 체크섬 정보가 포함됩니다. 또한 Amazon Glacier는 내용 범위가 누락되지 않았는지 검사합니다. 파트를 업로드할 때는 최종 아카이브 어셈블리에서 각 파트가 위치하는 곳을 찾을 수 있도록 범위 값을 지정합니다. 최종 아카이브를 어셈블링할 때 Amazon Glacier는 누락된 내용 범위의 유무를 검사하며, 누락된 내용 범위가 있는 경우에는 Amazon Glacier가 오류를 반환하고 멀티파트 업로드 완료 작업이 중단됩니다. 멀티파트 업로드 완료 작업은 멱등성 작업입니다. 따라서 첫 번째 멀티파트 업로드를 성공적으로 완료한 후 단기간 내에 해당 작업을 다시 호출하는 경우 작업이 성공적으로 실행되고 동일한 아카이브 ID를 반환합니다. 이는 네트워크 장애로 인해 연결이 중단되거나 500 서버 오류가 발생하는 경우에 유용합니다. 이때는 멀티파트 업로드 완료 요청을 반복하더라도 중복 아카이브를 생성하지 않고 동일한 아카이브 ID가 얻습니다. 단, 멀티파트 업로드 완료 후에는 파트 목록 조회 작업을 호출할 수 없습니다. 따라서 멱등성을 갖는 완료 작업이라고 해도 멀티파트 업로드 목록 조회 응답에 멀티파트 업로드가 표시되지는 않습니다. ## 요청 멀티파트 업로드를 완료하려면 멀티파트 업로드 시작 요청에 대한 응답으로 HTTP POST 요청을 Amazon Glacier가 생성한 업로드 ID의 URI로 전송합니다. 이는 파트 업로드 시 사용한 URI와 동일합니다. 이때 필요한 공통 헤더 외에도 전체 아카이브의 SHA256 트리-해시 결과와 아카이브의 총 크기(바이트)를 요청에 포함시켜야 합니다. ### 구문 ``` 1. POST /AccountId/vaults/VaultName/multipart-uploads/uploadID 2. Host: glacier.Region.amazonaws.com 3. Date: date 4. Authorization: SignatureValue 5. x-amz-sha256-tree-hash: SHA256 tree hash of the archive 6. x-amz-archive-size: ArchiveSize in bytes 7. x-amz-glacier-version: 2012-06-01 ``` **참고** `AccountId` 값은 볼트를 소유한 계정의 AWS 계정 ID입니다. AWS 계정 ID 또는 선택적으로 하나의 '`-`'(하이픈)을 지정할 수 있습니다. 이 경우에 Amazon Glacier는 요청 서명에 사용된 자격 증명과 연결된 AWS 계정 ID를 사용합니다. 계정 ID를 사용하는 경우 ID에 하이픈('-')을 포함할 수 없습니다. ### 요청 파라미터 이 작업은 요청 파라미터를 사용하지 않습니다. ### 요청 헤더 이 작업은 모든 작업에 일반적인 요청 헤더 외에 다음 요청 헤더를 사용합니다. 일반적인 요청 헤더에 대한 자세한 내용은 [공통 요청 헤더](api-common-request-headers.md) 섹션을 참조하세요. | 이름 | 설명 | 필수 | | --- | --- | --- | | x-amz-archive-size | 전체 아카이브의 총 크기(바이트)입니다. 이 값은 업로드한 개별 파트 크기의 총합이 되어야 합니다. 유형: 문자열 기본값: 없음 제약 조건: 없음 | 예 | | x-amz-sha256-tree-hash​ | 전체 아카이브의 SHA256 트리-해시입니다. 즉, 개별 파트의 SHA256 트리-해시로 이루어진 트리-해시입니다. 사용자가 요청에서 지정한 값이 Amazon Glacier에서 계산한 최종 어셈블링된 아카이브의 SHA256 트리–해시와 일치하지 않으면 Amazon Glacier가 오류를 반환하고 요청은 중단됩니다. 유형: 문자열 기본값: 없음 제약 조건: 없음 | 예 | ### 요청 요소 이 작업에서는 요청 요소를 사용하지 않습니다. ## 응답 Amazon Glacier(Amazon Glacier)는 전체 아카이브의 SHA256 트리-해시를 생성합니다. 해당 값이 요청에서 지정한 전체 아카이브의 SHA256 트리-해시와 일치하는 경우 Amazon Glacier는 아카이브를 볼트에 추가합니다. 또한 응답으로 새롭게 추가된 아카이브 리소스의 URL 경로와 함께 HTTP `Location` 헤더를 반환합니다. 아카이브 크기 또는 요청에서 보낸 SHA256이 일치하지 않으면 Amazon Glacier가 오류를 반환하고 업로드는 미완료 상태를 유지합니다. 하지만 나중에 아카이브를 성공적으로 생성할 수 있는 지점부터 정확한 값으로 멀티파트 업로드 완료 작업을 재시도할 수 있습니다. 멀티파트 업로드가 완료되지 않으면 결국 Amazon Glacier가 업로드 ID를 회수합니다. ### 구문 ``` HTTP/1.1 201 Created x-amzn-RequestId: x-amzn-RequestId Date: Date Location: Location x-amz-archive-id: ArchiveId ``` ### 응답 헤더 성공적인 응답에는 모든 작업에 일반적인 응답 헤더 외에 다음 응답 헤더가 포함됩니다. 일반적인 응답 헤더에 대한 자세한 내용은 [공통 응답 헤더](api-common-response-headers.md) 섹션을 참조하세요. | 이름 | 설명 | | --- | --- | | Location | 새롭게 생성된 아카이브의 상대적 URI 경로입니다. 이 URL에는 Amazon Glacier에서 생성된 아카이브 ID가 포함됩니다. 유형: 문자열 | | x-amz-archive-id | 아카이브 ID입니다. 이 값은 `Location` 헤더에도 포함됩니다. 유형: 문자열 | ### 응답 필드 이 작업은 응답 본문을 반환하지 않습니다. ## 예시 ### 요청 예시 이 예에서는 HTTP POST 요청이 멀티파트 업로드 시작 요청에 의해 반환된 URI로 전송됩니다. 요청에서는 전체 아카이브의 SHA256 트리-해시와 총 아카이브 크기를 모두 지정합니다. ``` 1. POST /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. z-amz-Date: 20170210T120000Z 4. x-amz-sha256-tree-hash:1ffc0f54dd5fdd66b62da70d25edacd0 5. x-amz-archive-size:8388608 6. x-amz-glacier-version: 2012-06-01 7. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2 ``` ### 응답의 예 다음 응답 예에서는 Amazon Glacier가 업로드된 파트에서 아카이브를 성공적으로 생성했음을 보여줍니다. 이 응답에는 완료 경로와 함께 아카이브 ID가 포함됩니다. ``` 1. HTTP/1.1 201 Created 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Location: /111122223333/vaults/examplevault/archives/NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId 5. x-amz-archive-id: NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId ``` 이제 HTTP 요청을 새롭게 추가된 리소스/아카이브의 URI로 전송할 수 있습니다. 예를 들어 GET 요청을 전송하여 아카이브를 가져올 수 있습니다. ## 관련 섹션 + [멀티파트 업로드 시작(POST multipart-uploads)](api-multipart-initiate-upload.md) + [파트 업로드(PUT uploadID)](api-upload-part.md) + [멀티파트 업로드 중단(DELETE uploadID)](api-multipart-abort-upload.md) + [멀티파트 업로드 목록 조회(GET multipart-uploads)](api-multipart-list-uploads.md) + [파트 목록 조회(GET uploadID)](api-multipart-list-parts.md) + [대용량 아카이브를 여러 파트로 나누어 업로드(멀티파트 업로드)](uploading-archive-mpu.md) + [아카이브 삭제(DELETE archive)](api-archive-delete.md) + [Amazon Glacier의 ID 및 액세스 관리(IAM)](security-iam.md) # 멀티파트 업로드 시작(POST multipart-uploads) ## 설명 이 작업으로 멀티파트 업로드가 시작됩니다([대용량 아카이브를 여러 파트로 나누어 업로드(멀티파트 업로드)](uploading-archive-mpu.md) 섹션 참조). Amazon Glacier(Amazon 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의 파트 한 개를 업로드하게 됩니다. **참고** Amazon Glacier에서는 전체 아카이브 크기를 지정할 필요가 없기 때문에 멀티파트 업로드를 시작할 때 아카이브의 크기를 몰라도 상관없습니다. 멀티파트 업로드를 완료한 후 Amazon Glacier는 ID가 참조한 멀티파트 업로드 리소스를 제거합니다. 사용자가 멀티파트 업로드를 취소하면 Amazon Glacier가 멀티파트 업로드 리소스를 제거하며, 24시간 동안 활동이 없어도 리소스가 제거될 수 있습니다. ID는 24시간 이후에도 사용할 수 있지만 애플리케이션은 이러한 사용을 예상하지 못합니다. ## Requests 멀티파트 업로드를 시작하려면 HTTP `POST` 요청을 아카이브를 저장할 볼트의 `multipart-uploads` 하위 리소스 URI로 전송합니다. 이때 요청에는 파트 크기가 포함되어야 하며, 옵션으로 아카이브 설명을 추가할 수도 있습니다. ### 구문 ``` 1. POST /AccountId/vaults/VaultName/multipart-uploads 2. Host: glacier.us-west-2.amazonaws.com 3. Date: Date 4. Authorization: SignatureValue 5. x-amz-glacier-version: 2012-06-01 6. x-amz-archive-description: ArchiveDescription 7. x-amz-part-size: PartSize ``` **참고** `AccountId` 값은 볼트를 소유한 계정의 AWS 계정 ID입니다. AWS 계정 ID를 지정하거나 선택적으로 단일 '`-`'(하이픈)를 지정할 수 있습니다.이 경우 Amazon Glacier는 요청에 서명하는 데 사용되는 자격 증명과 연결된 AWS 계정 ID를 사용합니다. 계정 ID를 사용하는 경우 ID에 하이픈('-')을 포함할 수 없습니다. ### 요청 파라미터 이 작업은 요청 파라미터를 사용하지 않습니다. ### 요청 헤더 이 작업은 모든 작업에 일반적인 요청 헤더 외에 다음 요청 헤더를 사용합니다. 일반적인 요청 헤더에 대한 자세한 내용은 [공통 요청 헤더](api-common-request-headers.md) 섹션을 참조하세요. | 이름 | 설명 | 필수 | | --- | --- | --- | | x-amz-part-size | 마지막 파트를 제외한 각 파트의 크기(바이트)입니다. 마지막 파트는 이 파트 크기보다 작을 수 있습니다. 유형: 문자열 기본값: None 제약 조건: 부품 크기는 2의 제곱이 곱해진 메비바이트(1024KiB) 값이어야 합니다. 예를 들어 1048576(1MiB), 2097152(2MiB), 4194304(4MiB), 8388608(8MiB) 등과 같습니다. 최소 허용 파트 크기는 1MiB이고, 최대 크기는 4GiB(4096MiB)입니다. | 예 | | x-amz-archive-description | 여러 파트로 나누어 업로드하는 아카이브 설명입니다. 평문으로 설명하거나 원하는 고유 식별자를 할당할 수도 있습니다. 볼트 인벤토리를 가져올 때는([작업 시작(POST jobs)](api-initiate-job-post.md) 참조) 응답으로 반환되는 아카이브마다 이 설명이 인벤토리에 포함됩니다. 아카이브 설명에서 선행 스페이스는 제거됩니다. 유형: 문자열 기본값: None 제약 조건: 설명은 1,024바이트보다 작거나 같아야 합니다. 허용되는 문자는 제어 코드를 제외한 7비트 ASCII 중에서도 특히 ASCII 값 32\$1126 십진수 또는 0x20\$10x7E 16진수입니다. | 아니요 | ### 요청 본문 이 작업에는 요청 본문이 없습니다. ## 응답 응답 시, Amazon Glacier는 ID로 식별된 멀티파트 업로드 리소스를 생성한 후 멀티파트 업로드 ID의 상대적 URI 경로를 반환합니다. ### 구문 ``` 1. HTTP/1.1 201 Created 2. x-amzn-RequestId: x-amzn-RequestId 3. Date: Date 4. Location: Location 5. x-amz-multipart-upload-id: multiPartUploadId ``` ### 응답 헤더 성공적인 응답에는 모든 작업에 일반적인 응답 헤더 외에 다음 응답 헤더가 포함됩니다. 일반적인 응답 헤더에 대한 자세한 내용은 [공통 응답 헤더](api-common-response-headers.md) 섹션을 참조하세요. | 이름 | 설명 | | --- | --- | | Location | Amazon Glacier가 생성한 멀티파트 업로드 ID의 상대적 URI 경로입니다. 이 URI 경로를 통해 파트를 업로드하거나 멀티파트 업로드를 완료하는 요청을 전송합니다. 유형: 문자열 | | x-amz-multipart-upload-id | 멀티파트 업로드 ID입니다. 이 값은 `Location` 헤더에도 포함됩니다. 유형: 문자열 | ### 응답 본문 이 작업은 응답 본문을 반환하지 않습니다. ### 오류 Amazon Glacier 예외 및 오류 메시지에 대한 자세한 내용은 [오류 응답](api-error-responses.md) 섹션을 참조하세요. ## 예제 ### 요청 예시 다음은 HTTP `POST` 요청을 이름이 `examplevault`인 볼트의 `multipart-uploads` 하위 리소스 URI로 전송하여 멀티파트 업로드를 시작하는 예제입니다. 여기에는 4MiB(4194304바이트)의 파트 크기를 지정하는 헤더와 아카이브 설명(옵션)이 포함되어 있습니다. ``` 1. POST /-/vaults/examplevault/multipart-uploads 2. Host: glacier.us-west-2.amazonaws.com 3. x-amz-Date: 20170210T120000Z 4. x-amz-archive-description: MyArchive-101 5. x-amz-part-size: 4194304 6. x-amz-glacier-version: 2012-06-01 7. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2 ``` ### 응답의 예 Amazon Glacier는 멀티파트 업로드 리소스를 생성한 후 볼트의 `multipart-uploads` 하위 리소스에 추가합니다. `Location` 응답 헤더에는 멀티파트 업로드 ID에 대한 상대적 URI 경로가 포함되어 있습니다. ``` 1. HTTP/1.1 201 Created 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Location: /111122223333/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE 5. x-amz-multipart-upload-id: OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE ``` 개별 파트 업로드에 대한 자세한 내용은 [파트 업로드(PUT uploadID)](api-upload-part.md) 섹션을 참조하세요. ## 관련 섹션 + [파트 업로드(PUT uploadID)](api-upload-part.md) + [멀티파트 업로드 완료(POST uploadID)](api-multipart-complete-upload.md) + [멀티파트 업로드 중단(DELETE uploadID)](api-multipart-abort-upload.md) + [멀티파트 업로드 목록 조회(GET multipart-uploads)](api-multipart-list-uploads.md) + [파트 목록 조회(GET uploadID)](api-multipart-list-parts.md) + [아카이브 삭제(DELETE archive)](api-archive-delete.md) + [대용량 아카이브를 여러 파트로 나누어 업로드(멀티파트 업로드)](uploading-archive-mpu.md) + [Amazon Glacier의 ID 및 액세스 관리(IAM)](security-iam.md) # 파트 목록 조회(GET uploadID) ## 설명 이 멀티파트 업로드 작업에서는 업로드 ID로 식별되는 특정 멀티파트 업로드에서 업로드된 아카이브의 파트 목록을 조회합니다. 멀티파트 업로드에 대한 자세한 내용은 [대용량 아카이브를 여러 파트로 나누어 업로드(멀티파트 업로드)](uploading-archive-mpu.md) 섹션을 참조하세요. 이 요청은 멀티파트 업로드를 완료하기 전에 멀티파트 업로드가 진행 중이라면 언제든지 가능합니다. Amazon Glacier는 각 파트 업로드에서 사용자가 지정한 범위를 기준으로 정렬된 파트 목록을 반환합니다. 멀티파트 업로드가 완료된 후에 파트 목록 조회 요청을 보내면 Amazon Glacier(Amazon Glacier)가 오류를 반환합니다. 파트 목록 조회 작업은 페이지 매김을 지원합니다. 응답 본문의 `Marker` 필드는 항상 확인하여 목록을 계속 이어가는 마커가 있는지 살펴야 합니다. 항목이 더 이상 없는 경우에는 `marker` 필드가 `null` 값을 갖습니다. `marker`가 null 값이 아닌 경우 다음 파트 세트를 가져오려면 Amazon Glacier가 이전 파트 목록 조회 요청에 대한 응답으로 반환한 마커 값으로 설정된 `marker` 요청 파라미터로 파트 목록 조회 요청을 한 번 더 전송합니다. 또한 요청 시 `limit` 파라미터를 지정하여 응답으로 반환되는 파트 수를 제한할 수도 있습니다. ## Requests ### 구문 진행 중인 멀티파트 업로드의 파트 목록을 조회하려면 `GET` 요청을 멀티파트 업로드 ID의 리소스 URI로 전송합니다. 멀티파트 업로드 ID는 멀티파트 업로드를 시작할 때([멀티파트 업로드 시작(POST multipart-uploads)](api-multipart-initiate-upload.md)) 반환됩니다. 옵션으로 `marker` 및 `limit` 파라미터를 지정할 수 있습니다. ``` 1. GET /AccountId/vaults/VaultName/multipart-uploads/uploadID HTTP/1.1 2. Host: glacier.Region.amazonaws.com 3. Date: Date 4. Authorization: SignatureValue 5. x-amz-glacier-version: 2012-06-01 ``` **참고** `AccountId` 값은 볼트를 소유한 계정의 AWS 계정 ID입니다. AWS 계정 ID를 지정하거나 선택적으로 단일 '`-`'(하이픈)를 지정할 수 있습니다.이 경우 Amazon Glacier는 요청에 서명하는 데 사용되는 자격 증명과 연결된 AWS 계정 ID를 사용합니다. 계정 ID를 사용하는 경우 ID에 하이픈('-')을 포함할 수 없습니다. ### 요청 파라미터 | 이름 | 설명 | 필수 | | --- | --- | --- | | limit | 반환할 파트의 최대 수입니다. 기본 제한은 50개입니다. 반환되는 파트 수가 지정한 제한보다 적을 수 있지만 제한을 초과할 수는 없습니다. 유형: 문자열 제약 조건: 최소 정수 값 `1`. 최대 정수 값 `50` | 아니요 | | marker | 페이지 매김에 사용되는 불투명한 문자열입니다. `marker`는 파트 목록 조회가 시작되는 파트를 지정합니다. 이전 파트 목록 조회 응답에서 `marker` 값을 가져옵니다. `marker`는 이전 파트 목록 조회 요청에서 시작된 결과에 페이지를 계속해서 매겨야 하는 경우에만 포함해야 합니다. 유형: 문자열 제약 조건: 없음 | 아니요 | ### 요청 헤더 이 작업은 대부분의 응답에 일반적인 응답 헤더만 사용합니다. 일반적인 응답 헤더에 대한 내용은 [공통 응답 헤더](api-common-response-headers.md) 섹션을 참조하세요. ### 요청 본문 이 작업에는 요청 본문이 없습니다. ## 응답 ### 구문 ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: x-amzn-RequestId 3. Date: Date 4. Content-Type: application/json 5. Content-Length: Length 6. 7. { 8. "ArchiveDescription" : String, 9. "CreationDate" : String, 10. "Marker": String, 11. "MultipartUploadId" : String, 12. "PartSizeInBytes" : Number, 13. "Parts" : 14. [ { 15. "RangeInBytes" : String, 16. "SHA256TreeHash" : String 17. }, 18. ... 19. ], 20. "VaultARN" : String 21. } ``` ### 응답 헤더 이 작업은 대부분의 응답에 일반적인 응답 헤더만 사용합니다. 일반적인 응답 헤더에 대한 내용은 [공통 응답 헤더](api-common-response-headers.md) 섹션을 참조하세요. ### 응답 본문 JSON 응답 본문에는 다음과 같은 JSON 필드가 포함됩니다. **ArchiveDescription** 멀티파트 업로드 시작 요청에서 지정한 아카이브 설명입니다. 멀티파트 업로드 시작 작업에서 아카이브 설명을 지정하지 않은 경우 이 필드는 `null` 값을 갖습니다. *유형*: 문자열 **CreationDate** 멀티파트 업로드가 시작된 UTC 시간입니다. *유형*: 문자열. ISO 8601 날짜 형식의 문자열 표현입니다. 예: `2013-03-20T17:03:43.221Z` **마커** 결과에 페이지를 계속해서 매기는 지점을 나타내는 불투명한 문자열입니다. 새 파트 목록 조회 요청에서 `marker`를 사용하여 목록의 작업을 추가로 가져옵니다. 파트가 더 없을 경우 이 값은 `null`입니다. *유형*: 문자열 **MultipartUploadId** 파트가 연결되는 업로드의 ID입니다. *유형*: 문자열 **PartSizeInBytes** 파트 크기(바이트)입니다. 이 크기는 멀티파트 업로드 시작 요청에서 지정한 값과 동일합니다. *형식*: 숫자 **파트** 멀티파트 업로드의 파트 크기 목록입니다. 배열의 각 객체는 `RangeBytes` 및 `sha256-tree-hash` 이름/값 페어로 구성됩니다. *유형*: 배열 **RangeInBytes** 파트의 바이트 범위(범위 상한값 포함)입니다. *유형*: 문자열 **SHA256TreeHash** Amazon Glacier가 파트에 대해 계산한 SHA256 트리-해시 값입니다. 이 필드는 절대 `null` 값을 가질 수 없습니다. *유형*: 문자열 **VaultARN** 멀티파트 업로드가 시작되는 볼트의 Amazon 리소스 이름(ARN)입니다. *유형*: 문자열 ### 오류 Amazon Glacier 예외 및 오류 메시지에 대한 자세한 내용은 [오류 응답](api-error-responses.md) 섹션을 참조하세요. ## 예제 ### 예제: 멀티파트 업로드의 파트 목록 조회 다음은 업로드하는 모든 파트의 목록을 조회하는 예제입니다. 아래 예제는 HTTP `GET` 요청을 진행 중인 멀티파트 업로드의 특정 멀티파트 업로드 ID URI로 전송하고 최대 1,000개까지 파트를 반환합니다. #### 요청 예시 ``` 1. GET /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. x-amz-Date: 20170210T120000Z 4. x-amz-glacier-version: 2012-06-01 5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2 ``` #### 응답의 예 응답 시, Amazon Glacier가 지정된 멀티파트 업로드 ID와 연결되어 업로드된 파트 목록을 반환합니다. 이 예제에서는 파트가 2개뿐입니다. 반환되는 `Marker` 필드가 `null` 값을 갖기 때문에 멀티파트 업로드에 남아있는 파트가 더 없다는 것을 의미합니다. ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Content-Type: application/json 5. Content-Length: 412 6. 7. { 8. "ArchiveDescription" : "archive description", 9. "CreationDate" : "2012-03-20T17:03:43.221Z", 10. "Marker": null, 11. "MultipartUploadId" : "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE", 12. "PartSizeInBytes" : 4194304, 13. "Parts" : 14. [ { 15. "RangeInBytes" : "0-4194303", 16. "SHA256TreeHash" : "01d34dabf7be316472c93b1ef80721f5d4" 17. }, 18. { 19. "RangeInBytes" : "4194304-8388607", 20. "SHA256TreeHash" : "0195875365afda349fc21c84c099987164" 21. }], 22. "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/demo1-vault" 23. } ``` ### 예제: 멀티파트 업로드의 파트 목록 조회(Marker 및 Limit Request 파라미터 지정) 다음은 페이지 매김을 사용해 결과 수를 제한하는 방법을 나타낸 예제입니다. 아래 예제는 HTTP `GET` 요청을 진행 중인 멀티파트 업로드의 특정 멀티파트 업로드 ID URI로 전송하고 파트 1개를 반환합니다. 파트 목록을 시작할 파트에서 첫 번째 `marker` 파라미터가 지정됩니다. 이전 파트 목록 조회 요청의 응답에서 `marker` 값을 가져올 수 있습니다. 또한 이 예제에서는 `limit` 파라미터가 1로 설정되어 파트를 1개 반환합니다. `Marker` 필드가 `null` 값이 아니기 때문에 가져올 파트가 적어도 1개 이상이란 것을 의미합니다. #### 요청 예시 ``` 1. GET /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE?marker=1001&limit=1 HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. x-amz-Date: 20170210T120000Z 4. x-amz-glacier-version: 2012-06-01 5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2 ``` #### 응답의 예 응답 시, Amazon Glacier가 지정된 진행 중인 멀티파트 업로드 ID와 연결되어 업로드된 파트 목록을 반환합니다. ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Content-Type: text/json 5. Content-Length: 412 6. 7. { 8. "ArchiveDescription" : "archive description 1", 9. "CreationDate" : "2012-03-20T17:03:43.221Z", 10. "Marker": "MfgsKHVjbQ6EldVl72bn3_n5h2TaGZQUO-Qb3B9j3TITf7WajQ", 11. "MultipartUploadId" : "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE", 12. "PartSizeInBytes" : 4194304, 13. "Parts" : 14. [ { 15. "RangeInBytes" : "4194304-8388607", 16. "SHA256TreeHash" : "01d34dabf7be316472c93b1ef80721f5d4" 17. }], 18. "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/demo1-vault" 19. } ``` ## 관련 섹션 + [멀티파트 업로드 시작(POST multipart-uploads)](api-multipart-initiate-upload.md) + [파트 업로드(PUT uploadID)](api-upload-part.md) + [멀티파트 업로드 완료(POST uploadID)](api-multipart-complete-upload.md) + [멀티파트 업로드 중단(DELETE uploadID)](api-multipart-abort-upload.md) + [멀티파트 업로드 목록 조회(GET multipart-uploads)](api-multipart-list-uploads.md) + [대용량 아카이브를 여러 파트로 나누어 업로드(멀티파트 업로드)](uploading-archive-mpu.md) + [Amazon Glacier의 ID 및 액세스 관리(IAM)](security-iam.md) # 멀티파트 업로드 목록 조회(GET multipart-uploads) ## 설명 이 멀티파트 업로드 작업에서는 특정 볼트에서 진행 중인 멀티파트 업로드 목록을 표시합니다. 진행 중인 멀티파트 업로드란 [멀티파트 업로드 시작(POST multipart-uploads)](api-multipart-initiate-upload.md) 요청으로 시작되었지만 아직 완료되거나 중단되지 않은 멀티파트 업로드를 말합니다. 멀티파트 업로드 목록 조회에 대한 응답으로 반환되는 목록은 정해진 순서가 없습니다. 멀티파트 업로드 목록 조회 작업은 페이지 매김을 지원합니다. 기본적으로 이 작업에서 반환되는 멀티파트 업로드 수는 최대 50개입니다. 응답 본문의 `marker` 필드는 항상 확인하여 목록을 계속 이어가는 마커가 있는지 살펴야 합니다. 항목이 더 이상 없는 경우에는 `marker` 필드가 `null` 값을 갖습니다. `marker`가 null 값이 아닌 경우 다음 멀티파트 업로드 세트를 가져오려면 Amazon Glacier(Amazon Glacier)가 이전 멀티파트 업로드 목록 조회 요청에 대한 응답으로 반환한 마커 값으로 설정된 `marker` 요청 파라미터로 멀티파트 업로드 목록 조회 요청을 한 번 더 전송합니다. 이 작업과 [파트 목록 조회(GET uploadID)](api-multipart-list-parts.md) 작업의 차이점에 대해서 알아둘 필요가 있습니다. 멀티파트 업로드 목록 조회 작업은 볼트 1개의 멀티파트 업로드 목록을 모두 조회합니다. 하지만 파트 목록 조회 작업은 업로드 ID로 식별되는 특정 멀티파트 업로드의 파트를 반환합니다. 멀티파트 업로드에 대한 자세한 내용은 [대용량 아카이브를 여러 파트로 나누어 업로드(멀티파트 업로드)](uploading-archive-mpu.md) 섹션을 참조하세요. ## Requests ### 구문 멀티파트 업로드 목록을 조회하려면 `GET` 요청을 볼트의 `multipart-uploads` 하위 리소스 URI로 전송합니다. 옵션으로 `marker` 및 `limit` 파라미터를 지정할 수 있습니다. ``` 1. GET /AccountId/vaults/VaultName/multipart-uploads HTTP/1.1 2. Host: glacier.Region.amazonaws.com 3. Date: Date 4. Authorization: SignatureValue 5. x-amz-glacier-version: 2012-06-01 ``` **참고** `AccountId` 값은 볼트를 소유한 계정의 AWS 계정 ID입니다. AWS 계정 ID를 지정하거나 선택적으로 단일 '`-`'(하이픈)를 지정할 수 있습니다.이 경우 Amazon Glacier는 요청에 서명하는 데 사용되는 자격 증명과 연결된 AWS 계정 ID를 사용합니다. 계정 ID를 사용하는 경우 ID에 하이픈('-')을 포함할 수 없습니다. ### 요청 파라미터 | 이름 | 설명 | 필수 | | --- | --- | --- | | limit | 응답 본문으로 반환되는 최대 업로드 수를 지정합니다. 이 파라미터를 지정하지 않으면 업로드 목록 조회 작업이 최대 50개까지 업로드를 반환합니다. 유형: 문자열 제약 조건: 최소 정수 값 `1`. 최대 정수 값 `50` | 아니요 | | marker | 페이지 매김에 사용되는 불투명한 문자열입니다. `marker`는 업로드 목록 조회가 시작되는 업로드를 지정합니다. 이전 업로드 목록 조회 응답에서 `marker` 값을 가져옵니다. `marker`는 이전 업로드 목록 조회 요청에서 시작된 결과에 페이지를 계속해서 매겨야 하는 경우에만 포함해야 합니다. 유형: 문자열 제약 조건: 없음 | 아니요 | ### 요청 헤더 이 작업은 대부분의 응답에 일반적인 응답 헤더만 사용합니다. 일반적인 응답 헤더에 대한 내용은 [공통 응답 헤더](api-common-response-headers.md) 섹션을 참조하세요. ### 요청 본문 이 작업에는 요청 본문이 없습니다. ## 응답 ### 구문 ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: x-amzn-RequestId 3. Date: Date 4. Content-Type: application/json 5. Content-Length: Length 6. 7. { 8. "Marker": String, 9. "UploadsList" : [ 10. { 11. "ArchiveDescription": String, 12. "CreationDate": String, 13. "MultipartUploadId": String, 14. "PartSizeInBytes": Number, 15. "VaultARN": String 16. }, 17. ... 18. ] 19. } ``` ### 응답 헤더 이 작업은 대부분의 응답에 일반적인 응답 헤더만 사용합니다. 일반적인 응답 헤더에 대한 내용은 [공통 응답 헤더](api-common-response-headers.md) 섹션을 참조하세요. ### 응답 본문 JSON 응답 본문에는 다음과 같은 JSON 필드가 포함됩니다. **ArchiveDescription** 멀티파트 업로드 시작 요청에서 지정한 아카이브 설명입니다. 멀티파트 업로드 시작 작업에서 아카이브 설명을 지정하지 않은 경우 이 필드는 `null` 값을 갖습니다. *유형*: 문자열 **CreationDate** 멀티파트 업로드가 시작된 UTC 시간입니다. *유형*: 문자열. ISO 8601 날짜 형식의 문자열 표현입니다. 예: `2013-03-20T17:03:43.221Z` **마커** 결과에 페이지를 계속해서 매기는 지점을 나타내는 불투명한 문자열입니다. 새 멀티파트 업로드 목록 조회 요청에서 `marker`를 사용하여 목록의 업로드를 추가로 가져옵니다. 업로드가 더 없을 경우 이 값은 `null`입니다. *유형*: 문자열 **PartSizeInBytes** [멀티파트 업로드 시작(POST multipart-uploads)](api-multipart-initiate-upload.md) 요청에서 지정된 파트 크기입니다. 마지막 파트를 제외하고 업로드되는 파트의 총 크기이기 때문에 이 크기보다 작을 수도 있습니다. *형식*: 숫자 **MultipartUploadId** 멀티파트 업로드 ID입니다. *유형*: 문자열 **UploadsList** 멀티파트 업로드 객체에 대한 메타데이터 목록입니다. 이 목록의 각 항목은 `ArchiveDescription`, `CreationDate`, `MultipartUploadId`, `PartSizeInBytes`, `VaultARN` 등을 포함하여 해당하는 업로드의 이름-값 페어 집합으로 구성됩니다. *유형*: 배열 **VaultARN** 아카이브가 저장되는 볼트의 Amazon 리소스 이름(ARN)입니다. *유형*: 문자열 ### 오류 Amazon Glacier 예외 및 오류 메시지에 대한 자세한 내용은 [오류 응답](api-error-responses.md) 섹션을 참조하세요. ## 예제 ### 예제: 모든 멀티파트 업로드 목록 조회 다음은 볼트에서 진행 중인 모든 멀티파트 업로드 목록을 조회하는 예제입니다. 이 예제에서는 HTTP `GET` 요청이 지정된 볼트의 `multipart-uploads` 하위 리소스 URI로 전송됩니다. 요청에서 `marker` 파라미터와 `limit` 파라미터를 지정하지 않았기 때문에 최대 1,000개까지 진행 중인 멀티파트 업로드가 반환됩니다. #### 요청 예시 ``` 1. GET /-/vaults/examplevault/multipart-uploads HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. x-amz-Date: 20170210T120000Z 4. x-amz-glacier-version: 2012-06-01 5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2 ``` #### 응답의 예 응답 시, Amazon Glacier는 지정된 볼트에서 진행 중인 모든 멀티파트 업로드의 목록을 반환합니다. `marker` 필드가 `null` 값이므로 더 이상 목록을 조회할 업로드가 없다는 것을 의미합니다. ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Content-Type: application/json 5. Content-Length: 1054 6. 7. { 8. "Marker": null, 9. "UploadsList": [ 10. { 11. "ArchiveDescription": "archive 1", 12. "CreationDate": "2012-03-19T23:20:59.130Z", 13. "MultipartUploadId": "xsQdFIRsfJr20CW2AbZBKpRZAFTZSJIMtL2hYf8mvp8dM0m4RUzlaqoEye6g3h3ecqB_zqwB7zLDMeSWhwo65re4C4Ev", 14. "PartSizeInBytes": 4194304, 15. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" 16. }, 17. { 18. "ArchiveDescription": "archive 2", 19. "CreationDate": "2012-04-01T15:00:00.000Z", 20. "MultipartUploadId": "nPyGOnyFcx67qqX7E-0tSGiRi88hHMOwOxR-_jNyM6RjVMFfV29lFqZ3rNsSaWBugg6OP92pRtufeHdQH7ClIpSF6uJc", 21. "PartSizeInBytes": 4194304, 22. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" 23. }, 24. { 25. "ArchiveDescription": "archive 3", 26. "CreationDate": "2012-03-20T17:03:43.221Z", 27. "MultipartUploadId": "qt-RBst_7yO8gVIonIBsAxr2t-db0pE4s8MNeGjKjGdNpuU-cdSAcqG62guwV9r5jh5mLyFPzFEitTpNE7iQfHiu1XoV", 28. "PartSizeInBytes": 4194304, 29. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" 30. } 31. ] 32. } ``` ### 예제: 부분적 멀티파트 업로드 목록 조회 다음은 페이지 매김을 사용해 결과 수를 제한하는 방법을 나타낸 예제입니다. 이 예제에서는 HTTP `GET` 요청이 지정된 볼트의 `multipart-uploads` 하위 리소스 URI로 전송됩니다. 또한 `limit` 파라미터가 1로 설정되어 있습니다. 이는 목록에서 반환되는 업로드 수가 1개로 제한된다는 것을 의미하며, `marker` 파라미터는 반환 목록이 시작되는 멀티파트 업로드 ID를 나타냅니다. #### 요청 예시 ``` 1. GET /-/vaults/examplevault/multipart-uploads?limit=1&marker=xsQdFIRsfJr20CW2AbZBKpRZAFTZSJIMtL2hYf8mvp8dM0m4RUzlaqoEye6g3h3ecqB_zqwB7zLDMeSWhwo65re4C4Ev HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. x-amz-Date: 20170210T120000Z 4. x-amz-glacier-version: 2012-06-01 5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2 ``` #### 응답의 예 응답 시, Amazon Glacier(Amazon Glacier)는 지정된 볼트에서 진행 중인 두 개 이하의 멀티파트 업로드 목록을 반환하는데, 지정된 마커부터 시작하여 두 개의 결과를 반환합니다. ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Content-Type: application/json 5. Content-Length: 470 6. 7. { 8. "Marker": "qt-RBst_7yO8gVIonIBsAxr2t-db0pE4s8MNeGjKjGdNpuU-cdSAcqG62guwV9r5jh5mLyFPzFEitTpNE7iQfHiu1XoV", 9. "UploadsList" : [ 10. { 11. "ArchiveDescription": "archive 2", 12. "CreationDate": "2012-04-01T15:00:00.000Z", 13. "MultipartUploadId": "nPyGOnyFcx67qqX7E-0tSGiRi88hHMOwOxR-_jNyM6RjVMFfV29lFqZ3rNsSaWBugg6OP92pRtufeHdQH7ClIpSF6uJc", 14. "PartSizeInBytes": 4194304, 15. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" 16. } 17. ] 18. } ``` ## 관련 섹션 + [멀티파트 업로드 시작(POST multipart-uploads)](api-multipart-initiate-upload.md) + [파트 업로드(PUT uploadID)](api-upload-part.md) + [멀티파트 업로드 완료(POST uploadID)](api-multipart-complete-upload.md) + [멀티파트 업로드 중단(DELETE uploadID)](api-multipart-abort-upload.md) + [파트 목록 조회(GET uploadID)](api-multipart-list-parts.md) + [대용량 아카이브를 여러 파트로 나누어 업로드(멀티파트 업로드)](uploading-archive-mpu.md) + [Amazon Glacier의 ID 및 액세스 관리(IAM)](security-iam.md) # 파트 업로드(PUT uploadID) ## 설명 이 멀티파트 업로드 작업에서는 아카이브 파트를 업로드합니다. 파트 업로드 요청에서 업로드되는 아카이브 어셈블의 바이트 범위를 지정하기 때문에 아카이브 파트는 순서에 상관없이 업로드할 수 있습니다. 또한 병렬 방식으로 파트를 업로드하는 것도 가능합니다. 멀티파트 업로드에서 업로드할 수 있는 파트 수는 최대 10,000개입니다. 멀티파트 업로드에 대한 자세한 내용은 [대용량 아카이브를 여러 파트로 나누어 업로드(멀티파트 업로드)](uploading-archive-mpu.md) 섹션을 참조하세요. 다음 조건 중 한 가지라도 사실인 경우에는 Amazon Glacier(Amazon Glacier)가 사용자의 파트 업로드 요청을 거부합니다. + **SHA256 트리-해시가 일치하지 않습니다:** 파트 데이터가 전송 중 손상되지 않도록 하려면 파트의 SHA256 트리 해시를 계산하여 요청에 추가해야 합니다. Amazon Glacier가 파트 데이터 수신과 함께 SHA256 트리 해시를 계산합니다. 이때 두 해시 값이 일치하지 않으면 작업이 오류로 중단됩니다. SHA256 트리-해시의 계산에 대한 자세한 내용은 [체크섬 계산](checksum-calculations.md) 섹션을 참조하세요. + **SHA256 선형 해시가 일치하지 않습니다:** 권한 부여에 필요하기 때문에 업로드된 전체 페이로드의 SHA256 선형 해시를 계산한 후 요청에 추가합니다. SHA256 선형 해시의 계산에 대한 자세한 내용은 [체크섬 계산](checksum-calculations.md) 섹션을 참조하세요. + **파트 크기가 일치하지 않습니다:** 마지막 파트를 제외하고 각 파트의 크기는 해당하는 [멀티파트 업로드 시작(POST multipart-uploads)](api-multipart-initiate-upload.md) 요청에서 지정한 크기와 반드시 일치해야 합니다. 마지막 파트의 크기는 지정된 크기보다 작거나 같아야 합니다. **참고** 멀티파트 업로드 시작 요청에서 지정한 파트 크기보다 작으면서 동시에 마지막 파트가 아닌 파트를 업로드하는 경우에도 파트 업로드 요청은 성공적으로 실행됩니다. 하지만 이후 멀티파트 업로드 완료 요청이 실행되지 않습니다. + **범위가 맞지 않습니다:** 요청의 바이트 범위 값이 해당하는 시작 요청에서 지정한 파트 크기와 맞지 않습니다. 예를 들어 크기가 4194304바이트(4MB)인 파트를 지정한다면 유효한 파트 범위는 0\$14194303바이트(4MB-1)와 4194304(4MB)\$18388607바이트(8MB-1)입니다. 하지만 범위 값을 2\$16MB로 설정하면 범위와 파트 크기가 맞지 않아 업로드가 오류로 중단되고 맙니다. 이 작업은 멱등성을 갖습니다. 따라서 동일한 파트를 여러 차례 업로드할 경우 가장 최근 요청에서 입력했던 데이터가 이전에 업로드했던 데이터를 덮어씁니다. ## 요청 이 HTTP `PUT` 요청을 멀티파트 업로드 시작 요청에서 반환된 업로드 ID의 URI로 전송합니다. Amazon Glacier는 업로드 ID를 사용하여 파트 업로드와 특정 멀티파트 업로드를 연결합니다. 요청할 때는 파트 데이터의 SHA256 트리-해시(`x-amz-SHA256-tree-hash` 헤더), 전체 페이로드의 SHA256 선형 해시(`x-amz-content-sha256` 헤더), 바이트 범위(`Content-Range` 헤더), 그리고 바이트 단위의 파트 길이(`Content-Length` 헤더)가 포함되어야 합니다. ### 구문 ``` 1. PUT /AccountId/vaults/VaultName/multipart-uploads/uploadID HTTP/1.1 2. Host: glacier.Region.amazonaws.com 3. Date: Date 4. Authorization: SignatureValue 5. Content-Range: ContentRange 6. Content-Length: PayloadSize 7. Content-Type: application/octet-stream 8. x-amz-sha256-tree-hash: Checksum of the part 9. x-amz-content-sha256: Checksum of the entire payload 10. x-amz-glacier-version: 2012-06-01 ``` **참고** `AccountId` 값은 볼트를 소유한 계정의 AWS 계정 ID입니다. AWS 계정 ID 또는 선택적으로 하나의 '`-`'(하이픈)을 지정할 수 있습니다. 이 경우에 Amazon Glacier는 요청 서명에 사용된 자격 증명과 연결된 AWS 계정 ID를 사용합니다. 계정 ID를 사용하는 경우 ID에 하이픈('-')을 포함할 수 없습니다. ### 요청 파라미터 이 작업은 요청 파라미터를 사용하지 않습니다. ### 요청 헤더 이 작업은 모든 작업에 일반적인 요청 헤더 외에 다음 요청 헤더를 사용합니다. 일반적인 요청 헤더에 대한 자세한 내용은 [공통 요청 헤더](api-common-request-headers.md) 섹션을 참조하세요. | 이름 | 설명 | 필수 | | --- | --- | --- | | Content-Length | 파트 길이(바이트)를 식별합니다. 유형: 문자열 기본값: 없음 제약 조건: 없음 | 아니요 | | Content-Range | 이 파트에 업로드될 어셈블링된 아카이브의 바이트 범위를 식별합니다. Amazon Glacier는 이 정보를 사용하여 아카이브를 적절한 순서로 어셈블링합니다. 이 헤더의 형식은 [RFC 2616](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.16)을 따릅니다. 헤더 예를 들면 `Content-Range:bytes 0-4194303/*`과 같습니다. 유형: 문자열 기본값: 없음 제약 조건: 범위는 멀티파트 업로드를 시작할 때 지정한 파트 크기보다 클 수 없습니다. | 예 | | x-amz-content-sha256 | 업로드되는 페이로드의 SHA256 체크섬(선형 해시)입니다. 이 값은 `x-amz-sha256-tree-hash` 헤더에서 지정하는 값과 다릅니다. 유형: 문자열 기본값: 없음 제약 조건: 없음 | 예 | | x-amz-sha256-tree-hash​ | 업로드되는 데이터의 SHA256 트리-해시를 지정합니다. SHA256 트리-해시의 계산에 대한 자세한 내용은 [체크섬 계산](checksum-calculations.md) 섹션을 참조하세요. 유형: 문자열 기본값: 없음 제약 조건: 없음 | 예 | ### 요청 본문 요청 본문에는 업로드할 데이터가 포함됩니다. ## 응답 파트 업로드가 성공하면 Amazon Glacier가 `204 No Content` 응답을 반환합니다. ### 구문 ``` 1. HTTP/1.1 204 No Content 2. x-amzn-RequestId: x-amzn-RequestId 3. Date: Date 4. x-amz-sha256-tree-hash: ChecksumComputedByAmazonGlacier ``` ### 응답 헤더 성공적인 응답에는 모든 작업에 일반적인 응답 헤더 외에 다음 응답 헤더가 포함됩니다. 일반적인 응답 헤더에 대한 자세한 내용은 [공통 응답 헤더](api-common-response-headers.md) 섹션을 참조하세요. | 이름 | 설명 | | --- | --- | | x-amz-sha256-tree-hash​ | Amazon Glacier가 업로드된 파트에 대해 계산한 SHA256 트리 해시입니다. 유형: 문자열 | ### 응답 본문 이 작업은 응답 본문을 반환하지 않습니다. ## 예시 다음은 4MB 파트를 업로드하는 요청입니다. 이 요청은 아카이브에서 4MB 파트가 첫 번째 파트가 되도록 바이트 범위를 설정합니다. ### 요청 예시 다음은 HTTP `PUT` 요청을 전송하여 4MB 파트를 업로드하는 예제입니다. 이 요청은 멀티파트 업로드 시작 요청에서 반환된 업로드 ID의 URI로 전송됩니다. `Content-Range` 헤더는 아카이브에서 첫 번째 4MB 데이터 파트를 업로드할 파트로 식별합니다. ``` 1. PUT /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Content-Range:bytes 0-4194303/* 5. x-amz-sha256-tree-hash:c06f7cd4baacb087002a99a5f48bf953 6. x-amz-content-sha256:726e392cb4d09924dbad1cc0ba3b00c3643d03d14cb4b823e2f041cff612a628 7. Content-Length: 4194304 8. 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 ``` 다음 파트를 업로드할 때도 절차는 같습니다. 하지만 업로드할 파트의 SHA256 트리-해시를 새롭게 계산해야 합니다. 또한 파트가 최종 어셈블리에서 포함되는 위치를 알 수 있도록 새로운 바이트 범위도 지정해야 합니다. 다음은 동일한 업로드 ID를 사용하여 다른 파트를 업로드하는 요청입니다. 이 요청에서는 이전 요청과 4MB 파트 크기 다음에 이어지는 4MB 아카이브를 지정합니다. ``` 1. PUT /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Content-Range:bytes 4194304-8388607/* 5. Content-Length: 4194304 6. x-amz-sha256-tree-hash:f10e02544d651e2c3ce90a4307427493 7. x-amz-content-sha256:726e392cb4d09924dbad1cc0ba3b00c3643d03d14cb4b823e2f041cff612a628 8. x-amz-glacier-version: 2012-06-01 9. Authorization: Authorization=AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20120525/us-west-2/glacier/aws4_request, SignedHeaders=host;x-amz-content-sha256;x-amz-date;x-amz-glacier-version, Signature=16b9a9e220a37e32f2e7be196b4ebb87120ca7974038210199ac5982e792cace ``` 어떤 순서로든 파트를 업로드할 수 있지만 Amazon Glacier가 각 파트의 범위 사양을 사용하여 어셈블링 순서를 결정합니다. ### 응답의 예 ``` 1. HTTP/1.1 204 No Content 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. x-amz-sha256-tree-hash: c06f7cd4baacb087002a99a5f48bf953 4. Date: Wed, 10 Feb 2017 12:00:00 GMT ``` ## 관련 섹션 + [멀티파트 업로드 시작(POST multipart-uploads)](api-multipart-initiate-upload.md) + [파트 업로드(PUT uploadID)](#api-upload-part) + [멀티파트 업로드 완료(POST uploadID)](api-multipart-complete-upload.md) + [멀티파트 업로드 중단(DELETE uploadID)](api-multipart-abort-upload.md) + [멀티파트 업로드 목록 조회(GET multipart-uploads)](api-multipart-list-uploads.md) + [파트 목록 조회(GET uploadID)](api-multipart-list-parts.md) + [대용량 아카이브를 여러 파트로 나누어 업로드(멀티파트 업로드)](uploading-archive-mpu.md) + [Amazon Glacier의 ID 및 액세스 관리(IAM)](security-iam.md)