当您不再需要保留某个存储空间（Bucket）时，可将其删除，以免产生额外费用。

警告 Bucket删除后不可恢复，请谨慎操作。

注意事项

  • 本文以华东1（杭州）外网Endpoint为例。如果您希望通过与OSS同地域的其他阿里云产品访问OSS，请使用内网Endpoint。关于OSS支持的Region与Endpoint的对应关系，请参见访问域名和数据中心。
  • 本文以OSS域名新建OSSClient为例。如果您希望通过自定义域名、STS等方式新建OSSClient，请参见Python初始化。
  • 要删除存储空间，您必须有oss:DeleteBucket权限。具体操作，请参见为RAM用户授权自定义的权限策略。

前提条件

  • 已删除Bucket中所有的文件（Object）。
    • 手动删除少量文件的具体操作，请参见删除文件。
    • 如果您的文件数量较多，建议结合生命周期规则进行批量删除。删除大量文件的具体操作，请参见生命周期规则。
    重要

    如果Bucket已开启版本控制，请确保删除Bucket内的所有当前版本和历史版本文件。删除所有版本文件的具体操作，请参见版本控制相关操作。

  • 已删除Bucket中因分片上传或断点续传产生的碎片（Part）。删除碎片的具体操作，请参见管理碎片。
  • 已删除Bucket中所有的Livechannel。删除Livechannel的具体操作，请参见DeleteLiveChannel。

示例代码

以下代码用于删除存储空间examplebucket：

# -*- coding: utf-8 -*-
import oss2

# 阿里云账号AccessKey拥有所有API的访问权限，风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维，请登录RAM控制台创建RAM用户。
auth = oss2.Auth('yourAccessKeyId', 'yourAccessKeySecret')
# yourEndpoint填写Bucket所在地域对应的Endpoint。以华东1（杭州）为例，Endpoint填写为https://oss-cn-hangzhou.aliyuncs.com。
# 填写Bucket名称，例如examplebucket。
bucket = oss2.Bucket(auth, 'https://oss-cn-hangzhou.aliyuncs.com', 'examplebucket')

try:
    # 删除Bucket。
    bucket.delete_bucket()
except oss2.exceptions.BucketNotEmpty:
    print('bucket is not empty.')
except oss2.exceptions.NoSuchBucket:
    print('bucket does not exist')

相关文档

  • 关于删除Bucket的完整示例代码，请参见GitHub示例。
  • 关于删除Bucket的API接口说明，请参见DeleteBucket。