开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。
对于较大文件上传,可以切分成段上传。用户可以在如下的应用场景内(但不仅限于此),使用分段上传的模式:
上传超过100MB大小的文件。
网络条件较差,和OBS服务端之间的链接经常断开。
上传前无法确定将要上传文件的大小。
分段上传分为如下3个步骤:
初始化分段上传任务(initiate_multi_part_upload)。
逐个或并行上传段(upload_part)。
合并段(complete_multi_part_upload)或取消分段上传任务(abort_multi_part_upload)。
初始化分段上传任务
使用分段上传方式传输数据前,必须先通知OBS初始化一个分段上传任务。该操作会返回一个OBS服务端创建的全局唯一标识(upload_id),用于标识本次分段上传任务。您可以根据这个唯一标识来发起相关的操作,如取消分段上传任务、列举分段上传任务、列举已上传的段等。
请注意,多段上传的对象的相关属性(如acl、过期时间等等)是在初始化分段上传任务时设置,不能在上传段或合并段时设置,请注意设置相关属性的时机。
您可以通过initiate_multi_part_upload初始化一个分段上传任务,参数描述如下表所示:
字段名
|
类型
|
约束
|
说明
|
option
|
请求桶的上下文,配置option
|
必选
|
桶参数。
|
key
|
char *
|
必选
|
对象名。
|
upload_id_return_size
|
int
|
必选
|
多段上传id缓存大小。
|
upload_id_return
|
char *
|
必选
|
多段上传id缓存。
|
put_properties
|
obs_put_properties*
|
可选
|
上传对象属性。
|
encryption_params
|
server_side_encryption_params *
|
可选
|
服务端加密设置。
|
handler
|
obs_response_handler *
|
必选
|
回调函数。
|
callback_data
|
void *
|
可选
|
回调数据。
|
static void test_initiate_multi_part_upload()
{
obs_status ret_status = OBS_STATUS_BUTT;
// 创建并初始化option
obs_options option;
init_obs_options(&option);
option.bucket_options.host_name = "";
option.bucket_options.bucket_name = "";
// 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险,建议在配置文件或者环境变量中密文存放,使用时解密,确保安全;本示例以ak和sk保存在环境变量中为例,运行本示例前请先在本地环境中设置环境变量ACCESS_KEY_ID和SECRET_ACCESS_KEY。
// 您可以登录访问管理控制台获取访问密钥AK/SK,获取方式请参见https://support.huaweicloud.com/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");
// 定义多段上传id缓存及大小
char upload_id[OBS_COMMON_LEN_256] = {0};
int upload_id_size = OBS_COMMON_LEN_256;
// 设置响应回调函数
obs_response_handler handler =
{
&response_properties_callback,
&response_complete_callback
};
// 初始化分段上传任务,这里的upload_id就是接口定义中的upload_id_return
initiate_multi_part_upload(&option, "