Object Storage Service:Rename objects (OSS SDK for Node.js)

How it works

Renaming an object involves two steps:

1. Copy the source object to the destination key within the same bucket.

2. Delete the source object.

To rename a directory, apply this copy-then-delete sequence recursively to every object and subdirectory it contains.

Rename an object

The following example renames srcobject.txt to destobject.txt in examplebucket.

const OSS = require('ali-oss');

const client = new OSS({
  // Set the region where the bucket is located. Example: oss-cn-hangzhou.
  region: 'oss-cn-hangzhou',
  // Load access credentials from environment variables.
  // Set OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET before running this example.
  accessKeyId: process.env.OSS_ACCESS_KEY_ID,
  accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
  authorizationV4: true,
  // Specify the bucket name.
  bucket: 'examplebucket',
});

async function renameObject() {
  try {
    // Step 1: Copy srcobject.txt to destobject.txt.
    const copyResult = await client.copy('destobject.txt', 'srcobject.txt');
    console.log('Copied:', copyResult);

    // Step 2: Delete the original object.
    const deleteResult = await client.delete('srcobject.txt');
    console.log('Deleted:', deleteResult);
  } catch (e) {
    console.error('Operation failed:', e.message || e);
  }
}

renameObject();

Replace the following placeholders with your actual values:

API reference

• CopyObject

• DeleteObject