GetBucketHttpsConfig - Object Storage Service

調用GetBucketHttpsConfig介面查看Bucket的TLS版本以及密碼編譯演算法套件配置。

注意事項

要查看Bucket的TLS版本以及密碼編譯演算法套件配置，您必須有oss:GetBucketHttpsConfig許可權。具體操作，請參見為RAM使用者授予自訂的權限原則。
每個地區都有對應的訪問網域名稱（Endpoint）。關於地區與訪問網域名稱對應關係的更多資訊，請參見訪問網域名稱和資料中心。

請求文法

GET /?httpsConfig HTTP/1.1
Host: BucketName.oss.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

要求標頭

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

回應標頭

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

響應元素

名稱	類型	樣本值	描述
HttpsConfiguration	容器	不涉及	HTTPS配置的容器。
TLS	容器	不涉及	TLS版本配置的容器。
Enable	布爾型	true	Bucket是否開啟TLS版本設定。 true：開啟TLS版本設定。 false：關閉TLS版本設定。
TLSVersion	字串	TLSv1.2	TLS版本號碼。關於TLS版本的適用情境及說明，請參見TLS版本說明。
CipherSuite	容器	不涉及	儲存密碼編譯演算法套件的容器。
Enable	布爾型	true	配置TLS密碼編譯演算法套件。 true：強密碼編譯演算法套件或者自訂密碼編譯演算法套件。 false：全部密碼編譯演算法套件（預設）。
StrongCipherSuite	布爾型	true	是否使用強密碼編譯演算法套件。 true：使用強密碼編譯演算法套件。 false：使用自訂密碼編譯演算法套件。
CustomCipherSuite	字串	ECDHE-ECDSA-AES128-SHA256	TLS 1.2版本的自訂密碼編譯演算法套件。
TLS13CustomCipherSuite	字串	ECDHE-ECDSA-AES256-CCM8	TLS 1.3版本的自訂密碼編譯演算法套件。

樣本

請求樣本

GET /?httpsConfig HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com 
Date: Thu, 17 Apr 2025 08:40:17 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

返回樣本

HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906****
Date: Sat, 8 May 2021 07:51:28 GMT
Connection: keep-alive
Content-Length: 154
Server: AliyunOSS

<?xml version="1.0" encoding="UTF-8"?>
<HttpsConfiguration>
  <TLS>
    <Enable>true</Enable>
    <TLSVersion>TLSv1.2</TLSVersion>
    <TLSVersion>TLSv1.3</TLSVersion>
  </TLS>
  <CipherSuite>
    <Enable>true/false</Enable>
    <StrongCipherSuite>true/false</StrongCipherSuite>
    <CustomCipherSuite>ECDHE-ECDSA-AES128-SHA256</CustomCipherSuite>
    <CustomCipherSuite>ECDHE-RSA-AES128-GCM-SHA256</CustomCipherSuite>
    <CustomCipherSuite>ECDHE-ECDSA-AES256-CCM8</CustomCipherSuite>
    <TLS13CustomCipherSuite>ECDHE-ECDSA-AES256-CCM8</CustomCipherSuite>
    <TLS13CustomCipherSuite>ECDHE-ECDSA-AES256-CCM8</CustomCipherSuite>
    <TLS13CustomCipherSuite>ECDHE-ECDSA-AES256-CCM8</CustomCipherSuite>
  </CipherSuite>
</HttpsConfiguration>

命令列工具ossutil

GetBucketHttpsConfig介面所對應的ossutil命令，請參見get-bucket-https-config。