追加上传

功能说明

对同一个对象追加数据内容。

方法定义

ObsClient.appendObject

请求参数

字段名	类型	约束	说明
Bucket	String	必选	桶名。
Key	String	必选	对象名。
RequestDate	String 或 Date	可选	指定请求时间。说明：当为String类型时，必须符合ISO8601或RFC822规范。
Position	Number	必选	追加上传的位置，第一次追加上传时必须为0。
ACL	String	可选	创建对象时可指定的预定义访问策略。
StorageClass	String	可选	创建对象时可指定的对象的存储类型。
Body	String	可选	待上传对象的内容。
SourceFile	File 或 Blob	可选	待上传的文件（浏览器必须支持FileReader）。
ProgressCallback	Function	可选	获取上传进度的回调函数。说明：该回调函数依次包含三个参数：已上传的字节数、总字节数、已使用的时间（单位：秒）。
Offset	Number	可选	当设置了SourceFile时有效，代表源文件中某一分段的起始偏移大小，默认值为0，单位为字节。
Metadata	Object	可选	待上传对象的自定义元数据。
WebsiteRedirectLocation	String	可选	当桶设置了Website配置，该参数指明对象的重定向地址。
Expires	Number	可选	待上传对象的生命周期，单位：天。
SuccessActionRedirect	String	可选	上传对象成功后的重定向的地址。
ContentType	String	可选	待上传对象的MIME类型，常见的contentType（MIME）列表参见配置、编辑、查看对象元数据。
ContentLength	Number	可选	当设置了SourceFile时有效，代表待上传对象数据的长度。
ContentMD5	String	可选	待上传对象数据的MD5值（经过Base64编码），提供给OBS服务端，校验数据完整性。
SseKms	String	可选	以SSE-KMS方式加密对象，支持的值： kms
SseKmsKey	String	可选	SSE-KMS方式下加密的主密钥ID，可为空。密钥ID获取方法请参见查看密钥。
SseC	String	可选	以SSE-C方式加密对象，支持的值： AES256
SseCKey	Buffer	可选	SSE-C方式下加密的密钥，该密钥需要您自定义，并由256bit的密钥经过base64编码得到。

Body与SourceFile不能同时使用。
当Body与SourceFile都为空时，上传对象的大小为0字节。

返回结果（InterfaceResult）

字段名	类型	说明
RequestId	String	OBS服务端返回的请求ID。
ETag	String	对象的ETag值。
NextPosition	String	下次追加上传的位置。
StorageClass	String	对象的存储类型，当对象存储类型是标准存储时，该值为空。

代码样例

obsClient.appendObject({
       Bucket : 'bucketname',
       Key : 'objectkey',
//     SourceFile : 'localfile',
       Body : 'Hello OBS',
       Position: 0
}, function (err, result) {
       if(err){
              console.error('Error-->' + err);
       }else{
              if(result.CommonMsg.Status < 300){
                     console.log('RequestId-->' + result.InterfaceResult.RequestId);
                     console.log('ETag-->' + result.InterfaceResult.ETag);
                     console.log('NextPosition-->' + result.InterfaceResult.NextPosition);
              }else{
                     console.log('Code-->' + result.CommonMsg.Code);
                     console.log('Message-->' + result.CommonMsg.Message);
              }
       }
});

父主题：对象相关接口

上一篇：上传对象

下一篇：下载对象