追加上传（Browser.js SDK）--对象存储-火山引擎

文档中心

立即注册

导航

对象存储

追加上传（Browser.js SDK）

最近更新时间：2024.12.19 16:12:56首次发布时间：2023.07.08 17:33:01

AppendObjectV2 接口用于追加写对象。追加写是指在已上传的对象末尾追加内容。只能对类型为 Appendable 的对象使用此接口。通过直接上传和分片上传创建的对象类型为 Normal。

注意事项

为了避免在浏览器环境中暴露您的火山引擎账号密钥信息（即 AccessKey ID 和 AccessKey Secret），强烈建议您使用临时访问凭证的方式执行 TOS 相关操作，详细说明，请参见使用 STS 临时 AK/SK+Token 访问火山引擎 TOS。
Endpoint 为 TOS 对外服务的访问域名。TOS 支持的 Endpoint 信息，请参见访问域名 Endpoint。
追加上传对象前，您必须具有 tos:PutObject 权限，详细信息，请参见权限配置指南。
上传对象时，对象名必须满足一定规范，详细信息,请参见对象命名规范。
TOS 是面向海量存储设计的分布式对象存储产品，内部分区存储了对象索引数据，为横向扩展您上传对象和下载对象时的最大吞吐量，和减小热点分区的概率，请您避免使用字典序递增的对象命名方式，详细信息,请参见性能优化。
如果桶中已经存在同名对象，则新对象会覆盖已有的对象。桶开启多版本的场景下，则会保留原有对象，生成一个新版本号用于标识新上传的对象。

限制说明

使用 AppendObject 接口时，对象的大小限制说明如下：

追加后的对象大小不能大于 5GiB。
通过 AppendObject 创建的对象进行 PutObject 操作，对象被覆盖且对象类型由 Appendable 变为 Normal。反之通过 PutObject 上传的对象不支持追加写操作。
AppendObject 创建的对象不支持拷贝。
如果对象类型为低频存储或归档闪回存储，则无法使用 AppendObject 接口。
如果您的存储桶处于开启或暂停多版本控制功能的状态下，则无法使用 AppendObject 接口。

示例代码

以下代码用于追加上传对象。

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <title>Document</title>
  </head>
  <body>
    <button id="upload">上传</button>
    <input id="file" type="file" />
    <!-- 导入 SDK 文件 -->
    <script src="https://tos-public.volccdn.com/obj/volc-tos-public/@volcengine/tos-sdk@latest/browser/tos.umd.production.min.js"></script>
    <script type="text/javascript">
      const client = new TOS({
        // yourRegion 填写 Bucket 所在地域。以华北2（北京)为例，yourRegion 填写为 cn-beijing。
        region: yourRegion,
        // 填写 endpoint 名称。
        endpoint: yourEndpoint,
        // 从 STS 服务获取的临时访问密钥（AccessKey ID 和 AccessKey Secret）。
        accessKeyId: yourAccessKey,
        accessKeySecret: yourSecretKey,
        // 从 STS 服务获取的安全令牌（SecurityToken）。
        stsToken: yourSecurityToken,
        // 填写 Bucket 名称。
        bucket: examplebucket,
      });

      const upload = document.getElementById("upload");
      upload.addEventListene r("click", async () => {
        // 从输入框获取 file 对象，例如 <input type="file" id="file" />。
        const data = document.getElementById("file").files[0];
        console.log("data", data);
        // 或者创建并填写 Blob 数据。
        // const data = new Blob(['Hello TOS']);

        await client.appendObject({
          key: "exampledir/exampleobject.txt",
          body: data,
          // 指定追加的位置
          offset: 0,
        });
      });
    </script>
  </body>
</html>