设置对象accesslabel

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

您可以通过函数set_access_label设置并行文件系统中对象的accesslabel。

同一并行文件系统目录最多512条access_label ，每条长度最大为52

方法定义

 void set_access_label(const obs_options *options,
	char* key, put_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	put_access_label_handler *	必选	回调结构体，结构体内所有成员都是回调函数的指针，用于设置处理接口响应数据的回调函数。您可以通过设置回调函数，把服务端的响应数据复制到您的自定义回调数据callback_data中。
dir_access_labels	Access_label_data*	必选	accesslabel相关数据

表2 Access_label_data
字段名	类型	约束	说明
labels	char[512][53]	set_access_label时必选	所有的accesslabel
labels_len	int	set_access_label时必选，get_access_label时sdk会设置	labels中的accesslabel数目
json_str	char*	可选	json格式的access_label
status	obs_status	由sdk返回	标识请求是否成功的状态码

代码示例

static void dir_access_label_response_complete_callback(obs_status status,
	const obs_error_details *error,
	void *callback_data) {
	if (callback_data)
	{
		Access_label_data *dir_access_label_datas = (Access_label_data *)callback_data;
		dir_access_label_datas->status = status;
	}
	else
	{
		statusG = status;
	}
	int len = 0;
	if (error && error->message) {
		printf("Error Message: \n	%s\n", error->message);
		len += snprintf_s(&(errorDetailsG[len]), sizeof(errorDetailsG) - len, _TRUNCATE,
			"  Message: %s\n", error->message);
	}
	if (error && error->resource) {
		printf("Error Resource: \n	%s\n", error->resource);
		len += snprintf_s(&(errorDetailsG[len]), sizeof(errorDetailsG) - len, _TRUNCATE,
			"  Resource: %s\n", error->resource);
	}
	if (error && error->further_details) {
		printf("Error further_details: \n	%s\n", error->further_details);
		len += snprintf_s(&(errorDetailsG[len]), sizeof(errorDetailsG) - len, _TRUNCATE,
			"  Further Details: %s\n", error->further_details);
	}
	if (error && error->extra_details_count) {
		len += snprintf_s(&(errorDetailsG[len]), sizeof(errorDetailsG) - len, _TRUNCATE,
			"%s", "  Extra Details:\n");
		int i;
		for (i = 0; i < error->extra_details_count; i++) {
			printf("Error Extra Detail(%d):\n	%s:%s\n", i,
				error->extra_details[i].name, error->extra_details[i].value);
			len += snprintf_s(&(errorDetailsG[len]),
				sizeof(errorDetailsG) - len, _TRUNCATE, "    %s: %s\n",
				error->extra_details[i].name,
				error->extra_details[i].value);
		}
	}
	if (error && error->error_headers_count) {
		len += snprintf_s(&(errorHeadersG[len]), sizeof(errorHeadersG) - len, _TRUNCATE,
			"%s", "  Extra Details:\n");
		int i;
		for (i = 0; i < error->error_headers_count; i++) {
			char* errorHeader = error->error_headers[i];
			printf("Error Headers(%d):\n	%s\n", i,
				errorHeader == NULL ? "NULL Header" : errorHeader);
			len += snprintf_s(&(errorHeadersG[len]),
				sizeof(errorHeadersG) - len, _TRUNCATE, "    %s\n",
				errorHeader == NULL ? "NULL Header" : errorHeader);
		}
	}
}

int put_dir_access_label_json_callback(int buffer_size, char *buffer, void *callback_data) {

	Access_label_data *data =
		(Access_label_data *)callback_data;

	int toRead = 0;
	if (data->json_str_remain_size > 0) {
		toRead = ((data->json_str_remain_size > (unsigned)buffer_size) ?
			(unsigned)buffer_size : data->json_str_remain_size);
		errno_t ret = memcpy_s(buffer, buffer_size, data->json_str + data->json_current_offset, toRead);
		if (ret != EOK) {
			printf("memcpy_s failed in put_dir_access_label_json_callback!");
		}
	}

	data->json_str_remain_size -= toRead;
	data->json_current_offset += toRead;


	return toRead;
}

static void test_set_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");

	int access_labels_len = 0;
	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;
	}

	errno_t ret = strcpy_s(dir_access_label_datas.labels[access_labels_len++], 53, "testlabel1");
	if (ret != EOK) {
		printf("strcpy_s failed, length of ACCESS_LABEL should be less than %d", MAX_LABEL_LENGTH);
	}
	ret = strcpy_s(dir_access_label_datas.labels[access_labels_len++], 53, "testlabel2");
	if (ret != EOK) {
		printf("strcpy_s failed, length of ACCESS_LABEL should be less than %d", MAX_LABEL_LENGTH);
	}
	ret = strcpy_s(dir_access_label_datas.labels[access_labels_len++], 53, "testlabel3");
	if (ret != EOK) {
		printf("strcpy_s failed, length of ACCESS_LABEL should be less than %d", MAX_LABEL_LENGTH);
	}
	ret = strcpy_s(dir_access_label_datas.labels[access_labels_len++], 53, "te01234567890123456789012345678901234567890123456789");
	if (ret != EOK) {
		printf("strcpy_s failed, length of ACCESS_LABEL should be less than %d", MAX_LABEL_LENGTH);
	}
	dir_access_label_datas.labels_len = access_labels_len;
	put_access_label_handler handler = {
		{
			response_properties_callback, // 您可以在sdk的源码的demo_windows.cpp 文件中找到这个函数示例 
			dir_access_label_response_complete_callback
		},
		put_dir_access_label_json_callback
	};
	set_access_label(&option, key, &handler, &dir_access_label_datas);
	printf("test_set_access_label's obs_status is %s", obs_get_status_name(dir_access_label_datas.status));
}