PutBucketHttpsConfig - Object Storage Service

調用PutBucketHttpsConfig介面為Bucket開啟或關閉TLS版本設定。

注意事項

要為Bucket開啟或關閉TLS版本設定，您必須有oss:PutBucketHttpsConfig許可權。具體操作，請參見為RAM使用者授權自訂的權限原則。
每個地區都有對應的訪問網域名稱（Endpoint）。關於地區與訪問網域名稱對應關係的更多資訊，請參見訪問網域名稱和資料中心。

請求文法

PUT /?httpsConfig HTTP/1.1
Date: GMT Date
Authorization: SignatureValue
Host: BucketName.oss-cn-hangzhou.aliyuncs.com

<?xml version="1.0" encoding="UTF-8"?>
<HttpsConfiguration>  
  <TLS>
    <Enable>true</Enable>   
    <TLSVersion>TLSv1.2</TLSVersion>
    <TLSVersion>TLSv1.3</TLSVersion>
  </TLS>
</HttpsConfiguration>

要求標頭

此介面僅涉及公用要求標頭。更多資訊，請參見公用要求標頭（Common Request Headers）。

請求元素

名稱	類型	是否必選	樣本值	描述
HttpsConfiguration	容器	是	不涉及	HTTPS配置的容器。
TLS	容器	是	不涉及	TLS版本配置的容器。
Enable	布爾型	是	true	是否為Bucket開啟TLS版本設定。取值如下： true：開啟TLS版本設定。 false：關閉TLS版本設定。
TLSVersion	字串	否	TLSv1.2	TLS版本。僅當Enable取值為true時，需要設定TLS版本，取值如下： TLSv1.0 TLSv1.1 TLSv1.2 TLSv1.3 關於TLS版本的適用情境及說明，請參見TLS版本說明。

回應標頭

此介面僅涉及公用回應標頭。更多資訊，請參見公用回應標頭（Common Response Headers）。

樣本

請求樣本

PUT /?httpsConfig HTTP/1.1
Date: Wed, 16 Aug 2023 15:56:37 GMT
Authorization: OSS qn6q**************:77Dv****************
Host: oss-example.oss-cn-hangzhou.aliyuncs.com

<?xml version="1.0" encoding="UTF-8"?>
<HttpsConfiguration>  
  <TLS>
    <Enable>true</Enable>   
    <TLSVersion>TLSv1.2</TLSVersion>
    <TLSVersion>TLSv1.3</TLSVersion>    
  </TLS>
</HttpsConfiguration>

返回樣本

HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906****
Date: Wed, 16 Aug 2023 15:56:37 GMT
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS