本文导读

展开导读

文档首页/ 云证书管理服务 CCM/ API参考/ 历史API/ SSL证书管理/ 购买SSL证书

购买SSL证书

更新时间：2023-10-11 GMT+08:00

查看PDF

功能介绍

购买SSL证书。

说明：

请求参数“agree_privacy_protection”必须设置为“true”，才能成功提交购买证书申请。

URI

URI格式
 POST /v2/{project_id}/scm/cert/purchase

参数说明

参数	是否必选	参数类型	描述
project_id	是	String	项目ID。

请求消息

请求参数

参数	是否必选	参数类型	描述
cert_brand	是	String	证书品牌。如：GLOBALSIGN
cert_type	是	String	证书类型，取值如下： DV_SSL_CERT DV_SSL_CERT_BASIC EV_SSL_CERT EV_SSL_CERT_PRO OV_SSL_CERT OV_SSL_CERT_PRO
domain_type	是	String	域名类型，取值如下： SINGLE_DOMAIN：单域名类型。 MULTI_DOMAIN：多域名类型。 WILDCARD：泛域名类型。
effective_time	是	Integer	证书有效期（年），取值如下： 1：购买有效期为1年的证书。 2：购买有效期为2年的证书。
domain_numbers	是	Integer	域名数量。当“domain_type”选择的是“SINGLE_DOMAIN”或“WILDCARD”类型的证书时，域名数量取值为“1”。当“domain_type”选择的是“MULTI_DOMAIN”类型的证书时，域名数量取值范围为“2~100”。
order_number	是	Integer	购买的证书数量。取值范围为1~1000。
agree_privacy_protection	是	Boolean	是否同意隐私协议。 true：同意隐私协议。 false：不同意隐私协议。此处仅能设置为true才能成功购买证书。

响应消息

响应参数

参数	是否必选	参数类型	描述
order_id	是	String	订单号。
cert	是	Array of cert objects	证书列表，详情请参见表1。

表1 cert
参数	是否必选	参数类型	描述
cert_id	是	String	证书ID。

示例

如下以购买1张品牌为Globalsign，域名类型为多域名，域名数量为5，有效期为1年的OV证书为例。

请求样例

{ 
 "cert_brand":"GLOBALSIGN", 
 "cert_type":"OV_SSL_CERT ", 
 "domain_type":"MULTI_DOMAIN", 
 "effective_time": 1, 
 "domain_numbers": 5, 
 "order_number": 1, 
 "agree_privacy_protection":true, 
 }

响应样例

{  
"order_id": "CS1803192259ROA8U" 
"cert": [{ 
         "cert_id": "scs1481110651012", 
       }] 
}

或

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

状态码

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

表2 状态码
状态码	编码	状态说明
200	OK	请求已成功。

异常状态码，请参见错误码。

父主题： SSL证书管理

上一篇：SSL证书管理

下一篇：查询证书列表

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消