調用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版本設定。取值如下:
|
TLSVersion | 字串 | 否 | TLSv1.2 | TLS版本。僅當Enable取值為true時,需要設定TLS版本,取值如下:
關於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