文档首页/ 云证书管理服务 CCM/ API参考/ 历史API/ SSL证书管理/ 购买SSL证书
更新时间：2023-10-11 GMT+08:00
查看PDF
分享

购买SSL证书

功能介绍

购买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证书管理