对冷归档对象进行恢复,恢复之后可以通过下载对象接口获取到对象。通过参数可以指定不同的取回方式。
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" # 对象名称,例如 example_dir 下的 example_object.txt 文件,则填写为 example_dir/example_object.txt 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))
关于恢复对象接口的详细介绍,请参见 RestoreObject。