JavaScript-SDK之如何实现快速开始-NodeJS?
本文介绍如何在Node.js环境中使用OSS JavaScript SDK来访问OSS服务，包括查看Bucket列表、查看文件列表、上传/下载文件和删除文件。为了方便修改，本文会新建一个app.js，以下功能演示代码都写在这个文件中。
安装SDK
在工作目录安装ali-oss：
npm install ali-oss
使用同步方式
由于SDK基于
ES6开发，使用
Generator Function使用户能够方便地用同步的方式异步的代码，需要配合co使用。具体可参考
这篇博客。使用同步方式还需要安装co：
npm install co
使用异步方式
为了支持callback的使用方式，SDK同时也提供了异步的基于
Promise的接口，使用上类似callback，具体可参考
这篇博客。
下面的文档将以[backcolor=transparent]同步的方式为例。
初始化Client
创建一个文件：app.js并写入下面的内容：
var co = require('co');
var OSS = require('ali-oss');
var client = new OSS({
region: '<Your region>',
accessKeyId: '<Your AccessKeyId>',
accessKeySecret: '<Your AccessKeySecret>'
});
其中region参数是指您申请OSS服务时的区域，例如oss-cn-hangzhou。完整的区域列表可以在
OSS服务节点查看。
[backcolor=transparent]如果所使用的endpoint不在上述列表中，可以通过以下参数指定endpoint：
- internal: 配合region使用，如果指定internal为true，则访问内网节点
- secure: 配合region使用，如果指定了secure为true，则使用HTTPS访问
- endpoint: 例如http://oss-cn-hangzhou.aliyuncs.com，如果指定了endpoint，则region会被忽略，endpoint可以指定HTTPS，也可以是IP形式
- cname: 配合endpoint使用，如果指定了cname为true，则将endpoint视为用户绑定的自定义域名
- bucket: 如果未指定bucket，则进行Object相关的操作时需要先调用useBucket接口（只需要调用一次）
- timeout: 默认为60秒，指定访问OSS的API的超时时间
查看Bucket列表
在app.js末尾添加如下内容，使用listBuckets接口查看Bucket列表：
co(function* () {
var result = yield client.listBuckets();
console.log(result);
}).catch(function (err) {
console.log(err);
});
运行并查看结果：node app.js。
查看文件列表
修改app.js，使用list接口查看文件列表：
co(function* () {
client.useBucket('Your bucket name');
var result = yield client.list({
'max-keys': 5
});
console.log(result);
}).catch(function (err) {
console.log(err);
});
使用node app.js运行并查看结果。
上传一个文件
修改app.js，使用put接口上传一个文件：
co(function* () {
client.useBucket('Your bucket name');
var result = yield client.put('object-key', 'local file');
console.log(result);
}).catch(function (err) {
console.log(err);
});
下载一个文件
修改app.js，使用get接口下载一个文件：
co(function* () {
var result = yield client.get('object-key', 'local file');
console.log(result);
}).catch(function (err) {
console.log(err);
});
删除一个文件
修改app.js，使用delete接口删除一个文件：
co(function* () {
var result = yield client.delete('object-key');
console.log(result);
}).catch(function (err) {
console.log(err);
});
了解更多
版权声明：本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
