流式上传
![](https://support.huaweicloud.com/sdk-c-devg-obs/public_sys-resources/notice_3.0-zh-cn.png)
开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。
流式上传需要将您的数据流传入回调数据callback_data中,然后使用结构体obs_put_object_handler中定义的回调函数put_object_data_callback来处理传入的回调数据。通过调用put_object实现流式上传。
参数描述
字段名 |
类型 |
约束 |
说明 |
---|---|---|---|
option |
请求桶的上下文,配置option |
必选 |
桶参数。 |
key |
char * |
必选 |
对象名。 |
content_length |
uint64_t |
必选 |
对象内容长度。 |
put_properties |
obs_put_properties* |
必选 |
上传对象属性。 |
encryption_params |
server_side_encryption_params * |
可选 |
上传对象加密设置。 |
handler |
obs_put_object_handler * |
必选 |
回调函数。 |
callback_data |
void * |
可选 |
回调数据。 |
示例代码
static void test_put_object_from_buffer() { // 待上传buffer char *buffer = "abcdefg"; // 待上传buffer的长度 int buffer_size = strlen(buffer); // 上传的对象名 char *key = "put_buffer_test"; // 初始化option obs_options option; init_obs_options(&option); option.bucket_options.host_name = "<your-endpoint>"; option.bucket_options.bucket_name = "<Your bucketname>"; // 认证用的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"); option.bucket_options.certificate_info = "<Your certificate>"; // 初始化上传对象属性 obs_put_properties put_properties; init_put_properties(&put_properties); //初始化存储上传数据的结构体 put_buffer_object_callback_data data; memset(&data, 0, sizeof(put_buffer_object_callback_data)); // 把buffer赋值到上传数据结构中 data.put_buffer = buffer; // 设置buffersize data.buffer_size = buffer_size; // 设置回调函数 obs_put_object_handler putobjectHandler = { { &response_properties_callback, &put_buffer_complete_callback }, &put_buffer_data_callback }; put_object(&option, key, buffer_size, &put_properties,0,&putobjectHandler,&data); if (OBS_STATUS_OK == data.ret_status) { printf("put object from buffer successfully. \n"); } else { printf("put object from buffer failed(%s).\n", obs_get_status_name(data.ret_status)); } }
![](https://support.huaweicloud.com/sdk-c-devg-obs/public_sys-resources/note_3.0-zh-cn.png)
- 上传的内容大小不能超过5GB。
- put_object接口中第五个参数是提供服务端加密功能的参数,具体用法参考服务端加密章节。