本文介绍初始化时如何使用配置项。

OSS(options)中的各个配置项说明请参见下表。
配置项 类型 描述
accessKeyId String 通过阿里云控制台创建的AccessKey ID。
accessKeySecret] String 通过阿里云控制台创建的AccessKey Secret。
stsToken String 使用临时授权方式。更多信息,请参见使用STS进行临时授权
bucket String 通过控制台或PutBucket创建的Bucket。
endpoint String OSS访问域名。
region String Bucket所在的区域, 默认值为oss-cn-hangzhou。
internal Boolean 是否使用阿里云内网访问,默认值为false。例如通过ECS访问OSS,则设置internal为true,采用internal的endpoint可节省费用。
cname Boolean 是否支持上传自定义域名,默认值为false。如果设置cname为true,则endpoint传入自定义域名时,自定义域名需要先和Bucket进行绑定。
isRequestPay Boolean Bucket是否开启请求者付费模式,默认值为false。更多信息,请参见请求者付费模式
secure Boolean 设置secure为true,则使用HTTPS;设置secure为false,则使用HTTP。更多信息,请参见常见问题
timeout String|Number 超时时间,默认值为60000,单位为毫秒。

Node.js示例如下:

var oss = require('ali-oss');

var client = new oss({
 // yourRegion填写Bucket所在地域。以华东1(杭州)为例,Region填写为oss-cn-hangzhou。
  region: 'yourRegion',
  // 阿里云账号AccessKey拥有所有API的访问权限,风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维,请登录RAM控制台创建RAM用户。
  accessKeyId: 'yourAccessKeyId',
  accessKeySecret: 'yourAccessKeySecret',
  // 填写Bucket名称。
  bucket: 'examplebucket'
});