文档中心

恢复对象（Python SDK）

最近更新时间：2024.02.04 18:31:06

首次发布时间：2023.08.03 16:36:18

对冷归档对象进行恢复，恢复之后可以通过下载对象接口获取到对象。通过参数可以指定不同的取回方式。

注意事项

第一次调用 restore_object 接口，返回 202。如果文件正在恢复中，再次调用 restore_object 接口，会返回 409 错误。如果对象已完成恢复，再次调用 restore_object 接口会返回 200 OK。
对于开启多版本的桶，可以通过指定 version_id 恢复指定版本的对象，如果未指定 version_id，默认恢复当前对象。

示例代码

以下代码用于恢复对象。

import os
import tos
from tos.enum import TierType
from tos.models2 import RestoreJobParameters

# 从环境变量获取 AK 和 SK 信息。
ak = os.getenv('TOS_ACCESS_KEY')
sk = os.getenv('TOS_SECRET_KEY')
# your endpoint 和 your region 填写 Bucket 所在区域对应的 Endpoint。# 以华北2(北京)为例，your endpoint 填写为 tos-cn-beijing.volces.com，your region 填写为 cn-beijing。
endpoint = "your endpoint"
region = "your region"
bucket_name = "bucket-test"
object_key = "object-test"
try:
    # 创建 TosClientV2 对象，对桶和对象的操作都通过 TosClientV2 实现。
    client = tos.TosClientV2(ak, sk, endpoint, region)
    client.restore_object(bucket=bucket_name, key=key, days=1,
                          restore_job_parameters=RestoreJobParameters(TierType.Tier_Expedited))
except tos.exceptions.TosClientError as e:
    # 操作失败，捕获客户端异常，一般情况为非法请求参数或网络异常。
    print('fail with client error, message:{}, cause: {}'.format(e.message, e.cause))
except tos.exceptions.TosServerError as e:
    # 操作失败，捕获服务端异常，可从返回信息中获取详细错误信息。
    print('fail with server error, code: {}'.format(e.code))
    # request id 可定位具体问题，强烈建议日志中保存。
    print('error with request id: {}'.format(e.request_id))
    print('error with message: {}'.format(e.message))
    print('error with http code: {}'.format(e.status_code))
    print('error with ec: {}'.format(e.ec))
    print('error with request url: {}'.format(e.request_url))
except Exception as e:
    print('fail with unknown error: {}'.format(e))

对象存储

恢复对象（Python SDK）

注意事项

示例代码

相关文档