抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 快速入门
  • 开发指南
  • 功能服务
  • 行业解决方案
  • 迁移指南
  • API 参考
  • 云函数
  • 云托管
  • 触发器接口开发文档
  • 云数据库
  • 对象存储
  • 客户端SDK接口
  • 对象存储服务端 API
  • 媒资管理OpenApi
  • 配置中心SDK
  • 公共错误码
  • 最佳实践
  • 产品计费
  • 常见问题
  • 产品动态
  • 对象存储服务端 API

    收藏
    我的收藏
    本文将重点介绍对象存储服务端API 的具体使用示例,具体 API 细节可参考https://www.volcengine.com/docs/6349/113480 火山侧对应内容。不同语言在火山侧有对应参考文档,各语言API文档参考链接如下:

    Node js 使用样例

      1.在抖音云站点对象存储站点获取 Access Key ID(简称AK)和Secret Access Key(简称SK)。
      2.点击访问生成密钥,获取对应密钥。
      3.以 Node.js 云函数为例,按照https://www.volcengine.com/docs/6349/113480 指引在云函数中使用@volcengine/tos-sdk 这个 npm 包进行客户端的初始化和上传文件。
    /** * @param params 调用参数,HTTP 请求下为请求体 * @param context 调用上下文 * * @return 函数的返回数据,HTTP 场景下会作为 Response Body * */ let { dySDK } = require("@open-dy/node-server-sdk"); const { TosClient } = require('@volcengine/tos-sdk'); module.exports = async function (params, context) { // 云函数 params、context 使用介绍:云函数Api_开发者平台_抖音开放平台 // 创建客户端 const client = new TosClient({ accessKeyId: 'xxx', accessKeySecret:'xxx', region: "cn-beijing", // 填写 Bucket 所在地域。以华北2(北京)为例,则 "Provide your region" 填写为 cn-beijing。 endpoint: "tos-cn-beijing.volces.com", // 填写域名地址 }); };
      4.可以使用 listClient 获取所有桶,开通对象存储已有一个默认桶。
    const { data } = await client.listBuckets();
      4.可向该桶上传文件内容。
    const objectName = 'example_dir/example.txt'; // 上传对象 await client.putObject({ bucket: 'xxx', key: objectName, body: Buffer.from('hello world'), }); // 查询刚刚上传对象的大小 const { data } = await client.headObject({ bucket: 'xxx', key: objectName, }); // object size: 11 console.log('object size:', data['content-length']); console.log('data', data);
      5.可在抖音云控制台对象存储tab页查看到对应上传内容。
    完整demo如下:
    /** * @param params 调用参数,HTTP 请求下为请求体 * @param context 调用上下文 * * @return 函数的返回数据,HTTP 场景下会作为 Response Body * */ let { dySDK } = require("@open-dy/node-server-sdk"); const { TosClient } = require('@volcengine/tos-sdk'); module.exports = async function (params, context) { // 云函数 params、context 使用介绍:云函数Api_开发者平台_抖音开放平台 // 创建客户端 // 创建客户端 const client = new TosClient({ accessKeyId: 'xxx', accessKeySecret:'xxx', region: "cn-beijing", // 填写 Bucket 所在地域。以华北2(北京)为例,则 "Provide your region" 填写为 cn-beijing。 endpoint: "tos-cn-beijing.volces.com", // 填写域名地址 }); // await client.createBucket({ // bucket: bucketName, // }); // // 列举所有桶,将列举出刚刚创建的桶 const { data: tosInfo } = await client.listBuckets(); console.log('tosInfo', tosInfo); const objectName = 'example_dir/example.txt'; // 上传对象 await client.putObject({ bucket: 'xxx', key: objectName, body: Buffer.from('hello world'), }); // 查询刚刚上传对象的大小 const { data } = await client.headObject({ bucket: 'xxx', key: objectName, }); // object size: 11 console.log('object size:', data['content-length']); console.log('data', data); };

    具体API 说明