
# 删除桶
如果桶为空或您不再需要一个桶，可以通过OBS[管理控制台](https://console.huaweicloud.com/console/?locale=zh-cn#/obs/manager/buckets)、API、SDK、OBS Browser+、obsutil方式将其删除，以免占用桶数量配额，同时可以降低存储成本。
#### 注意事项
- 删桶后桶名会释放，释放完成后才能创建同名桶。调用删桶API一般耗时约30分钟释放，如遇特殊情况（例如欠费、销户触发删桶，删桶前需要先进行资源清理）耗时会更长，OBS无法保证此过程的时效性。因此创建同名桶失败，可能是由于桶名未释放完成。另外，如果桶名释放后，有其他用户在您之前抢先使用了桶名，创建同名桶也会失败。
- 删除操作是不可逆的，如果当前桶内数据后续可能需要使用，请提前做好备份以及转换存储类型以节约存储成本。
- 删除桶后，依赖该桶的静态网站托管、CDN等业务也会中断，请谨慎操作。
- 若开启了跨区域复制，删除桶操作可能会同步清除目标桶的数据，请检查配置。
- 删除桶前需要清理彻底清理桶里的对象和碎片，当清理大量对象和碎片时可能产生API请求费用，清理时间依赖于清理对象的数量。
 
#### 约束限制
只有桶的拥有者或拥有**obs:bucket:DeleteBucket** 权限的用户才能删除桶，您可以使用IAM或桶策略进行授权，授权操作请参见[创建IAM自定义策略](https://support.huaweicloud.com/usermanual-iam/iam_01_0605.html)或[自定义创建桶策略](https://support.huaweicloud.com/usermanual-obs/obs_03_0123.html)。
如果您在 IAM 用户或角色策略中拥有**obs:bucket:DeleteBucket** 权限，但无法删除桶，可能是SCP策略或桶策略中对于 **obs:bucket:DeleteBucket** 包含了Deny语句。请先放开**obs:bucket:DeleteBucket**权限，然后再进行删除桶操作。
#### 使用方式
OBS支持通过[管理控制台](https://console.huaweicloud.com/console/?locale=zh-cn#/obs/manager/buckets)、API、SDK、OBS Browser+、obsutil方式删除桶。
#### 步骤一：删除桶内对象与碎片
只有彻底删除桶内对象和碎片后，才能删除桶。
#### 删除未开启多版本控制的对象
**删除对象**
1. 在OBS[管理控制台](https://console.huaweicloud.com/console/?locale=zh-cn#/obs/manager/buckets)左侧导航栏选择"桶列表"。
2. 在桶列表中，单击待操作的桶，进入"对象"页面。
3. 选中待删除的文件或文件夹，并单击右侧的"更多 \> 删除"。 
   图1删除文件或文件夹
   ![](https://support.huaweicloud.com/usermanual-obs/figure/zh-cn_image_0000002313103285.png)
   
   
4. 单击"确定"，确认删除文件或文件夹。 
   图2删除对象
   ![](https://support.huaweicloud.com/usermanual-obs/figure/zh-cn_image_0000002656358291.png "点击放大")
   
   
   
**批量删除对象**
如果需要删除桶中大量文件，或者删除一些周期性的文件，可以通过勾选多个文件，以批量方式删除文件。
1. 在OBS[管理控制台](https://console.huaweicloud.com/console/?locale=zh-cn#/obs/manager/buckets)左侧导航栏选择"桶列表"。
2. 在桶列表中，单击待操作的桶，进入"对象"页面。
3. 根据实际需求情况，勾选全部或需要删除的多个文件或文件夹，单击文件列表上方的"删除"。
4. 单击"确定"，确认删除文件或文件夹。 
   还可以通过生命周期功能，定期自动删除桶中对象，提高删除效率。了解如何结合生命周期删除对象，请参见[结合生命周期](https://support.huaweicloud.com/usermanual-obs/zh-cn_topic_0045829108.html#ZH-CN_TOPIC_0000001919908844__zh-cn_topic_0000001919694178_section1853333182510)。
   
   
 
#### 删除已开启/暂停多版本控制的对象
**删除对象**
1. 在OBS[管理控制台](https://console.huaweicloud.com/console/?locale=zh-cn#/obs/manager/buckets)左侧导航栏选择"桶列表"。
2. 在桶列表中，单击待操作的桶，进入"对象"页面。
3. 启用"历史版本"开关。
4. 勾选需要删除的文件或文件夹，单击搜索栏上方的"彻底删除"。 
   图3彻底删除对象
   ![](https://support.huaweicloud.com/usermanual-obs/figure/zh-cn_image_0000002579793900.png "点击放大")
   
   
5. 单击弹窗中的"确定"，删除对象成功。
**批量删除对象**
1. 在OBS[管理控制台](https://console.huaweicloud.com/console/?locale=zh-cn#/obs/manager/buckets)左侧导航栏选择"桶列表"。
2. 在桶列表中，单击待操作的桶，进入"对象"页面。
3. 启用"历史版本"开关。
4. 根据实际需求情况，勾选全部或需要删除的多个文件或文件夹，单击搜索栏上方的"彻底删除"。
5. 单击弹窗中的"确定"，批量删除对象成功。
 
#### 删除碎片
1. 在OBS[管理控制台](https://console.huaweicloud.com/console/?locale=zh-cn#/obs/manager/buckets)左侧导航栏选择"桶列表"。
2. 在桶列表中，单击待操作的桶，进入"对象"页面。
3. 单击"碎片"，选中需要清理的碎片，单击右侧的"删除"。 
   也可选中多个碎片，单击对象列表上方的"删除"进行批量删除。
   
   
4. 单击"确定"，确认删除碎片。 
   图4删除碎片   
   ![](https://support.huaweicloud.com/usermanual-obs/figure/zh-cn_image_0000001921975292.png "点击放大")
   
   
 
#### 使用生命周期删除桶内对象和碎片
用户可以通过配置生命周期规则，定期删除桶内的对象和碎片。
1. 在OBS[管理控制台](https://console.huaweicloud.com/console/?locale=zh-cn#/obs/manager/buckets)左侧导航栏选择"桶列表"。
2. 在桶列表中，单击待操作的桶，进入"对象"页面。
3. 在左侧导航栏单击"数据管理 \> 生命周期规则"，进入"生命周期规则"界面。
4. 单击"创建"，系统弹出创建生命周期规则对话框。
5. 配置"基本信息"。 
   ![](https://support.huaweicloud.com/usermanual-obs/figure/zh-cn_image_0000002376623857.png "点击放大")
   表1"基本信息"参数说明 
   | 参数名称 | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
   |:---|:---|
   | 状态   | 是否启用生命周期规则。 - 开关开启，启用生命周期规则，受规则影响的对象将在指定天数后转换存储类别/自动删除/删除碎片/清理无历史版本的删除标记。  - 开关关闭，表示不启用生命周期规则。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
   | 规则名称 | 生命周期规则的名称。 命名规则如下： - 长度不超过255个字符。  - 只能由大写或小写的英文字母、数字、英文句号（.）、下划线（_）和连字符（-）组成。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
   | 范围   | 使用对象名称作为筛选条件，明确生命周期规则适用的对象范围。 - 对象前缀：配置对象前缀后，桶内满足该前缀的对象将受生命周期规则管理。  - 所有对象：桶内所有对象都将受生命周期规则管理。   **配置范围时，需要注意多条生命周期规则之间重叠的情况，重叠的规则必须要满足[重叠规则约束](https://support.huaweicloud.com/zh-cn/usermanual-obs/obs_41_0072.html#ZH-CN_TOPIC_0000001972178513__zh-cn_topic_0000001870567984_section139151017133111)，否则将会因规则冲突导致生命周期规则配置失败。**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
   | 前缀   | 当范围选择"对象前缀"时，需配置对象名称前缀，表示桶内满足该前缀的对象将受生命周期规则管理。 对象名前缀规则：不能包括**\<\>**特殊字符。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
   | 标签   | 可选参数。 使用对象标签作为筛选条件，携带该标签的对象将受生命周期规则管理。 - 键名(Key)约束： - 最大长度为128个字符，可用UTF-8格式表示的字母（含中文）、数字、空格，以及以下字符："_ . : = + - @"。  - 区分大小写，存在多条Tag时，Tag的键名(Key)不能重复。  - 不能为空。    - 键值（Value）约束： - 最大长度为255个字符，可用UTF-8格式表示的字母（含中文）、数字、空格，以及以下字符："_ . : /= + - @"。  - 区分大小写。  - 可以为空。     支持最多配置10个标签筛选条件。 **使用对象标签作为筛选条件后，无法启用"碎片过期删除规则设置"和"清理无历史版本的删除标记"。** 关于给对象添加标签，详情请参见[对象标签](https://support.huaweicloud.com/usermanual-obs/obs_41_0054.html#ZH-CN_TOPIC_0000001945056570)。 |
      
   
   
6. 配置"当前版本"和"历史版本"，指定对象最后一次更新后多少天，受规则影响的对象将被自动删除。 
   "历史版本"配置项默认是不展示的，只有当桶开启过"多版本控制"，即多版本控制状态为"已启用"或"暂停"时才会展示。
   图5设置"当前版本"和"历史版本"   
   ![](https://support.huaweicloud.com/usermanual-obs/figure/zh-cn_image_0000002665034457.png "点击放大")
   
   
   
 
#### 步骤二：删除桶
OBS支持通过[管理控制台](https://console.huaweicloud.com/console/?locale=zh-cn#/obs/manager/buckets)、API、SDK、OBS Browser+、obsutil方式删除桶。
#### 使用OBS控制台
1. 在OBS[管理控制台](https://console.huaweicloud.com/console/?locale=zh-cn#/obs/manager/buckets)左侧导航栏选择"桶列表"。
2. 在桶列表中，选择待删除的桶，并单击右侧的"删除"。 
   ![](https://support.huaweicloud.com/usermanual-obs/public_sys-resources/note_3.0-zh-cn.png)
   用户删除桶后，需要等待30分钟才能创建同名桶和并行文件系统。
   
   
3. 单击"确定"，确认删除桶。 
   图6删除桶   
   ![](https://support.huaweicloud.com/usermanual-obs/figure/zh-cn_image_0000002663305885.png "点击放大")
   
   
 
#### 使用API
[删除桶](https://support.huaweicloud.com/api-obs/obs_04_0025.html)
#### 使用SDK
| [Java](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0403.html) | [Python](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0804.html) | [C](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0303.html) | [Go](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0405.html) | [BrowserJS](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0403.html) | [.NET](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0303.html) | [Android](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0303.html) | [iOS](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0303.html) | [PHP](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0303.html) | [Node.js](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0303.html) |
|---|---|---|---|---|---|---|---|---|---|
   
#### 使用图形化工具OBS Browser+
1. 登录OBS Browser+。
2. 选中待删除的桶，单击"删除"。 
   ![](https://support.huaweicloud.com/usermanual-obs/public_sys-resources/note_3.0-zh-cn.png)
   用户删除桶后，需要等待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 | 附加参数，可选 | 运行当前命令时的自定义配置文件。可支持的配置参数请参考[配置参数说明](https://support.huaweicloud.com/utiltg-obs/obs_11_0035.html)。 |
| e      | 附加参数，可选 | 指定终端节点。                                                                                           |
| i      | 附加参数，可选 | 指定用户的AK。                                                                                          |
| k      | 附加参数，可选 | 指定用户的SK。                                                                                          |
| t      | 附加参数，可选 | 指定用户的securitytoken。                                                                               |
   
