文档首页/ 对象存储服务 OBS/ SDK参考/ C/ 参数列表/ 获取对象accesslabel请求参数
更新时间:2026-07-13 GMT+08:00
分享

获取对象accesslabel请求参数

表1 请求参数列表

参数名称

参数类型

是否必选

描述

options

const obs_options *

必选

参数解释:

请求桶的上下文,通过obs_options设置AK、SK、endpoint、bucket、超时时间、临时鉴权。

约束限制:

取值范围:

默认取值:

key

char *

必选

参数解释:

并行文件系统中的目录名称。

约束限制:

同一个并行文件系统中存储的目录名必须是唯一的。

取值范围:

长度大于0且不超过1024的字符串。

默认取值:

handler

表2*

必选

参数解释:

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

约束限制:

取值范围:

默认取值:

dir_access_labels

Access_label_data*

必选

参数解释:

accesslabel相关数据。

约束限制:

取值范围:

默认取值:

表2 get_access_label_handler

参数名称

参数类型

是否必选

描述

response_handler

obs_response_handler *

必选

参数解释:

响应回调函数结构体。

约束限制:

取值范围:

默认取值

get_access_label_callback_impl

表3 get_access_label_callback*

必选

参数解释:

回调函数指针,用于将获取到的access_label数据写入缓冲区

约束限制:

取值范围:

默认取值:

表3 get_access_label_callback

参数名称

参数类型

是否必选

描述

buffer_size

int

必选

参数解释:

buffer缓冲区的长度。

约束限制:

取值范围:

默认取值

buffer

char *

必选

参数解释:

获取到的access_label数据缓冲区。

约束限制:

取值范围:

默认取值

callback_data

void *

必选

参数解释:

用户自定义回调数据指针。

约束限制:

取值范围:

默认取值

表4 Access_label_data

参数名称

参数类型

是否必选

描述

labels

char[512][53]

set_access_label时必选

参数解释:

存放accesslabel的数组。

约束限制:

单个label最大长度为53,数组最大容量为512。

取值范围:

默认取值:

labels_len

int

set_access_label时必选,get_access_label时sdk会设置

参数解释:

labels数组中的access_label数目。。

约束限制:

无。

取值范围:

[0, 512]

默认取值:

json_str

char*

可选

参数解释:

json格式的accesslabel数据。

约束限制:

由SDK自动设置,用户无需填写。

取值范围:

默认取值:

json_str_remain_size

int

可选

参数解释:

json_str剩余空间大小。。

约束限制:

无。

取值范围:

默认取值:

json_current_offset

int

可选

参数解释:

json_str当前写入偏移量。

约束限制:

无。

取值范围:

默认取值:

callback_data

void *

可选

参数解释:

用户自定义回调数据。

约束限制:

取值范围:

默认取值:

status

obs_status

由sdk返回

参数解释:

标识请求是否成功的状态码。

约束限制:

由SDK自动设置,用户无需填写。

取值范围:

请详见表7 obs_status

默认取值:

相关文档