# 批量恢复归档或深度归档存储对象(HarmonyOS SDK)
#### 功能说明
本示例用于批量恢复归档或深度归档存储的对象，使其临时转换为可读状态。通过对象列表指定需要恢复的对象，利用 Promise.all 分批并发执行 restoreObject 请求，可指定恢复速率（Tier）和保留天数（Days）。
#### 接口约束
- 您必须是桶拥有者或拥有恢复归档或深度归档存储对象的权限，才能恢复归档或深度归档存储对象。建议使用IAM或桶策略进行授权，如果使用IAM则需授予obs:object:RestoreObject权限，如果使用桶策略则需授予RestoreObject权限。相关授权方式介绍可参见[OBS权限控制概述](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0001.html)，配置方式详见[使用IAM自定义策略](https://support.huaweicloud.com/usermanual-obs/obs_03_0121.html)、[配置对象策略](https://support.huaweicloud.com/usermanual-obs/obs_03_0075.html)。
- OBS支持的Region与Endpoint的对应关系，详细信息请参见[地区与终端节点](https://developer.huaweicloud.com/endpoint?OBS)。
- 仅归档或深度归档存储的对象需要恢复才能访问，恢复请求提交后对象进入临时恢复状态，恢复完成后可读取。
- Tier 指定恢复速率：Expedited（快速恢复）、Standard（标准恢复），不同速率的恢复时长与计费标准不同。
- Days 指定恢复后对象的保留天数，取值范围为 1\~30，超过保留天数后对象将自动转回归档状态。
- 对已处于恢复状态的对象重复调用 restoreObject 不会叠加保留期，保留期以最近一次成功恢复请求的 Days 为准。
- 并发数不宜过大，避免占用过多内存与带宽，建议根据设备性能和网络情况设置。
 
#### 方法定义
本接口为组合调用示例，基于 restoreObject 接口实现批量恢复。
```
restoreObject(input: RestoreObjectInput): Response<BaseResponseOutput>
```
#### 请求参数
本接口为组合调用示例，基于 restoreObject 接口实现批量操作，请求参数与 restoreObject 接口一致，详细参数说明请参见[RestoreObjectInput](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0417.html#obs_34_0417__table206638398315)参数表。
#### 代码示例
本示例用于批量恢复 examplebucket 桶内的归档对象，恢复速率设置为 Standard（标准恢复），保留天数设置为 7 天，并发数设置为 3。
```
// 引入依赖包
import ObsClient, { RestoreObjectInput, RestoreTierType } from '@obs/esdk-obs-harmony';
import { process } from '@kit.ArkTS';
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
const processManager = new process.ProcessManager();
// 创建ObsClient实例
const obsClient = new ObsClient({
  // 推荐通过环境变量获取AKSK，这里也可以使用其他外部引入方式传入，如果使用硬编码可能会存在泄露风险
  // 您可以登录访问管理控制台获取访问密钥AK/SK，获取方式请参见https://support.huaweicloud.com/usermanual-ca/ca_01_0003.html
  AccessKeyId: processManager.getEnvironmentVar("ACCESS_KEY_ID"),
  SecretAccessKey: processManager.getEnvironmentVar("SECRET_ACCESS_KEY"),
  // 【可选】如果使用临时AK/SK和SecurityToken访问OBS，同样建议您尽量避免使用硬编码，以降低信息泄露风险。您可以通过环境变量获取访问密钥AK/SK，也可以使用其他外部引入方式传入
  // SecurityToken: processManager.getEnvironmentVar("SECURITY_TOKEN"),
  // Server填写Bucket对应的Endpoint, 这里以华北-北京四为例，其他地区请按实际情况填写
  Server: "https://obs.cn-north-4.myhuaweicloud.com",
});
// 需要恢复的归档对象Key列表
const archiveObjectKeys: string[] = [
  "archive-object1.txt",
  "archive-object2.txt",
  "archive-object3.txt",
  "archive-object4.txt",
  "archive-object5.txt",
];
interface RestoreResult {
  key: string;
  success: boolean;
  error?: string;
}
async function batchRestore() {
  const bucket = "examplebucket";
  const days = 7;
  const tier = RestoreTierType.STANDARD;
  const concurrentCount = 3;
  const results: RestoreResult[] = [];
  for (let i = 0; i < archiveObjectKeys.length; i += concurrentCount) {
    const batch = archiveObjectKeys.slice(i, i + concurrentCount);
    const batchResults = await Promise.all(
      batch.map(async (objectKey) => {
        try {
          const params: RestoreObjectInput = {
            Bucket: bucket,
            Key: objectKey,
            Days: days,
            Tier: tier,
          };
          const result = await obsClient.restoreObject(params);
          if (result.CommonMsg.Status < 300) {
            hilog.info(0x0001, 'OBS-Harmony', "Restore request submitted: %s, Status: %d", objectKey, result.CommonMsg.Status);
            return { key: objectKey, success: true } as RestoreResult;
          } else {
            hilog.error(0x0001, 'OBS-Harmony', "Restore failed: %s, Status: %d, Code: %s", objectKey, result.CommonMsg.Status, result.CommonMsg.Code);
            return { key: objectKey, success: false, error: result.CommonMsg.Message } as RestoreResult;
          }
        } catch (error) {
          const err = error as BusinessError;
          hilog.error(0x0001, 'OBS-Harmony', 'Restore exception: %s, code=%d, message: %s', objectKey, err.code, err.message);
          return { key: objectKey, success: false, error: err.message } as RestoreResult;
        }
      })
    );
    results.push(...batchResults);
  }
  const successCount = results.filter(r => r.success).length;
  const failedCount = results.length - successCount;
  hilog.info(0x0001, 'OBS-Harmony', "Batch restore complete: %d/%d success, %d failed", successCount, results.length, failedCount);
}
batchRestore();
```
#### 相关链接
- 关于批量恢复所调用的恢复归档存储对象的API说明，请参见[恢复归档存储对象](https://support.huaweicloud.com/api-obs/obs_04_0087.html)。
- 恢复对象过程中返回的错误码含义、问题原因及处理措施可参考[OBS错误码](https://support.huaweicloud.com/api-obs/obs_04_0115.html#section1)。