PutBucketHttpsConfig--对象存储-火山引擎

文档中心

立即注册

导航

对象存储

PutBucketHttpsConfig

最近更新时间：2025.07.31 16:41:51首次发布时间：2025.07.31 16:41:51

功能描述

此接口用于开启或关闭 TLS 版本设置功能。

请求消息样式

PUT /?httpsConfig HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
Date: GMT Date
Authorization: authorization string
<Optional Additional Header>

{
    "TLS": {
        "Enable": true,
        "MinTLSVersion": "TLSv1.0",
        "MaxTLSVersion": "TLSv1.2"
    }
}

请求参数和消息头

该请求使用的公共请求消息头，请参见公共参数。

名称	位置	参数类型	是否必选	示例值	说明
httpsConfig	Query	String	是	-	代表 PutBucketHttpsConfig 请求的特殊标识。

请求元素

名称	参数类型	是否必填	示例值	说明
TLS	Object	是	-	TLS 版本规则。
Enable	Boolean	是	true	是否开启 TLS 版本设置功能，取值说明如下： `true`：开启 TLS 版本设置功能。 `false`：关闭 TLS 版本设置功能。
MinTLSVersion	String	否，开启 TLS 版本设置时，必填	TLSv1.0	最小 TLS 版本，取值为 `TLSv1.0`、`TLSv1.1`、`TLSv1.2` 和 `TLSv1.3`。
MaxTLSVersion	String	否，开启 TLS 版本设置时，必填	TLSv1.2	最大 TLS 版本，取值为 `TLSv1.0`、`TLSv1.1`、`TLSv1.2` 和 `TLSv1.3`。

响应消息头

该请求返回的公共响应消息头，请参见公共参数。

响应元素

该请求响应中无消息元素。

请求示例

PUT /?httpsConfig HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
Date: Fri, 30 Jul 2021 08:05:36 +0000
Authorization: authorization string
<Optional Additional Header>

{
    "TLS": {
        "Enable": true,
        "MinTLSVersion": "TLSv1.0",
        "MaxTLSVersion": "TLSv1.2"
    }
}

响应示例

HTTP/1.1 200 OK
Date: Fri, 30 Jul 2021 13:53:55 GMT
Server: TosServer
x-tos-id-2: 1e89f203jld00006-a444fd0
x-tos-request-id: 1e89f203b2d00006-a444ed0