MENU
      ListParts

        ListParts


        기사 요약

        Classic/VPC 환경에서 이용 가능합니다.

        멀티파트 업로드로 버킷에 업로드된 오브젝트 파트를 조회할 수 있습니다.

        요청

        요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

        메서드URI
        GET/{bucket-name}/{object-name}

        요청 구문

        요청 구문은 다음과 같습니다.

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

        요청 헤더

        Object Storage API에서 공통으로 사용하는 헤더에 대한 자세한 내용은 Object Storage 공통 헤더를 참조해 주십시오.

        요청 경로 파라미터

        파라미터에 대한 설명은 다음과 같습니다.

        필드타입필수 여부설명
        bucket-nameStringRequired오브젝트가 저장된 버킷 이름
        object-nameStringRequired멀티파트 업로드를 실행한 오브젝트 이름

        요청 쿼리 파라미터

        파라미터에 대한 설명은 다음과 같습니다.

        필드타입필수 여부설명
        uploadIdStringRequiredInitiateMultipartUpload API를 실행해서 받은 업로드 ID
        max-partsStringOptional조회되는 파트의 최대 개수
        • 1,000 이하
        part-number-markerIntegerOptional조회되는 파트의 시작점
        • 입력한 값보다 큰 번호의 파트 조회
        • 0~1,000 (기본값: 1,000)
        참고

        파트 총 개수가 1,000개 또는 max-parts 지정값을 초과하면, IsTruncated 항목이 true로 표시되며, 이후 요청에서 part-number-marker 파라미터에 NextPartNumberMarker를 지정하면 이전 요청에서 조회된 목록 다음의 파트 목록을 조회할 수 있습니다.

        요청 예시

        요청 예시는 다음과 같습니다.

        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

        응답

        응답 형식을 설명합니다.

        응답 헤더

        Object Storage API에서 공통으로 사용하는 응답 헤더에 대한 자세한 내용은 Object Storage 공통 응답 헤더를 참조해 주십시오.

        응답 상태 코드

        Object Storage API에서 공통으로 사용하는 응답 상태 코드에 대한 자세한 내용은 Object Storage 응답 상태 코드를 참조해 주십시오.

        응답 예시

        응답 예시는 다음과 같습니다.

        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
        HTTP
        <?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>
        XML

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

        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.