全部产品
Search
文档中心

对象存储 OSS:PutBucketPublicAccessBlock

更新时间:Apr 28, 2024

调用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 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