파트 목록 조회(GET uploadID) - Amazon S3 Glacier
설명요청응답예시관련 단원

Amazon Simple Storage Service(S3)의 아카이브 스토리지를 처음 사용하는 경우, 먼저 Amazon S3의 S3 Glacier 스토리지 클래스, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval 및 S3 Glacier Deep Archive에 대해 자세히 알아보는 것을 권장합니다. 자세한 내용은 Amazon S3 사용 설명서의 S3 Glacier 스토리지 클래스 및 객체 보관용 스토리지 클래스를 참조하십시오.

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

파트 목록 조회(GET uploadID)

설명

이번 멀티파트 업로드 작업에서는 업로드 ID로 식별되는 특정 멀티파트 업로드에서 업로드된 아카이브의 파트 목록을 조회합니다. 멀티파트 업로드에 대한 자세한 내용은 대용량 아카이브를 여러 파트로 나누어 업로드(멀티파트 업로드) 단원을 참조하십시오.

이 요청은 멀티파트 업로드를 완료하기 전에 멀티파트 업로드가 진행 중이라면 언제든지 가능합니다. S3 Glacier는 각 파트 업로드에서 사용자가 지정한 범위를 기준으로 정렬된 파트 목록을 반환합니다. 멀티파트 업로드가 완료된 후에 파트 목록 조회 요청을 보내면 Amazon S3 Glacier(S3 Glacier)가 오류를 반환합니다.

파트 목록 조회 작업은 페이지 매김을 지원합니다. 응답 본문의 Marker 필드는 항상 확인하여 목록을 계속 이어가는 마커가 있는지 살펴야 합니다. 항목이 더 이상 없는 경우에는 marker 필드가 null 값을 갖습니다. marker가 null 값이 아닌 경우 다음 파트 세트를 가져오려면 S3 Glacier가 이전 파트 목록 요청에 대한 응답으로 반환한 마커 값으로 설정된 marker 요청 파라미터로 파트 목록 요청을 한 번 더 전송합니다.

또한 요청 시 limit 파라미터를 지정하여 응답으로 반환되는 파트 수를 제한할 수도 있습니다.

요청

조건

진행 중인 멀티파트 업로드의 파트 목록을 조회하려면 GET 요청을 멀티파트 업로드 ID의 리소스 URI로 전송합니다. 멀티파트 업로드 ID는 멀티파트 업로드를 시작할 때(멀티파트 업로드 시작(POST multipart-uploads)) 반환됩니다. 옵션으로 marker 및 limit 파라미터를 지정할 수 있습니다.

GET /AccountId/vaults/VaultName/multipart-uploads/uploadID HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
x-amz-glacier-version: 2012-06-01

참고

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

요청 파라미터

이름 설명 필수
limit

반환할 파트의 최대 수입니다. 기본 제한은 50개입니다. 반환되는 파트 수가 지정한 제한보다 적을 수 있지만 제한을 초과할 수는 없습니다.

유형: 문자열

제약 조건: 최소 정수 값 1. 최대 정수 값 50

 아니요
marker

페이지 매김에 사용되는 불투명한 문자열입니다. marker는 파트 목록 조회가 시작되는 파트를 지정합니다. 이전 파트 목록 조회 응답에서 marker 값을 가져옵니다. marker는 이전 파트 목록 조회 요청에서 시작된 결과에 페이지를 계속해서 매겨야 하는 경우에만 추가합니다.

유형: 문자열

제약 조건: 없음

 아니요

요청 헤더

이 작업은 대부분의 응답에 일반적인 응답 헤더만 사용합니다. 일반적인 응답 헤더에 대한 내용은 공통 응답 헤더 단원을 참조하십시오.

요청 본문

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

응답

조건

HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: Length

{
    "ArchiveDescription" : String,
    "CreationDate" : String,
    "Marker": String,
    "MultipartUploadId" : String,
    "PartSizeInBytes" : Number,
    "Parts" : 
    [ {
      "RangeInBytes" : String,
      "SHA256TreeHash" : String
      },
      ...
     ],
    "VaultARN" : String
}

응답 헤더

이 작업은 대부분의 응답에 일반적인 응답 헤더만 사용합니다. 일반적인 응답 헤더에 대한 내용은 공통 응답 헤더 단원을 참조하십시오.

응답 본문

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

S3 Glacier가 파트에 대해 계산한 SHA256 트리-해시 값입니다. 이 필드는 절대 null 값을 가질 수 없습니다.

유형: 문자열

VaultARN

멀티파트 업로드가 시작되는 볼트의 Amazon 리소스 이름(ARN)입니다.

유형: 문자열

오류

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

예시

예제: 멀티파트 업로드의 파트 목록 조회

다음은 업로드하는 모든 파트의 목록을 조회하는 예제입니다. 아래 예제는 HTTP GET 요청을 진행 중인 멀티파트 업로드의 멀티파트 업로드 ID URI로 전송하고 최대 1,000개까지 파트를 반환합니다.

예 요청

GET /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
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가 응답에서 지정된 멀티파트 업로드 ID와 연결되어 업로드된 파트 목록을 반환합니다. 이번 예제에서는 파트가 2개뿐입니다. 반환되는 Marker 필드가 null 값을 갖기 때문에 멀티파트 업로드에 남아있는 파트가 더 없다는 것을 의미합니다.

HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT
Content-Type: application/json
Content-Length: 412
      
{
    "ArchiveDescription" : "archive description",
    "CreationDate" : "2012-03-20T17:03:43.221Z",
    "Marker": null,
    "MultipartUploadId" : "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE",
    "PartSizeInBytes" : 4194304,
    "Parts" : 
    [ {
      "RangeInBytes" : "0-4194303",
      "SHA256TreeHash" : "01d34dabf7be316472c93b1ef80721f5d4"
      },
      {
      "RangeInBytes" : "4194304-8388607",
      "SHA256TreeHash" : "0195875365afda349fc21c84c099987164"
      }],
    "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/demo1-vault"
}

예제: 멀티파트 업로드의 파트 목록 조회(Marker 및 Limit Request 파라미터 지정)

다음은 페이지 매김을 사용해 결과 수를 제한하는 방법을 나타낸 예제입니다. 아래 예제는 HTTP GET 요청을 진행 중인 멀티파트 업로드의 멀티파트 업로드 ID URI로 전송하고 파트 1개를 반환합니다. 파트 목록을 시작할 파트에서 첫 번째 marker 파라미터가 지정됩니다. 이전 파트 목록 조회 요청의 응답에서 marker 값을 가져올 수 있습니다. 또한 이번 예제에서는 limit 파라미터가 1로 설정되어 파트를 1개 반환합니다. Marker 필드가 null 값이 아니기 때문에 가져올 파트가 적어도 1개 이상이란 것을 의미합니다.

예 요청

GET /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE?marker=1001&limit=1 HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
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가 응답에서 지정된 진행 중 멀티파트 업로드 ID와 연결되어 업로드된 파트 목록을 반환합니다.

HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT
Content-Type: text/json
Content-Length: 412
      
{
    "ArchiveDescription" : "archive description 1",
    "CreationDate" : "2012-03-20T17:03:43.221Z",
    "Marker": "MfgsKHVjbQ6EldVl72bn3_n5h2TaGZQUO-Qb3B9j3TITf7WajQ",
    "MultipartUploadId" : "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE",
    "PartSizeInBytes" : 4194304,
    "Parts" : 
    [ {
      "RangeInBytes" : "4194304-8388607",
      "SHA256TreeHash" : "01d34dabf7be316472c93b1ef80721f5d4"
      }],
    "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/demo1-vault"
}