开发过程中，您有任何问题可以在github上提交issue，或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。

您可以在上传对象时设置对象属性。对象属性包含对象长度、对象MIME类型、对象MD5值(用于校验)、对象存储类型、对象自定义元数据。对象属性可以在多种上传方式下(文本上传、流式上传、文件上传、分段上传)，或复制对象时进行设置。

对象属性详细说明见下表：

名称

描述

默认值

对象长度(Content-Length)

上传对象的长度，超过流/文件的长度会截断。

流/文件实际长度

对象MIME类型(Content-Type)

对象的MIME类型，定义对象的类型及网页编码，决定浏览器将以什么形式、什么编码读取对象。

binary/octet-stream

对象MD5值(Content-MD5)

对象数据的MD5值(经过Base64编码)，提供给OBS服务端，校验数据完整性。

无

对象存储类型

对象的存储类型，不同的存储类型可以满足客户业务对存储性能、成本的不同诉求。默认与桶的存储类型保持一致，可以设置为与桶的存储类型不同。

无

对象自定义元数据

用户对上传到桶中对象的自定义属性描述，以便对对象进行自定义管理。

无

设置对象长度// 引入obs库

// 使用npm安装

var ObsClient = require('esdk-obs-nodejs');

// 使用源码安装

// var ObsClient = require('./lib/obs');

// 创建ObsClient实例

var obsClient = new ObsClient({

access_key_id: '*** Provide your Access Key ***',

secret_access_key: '*** Provide your Secret Key ***',

server : 'https://your-endpoint'

});

obsClient.putObject({

Bucket : 'bucketname',

Key : 'objectname',

SourceFile : 'localfile',

ContentLength : 1024 * 1024 // 1MB

}, (err, result) => {

if(err){

console.error('Error-->' + err);

}else{

console.log('Status-->' + result.CommonMsg.Status);

}

});

使用ContentLength参数指定对象长度。

设置对象MIME类型// 引入obs库

// 使用npm安装

var ObsClient = require('esdk-obs-nodejs');

// 使用源码安装

// var ObsClient = require('./lib/obs');

// 创建ObsClient实例

var obsClient = new ObsClient({

access_key_id: '*** Provide your Access Key ***',

secret_access_key: '*** Provide your Secret Key ***',

server : 'https://your-endpoint'

});

// 上传图片

obsClient.putObject({

Bucket : 'bucketname',

Key : 'objectname.jpg',

SourceFile : 'localimage.jpg',

ContentType : 'image/jpeg'

}, (err, result) => {

if(err){

console.error('Error-->' + err);

}else{

console.log('Status-->' + result.CommonMsg.Status);

}

});

使用ContentType参数指定对象MIME类型。

如果不设置对象MIME类型，SDK会根据上传对象的后缀名自动判断对象MIME类型，如.xml判断为application/xml文件；.html判断为text/html文件。

设置对象MD5值// 引入obs库

// 使用npm安装

var ObsClient = require('esdk-obs-nodejs');

// 使用源码安装

// var ObsClient = require('./lib/obs');

// 创建ObsClient实例

var obsClient = new ObsClient({

access_key_id: '*** Provide your Access Key ***',

secret_access_key: '*** Provide your Secret Key ***',

server : 'https://your-endpoint'

});

obsClient.putObject({

Bucket : 'bucketname',

Key : 'objectname',

SourceFile : 'localimage.jpg',

ContentMD5 : 'your md5 which should be encoded by base64'

}, (err, result) => {

if(err){

console.error('Error-->' + err);

}else{

console.log('Status-->' + result.CommonMsg.Status);

}

});

使用ContentMD5参数指定对象MD5值。

对象数据的MD5值必须经过Base64编码。

OBS服务端会将该MD5值与对象数据计算出的MD5值进行对比，如果不匹配则上传失败，返回HTTP 400错误。

如果不设置对象的MD5值，OBS服务端会忽略对对象数据的MD5值校验。

设置对象存储类型// 引入obs库

// 使用npm安装

var ObsClient = require('esdk-obs-nodejs');

// 使用源码安装

// var ObsClient = require('./lib/obs');

// 创建ObsClient实例

var obsClient = new ObsClient({

access_key_id: '*** Provide your Access Key ***',

secret_access_key: '*** Provide your Secret Key ***',

server : 'https://your-endpoint'

});

obsClient.putObject({

Bucket : 'bucketname',

Key : 'objectname',

SourceFile : 'localfile',

// 设置对象存储类型为归档存储

StorageClass : ObsClient.enums.StorageClassCold

}, (err, result) => {

if(err){

console.error('Error-->' + err);

}else{

console.log('Status-->' + result.CommonMsg.Status);

}

});

使用StorageClass参数指定对象的存储类型。

如果不设置，对象的存储类型默认与桶的存储类型保持一致。

对象的存储类型分为三类，其含义与桶存储类型一致。

下载归档存储类型的对象前必须将其取回。

设置对象自定义元数据// 引入obs库

// 使用npm安装

var ObsClient = require('esdk-obs-nodejs');

// 使用源码安装

// var ObsClient = require('./lib/obs');

// 创建ObsClient实例

var obsClient = new ObsClient({

access_key_id: '*** Provide your Access Key ***',

secret_access_key: '*** Provide your Secret Key ***',

server : 'https://your-endpoint'

});

obsClient.putObject({

Bucket : 'bucketname',

Key : 'objectname',

SourceFile : 'localfile',

Metadata : {'property1':'property-value1', 'property2' : 'property-value2'},

}, (err, result) => {

if(err){

console.error('Error-->' + err);

}else{

console.log('Status-->' + result.CommonMsg.Status);

}

});

使用Metadata参数指定对象自定义元数据。

在上面设置对象自定义元数据示例代码中，用户自定义了一个名称为“property1”，值为“property-value1”的元数据和一个名称为“property2”，值为“property-value2”的元数据。

一个对象可以有多个元数据，总大小不能超过8KB。

对象的自定义元数据可以通过ObsClient.getObjectMetadata获取，参见获取对象元数据。

使用ObsClient.getObject下载对象时，对象的自定义元数据也会同时下载。