调用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 | 是否为指定接入点开启阻止公共访问。
|
响应头
此接口仅包含公共响应头。更多信息,请参见公共响应头(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