

喜讯:国内、香港、海外云服务器租用特惠活动,2核/4G/10M仅需31元每月,点击抢购>>>
点击这里注册天翼云特邀VIP帐号,立即体验天翼云对象存储>>>
天翼云对象存储(经典版)I型API参考-List Part
该操作用于列出一次分片上传过程中已经上传完成的所有片段。
该操作必须包含一个通过Initial Multipart Upload操作获取的上传ID。该请求最多返回1000个上传片段信息,默认返回的片段数是1000。用户可以通过指定max-parts参数来指定一次请求返回的片段数。如果用户的分片上传过程超过1000个片段,响应中的IsTruncated字段的值则被设置成true,并且指定一个NextPartNumberMarker元素。用户可以在下一个连续的List Part请求中加入part-number-marker参数,并把它的值设置成上一个请求返回的NextPartNumberMarker值。
请求语法
GET /ObjectName?uploadId=UploadId HTTP/1.1 Host: BucketName.oos-cn.ctyunapi.cn Date: Date Authorization: Signature |
请求参数
名称 | 描述 | 是否必须 |
uploadId | 该ID用来标识一个分片上传过程。 类型:字符串。 | 是 |
max-parts | 设置响应体中返回的片段的最大数目。 类型:字符串。 取值:[0, 1000],默认值为1000。 | 否 |
encoding-type | 指定响应中Key的编码类型。如果Key包含xml 1.0标准不支持的控制字符,可通过设置该参数对响应中的Key进行编码。 类型:字符串。 取值:url,字母不区分大小写。 | 否 |
part-number-marker | 指定此次列表的起始片段的分片号,只有比该片段的分片号更高的片段才会被列举出来。 类型:字符串。 | 否 |
响应结果
名称 | 描述 |
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 | 指定执行此次分片上传过程的用户账户。 子节点:ID,DisplayName。 类型:容器 父节点:ListPartsResult 子节点:ID,DisplayName |
ID | OOS账户的ID。 类型:字符串 父节点:Initiator |
DisplayName | OOS账户的账户名。 类型:字符串 父节点:Initiator |
StorageClass | 对象的存储类型: l STANDARD:标准存储; l STANDARD_IA:低频访问存储。 类型:字符串 父节点:ListPartsResult |
PartNumberMarker | 列表起始位置的片段的分片号。 类型:Integer。 父节点:ListPartsResult。 |
NextPartNumberMarker | 当此次请求没有将所有片段列举完时,此元素指定列表中的最后一个片段的分片号。此分片号用于作为下一次连续列表请求的part-number-marker参数的值。 类型:Integer。 父节点:ListPartsResult。 |
MaxParts | 响应中片段的最大数目。 类型:Integer。 父节点:ListPartsResult。 |
IsTruncated | 标识此次分片上传过程中的所有片段是否全部被列出,如果为true则表示没有全部列出。如果分片上传过程的片段数超过了MaxParts元素指定的最大数,则会导致一次列表请求无法将所有片段数列出。 类型:Boolean。 父节点:ListPartsResult。 |
Part | 与某个片段对应的容器,响应中可能包含0个或多个Part元素。 类型:字符串。 父节点:ListPartsResult。 子节点:PartNumber, LastModified, ETag, Size。 |
推荐:TOP云智能建站优惠活动,仅880元即可搭建一个后台管理五端合一的智能网站(PC网站、手机网站、百度智能小程序、微信小程序、支付宝小程序),独享百度搜索SEO优势资源,让你的网站不仅有颜值有排面,更有排名,可以实实在在为您带来效益,请点击进入TOP云智能建站>>>,或咨询在线客服了解详情。
相关阅读
猜您喜欢
|



湘公网安备43019002001857号
备案号:
客服1