2.4.24. S3 列表多部分上传


GET /?uploads 返回当前 in-progress 多部分上传列表,即应用启动多部分上传,但服务尚未完成所有上传。

语法

GET /BUCKET?uploads HTTP/1.1

您可以为 GET /BUCKET?uploads 指定参数,但参数都不是必需的。

Expand
表 2.17. 参数
名称Type描述

prefix

字符串

返回的 in-progress 上传,其密钥包含指定前缀。

delimiter

字符串

前缀与其他对象名称之间的分隔符。

key-marker

字符串

上传列表的开头标记。

max-keys

整数

上传的最大 in-progres 数。默认值为 1000。

max-uploads

整数

多部分上传的最大数量。范围为 1 到1000。默认值为 1000。

version-id-marker

字符串

如果没有指定 key-marker,则忽略。指定第一个上传的 ID 以字典顺序(位于 )或遵循 ID 的顺序来列出。

Expand
表 2.18. 响应实体
名称Type描述

ListMultipartUploadsResult

Container

用于结果的容器。

ListMultipartUploadsResult.Prefix

字符串

前缀 请求参数指定的前缀(若有)。

Bucket

字符串

将接收存储桶内容的存储桶。

KeyMarker

字符串

通过密钥标记请求参数指定的 密钥标记 (如果有)。

UploadIdMarker

字符串

upload-id-marker 请求参数指定的标记(如果有)。

NextKeyMarker

字符串

如果 IsTruncatedtrue,则后续请求中使用的密钥标记。

NextUploadIdMarker

字符串

如果 IsTruncatedtrue,则上传 ID 标记用于后续请求。

MaxUploads

整数

max-uploads 请求参数指定的最大上传。

Delimiter

字符串

如果设置,具有相同前缀的对象将显示在 CommonPrefixes 列表中。

IsTruncated

布尔值

如果为 true,则仅返回存储桶上传内容的子集。

上传

Container

KeyUploadIdInitiatorOwnerStorageClassInitiated 元素的容器。

字符串

在多部分上传完成后,对象的键。

UploadId

字符串

标识多部分上传的 ID

initiator

Container

包含开始上传的用户的 IDDisplayName

DisplayName

字符串

启动器的显示名称。

ID

字符串

启动器的 ID。

所有者

Container

拥有上传对象的用户的 IDDisplayName 的容器。

StorageClass

字符串

用于存储生成的对象的方法。STANDARDREDUCED_REDUNDANCY

启动

Date

用户开始上传的日期和时间。

CommonPrefixes

Container

如果多个对象包含相同的前缀,它们将显示在此列表中。

CommonPrefixes.Prefix

字符串

在前缀后面使用前缀的子字符串,如 前缀 request 参数定义。

Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

关于红帽文档

Legal Notice

Theme

© 2026 Red Hat
返回顶部