更新时间:2023-11-09 GMT+08:00

对象下载

开发过程中,您有任何问题可以在github上提交issue

您可以调用get_object函数下载对象。

参数描述

字段名

类型

约束

说明

option

请求桶的上下文,配置option

必选

桶参数。

object_info

obs_object_info *

必选

对象名和版本号,非多版本对象,version设置为0。

get_conditions

obs_get_conditions *

必选

对象筛选条件和读取范围设置。

encryption_params

server_side_encryption_params *

可选

获取对象的解密设置。

handler

obs_get_object_handler *

必选

回调函数。

callback_data

void *

可选

回调数据。

示例代码

static void test_get_object()
{
    char *file_name = "./test";
    obs_object_info object_info;
    // 初始化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");

    // 设置下载的对象
    memset(&object_info, 0, sizeof(obs_object_info));
    object_info.key = "<object key>";
    object_info.version_id = "<object version ID>";
    //根据业务需要设置存放下载对象数据的结构
    get_object_callback_data data;
    data.ret_status = OBS_STATUS_BUTT;
    data.outfile = write_to_file(file_name);
    // 定义范围下载参数
    obs_get_conditions getcondition;
    memset(&getcondition, 0, sizeof(obs_get_conditions));
    init_get_properties(&getcondition);
    getcondition.start_byte = "<start byte>";
    // 下载长度,默认0,读到对象尾
    getcondition.byte_count = "<byte count>";

    // 定义下载的回调函数
    obs_get_object_handler get_object_handler =
    { 
        { &response_properties_callback,
          &get_object_complete_callback},
        &get_object_data_callback
    };

    get_object(&option, &object_info, &getcondition, 0, &get_object_handler, &data);
    if (OBS_STATUS_OK == data.ret_status) {
        printf("get object successfully. \n");
    }
    else
    {
        printf("get object faied(%s).\n", obs_get_status_name(data.ret_status));
    }
    fclose(data.outfile);
}
  • 通过操作对象输入流可将对象的内容读取到本地文件或者内存中。
  • getcondition可以传空,表示下载整个对象。