List Parts
Description: lists all blocks that have been uploaded
Request format:
GET /<ObjectName>?uploadId=<UploadId> HTTP/1.1
Host: <Your-Bucket-Name>.ss.bscstorage.com
Date: <date>
Authorization: <authorization string> #Please refer to signature algorithm
- Response:
HTTP/1.1 200 OK
Date: Tue, 08 Apr 2014 02:59:47 GMT
Connection: keep-alive
x-amz-request-id: 0000106c-1608-0810-4621-00163e000064
x-amz-s2-requester: <Your UserName>
<?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>initiator</ID>
<DisplayName></DisplayName>
</Initiator>
<Owner>
<ID>owner</ID>
<DisplayName></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>
- Request Parameters：
| Parameter | Description | Required |
|---|---|---|
| uploadId | Uploadid value obtained through Initiate Multipart Upload (large file fragment upload initialization interface) | Yes |
| max-parts | Returns the maximum number of parts, 2048 by default | Yes |
| part-number-marker | List the parts after the partnumber, excluding the part specified by the partnumber, which starts from 1 | Yes |
Request Headers：
Response Body（Response XML Body）：
| Name | Description |
|---|---|
| ListPartsResult | Contain Bucket, Key, UploadId, Initiator, Owner, StorageClass, PartNumberMarker, NextPartNumberMarker, MaxParts, IsTruncated, Part element |
| Bucket | bucket name |
| Key | objectName |
| UploadId | Identify the ID of the block upload. This parameter needs to be carried when uploading the block later |
| Initiator | Include ID, DisplayName element |
| ID | init UserName |
| DisplayName | |
| Owner | Include ID, DisplayName element, specific file's owner |
| StorageClass | storage class |
| PartNumberMarker | list initial partNumber, does not include this partNumber |
| NextPartNumberMarker | Start the partNumber of the list next time |
| MaxParts | Maximum part numbers |
| IsTruncated | Is it truncated |
| Part | It contains partnumber, LastModified, Etag and size elements to represent the information of a part |
| PartNumber | Number of part |
| LastModified | Last modification time of part |
| ETag | part's md5 |
| Size | part's size |