更新时间:2026-08-28 GMT+08:00
分享

批量复制对象(HarmonyOS SDK)

功能说明

本示例用于将 OBS 对象批量复制到目标桶,支持同桶或跨桶复制。通过对象列表构造源对象到目标对象的映射,利用 Promise.all 分批并发执行 copyObject 请求,每个对象复制完成后实时记录结果。

接口约束

  • 您必须是桶拥有者或拥有复制对象的权限,才能复制对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:PutObject权限(目标桶)与obs:object:GetObject权限(源桶),如果使用桶策略则需授予PutObject权限(目标桶)与GetObject权限(源桶)。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM自定义策略配置对象策略
  • OBS支持的Region与Endpoint的对应关系,详细信息请参见地区与终端节点
  • 源桶与目标桶必须属于同一 Region,跨 Region 复制请使用跨区域复制功能。
  • 单次复制的对象大小不超过 5GB,超过 5GB 的大对象需通过分段上传的复制段接口完成。
  • CopySource 格式为 源桶名/源对象名,如 sourcebucket/sourceobject。若源对象为多版本对象,可通过 CopySourceVersionId 指定版本。
  • 并发数不宜过大,避免占用过多内存与带宽,建议根据设备性能和网络情况设置。

方法定义

本接口为组合调用示例,基于 copyObject 接口实现批量复制。

1
copyObject(input: CopyObjectInput): Response<CopyObjectOutput>

请求参数

本接口为组合调用示例,基于 copyObject 接口实现批量操作,请求参数与 copyObject 接口一致,详细参数说明请参见CopyObjectInput参数表。

代码示例

本示例用于将源桶 sourcebucket 中的多个对象批量复制到目标桶 examplebucket,并发数设置为 3。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
// 引入依赖包
import ObsClient, { CopyObjectInput } 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 → 目标对象Key 映射
const copyMap: Record<string, string> = {
  "src-object1.txt": "dst-object1.txt",
  "src-object2.txt": "dst-object2.txt",
  "src-object3.txt": "dst-object3.txt",
  "src-object4.txt": "dst-object4.txt",
};

interface CopyResult {
  key: string;
  success: boolean;
  etag?: string;
  error?: string;
}

async function batchCopy() {
  const sourceBucket = "sourcebucket";
  const destBucket = "examplebucket";
  const entries = Object.entries(copyMap);
  const concurrentCount = 3;
  const results: CopyResult[] = [];

  for (let i = 0; i < entries.length; i += concurrentCount) {
    const batch = entries.slice(i, i + concurrentCount);
    const batchResults = await Promise.all(
      batch.map(async (entry) => {
        const srcKey = entry[0];
        const dstKey = entry[1];
        try {
          const result = await obsClient.copyObject({
            Bucket: destBucket,
            Key: dstKey,
            CopySource: sourceBucket + "/" + srcKey,
          });
          if (result.CommonMsg.Status < 300) {
            hilog.info(0x0001, 'OBS-Harmony', "Copy success: %s -> %s", srcKey, dstKey);
            return { key: dstKey, success: true, etag: result.InterfaceResult?.ETag } as CopyResult;
          } else {
            hilog.error(0x0001, 'OBS-Harmony', "Copy failed: %s, Status: %d, Code: %s", srcKey, result.CommonMsg.Status, result.CommonMsg.Code);
            return { key: dstKey, success: false, error: result.CommonMsg.Message } as CopyResult;
          }
        } catch (error) {
          const err = error as BusinessError;
          hilog.error(0x0001, 'OBS-Harmony', 'Copy exception: srcKey=%s, dstKey=%s, code=%d, message: %s', srcKey, dstKey, err.code, err.message);
          return { key: dstKey, success: false, error: err.message } as CopyResult;
        }
      })
    );
    results.push(...batchResults);
  }

  const successCount = results.filter(r => r.success).length;
  const failedCount = results.length - successCount;
  hilog.info(0x0001, 'OBS-Harmony', "Batch copy complete: %d/%d success, %d failed", successCount, results.length, failedCount);
}

batchCopy();
      

相关链接

  • 关于批量复制所调用的复制对象的API说明,请参见复制对象
  • 复制对象过程中返回的错误码含义、问题原因及处理措施可参考OBS错误码

相关文档