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

설명

이번 멀티파트 업로드 작업에서는 특정 볼트에서 진행 중인 멀티파트 업로드 목록을 표시합니다. 진행 중인 멀티파트 업로드란 멀티파트 업로드 시작(POST multipart-uploads) 요청으로 시작되었지만 아직 완료되거나 중단되지 않은 멀티파트 업로드를 말합니다. 멀티파트 업로드 목록 조회에 대한 응답으로 반환되는 목록은 정해진 순서가 없습니다.

멀티파트 업로드 목록 조회 작업은 페이지 매김을 지원합니다. 기본적으로 이번 작업에서 반환되는 멀티파트 업로드 수는 최대 50개입니다. 응답 본문의 marker 필드는 항상 확인하여 목록을 계속 이어가는 마커가 있는지 살펴야 합니다. 항목이 더 이상 없는 경우에는 marker 필드가 null 값을 갖습니다.

marker가 null 값이 아닌 경우 다음 멀티파트 업로드 세트를 가져오려면 Amazon S3 Glacier(S3 Glacier)가 이전 멀티파트 업로드 목록 요청에 대한 응답으로 반환한 마커 값으로 설정된 marker 요청 파라미터로 멀티파트 업로드 목록 요청을 한 번 더 전송합니다.

이번 작업과 파트 목록 조회(GET uploadID) 작업의 차이점에 대해서 알아둘 필요가 있습니다. 멀티파트 업로드 목록 조회 작업은 볼트 1개의 멀티파트 업로드 목록을 모두 조회합니다. 하지만 파트 목록 조회 작업은 업로드 ID로 식별되는 특정 멀티파트 업로드의 파트를 반환합니다.

멀티파트 업로드에 대한 자세한 내용은 대용량 아카이브를 여러 파트로 나누어 업로드(멀티파트 업로드) 단원을 참조하십시오.

요청

조건

멀티파트 업로드 목록을 조회하려면 GET 요청을 볼트의 multipart-uploads 하위 리소스 URI로 전송합니다. 옵션으로 marker 및 limit 파라미터를 지정할 수 있습니다.

GET /AccountId/vaults/VaultName/multipart-uploads 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

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

응답 헤더

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

응답 본문

JSON 응답 본문에는 다음과 같은 JSON 필드가 포함됩니다.

ArchiveDescription

멀티파트 업로드 시작 요청에서 지정한 아카이브 설명입니다. 멀티파트 업로드 시작 작업에서 아카이브 설명을 지정하지 않은 경우 이 필드는 null 값을 갖습니다.

유형: 문자열

CreationDate

멀티파트 업로드가 시작된 시간(UTC)입니다.

유형: 문자열. ISO 8601 날짜 형식의 문자열 표현입니다. 예: 2013-03-20T17:03:43.221Z

마커

결과에 페이지를 계속해서 매기는 지점을 나타내는 불투명한 문자열입니다. 멀티파트 업로드 목록 조회 요청을 새롭게 전송하면서 marker를 사용하여 목록의 업로드를 추가로 가져옵니다. 남은 업로드가 더 없을 경우 이 값은 null입니다.

유형: 문자열

PartSizeInBytes

멀티파트 업로드 시작(POST multipart-uploads) 요청에서 지정하는 파트 크기입니다. 마지막 파트를 제외하고 업로드되는 파트의 총 크기이기 때문에 이 크기보다 작을 수도 있습니다.

형식: 숫자

MultipartUploadId

멀티파트 업로드 ID입니다.

유형: 문자열

UploadsList

멀티파트 업로드 객체에 대한 메타데이터 목록입니다. 이 목록의 항목은 각각 ArchiveDescription, CreationDate, MultipartUploadId, PartSizeInBytes, VaultARN 등을 포함하여 해당하는 업로드의 이름-값 페어 집합으로 구성됩니다.

유형: 배열

VaultARN

아카이브가 저장되는 볼트의 Amazon 리소스 이름(ARN)입니다.

유형: 문자열

오류

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

예시

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

