- Print
- PDF
ListParts
- Print
- PDF
Available in Classic and VPC
You can view the parts of an object uploaded to a bucket with a multipart upload.
Requests
The following describes the request format for the endpoint. The request format is as follows.
Method | URI |
---|---|
GET | /{bucket-name}/{object-name} |
Request syntax
The request syntax is as follows.
GET https://{endpoint}/{bucket-name}/{object-name}?uploadId={uploadId} # path style
GET https://{bucket-name}.{endpoint}/{object-name}?uploadId={uploadId} # virtual host style
Request headers
For headers common to all Object Storage APIs, see Object Storage common headers.
Request path parameters
The following describes the parameters.
Field | Type | Required | Description |
---|---|---|---|
bucket-name | String | Required | Name of the bucket where the object is stored |
object-name | String | Required | Name of the object that ran the multipart upload |
Request query parameters
The following describes the parameters.
Field | Type | Required | Description |
---|---|---|---|
uploadId | String | Required | Upload ID received by running the InitiateMultipartUpload API |
max-parts | String | Optional | Maximum number of parts retrieved
|
part-number-marker | Integer | Optional | Starting point of the part being viewed
|
If the total number of parts exceeds 1000 or the max-parts
specification, the IsTruncated
item will be marked as true
, and you can specify NextPartNumberMarker
in the part-number-marker
parameter in subsequent requests to retrieve the list of parts following the list retrieved in the previous request.
Request example
The following is a sample request.
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
Responses
The following describes the response format.
Response headers
For response headers common to all Object Storage APIs, see Object Storage common response headers.
Response status codes
For response status codes common to all Object Storage APIs, see Object Storage response status codes.
Response example
The following is a sample response.
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>