对象存储OBS断点续传上传_对象存储（OBS）

对象存储OBS断点续传上传

断点续传技术在对象存储服务（OBS）中发挥着重要作用，特别是在上传大文件或网络不稳定的情况下，该技术允许上传过程中出现中断时，从断点处继续上传而不是重新开始，大大提高了上传效率和成功率。

1. 断点续传上传的基本原理

断点续传上传的基本思路是将大文件分割成多个小块，分别上传这些块，在上传过程中，每个块的上传结果将实时记录在一个名为checkpoint的文件中，只有所有块都成功上传后，整个文件的上传操作才被标记为成功，如果某些块失败，用户可以根据checkpoint文件中的记录，仅重新上传失败的块，而不是整个文件。

2. 断点续传上传的主要参数

使用断点续传上传功能时，主要涉及以下几个关键参数：

具体到obs_upload_file_configuration的结构描述如下：

3. 示例代码和应用流程

以下是一个简单的断点续传上传接口的使用示例：

void uploadFileResultCallback(obs_status status,
                            char *resultMsg,
                            int partCountReturn,
                            obs_upload_file_part_info *uploadInfoList,
                            void *callbackData);
//回调函数声明
static void test_upload_file() {
    obs_status ret_status = OBS_STATUS_BUTT;
    //创建并初始化option
    obs_options option;
    init_obs_options(&option);
    option.bucket_options.host_name = "<yourendpoint>";
    option.bucket_options.bucket_name = "<Your bucketname>";
    //认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全；本示例以ak和sk保存在环境变量中为例，运行本示例前请先在本地环境中设置环境变量ACCESS_KEY_ID和SECRET_ACCESS_KEY。
    option.bucket_options.access_key = getenv("ACCESS_KEY_ID");
    option.bucket_options.secret_access_key = getenv("SECRET_ACCESS_KEY");
    //初始化结构体put_properties
    obs_put_properties put_properties;
    init_put_properties(&put_properties);
    obs_upload_file_configuration uploadFileInfo;
    memset_s(&uploadFileInfo,sizeof(obs_upload_file_configuration),0,sizeof(obs_upload_file_configuration));
    uploadFileInfo.check_point_file = 0;
    uploadFileInfo.enable_check_point = 1;
    uploadFileInfo.part_size = "<part size>";
    uploadFileInfo.task_num = "<task num>";
    uploadFileInfo.upload_file = "<upload filename>";
    uploadFileInfo.put_properties = &put_properties;  
    //回调函数
    obs_upload_file_response_handler Handler = { 
        {&response_properties_callback, &response_complete_callback_for_multi_task},
        &uploadFileResultCallback
    };    
    initialize_break_point_lock();
    upload_file(&option, "<Your Key>", 0, &uploadFileInfo, Null, &Handler, &ret_status);
}

此代码首先初始化上传所需的各种参数，如上传文件路径、分段大小、是否启用断点续传等，然后定义了一个回调函数uploadFileResultCallback用于处理上传结果，最后通过调用upload_file方法开始上传过程。

4. 相关问题与解答

问题1: 如何确保断点续传上传的安全问题？

答案： 为了确保安全性，认证用的AK和SK不应硬编码到代码中或明文存储，建议将这些信息放在配置文件或环境变量中，并使用时进行解密，应正确设置文件权限，避免未授权访问敏感信息。

问题2: 如果上传过程中本地文件发生了变化怎么办？

答案： 如果上传过程中本地文件内容发生变化，断点续传机制会认为文件已更改，因此会重新开始上传所有分片，为避免这种情况，应确保在上传过程中不修改正在上传的本地文件，如果需要更改文件，最好等到上传完成后再进行修改。