文档首页/ 对象存储服务 OBS/ SDK参考/ PHP/ 桶相关接口/ 阻止桶公共访问（BPA）/ 设置桶的BPA配置
更新时间：2026-07-13 GMT+08:00
查看PDF
分享

设置桶的BPA配置

功能说明

创建或修改OBS桶的PublicAccessBlock配置，以开启或关闭阻止公开访问。

开发过程中，您有任何问题可以在GitHub上提交issue，或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。

接口约束

  • 您必须是桶拥有者或拥有设置桶BPA配置的权限，才能设置桶桶BPA配置。建议使用IAM或桶策略进行授权，如果使用IAM则需授予obs:bucket:PutBucketPublicAccessBlock权限，如果使用桶策略则需授予PutBucketPublicAccessBlock权限。相关授权方式介绍可参见OBS权限控制概述，配置方式详见使用IAM自定义策略、自定义创建桶策略。
  • OBS支持的region以及region与endPoint的对应关系，详细信息请参见地区与终端节点。
  • 如果开启阻止公开访问，则已有的公开访问权限会被忽略，并且不允许配置新的公开访问权限。如果关闭阻止公开访问，则已有的公开访问权限仍然生效，并且支持配置新的公开访问权限。
  • Posix桶新桶默认不开启BPA配置，对象桶新桶默认开启BPA配置。

方法定义

设置桶的BPA配置请求参数说明

表1 请求参数列表

参数名称

参数类型

是否必选

描述

bucketName

String

必选

参数解释：

桶名。

约束限制：

  • 桶的名称需全局唯一，不能与已有的任何桶名称重复，包括其他用户创建的桶。
  • 桶命名规则如下：
    • 3～63个字符，数字或字母开头，支持小写字母、数字、“-”、“.”。
    • 禁止使用IP地址。
    • 禁止以“-”或“.”开头及结尾。
    • 禁止两个“.”相邻（如：“my..bucket”）。
    • 禁止“.”和“-”相邻（如：“my-.bucket”和“my.-bucket”）。
  • 同一用户在同一个区域多次创建同名桶不会报错，创建的桶属性以第一次请求为准。

默认取值：

无

BlockPublicAcls

Boolean

可选

参数解释：

是否锁定公共acl，当该参数为True时，上传对象，设置Public ACL时禁止对象上传，ACL修改API（修改桶ACL、对象ACL），设置Public ACL时禁止ACL修改。

默认取值：

False

IgnorePublicAcls

Boolea

可选

参数解释：

是否忽略公共acl。当该参数为True时，OBS所有OpenAPI进行权限检查时，Public ACL不生效。

默认取值：

False

BlockPublicPolicy

Boolea

可选

参数解释：

是否锁定公共策略。当该参数为True时，桶策略修改API，设置Public Policy时禁止Policy修改。

默认取值：

False

RestrictPublicBuckets

Boolean

可选

参数解释：

是否限制账号访问。当该参数为True时，OBS所有OpenAPI进行权限检查时，如果桶策略状态为公开，则只允许云服务账号和本账号访问。

默认取值：

False

相关文档