设置HTTPS加速
更新时间：2025-08-21
接口
本接口用于设置HTTPS加速相关选项，属于全量配置接口。
| Method | Path | 说明 |
|---|---|---|
| PUT | /v2/abroad/domain/{domain}/config?https | 配置HTTPS加速 |
domain: CDN加速域名。
请求体（Request Body）
| 参数 | 可选 | 类型 | 说明 |
|---|---|---|---|
| https | 必选 | HTTPSConfig | HTTPS配置信息 |
HTTPSConfig的类型如下：
| 参数 | 可选 | 类型 | 说明 |
|---|---|---|---|
| enabled | 必选 | Bool | 开启HTTPS加速，默认为false，当enabled=false，以下几列字段设置无效 |
| certId | 可选 | String | 当enabled=true时此项为必选，为SSL证书服务返回的证书ID |
| httpRedirect | 可选 | Bool | 为true时将HTTP请求重定向到HTTPS（重定向状态码为301) |
| http2Enabled | 可选 | Bool | 开启HTTP2特性，默认true，当enabled=false此项无效 |
| httpOrigin | 可选 | Bool | 当为true时以HTTP协议回源，默认为false，当enabled=false此项无效 |
响应码 (Http Status Code)
| HTTP Status Code | 说明 |
|---|---|
| 200 | 成功 |
| 400 | 更新失败，参数错误等 |
请求示例1
开启HTTPS，certId为"ssl-82fdaufdsaldsuaow"其他属性遵循默认值。
Text
1PUT /v2/abroad/domain/www.example.com/config?https HTTP/1.1
2Host: cdn.baidubce.com
3Content-Length: 59
4Content-Type: text/json;utf-8
5{
6 "https": {
7 "enabled": true,
8 "certId": "ssl-82fdaufdsaldsuaow"
9 }
10}请求示例2
开启HTTPS，certId为"ssl-82fdaufdsaldsuaow"，将HTTP请求重定向到HTTPS，重定向状态码为301，关闭HTTP2特性, 配置https回源。
Text
1PUT /v2/abroad/domain/www.example.com/config?https HTTP/1.1
2Host: cdn.baidubce.com
3Content-Length: 123
4Content-Type: text/json;utf-8
5{
6 "https":{
7 "enabled":true,
8 "certId":"ssl-82fdaufdsaldsuaow",
9 "httpRedirect":true,
10 "http2Enabled":false,
11 "httpOrigin": false
12 }
13}请求示例3
关闭HTTPS，其他选项无意义。
Text
1PUT /v2/abroad/domain/www.example.com/config?https HTTP/1.1
2Host: cdn.baidubce.com
3Content-Length: 27
4Content-Type: text/json;utf-8
5{
6 "https":{
7 "enabled": false
8 }
9}响应示例
Text
1HTTP/1.1 200 OK
2Server: nginx
3Date: May, 15 May 2020 05:57:29 GMT
4Content-Type: application/json; charset=utf-8
5Transfer-Encoding: chunked
6Connection: keep-alive
7x-bce-request-id: 8a9c4d38-5198-ed4e-b279-272fdde46e4b
8{
9 "status":"RUNNING"
10}