调用PutAccessPointPublicAccessBlock接口为接入点开启阻止公共访问

调用PutAccessPointPublicAccessBlock接口为接入点开启阻止公共访问。

注意事项

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

请求语法

PUT /?publicAccessBlock&x-oss-access-point-name=ap-01 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）。

请求元素

名称	类型	是否必选	示例值	描述
x-oss-access-point-name	字符串	是	ap-01	填写接入点名称。
PublicAccessBlockConfiguration	容器	是	不涉及	保存阻止公共访问信息的容器。父节点：无子节点：BlockPublicAccess
BlockPublicAccess	布尔值	否	true	是否为指定接入点开启阻止公共访问。 true：开启阻止公共访问。 false（默认值）：关闭阻止公共访问。

响应头

此接口仅包含公共响应头。更多信息，请参见公共响应头（Common Response Headers）。

示例

请求示例

PUT /?publicAccessBlock&x-oss-access-point-name=ap-01 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 qn6q**************:77Dv****************

<?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