查询uk证书列表
更新时间 2026-03-12 13:57:26
最近更新时间: 2026-03-12 13:57:26
接口功能介绍
查询uk证书列表
接口约束
无
URI
POST /v1/manageCertificate/listCertificateForUk
路径参数 无
Query参数 无
请求参数
请求头header参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionId | 是 | String | 资源池id | fecnjniakfkn2314ndekqldedcsadfg |
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| pageNumber | 否 | Integer | 页码 | 1 | |
| pageSize | 否 | Integer | 每页数量 | 10 | |
| algorithm | 否 | String | 证书算法 | RSA_2048 | |
| status | 否 | String | 状态（2-启用，3-禁用，5-过期） | 2 | |
| epId | 否 | String | 企业项目id | default | |
| instanceId | 否 | String | 实例id，非必传，当为空时列出所有uk证书，不为空时列出指定实例下的uk证书 | ins-X63C8r | |
| certificateIdList | 否 | Array of Strings | 证书id列表 |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | String | 状态码 取值范围：200 成功 | 200 | |
| message | String | 提示信息 | Success | |
| returnObj | Object | 返回数据结构体 | result | |
| error | String | 错误码 仅错误时返回 格式为{服务编码}.{错误编号} | KMS.0269 |
表 result
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| list | Array of Objects | 证书列表 | CertInfoOutDto | |
| pageNumber | Integer | 页码 | 1 | |
| requestId | String | 请求id | 1d6d65ac-761d-4276-ad0f-1b94ef2ea29d | |
| pageSize | Integer | 每页数量 | 10 | |
| totalCount | Integer | 证书总数 | 10 |
表 CertInfoOutDto
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| certificateId | String | 证书id | abcs-dsbic | |
| keySpec | String | 算法类型 | RSA_2048 | |
| exportablePrivateKey | Integer | 私钥是否可以导出 | 1 | |
| subject | String | 证书主体 | abc | |
| createdTime | String | 创建时间 | kms | |
| status | Integer | 证书状态 | 2 | |
| epId | String | 证书所属企业项目 | tele | |
| protectionLevel | String | 证书保护级别 | 1 | |
| certificateName | String | 证书别名 | cert |
枚举参数
无
请求示例
请求url
https://{host}/v1/manageCertificate/listCertificateForUk
请求头header
{
"regionId": "200000001852"
}
请求体body
{
"pageNumber": 1,
"pageSize": 10,
"instanceId": "ins-Fu1xNx"
}
响应示例
{
"statusCode": "200",
"message": "查询Ukey证书列表成功",
"returnObj": {
"pageNumber": 1,
"requestId": "2eb43ad2-7781-4390-bcd6-f9b379076ad6",
"pageSize": 10,
"list": [
{
"subject": "C=CN,OU=信息部,CN=凯星液力",
"certificateId": "86599f11-ce59-4a61-a3cd-de9e66c14112",
"certificateName": "uk证书1757354579557",
"createdTime": 1757354580000,
"epId": "default",
"keySpec": "SM2",
"status": 2
},
{
"subject": "C=CN,OU=信息部,CN=凯星液力",
"certificateId": "29863a57-c5fd-44d2-92de-58804ced7f87",
"certificateName": "uk证书1757354844827",
"createdTime": 1757354845000,
"epId": "default",
"keySpec": "SM2",
"status": 2
},
],
"totalCount": 5
}
}
状态码
请参考 状态码
错误码
请参考 错误码
