Renaming is supported only for objects uploaded after the RenameObject feature is enabled; it is not supported for objects that existed prior to enabling this feature.

Concurrent renaming is not supported for the same object.

All information contained in the metadata of the renamed object is identical to that of the source object.

Sample Code

The following code is used for the object renaming functionality.

#include "TosClientV2.h"​
using namespace VolcengineTos;​
​
int main(void){​
 ​
 ​
    std::string region = "Your Region";​
    std::string accessKey = std::getenv("TOS_ACCESS_KEY");​
    std::string secretKey = std::getenv("TOS_SECRET_KEY");​
   ​
    std::string bucketName = "examplebucket";​
 ​
    std::string objectName = "exampledir/exampleobject1.txt";​
    std::string objectNameNew = "exampledir/exampleobject2.txt";​
    ​
    ​
    InitializeClient();​
​
    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;​
}​

Reference Document

For the API documentation on RenameObject, see RenameObject.

Last updated: 2025.09.25 14:22:48

Public security network record in Beijing: No. 11010802032137