该操作可列出指定分片上传下所有的分片。该请求必须包含Upload ID。该请求最多返回1000个分片,返回分片数量默认为1000,可通过指定max-parts参数来限制返回数量。如果分段上传超过1000个分片,响应中将返回IsTruncated,且值为true,以及NextPartNumberMarker元素。在之后的请求中,您可以使用part-number-marker参数并其值设置为上一个响应中NextPartNumberMarker中字段值。
GET /ObjectName?uploadId=UploadId HTTP/1.1 Host: <bucket>.s3.<region>.jdcloud-oss.com Date: <date> Authorization: <authorization string>
参数 | 描述 | 必须 |
---|---|---|
encoding-type | 请求OSS对响应进行编码并指定编码方法。 Type: String Default: None Valid value: url |
否 |
uploadID | 标识某一分片上传。 Type: String Default: None |
是 |
max-parts | 设置分片的最大返回数。 Type: String Default: 1,000 |
否 |
part-number-marker | 指定列出列表某处之后的分片。 Type: String Default: None |
否 |
无特殊请求Header
无请求元素
无特殊响应Header
名称 | 描述 |
---|---|
x-amz-abort-date | 如果Bucket的生命周期规则配置了中止不完成的分片上传(put bucket lifecycle上线后支持),且规则中前缀与请求中Object名称匹配,则响应包含此Header。 Type: String |
x-amz-abort-rule-id | 与x-amz-abort-date一起返回,用来标识生命周期规则。 Type: String |
ListPartsResult | 响应信息集合。 Children: Bucket, Key, UploadId, Initiator, Owner, StorageClass, PartNumberMarker, NextPartNumberMarker, MaxParts, IsTruncated, Part Type: Container |
Bucket | 分片上传所在Bucket。Type: String Ancestor: ListPartsResult |
Encoding-Type | 在XML响应中Object名称的编码类型,如果请求指定encoding-type参数,则响应中包含此元素。Type: String Ancestor: ListBucketResult |
key | 分片上传的Object。 Type: String Ancestor: ListPartsResult |
UploadID | 标识分片上传。 Type: String Ancestor: ListPartsResult |
Initiator | 标识启动的分片上传的用户信息的集合。 Children: ID, DisplayName Type: Container Ancestor: ListPartsResult |
ID | 用户ID Type: String Ancestor: Initiator |
DisplayName | 用户名 Type: String Ancestor: Initiator |
Owner | Object拥有者的信息集合。 Children: ID, DisplayName Type: Container Ancestor: ListPartsResult |
StorageClass | 存储类型 Type: String Ancestor: ListPartsResult |
PartNumberMarker | 列出某一number后的分片。 Type: Integer Ancestor: ListPartsResult |
NextPartNumberMarker | 当part数超出后,该元素指定列表中下一个分片,该值作为下个请求中的part-number-marker参数。 Type: Integer Ancestor: ListPartsResult |
MaxParts | 返回分片最大数量。 Type: Integer Ancestor: ListPartsResult |
IsTruncated | 指示返回的分片列表是否截断。true代表被截断。 Type: Boolean Ancestor: ListPartsResult |
Part | 分片信息集合。 Children: PartNumber, LastModified, ETag, Size Type: String Ancestor: ListPartsResult |
PartNumber | 分片标识号。 Type: Integer Ancestor: Part |
LastModified | 分片上传到的时间。 Type: Date Ancestor: Part |
ETag | 分片上传返回的实体标签。 Type: String Ancestor: Part |
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>