查询证书列表
更新时间 2025-12-03 09:38:24
最近更新时间: 2025-12-03 09:38:24
接口功能介绍
查询证书列表。
接口约束
无
URI
GET /v3/api/ssl/cert/list
路径参数 无
Query参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| certId | 否 | String | 证书ID | 123 | |
| certName | 否 | String | 证书名称 | myCert | |
| type | 否 | String | 证书类型 | SERVER | |
| pageNum | 否 | Integer | 分页参数，页索引，默认为1 | 1 | |
| pageSize | 否 | Integer | 分页参数，页大小，默认为10 | 10 |
请求参数
请求头header参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionId | 是 | String | 实例的资源池ID。 | bb9fdb42056f11eda1610242ac110002 |
请求体body参数 无
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 调用结果状态 | ||
| error | String | 错误码 | ||
| message | String | 结果描述 | ||
| returnObj | Object | 返回数据 | returnObj | |
| 表 returnObj |
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| pageNum | Integer | 分页参数，页索引 | 1 | |
| pageSize | Integer | 分页参数，页大小 | 10 | |
| totalCount | Integer | 返回数据条目总数 | 100 | |
| result | Array of Objects | 返回数据列表 | result | |
| 表 result |
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| certId | String | 证书id | 123 | |
| certName | String | 证书名称 | myCert | |
| remark | String | 证书备注 | test | |
| validFrom | String | 证书有效期起始日期 | 2025-01-01 00:00:00 | |
| validEnd | String | 证书有效期结束日期 | 2028-01-01 00:00:00 | |
| uploadTime | String | 证书上传时间 | 2024-01-01 00:00:00 | |
| sn | String | 证书SN序列号 | 123 | |
| certType | String | 证书类型 | SERVER | |
| encryptor | String | 私钥加密类型 | RSA | |
| subject | String | 证书主体 | lollipop.inc |
枚举参数
参数名 certType
| 枚举值 | 类型 | 说明 |
|---|---|---|
| CLIENT_CA | String | 客户端CA证书 |
| SERVER | String | 服务端证书 |
| 参数名 encryptor |
| 枚举值 | 类型 | 说明 |
|---|---|---|
| RSA | String | RSA |
请求示例
请求url
https://mqtt-global.ctapi.ctyun.cn/v3/api/ssl/cert/list
请求头header
{
"regionId":"bb9fdb42056f11eda1610242ac110002"
}
请求体body
无
响应示例
{
"statusCode":800,
"returnObj": {
"pageNum": 1,
"pageSize": 10,
"totalCount": 100,
"result": [
{
"certId": "123",
"certName": "myCert",
"remark": "test",
"validFrom": "2025-01-01 00:00:00",
"validEnd": "2028-01-01 00:00:00",
"uploadTime": "2024-01-01 00:00:00",
"sn": "123",
"certType": "SERVER",
"encryptor": "RSA",
"subject": "lollipop.inc"
}
]
}
}
状态码
请参考 状态码
错误码
请参考 错误码
