最近更新时间:2024-06-25 19:33:45
此 List 操作将会列出所有正在进行的分块上传任务。正在进行的分块上传任务是指那些已经启动,却没有放弃或完成的分块上传任务。
在一次响应中,此操作最多返回1000(默认值)个分块上传任务。用户可以使用 max-uploads
参数来限定上限值。如果用户空间中正在进行的分块上传任务数大于此操作设定的上限值,响应中将会将 IsTruncated
元素设为 true
。用户可以使用 key-marker
和 upload-id-marker
参数来列出未列出的任务。
GET /?uploads HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignatureValue}
注意:
参数 | 描述 | 是否必选 |
---|---|---|
delimiter | 分隔符,用于对Object名称进行分组的字符。 | 否 |
encoding-type | 指明请求KS3与KS3响应使用的编码方式。 | 否 |
max-uploads | 限定要列出正在进行任务的上限值([1,1000])。响应中将会在响应体中返回其值。 | 否 |
upload-id-marker | 与 | 否 |
key-marker | 与 | 否 |
prefix | 限定响应结果列表使用的前缀,正如你在电脑中使用的文件夹一样。 | 否 |
该接口只使用常用请求头部。获取更多信息,请点击常用请求头部
该接口不使用请求内容。
该接口可以使用所有常用响应头部。获取更多信息,请点击常用响应头部。
名称 | 描述 |
---|---|
ListMultipartUploadsResult | 响应内容的容器。 |
Bucket | 启动分块上传任务的用户空间名称。 |
KeyMarker | 列表开始位置的 |
UploadIdMarker | 列表开始位置的 |
NextKeyMarker | 在一个连续列表请求中,如果列表是被截断的,应该通过设定 |
NextUploadIdMarker | 在一个连续列表请求中,如果列表是被截断的,应该通过设定 |
Encoding-Type | KS3响应中对对象名称的编码方式。 |
MaxUploads | 响应中列表的条目数不能超过该值。 |
IsTruncated | 是否被截断。如果对象列表记录数超过了设定的上限值,那么将会被截断。 |
Upload | 包含某个特定分块上传任务信息的容器。响应中应包含0个或多个 |
Key | 分块上传任务上传对象的 |
UploadID | 分块上传任务的ID。 |
Initiator | 包含分块上传任务发起人信息的容器。 |
ID | Object拥有者或被授权者ID的base64编码。 |
DisplayName | Object拥有者或被授权者ID的base64编码。 |
Owner | 用户空间拥有者信息。 |
StorageClass | 上传对象的存储方式。 |
Initiated | 分块上传任务启动时的时间和日期。 |
ListMultipartUploadsResult.Prefix | 对象 |
Delimiter | 分隔符,用于分割参数。分割后便于确定公共前缀。 |
CommonPrefixes | 当用户指定分隔符后,KS3会返回他们的公共前缀。实际上,公共前缀包括的值类似于文件目录中的同一个目录下的子目录。值的数量不能超过上限数量。例如:指定分隔符为 |
CommonPrefixes.Prefix | 如果设定了 |
该接口不返回任何特殊错误。
请求示例
GET /?uploads&max-uploads=3 HTTP/1.1
Host: ks3-example.ks3-cn-beijing.ksyuncs.com
Date: Mon, 1 Nov 2010 20:34:56 GMT
Authorization: authorization string
响应示例
HTTP/1.1 200 OK
Date: Mon, 1 Nov 2014 20:34:56 GMT
Content-Length: 1330
Connection: keep-alive
x-kss-request-id: 656c76696e6727732072657175657374
Server: KS3
<?xml version="1.0" encoding="UTF-8"?>
<ListMultipartUploadsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Bucket>ks3-example</Bucket>
<KeyMarker></KeyMarker>
<UploadIdMarker></UploadIdMarker>
<NextKeyMarker>my-movie.m2ts</NextKeyMarker>
<NextUploadIdMarker>YW55IGlkZWEgd2h5IGVsdmluZydzIHVwbG9hZCBmYWlsZWQ</NextUploadIdMarker>
<MaxUploads>3</MaxUploads>
<IsTruncated>true</IsTruncated>
<Upload>
<Key>my-divisor</Key>
<UploadId>f9957b016aaf37c7569c91fd14501847</UploadId>
<Initiator>
<ID>MjAwMDEwMz****</ID>
<DisplayName>MjAwMDEwMz****</DisplayName>
</Initiator>
<Owner>
<ID>KS3UserId</ID>
<DisplayName>Ks3User</DisplayName>
</Owner>
<StorageClass>STANDARD</StorageClass>
<Initiated>2014-11-10T20:48:33.000Z</Initiated>
</Upload>
<Upload>
<Key>my-movie.m2ts</Key>
<UploadId>f9957b016aaf37c7569c91fd14501847</UploadId>
<Initiator>
<ID>MjAwMDEwMz****</ID>
<DisplayName>MjAwMDEwMz****</DisplayName>
</Initiator>
<Owner>
<ID>MjAwMDEwMz****</ID>
<DisplayName>MjAwMDEwMz****</DisplayName>
</Owner>
<StorageClass>STANDARD</StorageClass>
<Initiated>2014-11-10T20:48:33.000Z</Initiated>
</Upload>
<Upload>
<Key>my-movie.m2ts</Key>
<UploadId>f9957b016aaf37c7569c91fd14501847</UploadId>
<Initiator>
<ID>MjAwMDEwMz****</ID>
<DisplayName>MjAwMDEwMz****</DisplayName>
</Initiator>
<Owner>
<ID>MjAwMDEwMz****</ID>
<DisplayName>MjAwMDEwMz****</DisplayName>
</Owner>
<StorageClass>STANDARD</StorageClass>
<Initiated>2014-11-10T20:49:33.000Z</Initiated>
</Upload>
</ListMultipartUploadsResult>
通过该接口可以把bucket下正在进行的分块上传罗列出来。对于很久之前初始化,且无人再使用的分块上传,建议调用Abort Multipart Upload接口删除。
纯净模式
鼠标选中内容,快速反馈问题