更新时间:2024-12-19 GMT+08:00
分享

申请证书

功能介绍

申请证书,如证书绑定域名、填写证书申请人的详细信息等。

  • 请求参数“agree_privacy_protection”必须设置为“true”,才能成功提交申请证书的请求。
  • 当前页面API为历史版本API,未来可能停止维护。请使用申请证书

URI

  • URI格式

    POST /v2/{project_id}/scm/cert/{cert_id}/complete

  • 参数说明

    参数

    是否必选

    参数类型

    描述

    project_id

    String

    项目ID。

    cert_id

    String

    证书ID

请求消息

请求参数

参数

是否必选

参数类型

描述

domain

String

该证书绑定的域名。

  • 当购买的证书为“单域名”“泛域名”类型的证书时,请直接填写单域名或泛域名即可。
  • 当购买的证书为“多域名”类型的证书时,需要选择1个域名作为主域名。

示例:www.example.com

sans

String

绑定多域名类型证书的附加域名。

当购买的证书为“多域名”类型的证书,且有可增加附加域名的额度时,才需要设置该值。

多个域名需要以“;”隔开。

示例:www.example.com;www.example1.com;www.example2.com

csr

String

证书CSR串,与域名必须匹配。

company_name

String

公司名称,OV和EV型证书必填。

字符长度为0~63位。

company_unit

String

部门名称,OV和EV型证书非必填。

字符长度为0~63位。

company_province

String

公司所在省份,OV和EV型证书必填。

字符长度为0~63位。

company_city

String

公司所在市区,OV和EV型证书必填。

字符长度为0~63位。

country

String

国家代码。

  • CN:中国
  • US:美国

applicant_name

String

申请人的姓名。

字符长度为0~63位。

applicant_phone

String

申请人的电话号码。

示例:13212345678

applicant_email

String

申请人的邮箱。

示例:example@huawei.com

contact_name

String

技术联系人的姓名。

字符长度为0~63位。

contact_phone

String

技术联系人的电话号码。

示例:13212345678

contact_email

String

技术联系人的邮箱。

示例:example@huawei.com

auto_dns_auth

Boolean

是否将DNS验证信息推送到华为云解析服务。

  • true:推送。
  • false:不推送。

agree_privacy_protection

Boolean

是否同意授权隐私协议。

  • true:同意隐私协议。
  • false:不同意隐私协议。

此处仅能设置为true才能成功申请证书。

domain_method

String

域名验证方式。

  • dns:DV、OV、EV域名证书可选。
  • file:仅IP证书可选。
  • email:OV、EV域名证书可选。

响应消息

响应参数

参数

是否必选

参数类型

描述

request_info

String

请求结果。

示例

如下以补全某张证书的信息为例。

  • 请求样例
    {
        "domain":"www.xzz.com",
        "company_name":"A公司成都分公司",
        "company_province":"四川",
        "company_city":"成都",
        "applicant_name":"A公司",
        "applicant_phone":"132****5678",
        "applicant_email":"999****346@qq.com",
        "csr":"",
        "sans":"",
        "country":"CN",
        "company_unit":"人力部",
        "contact_name":"环境",
        "contact_phone":"135****5678",
        "contact_email":"jk@jk.ff",
        "auto_dns_auth":false,
        "agree_privacy_protection":true
    }
  • 响应样例
    { 
        "request_info":"success"
    }

    { 
       "error_code": "SCM.XXXX",  
       "error_msg": "XXXX"   
     }

状态码

表1描述的是API返回的正常状态码。
表1 状态码

状态码

编码

状态说明

200

OK

请求已成功。

异常状态码,请参见错误码

相关文档