You need to enable JavaScript to run this app.
导航
对象存储
  • 文档首页
    • /对象存储/SDK 参考/Harmony/对象接口/拷贝对象/普通拷贝（Harmony SDK）
普通拷贝（Harmony SDK）
最近更新时间：2024.12.23 17:29:48首次发布时间：2024.12.23 17:29:48
我的收藏

通过 copyObject 可以在同一地域的存储桶之间拷贝对象，也可以在同一个存储桶内拷贝对象。复制时可以设置指定新的元数据信息或保持源对象的元数据信息。

注意事项

  • 拷贝文件不支持跨区域的桶间拷贝。
  • 拷贝对象时，账号必须具备源对象的读取权限和目标桶的写入权限。
  • 拷贝对象时，可以保留所有元数据（默认值）或指定新的元数据。但 ACL 并未被保留，而是设置为私有。

示例代码

以下代码展示如何通过 copyObject 从 harmonyos-sdk-test-bucket 桶拷贝 source-test 对象到 harmonyos-sdk-copy-bucket 桶，并将拷贝的对象命名为 copy-test。

import { TosClient, TosClientError, TosServerError } from '@volcengine/tos_harmonyos_sdk';

// 创建客户端
const client = new TosClient({
  accessKeyId: "Provide your ak", 
  accessKeySecret: "Provide your sk", 
  securityToken: 'Provide your securityToken',
  region: "Provide your region", // 填写 Bucket 所在地域。以华北2（北京)为例，"Provide your region" 填写为 cn-beijing。
  endpoint: "Provide your endpoint", // 填写域名地址
});

function handleError(error: Error) {
  if (error instanceof TosClientError) {
    console.log('Client Err Msg:', error.message);
    console.log('Client Err Stack:', error.stack);
  } else if (error instanceof TosServerError) {
    console.log('Request ID:', error.requestId);
    console.log('Response Status Code:', error.statusCode);
    console.log('Response Header:', error.headers);
    console.log('Response Err Code:', error.code);
    console.log('Response Err Msg:', error.message);
  } else {
    console.log('unexpected exception, message: ', error);
  }
}

async function main() {
  try {
    const srcBucket = 'harmonyos-sdk-test-bucket'; // 源桶
    const srcObject = 'source-test'; // 源对象
    const dstBucket = 'harmonyos-sdk-copy-bucket'; // 目标桶
    const dstObject = 'copy-test'; // 目标对象

    // 同一个 Bucket 复制对象，复制对象使用原有的元数据数据
    const res = await client.copyObject({
      Bucket: srcBucket,
      Key: dstObject,
      SrcBucket: srcBucket,
      SrcKey: srcObject,
      MetadataDirective: MetadataDirectiveType.MetadataDirectiveCopy,
    });
    console.log('copy result', res.ETag);
    // 查询拷贝对象信息
    const headResult = await client.headObject({
      Bucket: dstBucket,
      Key: dstObject,
    });
    console.log('headResult', headResult);

    // 复制对象使用指定的元数据信息
    const res2 = await client.copyObject({
      Bucket: dstBucket,
      Key: dstObject,
      SrcBucket: srcBucket,
      SrcKey: srcObject,
      MetadataDirective: MetadataDirectiveType.MetadataDirectiveReplace,
      // 复制时指定对象为低频存储
      SrcVersionID: StorageClassType.StorageClassIa,
      // 复制时指定为私有权限
      ACL: ACLType.ACLPrivate,
    });
    console.log('copy result', res2.ETag);
    // 查询拷贝对象信息
    const headResult2 = await client.headObject({
      Bucket: dstBucket,
      Key: dstObject,
    });
    console.log('headResult', headResult2);
  } catch (error) {
    handleError(error);
  }
}

main();

相关文档

关于普通拷贝的 API 文档，请参见 CopyObject。