Todos os produtos
Search
Central de documentação

Object Storage Service:Excluir um bucket (SDK Node.js)

Última atualização: Sep 22, 2026

Um bucket é um contêiner que armazena objetos. Este tópico descreve como excluir um bucket.

Nota
  • Antes de excluir um bucket, exclua todos os arquivos, LiveChannel s e fragmentos de uploads multipart presentes nele.

  • Se o bucket tiver uploads multipart incompletos, use listUploads e abortMultipartUpload para cancelar os uploads antes de excluir o bucket.

Permissões

Por padrão, uma conta Alibaba Cloud possui permissões completas. Usuários RAM ou roles RAM vinculados a uma conta Alibaba Cloud não possuem nenhuma permissão por padrão. A conta Alibaba Cloud ou o administrador da conta deve conceder permissões de operação por meio de RAM policies ou Bucket Policy.

API

Action

Description

DeleteBucket

oss:DeleteBucket

Exclui um bucket.

Código de exemplo

O código a seguir demonstra como excluir um bucket específico.

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

const client = new OSS({
  // Set region to 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: 'yourregion',
  // Obtain access credentials from environment variables. Before you run the sample code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are configured.
  accessKeyId: process.env.OSS_ACCESS_KEY_ID,
  accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
  authorizationV4: true,
  // Set bucket to the name of your bucket.
  bucket: 'yourBucketName',
});

async function deleteBucket() {
  try {
    // Specify the bucket name.
    const result = await client.deleteBucket('yourbucketname');
    console.log(result);
  } catch (err) {
    console.log(err);
  }
}

deleteBucket();

Referências

  • Para acessar o código de exemplo completo usado para excluir um bucket, consulte GitHub sample.

  • Para mais informações sobre a operação de API que exclui um bucket, consulte DeleteBucket.