全部產品
Search
文件中心

Object Storage Service:PutPublicAccessBlock

更新時間:Apr 26, 2025

調用PutPublicAccessBlock介面為OSS全域開啟阻止公用訪問。

注意事項

  • 阿里雲帳號預設擁有為OSS全域開啟阻止公用訪問的許可權。如果您希望通過RAM使用者或者STS的方式為OSS全域開啟阻止公用訪問,您必須擁有oss:PutPublicAccessBlock許可權。具體操作,請參見RAM Policy常見樣本

  • 如果開啟阻止公用訪問,則已有的公用存取權限會被忽略,且不允許建立新的公用存取權限。如果關閉阻止公用訪問,則已有的公用存取權限仍生效,且支援建立新的公用存取權限。

請求文法

PUT /?publicAccessBlock HTTP/1.1
Date: GMT Date
Content-Length:ContentLength
Content-Type: application/xml
Host: 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

是否開啟阻止公用訪問。

  • true:開啟阻止公用訪問。

  • false(預設值):關閉阻止公用訪問。

回應標頭

此介面僅包含公用回應標頭。更多資訊,請參見公用回應標頭(Common Response Headers)

樣本

  • 請求樣本

    PUT /?publicAccessBlock HTTP/1.1
    Date: Mon, 19 Feb 2024 08:40:17 GMT
    Content-Length:148
    Content-Type: application/xml
    Host: oss-cn-hangzhou.aliyuncs.com
    Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
    
    <?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

SDK

本介面對應的SDK如下:

命令列工具ossutil

PutPublicAccessBlock介面所對應的ossutil命令,請參見put-public-access-block