Docs

Torch Object Storage

Basic configurations

Using RenameObject

You can use the RenameObject feature to rename objects directly within the bucket. First, enable the feature in the TOS console. Then, rename objects using the RenameObject API. This topic provides background information, notes, and steps for enabling, using, and disabling the RenameObject feature.

Background information

The RenameObject feature is a faster, millisecond-level solution compared to the conventional method described in Renaming objects. Using RenameObject, you can rename any type of object. If the original object is appendable, the renamed object retains that property.

Notes

Category	Considerations
Content	RenameObject only changes the name of the object. All object metadata properties, such as the last modified time, are preserved.
Object	RenameObject only supports renaming objects uploaded after it is enabled. Objects uploaded before this feature is enabled are not supported. Before using RenameObject, restore any objects stored in Archive, Cold Archive, or Deep Cold Archive. For more information, see Restoring objects. Concurrent renaming of the same object using the RenameObject feature is not supported. RenameObject supports renaming objects created by all methods, including Put, Multi-Upload, Append, Copy, and Rename. If the original object is appendable, the renamed object retains that property.

Enabling RenameObject

Enabling RenameObject when creating a bucket

In the left navigation pane, click Buckets. Then, in the upper-left corner of the displayed page, click Create bucket.

On the Create Bucket page, click Advanced settings and enable the RenameObject feature.

tip

The RenameObject option only appears under Advanced settings when Versioning is set to Inactive.

For more information on other parameters when creating a bucket, see Creating buckets.

Click Create.

Enabling RenameObject for an existing bucket

You can enable the RenameObject feature either through the TOS console or by calling the PutBucketRename API. Learn how in PutBucketRename.

In the left navigation pane, click Buckets. In the Buckets list, click the bucket you want to manage.

In the left navigation pane, select Basic configurations > RenameObject.

On the RenameObject page, click Edit.

Click Enabled and Select.

In the box that appears, click Confirm.

tip

RenameObject does not work with versioning. You cannot use this feature if versioning is enabled or suspended on your bucket.

Using RenameObject

After enabling RenameObject, you can rename objects using the RenameObject API. For more information, see RenameObject.

Disabling RenameObject

You can disable the RenameObject feature either through the TOS console or by calling the DeleteBucketRename API. Learn how in DeleteBucketRename.

In the left navigation pane, click Buckets. In the Buckets list, click the bucket you want to manage.

In the left navigation pane, select Basic configurations > RenameObject.

On the RenameObject page, click Edit.

Click Disabled and Select.

In the box that appears, click Confirm.

Last updated: 2026.07.20 18:40:36