常见问题及解答。

如何 HTTPS 访问

初始化 SDK 时,可传入以下几个参数:

  • region: 参数是指您申请 OSS 服务时的区域,例如oss-cn-hangzhou。完整的区域列表可以在 OSS 服务节点查看。
  • internal: 配合region使用,如果指定 internaltrue,则访问内网节点。
  • secure: 配合region使用,如果指定了securetrue,则使用 HTTPS 访问。
  • endpoint: 例如http://oss-cn-hangzhou.aliyuncs.com,如果指定了endpoint,则region会被忽略,endpoint可以指定HTTPS,也可以是IP形式。

如何获取上传进度

使用分片上传时,可获取上传进度。

如何获取下载进度

Node 中可根据下载流的大小来计算进度。

如何上传base64编码的图片

将 Base64 内容转换成 File 对象,在调用接口上传至 OSS 服务器。

 function dataURLtoFile(dataurl, filename) {
    let arr = dataurl.split(','), mime = arr[0].match(/:(.*?);/)[1],
      bstr = atob(arr[1]), n = bstr.length, u8arr = new Uint8Array(n);
    while(n--){
      u8arr[n] = bstr.charCodeAt(n);
    }
    return new File([u8arr], filename, {type:mime});
  }

  let file = dataURLtoFile('<base64 content>', '');

  client.multipartUpload('<oss file name>', file).then( (res)=> {
    console.log(res)
  }).catch((err) => {
    console.log(err)
  });

如何上传文件到指定目录

给要上传的 object 名称前加指定目录前缀即可,可参考OSS 和文件系统对比

let OSS = require('ali-oss')
let client = new OSS({
  region: '<Your region>',
  accessKeyId: '<Your AccessKeyId>',
  accessKeySecret: '<Your AccessKeySecret>',
  bucket: 'Your bucket name'
});

client.multipartUpload('base-dir/' +'object-name', 'local-file', {
    progress: async function (p) {
      console.log('Progress: ' + p);
    }
  });
  console.log(result);
}).then((res) => {
  console.log(res)
}). catch((err) => {
  console.log(err);
});

如何获取object的签名URL

可调用 signatureUrl 方法,获取下载地址,可查看相关文档

常见错误参考