全部文档
当前文档
最近更新时间：2026-06-03 21:31:44
以下代码用于解冻归档类型文件：
from ks3.connection import Connection
# 金山云主账号 AccessKey 拥有所有API的访问权限，风险很高。
# 强烈建议您创建并使用子账号进行 API 访问或日常运维，请登录 https://uc.console.ksyun.com/pro/iam/#/user/list 创建子账号。
# 通过指定 host(Endpoint)，您可以在指定的地域使用存储空间。
conn = Connection('<yourAccessKeyId>', '<yourAccessKeySecret>', host='<YOUR_REGION_ENDPOINT>')
# 获取存储空间实例
b = conn.get_bucket('<yourBucketName>')
k = b.get_key('<yourKeyName>')
# 对归档Object进行解冻
# 传入解冻天数，进行解冻
k.restore_object(days=3)
有关解冻归档文件的API，请参见Restore Object。
以下代码用于指定解冻优先级（tier）进行解冻：
from ks3.connection import Connection
# 金山云主账号 AccessKey 拥有所有API的访问权限，风险很高。
# 强烈建议您创建并使用子账号进行 API 访问或日常运维，请登录 https://uc.console.ksyun.com/pro/iam/#/user/list 创建子账号。
# 通过指定 host(Endpoint)，您可以在指定的地域使用存储空间。
conn = Connection('<yourAccessKeyId>', '<yourAccessKeySecret>', host='<YOUR_REGION_ENDPOINT>')
b = conn.get_bucket('<yourBucketName>')
k = b.get_key('<yourKeyName>')
# tier 取值：
# Standard：标准解冻（默认）
# Expedited：加急解冻
# Bulk：批量解冻
k.restore_object(days=3, tier='Expedited')仅冷归档（COLD_ARCHIVE）类型支持tier参数。归档（ARCHIVE）类型不支持指定解冻优先级。
不同优先级的解冻耗时不同：Expedited最短，Bulk最长，Standard介于两者之间。
以下代码用于获取归档类型文件的解冻状态信息：
from ks3.connection import Connection
# 金山云主账号 AccessKey 拥有所有API的访问权限，风险很高。
# 强烈建议您创建并使用子账号进行 API 访问或日常运维，请登录 https://uc.console.ksyun.com/pro/iam/#/user/list 创建子账号。
# 通过指定 host(Endpoint)，您可以在指定的地域使用存储空间。
conn = Connection('<yourAccessKeyId>', '<yourAccessKeySecret>', host='<YOUR_REGION_ENDPOINT>')
b = conn.get_bucket('<yourBucketName>')
k = b.get_key('<yourKeyName>', validate=True)
if k is not None:
print(f'是否解冻中: {k.ongoing_restore}')
if k.expiry_date:
# 查看解冻过期时间
print(f'解冻过期时间: {k.expiry_date}')1. ongoing_restore和expiry_date属性在调用get_key时自动填充。如果文件未被解冻过，则这两个属性不存在。
2. 解冻状态通过x-kss-restore响应头返回，格式为ongoing-request="true|false", expiry-date="..."。您可以通过k.ongoing_restore查看解冻是否正在进行，通过k.expiry_date查看解冻过期时间。
纯净模式