2. 初始化¶

2.1. 确定EndPoint¶

EndPoint 是NOS各个区域的地址，目前支持以下形式

EndPoint类型	备注
NOS区域域名地址	使用桶所在的区域的NOS域名地址

2.1.1. NOS区域域名地址¶

进入NOS控制台，在桶的属性中可以查找到当前桶所在的区域及域名，桶的域名的后缀部分为该桶的公网域名，例如:test-logging.nos-eastchina1.126.net中的nos-eastchina1.126.net 为该桶的公网EndPoint。

2.2. 配置秘钥¶

要接入NOS服务，您需要一对有效的AccessKey（包括AccessKeyId与AccessKeySecret）来进行签名验证，开通服务与AccessKey请参考访问控制

在获取到AccessKeyId与AccessKeySecret之后，可以按照以下的步骤进行初始化

2.3. 使用方法¶

2.3.1. 使用步骤¶

1.安装nos-node-sdk模块:

npm install nos-node-sdk

2.引入模块 nos-node-sdk 模块:

var NosClient = require('nos-node-sdk');

3.初始化 NosClient:

var nosclient = new NosClient();
nosclient.setAccessId('您的accessKeyId');
nosclient.setSecretKey('您的accessKeySecret');
nosclient.setEndpoint('建桶时选择的的区域域名');
nosclient.setPort('80');

2.3.2. 使用说明¶

nos-node-sdk提供callback风格的api接口，所有的api都有两个参数，示例如下:

var map = {
    bucket: 'bucketName', //桶名
    key: 'objectName', //对象名
    filepath: 'path' //本地文件路径
};
var cb = function(result) {
    console.log(result);
};

try {
    nosclient.put_file(map, cb);
}
catch(err) {
    console.log("Failed with code:" + err.code);
}

第一个参数是map，不同的接口要求传入的map参数不一样。
第二个参数是回调函数cb，cb中的操作由用户自行定义，在收到响应的时候由sdk自动调用，并传入一个result参数，该参数提供的内容在不同的api中有所不同。用户可以在自定义cb的时候利用该参数获取响应的内容，如uploadid，etag等等。

使用sdk时，用户只需要按照文档要求提供合法的map参数和定义cb，就能方便调用nos接口通过node管理资源。NOS Node SDK主要描述各个api的map参数和cb函数的result参数的内容，并提供使用示例。
当接口调用失败，返回状态码不在[200,400)范围时，sdk会抛出异常，异常包含的信息请参考异常信息