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

Prerequisites

Before you begin, ensure that you have:

• Emptied the bucket of all objects, LiveChannels, and parts from incomplete multipart uploads. To cancel incomplete multipart uploads, use listUploads and abortMultipartUpload

• Granted the oss:DeleteBucket permission to your Alibaba Cloud account or RAM user through a RAM policy or bucket policy

Permissions

Delete a bucket

The following example deletes a specified bucket.

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

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

async function deleteBucket() {
  try {
    const result = await client.deleteBucket('examplebucket');
    console.log('Bucket deleted successfully:', result);
  } catch (err) {
    console.log(err);
  }
}

deleteBucket();

Replace the following placeholders with actual values:

Troubleshooting

If bucket deletion fails, check the following:

• Bucket is not empty: Delete all objects, LiveChannels, and parts from incomplete multipart uploads. Use listUploads to list incomplete multipart uploads and abortMultipartUpload to cancel them.

• Insufficient permissions: Make sure the oss:DeleteBucket action is granted in the RAM policy or bucket policy.

What's next

• For the complete sample code, see the GitHub example.

• For the API reference, see DeleteBucket.