存储空间(Bucket)是存储对象(Object)的容器。对象都隶属于存储空间。本文介绍如何设置和获取存储空间访问权限(ACL)。

设置存储空间访问权限

存储空间的访问权限(ACL)有以下三类:

访问权限 描述 访问权限值
私有 存储空间的拥有者和授权用户有该存储空间内的文件的读写权限,其他用户没有权限操作该存储空间内的文件。 private
公共读 存储空间的拥有者和授权用户有该存储空间内的文件的读写权限,其他用户只有该存储空间内的文件的读权限。请谨慎使用该权限。 public-read
公共读写 所有用户都有该存储空间内的文件的读写权限。请谨慎使用该权限。 public-read-write

更多关于访问权限的内容请参见开发指南中的访问控制

通过putBucketACL设置Bucket的ACL:

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

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

async function putBucketACL() {
  try {
    const result = await client.putBucketACL('bucket name', 'public-read');
    console.log(result);
  } catch (err) {
    console.log(err);
  }
}

putBucketACL();
			

设置存储空间访问权限的更多详情,请参见PutBucketACL

获取存储空间访问权限

通过getBucketACL查看Bucket的ACL:

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

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

async function getBucketACL() {
  try {
    const result = await client.getBucketACL('luozhang002');
    console.log(result);
  } catch (err) {
    console.log(err);
  }
}

getBucketACL();
			

获取存储空间访问权限的更多详情,请参见GetBucketAcl