Tous les produits
Search
Centre de documentation

Object Storage Service:Renommer des objets (OSS SDK for Node.js)

Dernière mise à jour :Sep 22, 2026

OSS ne permet pas de renommer directement les objets. Pour renommer un objet, copiez-le puis supprimez l'original : appelez CopyObject pour créer un nouvel objet avec le nom souhaité, puis appelez DeleteObject pour supprimer l'objet source.

Exemple de code

L'exemple de code suivant montre comment renommer l'objet srcobject.txt en destobject.txt dans le bucket examplebucket.

const OSS = require('ali-oss');
const client = new OSS({
  // Specify the region in which the bucket is located. For example, if the bucket is located in the China (Hangzhou) region, set the region to oss-cn-hangzhou. 
  region: 'oss-cn-hangzhou',
  // Obtain access credentials from environment variables. Before running this code, ensure the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are set. 
  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 {
    // Copy the source object 'srcobject.txt' to a new destination object 'destobject.txt'. 
    const r = await client.copy('destobject.txt', 'srcobject.txt');
    console.log ('Copied', r);
    // Delete srcobject.txt. 
    const deleteResult = await client.delete('srcobject.txt');
    console.log(deleteResult);
  } catch (e) {
    console.log(e);
  }
}

renameObject();
Remarque

Pour renommer des répertoires, appliquez la même procédure de copie-suppression de manière récursive à tous les objets et sous-répertoires.

Références

Pour plus d'informations sur les opérations API utilisées pour renommer un objet, consultez CopyObject et DeleteObject.