List Parts 本节主要介绍List Parts。 该操作用于列出一次分片上传过程中已经上传完成的所有片段。 该操作必须包含一个通过Initial Multipart Upload操作获取的上传ID。该请求最多返回1000个上传片段信息,默认返回的片段数是1000。用户可以通过指定maxparts参数来指定一次请求返回的片段数。如果用户的分片上传过程超过1000个片段,响应中的IsTruncated字段的值则被设置成true,并且指定一个NextPartNumberMarker元素。用户可以在下一个连续的List Part请求中加入partnumbermarker参数,并把它的值设置成上一个请求返回的NextPartNumberMarker值。 请求语法 GET /ObjectName?uploadIdUploadId HTTP/1.1 Host: BucketName.ooscn.ctyunapi.cn Date: Date Authorization: SignatureValue 请求头 名称 描述 是否必须 uploadId 该ID用来标识一个分片上传过程。 类型:字符串。 是 maxparts 设置响应体中返回的片段的最大数目。 类型:字符串。 取值:[1, 1000],默认值为1000。 否 partnumbermarker 指定此次列表的起始片段的分片号,只有比该片段的分片号更高的片段才会被列举出来。 类型:字符串。 否 encodingtype 指定响应中Key的编码类型。如果Key包含xml 1.0标准不支持的控制字符,可通过设置该参数对响应中的Key进行编码。 类型:字符串。 取值:url,字母不区分大小写。 否 响应结果 名称 描述 :: ListPartsResult 包含整个响应的容器。 类型:容器。 子节点:Bucket、EncodingType、Key、UploadId、Initiator、Owner、StorageClass、PartNumberMarker、NextPartNumberMarker、MaxParts、IsTruncated、Part。 Bucket 分片上传对应的bucket名称。 类型:字符串。 父节点:ListPartsResult。 EncodingType Key的编码类型。 类型:字符串。 父节点:ListPartsResult。 Key 新创建的文件的Key。 类型:字符串。 父节点:ListPartsResult。 UploadId 分片上传ID。 类型:字符串。 父节点:ListPartsResult。 Initiator 指定执行此次分片上传过程的用户账户。 类型:容器。 父节点:ListPartsResult。 子节点:ID、DisplayName。 ID OOS账户的ID。 类型:字符串。 父节点:Initiator。 DisplayName OOS账户的账户名。 类型:字符串。 父节点:Initiator。 StorageClass 文件的存储类型: STANDARD:标准存储。 STANDARDIA:低频访问存储。 类型:字符串。 父节点:ListPartsResult。 PartNumberMarker 列表起始位置的片段的分片号。 类型:整型。 父节点:ListPartsResult。 NextPartNumberMarker 当此次请求没有将所有片段列举完时,此元素指定列表中的最后一个片段的分片号。此分片号用于作为下一次连续列表请求的partnumbermarker参数的值。 类型:整型。 父节点:ListPartsResult。 MaxParts 响应中片段的最大数目。 类型:整型。 父节点:ListPartsResult。 IsTruncated 标识此次分片上传过程中的所有片段是否全部被列出,如果为true则表示没有全部列出。如果分片上传过程的片段数超过了MaxParts元素指定的最大数,则会导致一次列表请求无法将所有片段数列出。 类型:Boolean。 父节点:ListPartsResult。 Part 与某个片段对应的容器,响应中可能包含0个或多个Part元素。 类型:容器。 父节点:ListPartsResult。 子节点:PartNumber、LastModified、ETag、Size。 PartNumber 标识片段的分片号。 类型:整型。 父节点:Part。 LastModified 片段上传完成的日期。 类型:Date。 父节点:Part。 ETag 片段上传完成时返回的ETag值。 类型:字符串。 父节点:Part。 Size 片段的数据大小。 类型:整型。 父节点:Part。