管理存储空间访问权限 - 对象存储 OSS

您可以在创建存储空间（Bucket）时设置存储空间的访问权限（ACL），也可以在创建存储空间后根据自己的业务需求修改存储空间的访问权限。本文介绍如何设置和获取存储空间的访问权限。

设置存储空间的访问权限

存储空间的访问权限有以下三类：

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

创建存储空间的同时设置其访问权限

以下代码用于创建存储空间的同时设置其访问权限：

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

const client = new OSS({
  // yourregion填写Bucket所在地域。以华东1（杭州）为例，Region填写为oss-cn-hangzhou。
  region: 'yourregion',
  // 阿里云账号AccessKey拥有所有API的访问权限，风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维，请登录RAM控制台创建RAM用户。
  accessKeyId: 'yourAccessKeyId',
  accessKeySecret: 'yourAccessKeySecret',
  // 填写存储空间名称。
  bucket: 'yourbucketname'
});
// 此处以创建存储空间的同时设置其访问权限为public-read为例。
async function putBucket() {
  const acl = 'public-read';   try {
    await client.putBucket('yourbucketname', { acl });
  } catch (error) {
    console.log(error)
  }
}

putBucket()

创建存储空间后修改其访问权限

以下代码用于创建存储空间后修改其访问权限：

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

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

async function putBucketACL() {
// 此处以创建存储空间后修改其访问权限为private为例。
  const acl = 'private'  
  try {
    await client.putBucketACL('yourbucketname', acl)
  } catch (error) {
    console.log(error)
  }
}

putBucketACL()

获取存储空间的访问权限

以下代码用于获取存储空间的访问权限：

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

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

// 获取存储空间的访问权限。
async function getBucketAcl() {
  const result = await client.getBucketACL('yourbucketname')
  console.log('acl: ', result.acl)
}

getBucketAcl()

设置存储空间的访问权限

获取存储空间的访问权限

相关文档