ListParts
    • PDF

    ListParts

    • PDF

    기사 요약

    개요

    멀티파트 업로드를 시작한 오브젝트에 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
    

    파라미터

    파라미터명필수 여부타입제약 사항설명
    uploadIdYesstring멀티파트 업로드를 식별하는 ID
    max-partsNostring조회되는 목록의 최대 개수 지정
    part-number-markerNonumberMin: 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.gov-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>
    

    이 문서가 도움이 되었습니까?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.