普通下载（Harmony SDK）--对象存储-火山引擎

文档中心

立即注册

导航

对象存储

普通下载（Harmony SDK）

最近更新时间：2024.12.23 17:29:49首次发布时间：2024.12.23 17:29:49

通过 getObject 方法可以从指定桶中下载对象。在使用此接口之前，确保拥有对此对象的读访问权限。

注意事项

下载对象前，您必须具有 tos:GetObject 权限，具体操作，请参见权限配置指南。
对于开启多版本的桶，下载指定版本对象时，您必须具有 tos:GetObjectVersion 权限，具体操作，请参见权限配置指南。
如果应用程序会在同一时刻大量下载同一个对象，您的访问速度会受到 TOS 带宽及地域的限制。建议您使用 CDN 产品，提升性能的同时也能降低您的成本。通过 CDN 访问 TOS 的详细信息，请参见使用 CDN 加速访问 TOS 资源。

示例代码

以下代码用于下载桶的对象到内存。

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 bucketName = 'harmony-sdk-test-bucket'; // 目标桶
    const objectName = 'example_dir/example.txt'; // 目标对象
    // 返回 data.content 为 stream
    const res = await client.getObject({
      Bucket: bucketName,
      Key: objectName,
    });

    // 获取返回的 stream 中的所有内容
    const str = buffer.from(res.Content.read(100)).toString()
    res.Content.close();

    console.log('object size:', str.length);
    // 如果对象是一串文字,可以 toString 解析
    console.log('data string:', str);
  } catch (error) {
    handleError(error);
  }
}

main();