The operation can list all multiparts under specified multipart upload. The request must contain Upload ID. The request returns 1,000 multiparts at most, the default count of returned multiparts is 1,000, and return count can be limited by specifying max-parts parameter. If there are over 1,000 multiparts in segment upload, IsTruncated with the value of true and NextPartNumberMarker element will be returned in the response. In the subsequent requests, you can use part-number-marker parameter and set its value as the field value of NextPartNumberMarker in the previous response.
GET /ObjectName?uploadId=UploadId HTTP/1.1 Host: <bucket>.s3.<region>.jdcloud-oss.com Date: <date> Authorization: <authorization string>
Parameter | Description | Must |
---|---|---|
encoding-type | Request OSS to encode the response and specify the encoding method. Type: String Default: None Valid value: url |
No |
uploadID | Identify a certain multipart upload. Type: String Default: None |
Yes |
max-parts | Set the maximum return count of multiparts. Type: String Default: 1,000 |
No |
part-number-marker | Specify the multiparts to be listed after the certain position of the List. Type: String Default: None |
No |
No Special Request Header
No Request Elements
No Special Response Header
Name | Description |
---|---|
x-amz-abort-date | If the life cycle rules of the Bucket are configured as terminating uncompleted multipart upload (it will be supported after launch of put bucket lifecycle), and the prefix in the rule is consistent with the name of Object in the request, then the response contains the Header. Type: String |
x-amz-abort-rule-id | It will be returned with x-amz-abort-date, which are used to identify life cycle rules. Type: String |
ListPartsResult | Response Information Set. Children: Bucket, Key, UploadId, Initiator, Owner, StorageClass, PartNumberMarker, NextPartNumberMarker, MaxParts, IsTruncated, Part Type: Container |
Bucket | Bucket where multipart upload is located. Type: String Ancestor: ListPartsResult |
Encoding-Type | Encoding type of Object name in XML response, if encoding-type parameter is specified in the request, the response contains the element. Type: String Ancestor: ListBucketResult |
key | Object of Multipart Upload. Type: String Ancestor: ListPartsResult |
UploadID | Identify multipart upload. Type: String Ancestor: ListPartsResult |
Initiator | Identify user Information set of started multipart upload. Children: ID, DisplayName Type: Container Ancestor: ListPartsResult |
ID | User ID Type: String Ancestor: Initiator |
DisplayName | User Name Type: String Ancestor: Initiator |
Owner | Information Set of Object Owner. Children: ID, DisplayName Type: Container Ancestor: ListPartsResult |
StorageClass | Storage Type Type: String Ancestor: ListPartsResult |
PartNumberMarker | List multiparts after a certain number. Type: Integer Ancestor: ListPartsResult |
NextPartNumberMarker | When part count is exceeded, the element specifies the next multipart in the list, with its value being the parameter of part-number-marker in the next request. Type: Integer Ancestor: ListPartsResult |
MaxParts | Return maximum count of multiparts. Type: Integer Ancestor: ListPartsResult |
IsTruncated | Indicate whether returned multipart list is truncated. True presents it is truncated. Type: Boolean Ancestor: ListPartsResult |
Part | Multipart Information Set. Children: PartNumber, LastModified, ETag, Size Type: String Ancestor: ListPartsResult |
PartNumber | Multipart Identifier Number. Type: Integer Ancestor: Part |
LastModified | Time of multipart upload completion. Type: Date Ancestor: Part |
ETag | Returned Entity Tag of Multipart Upload. Type: String Ancestor: Part |
Size | Multipart Size Type: Integer Ancestor: Part |
GET /example-object?uploadId=XXBsb2FkIElEIGZvciBlbHZpbmcncyVcdS1tb3ZpZS5tMnRzEEEwbG9hZA&max-parts=2&part-number-marker=1 HTTP/1.1 Host: oss-example.s3.<region>.jdcloud-oss.com Date: Mon, 1 Nov 2010 20:34:56 GMT Authorization: <authorization string>
HTTP/1.1 200 OK x-amz-request-id: 656c76696e6727732072657175657374 Date: Mon, 1 Nov 2010 20:34:56 GMT Content-Length: 985 Connection: keep-alive Server: JDCloudOSS <?xml version="1.0" encoding="UTF-8"?> <ListPartsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/"> <Bucket>example-bucket</Bucket> <Key>example-object</Key> <UploadId>XXBsb2FkIElEIGZvciBlbHZpbmcncyVcdS1tb3ZpZS5tMnRzEEEwbG9hZA</UploadId> <Initiator> <ID>arn:aws:iam::111122223333:user/some-user-11116a31-17b5-4fb7-9df5-b288870f11xx</ID> <DisplayName>umat-user-11116a31-17b5-4fb7-9df5-b288870f11xx</DisplayName> </Initiator> <Owner> <ID>75aa57f09aa0c8caeab4f8c24e99d10f8e7faeebf76c078efc7c6caea54ba06a</ID> <DisplayName>someName</DisplayName> </Owner> <StorageClass>STANDARD</StorageClass> <PartNumberMarker>1</PartNumberMarker> <NextPartNumberMarker>3</NextPartNumberMarker> <MaxParts>2</MaxParts> <IsTruncated>true</IsTruncated> <Part> <PartNumber>2</PartNumber> <LastModified>2010-11-10T20:48:34.000Z</LastModified> <ETag>"7778aef83f66abc1fa1e8477f296d394"</ETag> <Size>10485760</Size> </Part> <Part> <PartNumber>3</PartNumber> <LastModified>2010-11-10T20:48:33.000Z</LastModified> <ETag>"aaaa18db4cc2f85cedef654fccc4a4x8"</ETag> <Size>10485760</Size> </Part> </ListPartsResult>