租户端 存储 对象存储（COS） COS API参考 查询分块上传

查询分块上传

最近更新时间: 2025-02-18 16:02:00

功能描述

List Multipart Uploads 用来查询正在进行中的分块上传。单次请求操作最多列出1000个正在进行中的分块上传。

注意：

该请求需要有 Bucket 的读权限。

请求

请求示例

GET /?uploads HTTP/1.1
Host: <BucketName-APPID>.<Endpoint>
Date: GMT Date
Authorization: Auth String

说明：

Authorization: Auth String（详情请参阅请求签名文档）。

请求头

公共头部

该请求操作的实现使用公共请求头，了解公共请求头详情请参阅 公共请求头部 文档。

非公共头部

该请求操作无特殊的请求头部信息。

请求参数

具体内容如下：

名称描述类型必选
delimiter定界符为一个符号，对 Object 名字包含指定前缀且第一次出现 delimiter 字符之间的 Object 作为一组元素：common prefix。如果没有 prefix，则从路径起点开始String否
encoding-type规定返回值的编码格式，合法值：urlString否
prefix限定返回的 Object key 必须以 Prefix 作为前缀。
注意使用 prefix 查询时，返回的 key 中仍会包含 Prefix		String否
max-uploads设置最大返回的 multipart 数量，合法取值从1到1000，默认1000String否
key-marker与 upload-id-marker 一起使用
当 upload-id-marker 未被指定时，ObjectName 字母顺序大于 key-marker 的条目将被列出
当 upload-id-marker 被指定时，ObjectName 字母顺序大于 key-marker 的条目被列出，ObjectName 字母顺序等于 key-marker 同时 UploadID 大于 upload-id-marker 的条目将被列出		String否
upload-id-marker与 key-marker 一起使用
当 key-marker 未被指定时，upload-id-marker 将被忽略
当 key-marker 被指定时，ObjectName字母顺序大于 key-marker 的条目被列出，ObjectName 字母顺序等于 key-marker 同时 UploadID 大于 upload-id-marker 的条目将被列出		String否

请求体

该请求的请求体为空。

响应

响应头

公共响应头

该响应包含公共响应头，了解公共响应头详情请参阅 公共响应头部 文档。

特有响应头

该响应无特殊的响应头。

响应体

该响应体返回为 application/xml 数据，包含完整节点数据的内容展示如下：

<ListMultipartUploadsResult>
  <Bucket></Bucket>
  <Encoding-Type></Encoding-Type>
  <KeyMarker></KeyMarker>
  <UploadIdMarker></UploadIdMarker>
  <NextKeyMarker></NextKeyMarker>
  <NextUploadIdMarker></NextUploadIdMarker>
  <MaxUploads></MaxUploads>
  <IsTruncated></IsTruncated>
  <Prefix></Prefix>
  <Delimiter></Delimiter>
  <Upload>
    <Key></Key>
    <UploadID></UploadID>
    <StorageClass></StorageClass>
    <Initiator>
      <ID></ID>
    <DisplayName></DisplayName>
    </Initiator>
    <Owner>
      <ID></ID>
    <DisplayName></DisplayName>
    </Owner>
    <Initiated></Initiated>
  </Upload>
  <CommonPrefixes>
    <Prefix></Prefix>
  </CommonPrefixes>
</ListMultipartUploadsResult>

具体的数据内容如下：

节点名称（关键字）父节点描述类型
ListMultipartUploadsResult无用来表述所有分块上传的信息Container

Container 节点 ListMultipartUploadsResult 的内容：

节点名称（关键字）父节点描述类型
BucketListMultipartUploadsResult分块上传的目标 Bucket，由用户自定义字符串和系统生成 APPID 数字串由中划线连接而成，如：examplebucket-1250000000String
Encoding-TypeListMultipartUploadsResult规定返回值的编码格式，合法值：urlString
KeyMarkerListMultipartUploadsResult列出条目从该 key 值开始String
UploadIdMarkerListMultipartUploadsResult列出条目从该 UploadId 值开始String
NextKeyMarkerListMultipartUploadsResult假如返回条目被截断，则返回 NextKeyMarker 就是下一个条目的起点String
NextUploadIdMarkerListMultipartUploadsResult假如返回条目被截断，则返回 UploadId 就是下一个条目的起点String
MaxUploadsListMultipartUploadsResult设置最大返回的 multipart 数量，合法取值从0到1000String
IsTruncatedListMultipartUploadsResult返回条目是否被截断，布尔值：TRUE，FALSEBoolean
PrefixListMultipartUploadsResult限定返回的 Objectkey 必须以 Prefix 作为前缀，
注意使用 prefix 查询时，返回的 key 中仍会包含 Prefix		String
DelimiterListMultipartUploadsResult定界符为一个符号，对 object 名字包含指定前缀且第一次出现 delimiter 字符之间的 object 作为一组元素：common prefix。如果没有 prefix，则从路径起点开始String
UploadListMultipartUploadsResult每个 Upload 的信息Container
CommonPrefixesListMultipartUploadsResult将 prefix 到 delimiter 之间的相同路径归为一类，定义为 Common PrefixContainer

