首页 对象存储 OSS SDK示例 Node.js 存储空间 管理存储空间访问权限

管理存储空间访问权限

您可以在创建存储空间(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()

相关文档

  • 关于管理存储空间读写权限的完整示例代码,请参见GitHub示例

  • 关于设置存储空间读写权限的API接口说明,请参见PutBucketAcl

  • 关于获取存储空间读写权限的API接口说明,请参见GetBucketAcl

阿里云首页 对象存储 OSS 相关技术圈