文档首页/ 对象存储服务 OBS/ 用户指南/ 桶管理/ 删除桶
更新时间：2025-09-26 GMT+08:00
查看PDF
分享

删除桶

如果桶为空或您不再需要一个桶，可以通过OBS管理控制台、API、SDK、OBS Browser+、obsutil方式将其删除，以免占用桶数量配额。

桶为空包含两方面含义：

  • 桶内没有任何对象或对象的任何历史版本。
  • 桶内没有任何未合并的多段上传任务，即桶内不存在碎片。

    如果桶已开启多版本特性，请确保所有历史版本和删除标记（删除标记也视作一个历史版本）已删除。

约束与限制

因为OBS桶是全局资源，所以您自有的桶不能重名，您与其他用户的桶也不能重名。删桶后桶名会释放，释放完成后才能创建同名桶。调用删桶API一般耗时约30分钟释放，如遇特殊情况（例如欠费、销户触发删桶，删桶前需要先进行资源清理）耗时会更长，OBS无法保证此过程的时效性。因此创建同名桶失败，可能是由于桶名未释放完成。另外，如果桶名释放后，有其他用户在您之前抢先使用了桶名，创建同名桶也会失败。

前提条件

  • 已彻底删除桶中对象。只有彻底删除对象后，才能删除桶。

    对象、碎片和已删除对象列表中对象都要删除。

  • 只有桶的拥有者才能删除桶。

使用方式

OBS支持通过控制台、API、SDK、OBS Browser+、obsutil方式删除桶。

使用OBS控制台

  1. 在OBS管理控制台左侧导航栏选择“对象存储”。
  2. 在桶列表中，选择待删除的桶，并单击右侧的“删除”。

    用户删除桶后，需要等待30分钟才能创建同名桶和并行文件系统。

  3. 单击“确定”，确认删除桶。

    图1 删除桶

使用API

删除桶

使用SDK

Java

Python

C

Go

BrowserJS

.NET

Android

iOS

PHP

Node.js

使用图形化工具OBS Browser+

  1. 登录OBS Browser+。
  2. 选中待删除的桶，单击“删除”。

    用户删除桶后，需要等待30分钟才能创建同名桶和并行文件系统。

  3. 单击确认框中的“是”后，删除该桶。

使用命令行工具obsutil

命令结构：

  • Windows操作系统 
    obsutil rm obs://bucket [-f] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
  • macOS/Linux操作系统 
    ./obsutil rm obs://bucket [-f] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

运行示例：

  • 以Windows操作系统为例，运行obsutil rm obs://bucket-test，删除bucket-test桶。 
    obsutil rm obs://bucket-test

Start at 2024-09-30 07:58:33.736622 +0000 UTC

Do you want to delete bucket [bucket-test] ? Please input (y/n) to confirm:
y
Delete bucket [bucket-test] successfully!

参数说明：

参数

约束

描述

bucket

必选

桶名。

f

附加参数，可选

强制操作，不进行询问提示。

config

附加参数，可选

运行当前命令时的自定义配置文件，可支持的配置参数请参考配置参数说明。

e

附加参数，可选

指定终端节点。

i

附加参数，可选

指定用户的AK。

k

附加参数，可选

指定用户的SK。

t

附加参数，可选

指定用户的securitytoken。
父主题： 桶管理