다음은 볼트에서 진행 중인 모든 멀티파트 업로드 목록을 조회하는 예제입니다. 이번 예제에서는 HTTP GET 요청이 지정된 볼트의 multipart-uploads 하위 리소스 URI로 전송됩니다. 요청에서 marker 파라미터와 limit 파라미터를 지정하지 않았기 때문에 최대 1,000개까지 진행 중인 멀티파트 업로드가 반환됩니다.

예 요청

GET /-/vaults/examplevault/multipart-uploads 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는 지정된 볼트에서 진행 중인 모든 멀티파트 업로드의 목록을 응답에서 반환합니다. 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: 1054
      
{
  "Marker": null, 
  "UploadsList": [ 
    {
      "ArchiveDescription": "archive 1",
      "CreationDate": "2012-03-19T23:20:59.130Z",
      "MultipartUploadId": "xsQdFIRsfJr20CW2AbZBKpRZAFTZSJIMtL2hYf8mvp8dM0m4RUzlaqoEye6g3h3ecqB_zqwB7zLDMeSWhwo65re4C4Ev",
      "PartSizeInBytes": 4194304,
      "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
    }, 
    {
      "ArchiveDescription": "archive 2",
      "CreationDate": "2012-04-01T15:00:00.000Z",
      "MultipartUploadId": "nPyGOnyFcx67qqX7E-0tSGiRi88hHMOwOxR-_jNyM6RjVMFfV29lFqZ3rNsSaWBugg6OP92pRtufeHdQH7ClIpSF6uJc",
      "PartSizeInBytes": 4194304,
      "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
    },
    {
      "ArchiveDescription": "archive 3",
      "CreationDate": "2012-03-20T17:03:43.221Z",
      "MultipartUploadId": "qt-RBst_7yO8gVIonIBsAxr2t-db0pE4s8MNeGjKjGdNpuU-cdSAcqG62guwV9r5jh5mLyFPzFEitTpNE7iQfHiu1XoV",
      "PartSizeInBytes": 4194304,
      "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
    } 
  ]
}    

예제: 부분적 멀티파트 업로드 목록 조회

다음은 페이지 매김을 사용해 결과 수를 제한하는 방법을 나타낸 예제입니다. 이번 예제에서는 HTTP GET 요청이 지정된 볼트의 multipart-uploads 하위 리소스 URI로 전송됩니다. 또한 limit 파라미터가 1로 설정되어 있습니다. 이는 목록에서 반환되는 업로드 수가 1개로 제한된다는 것을 의미하며, marker 파라미터는 반환 목록이 시작되는 멀티파트 업로드 ID를 나타냅니다.

예 요청

GET /-/vaults/examplevault/multipart-uploads?limit=1&marker=xsQdFIRsfJr20CW2AbZBKpRZAFTZSJIMtL2hYf8mvp8dM0m4RUzlaqoEye6g3h3ecqB_zqwB7zLDMeSWhwo65re4C4Ev 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

응답의 예

Amazon S3 Glacier(S3 Glacier)는 지정된 볼트에서 진행 중인 두 개 이하의 멀티파트 업로드 목록을 응답에서 반환하는데, 지정된 마커부터 시작하여 결과를 두 개씩 반환합니다.

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: 470

{
  "Marker": "qt-RBst_7yO8gVIonIBsAxr2t-db0pE4s8MNeGjKjGdNpuU-cdSAcqG62guwV9r5jh5mLyFPzFEitTpNE7iQfHiu1XoV",
  "UploadsList" : [ 
    {
      "ArchiveDescription": "archive 2",
      "CreationDate": "2012-04-01T15:00:00.000Z",
      "MultipartUploadId": "nPyGOnyFcx67qqX7E-0tSGiRi88hHMOwOxR-_jNyM6RjVMFfV29lFqZ3rNsSaWBugg6OP92pRtufeHdQH7ClIpSF6uJc",
      "PartSizeInBytes": 4194304,
      "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
    }
  ]
}   

관련 단원

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

• 파트 업로드(PUT uploadID)

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

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

• 파트 목록 조회(GET uploadID)

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

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