全部產品
Search
文件中心

Object Storage Service:PutBucketHttpsConfig

更新時間:Jun 19, 2024

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

注意事項

請求文法

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