appendObject 接口用于追加写对象。追加写是指在已上传的对象末尾追加内容。只能对类型为 Appendable 的对象使用此接口。通过直接上传和分片上传创建的对象类型为 Normal。
注意事项
tos:PutObject
权限,具体操作请参见权限配置指南。使用 AppendObject 接口时,对象的大小限制说明如下:
以下代码用于将字符流追加上传到目标桶。
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 = 'node-sdk-test-bucket'; const objectName = 'example_dir/example.txt'; // 上传对象 await client.appendObject({ Bucket: bucketName, Key: objectName, // 将字符串 "Hello TOS" 上传到指定 example_dir 目录下的 example.txt Content: buffer.from('Hello TOS').buffer, Offset: 0, }); // 查询刚刚上传对象的大小 const res = await client.headObject({ Bucket: bucketName, Key: objectName, }); // object size: 9 console.log('object size:', res.ContentLength); } catch (error) { handleError(error); } } main();
关于追加上传的 API 文档,请参见 AppendObject。