對象存儲（OBS）的斷點續傳上傳是一種數據傳輸機制，允許在上傳過程中遇到中斷時，從上次中斷的位置繼續上傳，而不是重新開始。這大大提高了大文件傳輸的效率和可靠性。

對象存儲OBS斷點續傳上傳

（圖片來源網絡，侵刪）

斷點續傳技術在對象存儲服務（OBS）中發揮著重要作用，特別是在上傳大文件或網絡不穩定的情況下，該技術允許上傳過程中出現中斷時，從斷點處繼續上傳而不是重新開始，大大提高了上傳效率和成功率。

1. 斷點續傳上傳的基本原理

斷點續傳上傳的基本思路是將大文件分割成多個小塊，分別上傳這些塊，在上傳過程中，每個塊的上傳結果將實時記錄在一個名為checkpoint的文件中，只有所有塊都成功上傳后，整個文件的上傳操作才被標記為成功，如果某些塊失敗，用戶可以根據checkpoint文件中的記錄，僅重新上傳失敗的塊，而不是整個文件。

2. 斷點續傳上傳的主要參數

使用斷點續傳上傳功能時，主要涉及以下幾個關鍵參數：

（圖片來源網絡，侵刪） 字段名 類型 約束 說明 option 請求桶的上下文，配置option 必選 桶參數 key char 必選 對象名 upload_file_config obs_upload_file_configuration 必選 上傳文件的配置說明 encryption_params server_side_encryption_params 可選 上傳對象加密設置 handler obs_upload_file_response_handler 必選 回調結構體，包含回調函數的指針 callback_data void 可選 回調數據

具體到obs_upload_file_configuration的結構描述如下：

成員名 類型 約束 說明 upload_file char 必選 待上傳的本地文件 part_size uint64_t 必選 分段大小，單位字節，取值范圍是100KB~5GB，默認為5MB check_point_file char 必選 記錄上傳進度的文件，只在斷點續傳模式下有效 enable_check_point int 必選 是否開啟斷點續傳模式，默認為0，表示不開啟 task_num int 必選 分段上傳時的最大并發數，默認為1

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不應硬編碼到代碼中或明文存儲，建議將這些信息放在配置文件或環境變量中，并使用時進行解密，應正確設置文件權限，避（本文來源：WWW.KENgnIAO.cOM）免未授權訪問敏感信息。

問題2: 如果上傳過程中本地文件發生了變化怎么辦？

答案： 如果上傳過程中本地文件內容發生變化，斷點續傳機制會認為文件已更改，因此會重新開始上傳所有分片，為避免這種情況，應確保在上傳過程中不修改正在上傳的本地文件，如果需要更改文件，最好等到上傳完成后再進行修改。

---