恢复归档对象

最近更新时间:2026-04-20 14:02:52

我的收藏

简介

本文介绍对象存储 COS 通过鸿蒙 SDK 实现恢复归档对象的示例代码和描述。将归档类型的对象取回访问(POST Object restore)。
API
操作名
操作描述
恢复归档对象
对一个归档存储或深度归档存储类型的对象进行恢复(解冻)以便读取该对象内容。

恢复归档对象

功能说明

对一个归档存储或深度归档存储类型的对象进行恢复(解冻)以便读取该对象内容。

示例代码

// 存储桶名称,由 bucketname-appid 组成,appid 必须填入,可以在 COS 控制台查看存储桶名称。 https://console.cloud.tencent.com/cos5/bucket
let bucket = "examplebucket-1250000000";
//对象在存储桶中的位置标识符,即称对象键(要恢复的对象)
let archiveCosPath = "exampleobject.txt";

let request = new RestoreObjectRequest(bucket, archiveCosPath);
/**
* 对于普通的归档存储和深度归档存储对象,需要指定恢复出的临时副本的有效时长,取值范围为1 - 365,单位为"天"。
* 如果是智能分层归档层或深度归档层对象,不需要指定此参数。
*/
request.days = 1;
/**
* 恢复模式,可选值:
* - Expedited:快速取回模式,恢复任务在1 - 5分钟内可完成(仅归档存储/智能分层归档层)。
* - Standard:标准取回模式,归档存储恢复任务在3 - 5小时内完成,深度归档存储恢复时间为12 - 24小时。
* - Bulk:批量取回模式,归档存储恢复任务在5 - 12小时内完成,深度归档存储恢复时间为24 - 48小时。
*
* 如果不指定恢复模式,默认使用 Standard 标准取回模式恢复。
*/
request.tier = 'Expedited';
try {
let result = await CosXmlBaseService.default().restoreObject(request)
// result 中包括 http headers 等
} catch (e) {
// 异常处理
}