文档中心

普通拷贝（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();

对象存储

普通拷贝（Node.js SDK）

注意事项

示例代码

相关文档