获取对象accesslabel

开发过程中，您有任何问题可以在github上提交issue，或者在华为云对象存储服务论坛中发帖求助。

OBS支持为对象设置AccessLabel进行权限控制处理，您可以通过函数get_access_label获取并行文件系统中对象的accesslabel。

方法定义

    
         void get_access_label(const obs_options *options,
	char* key, get_access_label_handler * handler,
	Access_label_data * dir_access_labels);

请求参数描述

表1 请求参数列表
字段名	类型	约束	说明
options	const obs_options *	必选	请求桶的上下文，配置option(C SDK)，通过obs_options设置AK、SK、endpoint、bucket、超时时间、临时鉴权
key	char *	必选	并行文件系统中的目录名称。
handler	get_access_label_handler *	必选	回调结构体，结构体内所有成员都是回调函数的指针，用于设置处理接口响应数据的回调函数。您可以通过设置回调函数，把服务端的响应数据复制到您的自定义回调数据callback_data中。
dir_access_labels	Access_label_data*	必选	accesslabel相关数据

代码示例

static obs_status get_dir_access_label_json_callback(int buffer_size, const char *buffer,
	void *callback_data)
{
	Access_label_data *data = (Access_label_data *)callback_data;
	errno_t ret = memcpy_s(data->json_str + data->json_current_offset, buffer_size, buffer, buffer_size);
	data->json_current_offset += buffer_size;
	return ((ret != EOK) ?
		OBS_STATUS_Security_Function_Failed : OBS_STATUS_OK);
}

static void test_get_access_label(char *bucket_name, char *key) {
	obs_options option;
	init_obs_options(&option);
	obs_put_properties putProperties = { 0 };
	init_put_properties(&putProperties);

	option.bucket_options.host_name = HOST_NAME;
	option.bucket_options.bucket_name = bucket_name;
    // 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全；本示例以ak和sk保存在环境变量中为例，运行本示例前请先在本地环境中设置环境变量ACCESS_KEY_ID和SECRET_ACCESS_KEY。
    // 您可以登录访问管理控制台获取访问密钥AK/SK，获取方式请参见https://support.huaweicloud.com/usermanual-ca/ca_01_0003.html
    option.bucket_options.access_key = getenv("ACCESS_KEY_ID");
    option.bucket_options.secret_access_key = getenv("SECRET_ACCESS_KEY");

	Access_label_data dir_access_label_datas;
	obs_status status = init_access_label(&dir_access_label_datas);
	if (status != OBS_STATUS_OK) {
		printf("init_access_label failed in %s", __FUNCTION__);
		return;
	}
	char json_str[MAX_LABEL_JSON_LENGTH] = {0}; // 用于接收从服务端返回的json格式的字符串，包含了所有的access label
	dir_access_label_datas.json_str = json_str;
	get_access_label_handler handler = {
		{
			response_properties_callback,// 您可以在sdk的源码的demo_windows.cpp 文件中找到这个函数示例
			dir_access_label_response_complete_callback //此回调的完整实现见 代码示例
		},
		get_dir_access_label_json_callback
	};
	get_access_label(&option, key, &handler, &dir_access_label_datas);
	printf("test_get_access_label's obs_status is %s, dir_access_label_json is %s\n", 
		obs_get_status_name(dir_access_label_datas.status), 
		dir_access_label_datas.json_str);
	for (int i = 0; i < dir_access_label_datas.labels_len; ++i) {
                // 打印所有从服务端返回的json中解析出的access label
		printf("access_label[%d] is %s\n", i + 1, dir_access_label_datas.labels[i]);
	}
}