# 申请证书 #### 功能介绍 申请证书，如证书绑定域名、填写证书申请人的详细信息等。 ![](https://support.huaweicloud.com/api-ccm/public_sys-resources/note_3.0-zh-cn.png) - 请求参数"agree_privacy_protection"必须设置为"true"，才能成功提交申请证书的请求。 - 当前页面API为历史版本API，未来可能停止维护。请使用[申请证书](https://support.huaweicloud.com/api-ccm/ApplyCertificate.html)。 #### 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 | 请求已成功。 | 异常状态码，请参见[错误码](https://support.huaweicloud.com/api-ccm/scm.html)。