Eliminación de archivos (SDK de Node.js) - Object Storage Service

Elimine un solo objeto, varios objetos por nombre, los objetos que coincidan con un prefijo o un directorio completo.

Aviso

Los objetos eliminados no se pueden recuperar. Proceda con precaución.

Eliminar un solo archivo

A continuación se muestra el código para eliminar un objeto llamado exampleobject.txt de un bucket denominado examplebucket:

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

const client = new OSS({
  // Specify the region where the bucket is located. For example, if the bucket is in the China (Hangzhou) region, set Region to oss-cn-hangzhou.
  region: 'oss-cn-hangzhou',
  // Obtain access credentials from environment variables. Before you run this code, make sure that 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 deleteObject() {
  try {
    // Specify the full path of the object. The full path cannot contain the bucket name.
    const result = await client.delete('exampleobject.txt');
    console.log(result);
  } catch (error) {
    console.log(error);
  }
}

deleteObject();

Eliminar archivos por lotes

Es posible eliminar hasta 1,000 objetos a la vez por nombre, por prefijo o por directorio.

La respuesta de una operación de eliminación por lotes se genera en uno de estos dos modos:

Modo detallado (verbose): el cuerpo de la respuesta de OSS incluye el resultado de cada objeto eliminado. Este es el modo predeterminado.
Modo silencioso (quiet): OSS no devuelve un cuerpo de respuesta.

También puede configurar reglas de ciclo de vida para eliminar objetos automáticamente. Para obtener más información, consulte Lifecycle rules based on last modification time.

Delete multiple objects with specified names

El siguiente código elimina varios objetos por nombre:

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

const client = new OSS({
  // Specify the region where the bucket is located. For example, if the bucket is in the China (Hangzhou) region, set Region to oss-cn-hangzhou.
  region: 'oss-cn-hangzhou',
  // Obtain access credentials from environment variables. Before you run this code, make sure that 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 deleteMulti() {
  try {
    // Specify the full paths of the objects to delete and set the response mode to verbose. The full paths cannot contain the bucket name.
    // let result = await client.deleteMulti(['exampleobject-1', 'exampleobject-2', 'testfolder/sampleobject.txt']);
    // console.log(result);
    // Specify the full paths of the objects to delete and set the response mode to quiet. The full paths cannot contain the bucket name.
    const result = await client.deleteMulti(['exampleobject-1', 'exampleobject-2', 'testfolder/sampleobject.txt'], {quiet: true});
    console.log(result);
  } catch (error) {
    console.log(error);
  }
}

deleteMulti();

Delete multiple objects with the specified object name prefix or in the specified directory

Este fragmento de código elimina objetos por prefijo o borra un directorio completo:

Aviso

Si no se especifica el prefijo o se establece en NULL, se eliminan todos los objetos del bucket. Especifique los prefijos con cuidado.

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

const client = new OSS({
  // Specify the region where the bucket is located. For example, if the bucket is in the China (Hangzhou) region, set Region to oss-cn-hangzhou.
  region: 'oss-cn-hangzhou',
  // Obtain access credentials from environment variables. Before you run this code, make sure that 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',
});

// Handle failed requests to prevent promise.all from breaking, and return the failure reason and the failed file name.
async function handleDel(name) {
  try {
    await client.delete(name);
  } catch (error) {
    error.failObjectName = name;
    return error;
  }
}

// Delete multiple files.
async function deletePrefix(prefix) {
  const list = await client.list({
    prefix: prefix,
  });

  list.objects = list.objects || [];
  const result = await Promise.all(list.objects.map((v) => handleDel(v.name)));
  console.log(result);
}
// To delete all objects that have the 'src' prefix, set prefix to 'src'. This deletes files such as 'src_file.txt', the 'src' folder, and all files within the 'src' folder.
deletePrefix('src');
// To delete only the 'src' folder and all files within it, set prefix to 'src/'.
// deletePrefix('src/');

Referencias

Para consultar el código de ejemplo completo sobre cómo eliminar uno o más archivos, visite el ejemplo de GitHub.
Para conocer la referencia de la API sobre la eliminación de un solo archivo, consulte DeleteObject.
Si necesita la referencia de la API para eliminar varios archivos, consulte DeleteMultipleObjects.