对象存储服务 OBS-列举桶中已初始化多段任务:请求消息参数

时间:2023-11-03 16:44:58

请求消息参数

该请求可以通过在请求消息中指定参数,查询指定范围的多段上传任务,请求参数说明如表1所示。

表1 请求消息参数

参数名称

描述

是否必选

delimiter

对于名字中包含delimiter的对象的任务,其对象名(如果请求中指定了prefix,则此处的对象名需要去掉prefix)中从首字符至第一个delimiter之间的字符串将作为CommonPrefix在响应中返回。对象名包含CommonPrefix的任务被视为一个分组,作为一条记录在响应中返回,该记录不包含任务的信息,仅用于提示用户该分组下存在多段上传任务。

类型:String

prefix

如果请求中指定了prefix,则响应中仅包含对象名以prefix开始的任务信息。

类型:String

max-uploads

列举的多段任务的最大条目,取值范围为[1,1000],当超出范围时,按照默认的1000进行处理。

类型:Integer

key-marker

列举时返回指定的key-marker之后的多段任务。

类型:String

upload-id-marker

只有和key-marker一起使用才有意义, 列举时返回指定的key-marker的upload-id-marker之后的多段任务。

类型:String

encoding-type

对响应中的部分元素进行指定类型的编码。如果Delimiter、KeyMarker、Prefix、NextKeyMarker和Key包含xml 1.0标准不支持的控制字符,可通过设置encoding-type对响应中的Delimiter、KeyMarker、Prefix(包括CommonPrefixes中的Prefix)、NextKeyMarker和Key进行编码。

类型:String

可选值:url。

support.huaweicloud.com/api-obs/obs_04_0097.html