列举并行文件系统内对象请求参数
|
字段名 |
类型 |
约束 |
说明 |
|---|---|---|---|
|
options |
const obs_options * |
必选 |
请求桶的上下文,配置option(C SDK),通过obs_options设置AK、SK、endpoint、bucket、超时时间、临时鉴权 |
|
prefix |
char * |
可选 |
限定返回的对象名必须带有prefix前缀。 |
|
marker |
char * |
可选 |
列举对象的起始位置,返回的对象列表将是对象名按照字典序排序后该参数以后的所有对象。 |
|
delimiter |
char * |
可选 |
用于对对象名进行分组的字符。对于对象名中包含delimiter的对象,其对象名(如果请求中指定了prefix,则此处的对象名需要去掉prefix)中从首字符至第一个delimiter之间的字符串将作为一个分组并作为commonPrefix返回。 对于并行文件系统,不携带此参数时默认列举是递归列举此目录下所有内容,会列举子目录。在大数据场景下(目录层级深、目录下文件多)的列举,建议设置[delimiter="/"],只列举当前目录下的内容,不列举子目录,提高列举效率。 |
|
maxkeys |
int |
必选 |
列举对象的最大数目,取值范围为1~1000,当超出范围时,按照默认的1000进行处理。 |
|
handler |
obs_list_objects_handler * |
必选 |
回调结构体,结构体内所有成员都是回调函数的指针,用于设置处理接口响应数据的回调函数。您可以通过设置回调函数,把服务端的响应数据复制到您的自定义回调数据callback_data中。 |
|
callback_data |
void * |
可选 |
用户自定义回调数据。 |