# 购买SSL证书
#### 功能介绍
购买SSL证书。
![](https://support.huaweicloud.com/api-ccm/public_sys-resources/note_3.0-zh-cn.png)
- 请求参数"agree_privacy_protection"必须设置为"true"，才能成功提交购买证书申请。
- 当前页面API为历史版本API，未来可能停止维护。请使用[购买SSL证书](https://support.huaweicloud.com/api-ccm/SubscribeCertificate.html)。
 
#### 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]。 |
   
 表1cert 
| 参数      | 是否必选 | 参数类型   | 描述    |
|:---|:---|:---|:---|
| 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 | 请求已成功。 |
   
异常状态码，请参见[错误码](https://support.huaweicloud.com/api-ccm/scm.html)。