内容分发网络CDN

    增加&修改域名证书

    接口

    如果domain已经绑定了一个证书id,则该接口为修改(将用户新上传的证书替换掉证书库中的老证书,且给domain绑定新证书的id)。 如果domain之前没有绑定证书,则该接口为上传新证书且将新的证书id绑到domain上。

    method path 说明
    PUT /v2/{domain}/certificates 增加or修改domain绑定的certificate

    url参数

    参数 可选 类型 说明
    domain 必选 string 关联目标证书的域名

    请求体

    参数 可选 类型 说明
    httpsEnable 必选 string 只能取值"ON"或者"OFF",表是否开启domain的https支持,“ON”开启,“OFF”关闭
    certificate 必选 certificate 证书内容

    certificate参数说明

    参数 可选 类型 说明
    certName String 必须 证书的名称。长度限制为1-65个字符,以字母开头,只允许包含字母、数字、’-‘、’/’、’.’、’_’、’*’,Java正则表达式 ^[a-zA-Z][a-zA-Z0-9\-/_\.\*]{0,64}$
    certServerData String 必须 服务器证书的数据内容 (Base64编码)
    certPrivateData String 必须 证书的私钥数据内容 (Base64编码)
    certLinkData String 可选 证书链数据内容 (Base64编码)
    certType Integer 可选 证书类型,1:服务端证书(默认) 2:客户端证书

    响应体

    参数 可选 类型 说明
    certId 必选 string 证书入库后的certId

    使用该接口时注意4种500的情况,根据返回的code字段

    1. “unbind old certificate failed”,此时该domain和操作前的状态是一样的(旧的证书没有解绑,没有删除,新的证书也没有入证书库)
    2. "delete old certificate failed",此时该domain和旧的证书解绑了,但是旧的证书还在证书库中,没有删除,新的证书也没有入库
    3. "add new certificate failed",此时该domain和旧的证书解绑了,旧的证书也已经从证书库中删除,但是新的证书没有入库。当前该domain没有绑定任何证书
    4. "bind new certificate failed",此时该domain和旧的证书解绑了,旧的证书也已经从证书库中删除了,新的证书也已经入库,但是新证书和domain绑定失败了。当前该domain没有绑定任何证书

    请求示例

    PUT /v2/www.example.com/certificates
    {
        "httpsEnable": "OFF",
        "certificate": {
            "certName": "test",
            "certServerData": "-----BEGIN CERTIFICATE----END CERTIFICATE-----",
            "certPrivateData": "-----BEGIN RSA PRIVATE KEY----END RSA PRIVATE KEY-----"
        }
    }

    响应示例

    HTTP/1.1 100 Continue
    
    HTTP/1.1 200 OK
    Server: nginx
    Date: Wed, 28 Aug 2019 08:10:51 GMT
    Content-Type: application/json; charset=utf-8
    Transfer-Encoding: chunked
    Connection: keep-alive
    X-Powered-By: PHP/7.1.5
    x-bce-request-id: aa1f2344-711b-8332-3d2e-2849fd123e75
    
    {"certId":"xxx"}
    上一篇
    设置HTTPS加速
    下一篇
    查询域名证书