调用PutBucketPublicAccessBlock接口为Bucket开启阻止公共访问

调用PutBucketPublicAccessBlock接口为Bucket开启阻止公共访问。

注意事项

阿里云账号默认拥有为Bucket开启阻止公共访问的权限。如果您希望通过RAM用户或者STS的方式为Bucket开启阻止公共访问，您必须拥有oss:PutBucketPublicAccessBlock权限。具体操作，请参见RAM Policy常见示例。
如果开启阻止公共访问，则已有的公共访问权限会被忽略，且不允许创建新的公共访问权限。如果关闭阻止公共访问，则已有的公共访问权限仍然生效，且支持创建新的公共访问权限。

请求语法

PUT /?publicAccessBlock HTTP/1.1
Date: GMT Date
Content-Length：ContentLength
Content-Type: application/xml
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue

<?xml version="1.0" encoding="UTF-8"?>
<PublicAccessBlockConfiguration>
  <BlockPublicAccess>true</BlockPublicAccess>
</PublicAccessBlockConfiguration>

请求头

此接口仅涉及公共请求头。更多信息，请参见公共请求头（Common Request Headers）。

请求元素

名称

类型

是否必选

示例值

描述

PublicAccessBlockConfiguration

容器

是

不涉及

保存阻止公共访问信息的容器。

父节点：无

子节点：BlockPublicAccess

BlockPublicAccess

布尔值

否

true

是否为指定Bucket开启阻止公共访问。

true：开启阻止公共访问。
false（默认值）：关闭阻止公共访问。

示例

请求示例

PUT /?publicAccessBlock HTTP/1.1
Date: Mon, 19 Feb 2024 08:40:17 GMT
Content-Length：148
Content-Type: application/xml
Host: examplebucket.oss-cn-hangzhou.aliyuncs.com
Authorization: OSS qn6qrrqxo2oawuk53otfjbyc:77Dvh5wQgIjWjwO/KyRt8dOP****

<?xml version="1.0" encoding="UTF-8"?>
<PublicAccessBlockConfiguration>
  <BlockPublicAccess>true</BlockPublicAccess>
</PublicAccessBlockConfiguration>

返回示例

HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906****
Date: Mon, 19 Feb 2024 08:40:17 GMT
Server: AliyunOSS