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
파라미터
파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
---|---|---|---|---|
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.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>
이 문서가 도움이 되었습니까?