对象存储服务 OBS-列举桶内对象请求参数:参数描述
参数描述
字段名 |
类型 |
约束 |
说明 |
---|---|---|---|
Bucket |
string |
必选 |
桶名。 |
Marker |
string |
可选 |
列举对象的起始位置,返回的对象列表将是对象名按照字典序排序后该参数以后的所有对象。 |
Prefix |
string |
可选 |
限定返回的对象名必须带有prefix前缀。 |
MaxKeys |
int |
可选 |
列举对象的最大数目,取值范围为1~1000,当超出范围时,按照默认的1000进行处理。 |
Delimiter |
string |
可选 |
指定用于对对象名分组的字符。分组步骤如下:① 先选出所有含此Delimiter的对象名;② 去掉这些对象名中的prefix(若请求中未指定prefix字段,则跳过此步);③ 以首字符与Delimiter间的字符串(后续会作为CommonPrefix返回)为标准进行分组。 对于并行文件系统,不携带此参数时默认列举是递归列举此目录下所有内容,会列举子目录。在大数据场景下(目录层级深、目录下文件多)的列举,建议设置[delimiter=/],只列举当前目录下的内容,不列举子目录,提高列举效率。 |
Origin |
string |
可选 |
预请求指定的跨域请求Origin(通常为域名)。 |
RequestHeader |
string |
可选 |
跨域请求可以使用的HTTP头域。 |
EncodingType |
string |
可选 |
对响应中的部分元素进行指定类型的编码。如果Delimiter、Marker、Prefix、CommonPrefixes、NextMarker和Key包含xml 1.0标准不支持的控制字符,可通过设置该参数指定对响应中的Delimiter、Marker、Prefix、CommonPrefixes、NextMarker和Key进行编码。 可选值:url。 |