分段复制
开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。
分段复制是分段上传的一种特殊情况,即分段上传任务中的段通过复制OBS指定桶中现有对象(或对象的一部分)来实现。您可以通过copy_part来复制段,参数描述如下表:
字段名 |
类型 |
约束 |
说明 |
---|---|---|---|
option |
请求桶的上下文,配置option |
必选 |
桶参数。 |
key |
char * |
必选 |
对象名。 |
object_info |
obs_copy_destination_object_info * |
必选 |
指明多段上传任务。 |
object_info->destination_bucket |
char * |
必选 |
目标对象所在桶。 |
object_info->destination_key |
char * |
必选 |
目标对象名称。 |
object_info->last_modified_return |
int64_t * |
必选 |
对象上次修改的时间。 |
object_info->etag_return_size |
int |
必选 |
eTag缓存大小。 |
object_info->etag_return |
char * |
必选 |
eTag缓存。 |
copypart |
obs_upload_part_info * |
必选 |
上传段信息。 |
copypart->part_number |
unsigned int |
必选 |
上传段的段号。 |
copypart->upload_id |
char * |
必选 |
多段上传任务Id。 |
put_properties |
obs_put_properties* |
可选 |
上传对象属性。 |
encryption_params |
server_side_encryption_params * |
可选 |
服务端加密设置。 |
handler |
obs_response_handler * |
必选 |
回调函数。 |
callback_data |
void * |
可选 |
回调数据。 |
示例代码如下:
static void test_copy_part() { obs_status ret_status = OBS_STATUS_BUTT; // 创建并初始化option obs_options option; init_obs_options(&option); option.bucket_options.host_name = "<your-endpoint>"; option.bucket_options.bucket_name = "<Your bucketname>"; // 认证用的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"); // SSE-KMS加密 server_side_encryption_params encryption_params; memset(&encryption_params, 0, sizeof(server_side_encryption_params)); // 复制段后返回的etag值 char etagreturn[256] ={0}; char *key= "<Source object key>" // 定义拷贝段信息 obs_copy_destination_object_info object_info; memset(&object_info, 0, sizeof(obs_copy_destination_object_info)); object_info.destination_bucket = "<Your destination bucketname>"; object_info.destination_key = "<Your destination object key>"; object_info.etag_return = etagreturn; object_info.etag_return_size = 256; obs_upload_part_info copypart; memset(©part, 0, sizeof(obs_upload_part_info)); // 设置响应回调函数 obs_response_handler responseHandler = { &response_properties_callback, &response_complete_callback }; // 拷贝第一段 copypart.part_number = "1"; copypart.upload_id = "<upload id>"; copy_part(&option, key, &object_info, ©part, &putProperties,&encryption_params,&responseHandler, &ret_status); if (OBS_STATUS_OK == ret_status) { printf(" copy part 1 successfully. \n"); } else { printf("copy part 1 failed(%s).\n", obs_get_status_name(ret_status)); } // 拷贝第二段 copypart.part_number = "2"; copypart.upload_id = "<upload id>"; copy_part(&option, key, &object_info, ©part, &putProperties,&encryption_params,&responseHandler, &ret_status); if (ret_status == OBS_STATUS_OK) { printf(" copy part 2 successfully. \n"); } else { printf("copy part 2 failed(%s).\n", obs_get_status_name(ret_status)); } }