ListParts
  • PDF

ListParts

  • PDF

The latest service changes have not yet been reflected in this content. We will update the content as soon as possible. Please refer to the Korean version for information on the latest updates.

개요

멀티파트 업로드를 시작한 오브젝트에 uploadId 파라미터가 지정된 GET 요청을 보내면 업로드된 파트를 조회합니다.
조회되는 파트의 최대 개수는 1000개이며, 기본값으로 1000개의 파트를 조회합니다. 조회되는 파트개수는 max-parts 파라미터를 지정하여 제한할 수 있습니다.
멀티파트 업로드의 파트 개수가 1000개(또는 max-parts 값) 보다 많은 경우 IsTruncated 항목이 true 값을 가지며, NextPartNumberMarker 항목이 포함된 응답이 반환됩니다. 후속 요청으로 part-number-marker 파라미터에 NextPartNumberMarker 값을 지정하면 이전 요청에서 조회된 목록 다음의 파트 목록을 조회할 수 있습니다.

요청

구문

GET https://{endpoint}/{bucket-name}/{object-name}?uploadId={uploadId} # path style
GET https://{bucket-name}.{endpoint}/{object-name}?uploadId={uploadId} # virtual host style

파라미터

파라미터명 필수 여부 타입 제약 사항 설명
uploadId Yes string 멀티파트 업로드를 식별하는 ID입니다.
max-parts No string 조회되는 목록의 최대 개수를 지정합니다.
part-number-marker No number Min: 0
Max: 1000
조회되는 목록의 시작 부분을 지정합니다.
해당 값보다 큰 번호의 파트가 조회됩니다.
기본값은 1000입니다.

예시

요청 예시

GET /some-bucket/multipart-object-123?uploadId=01000180-3f73-ad2d-2ed4-8bf4b9e5f6b5&max-parts=2 HTTP/1.1
Authorization: {authorization-string}
x-amz-date: 20220419T014350Z
Host: kr.object.ncloudstorage.com

응답 예시

HTTP/1.1 200 OK
Date: Tue, 19 Apr 2022 01:43:50 GMT
Accept-Ranges: bytes
x-amz-request-id: e5767394-0d66-4ce0-b53f-d0d449db0a24
Content-Type: application/xml
Content-Length: 668
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ListPartsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <Bucket>some-bucket</Bucket>
    <Key>mutipart-object-123</Key>
    <UploadId>01000180-3f73-ad2d-2ed4-8bf4b9e5f6b5</UploadId>
    <Initiator>
        <ID>{owner-user-id}</ID>
        <DisplayName>{owner-user-id}</DisplayName>
    </Initiator>
    <Owner>
        <ID>{owner-user-id}</ID>
        <DisplayName>{owner-user-id}</DisplayName>
    </Owner>
    <StorageClass>STANDARD</StorageClass>
    <NextPartNumberMarker>2</NextPartNumberMarker>
    <MaxParts>2</MaxParts>
    <IsTruncated>true</IsTruncated>
    <Part>
        <PartNumber>1</PartNumber>
        <LastModified>2022-04-19T01:33:30.285Z</LastModified>
        <ETag>"1c5169091bb3ca7440f67c603a1f60b5"</ETag>
        <Size>143693806</Size>
    </Part>
    <Part>
        <PartNumber>2</PartNumber>
        <LastModified>2022-04-19T02:14:11.202Z</LastModified>
        <ETag>"842169123bb3gr7440f67c546b1a85b7"</ETag>
        <Size>158964528</Size>
    </Part>
</ListPartsResult>

Was this article helpful?