이 페이지는 저장소와 2012년 원래 REST API를 사용하는 S3 Glacier 서비스의 기존 고객만 사용할 수 있습니다.

아카이브 스토리지 솔루션을 찾고 있다면 Amazon S3의 S3 Glacier 스토리지 클래스 S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval 및 S3 Glacier Deep Archive를 사용하는 것이 좋습니다. 이러한 스토리지 옵션에 대한 자세한 내용은 Amazon S3 사용 설명서의 S3 Glacier 스토리지 클래스 및 S3 Glacier 스토리지 클래스를 사용한 장기 데이터 저장을 참조하세요. 이러한 스토리지 클래스는 Amazon S3 API를 사용하며, 모든 리전에서 사용 가능하고, Amazon S3 콘솔 내에서 관리할 수 있습니다. 스토리지 비용 분석, Storage Lens, 고급 선택적 암호화 기능 등과 같은 기능을 제공합니다.

멀티파트 업로드 목록 조회(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

요청 파라미터

요청 헤더

이 작업은 대부분의 응답에 일반적인 응답 헤더만 사용합니다. 일반적인 응답 헤더에 대한 내용은 공통 응답 헤더 섹션을 참조하세요.

요청 본문

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

응답

구문

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 필드가 포함됩니다.

Errors

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"
    }
  ]
}   

관련 단원