列举分片上传事件
该接口用来列举正在执行中的分片上传事件,即已经初始化但还未完成或者终止的分片上传事件。
请求
请求语法
内容
Get /?uploads HTTP/1.1 Host: {BucketName}.{Endpoint} Date: {date} Authorization: SignatureValue
描述
Endpoint:参考与region地域的关系 SignatureValue:参考签名算法
请求参数
该请求支持delimiter、max-uploads、key-marker、prefix、upload-id-marker参数,通过组合参数,可以设定查询规则。
名称 | 类型 | 描述 |
---|---|---|
delimiter | 字符串 | 分隔符,即对object名字进行分组的字符。从指定的前缀prefix到第一次出现delimiter字符之间的内容作为一组元素(即CommonPrefixes)。 |
max-uploads | 字符串 | 限定此次列举分片上传事件最大的返回数目,默认为1000,且取值不能大于1000。 |
key-marker | 字符串 | 与upload-id-marker参数一同使用来指定返回结果的起始位置。 如果已设置upload-id-marker,查询结果中包含所有Object名字的字典序大于key-marker的分片上传事件。 如果未设置upload-id-marker,查询结果中包含: (1) 所有Object名字的字典序大于key-marker的分片上传事件; (2)Object名字等于key-marker参数值,但是Upload ID比upload-id-marker参数值大的分片上传事件。 |
prefix | 字符串 | 限定返回的object key必须以prefix作为前缀。 |
upload-id-marker | 字符串 | 与key-marker参数一同使用来指定返回结果的起始位置。 如果已设置upload-id-marker,查询结果中包含所有Object名字的字典序大于key-marker的分片上传事件。 如果未设置upload-id-marker,查询结果中包含: (1) 所有Object名字的字典序大于key-marker的分片上传事件; (2)Object名字等于key-marker参数值,但是Upload ID比upload-id-marker参数值大的分片上传事件。 |
encoding-type | 字符串 | 指定对返回内容编码的类型。默认值:无 |
响应
非公共响应头
无
响应体
名称 | 类型 | 描述 |
---|---|---|
ListMultipartUploadsResult | 容器 | 存放响应元素。 子节点:Bucket, KeyMarker, UploadIdMarker, NextKeyMarker, NextUploadIdMarker, MaxUploads, Delimiter, Prefix, CommonPrefixes, IsTruncated 父节点:无 |
Bucket | 字符串 | 存储桶的名称。 父节点:ListMultipartUploadsResult |
KeyMarker | 字符串 | 指定返回结果中Object的起始位置。 父节点:ListMultipartUploadsResult |
UploadIdMarker | 字符串 | 指定返回结果中UploadID的起始位置。 父节点:ListMultipartUploadsResult |
NextKeyMarker | 字符串 | 本次列举没有返回全部结果时,会标记列表被截(IsTruncated=true),同时返回最后一个object的名称。如果IsTruncated为true,则可以使用NextKeyMarker作为下次list的marker参数。 父节点:ListMultipartUploadsResult |
NextUploadIdMarker | 字符串 | 如果列表被截断,此元素在后续请求中标记请求参数。 父节点:ListMultipartUploadsResult |
Encoding-Type | 字符串 | 对返回的内容进行编码,指定编码的类型。默认值:无 父节点: ListBucketResult |
MaxUploads | 字符串 | 限定此次返回分片上传事件的最大数目,默认为1000,且取值不能大于1000。 父节点:ListMultipartUploadsResult |
IsTruncated | 枚举字符串 | 请求中返回的结果是否被截断。有效值:true表示本次没有返回全部结果,false表示本次已经返回了全部结果。 父节点:ListMultipartUploadsResult |
Upload | 容器 | 存放分片上传的元素。 子节点:Key, UploadId, InitiatorOwner, StorageClass, Initiated 父节点:ListMultipartUploadsResult |
Key | 字符串 | 对象的名称。 父节点:Upload |
UploadId | 字符串 | 上传事件的标识符。 父节点:Upload |
Initiator | 容器 | 任务的创建者。 子节点:ID, DisplayName 父节点:Upload |
ID | 字符串 | 创建者的ID。 父节点:Initiator, Owner |
DisplayName | 字符串 | 创建者的DisplayName。 子节点:ID, DisplayName 父节点:Upload |
Owner | 容器 | 对象的拥有者。 子节点:ID, DisplayName 父节点:Upload |
StorageClass | 字符串 | 表明待分片上传的对象存储类型。 父节点:Upload |
Initiated | 字符串 | Multipart Upload任务的初始化时间。 父节点:Upload |
ListMultipartUploadsResult.Prefix | 字符串 | 请求中的Prefix。 父节点:ListMultipartUploadsResult |
Delimiter | 字符串 | 分隔符,即对object名字进行分组的字符。从指定的前缀prefix到第一次出现delimiter字符之间的内容作为一组元素(即CommonPrefixes)。 父节点:ListMultipartUploadsResult |
CommonPrefixes | 容器 | 请求中带Delimiter参数时,返回消息带CommonPrefixes分组信息。 父节点:ListMultipartUploadsResult |
CommonPrefixes. Prefix | 字符串 | CommonPrefixes分组信息中的Prefix。 父节点:CommonPrefixes |
示例
- 请求
Get /?uploads HTTP/1.1 Host:oss-example.oss-cn-beijing.inspurcloud.com Date: Thu, 13 Feb 2019 15:14:62 GMT Authorization: OSS qDKLKLFJrqxo2oawuk53otfjbyc:JX75CtQqsmBBz+dciGHHDJHGS
响应
HTTP/1.1 200 OK x-amz-id-2: 6522JHGGDDyRx9e6j5Onimru9pO4ZVKnJ2Qz7/C1NPcfTGJHKEFHJKK== x-amz-request-id: 66548948419696e672773207255646544564165 Date: Mon, 5 Nov 2019 10:34:42 GMT Content-Length: 1330 Connection: keep-alive <?xml version="1.0" encoding="UTF-8"?> <ListMultipartUploadsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/"> <Bucket>bucket</Bucket> <KeyMarker></KeyMarker> <UploadIdMarker></UploadIdMarker> <NextKeyMarker>test1.m2ts</NextKeyMarker> <NextUploadIdMarker>YGGFDFJKIKgd2h5IGVsd58424GVGHVwbG9hZCBmJKYHFGFDF</NextUploadIdMarker> <MaxUploads>3</MaxUploads> <IsTruncated>true</IsTruncated> <Upload> <Key>test2</Key> <UploadId>XmcncyBuVjawMgbGlrZSBlbHb3QgaGF2aW5nIG11Y2ggbHZpb</UploadId> <Initiator> <ID>user1</ID> <DisplayName>user1</DisplayName> </Initiator> <Owner> <ID>7ca9d10f8e7faea0c8caeab4f8c24e9c078efc7c6ebf76ea55aa57f09a4ba06a</ID> <DisplayName>OwnerDisplayName</DisplayName> </Owner> <StorageClass>STANDARD</StorageClass> <Initiated>2019-11-10T20:48:33.000Z</Initiated> </Upload> <Upload> <Key>test2</Key> <UploadId>VXBsb2FkIElEIZpbmcncyBteS1tZvciBlbHS5tMnRzIHG9hZAVwb3ZpZGb</UploadId> <Initiator> <ID>b7000b05591d167d7ac70bcd6a3f92be</ID> <DisplayName>InitiatorDisplayName</DisplayName> </Initiator> <Owner> <ID>d16700c452597d70b056a3f92be</ID> <DisplayName>OwnerDisplayName</DisplayName> </Owner> <StorageClass>STANDARD</StorageClass> <Initiated>2019-11-10T20:48:33.000Z</Initiated> </Upload> <Upload> <Key>test3</Key> <UploadId>lksdmlbG9hZCBmYWlsuZYW55IGydzIHZWEgd2h5IGVVwZWQ</UploadId> <Initiator> <ID>user1</ID> <DisplayName>user1</DisplayName> </Initiator> <Owner> <ID>user1</ID> <DisplayName>OwnerDisplayName</DisplayName> </Owner> <StorageClass>STANDARD</StorageClass> <Initiated>2019-11-10T20:49:33.000Z</Initiated> </Upload> </ListMultipartUploadsResult>
错误码
错误码 | 描述 | 状态码 | 描述 |
---|---|---|---|
... | ... | ... | ... |