本文档介绍如何初始化 Node.js SDK。

创建一个文件app.js并写入如下内容:

let OSS = require('ali-oss');

let client = new OSS({
  region: '<Your region>',
  accessKeyId: '<Your AccessKeyId>',
  accessKeySecret: '<Your AccessKeySecret>'
});

其中region是指您申请 OSS 服务时的区域,例如oss-cn-hangzhou。完整的区域列表请参考访问域名和数据中心

说明 如果使用的 endpoint 不在上述列表中,可以通过以下参数指定 endpoint:
  • internal:配合region使用。如果指定internaltrue,则访问内网节点。
  • secure:配合region使用。如果指定securetrue,则使用 HTTPS 访问。
  • endpoint:如果指定了endpoint,如http://oss-cn-hangzhou.aliyuncs.com,则region会被忽略,endpoint可以指定为 HTTPS,也可以是 IP 的形式。
  • cname: 配合endpoint使用。如果指定cnametrue,则将endpoint视为用户绑定的自定义域名。
  • bucket:如果未指定bucket,则进行 object 相关的操作时需要先调用useBucket接口(仅需要调用一次)。
  • timeout:默认为 60 秒,指定访问 OSS 的 API 的超时时间。