文档首页/ 对象存储服务 OBS/ SDK参考/ C/ 管理对象/ 复制对象
更新时间：2024-10-08 GMT+08:00
查看PDF
分享

复制对象

开发过程中，您有任何问题可以在github上提交issue，或者在华为云对象存储服务论坛中发帖求助。

复制对象特性用来为OBS上已经存在的对象创建一个副本。

您可以通过copy_object来复制对象。复制对象时，可重新指定新对象的属性和设置对象权限，且支持条件复制。

  • 如果待复制的源对象是归档存储类型，则必须先恢复源对象才能进行复制。

简单复制

copy_object的参数描述如下：

字段名

类型

约束

说明

option

请求桶的上下文，配置option

必选

桶参数。

key

char *

必选

对象名。

version_id

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缓存。

is_copy

unsigned int

必选

用来指定新对象的元数据是从源对象中复制，还是用请求中的元数据替换。

put_properties

obs_put_properties*

可选

上传对象属性。

encryption_params

server_side_encryption_params *

可选

服务端加密设置。

handler

obs_response_handler *

必选

回调函数。

callback_data

void *

可选

回调数据。

示例代码如下：

static void test_copy_object()
{
    obs_status ret_status = OBS_STATUS_BUTT;
    char eTag[OBS_COMMON_LEN_256] = {0};
    int64_t lastModified;
    // 创建并初始化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");
    // 设置目的对象信息
    obs_copy_destination_object_info objectinfo ={0};
    objectinfo.destination_bucket = target_bucket;
    objectinfo.destination_key = destinationKey;
    objectinfo.etag_return = eTag;
    objectinfo.etag_return_size = sizeof(eTag);
    objectinfo.last_modified_return = &lastModified;
    // 设置响应回调函数
    obs_response_handler responseHandler =
    { 
        &response_properties_callback,
        &response_complete_callback 
    };
    // 拷贝对象
    copy_object(&option, key, version_id, &objectinfo, 1, NULL, NULL,&responseHandler,&ret_status);
    if (OBS_STATUS_OK == ret_status) {
        printf("test_copy_object  successfully. \n");
    }
    else
    {
        printf("test_copy_object failed(%s).\n", obs_get_status_name(ret_status));
    }
}

限定条件复制

复制对象时，可以指定一个或多个限定条件，满足限定条件时则进行复制，否则抛出异常，复制对象失败。

您可以使用的限定条件如下：

参数

作用

if_modified_since

如果源对象在指定的时间后有修改，则进行复制，否则抛出异常。

if_not_modified_since

如果源对象在指定的时间后没有修改，则进行复制，否则抛出异常。

if_match_etag

如果源对象的ETag值与该参数值相同，则进行复制，否则抛出异常。

if_not_match_etag

如果源对象的ETag值与该参数值不相同，则进行复制，否则抛出异常。
  • 源对象的ETag值是指源对象数据的MD5校验值。
  • 如果包含if_not_modified_since并且不符合，或者包含if_match_etag并且不符合，或者包含if_modified_since并且不符合，或者包含if_not_match_etag并且不符合，则复制失败，抛出异常中HTTP状态码为：412 precondition failed。
  • if_modified_since和if_not_match_etag可以一起使用；if_not_modified_since和if_match_etag可以一起使用。

以下代码展示了如何进行限定条件复制：

static void test_copy_object_condition()
{
    obs_status ret_status = OBS_STATUS_BUTT;
    char eTag[OBS_COMMON_LEN_256] = {0};
    int64_t lastModified;
    // 创建并初始化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");

    // 设置目的对象信息
    obs_copy_destination_object_info objectinfo ={0};
    objectinfo.destination_bucket = target_bucket;
    objectinfo.destination_key = destinationKey;
    objectinfo.etag_return = eTag;
    objectinfo.etag_return_size = sizeof(eTag);
    objectinfo.last_modified_return = &lastModified;
    //限定条件
    obs_put_properties putProperties={0};
    init_put_properties(&putProperties);         
    putProperties.get_conditions.if_match_etag = "<etag>";
    putProperties.get_conditions.if_modified_since = "<time>";
    putProperties.get_conditions.if_not_match_etag = "<etag>";
    putProperties.get_conditions.if_not_modified_since = "<time>";
    // 设置响应回调函数
    obs_response_handler responseHandler =
    { 
        &response_properties_callback,
        &response_complete_callback 
    };
    // 拷贝对象
    copy_object(&option, key, version_id, &objectinfo, 1, &putProperties, NULL,&responseHandler,&ret_status);
    if (OBS_STATUS_OK == ret_status) {
        printf("test_copy_object  successfully. \n");
    }
    else
    {
        printf("test_copy_object failed(%s).\n", obs_get_status_name(ret_status));
    }
}

重写对象访问权限

以下代码展示了如何在复制对象时重写对象访问权限：

static void test_copy_object_acl()
{
    obs_status ret_status = OBS_STATUS_BUTT;
    char eTag[OBS_COMMON_LEN_256] = {0};
    int64_t lastModified;
    // 创建并初始化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");
    // 设置目的对象信息
    obs_copy_destination_object_info objectinfo ={0};
    objectinfo.destination_bucket = target_bucket;
    objectinfo.destination_key = destinationKey;
    objectinfo.etag_return = eTag;
    objectinfo.etag_return_size = sizeof(eTag);
    objectinfo.last_modified_return = &lastModified;
    //重写对象访问权限
    obs_put_properties putProperties={0};
    init_put_properties(&putProperties);         
    putProperties.canned_acl = OBS_CANNED_ACL_PUBLIC_READ;
    // 设置响应回调函数
    obs_response_handler responseHandler =
    { 
        &response_properties_callback,
        &response_complete_callback 
    };
    // 拷贝对象
    copy_object(&option, key, version_id, &objectinfo, 1, &putProperties, NULL,&responseHandler,&ret_status);
    if (OBS_STATUS_OK == ret_status) {
        printf("test_copy_object  successfully. \n");
    }
    else
    {
        printf("test_copy_object failed(%s).\n", obs_get_status_name(ret_status));
    }
}
父主题： 管理对象

相关文档