S3 列表多重部件上载
GET /?uploads 返回当前正在进行的多部分上载的列表,即,应用程序启动多部分上载,但服务尚未完成所有上载。
语法
GET /_BUCKET_?uploads HTTP/1.1您可以为 GET /_BUCKET_?uploads指定参数,但这些参数都不是必需的。
参数
prefix
- 描述
返回正在进行的上载,这些上载的密钥包含指定的前缀。
- 类型
字符串
delimiter
- 描述
前缀与对象名的其余部分之间的定界符。
- 类型
字符串
key-marker
- 描述
上载列表的开始标记。
- 类型
字符串
max-keys
- 描述
正在进行的上载的最大数目。 缺省值为 1000。
- 类型
整数
max-uploads
- 描述
多部分上载的最大数量。 范围为 1-1000。 缺省值为 1000。
- 类型
整数
version-id-marker
- 描述
如果未指定
key-marker,那么将忽略。 指定在ID处或之后按词典顺序列出的第一次上载的ID。- 类型
字符串
响应实体
ListMultipartUploadsResult
- 描述
结果的容器。
- 类型
容器
ListMultipartUploadsResult.Prefix
- 描述
prefix请求参数指定的前缀 (如果有)。- 类型
字符串
Bucket
- 描述
将接收存储区内容的存储区。
- 类型
字符串
KeyMarker
- 描述
key-marker请求参数指定的键标记 (如果有)。- 类型
字符串
UploadIdMarker
- 描述
upload-id-marker请求参数指定的标记 (如果有)。- 类型
字符串
NextKeyMarker
- 描述
要在后续请求中使用的密钥标记 (如果
IsTruncated为true)。- 类型
字符串
NextUploadIdMarker
- 描述
要在后续请求中使用的上载标识标记 (如果
IsTruncated为true)。- 类型
字符串
MaxUploads
- 描述
max-uploads请求参数指定的最大上载数。- 类型
整数
Delimiter
- 描述
如果设置了此属性,那么具有相同前缀的对象将显示在
CommonPrefixes列表中。- 类型
字符串
IsTruncated
- 描述
如果值为
true,那么仅返回存储区上载内容的子集。- 类型
布尔值
Upload
- 描述
Key,UploadId,InitiatorOwner,StorageClass和Initiated元素的容器。- 类型
容器
Key
- 描述
多重部件上载完成后对象的键。
- 类型
字符串
UploadId
- 描述
用于标识多重部件上载的
ID。- 类型
字符串
Initiator
- 描述
包含启动上载的用户的
ID和DisplayName。- 类型
容器
DisplayName
- 描述
发起方的显示名称。
- 类型
字符串
ID
- 描述
发起方的标识。
- 类型
字符串
Owner
- 描述
这是拥有已上载对象的用户的
ID和DisplayName的容器。- 类型
容器
StorageClass
- 描述
用于存储结果对象的方法。
STANDARD或REDUCED_REDUNDANCY- 类型
字符串
Initiated
- 描述
用户启动上载的日期和时间。
- 类型
日期
CommonPrefixes
- 描述
如果多个对象包含相同的前缀,那么它们将显示在此列表中。
- 类型
容器
CommonPrefixes.Prefix
- 描述
prefix请求参数定义的前缀后面的键子串。- 类型
字符串