接口功能介绍
此接口可以列出存储桶中已经初始化,但是还没complete或者abort的分片上传任务。
接口约束
无
URI
GET /{bucket}?uploads
路径参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 |
---|---|---|---|---|
bucket | 是 | String | 桶名称 | testBucket |
Query参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
uploads | 是 | String | 固定参数 | uploads |
请求参数
请求头header参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 |
---|---|---|---|---|
Authorization | 是 | String | 用于验证请求合法性的认证信息 |
请求体body参数
无
响应参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
ListMultipartUploadsResult | 是 | Array of Objects | 保存ListMultipartUpload请求结果的容器 | ListMultipartUploadsResult |
表 ListMultipartUploadsResult
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
Bucket | 是 | String | 本次请求的存储桶名称 | example-bucket | |
IsTruncated | 是 | Boolean | 指明是否已返回所有结果。true:表示本次没有返回全部结果。 false:表示本次已返回全部结果 | true | |
MaxUploads | 是 | Integer | 返回的最大分片上传事件个数 | 10 | |
NextKeyMarker | 是 | String | 如果本次没有返回全部结果,响应请求中将包含NextKeyMarker元素,用于表示接下来请求的KeyMarker值 | test | |
NextUploadIdMarker | 是 | String | 如果本次没有返回全部结果,响应请求中将包含NextUploadMarker元素,用于表示接下来请求的UploadMarker值 | YW55IGlkZWEgd2************** | |
Upload | 是 | Array of Objects | 保存Multipart Upload事件信息的容器 | -- | Key,UploadId,Initiator,Owner,StorageClass,Initiated |
表 Upload
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
Key | 是 | String | 对象的Key | my-divisor | |
UploadId | 是 | String | 分片上传事件的id | XMgbGlrZSB****************2ggbHVjaw | |
Initiated | 是 | String | 分片上传事件的初始化时间 | 2010-11-10T20:48:33.000Z | |
Initiator | 是 | Array of Objects | 初始化上传用户的ID和显示名 | Initiator | |
Owner | 是 | Array of Objects | 上传对象拥有的ID和显示名 | Owner | |
StorageClass | 是 | String | 对象的存储类型 | STANDARD |
表 Initiator
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
ID | 是 | String | Initiator的ID | arn:aws:iam::111122223333:user | |
DisplayName | 是 | String | Initiator的显示名 | user1 |
表 Owner
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
ID | 是 | String | Owner的ID | ***3795438795279 | |
DisplayName | 是 | String | Owner的显示名 | test |
请求示例
GET /testbucket?uploads
请求头header
Authorization: authorization string
请求体body
无
响应示例
HTTP/1.1 200 OK
x-amz-request-id: 656c76696e6727732072657175657374
Date: Mon, 1 Nov 2010 20:34:56 GMT
<?xml version="1.0" encoding="UTF-8"?>
<ListMultipartUploadsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Bucket>example-bucket</Bucket>
<NextKeyMarker>test</NextKeyMarker>
<NextUploadIdMarker>YW55IGlkZWEgd2**************</NextUploadIdMarker>
<MaxUploads>3</MaxUploads>
<IsTruncated>true</IsTruncated>
<Upload>
<Key>my-divisor</Key>
<UploadId>XMgbGlrZSB****************2ggbHVjaw</UploadId>
<Initiator>
<ID>arn:aws:iam::111122223333:user/user1</ID>
<DisplayName>user1</DisplayName>
</Initiator>
<Owner>
<ID>***3795438795279 </ID>
<DisplayName>test</DisplayName>
</Owner>
<StorageClass>STANDARD</StorageClass>
<Initiated>2010-11-10T20:48:33.000Z</Initiated>
</Upload>
</ListMultipartUploadsResult>
状态码
HTTP状态 | 错误码 | 描述 |
---|---|---|
200 | 操作成功 | |
403 | AccessDenied | 用户没有权限执行操作 |
错误码
请参考 请求错误码(原生接口)。