# 查询边缘节点组证书列表 - ListEdgeGroupCerts
#### 功能介绍
查询边缘节点组证书列表
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/IEF/doc?api=ListEdgeGroupCerts)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-ief/ief_02_1003.html)。
#### URI
GET /v2/{project_id}/edgemgr/groups/{group_id}/certs
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述      |
|:---|:---|:---|:---|
| project_id | 是    | String | 项目ID    |
| group_id   | 是    | String | 边缘节点组ID |
表2Query参数 
| 参数     | 是否必选 | 参数类型    | 描述                |
|:---|:---|:---|:---|
| limit  | 否    | Integer | 查询返回记录的数量限制       |
| offset | 否    | Integer | 偏移量，表示查询该偏移量后面的记录 |
#### 请求参数
表3请求Header参数 
| 参数              | 是否必选 | 参数类型   | 描述                                                        |
|:---|:---|:---|:---|
| X-Auth-Token    | 是    | String | 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
| ief-instance-id | 否    | String | 企业版实例ID，专业版实例为空值。                                         |
| Content-Type    | 是    | String | 消息体的类型（格式），默认取值为"application/json"。                       |
   
#### 响应参数
**状态码：200**
表4响应Body参数 
| 参数       | 参数类型                                                                                          | 描述           |
|:---|:---|:---|
| \[数组元素\] | Array of [EdgeGroupCertListResp] objects | 边缘节点组证书列表返回体 |
   
 表5EdgeGroupCertListResp 
| 参数         | 参数类型                                                                          | 描述        |
|:---|:---|:---|
| count      | Integer                                                                       | 边缘节点组证书数目 |
| groupcerts | Array of [EdgeGroupCert] objects | 边缘节点证书详情  |
   
 表6EdgeGroupCert 
| 参数                        | 参数类型    | 描述                                                                                |
|:---|:---|:---|
| 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 | 证书有效期持续时间                                                                         |
   
#### 请求示例
无
#### 响应示例
**状态码：200**
查询成功
```
{
  "count" : 1,
  "groupcerts" : [ {
    "created_at" : "2022-08-25 11:04:47.211793039 +0000 UTC",
    "description" : "",
    "id" : "d84da122-9dce-4deb-9959-8bb9d73e0ab5",
    "name" : "group1",
    "updated_at" : "2022-08-25 11:04:47.211793039 +0000 UTC",
    "group_id" : "e4f9c0d6-e1d7-41d5-a108-f38aa8372ffd",
    "is_deleted" : false,
    "package" : "",
    "project_id" : "ed202955e111444e8ced21a1bd75fc59",
    "serial_num" : "",
    "type" : "application",
    "ca" : "",
    "certificate" : "",
    "private_key" : "",
    "cert_remaining_valid_time" : 3584
  } ]
}
```
#### 状态码
| 状态码 | 描述   |
|:---|:---|
| 200 | 查询成功 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-ief/ErrorCode.html)。