Bucket权限管理

更新时间：2026-09-02

设置 Bucket 的访问权限

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

                Python
                
            

                from baidubce.auth.bce_credentials import BceCredentials
from baidubce.bce_client_configuration import BceClientConfiguration
from baidubce.services.bos.bos_client import BosClient
from baidubce.services.bos import canned_acl

access_key_id = 'your-access-key-id'
secret_access_key = 'your-secret-access-key'
endpoint = 'bj.bcebos.com'
bucket_name = 'your-bucket-name'

config = BceClientConfiguration(
    credentials=BceCredentials(access_key_id, secret_access_key),
    endpoint=endpoint
)
bos_client = BosClient(config)

bos_client.set_bucket_canned_acl(bucket_name, canned_acl.PRIVATE)
            

参数说明如下：

参数	必填	说明
`access_key_id`	是	用户的 Access Key ID。示例中请替换为实际值，文档中不应填写真实凭证。
`secret_access_key`	是	用户的 Secret Access Key。示例中请替换为实际值，文档中不应填写真实凭证。
`endpoint`	是	BOS 服务访问域名，例如 `bj.bcebos.com`。
`bucket_name`	是	待设置访问权限的 Bucket 名称。
`canned_acl.PRIVATE`	是	设置 Bucket 为私有读写权限。

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

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

                Python
                
            

                from baidubce.auth.bce_credentials import BceCredentials
from baidubce.bce_client_configuration import BceClientConfiguration
from baidubce.services.bos.bos_client import BosClient

access_key_id = 'your-access-key-id'
secret_access_key = 'your-secret-access-key'
endpoint = 'bj.bcebos.com'
bucket_name = 'your-bucket-name'

config = BceClientConfiguration(
    credentials=BceCredentials(access_key_id, secret_access_key),
    endpoint=endpoint
)
bos_client = BosClient(config)

bos_client.set_bucket_acl(
    bucket_name,
    [{
        'grantee': [
            {'id': 'b124deeaf6f641c9ac27700b41a350a8'},
            {'id': 'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa'}
        ],
        'permission': ['FULL_CONTROL'],
        'resource': ['your-bucket-name/prefix/*']
    }]
)
            

参数说明如下：

参数	必填	说明
`bucket_name`	是	待设置 ACL 的 Bucket 名称。
`grantee`	是	被授权用户列表，列表中的 `id` 为用户 ID。
`permission`	是	授权权限列表，支持 `READ`、`WRITE`、`FULL_CONTROL`。
`resource`	否	ACL 配置项影响的资源范围，例如 `your-bucket-name/prefix/*`。

id 为用户 ID，您可在用户信息中查看。

permission 中的权限设置包含三个值： READ、 WRITE、 FULL_CONTROL，它们分别对应相关权限。具体内容可以参考《BOS API文档上传ACL文件方式的权限控制》。

set_bucket_acl() 的第二个参数acl不需要包含"accessControlList"字段，已经封装到接口中。

设置更多 Bucket 访问权限

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

                Python
                
            

                from baidubce.auth.bce_credentials import BceCredentials
from baidubce.bce_client_configuration import BceClientConfiguration
from baidubce.services.bos.bos_client import BosClient

access_key_id = 'your-access-key-id'
secret_access_key = 'your-secret-access-key'
endpoint = 'bj.bcebos.com'
bucket_name = 'your-bucket-name'

config = BceClientConfiguration(
    credentials=BceCredentials(access_key_id, secret_access_key),
    endpoint=endpoint
)
bos_client = BosClient(config)

my_acl = [{
    'grantee': [{'id': '*'}],
    'permission': ['FULL_CONTROL'],
    'condition': {
        'referer': {
            'stringEquals': ['http://test/index']
        }
    }
}]

bos_client.set_bucket_acl(bucket_name, my_acl)
            

参数说明如下：

参数	必填	说明
`bucket_name`	是	待设置 ACL 的 Bucket 名称。
`my_acl`	是	Bucket ACL 配置列表。
`grantee.id`	是	被授权人 ID，`*` 表示所有用户。
`permission`	是	授权权限列表。
`condition.referer.stringEquals`	是	referer 白名单条件，示例值为 `http://test/index`。

                Python
                
            

                from baidubce.auth.bce_credentials import BceCredentials
from baidubce.bce_client_configuration import BceClientConfiguration
from baidubce.services.bos.bos_client import BosClient

access_key_id = 'your-access-key-id'
secret_access_key = 'your-secret-access-key'
endpoint = 'bj.bcebos.com'
bucket_name = 'your-bucket-name'

config = BceClientConfiguration(
    credentials=BceCredentials(access_key_id, secret_access_key),
    endpoint=endpoint
)
bos_client = BosClient(config)

my_acl = [{
    'grantee': [{'id': '*'}],
    'permission': ['FULL_CONTROL'],
    'condition': {
        'ipAddress': ['192.170.0.6']
    }
}]

bos_client.set_bucket_acl(bucket_name, my_acl)
            

参数说明如下：

参数	必填	说明
`bucket_name`	是	待设置 ACL 的 Bucket 名称。
`my_acl`	是	Bucket ACL 配置列表。
`grantee.id`	是	被授权人 ID，`*` 表示所有用户。
`permission`	是	授权权限列表。
`condition.ipAddress`	是	允许访问的客户端 IP 地址列表。

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

使用 BOS Python SDK 设置 STS 临时 token 权限可参考通过sts方式访问BOS

查看 Bucket 的权限

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

                Python
                
            

                from baidubce.auth.bce_credentials import BceCredentials
from baidubce.bce_client_configuration import BceClientConfiguration
from baidubce.services.bos.bos_client import BosClient

access_key_id = 'your-access-key-id'
secret_access_key = 'your-secret-access-key'
endpoint = 'bj.bcebos.com'
bucket_name = 'your-bucket-name'

config = BceClientConfiguration(
    credentials=BceCredentials(access_key_id, secret_access_key),
    endpoint=endpoint
)
bos_client = BosClient(config)

response = bos_client.get_bucket_acl(bucket_name)

bos_client.set_bucket_acl(bucket_name, response.access_control_list)
            

参数说明如下：

参数	必填	说明
`bucket_name`	是	待查看 ACL 的 Bucket 名称。
`response`	是	`get_bucket_acl` 方法返回的 Bucket ACL 解析结果。
`response.access_control_list`	是	Bucket 的权限列表，可作为 `set_bucket_acl` 的第二个参数传入。

参数	说明
`owner`	Bucket owner 信息。
`owner.id`	Bucket owner 的用户 ID。
`access_control_list`	标识 Bucket 的权限列表。
`access_control_list[].grantee`	标识被授权人。
`access_control_list[].grantee[].id`	被授权人 ID。
`access_control_list[].permission`	标识被授权人的权限。
`access_control_list[].resource`	ACL 配置项所影响的资源。

评价此篇文章

有帮助没帮助

概述

查看Bucket所属的区域

百度智能云

BOS 对象存储

BOS 对象存储

Bucket权限管理

设置 Bucket 的访问权限

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

设置更多 Bucket 访问权限

查看 Bucket 的权限