查询证书列表
更新时间 2025-09-19 14:16:10
最近更新时间: 2025-09-19 14:16:10
接口功能介绍
查询证书列表
接口约束
无
URI
POST /v1/manageCertificate/listCertificate
路径参数 无
Query参数 无
请求参数
请求头header参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionId | 是 | String | 资源池id | fecnjniakfkn2314ndekqldedcsadfg |
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| pageNumber | 否 | Integer | 页码，默认为1 | 1 | |
| pageSize | 否 | Integer | 每页显示证书数量，默认为10 | 10 | |
| instanceId | 否 | String | 实例Id，非必传，当为空时列出所有证书，不为空时列出指定实例下的证书 | ins-X63C8r |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | String | 返回码 取值范围：200 成功 | 200 | |
| error | String | 错误码 | KMS_0514 | |
| message | String | 调用结果信息 | 列表成功 | |
| returnObj | Object | 接口返回结果 | returnObj | |
| 表 returnObj |
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| content | Array of Strings | 证书列表 | certInfo | |
| pageNumber | String | 当前页码 | 1 | |
| pageSize | String | 本页数量 | 10 | |
| totalCount | String | 证书总数 | 10 | |
| requestId | String | 请求id | a857cc58-ab6f-40ac-b9e7-fa1781209a76 | |
| 表 certInfo |
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| certificateId | String | 证书id | c761ed38-f582-45ca-996b-d11e9740dec8 | |
| keySpec | String | 证书密钥类型 | RSA_2048 | |
| exportablePrivateKey | Integer | 证书私钥是否可导出 1：可 0：不可 | 1 | |
| subject | String | 证书主体 | CN='defaultUserNameCN=userName', OU=kms, O=aliyun, ST=BeiJing, C=CN | |
| createdTime | String | 证书创建时间 | 2022-11-07 18:15:34 | |
| status | Integer | 证书状态 1.PENDING待导入 2.ACTIVE启用 3.INACTIVE禁用 4.REVOKED已吊销 | 2 |
枚举参数
无
请求示例
请求url
无
请求头header
{
"hmac": "B1uAGreROOnfuQkNp9I5bE4aXsGwBcL5daW3W0nL0Mw=",
"requestDate": "Wed, 29 Aug 2023 17:05:01 CST",
"accessKey": "ae2cc5cc5e8211ea978a186590d96509",
"userId":"562b89493b1a40e1b97ea05e50dd8170",
"regionId":"fecnjniakfkn2314ndekqldedcsadfg"
}
请求体body
{
"pageNumber":"1",
"pageSize":"10"
}
响应示例
{
"statusCode": "200",
"message": "列表成功",
"returnObj": {
"content": [
{
"certificateId": "c761ed38-f582-45ca-996b-d11e9740dec8",
"keySpec": "RSA_2048",
"exportablePrivateKey": 1,
"subject": null,
"createdTime": "2022-11-07 18:15:34",
"status": 2
},
{
"certificateId": "4882c278-9b68-4818-993d-b01ab7d5995f",
"keySpec": "RSA_2048",
"exportablePrivateKey": 1,
"subject": "CN=\"defaultUserNameCN=userName\", OU=kms, O=aliyun, ST=BeiJing, C=CN",
"createdTime": "2022-11-08 19:15:01",
"status": 2
}
],
"pageNumber": 1,
"pageSize": 10,
"totalCount": 10,
"requestId":"a857cc58-ab6f-40ac-b9e7-fa1781209a76"
}
}
状态码
请参考 状态码
错误码
请参考 错误码
