Bucket回收站
更新时间：2026-09-23
应用场景
为了提高 BOS 数据的可靠性，用户可以通过配置回收站（Bucket Trash）的功能，保证删除后的数据在回收站内继续保留，用于后续对删除数据的找回。用户必须是源 Bucket 的 owner 且拥有 FULL_CONTROL 权限，且是目标 Bucket 的 owner。
注意：
- 进入回收站的文件仍然会继续计费，直到用户彻底删除。对于回收站中的文件，建议用户配置生命周期来删除过期的文件。
- 用户进行覆盖操作时，旧的数据不会进入回收站。
开通回收站
参数说明如下：
| 参数 | 是否必须 | 说明 |
|---|---|---|
trash_dir |
否 | 指定回收站目录名，可选。回收站默认目录为 .trash。 |
若用户想开通 Bucket 回收站并指定回收站目录，则如下代码所示：
运行以下示例前，请先参考初始化完成 BOS Client 初始化，并将示例中的 bucket_name（及其它占位符）替换为实际值。
Python
1response = bos_client.put_bucket_trash(bucket_name, trash_dir=".trash")
2print(response.metadata.bce_request_id)其中，bucket_name 为待开通回收站功能的 Bucket 名称；trash_dir 与请求体中的 trashDir 对应，用于指定回收站目录名。调用成功后，SDK 返回响应对象，可通过 response.metadata.bce_request_id 获取请求 ID。
注意：
- 若之前已开通过回收站功能，再次开通会覆盖原回收站目录名。
- 回收站目录名只能包含字母、数字、中文、下划线（_）、短横线（-）和小数点（.），且长度不超过 1024 个字符。包含
/等其它字符会报错（错误码InvalidTrashDirectoryName）。- 开通了回收站功能的 bucket，删除 object 会回到回收站中（回收站中的 object 的全称是：trashDir + '/' + old object name）。未开通此功能的 bucket，或者开通此功能的 bucket 且删除回收站内的 object 时，会彻底删除。
- 归档类型文件不支持 Bucket Trash 功能，删除归档类型文件时会直接删除。
评价此篇文章