列举桶中已初始化多段任务ListMultipartUploads_多段操作

华为云计算云知识列举桶中已初始化多段任务ListMultipartUploads

普惠上云 2核2G2M云服务器

38元/年

云服务器新品 X实例-4核8G5M

288元/年

新品尝鲜云耀数据库HRDS

免费试用

网站搭建买3年送2年

1元/天

列举桶中已初始化多段任务ListMultipartUploads

时间: 2023-08-21 14:38:14

API网关云服务器云主机云计算弹性伸缩

猜你想看：

华为云耀L实例实时语音识别云服务器配置 CDN是什么意思视频点播加速什么是云桌面

接口说明

列举桶中已初始化多段任务用户可以通过本接口查询一个桶中所有的初始化后还未合并以及未取消的多段上传任务。

URL

GET https://obs.cn-north-4.myhuaweicloud.com/

请求参数

名称	类型	IN	必选	描述
Authorization	string	header	是	请求消息中可带的签名信息。
Date	string	header	否	请求发起端的日期和时间,例如:Wed, 27 Jun 2018 13:39:15 +0000。默认值:无。条件:如果消息头中带了x-obs-date字段,则可以不带该字段,其他情况下必选。
bucket_name	string	query	是	桶名称
uploads	string	query	是	uploads表示请求多段任务API。
delimiter	string	query	否	对于名字中包含delimiter的对象的任务,其对象名(如果请求中指定了prefix,则此处的对象名需要去掉prefix)中从首字符至第一个delimiter之间的字符串将作为CommonPrefix在响应中返回。对象名包含CommonPrefix的任务被视为一个分组,作为一条记录在响应中返回,该记录不包含任务的信息,仅用于提示用户该分组下存在多段上传任务。
prefix	string	query	否	如果请求中指定了prefix,则响应中仅包含对象名以prefix开始的任务信息。
max-uploads	integer	query	否	列举的多段任务的最大条目,取值范围为[1,1000],当超出范围时,按照默认的1000进行处理。
key-marker	string	query	否	列举时返回指定的key-marker之后的多段任务。
upload-id-marker	string	query	否	只有和key-marker一起使用才有意义, 列举时返回指定的key-marker的upload-id-marker之后的多段任务。
encoding-type	string	query	否	对响应中的部分元素进行指定类型的编码。如果Delimiter、KeyMarker、Prefix、NextKeyMarker和Key包含xml 1.0标准不支持的控制字符,可通过设置encoding-type对响应中的Delimiter、KeyMarker、Prefix(包括CommonPrefixes中的Prefix)、NextKeyMarker和Key进行编码。

返回参数

返回码: 200

请求成功响应消息。

名称	类型	必选	描述
Content-Length	string	否	响应消息体的字节长度。
Connection	string	否	指明与服务器的连接是长连接还是短连接。
Date	string	否	OBS系统响应的时间。
ETag	string	否	对象的base64编码的128位MD5摘要。ETag是对象内容的唯一标识,可以通过该值识别对象内容是否有变化。比如上传对象时ETag为A,下载对象时ETag为B,则说明对象内容发生了变化。实际的ETag是对象的哈希值。ETag只反映变化的内容,而不是其元数据。上传的对象或拷贝操作创建的对象,通过MD5加密后都有唯一的ETag。如果通过多段上传对象,则无论加密方法如何,MD5会拆分ETag,此类情况ETag就不是MD5的摘要。
x-obs-id-2	string	否	帮助定位问题的特殊符号。
x-obs-request-id	string	否	由OBS创建来唯一确定本次请求的值,可以通过该值来定位问题。

名称	类型	必选	描述
Bucket	string	否	初始化任务所在的桶名。
EncodingType	string	否	对响应中的部分元素进行指定类型的编码。如果请求中设置了encoding-type,那响应中的Delimiter、KeyMarker、Prefix(包括CommonPrefixes中的Prefix)、NextKeyMarker和Key会被编码。
KeyMarker	string	否	列举时的起始对象位置。
UploadIdMarker	string	否	列举时的起始UploadId位置。
NextKeyMarker	string	否	如果本次没有返回全部结果,响应请求中将包含NextKeyMarker字段,用于标明接下来请求的KeyMarker值。
NextUploadIdMarker	string	否	如果本次没有返回全部结果,响应请求中将包含NextUploadMarker字段,用于标明接下来请求的UploadMarker值。
MaxUploads	integer	否	返回的最大多段上传任务数目。
IsTruncated	boolean	否	表明是否本次返回的Multipart Upload结果列表被截断。“true”表示本次没有返回全部结果;“false”表示本次已经返回了全部结果。
Upload	Upload object	否	保存Multipart Upload任务信息的容器。
ListMultipartUploadsResult.Prefix	string	否	请求中带的Prefix。
Delimiter	string	否	请求中带的Delimiter。
CommonPrefixes	CommonPrefixes object	否	请求中带Delimiter参数时,返回消息带CommonPrefixes分组信息。

200 Upload

名称	类型	必选	描述
Key	string	否	初始化Multipart Upload任务的Object名字。
UploadId	string	否	Multipart Upload任务的ID。
Initiator	string	否	Multipart Upload任务的创建者。
Owner	string	否	段的所有者。
StorageClass	string	否	表明待多段上传的对象存储类型。
Initiated	string	否	Multipart Upload任务的初始化时间。

200 Upload.Initiator

名称	类型	必选	描述
ID	string	否	创建者的DomainId。

200 Upload.Owner

名称	类型	必选	描述
ID	string	否	创建者的DomainId。

200 CommonPrefixes

名称	类型	必选	描述
CommonPrefixes. Prefix	string	否	CommonPrefixes分组信息中,表明不同的Prefix。

返回码: 400

请求失败响应消息。

名称	类型	必选	描述
Code	string	否	错误响应消息体XML中错误响应对应的HTTP消息返回码,具体的错误码请参见错误码-表2。
Message	string	否	错误响应消息体XML中具体错误更全面、详细的英文解释,具体的错误消息请参见错误码-表2。
RequestId	string	否	本次错误请求的请求ID,用于错误定位。
HostId	string	否	返回该消息的服务端ID。
Resource	string	否	该错误相关的桶或对象资源。

请求示例

示例 1

不带任何参数列举已初始化的段任务

"GET /?uploads"

"GET /?uploads HTTP/1.1\nUser-Agent: curl/7.29.0\nHost: examplebucket.obs.cn-north-4.myhuaweicloud.com\nAccept: */*\nDate: WED, 01 Jul 2015 04:51:21 GMT\nAuthorization: OBS UDS IAM STUBTEST000008:XdmZgYQ+ZVy1rjxJ9/KpKq+wrU0="

示例 2

带prefix和delimeter列举已初始化的段任务例如,用户桶examplebucket中2个段任务,对象名分别为multipart-object001和part2-key02,列举段任务时,设置prefix为“multipart",delimeter设置为object001,列举已初始化的段任务

"GET /?uploads&delimiter=object001&prefix=multipart"

"GET /?uploads&delimiter=object001&prefix=multipart HTTP/1.1\nUser-Agent: curl/7.29.0\nHost: examplebucket.obs.cn-north-4.myhuaweicloud.com\nAccept: */*\nDate: WED, 01 Jul 2015 04:51:21 GMT\nAuthorization: OBS UDSIAMSTUBTEST000008:XdmZgYQ+ZVy1rjxJ9/KpKq+wrU0=\n"

错误码

请参考错误码说明。