You need to enable JavaScript to run this app.
导航
普通拷贝(Node.js SDK)
最近更新时间:2024.02.26 17:05:19首次发布时间:2023.07.04 15:29:42

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

注意事项

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

示例代码

以下代码展示如何通过 copyObject 从桶 srcBucket 拷贝对象 srcObject 到桶 dstBucket 中的对象 dstObject。

// 导入 SDK, 当 TOS Node.JS SDK 版本小于 2.5.2 请把下方 TosClient 改成 TOS 导入
import { ACLType, MetadataDirectiveType, StorageClassType, TosClient, TosClientError, TosServerError } from '@volcengine/tos-sdk';

// 创建客户端
const client = new TosClient({
  accessKeyId: process.env['TOS_ACCESS_KEY'],
  accessKeySecret: process.env['TOS_SECRET_KEY'],
  region: "Provide your region", // 填写 Bucket 所在地域。以华北2(北京)为例,则 "Provide your region" 填写为 cn-beijing。
  endpoint: "Provide your endpoint", // 填写域名地址
});

function handleError(error) {
  if (error instanceof TosClientError) {
    console.log('Client Err Name:', error.name);
    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 = 'node-sdk-test-bucket'; // 源桶
    const srcObject = 'source-test'; // 源对象
    const dstBucket = 'node-sdk-copy-bucket'; // 目标桶
    const dstObject = 'copy-test'; // 目标对象

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

    // 复制对象使用指定的元数据信息
    const { data: data2 } = await client.copyObject({
      bucket: dstBucket,
      key: dstObject,
      srcBucket,
      srcKey: srcObject,
      metadataDirective: MetadataDirectiveType.MetadataDirectiveReplace,
      // 复制时指定对象为低频存储
      storageClass: StorageClassType.StorageClassIa,
      // 复制时指定为私有权限
      acl: ACLType.ACLPrivate,
      // 复制时设置 meta 元数据
      meta: { key: 'value' },
    });
    console.log('copy result', data2);
    // 查询拷贝对象信息
    const headResult2 = await client.headObject({
      bucket: dstBucket,
      key: dstObject,
    });
    console.log('headResult', headResult2);
  } catch (error) {
    handleError(error);
  }
}

main();

相关文档

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