文档首页/ 对象存储服务 OBS/ SDK参考/ C/ 参数列表/ 断点续传上传请求参数
更新时间:2026-03-13 GMT+08:00
分享

断点续传上传请求参数

表1 请求参数列表

字段名

类型

约束

说明

options

const obs_options *

必选

请求桶的上下文,配置option(C SDK),通过obs_options设置AK、SK、endpoint、bucket、超时时间、临时鉴权

key

char *

必选

对象名。

upload_file_config

obs_upload_file_configuration *

必选

上传文件的配置说明,请参看下表。

encryption_params

server_side_encryption_params *

可选

上传对象加密设置。

handler

obs_upload_file_response_handler *

必选

回调结构体,结构体内所有成员都是回调函数的指针,用于设置处理接口响应数据的回调函数。您可以通过设置回调函数,把服务端的响应数据复制到您的自定义回调数据callback_data中。

callback_data

void *

可选

用户自定义回调数据

上传文件结构obs_upload_file_configuration描述如下表:

表2 obs_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 *

必选

参数解释:

对象相关属性。

约束限制:

取值范围:

默认取值:

相关文档