調用PutAccessPointPublicAccessBlock介面為存取點開啟阻止公用訪問 - Object Storage Service

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