对象存储服务 OBS-列举桶中已初始化多段任务:请求消息参数
请求消息参数
该请求可以通过在请求消息中指定参数,查询指定范围的多段上传任务,请求参数说明如表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。 |
否 |