更新时间:2024-12-03 GMT+08:00

流式上传

开发过程中,您有任何问题可以在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/intl/zh-cn/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));
    }
}
  • 上传的内容大小不能超过5GB。
  • put_object接口中第五个参数是提供服务端加密功能的参数,具体用法参考服务端加密章节。