变更文件存储等级
更新时间：2026-09-23
BOS 支持标准存储、低频存储、冷存储、归档存储等多种存储类型。BOS Python SDK 支持对已有文件变更存储类型，其实现方式是通过 copy_object 拷贝自身，并指定新的 storage_class。
运行以下示例前，请先参考初始化完成 BOS Client 初始化，并将示例中的 bucket_name 等替换为实际值。
变更存储类型时通过 storage_class 参数指定目标存储类型，baidubce.services.bos.storage_class 模块提供的常量如下：
| 存储类型 | 常量 |
|---|---|
| 标准存储 | STANDARD |
| 低频存储 | STANDARD_IA |
| 冷存储 | COLD |
| 归档存储 | ARCHIVE |
| 多 AZ 标准存储 | MAZ_STANDARD |
| 多 AZ 低频存储 | MAZ_STANDARD_IA |
| 多 AZ 冷存储 | MAZ_COLD |
注意： 若源 Object 为归档（
ARCHIVE）类型，需先调用restore_object取回归档文件，取回完成后才能变更其存储类型。
Python
1from baidubce.services.bos import storage_class
2
3# 标准存储转为低频存储（拷贝自身并指定新的 storage_class）
4bos_client.copy_object(source_bucket_name, source_key,
5 target_bucket_name, target_key,
6 storage_class=storage_class.STANDARD_IA)
7
8# 低频存储转为冷存储
9bos_client.copy_object(source_bucket_name, source_key,
10 target_bucket_name, target_key,
11 storage_class=storage_class.COLD)方法说明
| 方法 | 返回值 | 说明 |
|---|---|---|
bos_client.copy_object(source_bucket_name, source_key, target_bucket_name, target_key, storage_class=...) |
BceResponse |
通过拷贝变更 Object 的存储类型。 |
评价此篇文章