You need to enable JavaScript to run this app.
内容分发网络

内容分发网络

请输入
  • 文档首页
    • 内容分发网络API 参考配置操作接口UpdateCdnConfig - 修改加速域名配置HTTPS 配置
复制全文
我的收藏
UpdateCdnConfig - 修改加速域名配置
HTTPS 配置
复制全文
我的收藏
HTTPS 配置

使用限制

节流限制：您每秒最多可以提交 20 个 API 请求。

请求说明

  • 请求方式：POST
  • 请求地址：https://cdn.volcengineapi.com/?Action=UpdateCdnConfig&Version=2021-03-01

公共参数

参数名称
数据类型
是否必选
参数说明
Action
String
是
接口名称。当前 API 的名称为 UpdateCdnConfig。
Version
String
是
接口版本。当前 API 的版本为 2021-03-01。

请求正文参数

HTTPS

参数名称
数据类型
是否必选
参数说明
示例
HTTPS
Object
否
表示 HTTPS 特性的配置。

请求示例

POST https://cdn.volcengineapi.com/?Version=2021-03-01&Action=UpdateCdnConfig
{
    "Domain": "www.example.com",
    "HTTPS": {
        "CertInfo": {
            "CertId": "cert-a80d734dc36b78l6b7d927b386e65ee4"
        },
        "DisableHttp": false,
        "ForcedRedirect": {
            "EnableForcedRedirect": true,
            "StatusCode": "301"
        },
        "HTTP2": true,
        "Switch": true,
        "OCSP": true,
        "TlsVersion": [
            "tlsv1.1",
            "tlsv1.2"
        ],
        "Hsts": {
            "Switch": true,
            "Ttl": 10,
            "Subdomain": "exclude"
        },
        "Keyless": {
            "Switch": true,
            "KeylessServer": "www.example.com:8080",
            "CheckType": "mutual",
            "CertInfoList": [
                {
                    "CertId": "cert_hosting-100969"
                }
            ],
            "ClientCertInfoList": [
                {
                    "CertId": "cert_hosting-79123"
                }
            ]
        }
    }
}

HTTPS 强制跳转到 HTTP 设置

参数名称
数据类型
是否必选
参数说明
示例
HttpForcedRedirect
Object
否

表示 "HTTPS 强制跳转到 HTTP" 特性的配置。

说明

关于 HTTP 重定向至 HTTPS 的配置，参见 HTTPS 下的 ForcedRedirect 特性。HttpForcedRedirect 与 ForcedRedirect 是互斥的。也就是说，如果您配置了其中任意一个特性，就不能配置另一个。

请求示例

POST https://cdn.volcengineapi.com/?Version=2021-03-01&Action=UpdateCdnConfig
{
    "Domain": "www.example.com",
    "HttpForcedRedirect": {
        "EnableForcedRedirect": false,
        "StatusCode": "301"
    }
}

QUIC 设置

参数名称
数据类型
是否必选
参数说明
示例
Quic
Object
否
表示 QUIC 配置。

请求示例

POST https://cdn.volcengineapi.com/?Version=2021-03-01&Action=UpdateCdnConfig
{
    "Domain": "www.example.com",
    "Quic": {
        "Switch": true
    }
}

返回参数

由于该 API 没有响应参数，响应正文只有包含请求元数据的 ResponseMetadata 结构体，没有 Result 结构体。

返回示例 

{
    "ResponseMetadata": {
        "RequestId": "2022010415564801021219713102003D3F",
        "Action": "UpdateCdnConfig",
        "Version": "2021-03-01",
        "Service": "CDN",
        "Region": "cn-north-1"
    }
}

错误码

如果响应正文的 ResponseMetadata 字段中包含 Error 字段，则表示 API 请求失败。更多关于错误码的信息，参见错误码。

最近更新时间：2026.01.30 17:09:41
这个页面对您有帮助吗？
有用
有用
无用
无用