重命名对象（C++ SDK）--对象存储-火山引擎

文档中心

立即注册

导航

对象存储

重命名对象（C++ SDK）

最近更新时间：2024.06.20 20:04:18首次发布时间：2024.04.26 18:00:05

TOS 支持在桶内 Rename 单个对象的 Key，不拷贝和删除数据。

注意事项

重命名对象前，您需要先开启重命名功能。
仅支持重命名开启 RenameObject 后新上传的对象，不支持重命名开启该功能前的存量对象。
同一个对象不支持并发重命名。
重命名对象元数据上的所有信息都与源对象一致。

示例代码

以下代码用于对象重命名功能。

#include "TosClientV2.h"
using namespace VolcengineTos;

int main(void){
    // 初始化 TOS 账号信息
    // Your Region 填写 Bucket 所在 Region
    std::string region = "Your Region";
    std::string accessKey = std::getenv("TOS_ACCESS_KEY");
    std::string secretKey = std::getenv("TOS_SECRET_KEY");
    // 填写 Bucket 名称，例如 examplebucket
    std::string bucketName = "examplebucket";
    // 填写Object完整路径，完整路径中不能包含Bucket名称，例如exampledir/exampleobject.txt。
    std::string objectName = "exampledir/exampleobject1.txt";
    std::string objectNameNew = "exampledir/exampleobject2.txt";
    
    // 初始化网络等资源
    InitializeClient();
    // 创建交互的 client
    TosClientV2 client(region, accessKey, secretKey);
    
    // 设置桶的策略配置
    PutBucketRenameInput input(bucketName, true);
    auto output = client.putBucketRename(input);
    if (!output.isSuccess()) {
        // 异常处理
        std::cout << "PutBucketRename failed." << output.error().String() << std::endl;
        // 释放网络等资源
        CloseClient();
        return -1;
    }
    std::cout << "PutBucketRename success." << std::endl;
    
    RenameObjectInput renameInput(bucketName, objectName, objectNameNew);
    auto renameOutput = client.renameObject(renameInput);
    if (!renameOutput.isSuccess()) {
        // 异常处理
        std::cout << "RenameObject failed." << renameOutput.error().String() << std::endl;
        // 释放网络等资源
        CloseClient();
        return -1;
    }
    std::cout << "RenameObject success." << std::endl;
    
    // 释放网络等资源
    CloseClient();
    return 0;
}

参考文档

关于 RenameObject 的 API 文档，请参见 RenameObject。