设置HTTPS加速
更新时间：2025-08-21
接口
本接口用于设置加速域名HTTPS相关的配置，属于全量配置接口。
| Method | Path | 说明 |
|---|---|---|
| PUT | /v2/domain/{domain}/config?https | 设置加速域名HTTPS相关的配置 |
domain: CDN加速域名。
请求体（Request Body）
| 参数 | 可选 | 类型 | 说明 |
|---|---|---|---|
| https | 必选 | HTTPSConfig | HTTPS配置信息 |
HTTPSConfig类型如下：
| 参数 | 可选 | 类型 | 说明 |
|---|---|---|---|
| enabled | 必选 | bool | 是否开启HTTPS加速(服务端HTTPS认证)。默认为false，当enabled=false时以下几行字段设置无效（当certId=""时certId字段是有效的） |
| certId | 可选 | string | 当enabled=true时此项为必选，为SSL证书服务返回的证书ID，当enablae=false且certId=""时解绑domain当前绑定的certId，否则当enabled=false时此项无效 |
| httpRedirect | 可选 | bool | 为true时将HTTP请求重定向到HTTPS（重定向状态码为httpRedirectCode所配置）。默认为false，当enabled=false时此项无效，不可与httpsRedirect同时为true |
| httpRedirectCode | 可选 | int | 重定向状态码。可选值301/302，默认302，当enabled=false此项无效，httpRedirect=false此项无效 |
| httpsRedirect | 可选 | bool | 为true时将HTTPS请求重定向到HTTP（重定向状态码为httpsRedirectCode所配置）。默认为false，当enabled=false时此项无效，不可与httpRedirect同时为true |
| httpsRedirectCode | 可选 | int | 重定向状态码。可选值301/302，默认302，当enabled=false此项无效，httpsRedirect=false此项无效 |
| noRedirectedUAs | 可选 | list<string> | 重定向时，排除包含特定UA的请求。数组元素不能超过10个，当enabled=false时此项无效，httpsRedirect、httpsRedirect有且仅有一个为true时，设置的此项有效（noRedirectedUAs=[]表示清空该项的历史值） |
| http2Enabled | 可选 | bool | 是否开启HTTP2特性。默认true，当enabled=false此项无效 |
| verifyClient | 可选 | bool | 是否开启HTTPS双向认证。默认为false，只有开启了服务端HTTPS认证才可以开启该配置 |
| sslProtocols | 可选 | list<string> | 设置访问TLS版本。默认为支持从TLSv1.0到TLSv1.3的版本，也可以主动设置为"TLSv1.0"、"TLSv1.1"、"TLSv1.2"、"TLSv1.3"四个中的一个或多个，该参数不能为空list，当enabled=false时此项无效，此项一般取默认值，无需设置 |
响应码 (Http Status Code)
| HTTP Status Code | 说明 |
|---|---|
| 200 | 成功 |
| 400 | 更新失败，参数错误等 |
请求示例1
开启HTTPS，certId为"ssl-82fdaufdsaldsuaow"。其他属性遵循默认值，不会将HTTP请求重定向到HTTPS，也不会将HTTPS请求重定向到HTTP，开启HTTP2特性，以HTTP协议回源，支持所有的TLS版本，包括TLSv1.0,TLSv1.1,TLSv1.2和TLSv1.3。
Text
1PUT /v2/domain/myself.baidu.com/config?https HTTP/1.1
2Host: cdn.baidubce.com
3
4{
5 "https": {
6 "enabled": true,
7 "certId": "ssl-82fdaufdsaldsuaow"
8 }
9}请求示例2
开启HTTPS，certId为"ssl-82fdaufdsaldsuaow"，将HTTP请求重定向到HTTPS，重定向状态码为301，关闭HTTP2特性，重定向时，排除包含UA:test1、test2、test3的请求。其他属性遵循默认值，不会将HTTPS请求重定向到HTTP，以HTTP协议回源，支持所有的TLS版本，包括TLSv1.0,TLSv1.1,TLSv1.2和TLSv1.3。
Text
1PUT /v2/domain/myself.baidu.com/config?https HTTP/1.1
2Host: cdn.baidubce.com
3
4{
5 "https":{
6 "enabled":true,
7 "certId":"ssl-82fdaufdsaldsuaow",
8 "httpRedirect":true,
9 "httpRedirectCode":301,
10 "http2Enabled":false,
11 "noRedirectedUAs": [
12 "test1",
13 "test2",
14 "test3"
15 ]
16 }
17}请求示例3
关闭HTTPS，其他选项无意义。
Text
1PUT /v2/domain/myself.baidu.com/config?https HTTP/1.1
2Host: cdn.baidubce.com
3
4{
5 "https":{
6 "enabled": false
7 }
8}响应示例
Text
1HTTP/1.1 200 OK
2Server: nginx/1.16.1
3Date: Tue, 09 May 2023 14:07:12 GMT
4Content-Type: application/json; charset=utf-8
5Transfer-Encoding: chunked
6Connection: keep-alive
7X-Powered-By: PHP/7.1.15
8x-bce-request-id: f9a8ea10-2263-7674-c7c5-b2139756afb6
9
10{
11 "status":"RUNNING"
12}