- Print
- PDF
ListParts
- Print
- 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.
Overview
Uploaded parts are searched when the uploadId parameter sends a designated GET request to an object which started a multi-part upload.
The maximum number of searched parts are 1000. 1000 parts are searched by default. The number of parts searched can be limited by specifying the max-parts parameter.
If the number of parts in a multi-part upload is greater than 1000 (or the max-parts value), then the IsTruncated item becomes true, and a response that includes the NextPartNumberMarker item is returned. You can specify the NextPartNumberMarker value in the part-number-marker parameter as a follow-up request to search the part list that follows the list viewed in the previous request.
Request
Statement
GET https://{endpoint}/{bucket-name}/{object-name}?uploadId={uploadId} # path style
GET https://{bucket-name}.{endpoint}/{object-name}?uploadId={uploadId} # virtual host style
Parameter
Parameter name | Requirement status | Type | Restrictions | Description |
---|---|---|---|---|
uploadId | Yes | string | It's an ID that identifies multi-part upload. | |
max-parts | No | string | It specifies the maximum number in the list searched. | |
part-number-marker | No | number | Min: 0 Max: 1000 | It specifies the beginning of the list searched. The parts that have numbering greater than this value are searched. The default value is 1000. |
Examples
Request examples
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
Response examples
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>