喜讯：国内、香港、海外云服务器租用特惠活动，2核/4G/10M仅需31元每月，点击抢购>>>
点击这里注册天翼云特邀VIP帐号，立即体验天翼云对象存储>>>
天翼云对象存储（经典版）I型API参考-List Multipart Uploads
该接口用于列出所有已经通过Initiate Multipart Upload请求初始化，但未完成或未终止的分片上传过程。
响应中最多返回1000个分片上传过程的信息，它既是响应能返回的最大分片上传过程数目，也是请求的默认值。用户也可以通过设置max-uploads参数来限制响应中的分片上传过程数目。如果当前的分片上传过程数超出了这个值，则响应中会包含一个值为true的IsTruncated元素。如果用户要列出多于这个值的分片上传过程信息，则需要继续调用List Multipart Uploads请求，并在请求中设置key-marker和upload-id-marker参数。
在响应体中，分片上传过程的信息通过key来排序。如果用户的应用程序中启动了多个使用同一key对象开头的分片上传过程，那么响应体中分片上传过程首先是通过key来排序，在相同key的分片上传内部则是按上传启动的起始时间的升序来进行排列。
请求语法
GET /?uploads HTTP/1.1 Host: BucketName.oos-cn.ctyunapi.cn Date: Date Authorization: Signature |
请求参数
名称 | 描述 | 是否必须 |
delimiter | 分隔符，一个用来对关键字们进行分组的字符。所有的关键字都包含delimiter和prefix间的相同子串，prefix之后第一个遇到delimiter的字符串都会加到一个叫CommonPrefix的组中。如果没有特别定义prefix，所有的关键字都会被返回，但不会有CommonPrefix。delimiter只支持”/”，不支持其他分隔符。 类型：字符串 | 否 |
max-uploads | 设置返回的分片上传过程的最大数目。 类型：Integer 取值：[ 1, 1000 ] 默认值：1000 | 否 |
key-marker | 与upload-id-marker参数一起，该参数指定列表操作从什么位置后面开始。如果upload-id-marker参数没有被指定，那么只有比key-marker参数指定的key更大的key会被列出。如果upload-id-marker参数被指定，任何包含与key-marker指定值相等或大于key的分片上传过程都会被包括，假设这些分片上传过程包含了比upload-id-marker指定值更大的ID。 类型：字符串 | 否 |
prefix | 该参数用于列出那些以prefix为前缀的正在进行的上传过程，用户可以使用多个prefix来把一个bucket分成不同的组（可以考虑采用类似文件系统中的文件夹的作用那样，使用prefix来对key进行分组）。 | 否 |
upload-id-marker | 与key-marker参数一起，指定列表操作从什么位置后面开始。如果key-marker没有被指定，upload-id-marker参数也会被忽略。否则，任何key值等于或大于key-marker的上传过程都会被包含在列表中，只要ID大于upload-id-marker指定的值。 | 否 |
encoding-type | 指定响应中KeyMarker、NextKeyMarker、Key、Prefix、Delimiter的编码类型。如果KeyMarker、NextKeyMarker、Key、Prefix、Delimiter包含xml 1.0标准不支持的控制字符，可通过设置该参数对响应中的KeyMarker、NextKeyMarker、Key、Prefix、Delimiter进行编码。 类型：字符串 取值：url，字母不区分大小写。 | 否 |
upload-id-marker | 与key-marker参数一起，指定列表操作从什么位置后面开始。如果key-marker没有被指定，upload-id-marker参数也会被忽略。否则，任何key值等于或大于key-marker的上传过程都会被包含在列表中，只要ID大于upload-id-marker指定的值。 | 否 |
响应结果
名称 | 描述 |
ListMultipartUploadsResult | 包含整个响应的容器。 类型：容器 子节点：Bucke、KeyMarker、UploadIdMarker、NextKeyMarker、NextUploadIdMarker,Maxuploads、Delimiter、Prefix、Commonfixes、IsTruncated、EncodingType |
Bucket | 分片上传对应的容器名称。 类型：字符串 父节点：ListMultipartUploadsResult |
KeyMarker | 指定key值，在这个key当前位置或它之后开始列表操作。 类型：字符串 父节点：ListMultipartUploadsResult |
UploadIdMarker | 指定分片上传ID，在这个ID所在位置之后开始列表操作。 类型：字符串 父节点：ListMultipartUploadsResult |
NextKeyMarker | 当此次列表不能将所有正在执行的分片上传过程列举完成时，NextKeyMarker作为下一次列表请求的key-marker参数的值。 类型：字符串 父节点：ListMultipartUploadsResult |
NextUploadIdMarker | 当此次列表不能将所有正在执行的分片上传过程列举完成时，NextKeyMarker作为下一次列表请求的upload-id-marker参数的值。 类型：字符串 父节点：ListMultipartUploadsResult |
MaxUploads | 响应中包含的上传过程的最大数目。 类型：字符串 父节点：ListMultipartUploadsResult |
IsTruncated | 标识此次分片上传过程中的所有片段是否全部被列出，如果为true则表示没有全部列出。如果分片上传过程的片段数超过了MaxParts元素指定的最大数，则会导致一次列表请求无法将所有片段数列出。 类型：Boolean 父节点：ListMultipartUploadsResult |
EncodingType | Key的编码类型。 类型：字符串 父节点：ListMultipartUploadsResult |
Upload | 某个分片上传过程的容器，响应体中可能包含0个或多个Upload元素。 类型: 容器 父节点: ListMultipartUploadsResult 子节点: Key、UploadId、Initiator、Owner、StorageClass、Initiated |
Key | 分片上传过程起始位置对象的Key值。 类型: Integer 父节点: Upload |
UploadId | 分片上传过程的ID号。 类型: Integer 父节点: Upload |
Initiator | 指定执行此次分片上传过程的用户账户。 子节点：ID，DisplayName 类型：容器 父节点：Upload |
ID | OOS账户的ID。 类型：字符串 推荐：TOP云智能建站优惠活动，仅880元即可搭建一个后台管理五端合一的智能网站（PC网站、手机网站、百度智能小程序、微信小程序、支付宝小程序），独享百度搜索SEO优势资源，让你的网站不仅有颜值有排面，更有排名，可以实实在在为您带来效益，请点击进入TOP云智能建站>>>，或咨询在线客服了解详情。 相关阅读
猜您喜欢
Copyright ? 2021-2025 尊托云数科技 All Rights Reserved. |
湘公网安备43019002001857号
备案号：
客服1 