取回归档存储类型文件
更新时间：2022-07-13
取回归档类型文件
用户上传归档文件后，归档文件是处于冰冻状态的，如果要下载归档文件，必须先取回归档存储文件。请求者必须有归档存储文件的读权限，并且归档存储文件处于冰冻状态。
取回归档文件，示例如下：
# 取回归档文件并设置解冻后持续时间为2天
bos_client.restore_object(bucket_name, target_key)| 参数 | 类型 | 说明 | 是否必须 |
|---|---|---|---|
| days | int | 表示解冻后状态的持续时间，要求是数字，单位是天，取值大于0且不超过30即可。默认解冻持续天数是7天,最长30天。 | 否 |
| tier | string | 解冻优先级。可取值范围如下：
|
否 |
判断归档文件是否取回
对于归档存储对象，如果正在取回或已经取回时返回，获取ObjectMetadata时会返回bce_restore。对于正在取回的归档对象bce_restore取值为 ongoing-request="true"；对于已取回的归档对象bce_restore取值为 ongoing-request="false", expiry-date="Wed, 07 Nov 2019 00:00:00 GMT"。其中expiry-date表示对象取回后的失效时间。
示例如下：
response = bos_client.get_object_meta_data(bucket_name, object_key)
if response.metadata.bce_restore is not None:
if response.metadata.bce_restore.find("expiry-date") >= 0:
print("archive object is restored.")
else:
print("archive object is restoring.")
else:
print("archvie object is freezed.")