Container 节点 Upload 的内容：

节点名称（关键字）父节点描述类型
KeyListMultipartUploadsResult.UploadObject 的名称String
UploadIDListMultipartUploadsResult.Upload标示本次分块上传的 IDString
StorageClassListMultipartUploadsResult.Upload用来表示分块的存储级别，枚举值：STANDARD，STANDARD_IA，ARCHIVEString
InitiatorListMultipartUploadsResult.Upload用来表示本次上传发起者的信息Container
OwnerListMultipartUploadsResult.Upload用来表示这些分块所有者的信息Container
InitiatedListMultipartUploadsResult.Upload分块上传的起始时间Date

Container 节点 Initiator 的内容：

节点名称（关键字）父节点描述类型
IDListMultipartUploadsResult.Upload.Initiator用户唯一的 CAM 身份 IDString
DisplayNameListMultipartUploadsResult.Upload.Initiator用户身份 ID 的简称（UIN）String

Container 节点 Owner 的内容：

节点名称（关键字）父节点描述类型
IDListMultipartUploadsResult.Upload.Owner用户唯一的 CAM 身份 IDString
DisplayNameListMultipartUploadsResult.Upload.Owner用户身份 ID 的简称（UIN）String

Container 节点 CommonPrefixes 的内容：

节点名称（关键字）父节点描述类型
PrefixListMultipartUploadsResult.CommonPrefixes显示具体的 CommonPrefixesString

错误分析

以下描述此请求可能会发生的一些特殊的且常见的错误情况：

错误码HTTP 状态码描述
InvalidArgument400 Bad Requestmax-uploads 必须是整数，且值介于0 - 1000之间，否则返回 InvalidArgument
encoding-type 只能取值 url，否则会返回 InvalidArgument

获取更多关于 COS 的错误码的信息，或者产品所有的错误列表，请查看 错误码 文档。

实际案例

请求

GET /?uploads HTTP/1.1
Host: <BucketName-APPID>.<Endpoint>
Date: Wed, 18 Jan 2015 21:32:00 GMT
Authorization: q-sign-algorithm=sha1&q-ak=AKIDxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&q-sign-time=1484727508;32557623508&q-key-time=1484727508;32557623508&q-header-list=host&q-url-param-list=uploads&q-signature=5bd4759a7309f7da9a0550c224d8c61589c9dbbf

响应

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 1203
Date: Wed, 18 Jan 2015 21:32:00 GMT
Server: tencent-cos
x-cos-request-id: NTg3ZjI0ZGRfNDQyMDRlXzNhZmRfMjRl

<ListMultipartUploadsResult>
    <Bucket>examplebucket-1250000000</Bucket>
    <Encoding-Type/>
    <KeyMarker/>
    <UploadIdMarker/>
    <MaxUploads>1000</MaxUploads>
    <Prefix/>
    <Delimiter>/</Delimiter>
    <IsTruncated>false</IsTruncated>
    <Upload>
        <Key>Object</Key>
        <UploadID>1484726657932bcb5b17f7a98a8cad9fc36a340ff204c79bd2f51e7dddf0b6d1da6220520c</UploadID>
        <Initiator>
           <ID>qcs::cam::uin/100000000001:uin/100000000001</ID>
        <DisplayName>100000000001</DisplayName>
        </Initiator>
        <Owner>
           <ID>qcs::cam::uin/100000000001:uin/100000000001</ID>
        <DisplayName>100000000001</DisplayName>
        </Owner>
        <StorageClass>Standard</StorageClass>
        <Initiated>Wed Jan 18 16:04:17 2017</Initiated>
    </Upload>
    <Upload>
        <Key>Object</Key>
        <UploadID>1484727158f2b8034e5407d18cbf28e84f754b791ecab607d25a2e52de9fee641e5f60707c</UploadID>
        <Initiator>
           <ID>qcs::cam::uin/100000000001:uin/100000000001</ID>
        <DisplayName>100000000001</DisplayName>
        </Initiator>
        <Owner>
           <ID>qcs::cam::uin/100000000001:uin/100000000001</ID>
        <DisplayName>100000000001</DisplayName>
        </Owner>
        <StorageClass>Standard</StorageClass>
        <Initiated>Wed Jan 18 16:12:38 2017</Initiated>
    </Upload>
    <Upload>
        <Key>exampleobject</Key>
        <UploadID>1484727270323ddb949d528c629235314a9ead80f0ba5d993a3d76b460e6a9cceb9633b08e</UploadID>
        <Initiator>
           <ID>qcs::cam::uin/100000000001:uin/100000000001</ID>
        <DisplayName>100000000001</DisplayName>
        </Initiator>
        <Owner>
           <ID>qcs::cam::uin/100000000001:uin/100000000001</ID>
        <DisplayName>100000000001</DisplayName>
        </Owner>
        <StorageClass>Standard</StorageClass>
        <Initiated>Wed Jan 18 16:14:30 2017</Initiated>
    </Upload>
</ListMultipartUploadsResult>