本文介绍初始化时如何使用配置项。
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' });