更新时间:2024-12-03 GMT+08:00

重命名对象或目录

开发过程中,您有任何问题可以在github上提交issue

您可以通过rename_object来修改对象名和目录名,rename_object接口只适用于并行文件系统,对象桶该接口不支持。

参数描述

字段名

类型

约束

说明

option

请求桶的上下文,配置option

必选

桶参数。

key

char *

必选

需要重命名的对象名或目录名。

new_object_name

char *

必选

新名字。

handler

obs_response_handler *

必选

回调函数。

callback_data

void *

可选

回调数据。

示例代码

以下代码展示对象如何重命名:

static void test_rename_object()
{
    obs_status ret_status = OBS_STATUS_BUTT;
    // 需要重命名的对象名或目录名
    char *key = "put_buffer_test";
    // 新名字
    char *new_key_name = "put_buffer_test_new";
    // 创建并初始化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/intl/zh-cn/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_response_handler response_handler =
    { 
        &response_properties_callback, &response_complete_callback
    };
    // 重命名对象
    rename_object(&option, key, new_key_name, &response_handler,&ret_status);
    if (OBS_STATUS_OK == ret_status) {
        printf("rename_object successfully. \n");
    }
    else
    {
        printf("rename_object failed.\n", obs_get_status_name(ret_status));
    }
}
  • rename_object只适用于并行文件系统的桶。
  • rename时,如果源对象不存在,则会报错(HTTP状态码为404)。