Harmony删除存储空间

更新时间:2025-03-28 09:55:45

存储空间(Bucket)是存储对象(Object)的容器。对象都隶属于存储空间。本文介绍如何删除存储空间。

注意事项

  • 关于OSS支持的RegionEndpoint的对应关系,请参见OSS地域和访问域名

  • 删除存储空间之前,必须先删除存储空间下的所有文件、LiveChannel和分片上传产生的碎片。

  • 如果该Bucket下还有未完成的上传请求,则需要通过listUploadsabortMultipartUpload取消请求后才能删除Bucket。

权限说明

阿里云账号默认拥有全部权限。阿里云账号下的RAM用户或RAM角色默认没有任何权限,需要阿里云账号或账号管理员通过RAM PolicyBucket Policy授予操作权限。

API

Action

说明

API

Action

说明

DeleteBucket

oss:DeleteBucket

删除Bucket。

示例代码

以下代码用于删除指定存储空间。

import Client, { RequestError } from '@aliyun/oss';

// 创建OSS客户端实例
const client = new Client({
  // 请替换为STS临时访问凭证的Access Key ID
  accessKeyId: 'yourAccessKeyId',
  // 请替换为STS临时访问凭证的Access Key Secret
  accessKeySecret: 'yourAccessKeySecret',
  // 请替换为STS临时访问凭证的Security Token
  securityToken: 'yourSecurityToken',
  // 填写Bucket所在地域。以华东1(杭州)为例,Region填写为oss-cn-hangzhou
  region: 'oss-cn-hangzhou',
});

// 删除指定的bucket
const deleteBucket = async () => {
  try {
    // 调用deleteBucket方法删除指定的bucket
    const res = await client.deleteBucket({
      bucket: 'yourBucketName' // 替换为你要删除的bucket名称
    });

    // 打印返回结果
    console.log(JSON.stringify(res));
  } catch (err) {
    // 捕获并处理请求错误
    if (err instanceof RequestError) {
      console.log('错误码: ', err.code); // 错误代码,例如"NoSuchBucket"表示bucket不存在
      console.log('错误信息: ', err.message); // 错误描述,提供更详细的错误信息
      console.log('请求ID: ', err.requestId); // 请求的唯一标识,用于排查问题
      console.log('HTTP状态码: ', err.status); // HTTP响应状态码,例如404表示资源未找到
      console.log('错误类别: ', err.ec); // 错误类别,进一步分类错误类型
    } else {
      console.log('未知错误: ', err); // 非RequestError类型的错误,可能是其他异常
    }
  }
};

// 调用函数,删除指定的bucket
deleteBucket();

相关文档

  • 关于删除存储空间的API接口说明,请参见DeleteBucket

  • 本页导读 (1)
  • 注意事项
  • 权限说明
  • 示例代码
  • 相关文档