# 创建边缘节点组证书 - CreateEdgeGroupCert
#### 功能介绍
创建边缘节点组证书。边缘节点组证书.tar.gz文件仅在调用该API时提供压缩包下载，请及时下载证书文件
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/IEF/doc?api=CreateEdgeGroupCert)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-ief/ief_02_1003.html)。
#### URI
POST /v2/{project_id}/edgemgr/groups/{group_id}/certs
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述      |
|:---|:---|:---|:---|
| project_id | 是    | String | 项目ID    |
| group_id   | 是    | String | 边缘节点组ID |
#### 请求参数
表2请求Header参数 
| 参数              | 是否必选 | 参数类型   | 描述                                                        |
|:---|:---|:---|:---|
| X-Auth-Token    | 是    | String | 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
| ief-instance-id | 否    | String | 企业版实例ID，专业版实例为空值。                                         |
| Content-Type    | 是    | String | 消息体的类型（格式），默认取值为"application/json"。                       |
   
表3请求Body参数 
| 参数          | 是否必选 | 参数类型   | 描述                                                                    |
|:---|:---|:---|:---|
| name        | 否    | String | 证书名称。只允许中文字符、英文字母、数字、下划线、中划线，最大长度64                                   |
| type        | 否    | String | 证书类型，支持填写： - system：创建节点时会默认创建一套系统证书 - application：应用证书 - device：设备证书 |
| description | 否    | String | 证书描述。最大长度为255个字符                                                      |
   
#### 响应参数
**状态码：201**
表4响应Body参数 
| 参数                        | 参数类型    | 描述                                                                                |
|:---|:---|:---|
| id                        | String  | 证书ID                                                                              |
| name                      | String  | 证书名称                                                                              |
| description               | String  | 证书描述                                                                              |
| created_at                | String  | 创建时间                                                                              |
| updated_at                | String  | 更新时间                                                                              |
| group_id                  | String  | 证书绑定的边缘节点组ID                                                                      |
| is_deleted                | Boolean | 证书是否处于删除中                                                                         |
| project_id                | String  | 证书所属账号的项目ID                                                                       |
| type                      | String  | 证书类型，包含： - system：创建节点时会默认创建一套系统证书 - application：应用证书 - device：设备证书               |
| serial_num                | String  | 证书序列号                                                                             |
| ca                        | String  | 根证书                                                                               |
| certificate               | String  | 证书                                                                                |
| private_key               | String  | 私钥                                                                                |
| package                   | String  | 将证书文件certificate/ca/private_key打成.tar.gz包后用base64编码的字符串。 使用时请使用base64解码成.tar.gz包。 |
| cert_remaining_valid_time | Integer | 证书有效期持续时间                                                                         |
   
#### 请求示例
创建边缘节点组证书，证书类型为"应用证书"。
```
{
  "name" : "aa",
  "description" : "",
  "type" : "application"
}
```
#### 响应示例
**状态码：201**
创建成功
```
{
  "created_at" : "2022-11-01 13:42:01.184150966 +0000 UTC",
  "description" : "",
  "id" : "842cda53-4cb4-4a47-9f5e-1c50fdcfcdc4",
  "name" : "aa",
  "updated_at" : "2022-11-01 13:42:01.184150966 +0000 UTC",
  "group_id" : "e4f9c0d6-e1d7-41d5-a108-f38aa8372ffd",
  "is_deleted" : false,
  "package" : "xxx",
  "project_id" : "pid",
  "serial_num" : "",
  "type" : "application",
  "ca" : "xxx",
  "certificate" : "xxx",
  "private_key" : "xxx",
  "cert_remaining_valid_time" : 3652
}
```
#### 状态码
| 状态码 | 描述   |
|:---|:---|
| 201 | 创建成功 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-ief/ErrorCode.html)。