全部产品
阿里云办公

常见问题

更新时间:2018-07-16 16:20:21

如何调用 STS

浏览器是不受信任的环境,如果把 AccessKeyId 和 AccessKeySecret 直接保存在浏览器端,存在极高的风险。建议在浏览器环境下使用 STS 模式进行 OSS 接口调用。

浏览器中使用 STS Server 相关文档

获取 STS token 后,就可进行 SDK 初始化操作。

  1. <script type="text/javascript">
  2. $.ajax("http://your_sts_server/",{method: 'GET'},function (err, result) {
  3. let client = new OSS({
  4. accessKeyId: result.AccessKeyId,
  5. accessKeySecret: result.AccessKeySecret,
  6. stsToken: result.SecurityToken,
  7. endpoint: '<oss endpoint>',
  8. bucket: '<Your bucket name>'
  9. });
  10. });
  11. </script>

如何 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形式。

浏览器跨域问题如何解决

在浏览器中使用 SDK 前,先要设置 Bucket 的 CORS 属性。具体步骤,请查看相关文档

如何设置上传文件的用户自定义数据(meta),文件类型(mime)和请求头(header)

参考浏览器分片上传

关于浏览器端断点续传的说明

可以将checkpoint保存到浏览器的localstorage,下次再调用的时候传入checkpoint参数,就可以实现断点续传功能。

如何获取上传进度

使用分片上传时,可获取上传进度。相关文档

如何获取下载进度

浏览器中无法获取进度,可调用 signatureUrl 方法,获取下载地址,可查看相关文档

如何上传文件到指定目录

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

  1. let OSS = require('ali-oss')
  2. let client = new OSS({
  3. region: '<Your region>',
  4. accessKeyId: '<Your AccessKeyId>',
  5. accessKeySecret: '<Your AccessKeySecret>',
  6. bucket: 'Your bucket name'
  7. });
  8. client.multipartUpload('base-dir/' +'object-key', 'local-file', {
  9. progress: async function (p) {
  10. console.log('Progress: ' + p);
  11. }
  12. });
  13. console.log(result);
  14. }).catch((err) => {
  15. console.log(err);
  16. });

如何上传base64编码的图片

base64先转码成指定格式图片,然后调用OSS上传接口进行上传,具体可参考Github示例

  1. /**
  2. * base64 to file
  3. * @param dataurl base64 content
  4. * @param filename set up a meaningful suffix, or you can set mime type in options
  5. * @returns {File|*}
  6. */
  7. const dataURLtoFile = function dataURLtoFile(dataurl, filename) {
  8. const arr = dataurl.split(',');
  9. const mime = arr[0].match(/:(.*?);/)[1];
  10. const bstr = atob(arr[1]);
  11. let n = bstr.length;
  12. const u8arr = new Uint8Array(n);
  13. while (n--) {
  14. u8arr[n] = bstr.charCodeAt(n);
  15. }
  16. return new Blob([u8arr], { type: mime });// if env support File, also can use this: return new File([u8arr], filename, { type: mime });
  17. };
  18. // client表示OSS client实例
  19. const uploadBase64Img = function uploadBase64Img(client) {
  20. // base64格式的内容
  21. const base64Content = 'data:image:xxxxxxxxxxxxx';
  22. const filename = 'img.png';
  23. const imgfile = dataURLtoFile(base64Content, filename);
  24. //key表示上传的object key ,imgFile表示dataURLtoFile处理后返回的图片
  25. client.multipartUpload(key, imgfile).then((res) => {
  26. console.log('upload success: %j', res);
  27. }).catch((err) => {
  28. console.error(err);
  29. });
  30. };

如何限制上传文件的大小

在浏览器中可以根据document.getElementById(“file”).files[0].size 获取上传文件的大小(字节数),可参考web直传的post请求。

如何获取object的签名URL

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

如何使用sdk生成的签名URL并进行资源上传

签名URL常用于授权给第三方进行资源的下载和上传操作。下载请参见上一条。sdk中提供signatureUrl API,用于返回一个经过签名的url,用户直接使用这个url上传或者下载资源即可。利用签名URL上传资源请参考sdk工程示例:签名url上传资源示例

如何使用表单上传方式上传资源到OSS服务器

可参考 Web 端直传实践

常见错误参考

本文导读目录