文档首页/ 对象存储服务 OBS/ SDK参考/ C/ 参数列表/ 列举多版本对象请求参数
更新时间:2026-03-13 GMT+08:00
分享

列举多版本对象请求参数

表1 请求参数列表

字段名

类型

约束

说明

options

const obs_options *

必选

请求桶的上下文,配置option(C SDK),通过obs_options设置AK、SK、endpoint、bucket、超时时间、临时鉴权

prefix

char *

可选

限定返回的对象名必须带有prefix前缀。

key_marker

char *

可选

列举多版本对象的起始位置,返回的对象列表将是对象名按照字典序排序后该参数以后的所有对象。

delimiter

char *

可选

用于对对象名进行分组的字符。对于对象名中包含delimiter的对象,其对象名(如果请求中指定了prefix,则此处的对象名需要去掉prefix)中从首字符至第一个delimiter之间的字符串将作为一个分组并作为common_prefixes返回。

version_id_marker

char *

可选

与key_marker配合使用,返回的对象列表将是对象名和版本号按照字典序排序后该参数以后的所有对象。

maxkeys

int

必选

列举对象的最大数目,取值范围为1~1000,当超出范围时,按照默认的1000进行处理。

handler

obs_list_versions_handler *

必选

回调结构体,结构体内所有成员都是回调函数的指针,用于设置处理接口响应数据的回调函数。您可以通过设置回调函数,把服务端的响应数据复制到您的自定义回调数据callback_data中。

callback_data

void *

可选

用户自定义回调数据。

相关文档