获取分片上传对象列表
返回正在进行分段上传的对象列表,即已经开始但还未完成分段上传的对象列表。可以指定参数,但参数不是必须的。
语法
GET /{bucket}?uploads HTTP/1.1
参数
名称 | 类型 | 描述 |
---|---|---|
prefix | String | 返回key 中包含指定前缀的正在上传的对象 |
delimiter | String | 前缀与对象名其余部分之间的分隔符 |
key-marker | String | 正在上传列表的开始标记 |
max-keys | Integer | 正在上传列表的最大容量,默认1000 |
max-uploads | Integer | 正在上传对象的最大分块数,默认为1000 |
upload-id-marker | String | 如果key-marker 未指定,则忽略。若被列 |
响应实体
名称 | 类型 | 描述 |
---|---|---|
ListMultipartUploadsResult | Container | 保存List Multipart Upload 请求结果的容器 |
ListMultipartUploadsResult.Prefix | String | prefix 请求参数指定的前缀 |
Bucket | String | Bucket 名称 |
KeyMarker | String | 列表的起始Object 位置 |
UploadIdMarker | String | 列表的起始UploadID 位置 |
NextKeyMarker | String | 如果本次没有返回全部结果,响应请求中将包含NextKeyMarker 元素,用于标明接下来请求的KeyMarker 值 |
NextUploadIdMarker | String | 要在后续请求中使用的上载ID 标记 |
MaxUploads | Integer | 返回的最大Upload 数目 |
Delimiter | String | 如果设置,具有相同前缀的对象将出现在CommonPrefixes 列表中 |
IsTruncated | Boolean | 标明是否本次返回的MultipartUpload 结果列表被截断 |
Upload | Container | 保存Multipart Upload 事件信息的容器 |
Key | String | 初始化分段上传的Object 的key |
UploadId | String | 分段上传事件的ID |
Initiator | Container | 包含启动上载的用户ID 和DisplayName 用户 |
DisplayName | String | 启动者的显示名称 |
ID | String | 启动者的ID |
Owner | Container | 拥有分段上传对象的用户的ID 和显示名 |
StorageClass | Container | 用于存储结果对象的方法 |
Initiated | Date | 启动分段上传的日期 |
CommonPrefixes | Container | 如果多个对象包含相同的前缀,它们将显示在此列表中 |
CommonPrefixes.Prefix | String | prefix 请求参数定义的前缀后面的key 的子字符串。 |