To prevent exposure of your Volcengine account credentials (namely, AccessKey ID and AccessKey Secret) in browser environments, it is strongly recommended to perform TOS operations using temporary access credentials. For detailed instructions, please refer to Using STS Temporary AK/SK+Token to Access Volcengine TOS.

Endpoint is the access domain name for TOS external services. For information on endpoints supported by TOS, please refer to Access Domain Endpoint.

Before uploading an object, you must have the tos:PutObject permission. For more information, see the Permissions Configuration Guide.

When uploading objects, object names must comply with specific standards. For detailed information, please refer to Object Naming Guidelines.

TOS is a distributed object storage product designed for large-scale data storage, with internal partitions that store object index data. To maximize the throughput when uploading and downloading objects and to reduce the likelihood of hot partitions, please avoid using object names that increase in lexicographical order. For more details, see Performance Optimization.

If an object with the same name already exists in the bucket, the new object will overwrite the existing one. If versioning is enabled for your bucket, the original object will be retained, and a new version number will be generated to identify the newly uploaded object.

Sample Code

The following code is used to upload data to the file exampleobject.txt located in the exampledir directory of examplebucket.

<!DOCTYPE html>​
<html lang="en">​
  <head>​
    <meta charset="UTF-8" />​
    <title>Document</title>​
  </head>​
  <body>​
    <button id="upload">Upload</button>​
    <input id="file" type="file" />​
    <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({​
        region: yourRegion,​
        endpoint: yourEndpoint,​
        accessKeyId: yourAccessKey,​
        accessKeySecret: yourSecretKey,​
        stsToken: yourSecurityToken,​
        bucket: examplebucket,​
      });​
​
      const headers = {​
      };​
​
      async function putObject(data) {​
        try {​
          const result = await client.putObject({​
            key: "exampledir/exampleobject.txt",​
            body: data,​
          });​
          console.log(result);​
        } catch (e) {​
          console.log(e);​
        }​
      }​
​
      const upload = document.getElementById("upload");​
      upload.addEventListener("click", () => {​
        const data = document.getElementById("file").files[0];​
        console.log("data", data);​
​
        putObject(data);​
      });​
    </script>​
  </body>​
</html>​

Last updated: 2025.09.22 18:55:46

Public security network record in Beijing: No. 11010802032137