更新时间:2024-02-28 GMT+08:00
追加上传
![](https://support.huaweicloud.com/sdk-nodejs-devg-obs/public_sys-resources/notice_3.0-zh-cn.png)
开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。
追加上传可实现对同一个对象追加数据内容的功能。您可以通过ObsClient.appendObject进行追加上传。示例代码如下:
// 引入obs库 // 使用npm安装 var ObsClient = require('esdk-obs-nodejs'); // 使用源码安装 // var ObsClient = require('./lib/obs'); // 创建ObsClient实例 var obsClient = new ObsClient({ //推荐通过环境变量获取AKSK,这里也可以使用其他外部引入方式传入,如果使用硬编码可能会存在泄露风险。 //您可以登录访问管理控制台获取访问密钥AK/SK,获取方式请参见https://support.huaweicloud.com/usermanual-ca/ca_01_0003.html access_key_id: process.env.ACCESS_KEY_ID, secret_access_key: process.env.SECRET_ACCESS_KEY, server : 'https://your-endpoint' }); // 第一次追加上传,起始位置必须为0 obsClient.appendObject({ Bucket:'bucketname', Key:'objectname', Position : 0, Body : 'Hello OBS' }).then(function(result){ console.log('Status-->' + result.CommonMsg.Status); if(result.CommonMsg.Status < 300 && result.InterfaceResult){ console.log('NextPosition-->' + result.InterfaceResult.NextPosition); } // 第二次追加上传 obsClient.appendObject({ Bucket:'bucketname', Key:'objectname', Position : result.InterfaceResult.NextPosition, Body : 'Hello OBS Again' }, function(err, result2){ if(err){ console.error('Error-->' + err); }else{ console.log('Status-->' + result2.CommonMsg.Status); if(result2.CommonMsg.Status < 300 && result2.InterfaceResult){ console.log('NextPosition-->' + result2.InterfaceResult.NextPosition); } } }); // 通过获取对象属性接口获取下次追加上传的位置 obsClient.getObjectMetadata({ Bucket:'bucketname', Key:'objectname', }).then(function(result3){ console.log('Status-->' + result3.CommonMsg.Status); if(result3.CommonMsg.Status < 300 && result3.InterfaceResult){ console.log('RequestId-->' + result3.InterfaceResult.RequestId); console.log('NextPosition-->' + result3.InterfaceResult.NextPosition); } }).catch(function(err){ console.error('err:' + err); }); }).catch(function(err){ console.error('err:' + err); });
![](https://support.huaweicloud.com/sdk-nodejs-devg-obs/public_sys-resources/note_3.0-zh-cn.png)
- 使用Position参数指定追加上传的位置,且第一次追加上传的位置必须为0。
- ObsClient.putObject上传的对象可覆盖ObsClient.appendObject上传的对象,覆盖后对象变为普通对象,不可再进行追加上传。
- 第一次调用追加上传时,如果已存在同名的普通对象,则会抛出异常(HTTP状态码为409)。
- 追加上传返回的ETag是当次追加数据内容的ETag,不是完整对象的ETag。
- 单次追加上传的内容不能超过5GB,且最多支持10000次追加上传。
- 追加上传成功后,可通过返回结果中InterfaceResult.NextPosition获取下次追加上传的位置;或者通过ObsClient.getObjectMetadata接口获取下次追加上传的位置。
父主题: 上传对象