设置Bucket的访问权限

如下代码将Bucket的权限设置为了private：

client.set_bucket_canned_acl(bucket_name, "private")

canned acl支持三种权限，分别为：private、public-read、public-read-write。关于权限的具体内容可以参考《BOS API文档 使用CannedAcl方式的权限控制》。

设置指定用户对Bucket的访问权限

BOS提供set_bucket_acl方法来实现指定用户对Bucket的访问权限设置，可以参考如下代码实现：

acl = [{'grantee' => [{'id' => 'b124deeaf6f641c9ac27700b41a350a8'},
                      {'id' => 'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa'}],
        'permission' => ['FULL_CONTROL']
}]

client.set_bucket_acl(bucket_name, acl)

注意：

1. permission中的权限设置包含三个值：READ、WRITE、FULL_CONTROL，它们分别对应相关权限。具体内容可以参考《BOS API文档 上传ACL文件方式的权限控制》。
2. 设置两个以上（含两个）被授权人时，请参考以上示例的格式，若将数组合并会返回报错。

设置更多Bucket访问权限

1. 通过设置referer白名单方式设置防盗链

   acl = [{'grantee' => [{'id' => 'b124deeaf6f641c9ac27700b41a350a8'},
                         {'id' => 'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa'}],
           'permission' => ['FULL_CONTROL'],
           'condition' => {
               'referer' => {
                   'stringLike' => ['http://www.abc.com/*'],
                   'stringEquals' => ['http://www.abc.com']
                }
           }
   }]
   
   client.set_bucket_acl(bucket_name, acl)

2. 限制客户端IP访问，只允许部分客户端IP访问

   acl = [{'grantee' => [{'id' => 'b124deeaf6f641c9ac27700b41a350a8'},
                         {'id' => 'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa'}],
           'permission' => ['FULL_CONTROL'],
           'condition' => {
               "ipAddress" => [
                     '192.168.0.0/16',
                     '192.169.0.*',
                     '192.170.0.5'
               ]
           }
   }]
   
   client.set_bucket_acl(bucket_name, acl)

设置STS临时token权限

对于通过STS方式创建的临时访问身份，管理员也可进行专门的权限设定。 STS的简介及设置临时权限的方式可参见临时授权访问。

使用BOS Ruby SDK设置STS临时token权限可参考使用STS创建BosClient

查看Bucket的权限

如下代码可以查看Bucket的权限：

client.get_bucket_acl(bucket_name)

get_bucket_acl方法返回的解析类中可供调用的参数有：