
# 断点续传上传请求参数
表1请求参数列表 
| 字段名                | 类型                                                                                                                                    | 约束 | 说明                                                                                                                                        |
|:---|:---|:---|:---|
| options            | const [obs_options](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0085.html#obs_20_0085__table9681927859) \*                  | 必选 | 请求桶的上下文，[配置option(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0203.html)，通过obs_options设置AK、SK、endpoint、bucket、超时时间、临时鉴权 |
| key                | char \*                                                                                                                               | 必选 | 对象名。                                                                                                                                      |
| upload_file_config | [obs_upload_file_configuration] \*                                                                   | 必选 | 上传文件的配置说明，请参看下表。                                                                                                                          |
| encryption_params  | [server_side_encryption_params](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0094.html#obs_20_0094__table20217914111418) \*  | 可选 | 上传对象加密设置。                                                                                                                                 |
| handler            | [obs_upload_file_response_handler](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0088.html#obs_20_0088__table239702913269) \* | 必选 | 回调结构体，结构体内所有成员都是回调函数的指针，用于设置处理接口响应数据的回调函数。您可以通过设置回调函数，把服务端的响应数据复制到您的自定义回调数据callback_data中。                                                |
| callback_data      | void \*                                                                                                                               | 可选 | 用户自定义回调数据                                                                                                                                 |
   
上传文件结构obs_upload_file_configuration描述如下表：
 表2obs_upload_file_configuration 
| **参数名称**           | **参数类型**                                                                                                            | **是否必选** | **描述**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
|:---|:---|:---|:---|
| upload_file        | char \*                                                                                                             | 必选       | **参数解释：** 要上传的本地文件路径。 **约束限制：** 无 **取值范围：** 无 **默认取值：** 无                                                                                                                                                                                                                                                                     |
| part_size          | uint64_t                                                                                                            | 可选       | **参数解释：** 分段大小，单位字节，取值范围是100KB\~5GB，默认为5MB。 **约束限制：** 无 **取值范围：** 无 **默认取值：** 无                                                                                                                                                                                                                                             |
| check_point_file   | char \*                                                                                                             | 可选       | **参数解释：** 记录上传进度的文件，只在断点续传模式下有效。当该值为空时，默认与待上传的本地文件同目录。 **约束限制：** 无 **取值范围：** 无 **默认取值：** 无                                                                                                                                                                                                                                        |
| enable_check_point | int                                                                                                                 | 可选       | **参数解释：** 是否启用断点续传。 **约束限制：** 无 **取值范围：** - 0（表示不启用断点续传模式，此时断点续传上传接口退化成对分段上传的简单封装，不会产生checkpoint文件）  - 1（表示启用断点续传模式）   **默认取值：** 0（表示不开启） |
| task_num           | int                                                                                                                 | 可选       | **参数解释：** 分段上传时的最大并发数。 **约束限制：** 无 **取值范围：** 无 **默认取值：** 1                                                                                                                                                                                                                                                                  |
| pause_upload_flag  | int \*                                                                                                              | 可选       | **参数解释：** 暂停上传标志。 **约束限制：** 不能为NULL，指向的值为1时暂停上传。 **取值范围：** 无 **默认取值：** 无                                                                                                                                                                                                                                                          |
| put_properties     | [obs_put_properties](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0092.html#obs_20_0092__table53755070) \* | 必选       | **参数解释：** 对象相关属性。 **约束限制：** 无 **取值范围：** 无 **默认取值：** 无                                                                                                                                                                                                                                                                        |
   
