Todos os produtos
Search
Central de documentação

Object Storage Service:Delete a bucket (Node.js SDK)

Última atualização: Jul 03, 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 no bucket.

  • 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 totais. Usuários RAM ou funções RAM vinculados a uma conta Alibaba Cloud não têm permissões por padrão. A conta Alibaba Cloud ou o administrador da conta deve conceder as permissões de operação por meio de políticas do RAM ou Bucket Policy.

API

Ação

Descrição

DeleteBucket

oss:DeleteBucket

Exclui um bucket.

Código de exemplo

O código a seguir apresenta um exemplo de 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 obter o código de exemplo completo usado para excluir um bucket, consulte o exemplo no GitHub.

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