
# 设置对象accesslabel请求参数
表1请求参数列表 
| **参数名称**          | **参数类型**                                                                                                             | **是否必选** | **描述**                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
|:---|:---|:---|:---|
| options           | const [obs_options](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0085.html#obs_20_0085__table9681927859) \* | 必选       | **参数解释：** 请求桶的上下文，通过obs_options设置AK、SK、endpoint、bucket、超时时间、临时鉴权。 **约束限制：** 无 **取值范围：** 无 **默认取值：** 无                                                                                             |
| key               | char \*                                                                                                              | 必选       | **参数解释：** 并行文件系统中的目录名称。 **约束限制：** 同一个并行文件系统中存储的目录名必须是唯一的。 **取值范围：** 长度大于0且不超过1024的字符串。 **默认取值：** 无 |
| handler           | [put_access_label_handler] \*                                                      | 必选       | **参数解释：** 回调结构体，结构体内所有成员都是回调函数的指针，用于设置处理接口响应数据的回调函数。您可以通过设置回调函数，把服务端的响应数据复制到您的自定义回调数据callback_data中。 **约束限制：** 无 **取值范围：** 无 **默认取值：** 无                                                                     |
| dir_access_labels | [Access_label_data]\*                                                               | 必选       | **参数解释：** accesslabel相关数据。 **约束限制：** 无 **取值范围：** 无 **默认取值：** 无                                                                                                                                                |
   
 表2put_access_label_handler 
| **参数名称**                       | **参数类型**                                                                                                              | **是否必选** | **描述**                                                                                                                                                                                                                                                                                       |
|:---|:---|:---|:---|
| response_handler               | [obs_response_handler](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0087.html#obs_20_0087__table53755070) \* | 必选       | **参数解释：** 响应回调函数结构体 **约束限制：** 无 **取值范围：** 无 **默认取值：** 无                     |
| put_access_label_callback_impl | [表3 put_access_label_callback] \*                                                     | 必选       | **参数解释：** 回调函数指针，用于把要上传的数据复制到待上传的数据缓冲区 **约束限制：** 无 **取值范围：** 无 **默认取值：** 无 |
   
 表3put_access_label_callback 
| **参数名称**                       | **参数类型**                                                                                                              | **是否必选** | **描述**                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|:---|
| response_handler               | [obs_response_handler](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0087.html#obs_20_0087__table53755070) \* | 必选       | **参数解释：** 响应回调函数结构体 **约束限制：** 无 **取值范围：** 无 **默认取值：** 无                      |
| put_access_label_callback_impl | [put_access_label_callback] \*                                                     | 必选       | **参数解释：** 回调函数指针，用于把要上传的数据复制到待上传的数据缓冲区 **约束限制：** 无 **取值范围：** 无 **默认取值：** 无 |
   
 表4Access_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](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0087.html#obs_20_0087__table9663191913320) **默认取值：** 无 |
   
