全部產品
Search
文件中心

Object Storage Service:PutBucketPublicAccessBlock

更新時間:Jun 19, 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